summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex')
-rw-r--r--Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex38
1 files changed, 6 insertions, 32 deletions
diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex
index 6b21fb8cb3b..1179362565d 100644
--- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex
+++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex
@@ -9,6 +9,7 @@
\usepackage{attachfile}%
\usepackage{ltxdocext}%
\usepackage{marginnote}%
+\usepackage{metalogo}%
\usepackage[svgnames,rgb]{xcolor}%
\usepackage{amsmath,array}%
\usepackage{tikz}%
@@ -138,18 +139,18 @@
\title{\filename}%
\Subtitle{A user-friendly interface to PDF annotations}%
\author{Josef Kleber}
-\Fileversion{v2.3a}
-\Refline{\href{mailto:josef.kleber@gmx.de}{\texttt{josef.kleber@gmx.de}}\\\href{https://bitbucket.org/kleberj/pdfcomment/}{\texttt{https://bitbucket.org/kleberj/pdfcomment/}}}
+\Fileversion{v2.3b}
+\Refline{\href{mailto:josef.kleber@gmx.de}{\texttt{josef.kleber@gmx.de}}\\\href{http://pdfcomment.jklatex.de}{\texttt{http://pdfcomment.jklatex.de}}}
\maketitle
\Headline{Abstract}
\begin{abstract}
For a long time \texttt{pdflatex} has offered the command \cmd\pdfannot{} for inserting arbitrary PDF annotations. However, the command is presented in a form where additional knowledge of the definition of the PDF format is indispensable. This package is an answer to the -- occasional -- questions in newsgroups, about how one could use the comment function of \texttt{Adobe Reader}. At least for the writer of \LaTeX{} code, the package offers a convenient and user-friendly means of using \cmd\pdfannot{} to provide comments in PDF files. Since version v1.1, \texttt{\filename{}} also supports:
\medskip
-\noindent\hfill\texttt{\LaTeX{} $\rightarrow$ \texttt{dvips} $\rightarrow$ \texttt{ps2pdf}, \LaTeX{} $\rightarrow$ \texttt{dvipdfmx}\footnote{only with style option \texttt{dvipdfmx}} and \XeLaTeX}.\hfill
+\noindent\hfill\texttt{\LaTeX{} $\rightarrow$ \texttt{dvips} $\rightarrow$ \texttt{ps2pdf}, \LaTeX{} $\rightarrow$ \texttt{dvipdfmx}\footnote{only with style option \texttt{dvipdfmx}} \XeLaTeX and \LuaLaTeX}.\hfill
\medskip
-Unfortunately, support of PDF annotations by PDF viewers is sparse to nonexistent. The reference viewer for the development of this package is \texttt{Adobe Reader}.
+Unfortunately, support of PDF annotations by PDF viewers may vary. The reference viewer for the development of this package is \texttt{Adobe Reader}.
If you can't see this annotation \pdfcomment[author={Josef Kleber},subject={Test annotation},color=lime,hspace=20pt]{This is an annotation} you are definitely using the wrong PDF viewer!
\end{abstract}
@@ -206,9 +207,6 @@ Version v2.0 of \texttt{pdfcomment.sty} introduced a bugfix that removes unwante
\subsection{Local options}
The following options are useable as options for the commands presented in sections \ref{sec:umgebungen} and \ref{sec:befehle}, as well as style options. As style options they have global effect, whereas they have only local effect when used in commands. Furthermore global options are not overwritten.
-\subsubsection[\texttt{id}]{\styleoption{id}}\label{sec:id}
-You can use the option \styleoption{id} to define a unique ID for referencing in a PDF reply (see \ref{sec:pdfreply}).
-
\subsubsection[\texttt{subject}]{\styleoption{subject}}\label{sec:subject}
You can use the option \styleoption{subject} for defining the subject of the PDF popup annotations.
@@ -442,7 +440,7 @@ Possible \margcs{\cmd\pdfcomment\\\oarg{options}\marg{comment}}options: \styleop
\bigskip
\cmd\pdfcomment{} will typeset an annotation into the text at the current \pdfcommentsetup{subject={\textbackslash pdfcomment test},hspace=18pt}\pdfcomment[icon=Star,color=YellowGreen]{This is a comment in the text} position.
-Internally, the argument \marg{comment} needs to be converted to PDFDocEncoding/PDFUnicode\footnote{\cmd\hypersetup\{unicode\}}. Some chars with special meaning in \LaTeX{} (\texttt{\&}, \texttt{\%,} ...) must be escaped or replaced with their command form, e.\,g. \texttt{\string\_} or \texttt{\string\textunderscore} \cite[6.2 Definition of \texttt{\string\pdfstringdef}]{bib:hyperref}. Furthermore there are some commands for formatting:
+Internally, the argument \marg{comment} needs to be converted to PDFDocEncoding/PDFUnicode\footnote{\cmd\hypersetup\{unicode\}}. Some chars with special meaning in \LaTeX{} (\texttt{\&}, \texttt{\%,} ...) must be escaped or replaced with their command form, e.\,g. \texttt{\string\_} or \texttt{\string\textunderscore}. Furthermore there are some commands for formatting:
\begin{center}
\begin{tabular}{cl}
@@ -531,22 +529,6 @@ Possible \margcs{\cmd\pdfsidelinecomment\\\oarg{options}\marg{comment}}options:
\cmd\pdflinecomment{} will typeset a comment in form of a line, polyline or polygon at the wished spot of the page (see: \LinkEx).
\clearpage
-\subsection{Replys}
-
-\subsubsection{\texorpdfstring{\cs{pdfreply}}{\textbackslash pdfreply}}
-\label{sec:pdfreply}
-Possible \margcs{\cmd\pdfreply\\\oarg{options}\marg{comment}}options: \styleoption{avatar}, \styleoption{style}, \styleoption{subject}, \styleoption{author}, \styleoption{id}, \styleoption{replyto}, \styleoption{color}, \styleoption{disable}, \styleoption{date}, \styleoption{timezone}
-
-\bigskip
-\defineavatar{Joe}{author=Joe,color=yellow}
-\defineavatar{Bob}{author=Bob,color=green}
-With the command \cmd\pdfreply{} you can compose replys to comments. The option \texttt{replyto} provides a clear reference to the comment the reply refers to.\footnote{The replys must be typeset on the same page than the refering comments}. Due to technical reasons the command \string\pdfreply\ works only while using \texttt{pdflatex}.
-\pdfmargincomment[subject={Top2},author={Josef Kleber},icon=Note,id=1,color=blue]{This is a comment.}
-\pdfreply[id=2,avatar=Joe,replyto=1,date=D:20101212161247+01'00']{This is a reply to a comment}
-\pdfreply[id=3,avatar=Bob,replyto=2,date=D:20101213095321+01'00']{Of course, you can reply to a reply}
-\pdfreply[id=4,avatar=Bob,replyto=1,date=D:20101213095512+01'00']{Just another reply}
-Furthermore the command can not support page breaks (\string\pdfmarkupcomment, \string\pdfsidelinecomment). The replys will only appear in the PDF annotations on the second page. Replys to comments without page break work smoothly!
-
\subsection{Tooltips}
\subsubsection{\texorpdfstring{\cs{pdftooltip}}{\textbackslash pdftooltip}}
@@ -698,12 +680,4 @@ with a text editor and change the entry
Please note that only opened popups will be printed!
-{
-\clearpage
-\raggedright
-\nocite{*}
-\bibliography{pdfcomment}
-\addcontentsline{toc}{section}{\refname}
-}
-
\end{document}