diff options
author | Karl Berry <karl@freefriends.org> | 2019-09-24 20:06:00 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-09-24 20:06:00 +0000 |
commit | b932b40952f8a44a92f75a5c8a4fd0e6ee763a7a (patch) | |
tree | a1d3afb4b264c3edb52df67f3d8852af19d8a543 /Master/texmf-dist/doc | |
parent | 45684d5bf92989769a95867aad2b7fcc669374fc (diff) |
acro (24sep19)
git-svn-id: svn://tug.org/texlive/trunk@52170 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/README | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/acro_en.pdf | bin | 567835 -> 563627 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/acro/acro_en.tex | 57 |
3 files changed, 48 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/latex/acro/README b/Master/texmf-dist/doc/latex/acro/README index 89f9d59cdf2..c9a69ddaee1 100644 --- a/Master/texmf-dist/doc/latex/acro/README +++ b/Master/texmf-dist/doc/latex/acro/README @@ -1,9 +1,9 @@ -------------------------------------------------------------------------- -the ACRO package v2.9 +the ACRO package v2.10 Typeset Acronyms -2019/02/17 +2019/09/23 -------------------------------------------------------------------------- Clemens Niederberger Web: https://bitbucket.org/cgnieder/acro diff --git a/Master/texmf-dist/doc/latex/acro/acro_en.pdf b/Master/texmf-dist/doc/latex/acro/acro_en.pdf Binary files differindex a0cd8ab700d..e816f76124a 100644 --- a/Master/texmf-dist/doc/latex/acro/acro_en.pdf +++ b/Master/texmf-dist/doc/latex/acro/acro_en.pdf diff --git a/Master/texmf-dist/doc/latex/acro/acro_en.tex b/Master/texmf-dist/doc/latex/acro/acro_en.tex index ad807a43d01..c7caf4b7bc9 100644 --- a/Master/texmf-dist/doc/latex/acro/acro_en.tex +++ b/Master/texmf-dist/doc/latex/acro/acro_en.tex @@ -1,8 +1,8 @@ -% !arara: pdflatex: { action: nonstopmode } +% arara: pdflatex: { action: nonstopmode } % !arara: biber % !arara: pdflatex: { action: nonstopmode } -% arara: pdflatex: { action: nonstopmode } -% arara: pdflatex: { action: nonstopmode } +% !arara: pdflatex: { action: nonstopmode } +% !arara: pdflatex: { action: nonstopmode } % -------------------------------------------------------------------------- % the ACRO package % @@ -322,7 +322,7 @@ documentation. \keyval{foreign-plural}{text}\Default{s} The\sinceversion{2.9} plural ending appended to the foreign form. %% foreign-plural-form - \keyval{long-plural-form}{text} + \keyval{foreign-plural-form}{text} Plural\sinceversion{2.9} lforeign form of the acronym; replaces the foreign form when used instead of appending the plural ending. %% list @@ -390,6 +390,10 @@ documentation. %% long-format \keyval{long-format}{\TeX{} code} The format used for the long form of the acronym. + %% short-format + \keyval{alt-format}{\TeX{} code} + The\sinceversion{2.10} format used for the alternative form of the + acronym. If this is not given the short format will be used. %% first-long-format \keyval{first-long-format}{\TeX{} code} The format used for the first long form of the acronym as set with \cs{ac}, @@ -521,36 +525,54 @@ This is an example of the logging info with \keyis{log}{true} or \subsection{Using the Acronyms -- the Commands}\label{sec:using-acronyms-comm} Acronyms are used with one of the following commands: \begin{commands} + %% \command{ac}[\sarg\marg{id}] basic command; the first output is different from subsequent ones. \command{Ac}[\sarg\marg{id}] - same as \cs{ac} but capitalizes the first letter of the long form. + same as \cs{ac} but capitalizes the first letter. + %% \command{acs}[\sarg\marg{id}] \h{s}hort form; the actual acronym. + \command{Acs}[\sarg\marg{id}] + same\sinceversion{2.10} as \cs{acs} but capitalizes the first letter. + %% \command{acl}[\sarg\marg{id}] \h{l}ong form; the meaning of the acronym. \command{Acl}[\sarg\marg{id}] same as \cs{acl} but capitalizes first letter. + %% \command{aca}[\sarg\marg{id}] \h{a}lternative short form as specified in the \option{alt} key of \cs{DeclareAcronym}; if it hasn't been specified this is identical to \cs{acs}. + \command{Aca}[\sarg\marg{id}] + same\sinceversion{2.10} as \cs{aca} but capitalizes the first letter. + %% \command{acf}[\sarg\marg{id}] first form; output like the first time \cs{ac} is output. \command{Acf}[\sarg\marg{id}] - same as \cs{acf} but capitalizes first letter of the long form. + same as \cs{acf} but capitalizes first letter. + %% \command{acp}[\sarg\marg{id}] \h{p}lural form of \cs{ac}; \command{Acp}[\sarg\marg{id}] - same as \cs{acp} but capitalizes first letter of the long form. + same as \cs{acp} but capitalizes first letter. + %% \command{acsp}[\sarg\marg{id}] plural form of \cs{acs}; + \command{Acsp}[\sarg\marg{id}] + same\sinceversion{2.10} as \cs{acsp} but capitalizes the first letter. + %% \command{aclp}[\sarg\marg{id}] plural form of \cs{acl}; \command{Aclp}[\sarg\marg{id}] same as \cs{aclp} but capitalizes first letter. + %% \command{acap}[\sarg\marg{id}] plural form of \cs{aca}; + \command{Acap}[\sarg\marg{id}] + same\sinceversion{2.10} as \cs{acap} but capitalizes the first letter. + %% \command{acfp}[\sarg\marg{id}] plural form of \cs{acf}; \command{Acfp}[\sarg\marg{id}] @@ -1104,10 +1126,16 @@ There are a few options which change the general behaviour of \acro. then already existing macros will be overwritten. %% \keybool{sort}\Default{true} - If set to \code{true} the acronym list will be sorted automatically. The + If set to \code{true} the acronym list will be sorted alphabetically. The entries are sorted by their \acs{id} ignoring upper and lower case. This option needs the experimental package \pkg{l3sort} (from the \pkg{l3experimental} bundle) and can only be set in the preamble. + If set to \code{false} the acronyms are listed in order of their + declaration. + %% + \keybool{display-foreign}\Default{true} + When set to \code{false} any \option{foreign} option is ignored and + foreign forms are not displayed. %% \keychoice{cite}{\default{all},first,none}\Default{first} \changedversion{2.4b}This option decides whether citations that are added @@ -1167,15 +1195,20 @@ There are a few options which change the general behaviour of \acro. the like commands. You can change it to another one like for example \cs*{makefirstuc}\footnote{from the \pkg{mfirstuc} package} or \cs*{MakeTextUppercase}\footnote{from the \pkg*{textcase} package}. + %% + \keybool{uppercase-short}\Default{false} + If\sinceversion{2.10} set to \code{true} commands like \cs{Ac}, \cs{Acs} or + \cs{Aca} will uppercase the first letter of the short or alternative + version. \end{options} -All options of this and the following sections can be set up either as package -options or via the setup command: +All options of this and the following sections can be set via the setup command: \begin{commands} \command{acsetup}[\marg{options}] Set up \acro\ anywhere in the document. Or separate package loading from setup. \end{commands} +They might work as package options as well but \emph{I do not recommend it}. \begin{example} % with \acsetup{macros} @@ -1660,6 +1693,9 @@ commands\footnote{Which is why you need to use them inside an expl3 \command*{acro_add_action:n}[ \marg{code}] Adds\sinceversion{2.7} code to \cs*{acro_get:n}. Inside of \meta{code} you can refer to the \ac{id} of the acronym with \verbcode+#1+. + The \cs*{acro_get:n} command is called the first macro that is called by + \cs*{acro_use:n} which for example enables conditionals to test for + certain acronym properties. \command*{acro_get_property:nn}[\TF\ \marg{id} \marg{property} \marg{true} \marg{false}] Fetches\sinceversion{2.7} the property \meta{property} of the acronym @@ -2129,4 +2165,3 @@ letter (category code~11). \printacronyms \end{document} - |