summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-05-10 20:50:29 +0000
committerKarl Berry <karl@freefriends.org>2020-05-10 20:50:29 +0000
commit4089354da92e3f04e88143fb7ab741315a17fb17 (patch)
treed8e1a631629ce23d32bd43a69b3ad422bd20f83f /Master/texmf-dist/doc/latex
parentbe9c569650668cf1f39d05db60ea78d27aed7a0c (diff)
acro (10may20)
git-svn-id: svn://tug.org/texlive/trunk@55090 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/acro/README10
-rw-r--r--Master/texmf-dist/doc/latex/acro/acro-manual.pdfbin868396 -> 879954 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/acro-manual.tex73
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.pdfbin0 -> 22752 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.tex21
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.pdfbin0 -> 15855 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.tex24
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.pdfbin0 -> 15808 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.tex39
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.units.pdfbin65310 -> 65067 bytes
-rw-r--r--Master/texmf-dist/doc/latex/acro/examples/acro.example.units.tex17
11 files changed, 149 insertions, 35 deletions
diff --git a/Master/texmf-dist/doc/latex/acro/README b/Master/texmf-dist/doc/latex/acro/README
index 9b6b9df588a..1cfc035d626 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.1 2020/05/03
+the ACRO package v3.2 2020/05/10
Typeset Acronyms
@@ -22,9 +22,10 @@ This work has the LPPL maintenance status `maintained'.
The Current Maintainer of this work is Clemens Niederberger.
--------------------------------------------------------------------------
-The acro package consists of the code file:
+The acro package consists of code files:
acro.sty
+ acro2.sty
The acro package consists of documentation files:
@@ -46,5 +47,8 @@ folder examples/ in the same folder as acro-manual.pdf:
acro.example.issue-154.pdf, acro.example.issue-154.tex
acro.example.texsx-505891.pdf, acro.example.texsx-505891.tex
acro.example.texsx-507726.pdf, acro.example.texsx-507726.tex
-
+ acro.example.texsx-513623.pdf, acro.example.texsx-513623.tex
+ acro.example.texsx-515295.pdf, acro.example.texsx-515295.tex
+ acro.example.texsx-542461.pdf, acro.example.texsx-542461.tex
+
--------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/acro/acro-manual.pdf b/Master/texmf-dist/doc/latex/acro/acro-manual.pdf
index 5c2310f650b..90a739e61c9 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 af5e2387c6e..1d21678c63e 100644
--- a/Master/texmf-dist/doc/latex/acro/acro-manual.tex
+++ b/Master/texmf-dist/doc/latex/acro/acro-manual.tex
@@ -1123,7 +1123,7 @@ have different indefinite articles\footnote{This may very well be a language
an \ac{ufo}
\end{example}
And what good would it be to use a package like \acro\ if you have to keep
-track of of and second uses, anyway? This is why \acs{ufo} should be defined
+track of first and second uses, anyway? This is why \acs{ufo} should be defined
like we did on page~\pageref{ufo}. We then can just use the dedicated
commands and let them decide for us:
\begin{example}[side-by-side]
@@ -1179,6 +1179,9 @@ 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{list,foreign}\Default{true}
+ \sinceversion{3.2}Determine wether to hide or display the foreign form in
+ the list of acronyms.
\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.
@@ -1250,6 +1253,8 @@ have no effect, of course.
}
\end{sourcecode}
+\pagebreak
+
There are a number of options to control the uppercasing behavior:
\begin{options}
\opt{first}\Module{uppercase}
@@ -1374,7 +1379,7 @@ for an acronym individually.
\end{properties}
This manual is an example for the indexing feature. Each acronym from
section~\vref{sec:acronyms} that has been used in this manual is also listed
-in the manual.
+in the index.
\section{Barriers}\label{sec:barriers}
The main purpose of the concept of barriers is to be able to have \emph{local}
@@ -1401,10 +1406,10 @@ barriers with
\begin{commands}
\command{acbarrier}
For this command to have any effect you must set
- \module{barriers}\code{/}\option{single} to \code{true}!
+ \module{barriers}\code{/}\option{use} to \code{true}!
\end{commands}
\begin{bewareofthedog}
- It takes usually two or even three \LaTeX\ runs until acronym usages
+ It usually takes two or even three \LaTeX\ runs until acronym usages
between barriers are properly counted.
\end{bewareofthedog}
@@ -1415,7 +1420,7 @@ boolean variable if it finds them. Per default \acro\ knows about three
tokens: the \enquote{\code{dot}} (\sym{.}), the \enquote{\code{dash}}
(\sym{-}) and the \enquote{\code{babel-hyphen}} (\cs*{babelhyphen}).
-Yeu have seen an example for this already:
+You have seen an example for this already:
\begin{sourcecode}
\DeclareAcronym{etc}{
short = etc\acdot ,
@@ -1502,8 +1507,7 @@ This command is used to define the two commands you already know:
\code{babel-hyphen} follows.
\expandable\command{abbrdot} Inserts \sym{.}\cs*{@}
\end{commands}
-The definitions are equivalent\footnote{Not \emph{quite}: \acro's definitions
- are engine protected.} to the following code:
+The definitions are equivalent to the following code:
\begin{sourcecode}
\newcommand*\acdot{\aciftrailing{dot}{}{\abbrdot}}
\newcommand*\acspace{\aciftrailing{dash,babel-hyphen}{}{\space}}
@@ -1801,7 +1805,14 @@ to defines own such objects:
\tmpl{longtabu}
A style that uses a \env*{longtabu} environment for building the
list. This needs the \pkg{longtable} package and the \pkg{tabu}
- package~\cite{pkg:tabu} loaded.
+ package~\cite{pkg:tabu} loaded\footnote{Please note that this package
+ currently is un-maintained and has a number of open bugs. For further
+ information refer to
+ \url{https://github.com/tabu-issues-for-future-maintainer/tabu}}.
+ \tmpl{supertabular}
+ A\sinceversion{3.2} style that uses a \env*{supertabular} environment for
+ building the list. This needs the \pkg{supertabular}
+ package~\cite{pkg:supertabular} loaded.
\tmpl{tabular}
A style that uses a \env*{tabular} environment for building the list.
Since a \env*{tabular} cannot break across pages this is only suited for
@@ -1827,7 +1838,7 @@ to defines own such objects:
\tmpl{section}
Uses \cs*{section} for the heading.
\tmpl{section*}
- Uses \cs*{section}\sarg* for the heading.
+ Uses \cs*{section}\sarg\ for the heading.
\end{templates}
\subsection{Defining new templates}\label{sec:defin-new-templ}
@@ -1841,6 +1852,19 @@ For the definition of templates these commends are available:
This re-defines a template of type \meta{type} woth the name \meta{name}
which inserts \meta{code} when used. A template of type \meta{type} with
name \meta{name} must exist. The default type is \code{acronym}.
+ \command{SetupAcroTemplate}[\oarg{type}\marg{name}\marg{code}]
+ Adds\sinceversion{3.2} \meta{code} to the beginning of the template
+ \meta{name} of type \meta{type}. The default type is \code{acronym}.
+ \command{SetupNextAcroTemplate}[\oarg{type}\marg{name}\marg{code}]
+ Adds\sinceversion{3.2} \meta{code} to the beginning of \emph{the next use}
+ of the template \meta{name} of type \meta{type}. The default type is
+ \code{acronym}.
+ \expandable\command{AcroTemplateType}
+ Within a template this expands to the \meta{type} of the current
+ template.
+ \expandable\command{AcroTemplateName}
+ Within a template this expands to the \meta{name} of the current
+ template.
\end{commands}
How to use these commands is best explained by examples of how the existing
@@ -1867,7 +1891,7 @@ and \cs*{acroifF} each have an argument less than \cs*{acroifTF}.
\subsubsection{Commands for common uses}
\begin{commands}
\expandable\command{acrolistname}
- Expnads to whatever is currently set with
+ Expands to whatever is currently set with
\module{list}\code{/}\option{name}.
\command{acrowrite}[\marg{property}]
Prints the property \meta{property} of the current acronym. Depending on
@@ -2137,7 +2161,7 @@ define and use additional articles.
\begin{commands}
\command{DeclareAcroArticle}[\marg{name}\marg{default}]
This command can be used to define properties and options analoguous to
- the indefnite article which have been defined this way:
+ the indefinite article which have been defined this way:
\end{commands}
\begin{sourcecode}
\DeclareAcroArticle{indefinite}{a}
@@ -2163,7 +2187,7 @@ template definitions.
This command tells the template that the article \meta{foo} should be
used.
\end{commands}
-Section~\vref{sec:own-acronym-commands} has an example of how this can be used
+Section~\vref{sec:own-acronym-commands} has examples of how this can be used
to define definite articles and commands that make use of them like this:
\begin{example}
\dacs{hadopi} \par
@@ -2208,13 +2232,13 @@ Translations for a language could be added this way\footnote{\acro\ already
The existing keywords had been shown in table~\vref{tab:translations}.
\section{Properties}\label{sec:new-properties}
-As you know from section~\ref{sec:decl-acronyms-other} \acro\ comes with
-quiute a number of predefined properties for the control of acronyms.
-However, there are cases when additional properties would be nice to have and
-to use. \acro\ provides this command:
+As you know from section~\ref{sec:decl-acronyms-other} \acro\ comes with quite
+a number of predefined properties which control various aspects of
+acronyms. However, there are cases when additional properties would be nice to
+have and to use. It can be done with the following command:
\begin{commands}
- \command{DeclareAcroProperty}[\sarg\qarg\barg\uarg\marg{name}]
- This defines the new property \meta{name}. The command has four optional
+ \command{DeclareAcroProperty}[\sarg\arg{?}\arg{!}\arg{|}\arg{>}\marg{name}]
+ This defines the new property \meta{name}. The command has five optional
arguments most of which you probably never need. \par
The optional star \sym{*} ensures that each acronym gets a \emph{unique}
value for the property. \par
@@ -2223,11 +2247,18 @@ to use. \acro\ provides this command:
\code{false} and when it is used without value (not an empty value!) then
\code{true} is assumed. \par
The optional exclamation mark \sym{!} creates a \emph{mandatory}
- property. An error if raised if an acronym does not set it. \par
+ property. An error is raised if an acronym does not set it. \par
The optional pipe \sym{|} creates a \emph{static} property which means
its value is written to an auxiliary file and read in again at begin
- document. Once set the value is the same throughout the document
- \command{DeclareAcroPropertyAlias}[\sarg\qarg\barg\uarg\marg{name1}\marg{name2}]
+ document. Once set the value is the same throughout the document. \par
+ The optional greater as symbol\sinceversion{3.2} \sym{>} creates a
+ \emph{display} property. This additionally defines the two boolean
+ options \meta{name}\code{/}\option{display} and
+ \module{list}\code{/}\meta{name}\code{/}\option{display}, both initially
+ set to true. If these options are set to false the acronym commands or
+ the list act as if the property \meta{name} has not been set. The
+ \property{foreign} property is an example.
+ \command{DeclareAcroPropertyAlias}[\sarg\arg{?}\arg{!}\arg{|}\arg{>}\marg{name1}\marg{name2}]
This newly declares property \meta{name1} and makes it an alias of
property \meta{name2}. This means that \meta{name1} gets the same value
that \meta{name2} has unless it is set explicitly. Property \meta{name2}
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.pdf b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.pdf
new file mode 100644
index 00000000000..51e1ef49fbb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.tex b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.tex
new file mode 100644
index 00000000000..049172952b5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.tex
@@ -0,0 +1,21 @@
+\documentclass{article}
+\usepackage{acro}
+
+\newrobustcmd*\newspecies[4][]{%
+ \DeclareAcronym{#2}{
+ short = {#3} ,
+ long = {#4} ,
+ #1 ,
+ tag = species ,
+ first-style= long ,
+ format = \itshape
+ }%
+}
+\newspecies{ecoli}{E.~coli}{Escherichia coli}
+
+\begin{document}
+
+First use: \ac{ecoli}\par
+Second use: \ac{ecoli}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.pdf b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.pdf
new file mode 100644
index 00000000000..f5cdd4871b2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.tex b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.tex
new file mode 100644
index 00000000000..f9a93dfab2e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.tex
@@ -0,0 +1,24 @@
+\documentclass{article}
+
+\usepackage{acro}
+\usepackage{csquotes}
+\usepackage{chemmacros}
+
+\DeclareAcronym{APA}{
+ short = 3-APA ,
+ long = \iupac{3-azido-1-propyl|amine}
+}
+\DeclareAcronym{CuAAC}{
+ short = \enquote{click} chemistry ,
+ long = copper(I)-catalyzed azide-alkyne cycloaddition
+}
+
+\begin{document}
+
+1: \Acl{APA}
+
+2: \Acs{CuAAC}
+
+3: \Acl{CuAAC}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.pdf b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.pdf
new file mode 100644
index 00000000000..6c4222c3431
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.tex b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.tex
new file mode 100644
index 00000000000..c44358073eb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.tex
@@ -0,0 +1,39 @@
+\documentclass{article}
+\usepackage{acro}
+
+\DeclareAcroArticle{definite}{the}
+\DeclareAcroEnding{possessive}{'s}{'s}
+
+\NewAcroCommand\dac{m}{\acrodefinite\UseAcroTemplate{first}{#1}}
+\NewAcroCommand\Dac{m}{\acroupper\acrodefinite\UseAcroTemplate{first}{#1}}
+
+\NewAcroCommand\Dacg{m}{%
+ \acroupper
+ \acrodefinite
+ \acropossessive
+ \UseAcroTemplate{first}{#1}%
+}
+
+\DeclareAcronym{css}{
+ short = CSS ,
+ long = Centre for Spaghetti Studies ,
+ short-definite = \nospace ,
+ long-possessive = '
+}
+
+\begin{document}
+
+Bob hails from \dac{css}. \par
+Bob hails from \dac{css}.
+
+\acreset{css}
+
+\Dacg{css} mandate is broad. \par
+\Dacg{css} mandate is broad.
+
+\acreset{css}
+
+\Dac{css} scientists eat well. \par
+\Dac{css} scientists eat well. \par
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.pdf b/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.pdf
index 79c07fc50a6..f699cdcd826 100644
--- a/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.pdf
+++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.units.pdf
Binary files differ
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 f499a918cb6..ff4d9cc8bb1 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
@@ -33,41 +33,36 @@
short = \ensuremath{f} ,
long = Frequenz ,
unit = \si{\hertz} ,
- class = physics
+ tag = physics
}
\DeclareAcronym{A}{
short = \ensuremath{A} ,
long = Fläche ,
unit = \si{\metre^2} ,
- class = physics
+ tag = physics
}
\DeclareAcronym{C}{
short = \ensuremath{C} ,
long = Kapazität ,
unit = \si{\farad} ,
- class = physics
+ tag = physics
}
\DeclareAcronym{F}{
short = \ensuremath{F} ,
long = Kraft ,
unit = \si{\newton} ,
- class = physics
+ tag = physics
}
\NewAcroTemplate[list]{physics}{%
- \def\TableCode{}%
\acronymsmapT{%
- \AcroPutRight\TableCode{%
- \def\AcronymID{##1}%
+ \AcroAddRow{%
\acrowrite{short}%
&
- \def\AcronymID{##1}%
\acrowrite{unit}%
&
- \def\AcronymID{##1}%
\acrowrite{list}%
&
- \def\AcronymID{##1}%
\acropages
{\acrotranslate{page}\nobreakspace}%
{\acrotranslate{pages}\nobreakspace}%
@@ -80,7 +75,7 @@
\setlength\LTleft{0pt}%
\setlength\LTright{0pt}%
\begin{longtable}{@{}lll@{\extracolsep{\fill}}l@{}}
- \TableCode
+ \AcronymTable
\end{longtable}
}