summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/changes/userdoc/changes.en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/changes/userdoc/changes.en.tex')
-rw-r--r--Master/texmf-dist/doc/latex/changes/userdoc/changes.en.tex752
1 files changed, 382 insertions, 370 deletions
diff --git a/Master/texmf-dist/doc/latex/changes/userdoc/changes.en.tex b/Master/texmf-dist/doc/latex/changes/userdoc/changes.en.tex
index 757e434191e..3949b2459bb 100644
--- a/Master/texmf-dist/doc/latex/changes/userdoc/changes.en.tex
+++ b/Master/texmf-dist/doc/latex/changes/userdoc/changes.en.tex
@@ -13,7 +13,6 @@ If you want to contact me directly, please send an email to \href{mailto:ekleino
Please start your email subject with \texttt{[changes]}.
\begin{quote}
- \small\textsc{README:}
The changes-package allows the user to manually markup changes of text, such as additions, deletions, or replacements.
Changed text is shown in a different color; deleted text is striked out.
Additionally, text can be highlighted and/or commented.
@@ -23,10 +22,16 @@ Please start your email subject with \texttt{[changes]}.
Here is a short example of change markup:
-This is \added[id=EK]{new} text.
-In this sentence, I replace a \replaced[id=EK, comment={a good word is better than a bad one}]{good}{bad} word.
-And, to sum up the text changes, there is another \deleted[id=EK]{obsolete} word to delete.
-Furthermore, text can be \highlight[id=EK]{highlighted} or just \comment[id=EK]{For the fun of it.} commented.
+\begin{quote}
+ This is \added[id=EK, comment={missing word}]{new} text.
+ In this sentence, I replace a \replaced[id=EK]{good}{bad} word.
+ And, to sum up the text changes, there is another \deleted[id=EK]{obsolete} word to delete.
+ Furthermore, text can be \highlight[id=EK]{highlighted} or just \comment[id=EK]{For the fun of it.}commented.
+\end{quote}
+
+Parallel to this manual is a folder ``examples'' which contains an extensive collection of example files, both \hologo{LaTeX} and PDF files.
+Please refer to these examples for inspiration and first problem solving.
+
%^^A ---- usage
\cleardoublepage
@@ -34,7 +39,7 @@ Furthermore, text can be \highlight[id=EK]{highlighted} or just \comment[id=EK]{
\label{sec:usage}
In this section a typical use case of the \chpackage{changes}-package is described.
-You can find the detailed description of the package options and new commands in \autoref{sec:user}.
+You can find the detailed description of the package options and new commands in \autoref{sec:ui}.
We start with the text you want to change.
You want to markup the changes for each author individually.
@@ -43,7 +48,7 @@ Such a change markup is well-known in WYSIWYG text processors such as \emph{Libr
The \chpackage{changes}-package was developed in order to support such change markup.
The package provides commands for defining authors, and for marking text as added, deleted, or replaced.
Additionally, text can be highlighted or commented.
-In order to use the package, you have to follow these steps:
+In order to use the package, you should follow these steps:
\begin{enumerate}
\item use \chpackage{changes}-package
@@ -56,80 +61,84 @@ In order to use the package, you have to follow these steps:
\end{enumerate}
-\minisec{use \chpackage{changes}-package}
+\minisec{Use \chpackage{changes}-package}
In order to activate change management, use the \chpackage{changes}-package as follows:
-\input{userdoc/in_usepackage_changes}
+\chinline{usepackage_changes}
respectively
-\input{userdoc/in_usepackage_options_changes}
+\chinline{usepackage_options_changes}
You can use the options for defining the layout of the change markup.
You can change the layout after using the \chpackage{changes}-package as well.
-For detailed information please refer to \autoref{sec:user:options} and \autoref{sec:user:customizingoutput}.
+For detailed information please refer to \autoref{sec:ui:options} and \autoref{sec:ui:customizingoutput}.
-\minisec{define authors}
+\minisec{Define authors}
The \chpackage{changes}-package provides a default anonymous author.
If you want to track your changes depending on the author, you have to define the needed authors as follows:
-\input{userdoc/in_definechangesauthor_options}
+\chinline{definechangesauthor}
Every author is uniquely identified through his or her id.
You can give every author an optional name and/or color.
-For detailed information please refer to \autoref{sec:user:authormanagement}.
+For detailed information please refer to \autoref{sec:ui:authormanagement}.
-\minisec{markup text changes}
+\minisec{Markup text changes}
Now everything is set to markup the changed text.
Please use the following commands according to your change:
-for newly added text:\\
-\chcommand{added[id=<id>, comment=<comment>]\{new text\}}
+for added text:
+
+\chinline{added}
-for deleted text:\\
-\chcommand{deleted[id=<id>, comment=<comment>]\{old text\}}
+for deleted text:
-for replaced text:\\
-\chcommand{replaced[id=<id>, comment=<comment>]\{\meta{new text}\}\{\meta{old text}\}}
+\chinline{deleted}
+
+for replaced text:
+
+\chinline{replaced}
Stating the author's id and/or a comment is optional.
-For detailed information please refer to \autoref{sec:user:changemanagement}.
+For detailed information please refer to \autoref{sec:ui:changemanagement}.
-\minisec{highlight and comment text}
+\minisec{Highlight and comment text}
Maybe you want to highlight orcomment some text?
-highlight text:\\
-\chcommand{highlight[id=<id>, comment=<comment>]\{text\}}
+highlight text:
+
+\chinline{highlight}
-comment text:\\
-\chcommand{comment[id=<id>]\{comment\}}
+comment text:
+
+\chinline{comment}
Stating the author's id and/or a comment for highlights is optional.
-For detailed information please refer to \autoref{sec:user:comment}.
+For detailed information please refer to \autoref{sec:ui:comment}.
-\minisec{typeset the document with \hologo{LaTeX}}
+\minisec{Typeset the document with \hologo{LaTeX}}
After marking your changes in the text you are able to display them in the generated document by processing it as usual with \hologo{LaTeX}.
By processing your document the changed text is layouted as you stated by the corresponding options and/or special commands.
-\minisec{output list of changes}
+\minisec{Output list of changes}
You can print a list of changes using:
-\chcommand{listofchanges}\texttt{[style=<list|summary|compactsummary>, title=<title>,}\\
-\hspace*{2em}\texttt{show=<type>]}
+\chinline{listofchanges}
The list is meant to be the analogon to the list of tables, or the list of figures.
@@ -137,32 +146,46 @@ Stating the style is optional, default is \choption{style=list}.
In order to print a quick overview of the number and kind of changes of every author, use the option \choption{style=summary} or \choption{style=compactsummary}.
Show only specific changes by using the \choption{show} option.
-By running \hologo{LaTeX}\ the data of the list is written into an auxiliary file.
-This data is used in the next \hologo{LaTeX}\ run for typesetting the list of changes.
-Therefore, two \hologo{LaTeX}\ runs are needed after every change in order to typeset an up-to-date list of changes.
+By running \hologo{LaTeX} the data of the list is written into an auxiliary file.
+This data is used in the next \hologo{LaTeX} run for typesetting the list of changes.
+Therefore, two \hologo{LaTeX} runs are needed after every change in order to typeset an up-to-date list of changes.
-For detailed information please refer to \autoref{sec:user:overview}.
+For detailed information please refer to \autoref{sec:ui:overview}.
-\minisec{remove markup}
+\minisec{Remove markup}
Often you want to remove the change markup after acknowledging or rejecting the changes.
You can suppress the output of changes with:
-\chcommand{usepackage[final]\{changes\}}
-
-\subsection{Available scripts}
+\chinline{usepackage_final_changes}
-In order to remove the markup from the \hologo{LaTeX}\ source code you can use a script from Silvano Chiaradonna.
+In order to remove the markup from the \hologo{LaTeX} files, you have to remove the commands by hand or use the script by Yvon Cui.
You find the script in the directory:
-\texttt{<texpath>/scripts/changes/}
+\chinline[, language=bash]{path_script}
+
+The script removes all markups either keeping or rejecting the change.
+You can select or deselect markup from removal using the interactive mode by starting the script without options.
+
+The script requires \emph{python3}.
+
+Use the script as follows:
+
+\chinputlisting{, language=bash}{userdoc/script_pymergechanges}
+
+Run the script with no options and files for a short help text:
+
+\chinputlisting{, language=bash}{userdoc/script_pymergechanges_empty}
+
+Known issues:
+
+\begin{itemize}
+ \item removes only markup that is used in one line, not markup that spans multiple lines
+ \item problems with nested commands
+\end{itemize}
-The script removes all markups.
-You can select or deselect markup from removal using the interactive mode.
-Switch on the interactive mode with the script parameter \texttt{-i}.
-The script is not adapted yet to the comment and highlight commands.
@@ -172,22 +195,26 @@ The script is not adapted yet to the comment and highlight commands.
\label{sec:limitations}
The \chpackage{changes}-package was carefully programmed and tested.
-Yet the possibility of errors in the package exists, you might encounter problem during use, or you might miss functionionality.
+Yet the possibility of errors in the package exists, you might encounter problem during use, or you might miss functionality.
In that case, please go to
\url{http://changes.sourceforge.net/}
-There you can report errors, ask for help in the forum, or give advice to other users.
-You can view the source code, and change it according to your needs.
-I will try to include your changes in the maintained package.
-If you are a registered \emph{sourceforge} user you can be a co-author of the \chpackage{changes}-package.
+There you find information on how to report errors or improvements, give advice to other users, or participate in the development of the package.
You can write me an email too, please send it to \href{mailto:ekleinod@edgesoft.de}{ekleinod@edgesoft.de}.
In that case, please start your email subject with \texttt{[changes]}.
Change markup of texts works well, it is possible to markup whole paragraphs.
-You can markup more than one paragraph at a time but occasionally this leads to errors.
-You cannot markup figures or tables.
+You cannot markup:
+
+\begin{itemize}
+ \item figures
+ \item tables
+ \item headings
+ \item some commands
+ \item several paragraphs (sometimes)
+\end{itemize}
You can try putting such text in an extra file and include in with \texttt{input}.
This works sometimes, give it a try.
@@ -198,7 +225,7 @@ Avoid such markup when using these environments.
There are several possibilities of enhancing the \chpackage{changes}-package.
I will describe but a few here, I will not implement them due to lack of time and/or skill.
-You can have a look at the more complete list of enhancements on the \emph{gitlab} page.
+You can have a look at the complete list of enhancements in the issue tracker of \emph{gitlab}.
\begin{itemize}
\item selecting of acknowledged and rejected texts; deletion of the corresponding markup
@@ -212,26 +239,34 @@ You can have a look at the more complete list of enhancements on the \emph{gitla
%^^A ---- user interface
\cleardoublepage
\section{User interface of the \chpackage{changes}-package}
-\label{sec:user}
+\label{sec:ui}
-This section describes the user interface of the \chpackage{changes}-package, i.e. all options and commands of the package.
-Every option respectively new command is described.
+This section describes the user interface of the \chpackage{changes}-package, i.e.\ all options and commands of the package.
+Every option and new command is described.
If you want to see the options and commands in action, please refer to the examples in
-\texttt{<texpath>/doc/latex/changes/examples/}
+\chinline[, language=bash]{path_doc_examples}
The example files are named with the used option respectively command.
-A preliminary remark regarding typesetting of replaced text: replaced text is always typeset as follows: \meta{new text}\meta{old text}.
-Thus, there is no possiblity to influence the output of replaced text directly, but via changing the output of added respectively deleted text.
-
-
%^^A -- options
\subsection{Package Options}
-\label{sec:user:options}
+\label{sec:ui:options}
+
+\chinline{usepackage_options_changes}
+
+The package options control the behavior of the overall package, i.\,e.\ all markup commands.
+
+The following options are defined:
+
+\localtableofcontents
+
+
\subsubsection{draft}
+\chinline{usepackage_draft_changes}
+
The \choption{draft}-option enables markup of changes.
The list of changes is available via \chcommand{listofchanges}.
This option is the default option, if no other option is selected.
@@ -239,25 +274,27 @@ This option is the default option, if no other option is selected.
The \chpackage{changes} package reuses the declaration of \choption{draft} in \chcommand{documentclass}.
The local declaration of \choption{final} overrules the declaration of \choption{draft} in \chcommand{documentclass}.
-\chcommand{usepackage[draft]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}
-
\subsubsection{final}
+
+\chinline{usepackage_final_changes}
+
The \choption{final}-option disables markup of changes, only the correct text will be shown.
The list of changes is disabled, too.
The \chpackage{changes} package reuses the declaration of \choption{final} in \chcommand{documentclass}.
The local declaration of \choption{draft} overrules the declaration of \choption{final} in \chcommand{documentclass}.
-\chcommand{usepackage[final]\{changes\}}
-
\subsubsection{markup}
+\chinline{usepackage_markup_changes}
+
The \choption{markup} option chooses a predefined visual markup of changed text.
The default markup is chosen if no explicit markup is given.
The markup chosen with \choption{markup} can be overwritten with the more special markup options \choption{addedmarkup}, \choption{deletedmarkup}, \choption{commentmarkup}, or \choption{highlightmarkup}.
-The following values are allowed:
+The following values for \emph{markup} are defined:
+
\begin{description}
\item [\choption{default}] default markup for added and deleted text, comments and highlighted text (default markup)
\item [\choption{underlined}] underlined for added text, wavy underlined for highlighted text, default for deleted text, and comments
@@ -265,234 +302,218 @@ The following values are allowed:
\item [\choption{nocolor}] no colored markup, underlined for added text, wavy underlined for highlighted text, default for deleted text and comments
\end{description}
-\begin{chusage}
- \>\chcommand{usepackage[markup=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[markup=default]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[markup=underlined]\{changes\}}\\
- \>\chcommand{usepackage[markup=bfit]\{changes\}}\\
- \>\chcommand{usepackage[markup=nocolor]\{changes\}}
-\end{chusage}
+\chexample{usepackage_markup_changes}
When changing from color markup to markup without color and vice versa, some errors occur if an auxiliary file exists.
Please ignore the errors, they vanish in the second run.
-\subsubsection{addedmarkup, deletedmarkup}
+\subsubsection{addedmarkup}
+
+\chinline{usepackage_addedmarkup_changes}
The \choption{addedmarkup} option chooses a predefined visual markup of added text.
-The \choption{deletedmarkup} option chooses a predefined visual markup of deleted text respectively.
The default markup is chosen if no explicit markup is given.
-The options \choption{addedmarkup} and \choption{deletedmarkup} overwrite the markup chosen with \choption{markup}.
+The option \choption{addedmarkup} overwrites the markup chosen with \choption{markup}.
+
+The following values for \emph{addedmarkup} are defined:
-The following values are allowed:
\begin{description}
- \item [\choption{colored}] no text markup, just coloring -- {\color{orange} example} (default markup for added text)
+ \item [\choption{colored}] no text markup, just coloring -- {\color{orange} example} (default)
\item [\choption{uline}] underlined text -- \uline{example}
\item [\choption{uuline}] double underlined text -- \uuline{example}
\item [\choption{uwave}] wavy underlined text -- \uwave{example}
\item [\choption{dashuline}] dashed underlined text -- \dashuline{example}
\item [\choption{dotuline}] dotted underlined text -- \dotuline{example}
- \item [\choption{sout}] striked out text (deleted text only) -- \sout{example} (default markup for deleted text)
- \item [\choption{xout}] crossed out text (deleted text only) -- \xout{example}
\item [\choption{bf}] bold text -- \textbf{example}
\item [\choption{it}] italic text -- \textit{example}
\item [\choption{sl}] slanted text -- \textsl{example}
\item [\choption{em}] emphasized text -- \emph{example}
\end{description}
-\begin{chusage}
- \>\chcommand{usepackage[addedmarkup=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[addedmarkup=colored]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[addedmarkup=uline]\{changes\}}\\
-\end{chusage}
+The output of replaced text is a combination of added and deleted text, thus any change in their layout influences the layout of replaced text.
+
+\chexample{usepackage_addedmarkup_changes}
+
-\begin{chusage}
- \>\chcommand{usepackage[deletedmarkup=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[deletedmarkup=sout]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[deletedmarkup=xout]\{changes\}}\\
- \>\chcommand{usepackage[deletedmarkup=uwave]\{changes\}}
-\end{chusage}
+\subsubsection{deletedmarkup}
+
+\chinline{usepackage_deletedmarkup_changes}
+
+The \choption{deletedmarkup} option chooses a predefined visual markup of deleted texty.
+The default markup is chosen if no explicit markup is given.
+The option \choption{deletedmarkup} overwrites the markup chosen with \choption{markup}.
+
+The following values for \emph{deletedmarkup} are defined:
+
+\begin{description}
+ \item [\choption{sout}] striked out text -- \sout{example} (default)
+ \item [\choption{xout}] crossed out text -- \xout{example}
+ \item [\choption{colored}] no text markup, just coloring -- {\color{orange} example}
+ \item [\choption{uline}] underlined text -- \uline{example}
+ \item [\choption{uuline}] double underlined text -- \uuline{example}
+ \item [\choption{uwave}] wavy underlined text -- \uwave{example}
+ \item [\choption{dashuline}] dashed underlined text -- \dashuline{example}
+ \item [\choption{dotuline}] dotted underlined text -- \dotuline{example}
+ \item [\choption{bf}] bold text -- \textbf{example}
+ \item [\choption{it}] italic text -- \textit{example}
+ \item [\choption{sl}] slanted text -- \textsl{example}
+ \item [\choption{em}] emphasized text -- \emph{example}
+\end{description}
+
+The output of replaced text is a combination of added and deleted text, thus any change in their layout influences the layout of replaced text.
+
+\chexample{usepackage_deletedmarkup_changes}
\subsubsection{highlightmarkup}
+\chinline{usepackage_highlightmarkup_changes}
+
The \choption{highlightmarkup} option chooses a predefined visual markup for highlighted text.
The default markup is chosen if no explicit markup is given.
The option \choption{highlightmarkup} overwrites the markup chosen with \choption{markup}.
-The following values are allowed:
+The following values for \emph{highlightmarkup} are defined:
\begin{description}
- \item [\choption{background}] markup by background color -- \colorbox{orange!30}{example (default markup for highlighted text)}
+ \item [\choption{background}] markup by background color -- \colorbox{orange!30}{example} (default)
\item [\choption{uuline}] double underlined text -- \uuline{example}
\item [\choption{uwave}] wavy underlined text -- \uwave{example}
\end{description}
-\begin{chusage}
- \>\chcommand{usepackage[highlightmarkup=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[highlightmarkup=background]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[highlightmarkup=uwave]\{changes\}}\\
-\end{chusage}
+\chexample{usepackage_highlightmarkup_changes}
\subsubsection{commentmarkup}
+\chinline{usepackage_commentmarkup_changes}
+
The \choption{commentmarkup} option chooses a predefined visual markup for comments.
The default markup is chosen if no explicit markup is given.
The option \choption{commentmarkup} overwrites the markup chosen with \choption{markup}.
-The following values are allowed:
+The following values for \emph{commentmarkup} are defined:
+
\begin{description}
- \item [\choption{todo}] comment as todo note, which is not added to list of todos -- \todo{example comment}(default markup for comments)
- \item [\choption{margin}] comment in margin -- \marginpar{example comment}
- \item [\choption{footnote}] comment as footnote -- \footnote{example comment}
+ \item [\choption{todo}] comment as todo note, which is not added to list of todos \todo{example comment}(default)
+ \item [\choption{margin}] comment in margin\marginpar{example comment}
+ \item [\choption{footnote}] comment as footnote\footnote{example comment}
\item [\choption{uwave}] wavy underlined text -- \uwave{example comment}
\end{description}
-\begin{chusage}
- \>\chcommand{usepackage[commentmarkup=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[commentmarkup=todo]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[commentmarkup=footnote]\{changes\}}\\
-\end{chusage}
-
+\chexample{usepackage_commentmarkup_changes}
\subsubsection{authormarkup}
+\chinline{usepackage_authormarkup_changes}
+
The \choption{authormarkup} option chooses a predefined visual markup of the author's identification.
The default markup is chosen if no explicit markup is given.
-The following values are allowed:
+The following values for \emph{authormarkup} are defined:
+
\begin{description}
- \item [\choption{superscript}] superscripted text -- text\textsuperscript{author} (default markup)
+ \item [\choption{superscript}] superscripted text -- text\textsuperscript{author} (default)
\item [\choption{subscript}] subscripted text -- text\textsubscript{author}
\item [\choption{brackets}] text in brackets -- text(author)
\item [\choption{footnote}] text in footnote -- text\footnote{author}
\item [\choption{none}] no author identification
\end{description}
-\begin{chusage}
- \>\chcommand{usepackage[authormarkup=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[authormarkup=superscript]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[authormarkup=subscript]\{changes\}}\\
- \>\chcommand{usepackage[authormarkup=brackets]\{changes\}}\\
- \>\chcommand{usepackage[authormarkup=footnote]\{changes\}}\\
- \>\chcommand{usepackage[authormarkup=none]\{changes\}}
-\end{chusage}
-
+\chexample{usepackage_authormarkup_changes}
\subsubsection{authormarkupposition}
+\chinline{usepackage_authormarkupposition_changes}
+
The \choption{authormarkupposition} option chooses the position of the author's identification.
The default value is chosen if no explicit markup is given.
-The following values are allowed:
+The following values for \emph{authormarkupposition} are defined:
+
\begin{description}
- \item [\choption{right}] right of the text -- text\textsuperscript{example} (default value)
- \item [\choption{left}] left of the text -- \textsuperscript{example}text
+ \item [\choption{right}] right of the text -- text\textsuperscript{author} (default)
+ \item [\choption{left}] left of the text -- \textsuperscript{author}text
\end{description}
-\begin{chusage}
- \>\chcommand{usepackage[authormarkupposition=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[authormarkupposition=right]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[authormarkupposition=left]\{changes\}}
-\end{chusage}
+\chexample{usepackage_authormarkupposition_changes}
\subsubsection{authormarkuptext}
+\chinline{usepackage_authormarkuptext_changes}
+
The \choption{authormarkuptext} option chooses the text that is used for the author's identification.
The default value is chosen if no explicit markup is given.
-The following values are allowed:
+The following values for \emph{authormarkuptext} are defined:
+
\begin{description}
- \item [\choption{id}] author's id -- text\textsuperscript{id} (default value)
+ \item [\choption{id}] author's id -- text\textsuperscript{id} (default)
\item [\choption{name}] author's name -- text\textsuperscript{authorname}
\end{description}
-\begin{chusage}
- \>\chcommand{usepackage[authormarkuptext=\meta{markup}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[authormarkuptext=id]\{changes\}} \Corresponds\ \chcommand{usepackage\{changes\}}\\
- \>\chcommand{usepackage[authormarkuptext=name]\{changes\}}
-\end{chusage}
-
+\chexample{usepackage_authormarkuptext_changes}
\subsubsection{todonotes}
+\chinline{usepackage_todonotes_changes}
+
Options for the \chpackage{todonotes} package can be specified as parameters of the \choption{todonotes}-option.
-Two or more options have to be put in curly brackets.
+Several options or options with special characters have to be put in curly brackets.
-\begin{chusage}
- \>\chcommand{usepackage[todonotes=\meta{options}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[todonotes=\{textsize=tiny\}]\{changes\}}
-\end{chusage}
+\chexample{usepackage_todonotes_changes}
\subsubsection{truncate}
-Options for the \chpackage{truncate} package can be specified as parameters of the \choption{truncate}-option.
-Two or more options have to be put in curly brackets.
+\chinline{usepackage_truncate_changes}
-\begin{chusage}
- \>\chcommand{usepackage[truncate=\meta{options}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[truncate=hyphenate]\{changes\}}
-\end{chusage}
+Options for the \chpackage{truncate} package can be specified as parameters of the \choption{truncate}-option.
+Several options or options with special characters have to be put in curly brackets.
+\chexample{usepackage_truncate_changes}
\subsubsection{ulem}
-Options for the \chpackage{ulem} package can be specified as parameters of the \choption{ulem}-option.
-Two or more options have to be put in curly brackets.
+\chinline{usepackage_ulem_changes}
-\begin{chusage}
- \>\chcommand{usepackage[ulem=\meta{options}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[ulem=UWforbf]\{changes\}}\\
- \>\chcommand{usepackage[ulem=\{normalem,normalbf\}]\{changes\}}
-\end{chusage}
+Options for the \chpackage{ulem} package can be specified as parameters of the \choption{ulem}-option.
+Several options or options with special characters have to be put in curly brackets.
+\chexample{usepackage_ulem_changes}
\subsubsection{xcolor}
+\chinline{usepackage_xcolor_changes}
+
Options for the \chpackage{xcolor} package can be specified as parameters of the \choption{xcolor}-option.
-Two or more option have to be embraced in curly brackets.
+Several options or options with special characters have to be put in curly brackets.
-\begin{chusage}
- \>\chcommand{usepackage[xcolor=\meta{options}]\{changes\}}\\
- \usageexample
- \>\chcommand{usepackage[xcolor=dvipdf]\{changes\}}\\
- \>\chcommand{usepackage[xcolor=\{dvipdf,gray\}]\{changes\}}
-\end{chusage}
+\chexample{usepackage_xcolor_changes}
%^^A -- Change management ----------------------------------------------------------
\subsection{Change management}
-\label{sec:user:changemanagement}
+\label{sec:ui:changemanagement}
+
+\localtableofcontents
-All examples use comment markup \emph{uwave}, because todo notes or margin notes are not allowed in tabbing environments (see \autoref{sec:limitations}).
+\chnewcmd{added}
-\subsubsection{\chcommand{added}}
-\DescribeMacro{\added}
+\chinline{added}
-The command \chcommand{added} marks new text.
-The new text is the mandatory argument for the command, thus it is written in curly braces.
+The command \chcommand{added} marks newly added text.
+The new text is given in curly braces.
The optional argument contains key-value-pairs for author-id and comment.
The author-id has to be defined using \chcommand{definechangesauthor}.
@@ -500,103 +521,85 @@ If the comment contains special characters or spaces, use curly brackets to encl
If a comment is given, the direct author markup at the changes text is omitted, because the author is printed in the comment.
-\begin{chusage}
- \>\chcommand{added[id=\meta{author's id}, comment=\meta{comment}]\{\meta{new text}\}}\\
- \usageexample
- \>\texttt{This is \chcommand{added}[id=EK]\{new\} text.}\\
- \>This is \added[id=EK]{new} text.\\
- \>\texttt{This is \chcommand{added}[id=EK, comment=\{has to be in it\}]\{new\} text.}\\
- \>This is \added[id=EK, comment={has to be in it}]{new} text.\\
- \>\texttt{This is \chcommand{added}[comment=anonymous]\{new\} text.}\\
- \>This is \added[comment=anonymous]{new} text.
-\end{chusage}
+\chexample{added}
+\chresult{added}
-\subsubsection{\chcommand{deleted}}
-\DescribeMacro{\deleted}
+\chnewcmd{deleted}
+
+\chinline{deleted}
The command \chcommand{deleted} marks deleted text.
-For arguments see \chcommand{added}.
+The deleted text is given in curly braces.
+
+For the optional arguments see \chcommand{added} (\autoref{sec:ui:cmd:added}).
+
+\chexample{deleted}
+\chresult{deleted}
-\begin{chusage}
- \>\chcommand{deleted[id=\meta{author's id}, comment=\meta{comment}]\{\meta{deleted text}\}}\\
- \usageexample
- \>\texttt{This is \chcommand{deleted}[comment=obsolete]\{bad\} text.}\\
- \>This is \deleted[comment=obsolete]{bad} text.
-\end{chusage}
-\subsubsection{\chcommand{replaced}}
-\DescribeMacro{\replaced}
+\chnewcmd{replaced}
+
+\chinline{replaced}
The command \chcommand{replaced} marks replaced text.
-Mandatory arguments are the new text and the old text.
-For optional arguments see \chcommand{added}.
+The new and the replaced text are given in this order in curly braces.
+
+For the optional arguments see \chcommand{added} (\autoref{sec:ui:cmd:added}).
-\begin{chusage}
- \>\chcommand{replaced[id=\meta{author's id}, comment=\meta{comment}]\{\meta{new text}\}\{\meta{old text}\}}\\
- \usageexample
- \>\texttt{This is \chcommand{replaced}[id=EK]\{nice\}\{bad\} text.}\\
- \>This is \replaced[id=EK]{nice}{bad} text.
-\end{chusage}
+The output of replaced text is a combination of added and deleted text, thus any change in their layout influences the layout of replaced text.
+
+\chexample{replaced}
+\chresult{replaced}
%^^A -- Highlighting and Comments ------------------------------------------------------
\subsection{Highlighting and Comments}
-\label{sec:user:comment}
+\label{sec:ui:comment}
-\subsubsection{\chcommand{highlight}}
-\DescribeMacro{\highlight}
+\localtableofcontents
-The command \chcommand{highlight} highlights text and adds a comment to the document.
-The highlighted text is the mandatory argument for the command, thus it is written in curly braces.
+\chnewcmd{highlight}
-The optional argument contains key-value-pairs for author-id and comment.
-The author-id has to be defined using \chcommand{definechangesauthor}.
-If the comment contains special characters or spaces, use curly brackets to enclose the comment.
+\chinline{highlight}
-If a comment is given, the direct author markup at the changes text is omitted, because the author is printed in the comment.
+The command \chcommand{highlight} highlights text.
+The highlighted text is given in curly braces.
-\begin{chusage}
- \>\chcommand{highlight[id=\meta{author's id}, comment=\meta{comment}]\{\meta{highlighted text}\}}\\
- \usageexample
- \>\texttt{This is \chcommand{highlight}[id=EK, comment=\{my comment\}]\{highlighted\} text.}\\
- \>This is \highlight[id=EK, comment={my comment}]{highlighted} text.\\
- \>\texttt{This is \chcommand{highlight}[comment=\{anonymous comment\}\{anonymously highlighted\} text.}\\
- \>This is \highlight[comment={anonymous comment}]{anonymously highlighted} text.
-\end{chusage}
+For the optional arguments see \chcommand{added} (\autoref{sec:ui:cmd:added}).
-\subsubsection{\chcommand{comment}}
-\DescribeMacro{\comment}
+\chexample{highlight}
+\chresult{highlight}
+
+
+\chnewcmd{comment}
+
+\chinline{comment}
The command \chcommand{comments} adds a comment to the document.
-The comment is the mandatory argument for the command, thus it is written in curly braces.
+The comment is given in curly braces.
-The optional argument contains a key-value-pair for the author-id.
+The command has only one optional argument: a key-value-pair for the author-id.
The author-id has to be defined using \chcommand{definechangesauthor}.
-The comments are numbered, the number is printed in the comment.
+The comments are numbered automatically, the number is printed in the comment.
-\begin{chusage}
- \>\chcommand{comment[id=\meta{author's id}]\{\meta{comment}\}}\\
- \usageexample
- \>\texttt{This is commented\chcommand{comment}[id=EK]\{my comment\} text.}\\
- \>This is commented\comment[id=EK]{my comment} text.\\
- \>\texttt{This is commented\chcommand{comment}\{anonymous comment\} text.}\\
- \>This is commented\comment{anonymous comment} text.
-\end{chusage}
+\chexample{comment}
+\chresult{comment}
%^^A -- Overview of changes
\subsection{Overview of changes}
-\label{sec:user:overview}
+\label{sec:ui:overview}
+
+\chnewcmd{listofchanges}
-\subsubsection{\chcommand{listofchanges}}
-\DescribeMacro{\listofchanges}
+\chinline{listofchanges}
The command \chcommand{listofchanges} outputs a list or summary of changes.
The first \hologo{LaTeX}-run creates an auxiliary file, the second run uses the data of this file.
@@ -604,21 +607,21 @@ Therefore you need two \hologo{LaTeX}-runs for an up-to-date list of changes.
There are three optional arguments:
-\begin{itemize}
- \item style
- \item title
- \item show
-\end{itemize}
+\begin{description}
+ \item[\choption{style}] list style
+ \item[\choption{title}] individual title
+ \item[\choption{show}] markup types
+\end{description}
\paragraph{style}
The \choption{style} argument defines the layout of the list of changes.
-There are three styles allowed:
+Three styles are defined:
-\begin{itemize}
- \item \choption{list} -- prints the list of changes like a list of figures (default)
- \item \choption{summary} -- prints the number of changes grouped by author
- \item \choption{compactsummary} -- same as \choption{summary} but entries with count 0 are omitted
-\end{itemize}
+\begin{description}
+ \item[\choption{list}] prints the list of changes like a list of figures (default)
+ \item[\choption{summary}] prints the number of changes grouped by author
+ \item[\choption{compactsummary}] same as \choption{summary} but entries with count 0 are omitted
+\end{description}
\paragraph{title}
The \choption{title} argument is used to change the title for the list.
@@ -626,200 +629,208 @@ If you want to use special characters or spaces in the title, enclose it in curl
\paragraph{show}
The \choption{show} argument defines which types of change markup are shown in the list of changes.
-The following values are allowed:
-
-\begin{itemize}
- \item \choption{all} -- show all types (default)
- \item \choption{added} -- show only additions
- \item \choption{deleted} -- show only deletions
- \item \choption{replaced} -- show only replacements
- \item \choption{highlight} -- show only highlights
- \item \choption{comment} -- show only comments
-\end{itemize}
-
You can combine the values using the \texttt{|} character.
For example if you want to show all additions and deletions, use \texttt{show=added|deleted}.
-\begin{chusage}
- \>\chcommand{listofchanges}\texttt{[style=<list|summary|compactsummary>, title=<title>,}\\
- \>\>\texttt{show=<type>]}\\
- \usageexample
- \>\chcommand{listofchanges}\\
- \>\chcommand{listofchanges[style=list]} \Corresponds\ \chcommand{listofchanges}\\
- \>\chcommand{listofchanges[style=summary, title=\{My Summary\}]}\\
- \>\chcommand{listofchanges[title=\{List of comments\}, show=comment]}
-\end{chusage}
+The following values are defined:
+
+\begin{description}
+ \item[\choption{all}] show all types (default)
+ \item[\choption{added}] show only additions
+ \item[\choption{deleted}] show only deletions
+ \item[\choption{replaced}] show only replacements
+ \item[\choption{highlight}] show only highlights
+ \item[\choption{comment}] show only comments
+\end{description}
+
+\chexample{listofchanges}
%^^A -- Author management -----------------------------------------------------
\subsection{Author management}
-\label{sec:user:authormanagement}
+\label{sec:ui:authormanagement}
-\subsubsection{\chcommand{definechangesauthor}}
-\DescribeMacro{\definechangesauthor}
+\chnewcmd{definechangesauthor}
+
+\chinline{definechangesauthor}
The command \chcommand{definechangesauthor} defines a new author for changes.
You have to define a unique author's id, special characters or spaces are not allowed within the author's id.
+
You may define a corresponding color and the author's name.
If you do not define a color, blue is used.
-The author's name is used in the list of changes and in the markup, if you set the corresponding option.
-\begin{chusage}
- \>\chcommand{definechangesauthor[name=\{\meta{author's name}\}, color=\{\meta{color}\}]\{\meta{author's id}\}}\\
- \usageexample
- \>\chcommand{definechangesauthor\{EK\}}\\
- \>\chcommand{definechangesauthor[color=orange]\{EK\}}\\
- \>\chcommand{definechangesauthor[name=\{Ekkart Kleinod\}]\{EK\}}\\
- \>\chcommand{definechangesauthor[name=\{Ekkart Kleinod\}, color=orange]\{EK\}}
-\end{chusage}
+The author's name is used in the list of changes and in the markup if you set the corresponding option.
+
+The package predefines one anonymous author without id.
+
+\chexample{definechangesauthor}
%^^A -- Adaptation of the output -----------------------------------------------------
\subsection{Adaptation of the output}
-\label{sec:user:customizingoutput}
+\label{sec:ui:customizingoutput}
+
+\localtableofcontents
+\chnewcmd{setaddedmarkup}
-\subsubsection{\chcommand{setaddedmarkup}}
-\DescribeMacro{\setaddedmarkup}
+\chinline{setaddedmarkup}
The command \chcommand{setaddedmarkup} defines the layout of added text.
The default markup is colored text, or the markup set with the option \choption{markup} respectively \choption{addedmarkup}.
-Values for definition: any \hologo{LaTeX}-commands, added text can be used with ``\#1''.
+Values for definition:
+
+\begin{itemize}
+ \item any \hologo{LaTeX}-commands
+ \item added text can be used with ``\#1''
+\end{itemize}
+
+The output of replaced text is a combination of added and deleted text, thus any change in their layout influences the layout of replaced text.
+
+\chexample{setaddedmarkup}
-\begin{chusage}
- \>\chcommand{setaddedmarkup\{\meta{definition}\}}\\
- \usageexample
- \>\chcommand{setaddedmarkup\{}\chcommand{emph\{\#1\}}\}\\
- \>\chcommand{setaddedmarkup\{+++: \#1\}}
-\end{chusage}
+\chnewcmd{setdeletedmarkup}
-\subsubsection{\chcommand{setdeletedmarkup}}
-\DescribeMacro{\setdeletedmarkup}
+\chinline{setdeletedmarkup}
The command \chcommand{setdeletedmarkup} defines the layout of deleted text.
The default markup is striked-out, or the markup set with the option \choption{markup} respectively \choption{deletedmarkup}.
-Values for definition: any \hologo{LaTeX}-commands, deleted text can be used with ``\#1''.
+Values for definition:
-\begin{chusage}
- \>\chcommand{setdeletedmarkup\{\meta{definition}\}}\\
- \usageexample
- \>\chcommand{setdeletedmarkup\{}\chcommand{emph\{\#1\}}\}\\
- \>\chcommand{setdeletedmarkup\{-\,-\,-: \#1\}}
-\end{chusage}
+\begin{itemize}
+ \item any \hologo{LaTeX}-commands
+ \item deleted text can be used with ``\#1''
+\end{itemize}
+The output of replaced text is a combination of added and deleted text, thus any change in their layout influences the layout of replaced text.
-\subsubsection{\chcommand{sethighlightmarkup}}
-\DescribeMacro{\sethighlightmarkup}
+\chexample{setdeletedmarkup}
+
+
+\chnewcmd{sethighlightmarkup}
+
+\chinline{sethighlightmarkup}
The command \chcommand{sethighlightmarkup} defines the layout of highlighted text.
The default markup is via a background color, or the markup set with the option \choption{markup} respectively \choption{highlightmarkup}.
-Values for definition: any \hologo{LaTeX}-commands, highlighted text can be used with ``\#1''.
-The author's color can be used with ``authorcolor''.
+Values for definition:
-\begin{chusage}
- \>\chcommand{sethighlightmarkup\{\meta{definition}\}}\\
- \usageexample
- \>\chcommand{sethighlightmarkup\{}\chcommand{emph\{\#1\}}\}\\
- \>\chcommand{sethighlightmarkup\{\chcommand{ifthenelse}\{\chcommand{isColored}\}\{\chcommand{color}\{authorcolor!60\}\}\{\}!!: \#1\}}
-\end{chusage}
+\begin{itemize}
+ \item any \hologo{LaTeX}-commands
+ \item highlighted text can be used with ``\#1''
+ \item \chpackage{ifthenelse} boolean test for colored text ``\chcommand{isColored}''
+ \item author's color can be used with color ``authorcolor''
+\end{itemize}
+\chexample{sethighlightmarkup}
-\subsubsection{\chcommand{setcommentmarkup}}
-\DescribeMacro{\setcommentmarkup}
+
+\chnewcmd{setcommentmarkup}
+
+\chinline{setcommentmarkup}
The command \chcommand{setcommentmarkup} defines the layout of comments.
The default markup is a margin note, or the markup set with the option \choption{markup} respectively \choption{commentmarkup}.
-Values for definition: any \hologo{LaTeX}-commands, comment text can be used with ``\#1'', author's id with ``\#2'', and author output (id or name) with ``\#3''.
-The author's color can be used with ``authorcolor'' and the comment count of the autor is stored in ``authorcommentcount''.
+Values for definition:
-\begin{chusage}
- \>\chcommand{setcommentmarkup\{\meta{definition}\}}\\
- \usageexample
- \>\chcommand{setcommentmarkup\{--- \#1 ---\}}\\
- \>\chcommand{setcommentmarkup}\{\chcommand{ifthenelse}\{\chcommand{isColored}\}\{\chcommand{color}\{authorcolor\}\}\{\}\#1\}\\
- \>\chcommand{setcommentmarkup}\{\chcommand{ifthenelse}\{\chcommand{isAnonymous\{\#2\}}\}\{\}\{\chcommand{textbf}\{\#3: \}\}\#1\}\\
- \>\chcommand{setcommentmarkup}\{[\chcommand{arabic}\{authorcommentcount\}] \#1\}
-\end{chusage}
+\begin{itemize}
+ \item any \hologo{LaTeX}-commands
+ \item comment can be used with ``\#1''
+ \item author's id can be used with ``\#2''
+ \item author output (id or name) can be used with ``\#3''
+ \item \chpackage{ifthenelse} boolean test for anonymous author ``\chcommand{isAnonymous}''
+ \item \chpackage{ifthenelse} boolean test for colored text ``\chcommand{isColored}''
+ \item author's color can be used with color ``authorcolor''
+ \item comment count of the autor can be used with counter ``authorcommentcount''
+\end{itemize}
+\chexample{setcommentmarkup}
-\subsubsection{\chcommand{setauthormarkup}}
-\DescribeMacro{\setauthormarkup}
+\chnewcmd{setauthormarkup}
+
+\chinline{setauthormarkup}
The command \chcommand{setauthormarkup} defines the layout of the author's markup in the text.
The default markup is a superscripted author's text.
-Values for definition: any \hologo{LaTeX}-commands, author's text can be used with ``\#1''.
+Values for definition:
+
+\begin{itemize}
+ \item any \hologo{LaTeX}-commands
+ \item author output (id or name) can be used with ``\#1''
+\end{itemize}
+
+\chexample{setauthormarkup}
-\begin{chusage}
- \>\chcommand{setauthormarkup\{\meta{definition}\}}\\
- \usageexample
- \>\chcommand{setauthormarkup\{(\#1)\}}\\
- \>\chcommand{setauthormarkup\{(\#1)\textasciitilde{}-{}-\textasciitilde{}\}}\\
- \>\chcommand{setauthormarkup\{}\chcommand{marginpar\{\#1\}\}}
-\end{chusage}
+\chnewcmd{setauthormarkupposition}
-\subsubsection{\chcommand{setauthormarkupposition}}
-\DescribeMacro{\setauthormarkupposition}
+\chinline{setauthormarkupposition}
The command \chcommand{setauthormarkupposition} defines the position of the author's markup relative to the changed text.
The default position is right of the changed text.
-Possible values: \emph{left} == left of the changes; all other values: right
+The following values for \emph{authormarkupposition} are defined:
-\begin{chusage}
- \>\chcommand{setauthormarkupposition\{\meta{position}\}}\\
- \usageexample
- \>\chcommand{setauthormarkupposition\{left\}}
-\end{chusage}
+\begin{description}
+ \item [\choption{right}] right of the text -- text\textsuperscript{author} (default)
+ \item [\choption{left}] left of the text -- \textsuperscript{author}text
+\end{description}
+\chexample{setauthormarkupposition}
-\subsubsection{\chcommand{setauthormarkuptext}}
-\DescribeMacro{\setauthormarkuptext}
+\chnewcmd{setauthormarkuptext}
+
+\chinline{setauthormarkuptext}
The command \chcommand{setauthormarkuptext} defines the text for the author's markup.
The default markup is the author's id.
-Possible values: \emph{name} == author's name; all other values: author's id
+The following values for \emph{authormarkuptext} are defined:
+
+\begin{description}
+ \item [\choption{id}] author's id -- text\textsuperscript{id} (default)
+ \item [\choption{name}] author's name -- text\textsuperscript{authorname}
+\end{description}
-\begin{chusage}
- \>\chcommand{setauthormarkuptext\{\meta{text}\}}\\
- \usageexample
- \>\chcommand{setauthormarkuptext\{name\}}
-\end{chusage}
+\chexample{setauthormarkuptext}
-\subsubsection{\chcommand{settruncatewidth}}
-\DescribeMacro{\settruncatewidth}
+\chnewcmd{settruncatewidth}
-The command \chcommand{settruncatewidth} sets the width of the truncation in the list of changes to the given value.
+\chinline{settruncatewidth}
+
+The command \chcommand{settruncatewidth} sets the width of the truncation in the list of changes to the given width.
The default width is \texttt{0.6}\chcommand{textwidth}.
\chexample{settruncatewidth}
-\subsubsection{\chcommand{setsummarywidth}}
-\DescribeMacro{\setsummarywidth}
+\chnewcmd{setsummarywidth}
+
+\chinline{setsummarywidth}
-The command \chcommand{setsummarywidth} sets the width of the list of changes in summary style to the given length.
+The command \chcommand{setsummarywidth} sets the width of the list of changes in summary style to the given width.
The default width is \texttt{0.3}\chcommand{textwidth}.
\chexample{setsummarywidth}
-\subsubsection{\chcommand{setsummarytowidth}}
-\DescribeMacro{\setsummarytowidth}
+\chnewcmd{setsummarytowidth}
+
+\chinline{setsummarytowidth}
The command \chcommand{setsummarytowidth} sets the width of the list of changes in summary style to the width of the given text.
@@ -827,26 +838,26 @@ The command \chcommand{setsummarytowidth} sets the width of the list of changes
-\subsubsection{\chcommand{setsocextension}}
-\DescribeMacro{\setsocextension}
+\chnewcmd{setsocextension}
+
+\chinline{setsocextension}
The command \chcommand{setsocextension} sets the extension of the auxiliary file for the summary of changes (soc-file\footnote{%
``soc'' stands for ``summary of changes''.
}).
The default extension is ``\texttt{soc}''.
-In the example stated below, the soc-file for ``\texttt{foo.tex}'' would be named ``\texttt{foo.changes}'' instead of the default name ``\texttt{foo.soc}''.
-\begin{chusage}
- \>\chcommand{setsocextension\{\meta{extension}\}}\\
- \usageexample
- \>\chcommand{setsocextension\{changes\}}
-\end{chusage}
+In the example, the soc-file for ``\texttt{foo.tex}'' would be named ``\texttt{foo.changes}'' resp.\ ``\texttt{foo.chg}'' instead of the default name ``\texttt{foo.soc}''.
+
+\chexample{setsocextension}
+
+\chimportant{Do not use a \hologo{LaTeX} standard file extension, such as ``toc'' or ``loc'', as this would collide with the normal \hologo{LaTeX} run.}
%^^A -- packages
\subsection{Used packages}
-\label{sec:user:packages}
+\label{sec:ui:packages}
The \chpackage{changes}-package uses already existing packages for it's functions.
You will find detailed description of the packages in their distributions.
@@ -879,6 +890,7 @@ Thanks.
The authors are (in alphabetical order):
\begin{itemize}
\item Chiaradonna, Silvano
+ \item Cui, Yvon
\item Fischer, Ulrike
\item Giovannini, Daniele
\item Kleinod, Ekkart
@@ -912,8 +924,8 @@ If you are interested in planned new features, please see
Copyright 2007-2018 Ekkart Kleinod (\href{mailto:ekleinod@edgesoft.de}{ekleinod@edgesoft.de})
-This work may be distributed and/or modified under the conditions of the \hologo{LaTeX}\ Project Public License, either version~1.3 of this license or any later version.
-The latest version of this license is in \url{http://www.latex-project.org/lppl.txt} and version~1.3 or later is part of all distributions of \hologo{LaTeX}\ version 2005/12/01 or later.
+This work may be distributed and/or modified under the conditions of the \hologo{LaTeX} Project Public License, either version~1.3 of this license or any later version.
+The latest version of this license is in \url{http://www.latex-project.org/lppl.txt} and version~1.3 or later is part of all distributions of \hologo{LaTeX} version 2005/12/01 or later.
This work has the LPPL maintenance status ``maintained''.
The current maintainer of this work is Ekkart Kleinod.