diff options
author | Karl Berry <karl@freefriends.org> | 2009-11-16 01:46:58 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-11-16 01:46:58 +0000 |
commit | 237c4c2e7bb45a876d74f05145db3f3e7dce5b53 (patch) | |
tree | 17a47ef7b94516c35a8a3f898d570217c30403d6 /Master | |
parent | 2b1511b76524ed6e4b906094ee4a63aacf7d68e5 (diff) |
pdfcomment 1.5a (7nov09)
git-svn-id: svn://tug.org/texlive/trunk@16024 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
14 files changed, 451 insertions, 137 deletions
diff --git a/Master/texmf-dist/doc/latex/pdfcomment/CHANGES b/Master/texmf-dist/doc/latex/pdfcomment/CHANGES index 8d971f8e56d..9a6c24f6a3c 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/CHANGES +++ b/Master/texmf-dist/doc/latex/pdfcomment/CHANGES @@ -1,5 +1,20 @@ === pdfcomment.sty === +-- pdfcomment.sty (v1.5a) (<- v1.5 2009/10/28) -- (svn rev 43) + +2009/11/04 added options liststyle and heading to command \listofpdfcomments [jk] + -> \setliststyle, \defineliststyle + +2009/11/04 added checks for undefined avatars, styles and liststyles [jk] + +-- pdfcomment.sty (v1.5) (<- v1.4c 2009/09/20) -- (svn rev 42) + +2009/10/28 new command \listofpdfcomments [jk] + + feature request by: Michael Niedermair + +2009/10/28 revision of documentation [jk] + -- pdfcomment.sty (v1.4c) (<- v1.4b 2009/09/20) -- (svn rev 41) 2009/09/21 revision of documentation [jk] diff --git a/Master/texmf-dist/doc/latex/pdfcomment/README b/Master/texmf-dist/doc/latex/pdfcomment/README index 60766ae11e0..7bd16b72a51 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/README +++ b/Master/texmf-dist/doc/latex/pdfcomment/README @@ -3,7 +3,7 @@ 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 Adobe -Reader. At least for the writer of LATEX code, the package offers a +Reader. At least for the writer of LaTeX code, the package offers a convenient and user-friendly means of using \pdfannot to provide comments in PDF files. Since version v1.1, pdfcomment.sty also supports: @@ -15,10 +15,8 @@ Adobe Reader. License: LPPL -Changes in v1.4c: +Changes in v1.5a: - - revision of documentation - added abbreviations for standard 14 fonts - clarification of font embedding in PDF free text annotations - - - minor bug fix
\ No newline at end of file + - added options liststyle and heading to command \listofpdfcomments + -> \setliststyle, \defineliststyle + - added checks for undefined avatars, styles and liststyles diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example.pdf Binary files differindex 1dc69e31532..3b47c80a6cd 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example.tex b/Master/texmf-dist/doc/latex/pdfcomment/example.tex index ba34c9e912c..dd7a22f722e 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example.tex @@ -3,6 +3,7 @@ \usepackage[english]{babel} \usepackage[latin1]{inputenc} \usepackage[T1]{fontenc} +\usepackage{lmodern} \usepackage{microtype} \usepackage{lipsum} \usepackage[svgnames,rgb]{xcolor} @@ -12,23 +13,23 @@ \begin{document} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} -A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[color=myblue,icon=Note,open=true,hspace=100pt]{This is another comment.} test the hspace!% +A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[color=myblue,subject={Comment2},icon=Note,open=true,hspace=100pt]{This is another comment.} test the hspace!% \defineavatar{CaptainJack}{color=myorange,author={Captain Jack}}% \definestyle{MyStar}{icon=Star,opacity=0.7,voffset=12pt}% -\pdfcomment[avatar=CaptainJack,style=MyStar]{It's enough now!} -\pdffreetextcomment[avatar=CaptainJack,subject={Top2},height=3cm,type=freetext,width=4.5cm,voffset=-4.8cm,hoffset=-3.2cm,opacity=0.5,justification=right]{This is also a comment, but it's a FreeText annotation! Your, Captain Jack} -\pdflinecomment[avatar=CaptainJack,subject={Top2},type=line,opacity=1,line={100 680 250 680},color=green,icolor=blue,caption=top,linebegin={/ROpenArrow},lineend={/OpenArrow},linewidth=2bp,captionhoffset=-5pt,captionvoffset=15pt]{This is a Line comment!} -\pdffreetextcomment[avatar=CaptainJack,subject={Top2},height=1.8cm,width=5.8cm,voffset=-7.2cm,hoffset=-1.2cm,opacity=1.0,justification=right,type=typewriter,font=Harrington,fontsize=18pt,fontcolor=CornflowerBlue]{This is a typewriter FreeText annotation!} +\pdfcomment[avatar=CaptainJack,style=MyStar,subject={enough}]{It's enough now!} +\pdffreetextcomment[avatar=CaptainJack,height=3cm,type=freetext,subject={freetext},width=4.5cm,voffset=-4.8cm,hoffset=-3.2cm,opacity=0.5,justification=right]{This is also a comment, but it's a FreeText annotation! Your, Captain Jack} +\pdflinecomment[avatar=CaptainJack,subject={Line1},type=line,opacity=1,line={100 680 250 680},color=green,icolor=blue,caption=top,linebegin={/ROpenArrow},lineend={/OpenArrow},linewidth=2bp,captionhoffset=-5pt,captionvoffset=15pt]{This is a Line comment!} +\pdffreetextcomment[avatar=CaptainJack,subject={typewriter},height=1.8cm,width=5.8cm,voffset=-7.2cm,hoffset=-1.2cm,opacity=1.0,justification=right,type=typewriter,font=Harrington,fontsize=18pt,fontcolor=CornflowerBlue]{This is a typewriter FreeText annotation!} \marginnote{\begin{textblock*}{1cm}(7cm,14.5cm) -\pdffreetextcomment[avatar=CaptainJack,height=1.9cm,width=9cm,opacity=0.5,voffset=0pt,hoffset=0pt,opacity=1.0,font=Georgia,fontsize=9pt,fontcolor=red,justification=left,linewidth=2bp,bse=cloudy,bsei=1.3,type=callout,line={170 515 120 460 200 460},lineend=/ClosedArrow]{This one was placed with absolute coordinates (textpos.sty) (font=Georgia, fontsize=9pt, fontcolor=red, linewidth=2bp, bse=cloudy, bsei=1.3, type=callout, line=\{170 515 120 460 200 460\}, lineend=/ClosedArrow)} +\pdffreetextcomment[avatar=CaptainJack,subject={callout},height=1.9cm,width=9cm,opacity=0.5,voffset=0pt,hoffset=0pt,opacity=1.0,font=Georgia,fontsize=9pt,fontcolor=red,justification=left,linewidth=2bp,bse=cloudy,bsei=1.3,type=callout,line={170 515 120 460 200 460},lineend=/ClosedArrow]{This one was placed with absolute coordinates (textpos.sty) (font=Georgia, fontsize=9pt, fontcolor=red, linewidth=2bp, bse=cloudy, bsei=1.3, type=callout, line=\{170 515 120 460 200 460\}, lineend=/ClosedArrow)} \end{textblock*}} {\small \marginnote{\begin{textblock*}{2cm}(6cm,11.9cm){($x_1, y_1$)}\end{textblock*}} \marginnote{\begin{textblock*}{2cm}(3cm,13.3cm){($x_2, y_2$)}\end{textblock*}} \marginnote{\begin{textblock*}{2cm}(5.6cm,13.6cm){($x_3, y_3$)}\end{textblock*}} } -\pdfmarkupcomment[author={Donald Duck},color=red,markup=StrikeOut]{A little Test!}{Why is this repeated? This is a StrikeOut markup annotation} +\pdfmarkupcomment[author={Donald Duck},subject={Strikeout},color=red,markup=StrikeOut]{A little Test!}{Why is this repeated? This is a StrikeOut markup annotation} \colorlet{KernFarbe}{red} \colorlet{HuelleFarbe}{blue} @@ -68,17 +69,17 @@ A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffse \pdfcommentsetup{avatar=Dolittle}\pdfmargincomment{Yeah nice, but stolen from the pgf-Users mailing list!} \vspace{3cm} -\pdfmarkupcomment[author={Donald Duck},color=Khaki,opacity=1.0,markup=Underline]{For a long time \texttt{pdflatex} offers the command \texttt{\textbackslash pdfannot} for inserting arbitrary pdf annotations. However, in a form where additional knowledge of the pdf reference is indispensable. \texttt{pdfcomment.sty} is an answer to the -- from time to time -- emerging questions in newsgroups, how one could use the comment function of \texttt{Adobe Reader}. At least out of the \LaTeX{} code \texttt{pdfcomment.sty} offers a convenient and user-friendly possibility to use pdf annotations in pdf files}{It's better to use dark colors for annotations with lines, as you see! This is a Underline markup annotations}. \pdfmargincomment{Holy moly! Can anybody transfer that to real english!} +\pdfmarkupcomment[author={Donald Duck},subject={underline},color=Khaki,opacity=1.0,markup=Underline]{For a long time \texttt{pdflatex} offers the command \texttt{\textbackslash pdfannot} for inserting arbitrary pdf annotations. However, in a form where additional knowledge of the pdf reference is indispensable. \texttt{pdfcomment.sty} is an answer to the -- from time to time -- emerging questions in newsgroups, how one could use the comment function of \texttt{Adobe Reader}. At least out of the \LaTeX{} code \texttt{pdfcomment.sty} offers a convenient and user-friendly possibility to use pdf annotations in pdf files}{It's better to use dark colors for annotations with lines, as you see! This is a Underline markup annotations}. \pdfmargincomment{Holy moly! Can anybody transfer that to real english!} -\pdfmarkupcomment[author={Donald Duck},color=Teal,opacity=1.0,markup=Squiggly]{Unfortunately the support of pdf annotations by pdf viewers is only partly available to nonexistent. The reference viewer for the development of this package is \texttt{Adobe Reader}.}{This is a Squiggly markup annotation} +\pdfmarkupcomment[author={Donald Duck},subject={squiggly},color=Teal,opacity=1.0,markup=Squiggly]{Unfortunately the support of pdf annotations by pdf viewers is only partly available to nonexistent. The reference viewer for the development of this package is \texttt{Adobe Reader}.}{This is a Squiggly markup annotation} -\noindent\pdfsquarecomment[avatar=CaptainJack,subject={Top2},height=2.5cm,width=5.8cm,voffset=-2.8cm,hoffset=1cm,opacity=1.0,justification=right,icolor=CornflowerBlue,bse=cloudy,bsei=2.5,linewidth=8pt]{This is a Square annotation!} -\pdffreetextcomment[avatar=CaptainJack,subject={Top2},height=2.2cm,width=4.8cm,voffset=-2.8cm,hoffset=1.5cm,opacity=1.0,justification=right,type=typewriter,font=Jokerman,fontsize=13pt,fontcolor=black]{This typewriter annotation overlays the square!} -\pdfcirclecomment[avatar=CaptainJack,color=blue,subject={Top2},height=2.5cm,width=5.8cm,voffset=-2.8cm,hoffset=8cm,opacity=1.0,justification=right,icolor={yellow},linewidth=12pt,borderstyle=dashed,dashstyle={10 5}]{This is a Circle annotation!} -\pdflinecomment[type=polyline,avatar=CaptainJack,subject={Top2},opacity=1,line={150 120 260 120 300 150 400 80},color=green,icolor=blue,linebegin={/Slash},lineend={/Diamond},linewidth=3bp,bse=cloudy]{This is a Polyline comment!} +\noindent\pdfsquarecomment[avatar=CaptainJack,subject={square},height=2.5cm,width=5.8cm,voffset=-2.8cm,hoffset=1cm,opacity=1.0,justification=right,icolor=CornflowerBlue,bse=cloudy,bsei=2.5,linewidth=8pt]{This is a Square annotation!} +\pdffreetextcomment[avatar=CaptainJack,subject={overlay},height=2.2cm,width=4.8cm,voffset=-2.8cm,hoffset=1.5cm,opacity=1.0,justification=right,type=typewriter,font=Jokerman,fontsize=13pt,fontcolor=black]{This typewriter annotation overlays the square!} +\pdfcirclecomment[avatar=CaptainJack,color=blue,subject={circle},height=2.5cm,width=5.8cm,voffset=-2.8cm,hoffset=8cm,opacity=1.0,justification=right,icolor={yellow},linewidth=12pt,borderstyle=dashed,dashstyle={10 5}]{This is a Circle annotation!} +\pdflinecomment[type=polyline,avatar=CaptainJack,subject={polyline},opacity=1,line={150 120 260 120 300 150 400 80},color=green,icolor=blue,linebegin={/Slash},lineend={/Diamond},linewidth=3bp,bse=cloudy]{This is a Polyline comment!} \vspace{3.5cm} -\pdfmarkupcomment[author={Donald Duck},color=yellow,opacity=1.0,markup=Highlight]{Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, +\pdfmarkupcomment[author={Donald Duck},subject={highlight},color=yellow,opacity=1.0,markup=Highlight]{Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris. Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna. Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis @@ -90,10 +91,10 @@ auctor semper nulla. Donec varius orci eget risus. Duis nibh mi, congue eu, accu eleifend, sagittis quis, diam. Duis eget orci sit amet orci dignissim rutrum.}{This is a Highlight markup annotations with page break} \vspace{5cm} -\pdflinecomment[avatar=CaptainJack,subject={Top2},type=line,opacity=1,line={110 620 220 530},color=green,icolor=blue,caption=none,linebegin={/RClosedArrow},lineend={/Circle},linewidth=2bp]{This is another Line comment! Just to show all possible arrows!} -\pdflinecomment[type=polygon,avatar=CaptainJack,subject={Top2},opacity=1,line={275 590 355 600 400 570 350 530 270 540 276 590},color=green,icolor=CornflowerBlue,linewidth=5bp,bse=cloudy,bsei=2.2]{This is a Polygon comment!} +\pdflinecomment[avatar=CaptainJack,subject={line2},type=line,opacity=1,line={110 620 220 530},color=green,icolor=blue,caption=none,linebegin={/RClosedArrow},lineend={/Circle},linewidth=2bp]{This is another Line comment! Just to show all possible arrows!} +\pdflinecomment[type=polygon,avatar=CaptainJack,subject={polygon},opacity=1,line={275 590 355 600 400 570 350 530 270 540 276 590},color=green,icolor=CornflowerBlue,linewidth=5bp,bse=cloudy,bsei=2.2]{This is a Polygon comment!} -\begin{pdfsidelinecomment}[avatar=CaptainJack,subject={Top2},opacity=1,color=red,icolor=yellow,caption=inline,linebegin={/Butt},lineend={/Square},linewidth=3bp,linesep=1cm]{ ! Delete ! } +\begin{pdfsidelinecomment}[avatar=CaptainJack,subject={sideline},opacity=1,color=red,icolor=yellow,caption=inline,linebegin={/Butt},lineend={/Square},linewidth=3bp,linesep=1cm]{ ! Delete ! } \lipsum[2-6] \end{pdfsidelinecomment} \end{document}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf Binary files differindex d0537a8cf82..d2745a53180 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex index 7b454c59e74..3599a64ac05 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex @@ -2,6 +2,7 @@ \usepackage[english]{babel} \usepackage[latin1]{inputenc} \usepackage[T1]{fontenc} +\usepackage{lmodern} \usepackage{microtype} \usepackage{lipsum} \usepackage[absolute]{textpos} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf Binary files differindex 2c87ef23256..26eb9246b2a 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex index 3558511e89d..cabdba3a7ac 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex @@ -2,6 +2,7 @@ \usepackage[english]{babel} \usepackage[latin1]{inputenc} \usepackage[T1]{fontenc} +\usepackage{lmodern} \usepackage{microtype} \usepackage{lipsum} \usepackage[svgnames,rgb]{xcolor} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf Binary files differindex 1d9ac5e90f3..d676b3bce9b 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf Binary files differindex bb488e38cde..8c6f61c4989 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex index b7c3845820c..d646fc4b12a 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex @@ -1,70 +1,57 @@ -\documentclass[a4paper]{ltxdoc} - +\documentclass[a4paper]{ltxdoc}% \usepackage[english]{babel}% \usepackage[latin1]{inputenc}% \usepackage[T1]{fontenc}% \usepackage{textcomp}% \usepackage{lmodern}% \usepackage{bera}% -\usepackage{microtype} -\usepackage{url}% +\usepackage{microtype}% \usepackage{attachfile}% +\usepackage{ltxdocext}% \usepackage{marginnote}% -\usepackage[svgnames,rgb]{xcolor} -\usepackage{ltxdocext} -\usepackage{pdfcomment} -\def\fileversion{v1.4c} -\def\filename{pdfcomment.sty} -\def\XeLaTeX{Xe\LaTeX} -\CodelineIndex -\makeatletter +\usepackage[svgnames,rgb]{xcolor}% +\usepackage{jkdoc}% +\usepackage{pdfcomment}% +% +\def\filename{pdfcomment.sty}% +\def\XeLaTeX{Xe\LaTeX}% +% +\makeatletter% \renewcommand\tableofcontents% {% - %\section*{\contentsname + %\section*{\contentsname}% \@mkboth{% \MakeUppercase\contentsname}{\MakeUppercase\contentsname}% \@starttoc{toc}% }% -\makeatother -\renewcommand{\arg}[1]{% - {\ttfamily\string{}\meta{#1}{\ttfamily\string}}% - \index{#1=\string\ttt{#1}, Argument}\index{Argument>#1=\string\ttt{#1}}% -}% -\renewcommand{\oarg}[1]{% - {\ttfamily[%] - }\meta{#1}{\ttfamily%[ - ]}% - \index{#1=\string\ttt{#1}, optionales Argument}% - \index{Argument, optional>#1=\string\ttt{#1}}% -}% -\renewcommand\env{\name@idx{Umgebung}}% -\renewcommand*{\file}[1]{% - {\ttfamily#1}% - \index{#1=\string\ttt{#1}}\index{Datei>#1=\string\ttt{#1}}% -}% -\newcommand\styleoption{\name@idx{Styleoption}}% -\newcommand\stylename{\name@idx{Dokumentenstyle}}% +% +\newcommand\styleoption{\name@idx{style option}}% +\newcommand\stylename{\name@idx{document style}}% \def\name@idx#1#2{% {\ttfamily#2}% \index{#2\space#1=\string\ttt{#2}\space#1}\index{#1>#2=\string\ttt{#2}}% }% - -\newcommand*\margcs[1]{\marginnote{\raggedleft\scriptsize #1}} -\newcommand*\package[1]{\texttt{#1}\index{#1=\string\ttt{#1}}} -\newcommand*\mco[1]{\mbox{\LANGLE\itshape#1\RANGLE}\index{#1, Klassenoptionwert}\index{Klassenoptionwert>#1}} -\setlength\parindent{0pt} -\makeatletter +\newcommand*\margcs[1]{\marginnote{\raggedleft\scriptsize #1}}% +\newcommand*\package[1]{\texttt{#1}\index{#1=\string\ttt{#1}}}% +\newcommand*\mco[1]{\mbox{\LANGLE\itshape#1\RANGLE}\index{#1, class option value}\index{class option value>#1}}% +% \renewcommand\@biblabel[1]{\makebox[1.5cm][l]{[#1]}} \renewcommand*\l@subsection{\@dottedtocline{2}{1.2em}{2.3em}} \renewcommand*\l@subsubsection{\@dottedtocline{3}{2.4em}{3.7em}} \makeatother -\hypersetup{pdfauthor={Josef Kleber},pdftitle={A user-friendly interface to PDF annotations},pdfsubject={Documentation for LaTeX style \filename}} +% +\setlength\parindent{0pt}% +\hypersetup{pdfauthor={Josef Kleber},pdftitle={A user-friendly interface to PDF annotations},pdfsubject={Documentation for LaTeX style \filename}}% +% \begin{document} \bibliographystyle{alphadin} -\title{\substyle{\filename} \fileversion\footnote{\protect\href{mailto:pdfcomment.sty@pdfcomment.josef-kleber.de}{\texttt{pdfcomment.sty@pdfcomment.josef-kleber.de}}}\\A user-friendly interface to PDF annotations\footnote{\protect\href{http://pdfcomment.josef-kleber.de}{\texttt{http://pdfcomment.josef-kleber.de}}}} -\author{Josef Kleber\footnote{\protect\href{mailto:josef.kleber@gmx.de}{\texttt{josef.kleber@gmx.de}}}} -\date{\today} +\title{\filename}% +\subtitle{A user-friendly interface to PDF annotations}% +\author{Josef Kleber} +\fileversion{v1.5a} +\refline{\href{mailto:pdfcomment.sty@pdfcomment.josef-kleber.de}{\texttt{pdfcomment.sty@pdfcomment.josef-kleber.de}}\\\href{http://pdfcomment.josef-kleber.de/en_index.htm}{\texttt{http://pdfcomment.josef-kleber.de/en\_index.htm}}}% \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: @@ -90,6 +77,7 @@ If you can't see this annotation \pdfcomment[author={Josef Kleber},subject={Test \tableofcontents \end{multicols} \clearpage +\headline{Acknowledgment} \section*{Acknowledgment} I want to thank the following persons for contributions to the development of this package: @@ -206,7 +194,7 @@ You can use the option \styleoption{font} for defining the font of PDF freetext You can use the option \styleoption{fontsize} for defining the fontsize of PDF freetext annotations. \subsubsection[\texttt{fontcolor}]{\styleoption{fontcolor}}\label{sec:fontcolor} -You can use the option \styleoption{fontcolor} for defining the font color in PDF freetext annotations,which must be a RGB color. +You can use the option \styleoption{fontcolor} for defining the font color in PDF freetext annotations, which must be a RGB color. \subsubsection[\texttt{line}]{\styleoption{line}}\label{sec:line} You can use the option \styleoption{line} for defining the coordinates of lines in certain PDF annotations, e.\,g. in the form \{$x_1$\space$y_1$\space$x_2$\space$y_2$\}. The origin is in the bottom left page corner. The given numbers will be interpreted as Postscript points (\LaTeX{} unit: bp (big points)), as usual in PDF documents. @@ -379,6 +367,36 @@ Possible \margcs{\cmd\pdfsidelinecomment\\\oarg{options}\marg{comment}}options: \label{sec:commentsetup} With the command \cmd\pdfcommentsetup \margcs{\cmd\pdfcommentsetup\marg{options}} you can reset the global options at any time. +\subsubsection{\texorpdfstring{\cs{listofpdfcomments}}{\textbackslash listofpdfcomments}} +\label{sec:listofpdfcomments} +The command \cmd\listofpdfcomments\margcs{\cmd\listofpdfcomments\oarg{options}} creates a list of the PDF comments to ease finding them. The command offers the following options: + +\begin{itemize} +\item \styleoption{liststyle} specifies the list style. Possible option values are: +\begin{itemize} +\item \mco{AuthorSubject} (default) +\item \mco{SubjectAuthorComment} +\item \mco{AuthorComment} +\item \mco{SubjectComment} +\item \mco{Comment} +\end{itemize} + +\item \styleoption{heading} specifies an alternative heading, e.\,g. \styleoption{heading}=\{List of comments\}. +\end{itemize} + +\subsubsection{\texorpdfstring{\cs{setliststyle}}{\textbackslash setliststyle}} +\label{sec:setliststyle} +The command \cmd\setliststyle\margcs{\cmd\setliststyle\marg{name}} is necessary, if comments are used before \cmd\listofpdfcomments\ and you wish to have an alternative list style. + +\subsubsection{\texorpdfstring{\cs{defineliststyle}}{\textbackslash defineliststyle}} +\label{sec:defineliststyle} +With the command \cmd\defineliststyle\margcs{\cmd\defineliststyle\\\marg{name}\marg{definition}} you can define new list styles, e.\,g.: + +\medskip +\cmd\makeatletter\\ +\cmd\defineliststyle\{MyListstyle\}\{\cmd\pc@lopt@subject\texttt{\textbackslash}\ \cmd\textcolor\{red\}\\\{(\cmd\pc@lopt@author)\}:\texttt{\textbackslash}\ \cmd\pc@lopt@comment\}\\ +\cmd\makeatother + \subsubsection{\texorpdfstring{\cs{defineavatar}}{\textbackslash defineavatar}} \label{sec:defineavatar} With the command \cmd\defineavatar \margcs{\cmd\defineavatar\marg{name}\marg{options}} you can create named predefined option lists, which can be later used in the comment commands with the option \styleoption{avatar}. With this option, it's easy for several authors of the same document to switch between different avatars, that is their graphical representation. @@ -421,6 +439,4 @@ Please note that only opened popups will be printed! \addcontentsline{toc}{section}{\refname} } -%for index -\footnotesize \end{document} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf Binary files differindex 4ded83a41b8..c8f879cbb1a 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex index baba06d6561..bd74dd4abb1 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex @@ -1,35 +1,38 @@ -\documentclass[a4paper]{ltxdoc} +\documentclass[a4paper]{ltxdoc}% \usepackage[german]{babel}% \usepackage[latin1]{inputenc}% \usepackage[T1]{fontenc}% \usepackage{lmodern}% \usepackage{bera}% \usepackage{textcomp}% -\usepackage{microtype} -\usepackage{url}% +\usepackage{microtype}% \usepackage{attachfile}% -\usepackage{marginnote}% -\usepackage[svgnames,rgb]{xcolor} \usepackage{ltxdocext}% -\usepackage{pdfcomment} -\def\fileversion{v1.4c} -\def\filename{pdfcomment.sty} -\def\XeLaTeX{Xe\LaTeX} -\CodelineIndex -\makeatletter +\usepackage{marginnote}% +\usepackage[svgnames,rgb]{xcolor}% +\usepackage{jkdocde}% +\usepackage{pdfcomment}% +% +\def\filename{pdfcomment.sty}% +\def\XeLaTeX{Xe\LaTeX}% +% +\makeatletter% \renewcommand\tableofcontents% {% - %\section*{\contentsname + %\section*{\contentsname}% \@mkboth{% \MakeUppercase\contentsname}{\MakeUppercase\contentsname}% \@starttoc{toc}% }% -\makeatother -\renewcommand{\arg}[1]{% +% +\CodelineIndex% +\renewcommand{\arg}[1]% +{% {\ttfamily\string{}\meta{#1}{\ttfamily\string}}% \index{#1=\string\ttt{#1}, Argument}\index{Argument>#1=\string\ttt{#1}}% }% -\renewcommand{\oarg}[1]{% +\renewcommand{\oarg}[1]% +{% {\ttfamily[%] }\meta{#1}{\ttfamily%[ ]}% @@ -47,23 +50,28 @@ {\ttfamily#2}% \index{#2\space#1=\string\ttt{#2}\space#1}\index{#1>#2=\string\ttt{#2}}% }% - -\newcommand*\margcs[1]{\marginnote{\raggedleft\scriptsize #1}} -\newcommand*\package[1]{\texttt{#1}\index{#1=\string\ttt{#1}}} -\newcommand*\mco[1]{\mbox{\LANGLE\itshape#1\RANGLE}\index{#1, Klassenoptionwert}\index{Klassenoptionwert>#1}} -\setlength\parindent{0pt} -\makeatletter -\renewcommand\@biblabel[1]{\makebox[1.5cm][l]{[#1]}} -\renewcommand*\l@subsection{\@dottedtocline{2}{1.2em}{2.3em}} -\renewcommand*\l@subsubsection{\@dottedtocline{3}{2.4em}{3.7em}} -\makeatother +\newcommand*\margcs[1]{\marginnote{\raggedleft\scriptsize #1}}% +\newcommand*\package[1]{\texttt{#1}\index{#1=\string\ttt{#1}}}% +\newcommand*\mco[1]{\mbox{\LANGLE\itshape#1\RANGLE}\index{#1, Klassenoptionwert}\index{Klassenoptionwert>#1}}% +% +\renewcommand\@biblabel[1]{\makebox[1.5cm][l]{[#1]}}% +\renewcommand*\l@subsection{\@dottedtocline{2}{1.2em}{2.3em}}% +\renewcommand*\l@subsubsection{\@dottedtocline{3}{2.4em}{3.7em}}% +\makeatother% +% +\setlength\parindent{0pt}% +% \hypersetup{pdfauthor={Josef Kleber},pdftitle={Ein benutzerfreundliches Interface zu PDF-Kommentaren},pdfsubject={Dokumentation für den LaTeX style \filename}} -\begin{document} +% +\begin{document} \bibliographystyle{alphadin} -\title{\substyle{\filename} \fileversion\footnote{\protect\href{mailto:pdfcomment.sty@pdfcomment.josef-kleber.de}{\texttt{pdfcomment.sty@pdfcomment.josef-kleber.de}}}\\Ein benutzerfreundliches Interface zu PDF-Kommentaren\footnote{\protect\href{http://pdfcomment.josef-kleber.de}{\texttt{http://pdfcomment.josef-kleber.de}}}} -\author{Josef Kleber\footnote{\protect\href{mailto:josef.kleber@gmx.de}{\texttt{josef.kleber@gmx.de}}}} -\date{\today} +\title{\filename}% +\subtitle{Ein benutzerfreundliches Interface zu PDF-Kommentaren}% +\author{Josef Kleber} +\fileversion{v1.5a} +\refline{\href{mailto:pdfcomment.sty@pdfcomment.josef-kleber.de}{\texttt{pdfcomment.sty@pdfcomment.josef-kleber.de}}\\\href{http://pdfcomment.josef-kleber.de}{\texttt{http://pdfcomment.josef-kleber.de}}}% \maketitle +\headline{Zusammenfassung}% \begin{abstract} \texttt{pdflatex}\index{pdflatex} bietet seit jeher den Befehl \cmd\pdfannot{} für das Einfügen beliebiger PDF annotations. Allerdings in einer Form, in der zusätzliche Kenntnisse der PDF-Referenz unabdingbar sind. \substyle{\filename} ist eine Antwort auf die in Newsgroups -- von Zeit zu Zeit -- auftauchende Frage, wie man die Kommentarfunktion des \texttt{Adobe Reader} nutzen könnte. Zumindest aus dem \LaTeX{}-Code heraus, bietet \substyle{\filename} eine bequeme und nutzerfreundliche Möglichkeit PDF annotations in PDF-Dateien zu nutzen. Seit Version v1.1 unterstützt \texttt{\filename{}} auch: @@ -90,6 +98,7 @@ Falls Sie diesen Kommentar \pdfcomment[author={Josef Kleber},subject={Test Komme \end{multicols} \clearpage \section*{Danksagung} +\headline{Danksagung}% Für Beiträge zur Entwicklung dieses Pakets möchte ich folgenden Personen danken: \begin{itemize} @@ -374,6 +383,36 @@ Mögliche \margcs{\cmd\pdfsidelinecomment\\\oarg{Optionen}\marg{Kommentar}}Option \label{sec:commentsetup} Mit dem Befehl \cmd\pdfcommentsetup \margcs{\cmd\pdfcommentsetup\marg{Optionen}} kann man jederzeit die globalen Styleoptionen neu setzen. +\subsubsection{\texorpdfstring{\cs{listofpdfcomments}}{\textbackslash listofpdfcomments}} +\label{sec:listofpdfcomments} +Der Befehl \cmd\listofpdfcomments\margcs{\cmd\listofpdfcomments\oarg{Optionen}} erzeugt eine Liste der Kommentare, um das Auffinden der Kommentare zu vereinfachen. Der Befehl bietet die folgenden Optionen: + +\begin{itemize} +\item \styleoption{liststyle} dient der Festlegung des Listenstils. Dabei sind folgende Werte möglich: +\begin{itemize} +\item \mco{AuthorSubject} (default) +\item \mco{SubjectAuthorComment} +\item \mco{AuthorComment} +\item \mco{SubjectComment} +\item \mco{Comment} +\end{itemize} + +\item \styleoption{heading} dient der Festlegung der Überschrift, z.\,B. \styleoption{heading}=\{Liste der Kommentare\}. +\end{itemize} + +\subsubsection{\texorpdfstring{\cs{setliststyle}}{\textbackslash setliststyle}} +\label{sec:setliststyle} +Der Befehl \cmd\setliststyle\margcs{\cmd\setliststyle\marg{Name}} ist notwendig, falls Kommentare bereits vor \cmd\listofpdfcomments\ eingesetzt werden und ein alternativer Listenstil gewünscht wird. + +\subsubsection{\texorpdfstring{\cs{defineliststyle}}{\textbackslash defineliststyle}} +\label{sec:defineliststyle} +Der Befehl \cmd\defineliststyle\margcs{\cmd\defineliststyle\\\marg{Name}\marg{Definition}} dient der Definition neuer Listenstile, z.\,B.: + +\medskip +\cmd\makeatletter\\ +\cmd\defineliststyle\{MyListstyle\}\{\cmd\pc@lopt@subject\texttt{\textbackslash}\ \cmd\textcolor\{red\}\\\{(\cmd\pc@lopt@author)\}:\texttt{\textbackslash}\ \cmd\pc@lopt@comment\}\\ +\cmd\makeatother + \subsubsection{\texorpdfstring{\cs{defineavatar}}{\textbackslash defineavatar}} \label{sec:defineavatar} Der Befehl \cmd\defineavatar \margcs{\cmd\defineavatar\marg{Name}\marg{Optionen}} dient der Erstellung benannter vordefinierter Optionslisten, die später in den Kommentarbefehlen über die Option \styleoption{avatar} wieder geladen werden. Damit können z.\,B. mehrere Autoren eines Dokuments sehr einfach zwischen ihren Avataren -- also ihren grafischen Repräsentationen -- wechseln. diff --git a/Master/texmf-dist/tex/latex/pdfcomment/pdfcomment.sty b/Master/texmf-dist/tex/latex/pdfcomment/pdfcomment.sty index d119066ad65..a497f2b178d 100644 --- a/Master/texmf-dist/tex/latex/pdfcomment/pdfcomment.sty +++ b/Master/texmf-dist/tex/latex/pdfcomment/pdfcomment.sty @@ -20,7 +20,7 @@ %% This work consists of all files listed in manifest.txt. %% % -\ProvidesPackage{pdfcomment}[2009/09/20 pdfcomment.sty v1.4c - Josef Kleber (C) 2008-2009]% +\ProvidesPackage{pdfcomment}[2009/11/04 pdfcomment.sty v1.5a - Josef Kleber (C) 2008-2009]% % \RequirePackage{xkeyval}% % @@ -185,18 +185,38 @@ \newcommand{\pc@raggedleftmarginnote}{\centering}% \newcommand{\pc@raggedrightmarginnote}{\centering}% % +\newcommand{\lpcname}{List of pdfcomments}% +\gdef\pc@lpc@format{\pc@lopt@author\ - \pc@lopt@subject}% +\gdef\pc@lopt@liststyle{AuthorSubject}% +% % define global style option avatar for setting a predefined set of options (Avatar) \define@key{pdfcomment.sty}{avatar}[]% {% thanks to Ulrike Fischer Msg-Id: <rba0oaiflbjf.dlg@nililand.de> - \edef\pc@gopt@loadavatar{\noexpand\setkeys{pdfcomment.sty}{\csname pc@avatar@#1\endcsname}}% - \pc@gopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@gopt@loadavatar{\noexpand\setkeys{pdfcomment.sty}{\csname pc@avatar@#1\endcsname}}% + \pc@gopt@loadavatar% + }% }% % % define global style option style for setting a predefined set of options (Style) \define@key{pdfcomment.sty}{style}[]% {% - \edef\pc@gopt@loadstyle{\noexpand\setkeys{pdfcomment.sty}{\csname pc@style@#1\endcsname}}% - \pc@gopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@gopt@loadstyle{\noexpand\setkeys{pdfcomment.sty}{\csname pc@style@#1\endcsname}}% + \pc@gopt@loadstyle% + }% }% % % define global style option subject for setting the subject of pdf annotations @@ -438,15 +458,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdfcomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfcomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfcomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdfcomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfcomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfcomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -692,15 +728,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdfmargincomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfmargincomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfmargincomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdfmargincomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfmargincomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfmargincomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -946,15 +998,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdffreetextcomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdffreetextcomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdffreetextcomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdffreetextcomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdffreetextcomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdffreetextcomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -1188,15 +1256,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdfmarkupcomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfmarkupcomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfmarkupcomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdfmarkupcomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfmarkupcomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfmarkupcomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -1446,15 +1530,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdfsquarecomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfsquarecomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfsquarecomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdfsquarecomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfsquarecomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfsquarecomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -1695,15 +1795,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdfcirclecomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfcirclecomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfcirclecomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdfcirclecomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfcirclecomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfcirclecomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -1944,15 +2060,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdflinecomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdflinecomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdflinecomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdflinecomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdflinecomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdflinecomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -2192,15 +2324,31 @@ % define local style option avatar for setting a predefined set of options (Avatar) \define@key{pdfsidelinecomment}{avatar}[]% {% - \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfsidelinecomment}{\csname pc@avatar@#1\endcsname}}% - \pc@lopt@loadavatar% + \edef\pc@edef@avatar{pc@avatar@#1}% + \@ifundefined{\pc@edef@avatar}% + {% + \PackageWarning{pdfcomment}{Unknown avatar #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadavatar{\noexpand\setkeys{pdfsidelinecomment}{\csname pc@avatar@#1\endcsname}}% + \pc@lopt@loadavatar% + }% }% % % define local style option style for setting a predefined set of options (Style) \define@key{pdfsidelinecomment}{style}[]% {% - \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfsidelinecomment}{\csname pc@style@#1\endcsname}}% - \pc@lopt@loadstyle% + \edef\pc@edef@style{pc@style@#1}% + \@ifundefined{\pc@edef@style}% + {% + \PackageWarning{pdfcomment}{Unknown style #1\MessageBreak% + skip assignment}% + }% + {% + \edef\pc@lopt@loadstyle{\noexpand\setkeys{pdfsidelinecomment}{\csname pc@style@#1\endcsname}}% + \pc@lopt@loadstyle% + }% }% % % define local command option subject for setting the subject of pdf annotations @@ -2438,6 +2586,18 @@ \gdef\pc@lopt@linesep{\pc@pttobp{#1}}% }% % +% define cammand option liststyle for \listofpdfcomments +\define@key{listofpdfcomments}{liststyle}[AuthorSubject]% +{% + \gdef\pc@lopt@liststyle{#1}% +}% +% +% define cammand option heading for \listofpdfcomments +\define@key{listofpdfcomments}{heading}[\lpcname]% +{% + \renewcommand{\lpcname}{#1}% +}% +% \ExecuteOptionsX{subject,color,author,icon,open,hspace,voffset,hoffset,width,height,depth,opacity,markup,font,fontsize,fontcolor,justification,borderstyle,linewidth,dashstyle,bse,bsei,type,lineend,linebegin,icolor,line,caption,captionhoffset,captionvoffset,linesep}% % \ProcessOptionsX\relax% @@ -2521,6 +2681,7 @@ \gdef\pc@lopt@c{/C [\pc@hyenc@color]}% }% \ifpc@gopt@final\else% + \pc@create@lpc% % typeset text annotation (see: PDF Reference) \ifpdf% \vbox% @@ -2604,6 +2765,7 @@ \gdef\pc@lopt@c{/C [\pc@hyenc@color]}% }% \ifpc@gopt@final\else% + \pc@create@lpc% \begingroup% % center marginnotes! \renewcommand{\raggedleftmarginnote}{\pc@raggedleftmarginnote}% @@ -2714,6 +2876,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% \expandafter\pdfannot \pc@pdfannotopt% {% /Subtype /FreeText% @@ -2734,6 +2897,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% \special{pdf: ann \pc@pdfannotopt% <<% /Subtype /FreeText% @@ -2756,6 +2920,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% %create dimensions of annotation \pdfmark[\rule{0pt}{\pc@lopt@height}\rule{\pc@lopt@width}{0pt}]% {% @@ -2810,6 +2975,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% \expandafter\pdfannot \pc@pdfannotopt% {% /Subtype /Square\space% @@ -2830,6 +2996,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% \special{pdf: ann \pc@pdfannotopt% <<% /Subtype /Square\space% @@ -2852,6 +3019,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% %create dimensions of annotation \pdfmark[\rule{0pt}{\pc@lopt@height}\rule{\pc@lopt@width}{0pt}]% {% @@ -2906,6 +3074,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% \expandafter\pdfannot \pc@pdfannotopt% {% /Subtype /Circle\space% @@ -2927,6 +3096,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% \special{pdf: ann \pc@pdfannotopt% <<% /Subtype /Circle\space% @@ -2949,6 +3119,7 @@ {% \vsize=0pt% \hskip\pc@lopt@hoffset% + \pc@create@lpc% %create dimensions of annotation \pdfmark[\rule{0pt}{\pc@lopt@height}\rule{\pc@lopt@width}{0pt}]% {% @@ -3013,6 +3184,7 @@ %create options for \pdfannot \pc@create@pdfannotopt% \ifpc@gopt@final\else% + \pc@create@lpc% % typeset line annotation (see: PDF Reference) \ifpdf% \vbox to 0pt% @@ -3126,6 +3298,9 @@ \pc@create@annot% \fi% \fi% + \ifpc@gopt@final\else% + \pc@create@lpc% + \fi% #2% \zsavepos{pdfcomment:\thezref@unique}% \zref@refused{pdfcomment:\thezref@unique}% @@ -3223,7 +3398,7 @@ \renewcommand{\pc@y@two}{\pc@y@bottom@text} \gdef\pc@lopt@line{\pc@x@two\space\pc@y@one\space\pc@x@two\space\pc@y@two}% \gdef\pc@lopt@le{/LE [\pc@lopt@linebegin\space/None]}% - \marginnote{\pc@create@annot@sideline}% + \marginnote{\pc@create@lpc\pc@create@annot@sideline}% \gdef\pc@lopt@line{\pc@x@one\space\pc@y@two\space\pc@x@one\space\pc@y@one}% \gdef\pc@lopt@le{/LE [/None\space\pc@lopt@linebegin]}% \marginnote{\pc@create@annot@sideline}% @@ -3240,7 +3415,7 @@ \pc@calc@sidelinepos% \gdef\pc@lopt@line{\pc@x@two\space\pc@y@one\space\pc@x@two\space\pc@y@two}% \gdef\pc@lopt@le{/LE [\pc@lopt@linebegin\space\pc@lopt@lineend]}% - \marginnote{\pc@create@annot@sideline}% + \marginnote{\pc@create@lpc\pc@create@annot@sideline}% \gdef\pc@lopt@line{\pc@x@one\space\pc@y@two\space\pc@x@one\space\pc@y@one}% \gdef\pc@lopt@le{/LE [\pc@lopt@lineend\space\pc@lopt@linebegin]}% \marginnote{\pc@create@annot@sideline}% @@ -3276,6 +3451,73 @@ \expandafter\gdef\csname pc@style@#1\endcsname{#2}% }% % +\newcommand\l@lpcsec{\@dottedtocline{1}{0em}{0em}}% +% +% define predefined set of liststyles +\newcommand{\defineliststyle}[2]% +{% + \expandafter\gdef\csname pc@liststyle@#1\endcsname{#2}% +}% +% +\newcommand{\setliststyle}[1]% +{% + \gdef\pc@lopt@liststyle{#1}% + \edef\pc@edef@liststyle{pc@liststyle@#1}% + \@ifundefined{\pc@edef@liststyle}% + {% + \setliststyle{AuthorSubject}% + \PackageWarning{pdfcomment}{Unknown liststyle #1\MessageBreak% + in command setliststyle\MessageBreak% + Using liststyle AuthorSubject instead!}% + }% + {% + \expandafter\gdef\expandafter\pc@lpc@format{\expandafter\csname \pc@edef@liststyle\endcsname}% + }% +}% +% +\defineliststyle{AuthorSubject}{\pc@lopt@author\ - \pc@lopt@subject}% +\defineliststyle{SubjectAuthorComment}{\pc@lopt@subject\ (\pc@lopt@author): \pc@lopt@comment}% +\defineliststyle{AuthorComment}{\pc@lopt@author: \pc@lopt@comment}% +\defineliststyle{SubjectComment}{\pc@lopt@subject: \pc@lopt@comment}% +\defineliststyle{Comment}{\pc@lopt@comment}% +% +\newcommand{\listofpdfcomments}[1][]% +{% + \setkeys{listofpdfcomments}{#1}% + \edef\pc@edef@liststyle{pc@liststyle@\pc@lopt@liststyle}% + \@ifundefined{\pc@edef@liststyle}% + {% + \PackageWarning{pdfcomment}{Unknown liststyle \pc@lopt@liststyle\MessageBreak% + in command listofpdfcomments\MessageBreak% + Using liststyle=AuthorSubject instead!}% + \setliststyle{AuthorSubject}% + }% + {% + \expandafter\gdef\expandafter\pc@lpc@format{\expandafter\csname \pc@edef@liststyle\endcsname}% + }% + \ifpc@gopt@final\else% + \setboolean{@restonecol}{false}% + \ifthenelse{\boolean{@twocolumn}}% + {\setboolean{@restonecol}{true}\onecolumn}% + {}% + \@ifundefined{chapter}% + {\section*{\lpcname\@mkboth{\lpcname}{\lpcname}}\addcontentsline{toc}{section}{\lpcname{}}}% + {\chapter*{\lpcname\@mkboth{\lpcname}{\lpcname}}\addcontentsline{toc}{chapter}{\lpcname{}}}% + {% + \setlength{\parindent}{0pt}% + \@starttoc{lpc}% + }% + \ifthenelse{\boolean{@restonecol}}% + {\twocolumn}% + {}% + \fi% +}% +% +\newcommand{\pc@create@lpc}% +{% + \phantomsection% + \addcontentsline{lpc}{lpcsec}{\protect\numberline{}\pc@lpc@format}% +}% % \newcommand{\pc@copy@gopt@lopt}% {% @@ -3314,6 +3556,7 @@ % \newcommand{\pc@encode@PDF}[1]% {% + \gdef\pc@lopt@comment{#1}% \pdfstringdef\pc@pdfenc@contents{#1}% \pdfstringdef\pc@pdfenc@author{\pc@lopt@author}% \pdfstringdef\pc@pdfenc@subject{\pc@lopt@subject}% |