diff options
author | Karl Berry <karl@freefriends.org> | 2020-05-10 20:50:29 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-05-10 20:50:29 +0000 |
commit | 4089354da92e3f04e88143fb7ab741315a17fb17 (patch) | |
tree | d8e1a631629ce23d32bd43a69b3ad422bd20f83f /Master/texmf-dist/doc/latex/acro | |
parent | be9c569650668cf1f39d05db60ea78d27aed7a0c (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/acro')
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/README | 10 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/acro-manual.pdf | bin | 868396 -> 879954 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/acro-manual.tex | 73 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.pdf | bin | 0 -> 22752 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.tex | 21 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.pdf | bin | 0 -> 15855 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.tex | 24 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.pdf | bin | 0 -> 15808 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.tex | 39 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.units.pdf | bin | 65310 -> 65067 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/examples/acro.example.units.tex | 17 |
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 Binary files differindex 5c2310f650b..90a739e61c9 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 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 Binary files differnew file mode 100644 index 00000000000..51e1ef49fbb --- /dev/null +++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-513623.pdf 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 Binary files differnew file mode 100644 index 00000000000..f5cdd4871b2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-515295.pdf 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 Binary files differnew file mode 100644 index 00000000000..6c4222c3431 --- /dev/null +++ b/Master/texmf-dist/doc/latex/acro/examples/acro.example.texsx-542461.pdf 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 Binary files differindex 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 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} } |