summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-05-04 21:24:10 +0000
committerKarl Berry <karl@freefriends.org>2020-05-04 21:24:10 +0000
commitd1beff40fcdadc8357ad31e0d8238e255f782ac5 (patch)
tree2e032a5b28c70fabd322a7854b03946d4e5e46a3 /Master/texmf-dist/doc
parent20594dd52356ceb2c603cac9ef3963fdcad31f4c (diff)
acro (3may20)
git-svn-id: svn://tug.org/texlive/trunk@55016 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/acro/README2
-rw-r--r--Master/texmf-dist/doc/latex/acro/acro-manual.pdfbin851941 -> 868396 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/acro-manual.tex56
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.acflike.pdfbin21224 -> 20922 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.issue-119.tex2
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.pdfbin32429 -> 32432 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.tex20
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-507726.tex25
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.units.tex6
9 files changed, 60 insertions, 51 deletions
diff --git a/Master/texmf-dist/doc/latex/acro/README b/Master/texmf-dist/doc/latex/acro/README
index 1af233ac328..9b6b9df588a 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.0 2020/04/29
+the ACRO package v3.1 2020/05/03
Typeset Acronyms
diff --git a/Master/texmf-dist/doc/latex/acro/acro-manual.pdf b/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
index adcbb7fb30f..5c2310f650b 100644
--- a/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
+++ b/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/acro/acro-manual.tex b/Master/texmf-dist/doc/latex/acro/acro-manual.tex
index 6470c95ba46..af5e2387c6e 100644
--- a/Master/texmf-dist/doc/latex/acro/acro-manual.tex
+++ b/Master/texmf-dist/doc/latex/acro/acro-manual.tex
@@ -1,8 +1,3 @@
-% arara: pdflatex: { interaction: nonstopmode }
-% !arara: biber
-% arara: pdflatex: { interaction: nonstopmode }
-% !arara: pdflatex: { interaction: nonstopmode }
-% !arara: pdflatex: { interaction: nonstopmode }
% --------------------------------------------------------------------------
% the ACRO package
%
@@ -16,25 +11,17 @@
% Copyright 2011--2020 Clemens Niederberger
%
% This work may be distributed and/or modified under the
-% conditions of the LaTeX Project Public License, either version 1.3
+% conditions of the LaTeX Project Public License, either version 1.3c
% of this license or (at your option) any later version.
% The latest version of this license is in
% http://www.latex-project.org/lppl.txt
-% and version 1.3 or later is part of all distributions of LaTeX
-% version 2005/12/01 or later.
+% and version 1.3c or later is part of all distributions of LaTeX
+% version 2008/05/04 or later.
%
% This work has nce status `maintained'.
%
% The Current Maintainer of this work is Clemens Niederberger.
% --------------------------------------------------------------------------
-% The acro package consists of the files
-% - acro.sty, acro.definitions.tex, acro.cfg
-% - acro-manual.tex, acro-manual.pdf, acro-manual.cls
-% - acro.history, README
-% --------------------------------------------------------------------------
-% If you have any ideas, questions, suggestions or bugs to report, please
-% feel free to contact me.
-% --------------------------------------------------------------------------
\PassOptionsToPackage{ngerman,latin,english}{babel}
\PassOptionsToPackage{version=3,upgrade}{acro}
\documentclass{acro-manual}
@@ -190,19 +177,22 @@
tag = glossary , no-index
}
\DeclareAcronym{option}{
- long = An \option*{option} is a package option of \acro\ which must set
- with \cs*{acsetup}. It \emph{cannot} be set as option to \cs*{usepackage}. ,
+ long = {An \option*{option} is a package option of \acro\ which must set
+ with \cs*{acsetup}. It \emph{cannot} be set as option to \cs*{usepackage}.
+ Options usually also can be set in the optional argument of \cs*{ac} and
+ friends.} ,
tag = glossary , no-index
}
\DeclareAcronym{load-time option}{
- long = A load-time \option*{option} is a package option of \acro\ which must
- be set as option to \cs*{usepackage}\oarg{options}\Marg{acro}. ,
+ long = {A load-time \option*{option} is a package option of \acro\ which
+ \emph{must} be set as option to
+ \cs*{usepackage}\oarg{options}\Marg{acro}.} ,
tag = glossary , no-index
}
\DeclareAcronym{template}{
- long = A template determines how different objects of \acro\ are printed.
+ long = {A template determines how different objects of \acro\ are printed.
This includes the acronyms themselves but also for example the list of
- acronyms as a whole. ,
+ acronyms as a whole.} ,
tag = glossary , no-index
}
\DeclareAcronym{articles}{
@@ -216,12 +206,11 @@
tag = glossary , no-index
}
\DeclareAcronym{translations}{
- long = Localisation strings which can be modified. ,
+ long = {Localisation strings which can be modified.} ,
tag = glossary , no-index
}
\newcommand*\issues{\url{https://github.com/cgnieder/acro/issues}}
-
\newcommand*\latin[1]{\textit{#1}}
\begin{document}
@@ -661,6 +650,13 @@ Then typical outputs look like this:
\acfp{ufo}
\end{example}
+\begin{bewareofthedog}
+ In a number of contexts all acronym commands act as if their starred form is
+ used: in the table of contents, in the list of figures, and in the list of
+ tables. The same is true for floats and the measuring phase of common
+ table environments like \env*{tabularx} or \env*{ltxtable}.
+\end{bewareofthedog}
+
\section{Alternative short forms}\label{sec:altern-short-forms}
Sometimes expressions have two different short forms. And example might be
\acs*{jpg} which also often is \aca*{jpg}. This is what the property
@@ -1181,6 +1177,8 @@ properties for such cases:
\end{properties}
There are also some options:
\begin{options}
+ \keybool{display}\Module{foreign}\Default{true}
+ Determine wether to hide or display the foreign form.
\keybool{display}\Module{locale}\Default{false}
This options determines wether the language of the foreign form is printed
or not when the full form of the acronym is printed.
@@ -1527,6 +1525,13 @@ used. You have already seen one of the commands which make it possible:
Every acronym will be reset.
\end{commands}
+\begin{bewareofthedog}
+ In a number of contexts all acronym commands act as if their starred form is
+ used: in the table of contents, in the list of figures, and in the list of
+ tables. The same is true for floats and the measuring phase of common
+ table environments like \env*{tabularx} or \env*{ltxtable}.
+\end{bewareofthedog}
+
\section{Bookmarks, backlinks and accessibility support}\label{sec:pdf-properties}
\subsection{Backlinks}\label{sec:backlinks}
When \acro\ is used together with the package
@@ -1881,6 +1886,9 @@ and \cs*{acroifF} each have an argument less than \cs*{acroifTF}.
\command{acroif\TF}[\marg{property}\marg{true}\marg{false}]
Checks if the property \meta{property} has been set for the current
acronym and either leaves \meta{true} or \meta{false} in the input stream.
+ \command{acroifboolean\TF}[\marg{property}\marg{true}\marg{false}]
+ \sinceversion{3.1}Returns \meta{true} if the boolean property
+ \meta{property} has been set to \code{true} and \meta{false} otherwise.
\command{acroifall\TF}[\marg{properties}\marg{true}\marg{false}]
Checks if all properties in the csv list \meta{properties} have been set
for the current acronym and either leaves \meta{true} or \meta{false} in
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.acflike.pdf b/Master/texmf-dist/doc/latex/acro/examples/acro.example.acflike.pdf
index 59494c99165..5effc702805 100644
--- a/Master/texmf-dist/doc/latex/acro/examples/acro.example.acflike.pdf
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.acflike.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.issue-119.tex b/Master/texmf-dist/doc/latex/acro/examples/acro.example.issue-119.tex
index d1b5cadc650..098e50a0e1b 100644
--- a/Master/texmf-dist/doc/latex/acro/examples/acro.example.issue-119.tex
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.issue-119.tex
@@ -14,7 +14,7 @@
\immediate\write\acro@list{%
\space\space
\item[\acrofield{##1}{short}]
- \acrofield{##1}{long}%
+ \acrofield{##1}{list}%
\acrofieldifTF{##1}{extra}{ (\acrofield{##1}{extra})}{}%
}%
}{\immediate\write\acro@list{\item}\AcroRerun}%
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.pdf b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.pdf
index 673ee23f5cc..806900ddc34 100644
--- a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.pdf
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.tex b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.tex
index 60e22e7051e..da888fdaba9 100644
--- a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.tex
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-505891.tex
@@ -1,6 +1,6 @@
\documentclass{article}
-\usepackage[version=3]{acro}
+\usepackage{acro}
\DeclareAcroProperty{alt2}
\DeclareAcroProperty{alt2-format}
@@ -12,24 +12,22 @@
\acronymsmapF{
\item [%
\acrowrite{short}%
- \acroifT{alt}{/\acrowrite{alt}}%
- \acroifT{alt2}{/\acrowrite{alt2}}%
+ \acroifT{alt}{/}\acrowrite{alt}%
+ \acroifT{alt2}{/}\acrowrite{alt2}%
]
- \acrowrite{long}%
+ \acrowrite{list}%
\acroifanyT{foreign,extra}{ (}%
\acroifT{foreign}{%
\acrowrite{foreign}%
\acroifT{foreign-short}{, \acrowrite{foreign-short}}%
\acroifT{extra}{, }%
}%
- \acroifT{extra}{\acrowrite{extra}}%
+ \acrowrite{extra}%
\acroifanyT{foreign,extra}{)}%
- \acroifpagesT{%
- \acropagefill
- \acropages
- {\acrotranslate{page}\nobreakspace}%
- {\acrotranslate{pages}\nobreakspace}%
- }%
+ \acropagefill
+ \acropages
+ {\acrotranslate{page}\nobreakspace}%
+ {\acrotranslate{pages}\nobreakspace}%
}
{ \item \AcroRerun }
\end {description}
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-507726.tex b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-507726.tex
index f9acd723d12..4f5e829713b 100644
--- a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-507726.tex
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-507726.tex
@@ -1,18 +1,20 @@
\documentclass{article}
\usepackage[english,ngerman]{babel}
\usepackage{csquotes}
-\usepackage[version=3]{acro}
+\usepackage{acro}
% issue #136
\DeclareAcroProperty{foreign-short}
-\RenewAcroTemplate {long-short}{%
+\RenewAcroTemplate{long-short}{%
\acroiffirstTF{%
\acrowrite{long}\acspace
(%
\acrowrite{short}%
- \acroifT{foreign}{, \acrowrite{foreign}}%
- \acroifT{foreign-short}{, \acrowrite{foreign-short}}%
+ \acroifT{foreign}{, }%
+ \acrowrite{foreign}%
+ \acroifT{foreign-short}{, }%
+ \acrowrite{foreign-short}%
\acrogroupcite
)%
}
@@ -26,14 +28,13 @@
\acronymsmapF{
\item [\acrowrite{short}\acroifT{alt}{/\acrowrite{alt}}]
\acrowrite{long}%
- \acroifanyT{foreign,extra}{ (}%
- \acroifT{foreign}{%
- \acrowrite{foreign}%
- \acroifT{foreign-short}{, \acrowrite{foreign-short}}%
- \acroifT{extra}{, }%
- }%
- \acroifT{extra}{\acrowrite{extra}}%
- \acroifanyT{foreign,extra}{)}%
+ \acroifanyT{foreign,extra,foreign-short}{ (}%
+ \acrowrite{foreign}%
+ \acroifallT{foreign-short,foreign}{, }%
+ \acrowrite{foreign-short}%
+ \acroifanyT{foreign-short,foreign}{\acroifT{extra}{, }}%
+ \acrowrite{extra}%
+ \acroifanyT{foreign,extra,foreign-short}{)}%
\acroifpagesT{%
\acropagefill
\acropages
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.tex b/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.tex
index 7a3ff0b3512..f499a918cb6 100644
--- a/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.tex
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.tex
@@ -65,10 +65,12 @@
\acrowrite{unit}%
&
\def\AcronymID{##1}%
- \acrowrite{long}%
+ \acrowrite{list}%
&
\def\AcronymID{##1}%
- \acroifpagesT{\acropages{S. }{S. }}%
+ \acropages
+ {\acrotranslate{page}\nobreakspace}%
+ {\acrotranslate{pages}\nobreakspace}%
\tabularnewline
}%
}%