acro (16jan21)

git-svn-id: svn://tug.org/texlive/trunk@57447 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 75 insertions, 11 deletions

diff --git a/Master/texmf-dist/doc/latex/acro/README b/Master/texmf-dist/doc/latex/acro/README
index 8f09cc322b6..b0382e13026 100644
--- a/Master/texmf-dist/doc/latex/acro/README
+++ b/Master/texmf-dist/doc/latex/acro/README
@@ -1,5 +1,5 @@
---------------------------------------------------------------------------
-the ACRO package v3.4 2020/12/25
+#--------------------------------------------------------------------------
+the ACRO package v3.5 2021/01/16
 
   Typeset Acronyms
 
@@ -8,7 +8,7 @@ Clemens Niederberger
 Web:    https://github.com/cgnieder/acro
 E-Mail: contact@mychemistry.eu
 --------------------------------------------------------------------------
-Copyright 2012--2020 Clemens Niederberger
+Copyright 2012--2021 Clemens Niederberger
 
 This work may be distributed and/or modified under the
 conditions of the LaTeX Project Public License, either version 1.3c
@@ -26,6 +26,7 @@ The acro package consists of code files:
 
   acro.sty
   acro2.sty
+  acro-examples.sty
 
 The acro package consists of documentation files:
 
diff --git a/Master/texmf-dist/doc/latex/acro/acro-manual.pdf b/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
index 24026d28a35..54c8b151c6d 100644
--- a/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
+++ b/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
diff --git a/Master/texmf-dist/doc/latex/acro/acro-manual.tex b/Master/texmf-dist/doc/latex/acro/acro-manual.tex
index 4f2a5d2442a..b8288eb6ca7 100644
--- a/Master/texmf-dist/doc/latex/acro/acro-manual.tex
+++ b/Master/texmf-dist/doc/latex/acro/acro-manual.tex
@@ -1,3 +1,5 @@
+% arara: pdflatex
+% arara: pdflatex
 % --------------------------------------------------------------------------
 % the ACRO package
 % 
@@ -8,7 +10,7 @@
 % Web:    https://github.com/cgnieder/acro/
 % E-Mail: contact@mychemistry.eu
 % --------------------------------------------------------------------------
-% Copyright 2011--2020 Clemens Niederberger
+% Copyright 2011--2021 Clemens Niederberger
 % 
 % This work may be distributed and/or modified under the
 % conditions of the LaTeX Project Public License, either version 1.3c
@@ -218,7 +220,7 @@
 \clearpage
 \part{Get started with \acro}\label{part:get-started-with}
 
-\section{Licence and requirements}\label{sec:licence-requirements}
+\section{Licence}\label{sec:licence}
 \license
 
 \section{Glossary}
@@ -409,7 +411,7 @@ the same.  In that case you can use
   %% sort
   \propval{sort}{text}\Default={short}
     If used the acronym will be sorted according to this property instead of
-    its \ac{id}.
+    its short form.
   %% tag
   \propval{tag}{csv list}\Default
     The tag(s) of an acronym.
@@ -432,6 +434,11 @@ the same.  In that case you can use
     value of the \property{sort} property.  This property allows to set an
     individual sorting option for the index.  See section~\vref{sec:indexing}
     for details.
+  %% index-cmd
+  \propval{index-cmd}{index command}\Default
+    This sets the indexing command for the acronym.  If unused then the
+    command set by the corresponding option is used.  See
+    section~\vref{sec:indexing} for details.
 \end{properties}
 
 \subsection{Properties related to plural and indefinite forms}\label{sec:prop-relat-plur}
@@ -585,8 +592,32 @@ the same.  In that case you can use
     set then the appropriate value might be derived from
     \property{foreign-babel}. See section~\vref{sec:fore-lang-acronyms} for
     details.
+  %% preset
+  \propval{preset}{set name}\Default
+    \sinceversion{3.5}Enables to load a set of properties that has been
+    defined earlier with \cs{NewAcroPreset}, siehe
+    section~\vref{sec:presets}.
+  %% uselist
+  \propval{uselist}{csv list of acronym ids}\Default
+    \sinceversion{3.5}If this property is given and all acronyms specified in
+    this property have been used before the first time the current acronym is
+    used it behaves as if it has been used before.
 \end{properties}
 
+\subsection{Presets}\label{sec:presets}
+\sinceversion{3.5}Sometimes it can be useful to have different kinds of
+acronyms or abbreviations or similar which share a common set of properties.
+Such sets can be defined with these commands:
+\begin{commands}
+  \command{NewAcroPreset}[\marg{set name}\marg{csv list of properties}]
+    Defines the property set \meta{set name}.  Any valid property can be set
+    in \meta{csv list of properties}.
+  \command{RenewAcroPreset}[\marg{set name}\marg{csv list of properties}]
+    Redefines the property set \meta{set name}.
+  \command{DeclareAcroPreset}[\marg{set name}\marg{csv list of properties}]
+    Defines or redefines the property set \meta{set name} without checking.
+\end{commands}
+
 \section{Using acronyms}\label{sec:using-acronyms}
 There are a number of commands to use acronyms with. Their names always follow
 the same pattern which should make their usage intuitive immediately.
@@ -883,12 +914,18 @@ the list of acronym you can use these options:
     The threshold for a page range to be turned into \latin{sequentes}.  A
     page range above the threshold is still typeset as a range:
     \meta{num1}--\meta{num2}.
-  \keyval{fill}{code}\Module{pages}\Default{\cs*{dotfill}}
+  \keyval{fill}{code}\Module{pages}\Default{\cs*{acrdotfill}}
     This is the code that is placed between acronym description and actual
     page numbers.
   \keybool{name}\Module{pages}\Default{false}
     If set to true the page numbers are preceded with p.\ or pp.
 \end{options}
+\begin{commands}
+  \command{acrodotfill}
+    \sinceversion{3.5}Creates a dotted line like those in the table of
+    contents.  If the macro \cs*{cftdotfill} is defined it is equal to
+    \cs*{cftdotfill}\Marg{\cs*{cftdotsep}}.
+\end{commands}
 Additionally\sinceversion{3.3} to setting these options with \cs{acsetup} they
 can be set as options to \cs{printacronyms}:
 \begin{sourcecode}
@@ -1274,7 +1311,7 @@ have no effect, of course.
   }
 \end{sourcecode}
 
-\pagebreak
+% \pagebreak
 
 There are a number of options to control the uppercasing behavior:
 \begin{options}
@@ -1370,8 +1407,10 @@ Maybe you want to add your acronyms to an index. In that case it is probably
 desirable to let \acro\ make this automatically.  In the simplest case just
 enable it:
 \begin{options}
-  \keybool{use}\Module{index}\Default{false}
-    Enable indexing.
+  \keychoice{use}{\default{true},false,indexed}\Module{index}\Default{false}
+    \changedversion{3.5}Enable indexing.  If \code{indexed} is chosen only the
+    acronyms for which the property \property{index} has been set are indexed.
+    With \code{true} \emph{all} acronyms are indexed.
   \keyval{cmd}{index command}\Module{index}\Default{\cs*{index}}
     Choose a command for indexing.
   \keyval{disable}{code}\Module{index}\Default{\cs*{def}\cs*{@}\{\}}
@@ -1568,6 +1607,10 @@ option:
   \keybool{make-links}\Default{false}
     If this is activated then every short or alternative appearance of an
     acronym will be linked to its description in the list of acronyms.
+  \keybool{link-only-first}\Default{false}
+    \sinceversion{3.5}If this is activated in addition to \option{make-links}
+    then \emph{only the first} short or alternative appearance of an acronym
+    will be linked to its description in the list of acronyms.
 \end{options}
 \begin{bewareofthedog}
   This will fail miserably together with local lists if an acronym appears in
@@ -1883,7 +1926,7 @@ to defines own such objects:
     page ranges.
 \end{templates}
 
-\subsubsection{Header templates}
+\subsubsection{Heading templates}
 \begin{templates}
   \tmpl{addchap}
     Only defined in a \KOMAScript\ class and if \cs*{chapter} is defined. Uses
@@ -1985,9 +2028,22 @@ and \cs*{acroifF} each have an argument less than \cs*{acroifTF}.
   \command{acroiftag\TF}[\marg{tag}\marg{true}\marg{false}]
     Checks if the current acronym has been given the tag \meta{tag} and either
     leaves \meta{true} or \meta{false} in the input stream.
+  \command{acroifstarred\TF}[\marg{true}\marg{false}]
+    \sinceversion{3.5}Checks if the current call of the acronym is a starred
+    command or not and either leaves \meta{true} or \meta{false} in the input
+    stream.
   \command{AcroPropertiesMap}[\marg{code}]
     Maps over all defined acronym properties.  Within \meta{code} you can
     refer to the current property with \code{\#1}.
+  \command{AcroAcronymsMap}[\marg{code}]
+    \sinceversion{3.5}Maps over all defined acronyms.  Within \meta{code} you
+    can refer to the current property with \code{\#1} or with \cs{AcronymID}.
+  \command{AcroMapBreak}
+    \sinceversion{3.5}Stops the map \cs{AcroAcronymsMap} and is usually used
+    in combination with a boolean check.
+  \command{AcroPropertiesSet}[\marg{id}\marg{csv list of properties}]
+    \sinceversion{3.5}Allows the setting of properties of acronym \meta{id}
+    outside of \cs{declareAcronym}.
 \end{commands}
 
 \subsubsection{Commands for usage in acronym templates}
@@ -2173,6 +2229,13 @@ first the table body is built and only then the table itself is printed:
 \end{sourcecode}
 
 \subsection{New heading templates}\label{sec:new-head-templ}
+Let's take a look at the two templates \template{section} and
+\template{section*} which should give you enough information to build your
+own:
+\begin{sourcecode}
+  \NewAcroTemplate[heading]{section} {\section {\acrolistname}}
+  \NewAcroTemplate[heading]{section*}{\section*{\acrolistname}}
+\end{sourcecode}
 
 \section{Endings}\label{sec:endings}
 Referring to section~\vref{sec:other-endings} this section explains how to