diff options
Diffstat (limited to 'macros/latex/contrib')
85 files changed, 3766 insertions, 3623 deletions
diff --git a/macros/latex/contrib/extarrows/README b/macros/latex/contrib/extarrows/README deleted file mode 100644 index e828202198..0000000000 --- a/macros/latex/contrib/extarrows/README +++ /dev/null @@ -1,34 +0,0 @@ -Package: extarrows (extensible arrows) - -Version: - * 1.0b (2008/05/15) - Thanks to Herbert Voss <Herbert.Voss@FU-Berlin.DE> - * 1.0a (2004/11/05) - -Author: kyanh <xkyanh@gmail.com> - -License: LGPL - -This package provides some extensible arrows in maths. mode - (more than \xleftarrow, \xrightarrow, ...) - - \xlongequal - \xLongleftarrow - \xLongrightarrow - \xLongleftrightarrow - \xLeftrightarrow - - \xlongleftrightarrow - \xleftrightarrow - \xlongleftarrow - \xlongrightarrow - -Examples: - extarrows-test.tex (source) - extarrows-test.pdf (demonstration) - --- -Huynh Ky Anh -Vietnamese TeX Users Group -http://kyanh.net/ -http://viettug.org/ diff --git a/macros/latex/contrib/extarrows/README.md b/macros/latex/contrib/extarrows/README.md new file mode 100644 index 0000000000..e4aca88986 --- /dev/null +++ b/macros/latex/contrib/extarrows/README.md @@ -0,0 +1,34 @@ +## Description + +`extarrows` (extensible arrows) provides some extensible arrows in math mode. + +The list of new arrow commands: + +* `\xlongequal` +* `\xLongleftarrow` +* `\xLongrightarrow` +* `\xLongleftrightarrow` +* `\xLeftrightarrow` +* `\xlongleftrightarrow` +* `\xleftrightarrow` +* `\xlongleftarrow` +* `\xlongrightarrow` + +## Examples + +* Source file: [extarrows-test.tex](extarrows-test.tex) +* Sample output: [extarrows-test.pdf](extarrows-test.pdf) + +## History + +* Version 1.2.0 (2020/03/12): Documentation updates. Use https://github.com/viettug/extarrows +* Version 1.0b (2008/05/15): Thanks to Herbert Voss <Herbert.Voss@FU-Berlin.DE> +* Version 1.0a (2004/11/05): Initial version + +## Author: + +Ky-Anh Huynh <xkyanh@gmail.com> + +## License + +LGPL diff --git a/macros/latex/contrib/extarrows/extarrows-test.pdf b/macros/latex/contrib/extarrows/extarrows-test.pdf Binary files differindex 930f579652..361bcad151 100644 --- a/macros/latex/contrib/extarrows/extarrows-test.pdf +++ b/macros/latex/contrib/extarrows/extarrows-test.pdf diff --git a/macros/latex/contrib/extarrows/extarrows-test.tex b/macros/latex/contrib/extarrows/extarrows-test.tex index bca513d7cd..b99340b1cb 100644 --- a/macros/latex/contrib/extarrows/extarrows-test.tex +++ b/macros/latex/contrib/extarrows/extarrows-test.tex @@ -1,9 +1,17 @@ +% Purpose : Provide some extensible arrows in math mode. +% (Sample source file) +% Author : Ky-Anh Huynh +% License : LGPL + \documentclass[10pt, a4paper, oneside]{article} \usepackage{extarrows} +% Define a simple macro for testing \def\test#1/{% - \texttt{\textbackslash #1:}\qquad& A\csname #1\endcsname[\text{to love}]{\text{we love}}Z} + \texttt{\textbackslash #1:}\qquad& A\csname #1\endcsname[\text{sub-script}]{\text{super-script}}Z} + +% Test command without sub/super-scripts \def\tfst #1/{% \texttt{\textbackslash #1:}\qquad& A\csname #1\endcsname[]{}Z} @@ -11,14 +19,12 @@ \section{Syntax} \begin{verbatim} +\arrowname{super-script} \arrowname[sub-script]{super-script} \end{verbatim} \noindent -\texttt{arrowname} is \texttt{xlongequal}, \texttt{xLongleftarrow}, etc. - -\noindent -The parameter \verb"[sub-script]" is optional. +\texttt{arrowname} is one of known arrow command, for example, \texttt{xlongequal}, \texttt{xLongleftarrow},\ldots \section{Examples} \begin{align} diff --git a/macros/latex/contrib/extarrows/extarrows.sty b/macros/latex/contrib/extarrows/extarrows.sty index f89ba3c319..ae66265212 100644 --- a/macros/latex/contrib/extarrows/extarrows.sty +++ b/macros/latex/contrib/extarrows/extarrows.sty @@ -1,5 +1,9 @@ +% Purpose : Provide some extensible arrows in math mode. +% Author : Ky-Anh Huynh +% License : LGPL + \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{extarrows}[2008/05/15 v1.0b Some extensible arrows] +\ProvidesPackage{extarrows}[2020/03/12 v1.2.0 Some extensible arrows] \RequirePackage{amsmath} diff --git a/macros/latex/contrib/glossaries/CHANGES b/macros/latex/contrib/glossaries/CHANGES index 3149706a90..9b66723996 100644 --- a/macros/latex/contrib/glossaries/CHANGES +++ b/macros/latex/contrib/glossaries/CHANGES @@ -1,5 +1,15 @@ glossaries change log: +v4.46 (2020-03-19): + + * glossaries.sty: + + - added starred form \ifglossaryexists* to include ignored + glossaries in existence test. + + - added \@printgloss@checkexists to allow better integration with + \printunsrtglossary (provided by glossaries-extra.sty). + v4.45 (2020-02-13): * glossaries-accsupp.sty: diff --git a/macros/latex/contrib/glossaries/README.md b/macros/latex/contrib/glossaries/README.md index ccb9d83969..e50691e1c8 100644 --- a/macros/latex/contrib/glossaries/README.md +++ b/macros/latex/contrib/glossaries/README.md @@ -1,4 +1,4 @@ -# glossaries v4.45 (2020-02-13) +# glossaries v4.46 (2020-03-19) Author: Nicola Talbot ([contact](http://www.dickimaw-books.com/contact)) diff --git a/macros/latex/contrib/glossaries/glossaries-code.pdf b/macros/latex/contrib/glossaries/glossaries-code.pdf Binary files differindex b6168ca4e4..f96bdbddfc 100644 --- a/macros/latex/contrib/glossaries/glossaries-code.pdf +++ b/macros/latex/contrib/glossaries/glossaries-code.pdf diff --git a/macros/latex/contrib/glossaries/glossaries-user.html b/macros/latex/contrib/glossaries/glossaries-user.html index abe7f89e46..a71a00fa29 100644 --- a/macros/latex/contrib/glossaries/glossaries-user.html +++ b/macros/latex/contrib/glossaries/glossaries-user.html @@ -21,11 +21,11 @@ .cmr-17{font-size:170%;} .cmr-12{font-size:120%;} .cmr-8{font-size:80%;} -.cmtt-12{font-size:120%;font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} +.cmtt-12{font-size:120%;font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} .cmbx-10{ font-weight: bold;} .cmbx-10{ font-weight: bold;} .cmss-10{ font-family: sans-serif;} @@ -33,11 +33,11 @@ .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} .cmti-10{ font-style: italic;} .cmssbx-10{ font-family: sans-serif; font-weight: bold;} .cmssbx-10{ font-family: sans-serif; font-weight: bold;} @@ -45,16 +45,16 @@ .cmssbx-10{ font-family: sans-serif; font-weight: bold;} .cmssbx-10{ font-family: sans-serif; font-weight: bold;} .cmr-9{font-size:90%;} -.cmtt-8{font-size:80%;font-family: monospace;} -.cmtt-8{font-family: monospace;} -.cmtt-8{font-family: monospace;} -.cmtt-8{font-family: monospace;} -.cmtt-8{font-family: monospace;} -.cmtt-9{font-size:90%;font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} +.cmtt-8{font-size:80%;font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} +.cmtt-9{font-size:90%;font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} .cmss-9{font-size:90%; font-family: sans-serif;} .cmss-9{ font-family: sans-serif;} .cmss-9{ font-family: sans-serif;} @@ -71,9 +71,9 @@ .cmss-8{ font-family: sans-serif;} .cmbx-12{font-size:120%; font-weight: bold;} .cmbx-12{ font-weight: bold;} -.tctt-1000{font-family: monospace;} +.tctt-1000{font-family: monospace,monospace;} .cmti-8{font-size:80%; font-style: italic;} -.cmitt-10{font-family: monospace; font-style: italic;} +.cmitt-10{font-family: monospace,monospace; font-style: italic;} .cmssi-10{ font-family: sans-serif; font-style: oblique;} .cmssi-10{ font-family: sans-serif; font-style: oblique;} .cmssi-10{ font-family: sans-serif; font-style: oblique;} @@ -147,11 +147,6 @@ table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } .hline td, .cline td{ padding: 0; } .hline hr, .cline hr{border:none;border-top:1px solid black;} .tabbing-right {text-align:right;} -span.TEX {letter-spacing: -0.125em; } -span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} -a span.TEX span.E {text-decoration: none; } -span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} -span.LATEX span.TEX{ position:relative; left: -0.4em; } div.float, div.figure {margin-left: auto; margin-right: auto;} div.float img {text-align:center;} div.figure img {text-align:center;} @@ -1310,7 +1305,7 @@ span#textcolor3{color:#008080} > <!--l. 679--><p class="noindent" > </p><!--l. 679--><p class="noindent" ><span -class="cmr-17">User Manual for glossaries.sty v4.45</span> +class="cmr-17">User Manual for glossaries.sty v4.46</span> </p> <div class="tabular"> <table id="TBL-1" class="tabular" cellspacing="0" cellpadding="0" @@ -1326,7 +1321,7 @@ href="http://www.dickimaw-books.com/contact" ><span class="cmtt-12">dickimaw-books.com/contact</span></a> </td></tr></table> </div> <!--l. 679--><p class="noindent" ><span -class="cmr-12">2020-02-13</span></p></div> +class="cmr-12">2020-03-19</span></p></div> <div class="abstract" > @@ -1342,14 +1337,13 @@ class="cmbx-10">Abstract</span></p></div> <!--l. 682--><p class="noindent" >The <span class="cmss-10">glossaries </span>package provides a means to define terms or abbreviations or symbols that can be referenced within your document. Sorted lists with collated <a -href="#glo:entrylocation">locations</a> can be generated either using <span class="TEX">T<span -class="E">E</span>X</span> or using a -supplementary <a +href="#glo:entrylocation">locations</a> can be generated either using TeX or using a supplementary +<a href="#glo:indexingapp">indexing application</a>. Sample documents are provided with the <span -class="cmss-10">glossaries </span>package. These are -listed in <a +class="cmss-10">glossaries </span>package. These are listed in <a href="#sec:samples">§19 </a><a -href="#sec:samples">Sample Documents<!--tex4ht:ref: sec:samples --></a>. +href="#sec:samples">Sample +Documents<!--tex4ht:ref: sec:samples --></a>. </p><!--l. 688--><p class="indent" > @@ -1412,16 +1406,11 @@ class="cmss-10">datatool</span><a id="dx1-12"></a> bundle) and <span class="cmss-10">amsgen</span><a - id="dx1-13"></a>. These packages are all available in the latest <span class="TEX">T<span -class="E">E</span>X</span> Live and Mik<span class="TEX">T<span -class="E">E</span>X</span> distributions. If any of them -are missing, please update your <span class="TEX">T<span -class="E">E</span>X</span> distribution using your update manager. For help on this + id="dx1-13"></a>. These packages are all available in the latest TeX Live and MikTeX distributions. If any of them +are missing, please update your TeX distribution using your update manager. For help on this see, for example, <a -href="http://tex.stackexchange.com/questions/55437/how-do-i-update-my-tex-distribution" >How do I update my <span class="TEX">T<span -class="E">E</span>X</span> distribution?</a> or (for Linux users) <a -href="http://tex.stackexchange.com/questions/14925/updating-tex-on-linux" >Updating <span class="TEX">T<span -class="E">E</span>X</span> on +href="http://tex.stackexchange.com/questions/55437/how-do-i-update-my-tex-distribution" >How do I update my TeX distribution?</a> or (for Linux users) <a +href="http://tex.stackexchange.com/questions/14925/updating-tex-on-linux" >Updating TeX on Linux</a>. </p><!--l. 728--><p class="indent" > Note that occasionally you may find that certain packages need to be loaded <span class="cmti-10">after </span>packages that are required @@ -1481,7 +1470,7 @@ href="glossaries-code.pdf" class="url" ><span class="cmtt-10">glossaries-code.pdf</span></a> </dt><dd class="description">Advanced users wishing to know more about the inner workings of all the packages provided in the <span -class="cmss-10">glossaries </span>bundle should read “Documented Code for glossaries v4.45”. +class="cmss-10">glossaries </span>bundle should read “Documented Code for glossaries v4.46”. </dd><dt class="description"> <span class="cmbx-10">INSTALL</span> </dt><dd @@ -2077,13 +2066,10 @@ class="newline" /> id="glo:indexingapp"></a><span class="cmbx-10">Indexing application</span> </dt><dd class="description"><br -class="newline" />An application (piece of software) separate from <span class="TEX">T<span -class="E">E</span>X</span>/<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> that collates and sorts information +class="newline" />An application (piece of software) separate from TeX/LaTeX that collates and sorts information that has an associated page reference. Generally the information is an index entry but in this case the information is a glossary entry. There are two main indexing applications that are used with - <span class="TEX">T<span -class="E">E</span>X</span>: <a + TeX: <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-3036"></a></a> and <a @@ -2144,8 +2130,7 @@ href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-3046"></a></a> provided with the <span class="cmss-10">glossaries</span> - package. <span class="TEX">T<span -class="E">E</span>X</span> distributions on Windows convert the original <span + package. TeX distributions on Windows convert the original <span class="cmtt-10">makeglossaries </span>script into an executable <span class="cmtt-10">makeglossaries.exe </span>for convenience (but Perl is still required). <br @@ -2183,8 +2168,7 @@ class="cmtt-10">makeglossaries</span><a id="dx1-3052"></a></a> script. If you have Perl installed, use the Perl script instead. This script is actually distributed with the file name <span -class="cmtt-10">makeglossaries-lite.lua</span>, but <span class="TEX">T<span -class="E">E</span>X</span> Live (on Unix-like systems) creates a symbolic link called +class="cmtt-10">makeglossaries-lite.lua</span>, but TeX Live (on Unix-like systems) creates a symbolic link called <span class="cmtt-10">makeglossaries-lite </span>(without the <span class="cmtt-10">.lua </span>extension) to the actual <span @@ -2265,8 +2249,7 @@ class="newline" /> class="cmbx-10">Small caps</span><a id="dx1-3063"></a> </dt><dd class="description"><br -class="newline" />Small capitals. The <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> kernel provides <span +class="newline" />Small capitals. The LaTeX kernel provides <span class="cmtt-10">\textsc</span><a id="dx1-3064"></a><span class="cmtt-10">{</span>⟨<span @@ -2292,20 +2275,13 @@ class="newline" /> </dd><dt class="description"> <a id="glo:latexexlatinchar"></a><span -class="cmbx-10">Standard </span><span class="LATEX"><span -class="cmbx-10">L</span><span class="A"><span -class="cmbx-10">A</span></span><span class="TEX"><span -class="cmbx-10">T</span><span -class="E"><span -class="cmbx-10">E</span></span><span -class="cmbx-10">X</span></span></span><span +class="cmbx-10">Standard LaTeX</span><span class="cmbx-10"> Extended Latin Character</span><a id="dx1-3067"></a> </dt><dd class="description"><br class="newline" />An <a href="#glo:exlatinchar">extended Latin character<a - id="dx1-3068"></a></a> that can be created by a core <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> command, such as <span + id="dx1-3068"></a></a> that can be created by a core LaTeX command, such as <span class="cmtt-10">\o </span>(ø) or <span class="cmtt-10">\’e </span>(é). That is, the character can be produced without the need to load a particular package. <br @@ -3131,26 +3107,14 @@ class="pzdr-x-x-90">✾</span></sup> </td> <!--l. 1150--><p class="noindent" >______________________________________________________________________________________ </p><!--l. 1152--><p class="noindent" ><sup class="textsuperscript"><span class="tcrm-0900">*</span></sup> <span -class="cmr-8">Strips standard </span><span class="LATEX"><span -class="cmr-8">L</span><span class="A"><span -class="cmr-8">A</span></span><span class="TEX"><span -class="cmr-8">T</span><span -class="E"><span -class="cmr-8">E</span></span><span -class="cmr-8">X</span></span></span><span -class="cmr-8"> accents (that is, accents generated by core </span><span class="LATEX"><span -class="cmr-8">L</span><span class="A"><span -class="cmr-8">A</span></span><span class="TEX"><span -class="cmr-8">T</span><span -class="E"><span -class="cmr-8">E</span></span><span -class="cmr-8">X</span></span></span><span +class="cmr-8">Strips standard LaTeX</span><span +class="cmr-8"> accents (that is, accents generated by core LaTeX</span><span class="cmr-8"> commands) so, for example, </span><span class="cmtt-8">\AA</span><a id="dx1-5007"></a> <span -class="cmr-8">is treated</span> +class="cmr-8">is treated the</span> <span -class="cmr-8">the same as A.</span> +class="cmr-8">same as A.</span> </p><!--l. 1155--><p class="noindent" ><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup> <span class="cmr-8">Only with the hybrid method provided with </span><a @@ -3237,8 +3201,7 @@ class="cmr-8">option automatically switches this on.)</span> id="x1-5017r1"></a> <h4 class="likesubsectionHead"><a id="x1-60001"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option1">🔗</a><a - id="option1"></a>Option 1 (<span class="TEX">T<span -class="E">E</span>X</span>)</h4> + id="option1"></a>Option 1 (TeX)</h4> <!--l. 1176--><p class="noindent" >Example Document: @@ -3293,8 +3256,7 @@ class="cmtt-10">=</span><span class="cmss-10">false</span><a id="dx1-6005"></a> package option (the default for Option 1) then the <a -href="#glo:latexexlatinchar">standard <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> accent commands</a> will be ignored, so if an entry’s name is set to <span class="obeylines-h"><span class="verb"><span +href="#glo:latexexlatinchar">standard LaTeX accent commands</a> will be ignored, so if an entry’s name is set to <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{\’e}lite</span></span></span> then the sort value will default to <span class="cmtt-10">elite </span>if <span @@ -3403,10 +3365,8 @@ href="#sec:printglossary">Displaying a glossary<!--tex4ht:ref: sec:printglossary <!--l. 1252--><p class="nopar" > </p></li> <li - class="enumerate" id="x1-6025x3">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> twice on your document. (As you would do to make a table of contents appear.) For - example, click twice on the “typeset” or “build” or “PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>” button in your editor.</li></ol> + class="enumerate" id="x1-6025x3">Run LaTeX twice on your document. (As you would do to make a table of contents appear.) For example, + click twice on the “typeset” or “build” or “PDFLaTeX” button in your editor.</li></ol> <a id="x1-6026r2"></a> <!--l. 1259--><p class="noindent" > @@ -3462,16 +3422,14 @@ href="#glo:cli">CLI</a> application called <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7005"></a></a> to sort the entries. This application comes with all -modern <span class="TEX">T<span -class="E">E</span>X</span> distributions, but it’s hard-coded for the non-extended <a +modern TeX distributions, but it’s hard-coded for the non-extended <a href="#glo:latinalph">Latin alphabet<a id="dx1-7006"></a></a>. It can’t correctly sort accent commands (such as <span class="cmtt-10">\’ </span>or <span class="cmtt-10">\c</span>) and fails with UTF-8 characters, especially for any sort values that start with a UTF-8 character (as it separates the octets resulting in an invalid file encoding). This process involves -making <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> write the glossary information to a temporary file which <a +making LaTeX write the glossary information to a temporary file which <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7007"></a></a> reads. Then <a @@ -3581,14 +3539,12 @@ href="#sec:printglossary">Displaying a glossary<!--tex4ht:ref: sec:printglossary <!--l. 1350--><p class="nopar" > </p></li> <li - class="enumerate" id="x1-7024x4">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document. This creates files with the extensions <span + class="enumerate" id="x1-7024x4">Run LaTeX on your document. This creates files with the extensions <span class="cmtt-10">glo</span><a id="dx1-7025"></a> and <span class="cmtt-10">ist</span><a id="dx1-7026"></a> (for example, if your - <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document is called <span + LaTeX document is called <span class="cmtt-10">myDoc.tex</span>, then you’ll have two extra files called <span class="cmtt-10">myDoc.glo </span>and <span @@ -3619,8 +3575,7 @@ class="cmtt-10">.gls</span>. If you have access to a terminal or a command promp <br /></pre><spacer type=vertical size=10> <br /></span> (Replace <span -class="cmtt-10">myDoc </span>with the base name of your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document file. Avoid spaces in the file name if +class="cmtt-10">myDoc </span>with the base name of your LaTeX document file. Avoid spaces in the file name if possible. The <span class="tctt-1000">$ </span>symbol indicates the command prompt and should be omitted.) </p><!--l. 1378--><p class="noindent" ><div class="important" title="Important Note"> The file extensions vary according to the glossary <span @@ -3726,8 +3681,7 @@ class="cmtt-10">-l</span><a </p></li> <li class="enumerate" id="x1-7050x6"><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#makeindex.relatex">🔗</a><a - id="makeindex.relatex"></a> Once you have successfully completed the previous step, you can now run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document + id="makeindex.relatex"></a> Once you have successfully completed the previous step, you can now run LaTeX on your document again.</li></ol> <!--l. 1428--><p class="noindent" >You’ll need to repeat the last step if you have used the <span class="cmss-10">toc</span><a @@ -3801,16 +3755,13 @@ limitations. </p><!--l. 1462--><p class="indent" > The <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-8006"></a></a> application comes with both <span class="TEX">T<span -class="E">E</span>X</span> Live and MiK<span class="TEX">T<span -class="E">E</span>X</span>, but since <a + id="dx1-8006"></a></a> application comes with both TeX Live and MiKTeX, but since <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8007"></a></a> is a Perl script, you will also need to install Perl, if you don’t already have it. In a similar way to <a href="#option2">Option 2</a>, this option involves making -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> write the glossary information to a temporary file which <a +LaTeX write the glossary information to a temporary file which <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8008"></a></a> reads. Then <a @@ -3926,14 +3877,12 @@ href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>). </li> <li - class="enumerate" id="x1-8025x3">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document. This creates files with the extensions <span + class="enumerate" id="x1-8025x3">Run LaTeX on your document. This creates files with the extensions <span class="cmtt-10">glo</span><a id="dx1-8026"></a> and <span class="cmtt-10">xdy</span><a id="dx1-8027"></a> (for example, if your - <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document is called <span + LaTeX document is called <span class="cmtt-10">myDoc.tex</span>, then you’ll have two extra files called <span class="cmtt-10">myDoc.glo </span>and <span class="cmtt-10">myDoc.xdy</span>). @@ -3964,8 +3913,7 @@ class="cmtt-10">.gls</span>. You also need to set the language name and input en <br /></pre><spacer type=vertical size=10> <br /></span> (Replace <span -class="cmtt-10">myDoc </span>with the base name of your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document file. Avoid spaces in the file name. If +class="cmtt-10">myDoc </span>with the base name of your LaTeX document file. Avoid spaces in the file name. If necessary, also replace <span class="cmtt-10">english </span>with the name of your language and <span class="cmtt-10">utf8 </span>with your input encoding, for @@ -4090,8 +4038,7 @@ class="cmtt-10">xindy</span><a id="dx1-8053"></a> explicitly. </p></li> <li - class="enumerate" id="x1-8055x5">Once you have successfully completed the previous step, you can now run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document + class="enumerate" id="x1-8055x5">Once you have successfully completed the previous step, you can now run LaTeX on your document again. As with <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a @@ -4481,8 +4428,7 @@ class="cmmi-10">α </span>(in that order). Note that the <span class="cmtt-10">alpha </span>entry has been included even though it wasn’t referenced in the document. -</p><!--l. 1804--><p class="indent" > This just requires a single <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call: +</p><!--l. 1804--><p class="indent" > This just requires a single LaTeX call: </p><!--l. 1805--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br /></pre><spacer type=vertical size=10> @@ -4737,9 +4683,8 @@ class="cmtt-10">=</span><span class="cmss-10">none</span><a id="dx1-11022"></a> package option (as in <a href="#option5">Option 5</a>) and then define the terms in the -preamble. No external tool is required. Just run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> as normal. (Twice to ensure that the table of contents -is up to date.) +preamble. No external tool is required. Just run LaTeX as normal. (Twice to ensure that the table of contents is +up to date.) </p><!--l. 1938--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br />pdflatex myDoc @@ -4859,8 +4804,7 @@ latter is necessary with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11044"></a></a> if the symbol needs to go in a section title as the entries aren’t defined on the -first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run. +first LaTeX run. </p><!--l. 1988--><p class="indent" > In normal document text, <span class="cmtt-10">\glsentrysymbol </span>will silently do nothing if the entry hasn’t been defined, but when used in a section heading it will expand to an undefined internal command when written to the <span @@ -5161,8 +5105,7 @@ class="cmtt-10">{#1}{text}}</span> </div> See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details about this style. -<!--l. 2104--><p class="indent" > Note that on the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run none of the entries will be defined. Once they are defined, the page +<!--l. 2104--><p class="indent" > Note that on the first LaTeX run none of the entries will be defined. Once they are defined, the page numbers may shift due to the increased amount of document text. You may therefore need to repeat the document build to ensure the page numbers are correct. </p><!--l. 2109--><p class="indent" > If there are extra terms that need to be included in the index that don’t have a description, you can define @@ -5212,8 +5155,7 @@ href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span cla <!--l. 2131--><p class="noindent" >In addition to the sample files described above, <span class="cmss-10">glossaries</span><a id="dx1-12001"></a> also provides some files containing lorum -ipsum dummy entries. These are provided for testing purposes and are on <span class="TEX">T<span -class="E">E</span>X</span>’s path (in +ipsum dummy entries. These are provided for testing purposes and are on TeX’s path (in <span class="cmtt-10">tex/latex/glossaries/test-entries</span>) so they can be included via <span class="cmtt-10">\input</span><a @@ -5306,8 +5248,7 @@ class="cmtt-10">user1</span><a id="dx1-12009"></a> key to store the name of an image file. (The images are provided by the <span class="cmss-10">mwe</span><a - id="dx1-12010"></a> package and should be on <span class="TEX">T<span -class="E">E</span>X</span>’s path.) One entry doesn’t have an + id="dx1-12010"></a> package and should be on TeX’s path.) One entry doesn’t have an associated image to help test for a missing key. The descriptions are long to allow for tests with the text wrapping around the image. For example: @@ -5467,8 +5408,7 @@ class="cmtt-10">user1</span><a id="dx1-12024"></a> key to store a citation key (or comma-separated list of citation keys). The citations are defined in <span class="cmtt-10">xampl.bib</span>, which should be available on all modern - <span class="TEX">T<span -class="E">E</span>X</span> distributions. One entry doesn’t have an associated citation to help test for a missing key. For + TeX distributions. One entry doesn’t have an associated citation to help test for a missing key. For example: @@ -5537,8 +5477,7 @@ href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span cla <!--l. 2331--><p class="noindent" ><div class="important" title="Important Note"> The <span class="cmss-10">glossaries </span>package uses the <span class="cmss-10">tracklang </span>package to determine the document languages. Unfortunately, because -there isn’t a standard language identification framework provided with <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>, <span +there isn’t a standard language identification framework provided with LaTeX, <span class="cmss-10">tracklang </span>isn’t always able to detect the selected languages either as a result of using an unknown interface or where the interface doesn’t provide a way of detecting the language. See <a @@ -5608,11 +5547,9 @@ href="#glo:nonlatinchar">non-Latin character<a id="dx1-13013"></a></a>, such as é, looks like a plain character in your <span class="cmtt-10">tex</span><a id="dx1-13014"></a> file, with -standard <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> it’s actually a macro and can therefore cause expansion problems. You may need to switch -off the field expansions with <span -class="cmtt-10">\glsnoexpandfields</span>. This issue doesn’t occur with XeLaTeX or Lua<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>. +standard LaTeX it’s actually a macro and can therefore cause expansion problems. You may need to switch off +the field expansions with <span +class="cmtt-10">\glsnoexpandfields</span>. This issue doesn’t occur with XeLaTeX or LuaLaTeX. </div> </p><!--l. 2372--><p class="noindent" > </p><!--l. 2374--><p class="indent" > With <span @@ -6208,8 +6145,7 @@ myinstitute-glossaries-dictionary-English.dict \usedictionary{myinstitute-glossaries-dictionary} </div> <!--l. 2615--><p class="nopar" > (Make sure that <span -class="cmtt-10">myinstitute-glossaries-dictionary-English.dict </span>can be found by <span class="TEX">T<span -class="E">E</span>X</span>.) If you want to +class="cmtt-10">myinstitute-glossaries-dictionary-English.dict </span>can be found by TeX.) If you want to share your custom dictionary, you can upload it to <a href="http://www.ctan.org/" >CTAN</a>. </p><!--l. 2620--><p class="indent" > If you are using <span @@ -6510,8 +6446,7 @@ class="cmtt-10">glossaries-irish-noenc.ldf </span>(no encoding information) and class="cmtt-10">glossaries-irish-utf8.ldf </span>(UTF-8). </p><!--l. 2847--><p class="indent" > These both define <span class="cmtt-10">\glossariescaptionsirish </span>but the <span -class="cmtt-10">*-noenc.ldf </span>uses <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> accent commands: +class="cmtt-10">*-noenc.ldf </span>uses LaTeX accent commands: </p> @@ -6557,8 +6492,7 @@ use the <span class="cmtt-10">sort</span><a id="dx1-16001"></a> key if the <span class="cmtt-10">name</span><a - id="dx1-16002"></a> contains any <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> commands (except if you’re using <a + id="dx1-16002"></a> contains any LaTeX commands (except if you’re using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-16003"></a></a>). @@ -6576,8 +6510,7 @@ class="cmss-10">automake</span><a id="dx1-16006"></a> package option, described in <a href="#sec:pkgopts-sort">§2.5 </a><a href="#sec:pkgopts-sort">Sorting Options<!--tex4ht:ref: sec:pkgopts-sort --></a>, but you will need -<span class="TEX">T<span -class="E">E</span>X</span>’s shell escape enabled. See also <a +TeX’s shell escape enabled. See also <a href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a>. </p><!--l. 2900--><p class="indent" > In order to generate a sorted glossary with compact <a @@ -6587,14 +6520,12 @@ href="#glo:indexingapp">indexing application</a> as an intermediate step (unless you have chosen <a -href="#option1">Option 1</a>, which uses <span class="TEX">T<span -class="E">E</span>X</span> to do the +href="#option1">Option 1</a>, which uses TeX to do the sorting or <a href="#option5">Option 5</a>, which doesn’t perform any sorting). It is this application that creates the file containing the code required to typeset the glossary. <strong>If this step is omitted, the glossaries will not appear in your document.</strong> The two indexing applications that are most commonly used with -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> are <a +LaTeX are <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-16008"></a></a> and <a @@ -6678,17 +6609,13 @@ class="cmtt-10">\makeglossaries</span><a href="#sec:makeglossariesapp">§1.4.1 </a><a href="#sec:makeglossariesapp">Using the makeglossaries Perl Script<!--tex4ht:ref: sec:makeglossariesapp --></a> for further details. Perl is stable, cross-platform, open source -software that is used by a number of <span class="TEX">T<span -class="E">E</span>X</span>-related applications (including <span +software that is used by a number of TeX-related applications (including <span class="cmtt-10">xindy</span><a id="dx1-16027"></a> and <span class="cmtt-10">latexmk</span><a id="dx1-16028"></a>). -Most Unix-like operating systems come with a Perl interpreter. <span class="TEX">T<span -class="E">E</span>X</span> Live also comes with a Perl -interpreter. MiK<span class="TEX">T<span -class="E">E</span>X</span> doesn’t come with a Perl interpreter so if you are a Windows MiK<span class="TEX">T<span -class="E">E</span>X</span> user +Most Unix-like operating systems come with a Perl interpreter. TeX Live also comes with a Perl +interpreter. MiKTeX doesn’t come with a Perl interpreter so if you are a Windows MiKTeX user you will need to install Perl if you want to use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a @@ -6777,10 +6704,8 @@ class="cmti-10">trimmed-down </span>alternative to the <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-16051"></a></a> Perl script. It doesn’t have some of the options that the -Perl version has and it doesn’t attempt to diagnose any problems, but since modern <span class="TEX">T<span -class="E">E</span>X</span> distributions come -with Lua<span class="TEX">T<span -class="E">E</span>X</span> (and therefore have a Lua interpreter) you don’t need to install anything else in order to +Perl version has and it doesn’t attempt to diagnose any problems, but since modern TeX distributions come +with LuaTeX (and therefore have a Lua interpreter) you don’t need to install anything else in order to use <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a @@ -6901,11 +6826,9 @@ class="cmtt-10">bib2gls</span><a </p><!--l. 3040--><p class="indent" > Likewise, an additional <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-16076"></a></a> and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run may be required if the document pages shift with + id="dx1-16076"></a></a> and LaTeX run may be required if the document pages shift with re-runs. For example, if the page numbering is not reset after the table of contents, the insertion of the table of -contents on the second <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run may push glossary entries across page boundaries, which means that the +contents on the second LaTeX run may push glossary entries across page boundaries, which means that the <a href="#glo:numberlist">number list<a id="dx1-16077"></a>s</a> in the glossary may need updating. @@ -7081,8 +7004,7 @@ class="cmtt-10">makeglossaries</span><a <br />perl makeglossaries myDoc <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 3106--><p class="indent" > Windows users: <span class="TEX">T<span -class="E">E</span>X</span> Live on Windows has its own internal Perl interpreter and provides +</p><!--l. 3106--><p class="indent" > Windows users: TeX Live on Windows has its own internal Perl interpreter and provides <span class="cmtt-10">makeglossaries.exe </span>as a convenient wrapper for the <a href="#glo:makeglossaries"><span @@ -7225,9 +7147,7 @@ href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><sp href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-18001"></a></a> Perl script requires a Lua interpreter, which should already be -available if you have a modern <span class="TEX">T<span -class="E">E</span>X</span> distribution that includes Lua<span class="TEX">T<span -class="E">E</span>X</span>. Lua is a light-weight, cross-platform +available if you have a modern TeX distribution that includes LuaTeX. Lua is a light-weight, cross-platform scripting language, but because it’s light-weight it doesn’t have the full-functionality of heavy-weight scripting languages, such as Perl. The <a href="#glo:makeglossaries-lite.lua"><span @@ -7240,14 +7160,13 @@ class="cmtt-10">makeglossaries</span><a class="cmtt-10">-d</span><a id="dx1-18004"></a> option.) -</p><!--l. 3189--><p class="indent" > <div class="important" title="Important Note"> Note that <span class="TEX">T<span -class="E">E</span>X</span> Live on Unix-like systems creates a symbolic link called <span -class="cmtt-10">makeglossaries-lite </span>(without -the <span +</p><!--l. 3189--><p class="indent" > <div class="important" title="Important Note"> Note that TeX Live on Unix-like systems creates a symbolic link called <span +class="cmtt-10">makeglossaries-lite </span>(without the +<span class="cmtt-10">lua</span><a id="dx1-18005"></a> extension) to the actual <span -class="cmtt-10">makeglossaries-lite.lua </span>script, so you may not need to supply the -extension. </div> +class="cmtt-10">makeglossaries-lite.lua </span>script, so you may not need to supply the extension. +</div> </p><!--l. 3195--><p class="noindent" > </p><!--l. 3197--><p class="indent" > The <a href="#glo:makeglossaries-lite.lua"><span @@ -7292,13 +7211,10 @@ class="cmtt-10">xindy</span></a> explicitly (Option 3)</h4> <!--l. 3220--><p class="noindent" ><a href="#glo:xindy"><span class="cmtt-10">Xindy</span><a - id="dx1-19001"></a></a> comes with <span class="TEX">T<span -class="E">E</span>X</span> Live. It has also been added to Mik<span class="TEX">T<span -class="E">E</span>X</span>, but if you don’t have it installed, see <a + id="dx1-19001"></a></a> comes with TeX Live. It has also been added to MikTeX, but if you don’t have it installed, see <a href="http://tex.stackexchange.com/questions/71167/how-to-use-xindy-with-miktex" >How to use Xindy with MikTeX</a> on <a -href="http://www.stackexchange.com/" ><span class="TEX">T<span -class="E">E</span>X</span> on StackExchange</a>. +href="http://www.stackexchange.com/" >TeX on StackExchange</a>. </p><!--l. 3226--><p class="indent" > If you want to use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a @@ -7806,8 +7722,7 @@ class="cmss-10">alsoindex</span></span><a <!--l. 3451--><p class="indent" > Remember that with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-24011"></a></a>, the entries will never be defined on the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call (because their + id="dx1-24011"></a></a>, the entries will never be defined on the first LaTeX call (because their definitions are contained in the <span class="cmtt-10">glstex</span><a id="dx1-24012"></a> file created by <a @@ -8259,8 +8174,7 @@ files. </p><!--l. 3662--><p class="indent" > <div class="important" title="Important Note"> This option can significantly slow document compilation and may cause the indexing to fail. Page numbers in the <a href="#glo:numberlist">number list<a - id="dx1-31006"></a></a> will be incorrect on page boundaries due to <span class="TEX">T<span -class="E">E</span>X</span>’s asynchronous output routine. As an + id="dx1-31006"></a></a> will be incorrect on page boundaries due to TeX’s asynchronous output routine. As an alternative, you can use the <span class="cmss-10">scrwfile</span><a id="dx1-31007"></a> package (part of the KOMA-Script bundle) and not use this option. @@ -8284,8 +8198,7 @@ class="cmtt-10">bib2gls</span><a (9 resource files and 1 transcript file). -</p><!--l. 3680--><p class="indent" > <span class="warningsymbol">⚠</span> If you want to use <span class="TEX">T<span -class="E">E</span>X</span>’s <span +</p><!--l. 3680--><p class="indent" > <span class="warningsymbol">⚠</span> If you want to use TeX’s <span class="cmtt-10">\write18</span><a id="dx1-31012"></a> mechanism to call <a href="#glo:makeindex"><span @@ -8725,8 +8638,7 @@ class="cmss-10">toc=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3866--><p class="noindent" >Add the glossaries to the table of contents. Note that an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run is required with this option. +<!--l. 3866--><p class="noindent" >Add the glossaries to the table of contents. Note that an extra LaTeX run is required with this option. Alternatively, you can switch this function on and off using </p><!--l. 3869--><p class="indent" > <hr><div title="Definition"><a id="dx1-39001"></a> <span @@ -9159,8 +9071,7 @@ class="cmtt-10">\GlsEntryCounterLabelPrefix </span></div><hr> (which defaults to <span class="cmtt-10">glsentry-</span>). </p><!--l. 4082--><p class="indent" > <div class="important" title="Important Note"> If you use <span -class="cmtt-10">\glsrefentry</span>, you must run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> twice after creating the glossary files using +class="cmtt-10">\glsrefentry</span>, you must run LaTeX twice after creating the glossary files using <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a @@ -9693,8 +9604,7 @@ class="cmtt-10">xindy</span><a <span class="cmss-10">glossaries </span>package tries to ensure that special characters are escaped and allows for the location to be substituted for a format that’s more acceptable to the indexing application. This requires a bit of trickery to circumvent the -problem posed by <span class="TEX">T<span -class="E">E</span>X</span>’s asynchronous output routine, which can go wrong and also adds to the complexity of +problem posed by TeX’s asynchronous output routine, which can go wrong and also adds to the complexity of the document build. </p><!--l. 4292--><p class="indent" > If you’re sure that your locations will always expand to an acceptable format (or you’re prepared to post-process the glossary file before passing it to the relevant indexing application) then use <span @@ -10023,10 +9933,9 @@ glossary file. For example, suppose you define an entry as follows:  <br /> description={hash symbol}} </div> <!--l. 4444--><p class="nopar" > The sort value (<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">#</span></span></span>) must be sanitized before writing it to the glossary file, otherwise <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> will try to -interpret it as a parameter reference. If, on the other hand, you want the sort value expanded, you need to -switch off the sanitization. For example, suppose you do: +class="cmtt-10">#</span></span></span>) must be sanitized before writing it to the glossary file, otherwise LaTeX will try to interpret +it as a parameter reference. If, on the other hand, you want the sort value expanded, you need to switch off the +sanitization. For example, suppose you do: </p> @@ -10622,8 +10531,7 @@ class="cmtt-10">makeindex</span><a id="dx1-79002"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-79003"></a></a> using <span class="TEX">T<span -class="E">E</span>X</span>’s <span + id="dx1-79003"></a></a> using TeX’s <span class="cmtt-10">\write18</span><a id="dx1-79004"></a> mechanism at the end of the document. The option <span @@ -10646,9 +10554,8 @@ opened). class="cmss-10">automake</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-79009"></a>, the associated files are created at the end of the document ready for -the next <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run. Since there is a possibility of commands such as <span + id="dx1-79009"></a>, the associated files are created at the end of the document ready +for the next LaTeX run. Since there is a possibility of commands such as <span class="cmtt-10">\gls </span>occurring on the last page of the document, it’s not possible to use <span class="cmtt-10">\immediate </span>to close the associated file or with @@ -10665,15 +10572,13 @@ instead. class="cmss-10">automake</span><span class="cmtt-10">=</span><span class="cmss-10">immediate</span><a - id="dx1-79011"></a>, you will get a warning on the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run as the associated glossary files + id="dx1-79011"></a>, you will get a warning on the first LaTeX run as the associated glossary files don’t exist yet. -</p><!--l. 4742--><p class="indent" > Since this mechanism can be a security risk, some <span class="TEX">T<span -class="E">E</span>X</span> distributions disable it completely, in which case -this option won’t have an effect. (If this option doesn’t appear to work, search the log file for “runsystem” and -see if it is followed by “enabled” or “disabled”.) +</p><!--l. 4742--><p class="indent" > Since this mechanism can be a security risk, some TeX distributions disable it completely, in which case this +option won’t have an effect. (If this option doesn’t appear to work, search the log file for “runsystem” and see if +it is followed by “enabled” or “disabled”.) </p><!--l. 4748--><p class="indent" > Some distributions allow <span class="cmtt-10">\write18 </span>in a restricted mode. This mode has a limited number of trusted applications, which usually includes <a @@ -10702,12 +10607,10 @@ class="cmtt-10">\babel</span><a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-79020"></a></a> script applies mappings to assist -you.) Note that you still need at least two <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> runs to ensure the document is up-to-date with this +you.) Note that you still need at least two LaTeX runs to ensure the document is up-to-date with this setting. </p><!--l. 4761--><p class="indent" > Since this package option attempts to run the <a -href="#glo:indexingapp">indexing application</a> on every <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run, its use should be +href="#glo:indexingapp">indexing application</a> on every LaTeX run, its use should be considered a last resort for those who can’t work out how to incorporate the indexing application into their document build. The default value for this option is <span class="cmss-10">automake</span><span @@ -11727,15 +11630,14 @@ class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> <!--l. 5239--><p class="noindent" >As a legacy from the precursor <span class="cmss-10">glossary</span><a - id="dx1-107001"></a> package, the standard glossary commands provided by the -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> kernel (<span + id="dx1-107001"></a> package, the standard glossary commands provided by the LaTeX kernel +(<span class="cmtt-10">\makeglossary </span>and <span class="cmtt-10">\glossary</span>) are redefined in terms of the <span -class="cmss-10">glossaries </span>package’s commands. -However, they were never documented in this user manual, and the conversion guide (<a -href="glossary2glossaries.html" >“Upgrading from the -glossary package to the glossaries package”</a>) explicitly discourages their use. +class="cmss-10">glossaries </span>package’s commands. However, they +were never documented in this user manual, and the conversion guide (<a +href="glossary2glossaries.html" >“Upgrading from the glossary package to +the glossaries package”</a>) explicitly discourages their use. </p><!--l. 5248--><p class="indent" > The use of those kernel commands (instead of the appropriate commands documented in this user guide) are deprecated, and you will now get a warning if you try using them. </p><!--l. 5252--><p class="indent" > In the event that you require the original form of these kernel commands, for example, if you need to use the @@ -11759,8 +11661,7 @@ class="cmss-10">true </span>(redefine with warnings, default), <span class="cmss-10">false </span>(restore previous definitions) or <span class="cmss-10">nowarn </span>(redefine without warnings, not recommended). -</p><!--l. 5268--><p class="indent" > The only glossary-related commands provided by the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> kernel are <span +</p><!--l. 5268--><p class="indent" > The only glossary-related commands provided by the LaTeX kernel are <span class="cmtt-10">\makeglossary </span>and <span class="cmtt-10">\glossary</span>. Other packages or classes may provide additional glossary-related commands or environments that conflict with @@ -12143,13 +12044,12 @@ name. href="#glo:exlatinchar">extended Latin character<a id="dx1-112007"></a></a> or other <a href="#glo:nonlatinchar">non-Latin character<a - id="dx1-112008"></a></a>, such as é or ß, looks + id="dx1-112008"></a></a>, such as é or -like a plain character in your <span -class="cmtt-10">.tex </span>file, it’s actually a macro (an active character) and therefore -can’t be used in the label. (This applies to <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> rather than XeLaTeX.) Also be careful of +ß, looks like a plain character in your <span +class="cmtt-10">.tex </span>file, it’s actually a macro (an active character) and +therefore can’t be used in the label. (This applies to LaTeX rather than XeLaTeX.) Also be careful of <span class="cmss-10">babel</span><a id="dx1-112009"></a>’s options that change certain punctuation characters (such as <span @@ -12432,10 +12332,8 @@ class="cmtt-10">bib2gls </span>gallery: sorting</a>. </div> </p><!--l. 5615--><p class="noindent" ><a href="#option1">Option 1</a> by default strips the <a -href="#glo:latexexlatinchar">standard <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> accents</a> (that is, accents generated by core - <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> commands) from the <span +href="#glo:latexexlatinchar">standard LaTeX accents</a> (that is, accents generated by core + LaTeX commands) from the <span class="cmtt-10">name</span><a id="dx1-112083"></a> key when it sets the <span class="cmtt-10">sort</span><a @@ -12897,8 +12795,7 @@ href="#glo:nonlatinchar">non-Latin character<a id="dx1-112159"></a>s</a> correctly. <a href="#option1">Option 1</a> discards accents from <a -href="#glo:latexexlatinchar">standard <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> extended Latin character<a +href="#glo:latexexlatinchar">standard LaTeX extended Latin character<a id="dx1-112160"></a>s</a> unless you use the <span class="cmss-10">sanitizesort</span><span @@ -14212,8 +14109,7 @@ entry can now be looked up in the glossary, even if the glossary occurs at the b document. </p><!--l. 6692--><p class="indent" > There are drawbacks to this mechanism: if you modify an entry definition, you need a second run to see the effect of your modification; this method requires an extra <span -class="cmtt-10">\newwrite</span>, which may exceed <span class="TEX">T<span -class="E">E</span>X</span>’s maximum +class="cmtt-10">\newwrite</span>, which may exceed TeX’s maximum allocation; unexpected expansion issues could occur; the <span class="cmtt-10">see</span><a id="dx1-125016"></a> key isn’t stored, which means it can’t be added to @@ -14293,9 +14189,8 @@ class="cmtt-10">makeindex</span><a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-127007"></a></a> to hierarchically -sort and collate the entries since they are readily available with most modern <span class="TEX">T<span -class="E">E</span>X</span> distributions. Since these -are both designed as <a +sort and collate the entries since they are readily available with most modern TeX distributions. Since these are +both designed as <a href="#glo:indexingapp">indexing applications</a> they both require that terms either have a valid location or a cross-reference. Even if you use <span class="cmss-10">nonumberlist</span><a @@ -14468,13 +14363,11 @@ href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span cla id="sec:locationsyntax"></a>Locations</h3> <!--l. 6843--><p class="noindent" >Neither <a href="#option1">Option 1</a> nor <a -href="#option4">Option 4</a> care about the location syntax as long as it’s valid <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> code (and doesn’t +href="#option4">Option 4</a> care about the location syntax as long as it’s valid LaTeX code (and doesn’t contain fragile commands). In both cases, the indexing is performed by writing a line to the <span class="cmtt-10">aux</span><a id="dx1-129001"></a> file. The write -operation is deferred to avoid the problems associated with <span class="TEX">T<span -class="E">E</span>X</span>’s asynchronous output routine. (See, for +operation is deferred to avoid the problems associated with TeX’s asynchronous output routine. (See, for example, <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=oddpage" >Finding if you’re on an odd or an even page</a> for more details on this issue.) Unfortunately Options <a @@ -15241,12 +15134,10 @@ class="cmtt-10">pdflatex</span><a id="dx1-132019"></a> rather than <span class="cmtt-10">latex</span><a id="dx1-132020"></a> to compile your -document, if possible. The DVI format of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> has limitations with the hyperlinks that can cause a problem +document, if possible. The DVI format of LaTeX has limitations with the hyperlinks that can cause a problem when used with the <span class="cmss-10">glossaries </span>package. Firstly, the DVI format can’t break a hyperlink across a line -whereas PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> can. This means that long glossary entries (for example, the full form of an +whereas PDFLaTeX can. This means that long glossary entries (for example, the full form of an acronym) won’t be able to break across a line with the DVI format. Secondly, the DVI format doesn’t correctly size hyperlinks in subscripts or superscripts. This means that if you define a term that may be used as a subscript or superscript, if you use the DVI format, it won’t come out the correct @@ -15926,8 +15817,7 @@ class="cmtt-10">\protect </span>it will be <!--l. 7619--><p class="noindent" >(Note the use of the <span class="cmtt-10">sort</span><a id="dx1-133030"></a> key in the above examples.) -</p><!--l. 7621--><p class="indent" > There are hundreds of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> packages that altogether define thousands of commands with +</p><!--l. 7621--><p class="indent" > There are hundreds of LaTeX packages that altogether define thousands of commands with various syntax and it’s impossible for <span class="cmss-10">mfirstuc</span><a id="dx1-133031"></a> to take them all into account. The above rules are @@ -16086,8 +15976,7 @@ define a helper command where the first argument is the text. For example:  <br /> sort={sample phrase},  <br /> description={an example}} </div> -<!--l. 7719--><p class="nopar" > In fact, since the whole design ethos of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is the separation of content and style, it’s better to use a +<!--l. 7719--><p class="nopar" > In fact, since the whole design ethos of LaTeX is the separation of content and style, it’s better to use a semantic command. For example: @@ -18621,8 +18510,7 @@ class="cmtt-10">makeindex</span><a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-140064"></a></a>) -followed by one or two runs of <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is required. +followed by one or two runs of LaTeX is required. </p><!--l. 9080--><p class="indent" > The first command, <span class="cmtt-10">\glsentrynumberlist</span>, simply displays the number list as is. The second command, <span @@ -18735,8 +18623,7 @@ class="cmtt-10">\null</span><a id="dx1-141010"></a> ensures that all indexing information is written before the final page is shipped out. Once the external files are present <span class="cmtt-10">\null</span> -will no longer be used. This can cause a spurious blank page on the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run before the glossary files +will no longer be used. This can cause a spurious blank page on the first LaTeX run before the glossary files have been created. Once these files are present, <span class="cmtt-10">\null </span>will no longer be used and so shouldn’t cause interference for the final document. </div> @@ -18750,16 +18637,14 @@ href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. </div> </p><!--l. 9152--><p class="noindent" > -</p><!--l. 9154--><p class="indent" > If the glossary still does not appear after you re-<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> your document, check the <span +</p><!--l. 9154--><p class="indent" > If the glossary still does not appear after you re-LaTeX your document, check the <span class="cmtt-10">makeindex</span><a id="dx1-141011"></a>/<span class="cmtt-10">xindy</span><a - id="dx1-141012"></a> log -files to see if there is a problem. With <a -href="#option1">Option 1</a>, you just need two <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> runs to make the glossaries appear, -but you may need further runs to make the <a + id="dx1-141012"></a> log files +to see if there is a problem. With <a +href="#option1">Option 1</a>, you just need two LaTeX runs to make the glossaries appear, but +you may need further runs to make the <a href="#glo:numberlist">number list<a id="dx1-141013"></a>s</a> up-to-date. </p><!--l. 9160--><p class="indent" > An individual glossary can be displayed using: @@ -19337,8 +19222,7 @@ clarity. </p><!--l. 9454--><p class="indent" > If you want greater control over the <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-142015"></a></a> style file than is available through the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> commands + id="dx1-142015"></a></a> style file than is available through the LaTeX commands provided by the <span class="cmss-10">glossaries </span>package, you will need to edit the <span class="cmtt-10">xindy</span><a @@ -20307,8 +20191,7 @@ ignored. class="cmti-10">name</span>⟩ must not contain any active characters. It’s generally best to stick with just characters that have category code 11 (typically the non-extended <a href="#glo:latinchar">Latin character<a - id="dx1-146006"></a>s</a> for standard <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>). + id="dx1-146006"></a>s</a> for standard LaTeX). </div> </p><!--l. 9982--><p class="noindent" > </p><!--l. 9984--><p class="indent" > There is also a starred version (new to v4.08): @@ -22021,8 +21904,7 @@ class="cmtt-10">\glslabeltok</span>, <a class="cmtt-10">\glslongtok </span>and <a id="dx1-150026"></a><span class="cmtt-10">\glsshorttok</span>. As with all -<span class="TEX">T<span -class="E">E</span>X</span> registers, you can access their values by preceding the register with <span +TeX registers, you can access their values by preceding the register with <span class="cmtt-10">\the</span><a id="dx1-150027"></a>. For example, the <span class="cmss-10">long-short</span><a @@ -22663,14 +22545,8 @@ class="cmtt-10">sample-font-abbr.tex</span></a>. </p> <!--l. 11210--><p class="indent" > Some writers and publishing houses have started to drop full stops (periods) from upper case initials but may still retain them for lower case abbreviations, while others may still use them for both upper and lower case. This can cause complications. Chapter 12 of <span -class="cmti-10">The </span><span class="TEX"><span -class="cmti-10">T</span><span -class="E"><span -class="cmti-10">E</span></span><span -class="cmti-10">X</span></span><span -class="cmti-10">book </span>discusses the spacing between words but, -briefly, the default behaviour of <span class="TEX">T<span -class="E">E</span>X</span> is to assume that an upper case character followed by a full stop and +class="cmti-10">The TeXbook </span>discusses the spacing between words but, +briefly, the default behaviour of TeX is to assume that an upper case character followed by a full stop and space is an abbreviation, so the space is the default inter-word space whereas a lower case character followed by a full stop and space is a word occurring at the end of a sentence. In the event that this isn’t true, you need to make a manual adjustment using <span class="obeylines-h"><span class="verb"><span @@ -22700,10 +22576,8 @@ The spacing is more noticeable with the typewriter font: <br /><span class="cmtt-10">I was awarded a B.Sc. and a Ph.D. (From the same place.)</span> <br /><spacer type=vertical size=10></span> -The lower case letter at the end of “B.Sc.” is confusing <span class="TEX">T<span -class="E">E</span>X</span> into thinking that the full stop after it marks the -end of the sentence. Whereas the upper case letter at the end of “Ph.D.” has confused <span class="TEX">T<span -class="E">E</span>X</span> into thinking that +The lower case letter at the end of “B.Sc.” is confusing TeX into thinking that the full stop after it marks the +end of the sentence. Whereas the upper case letter at the end of “Ph.D.” has confused TeX into thinking that the following full stop is just part of the abbreviation. These can be corrected: @@ -23056,8 +22930,7 @@ class="cmtt-10">\gls</span><a class="cmtt-10">\Gls</span><a id="dx1-152013"></a> to change the settings. -</p><!--l. 11425--><p class="indent" > <div class="important" title="Important Note"> Recall that, in general, <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> ignores spaces following command names consisting of alphabetical +</p><!--l. 11425--><p class="indent" > <div class="important" title="Important Note"> Recall that, in general, LaTeX ignores spaces following command names consisting of alphabetical characters. This is also true for <span class="cmtt-10">\</span>⟨<span class="cmti-10">label</span>⟩ unless you additionally load the <span @@ -23480,8 +23353,7 @@ class="cmtt-10">\glsenableentrycount</span>. </div>  <br />Number of times apple has been used: \glsentrycurrcount{apple}.  <br />\end{document} </div> -<!--l. 11694--><p class="nopar" > On the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run, <span class="obeylines-h"><span class="verb"><span +<!--l. 11694--><p class="nopar" > On the first LaTeX run, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryprevcount{apple}</span></span></span> produces 0. At the end of the document, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrycurrcount{apple}</span></span></span> produces 4. This is because the only commands that have incremented the entry @@ -23496,8 +23368,7 @@ class="cmtt-10">\glsentrytext </span>and <span class="cmtt-10">\glslink</span>, don’t use <span class="cmtt-10">\glsunset </span>so they don’t increment the entry count. On the <span -class="cmti-10">next </span><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run, <span class="obeylines-h"><span class="verb"><span +class="cmti-10">next </span>LaTeX run, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryprevcount{apple}</span></span></span> now produces 4 as that was the value of the <span class="cmtt-10">currcount </span>field for the <span @@ -23710,8 +23581,7 @@ href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands) then the entry won’t appear in the glossary. </p><!--l. 11804--><p class="indent" > Remember that since these commands use <span -class="cmtt-10">\glsentryprevcount </span>you need to run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> twice to ensure +class="cmtt-10">\glsentryprevcount </span>you need to run LaTeX twice to ensure they work correctly. The document build order is now (at least): <span class="cmtt-10">(pdf)latex</span>, <span class="cmtt-10">(pdf)latex</span>, <span @@ -24282,9 +24152,8 @@ class="cmss-10">listhypergroup</span><a id="dx1-157019"></a> style is like <span class="cmss-10">listgroup</span><a id="dx1-157020"></a> but has a navigation line at the start of the glossary - with links to each group that is present in the glossary. This requires an additional run through - <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> to ensure the group information is up to date. In the navigation line, each group is separated + with links to each group that is present in the glossary. This requires an additional run through LaTeX to + ensure the group information is up to date. In the navigation line, each group is separated by <!--l. 12084--><p class="noindent" ><hr><div title="Definition"><a id="dx1-157021"></a> <span @@ -26648,13 +26517,11 @@ class="cmss-10">glossaries-extra</span></a> manual. </div> <!--l. 13346--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">16.1 </span> <a id="sec:loops"></a>Loops</h3> -<!--l. 13349--><p class="noindent" ><div class="important" title="Important Note"> Some of the commands described here take a comma-separated list as an argument. As with <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>’s <span +<!--l. 13349--><p class="noindent" ><div class="important" title="Important Note"> Some of the commands described here take a comma-separated list as an argument. As with LaTeX’s <span class="cmtt-10">\@for</span> command, make sure your list doesn’t have any unwanted spaces in it as they don’t get stripped. (Discussed in more detail in <a -href="http://www.dickimaw-books.com/latex/admin/html/docsvlist.shtml#spacesinlists" >§2.7.2 of “<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> for Administrative Work”</a>.) </div> +href="http://www.dickimaw-books.com/latex/admin/html/docsvlist.shtml#spacesinlists" >§2.7.2 of “LaTeX for Administrative Work”</a>.) </div> </p><!--l. 13356--><p class="noindent" > </p><!--l. 13358--><p class="noindent" ><hr><div title="Definition"><a id="dx1-168001"></a> <span @@ -26751,16 +26618,32 @@ class="cmitt-10">false part</span>⟩ </div><hr> This checks if the glossary given by ⟨<span class="cmti-10">label</span>⟩ exists. If it does ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span -class="cmti-10">false</span> +class="cmti-10">false part</span>⟩. +The unstarred form will do ⟨<span +class="cmti-10">false part</span>⟩ for ignored glossaries. As from v4.46, there is now a starred +form of this command which will also consider ignored glossaries as existing. For example, given: +</p><div class="alltt"> +<div class="obeylines-v"> <span -class="cmti-10">part</span>⟩. -</p><!--l. 13408--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169002"></a> <span +class="cmtt-10">\newignoredglossary</span><a + id="dx1-169002"></a><span +class="cmtt-10">{common}</span> +</div> +</div> then + + + <div class="verbatim" id="verbatim-385"> +\ifglossaryexists{common}{true}{false} + <br />\ifglossaryexists*{common}{true}{false} +</div> +<!--l. 13418--><p class="nopar" > will produce “false true”. +</p><!--l. 13421--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169003"></a> <span class="cmtt-10">\ifglsentryexists</span>⟨<span class="cmitt-10">label</span>⟩⟨<span class="cmitt-10">true part</span>⟩⟨<span class="cmitt-10">false part</span>⟩ </div><hr> -</p><!--l. 13411--><p class="noindent" > +</p><!--l. 13424--><p class="noindent" > This checks if the glossary entry given by ⟨<span class="cmti-10">label</span>⟩ exists. If it does ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span @@ -26769,49 +26652,49 @@ class="cmti-10">false part</span>⟩. class="cmtt-10">\ifglsentryexists </span>will always be true after the containing glossary has been displayed via <span class="cmtt-10">\printglossary</span><a - id="dx1-169003"></a> or <span + id="dx1-169004"></a> or <span class="cmtt-10">\printglossaries</span><a - id="dx1-169004"></a> even if the entry is explicitly defined later in the document. This is + id="dx1-169005"></a> even if the entry is explicitly defined later in the document. This is because the entry has to be defined before it can be displayed in the glossary, see <a href="#sec:techissues">§4.8.1 </a><a href="#sec:techissues">Technical Issues<!--tex4ht:ref: sec:techissues --></a> for further details.) -</p><!--l. 13421--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169005"></a> <span +</p><!--l. 13434--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169006"></a> <span class="cmtt-10">\glsdoifexists{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">code</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13423--><p class="noindent" > +</p><!--l. 13436--><p class="noindent" > Does ⟨<span class="cmti-10">code</span>⟩ if the entry given by ⟨<span class="cmti-10">label</span>⟩ exists. If it doesn’t exist, an error is generated. (This command uses <span class="cmtt-10">\ifglsentryexists</span>.) -</p><!--l. 13428--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169006"></a> <span +</p><!--l. 13441--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169007"></a> <span class="cmtt-10">\glsdoifnoexists{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">code</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13430--><p class="noindent" > +</p><!--l. 13443--><p class="noindent" > Does the reverse of <span class="cmtt-10">\glsdoifexists</span>. (This command uses <span class="cmtt-10">\ifglsentryexists</span>.) -</p><!--l. 13434--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169007"></a> <span +</p><!--l. 13447--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169008"></a> <span class="cmtt-10">\glsdoifexistsorwarn{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">code</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13436--><p class="noindent" > +</p><!--l. 13449--><p class="noindent" > As <span class="cmtt-10">\glsdoifexists </span>but issues a warning rather than an error if the entry doesn’t exist. -</p><!--l. 13440--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169008"></a> <span +</p><!--l. 13453--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169009"></a> <span class="cmtt-10">\glsdoifexistsordo{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26819,13 +26702,13 @@ class="cmitt-10">code</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">else code</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13442--><p class="noindent" > +</p><!--l. 13455--><p class="noindent" > Does ⟨<span class="cmti-10">code</span>⟩ if the entry given by ⟨<span class="cmti-10">label</span>⟩ exists otherwise generate an error and do ⟨<span class="cmti-10">else code</span>⟩. -</p><!--l. 13446--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169009"></a> <span +</p><!--l. 13459--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169010"></a> <span class="cmtt-10">\glsdoifnoexistsordo{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26833,47 +26716,47 @@ class="cmitt-10">code</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">else code</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13448--><p class="noindent" > +</p><!--l. 13461--><p class="noindent" > Does ⟨<span class="cmti-10">code</span>⟩ if the entry given by ⟨<span class="cmti-10">label</span>⟩ doesn’t exist otherwise generate an error and do ⟨<span class="cmti-10">else code</span>⟩. -</p><!--l. 13452--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169010"></a> <span +</p><!--l. 13465--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169011"></a> <span class="cmtt-10">\ifglsused</span>⟨<span class="cmitt-10">label</span>⟩⟨<span class="cmitt-10">true part</span>⟩⟨<span class="cmitt-10">false part</span>⟩ </div><hr> -</p><!--l. 13455--><p class="noindent" > +</p><!--l. 13468--><p class="noindent" > See <a href="#sec:glsunset">§14 </a><a href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>. -</p><!--l. 13458--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169011"></a> <span +</p><!--l. 13471--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169012"></a> <span class="cmtt-10">\ifglshaschildren</span>⟨<span class="cmitt-10">label</span>⟩⟨<span class="cmitt-10">true part</span>⟩⟨<span class="cmitt-10">false part</span>⟩ </div><hr> -</p><!--l. 13461--><p class="noindent" > +</p><!--l. 13474--><p class="noindent" > This checks if the glossary entry given by ⟨<span class="cmti-10">label</span>⟩ has any sub-entries. If it does, ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span class="cmti-10">false part</span>⟩. -</p><!--l. 13466--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169012"></a> <span +</p><!--l. 13479--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169013"></a> <span class="cmtt-10">\ifglshasparent</span>⟨<span class="cmitt-10">label</span>⟩⟨<span class="cmitt-10">true part</span>⟩⟨<span class="cmitt-10">false part</span>⟩ </div><hr> -</p><!--l. 13469--><p class="noindent" > +</p><!--l. 13482--><p class="noindent" > This checks if the glossary entry given by ⟨<span class="cmti-10">label</span>⟩ has a parent entry. If it does, ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span class="cmti-10">false part</span>⟩. -</p><!--l. 13474--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169013"></a> <span +</p><!--l. 13487--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169014"></a> <span class="cmtt-10">\ifglshassymbol{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26881,16 +26764,16 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13476--><p class="noindent" > +</p><!--l. 13489--><p class="noindent" > This checks if the glossary entry given by ⟨<span class="cmti-10">label</span>⟩ has had the <span class="cmtt-10">symbol</span><a - id="dx1-169014"></a> field set. If it has, ⟨<span + id="dx1-169015"></a> field set. If it has, ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span class="cmti-10">false part</span>⟩. -</p><!--l. 13481--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169015"></a> <span +</p><!--l. 13494--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169016"></a> <span class="cmtt-10">\ifglshaslong{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26898,22 +26781,22 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13483--><p class="noindent" > + + +</p><!--l. 13496--><p class="noindent" > This checks if the glossary entry given by ⟨<span class="cmti-10">label</span>⟩ has had the <span class="cmtt-10">long</span><a - id="dx1-169016"></a> field set. If it has, ⟨<span + id="dx1-169017"></a> field set. If it has, ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span class="cmti-10">false part</span>⟩. This should be true for any entry that has been defined via <span class="cmtt-10">\newacronym</span><a - id="dx1-169017"></a>. There is no + id="dx1-169018"></a>. There is no check for the existence of ⟨<span class="cmti-10">label</span>⟩. - - -</p><!--l. 13490--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169018"></a> <span +</p><!--l. 13503--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169019"></a> <span class="cmtt-10">\ifglshasshort{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26921,20 +26804,20 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13492--><p class="noindent" > +</p><!--l. 13505--><p class="noindent" > This checks if the glossary entry given by ⟨<span class="cmti-10">label</span>⟩ has had the <span class="cmtt-10">short</span><a - id="dx1-169019"></a> field set. If it has, ⟨<span + id="dx1-169020"></a> field set. If it has, ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span class="cmti-10">false part</span>⟩. This should be true for any entry that has been defined via <span class="cmtt-10">\newacronym</span><a - id="dx1-169020"></a>. There is no + id="dx1-169021"></a>. There is no check for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13499--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169021"></a> <span +</p><!--l. 13512--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169022"></a> <span class="cmtt-10">\ifglshasdesc{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26942,16 +26825,16 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13501--><p class="noindent" > +</p><!--l. 13514--><p class="noindent" > This checks if the <span class="cmtt-10">description</span><a - id="dx1-169022"></a> field is non-empty for the entry given by ⟨<span + id="dx1-169023"></a> field is non-empty for the entry given by ⟨<span class="cmti-10">label</span>⟩. If it has, ⟨<span class="cmti-10">true part</span>⟩ is performed, otherwise ⟨<span class="cmti-10">false part</span>⟩. Compare with: -</p><!--l. 13505--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169023"></a> <span +</p><!--l. 13518--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169024"></a> <span class="cmtt-10">\ifglsdescsuppressed{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26959,21 +26842,21 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13507--><p class="noindent" > +</p><!--l. 13520--><p class="noindent" > This checks if the <span class="cmtt-10">description</span><a - id="dx1-169024"></a> field has been set to just <span + id="dx1-169025"></a> field has been set to just <span class="cmtt-10">\nopostdesc</span><a - id="dx1-169025"></a> for the entry given by ⟨<span + id="dx1-169026"></a> for the entry given by ⟨<span class="cmti-10">label</span>⟩. If it has, ⟨<span class="cmti-10">true</span> <span class="cmti-10">part</span>⟩ is performed, otherwise ⟨<span class="cmti-10">false part</span>⟩. There is no check for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13513--><p class="noindent" >For all other fields you can use: -</p><!--l. 13514--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169026"></a> <span +</p><!--l. 13526--><p class="indent" > For all other fields you can use: +</p><!--l. 13527--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169027"></a> <span class="cmtt-10">\ifglshasfield{</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26983,7 +26866,7 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13517--><p class="noindent" > +</p><!--l. 13530--><p class="noindent" > This tests the value of the field given by ⟨<span class="cmti-10">field</span>⟩ for the entry identified by ⟨<span class="cmti-10">label</span>⟩. If the value is empty <span @@ -26996,29 +26879,29 @@ class="cmti-10">true part</span>⟩ is performed. If the field supplied is class="cmti-10">false part</span>⟩ is performed and a warning is issued. Unlike the above commands, such as <span class="cmtt-10">\ifglshasshort</span>, an error occurs if the entry is undefined. -</p><!--l. 13526--><p class="indent" > As from version 4.23, within ⟨<span +</p><!--l. 13539--><p class="indent" > As from version 4.23, within ⟨<span class="cmti-10">true part</span>⟩ you can use -</p><!--l. 13527--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169027"></a> <span +</p><!--l. 13540--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169028"></a> <span class="cmtt-10">\glscurrentfieldvalue </span></div><hr> -</p><!--l. 13529--><p class="noindent" > +</p><!--l. 13542--><p class="noindent" > to access the field value. This command is initially defined to nothing but has no relevance outside ⟨<span class="cmti-10">true part</span>⟩. This saves re-accessing the field if the test is true. For example: </p> - <div class="verbatim" id="verbatim-385"> + <div class="verbatim" id="verbatim-386"> \ifglshasfield{useri}{sample}{, \glscurrentfieldvalue}{} </div> -<!--l. 13536--><p class="nopar" > will insert a comma, space and the field value if the <span +<!--l. 13549--><p class="nopar" > will insert a comma, space and the field value if the <span class="cmtt-10">user1</span><a - id="dx1-169028"></a> key has been set for the entry whose label is + id="dx1-169029"></a> key has been set for the entry whose label is <span class="cmtt-10">sample</span>. -</p><!--l. 13541--><p class="indent" > You can test if the value of the field is equal to a given string using: -</p><!--l. 13543--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169029"></a> <span +</p><!--l. 13554--><p class="indent" > You can test if the value of the field is equal to a given string using: +</p><!--l. 13556--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169030"></a> <span class="cmtt-10">\ifglsfieldeq{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27030,23 +26913,23 @@ class="cmitt-10">true</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13545--><p class="noindent" > +</p><!--l. 13558--><p class="noindent" > In this case the ⟨<span class="cmti-10">field</span>⟩ must be the field name not the key (see <a href="#tab:fieldmap">table 4.1</a>). If the field isn’t recognised, an error will occur. This command internally uses <span class="cmss-10">etoolbox</span><a - id="dx1-169030"></a>’s <span + id="dx1-169031"></a>’s <span class="cmtt-10">\ifcsstring </span>to perform the comparison. <span class="cmti-10">The string is not</span> <span class="cmti-10">expanded during the test.</span> -</p><!--l. 13552--><p class="indent" > The result may vary depending on whether or not expansion is on for the given field (when the entry was +</p><!--l. 13565--><p class="indent" > The result may vary depending on whether or not expansion is on for the given field (when the entry was defined). For example: </p> - <div class="verbatim" id="verbatim-386"> + <div class="verbatim" id="verbatim-387"> \documentclass{article}  <br />\usepackage{glossaries}  <br />\newcommand*{\foo}{FOO} @@ -27059,25 +26942,25 @@ defined). For example:  <br />\ifglsfieldeq{sample2}{useri}{FOO}{TRUE}{FALSE}.  <br />\end{document} </div> -<!--l. 13571--><p class="nopar" > This will produce “TRUE” in both cases since expansion is on, so <span +<!--l. 13584--><p class="nopar" > This will produce “TRUE” in both cases since expansion is on, so <span class="cmtt-10">\foo </span>was expanded to “FOO” when <span class="cmtt-10">sample2</span> was defined. If the tests are changed to: </p> - <div class="verbatim" id="verbatim-387"> + <div class="verbatim" id="verbatim-388"> \ifglsfieldeq{sample1}{useri}{\foo}{TRUE}{FALSE}.  <br />\ifglsfieldeq{sample2}{useri}{\foo}{TRUE}{FALSE}. </div> -<!--l. 13579--><p class="nopar" > then this will produce “FALSE” in both cases. Now suppose expansion is switched off for the <span +<!--l. 13592--><p class="nopar" > then this will produce “FALSE” in both cases. Now suppose expansion is switched off for the <span class="cmtt-10">user1</span><a - id="dx1-169031"></a> + id="dx1-169032"></a> key: </p> - <div class="verbatim" id="verbatim-388"> + <div class="verbatim" id="verbatim-389"> \documentclass{article}  <br />\usepackage{glossaries}  <br />\newcommand*{\foo}{FOO} @@ -27091,14 +26974,14 @@ key:  <br />\ifglsfieldeq{sample2}{useri}{FOO}{TRUE}{FALSE}.  <br />\end{document} </div> -<!--l. 13601--><p class="nopar" > This now produces “TRUE” for the first case (comparing “FOO” with “FOO”) and “FALSE” for the second +<!--l. 13614--><p class="nopar" > This now produces “TRUE” for the first case (comparing “FOO” with “FOO”) and “FALSE” for the second case (comparing “<span class="cmtt-10">\foo</span>” with “FOO”). -</p><!--l. 13606--><p class="indent" > The reverse happens in the following: +</p><!--l. 13619--><p class="indent" > The reverse happens in the following: </p> - <div class="verbatim" id="verbatim-389"> + <div class="verbatim" id="verbatim-390"> \documentclass{article}  <br />\usepackage{glossaries}  <br />\newcommand*{\foo}{FOO} @@ -27112,14 +26995,14 @@ class="cmtt-10">\foo</span>” with “FOO”).  <br />\ifglsfieldeq{sample2}{useri}{\foo}{TRUE}{FALSE}.  <br />\end{document} </div> -<!--l. 13626--><p class="nopar" > This now produces “FALSE” for the first case (comparing “FOO” with “<span +<!--l. 13639--><p class="nopar" > This now produces “FALSE” for the first case (comparing “FOO” with “<span class="cmtt-10">\foo</span>”) and “TRUE” for the second case (comparing “<span class="cmtt-10">\foo</span>” with “<span class="cmtt-10">\foo</span>”). -</p><!--l. 13631--><p class="indent" > You can test if the value of a field is equal to the replacement text of a command using: -</p><!--l. 13633--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169032"></a> <span +</p><!--l. 13644--><p class="indent" > You can test if the value of a field is equal to the replacement text of a command using: +</p><!--l. 13646--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169033"></a> <span class="cmtt-10">\ifglsfielddefeq{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27131,18 +27014,18 @@ class="cmitt-10">true</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13635--><p class="noindent" > +</p><!--l. 13648--><p class="noindent" > This internally uses <span class="cmss-10">etoolbox</span><a - id="dx1-169033"></a>’s <span + id="dx1-169034"></a>’s <span class="cmtt-10">\ifdefstrequal </span>command to perform the comparison. The argument ⟨<span class="cmti-10">command</span>⟩ must be a macro. -</p><!--l. 13639--><p class="indent" > For example: +</p><!--l. 13652--><p class="indent" > For example: </p> - <div class="verbatim" id="verbatim-390"> + <div class="verbatim" id="verbatim-391"> \documentclass{article}  <br />\usepackage{glossaries}  <br />\newcommand*{\foo}{FOO} @@ -27156,13 +27039,13 @@ must be a macro.  <br />\ifglsfielddefeq{sample2}{useri}{\foo}{TRUE}{FALSE}.  <br />\end{document} </div> -<!--l. 13659--><p class="nopar" > Here, the first case produces “TRUE” since the value of the <span +<!--l. 13672--><p class="nopar" > Here, the first case produces “TRUE” since the value of the <span class="cmtt-10">useri </span>field (“FOO”) is the same as the replacement text (definition) of <span class="cmtt-10">\foo </span>(“FOO”). We have the result “<span class="cmtt-10">FOO</span>” is equal to “<span class="cmtt-10">FOO</span>”. -</p><!--l. 13665--><p class="indent" > The second case produces “FALSE” since the value of the <span +</p><!--l. 13678--><p class="indent" > The second case produces “FALSE” since the value of the <span class="cmtt-10">useri </span>field (“<span class="cmtt-10">\foo</span>”) is not the same as the replacement text (definition) of <span @@ -27171,15 +27054,15 @@ class="cmtt-10">useri</span> field. We have the result “<span class="cmtt-10">\foo</span>” is not equal to “<span class="cmtt-10">FOO</span>”. -</p><!--l. 13671--><p class="indent" > If we add: +</p><!--l. 13684--><p class="indent" > If we add: </p> - <div class="verbatim" id="verbatim-391"> + <div class="verbatim" id="verbatim-392"> \newcommand{\FOO}{\foo}  <br />\ifglsfielddefeq{sample2}{useri}{\FOO}{TRUE}{FALSE}. </div> -<!--l. 13675--><p class="nopar" > we now get “TRUE” since the value of the <span +<!--l. 13688--><p class="nopar" > we now get “TRUE” since the value of the <span class="cmtt-10">useri </span>field (“<span class="cmtt-10">\foo</span>”) is the same as the replacement text (definition) of <span @@ -27187,10 +27070,10 @@ class="cmtt-10">\FOO </span>(“<span class="cmtt-10">\foo</span>”). We have the result “<span class="cmtt-10">\foo</span>” is equal to “<span class="cmtt-10">\foo</span>”. -</p><!--l. 13681--><p class="indent" > There is a similar command that requires the control sequence name (without the leading backslash) instead +</p><!--l. 13694--><p class="indent" > There is a similar command that requires the control sequence name (without the leading backslash) instead of the actual control sequence: -</p><!--l. 13683--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169034"></a> <span +</p><!--l. 13696--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169035"></a> <span class="cmtt-10">\ifglsfieldcseq{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27202,44 +27085,44 @@ class="cmitt-10">true</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13685--><p class="noindent" > +</p><!--l. 13698--><p class="noindent" > This internally uses <span class="cmss-10">etoolbox</span><a - id="dx1-169035"></a>’s <span + id="dx1-169036"></a>’s <span class="cmtt-10">\ifcsstrequal </span>command instead of <span class="cmtt-10">\ifdefstrequal</span>. -</p><!--l. 13689--><p class="noindent" > +</p><!--l. 13702--><p class="noindent" > </p> -<!--l. 13689--><p class="noindent" ><a +<!--l. 13702--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">16.3 </span> <a id="sec:fetchset"></a>Fetching and Updating the Value of a Field</h3> -<!--l. 13692--><p class="noindent" >In addition to the commands described in <a +<!--l. 13705--><p class="noindent" >In addition to the commands described in <a href="#sec:glsnolink">§9 </a><a href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>, the following may also be used to fetch field information. -</p><!--l. 13694--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13707--><p class="indent" > <hr><div title="Definition"><a id="dx1-170001"></a> <span class="cmtt-10">\glsentrytype{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13696--><p class="noindent" > +</p><!--l. 13709--><p class="noindent" > Expands to the entry’s glossary type. No existence check is performed. -</p><!--l. 13700--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13713--><p class="indent" > <hr><div title="Definition"><a id="dx1-170002"></a> <span class="cmtt-10">\glsentryparent{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13702--><p class="noindent" > +</p><!--l. 13715--><p class="noindent" > Expands to the label of the entry’s parent. No existence check is performed. -</p><!--l. 13706--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13719--><p class="indent" > <hr><div title="Definition"><a id="dx1-170003"></a> <span class="cmtt-10">\glsentrysort{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13708--><p class="noindent" > +</p><!--l. 13721--><p class="noindent" > Expands to the entry’s sort value. No existence check is performed. -</p><!--l. 13711--><p class="indent" > You can fetch the value of a given field and store it in a control sequence using: -</p><!--l. 13713--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13724--><p class="indent" > You can fetch the value of a given field and store it in a control sequence using: +</p><!--l. 13726--><p class="indent" > <hr><div title="Definition"><a id="dx1-170004"></a> <span class="cmtt-10">\glsfieldfetch{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27248,7 +27131,7 @@ class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">cs</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13715--><p class="noindent" > +</p><!--l. 13728--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the label identifying the glossary entry, ⟨<span class="cmti-10">field</span>⟩ is the field label (see <a @@ -27260,7 +27143,7 @@ the key used to set that field in the argument of <span class="cmtt-10">\newglossaryentry </span>(or the optional argument of <span class="cmtt-10">\newacronym</span>). -</p><!--l. 13724--><p class="indent" > You can change the value of a given field using one of the following commands. Note that these commands +</p><!--l. 13737--><p class="indent" > You can change the value of a given field using one of the following commands. Note that these commands only change the value of the given field. They have no affect on any related field. For example, if you change the value of the <span class="cmtt-10">text</span><a @@ -27272,12 +27155,12 @@ class="cmtt-10">plural</span><a class="cmtt-10">first</span><a id="dx1-170008"></a> or any other related key. -</p><!--l. 13730--><p class="indent" > In all the four related commands below, ⟨<span +</p><!--l. 13743--><p class="indent" > In all the four related commands below, ⟨<span class="cmti-10">label</span>⟩ and ⟨<span class="cmti-10">field</span>⟩ are as above and ⟨<span class="cmti-10">definition</span>⟩ is the new value of the field. -</p><!--l. 13734--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13747--><p class="indent" > <hr><div title="Definition"><a id="dx1-170009"></a> <span class="cmtt-10">\glsfielddef{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27286,12 +27169,12 @@ class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">definition</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13736--><p class="noindent" > +</p><!--l. 13749--><p class="noindent" > This uses <span class="cmtt-10">\def </span>to change the value of the field (so it will be localised by any grouping). -</p><!--l. 13740--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13753--><p class="indent" > <hr><div title="Definition"><a id="dx1-170010"></a> <span class="cmtt-10">\glsfieldedef{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27300,12 +27183,12 @@ class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">definition</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13742--><p class="noindent" > +</p><!--l. 13755--><p class="noindent" > This uses <span class="cmtt-10">\edef </span>to change the value of the field (so it will be localised by any grouping). Any fragile commands contained in the ⟨<span class="cmti-10">definition</span>⟩ must be protected. -</p><!--l. 13747--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13760--><p class="indent" > <hr><div title="Definition"><a id="dx1-170011"></a> <span class="cmtt-10">\glsfieldgdef{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27314,10 +27197,10 @@ class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">definition</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13749--><p class="noindent" > +</p><!--l. 13762--><p class="noindent" > This uses <span class="cmtt-10">\gdef </span>to change the value of the field. -</p><!--l. 13752--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13765--><p class="indent" > <hr><div title="Definition"><a id="dx1-170012"></a> <span class="cmtt-10">\glsfieldxdef{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27326,7 +27209,7 @@ class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">definition</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13754--><p class="noindent" > +</p><!--l. 13767--><p class="noindent" > This uses <span class="cmtt-10">\xdef </span>to change the value of the field. Any fragile commands contained in the ⟨<span class="cmti-10">definition</span>⟩ must be @@ -27334,11 +27217,11 @@ protected. </p> -<!--l. 13759--><p class="indent" > </div> -</p><!--l. 13759--><p class="noindent" ><a +<!--l. 13772--><p class="indent" > </div> +</p><!--l. 13772--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">17. <a id="sec:prefix"></a>Prefixes or Determiners</h2> -</p><!--l. 13761--><p class="indent" > The <span +</p><!--l. 13774--><p class="indent" > The <span class="cmss-10">glossaries-prefix</span><a id="dx1-171001"></a> package that comes with the <span class="cmss-10">glossaries </span>package provides additional keys that can be @@ -27347,7 +27230,7 @@ The <span class="cmss-10">glossaries-prefix </span>package automatically loads the <span class="cmss-10">glossaries </span>package and has the same package options. -</p><!--l. 13769--><p class="indent" > The extra keys for <span +</p><!--l. 13782--><p class="indent" > The extra keys for <span class="cmtt-10">\newglossaryentry</span><a id="dx1-171002"></a> are as follows: </p><dl class="description"><dt class="description"> @@ -27386,20 +27269,20 @@ class="cmtt-10">prefixplural</span><a id="dx1-171012"></a> key.</dd></dl> <a id="ex:determiners"></a> -<!--l. 13786--><p class="noindent" ><span +<!--l. 13799--><p class="noindent" ><span class="cmbx-12">Example 30</span><span class="cmbx-12"> (Defining Determiners)</span><a id="x1-171014"></a> -</p><!--l. 13787--><p class="indent" > Here’s the start of my example document: +</p><!--l. 13800--><p class="indent" > Here’s the start of my example document: </p> - <div class="verbatim" id="verbatim-392"> + <div class="verbatim" id="verbatim-393"> \documentclass{article}  <br />\usepackage[colorlinks]{hyperref}  <br />\usepackage[toc,acronym]{glossaries-prefix} </div> -<!--l. 13793--><p class="nopar" > Note that I’ve simply replaced <span +<!--l. 13806--><p class="nopar" > Note that I’ve simply replaced <span class="cmss-10">glossaries </span>from previous sample documents with <span class="cmss-10">glossaries-prefix</span>. Now for a sample definition<span class="footnote-mark"><a @@ -27408,28 +27291,28 @@ href="#fn1x17" id="fn1x17-bk"><sup class="textsuperscript">17.1</sup></a></span> </p> - <div class="verbatim" id="verbatim-393"> + <div class="verbatim" id="verbatim-394"> \newglossaryentry{sample}{name={sample},%  <br />  description={an example},%  <br />  prefix={a~},%  <br />  prefixplural={the\space}%  <br />} </div> -<!--l. 13805--><p class="nopar" > Note that I’ve had to explicitly insert a space after the prefix since there’s no designated separator between the +<!--l. 13818--><p class="nopar" > Note that I’ve had to explicitly insert a space after the prefix since there’s no designated separator between the prefix and the term being referenced. This not only means that you can vary between a breaking space and non-breaking space, but also allows for the possibility of prefixes that shouldn’t have a space, such as: </p> - <div class="verbatim" id="verbatim-394"> + <div class="verbatim" id="verbatim-395"> \newglossaryentry{oeil}{name={oeil},  <br />  plural={yeux},  <br />  description={eye},  <br />  prefix={l'},  <br />  prefixplural={les\space}} </div> -<!--l. 13818--><p class="nopar" > Where a space is required at the end of the prefix, you must use a spacing command, such as +<!--l. 13831--><p class="nopar" > Where a space is required at the end of the prefix, you must use a spacing command, such as <span class="cmtt-10">\space</span>, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\␣</span></span></span> (backslash space) or <span class="obeylines-h"><span class="verb"><span @@ -27437,36 +27320,36 @@ class="cmtt-10">~</span></span></span> due to the automatic spacing trimming per class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ options. -</p><!--l. 13824--><p class="indent" > In the event that you always require a space between the prefix and the term, then you can instead +</p><!--l. 13837--><p class="indent" > In the event that you always require a space between the prefix and the term, then you can instead redefine -</p><!--l. 13826--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13839--><p class="indent" > <hr><div title="Definition"><a id="dx1-171017"></a> <span class="cmtt-10">\glsprefixsep </span></div><hr> -</p><!--l. 13828--><p class="noindent" > +</p><!--l. 13841--><p class="noindent" > to do a space. (This command does nothing by default.) For example: </p> - <div class="verbatim" id="verbatim-395"> + <div class="verbatim" id="verbatim-396"> \renewcommand{\glsprefixsep}{\space} </div> -<!--l. 13832--><p class="nopar" > -</p><!--l. 13834--><p class="indent" > The prefixes can also be used with acronyms. For example: +<!--l. 13845--><p class="nopar" > +</p><!--l. 13847--><p class="indent" > The prefixes can also be used with acronyms. For example: </p> - <div class="verbatim" id="verbatim-396"> + <div class="verbatim" id="verbatim-397"> \newacronym  <br /> [%  <br />   prefix={an\space},prefixfirst={a~}%  <br /> ]{svm}{SVM}{support vector machine} </div> -<!--l. 13840--><p class="nopar" > </p> +<!--l. 13853--><p class="nopar" > </p> <div class="center" > -<!--l. 13841--><p class="noindent" > -</p><!--l. 13841--><p class="noindent" >____________________________</p></div> -<!--l. 13843--><p class="indent" > The <span +<!--l. 13854--><p class="noindent" > +</p><!--l. 13854--><p class="noindent" >____________________________</p></div> +<!--l. 13856--><p class="indent" > The <span class="cmss-10">glossaries-prefix</span><a id="dx1-171018"></a> package provides convenient commands to use these prefixes with commands such as <span @@ -27480,7 +27363,7 @@ class="cmtt-10">\gls</span>-like</a> command. (See <a href="#sec:glslink">§6 </a><a href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> for further details.) -</p><!--l. 13850--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13863--><p class="indent" > <hr><div title="Definition"><a id="dx1-171021"></a> <span class="cmtt-10">\pgls[</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -27489,7 +27372,7 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 13852--><p class="noindent" > +</p><!--l. 13865--><p class="noindent" > This is inserts the value of the <span class="cmtt-10">prefix</span><a id="dx1-171022"></a> key (or <span @@ -27505,7 +27388,7 @@ class="cmtt-10">}</span> class="cmtt-10">[</span>⟨<span class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. -</p><!--l. 13857--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13870--><p class="indent" > <hr><div title="Definition"><a id="dx1-171024"></a> <span class="cmtt-10">\Pgls[</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -27514,7 +27397,7 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 13859--><p class="noindent" > +</p><!--l. 13872--><p class="noindent" > If the <span class="cmtt-10">prefix</span><a id="dx1-171025"></a> key (or <span @@ -27538,7 +27421,7 @@ class="cmti-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. -</p><!--l. 13867--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13880--><p class="indent" > <hr><div title="Definition"><a id="dx1-171028"></a> <span class="cmtt-10">\PGLS[</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -27547,13 +27430,13 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 13869--><p class="noindent" > +</p><!--l. 13882--><p class="noindent" > As <span class="cmtt-10">\pgls </span>but converts the prefix to upper case and uses <span class="cmtt-10">\GLS</span><a id="dx1-171029"></a> instead of <span class="cmtt-10">\gls</span>. -</p><!--l. 13873--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13886--><p class="indent" > <hr><div title="Definition"><a id="dx1-171030"></a> <span class="cmtt-10">\pglspl[</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -27562,7 +27445,7 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 13875--><p class="noindent" > +</p><!--l. 13888--><p class="noindent" > This is inserts the value of the <span class="cmtt-10">prefixplural</span><a id="dx1-171031"></a> key (or <span @@ -27578,7 +27461,7 @@ class="cmti-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. -</p><!--l. 13880--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13893--><p class="indent" > <hr><div title="Definition"><a id="dx1-171033"></a> <span class="cmtt-10">\Pglspl[</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -27587,7 +27470,7 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 13882--><p class="noindent" > +</p><!--l. 13895--><p class="noindent" > If the <span class="cmtt-10">prefixplural</span><a id="dx1-171034"></a> key (or <span @@ -27611,7 +27494,7 @@ class="cmti-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. -</p><!--l. 13890--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13903--><p class="indent" > <hr><div title="Definition"><a id="dx1-171037"></a> <span class="cmtt-10">\PGLSpl[</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -27620,7 +27503,7 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 13892--><p class="noindent" > +</p><!--l. 13905--><p class="noindent" > As <span class="cmtt-10">\pglspl </span>but converts the prefix to upper case and uses <span class="cmtt-10">\GLSpl</span><a @@ -27628,11 +27511,11 @@ class="cmtt-10">\GLSpl</span><a class="cmtt-10">\glspl</span>. <a id="ex:prefixes"></a> -</p><!--l. 13896--><p class="noindent" ><span +</p><!--l. 13909--><p class="noindent" ><span class="cmbx-12">Example 31</span><span class="cmbx-12"> (Using Prefixes)</span><a id="x1-171040"></a> -</p><!--l. 13897--><p class="indent" > Continuing from Example <a +</p><!--l. 13910--><p class="indent" > Continuing from Example <a href="#ex:determiners">30<!--tex4ht:ref: ex:determiners --></a>, now that I’ve defined my entries, I can use them in the text via the above @@ -27640,25 +27523,25 @@ commands: </p> - <div class="verbatim" id="verbatim-397"> + <div class="verbatim" id="verbatim-398"> First use: \pgls{svm}. Next use: \pgls{svm}.  <br />Singular: \pgls{sample}, \pgls{oeil}.  <br />Plural: \pglspl{sample}, \pglspl{oeil}. </div> -<!--l. 13903--><p class="nopar" > which produces: +<!--l. 13916--><p class="nopar" > which produces: </p><div class="quote"> - <!--l. 13906--><p class="noindent" >First use: a support vector machine (SVM). Next use: an SVM. Singular: a sample, l’oeil. + <!--l. 13919--><p class="noindent" >First use: a support vector machine (SVM). Next use: an SVM. Singular: a sample, l’oeil. Plural: the samples, les yeux.</p></div> -<!--l. 13910--><p class="noindent" >For a complete document, see <a +<!--l. 13923--><p class="noindent" >For a complete document, see <a href="#ex:sample-prefix"><span class="cmtt-10">sample-prefix.tex</span></a>. </p> <div class="center" > -<!--l. 13911--><p class="noindent" > -</p><!--l. 13911--><p class="noindent" >____________________________</p></div> -<!--l. 13913--><p class="indent" > This package also provides the commands described below, none of which perform any check to determine +<!--l. 13924--><p class="noindent" > +</p><!--l. 13924--><p class="noindent" >____________________________</p></div> +<!--l. 13926--><p class="indent" > This package also provides the commands described below, none of which perform any check to determine the entry’s existence. -</p><!--l. 13916--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13929--><p class="indent" > <hr><div title="Definition"><a id="dx1-171041"></a> <span class="cmtt-10">\ifglshasprefix{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27667,14 +27550,14 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13918--><p class="noindent" > +</p><!--l. 13931--><p class="noindent" > Does ⟨<span class="cmti-10">true part</span>⟩ if the entry identified by ⟨<span class="cmti-10">label</span>⟩ has a non-empty value for the <span class="cmtt-10">prefix</span><a id="dx1-171042"></a> key. -</p><!--l. 13922--><p class="indent" > This package also provides the following commands: -</p><!--l. 13923--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13935--><p class="indent" > This package also provides the following commands: +</p><!--l. 13936--><p class="indent" > <hr><div title="Definition"><a id="dx1-171043"></a> <span class="cmtt-10">\ifglshasprefixplural{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27683,13 +27566,13 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13925--><p class="noindent" > +</p><!--l. 13938--><p class="noindent" > Does ⟨<span class="cmti-10">true part</span>⟩ if the entry identified by ⟨<span class="cmti-10">label</span>⟩ has a non-empty value for the <span class="cmtt-10">prefixplural</span><a id="dx1-171044"></a> key. -</p><!--l. 13929--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13942--><p class="indent" > <hr><div title="Definition"><a id="dx1-171045"></a> <span class="cmtt-10">\ifglshasprefixfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27698,13 +27581,13 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13931--><p class="noindent" > +</p><!--l. 13944--><p class="noindent" > Does ⟨<span class="cmti-10">true part</span>⟩ if the entry identified by ⟨<span class="cmti-10">label</span>⟩ has a non-empty value for the <span class="cmtt-10">prefixfirst</span><a id="dx1-171046"></a> key. -</p><!--l. 13935--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13948--><p class="indent" > <hr><div title="Definition"><a id="dx1-171047"></a> <span class="cmtt-10">\ifglshasprefixfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -27713,96 +27596,96 @@ class="cmitt-10">true part</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13937--><p class="noindent" > +</p><!--l. 13950--><p class="noindent" > Does ⟨<span class="cmti-10">true part</span>⟩ if the entry identified by ⟨<span class="cmti-10">label</span>⟩ has a non-empty value for the <span class="cmtt-10">prefixfirstplural</span> key. -</p><!--l. 13941--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13954--><p class="indent" > <hr><div title="Definition"><a id="dx1-171048"></a> <span class="cmtt-10">\glsentryprefix{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13943--><p class="noindent" > +</p><!--l. 13956--><p class="noindent" > Displays the value of the <span class="cmtt-10">prefix</span><a id="dx1-171049"></a> key for the entry given by ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13947--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13960--><p class="indent" > <hr><div title="Definition"><a id="dx1-171050"></a> <span class="cmtt-10">\glsentryprefixfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13949--><p class="noindent" > +</p><!--l. 13962--><p class="noindent" > Displays the value of the <span class="cmtt-10">prefixfirst</span><a id="dx1-171051"></a> key for the entry given by ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13953--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13966--><p class="indent" > <hr><div title="Definition"><a id="dx1-171052"></a> <span class="cmtt-10">\glsentryprefixplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13955--><p class="noindent" > +</p><!--l. 13968--><p class="noindent" > Displays the value of the <span class="cmtt-10">prefixplural</span><a id="dx1-171053"></a> key for the entry given by ⟨<span class="cmti-10">label</span>⟩. (No check is performed to determine if the entry exists.) -</p><!--l. 13960--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13973--><p class="indent" > <hr><div title="Definition"><a id="dx1-171054"></a> <span class="cmtt-10">\glsentryprefixfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13962--><p class="noindent" > +</p><!--l. 13975--><p class="noindent" > Displays the value of the <span class="cmtt-10">prefixfirstplural</span><a id="dx1-171055"></a> key for the entry given by ⟨<span class="cmti-10">label</span>⟩. (No check is performed to determine if the entry exists.) -</p><!--l. 13967--><p class="indent" > There are also variants that convert the first letter to upper +</p><!--l. 13980--><p class="indent" > There are also variants that convert the first letter to upper case<span class="footnote-mark"><a href="#fn2x17" id="fn2x17-bk"><sup class="textsuperscript">17.2</sup></a></span><a id="x1-171056f2"></a>: -</p><!--l. 13970--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13983--><p class="indent" > <hr><div title="Definition"><a id="dx1-171057"></a> <span class="cmtt-10">\Glsentryprefix{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13972--><p class="noindent" > -</p><!--l. 13973--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13985--><p class="noindent" > +</p><!--l. 13986--><p class="indent" > <hr><div title="Definition"><a id="dx1-171058"></a> <span class="cmtt-10">\Glsentryprefixfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13975--><p class="noindent" > -</p><!--l. 13976--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13988--><p class="noindent" > +</p><!--l. 13989--><p class="indent" > <hr><div title="Definition"><a id="dx1-171059"></a> <span class="cmtt-10">\Glsentryprefixplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13978--><p class="noindent" > -</p><!--l. 13980--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 13991--><p class="noindent" > +</p><!--l. 13993--><p class="indent" > <hr><div title="Definition"><a id="dx1-171060"></a> <span class="cmtt-10">\Glsentryprefixfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13982--><p class="noindent" > -</p><!--l. 13984--><p class="indent" > <div class="important" title="Important Note"> As with analogous commands such as <span +</p><!--l. 13995--><p class="noindent" > +</p><!--l. 13997--><p class="indent" > <div class="important" title="Important Note"> As with analogous commands such as <span class="cmtt-10">\Glsentrytext</span><a id="dx1-171061"></a>, these commands aren’t expandable so can’t be used in PDF bookmarks. </div> -</p><!--l. 13987--><p class="noindent" > +</p><!--l. 14000--><p class="noindent" > <a id="ex:plist"></a> -</p><!--l. 13989--><p class="noindent" ><span +</p><!--l. 14002--><p class="noindent" ><span class="cmbx-12">Example 32</span><span class="cmbx-12"> (Adding Determiner to Glossary Style)</span><a id="x1-171063"></a> -</p><!--l. 13990--><p class="indent" > You can use the above commands to define a new glossary style that uses the determiner. For +</p><!--l. 14003--><p class="indent" > You can use the above commands to define a new glossary style that uses the determiner. For example, the following style is a slight modification of the <span class="cmss-10">list</span><a id="dx1-171064"></a> style that inserts the prefix before the @@ -27810,7 +27693,7 @@ name: </p> - <div class="verbatim" id="verbatim-398"> + <div class="verbatim" id="verbatim-399"> \newglossarystyle{plist}{%  <br />  \setglossarystyle{list}%  <br />  \renewcommand*{\glossentry}[2]{% @@ -27820,12 +27703,12 @@ name:  <br />       \glossentrydesc{##1}\glspostdescription\space ##2}%  <br />} </div> -<!--l. 14003--><p class="nopar" > If you want to change the prefix separator (<span +<!--l. 14016--><p class="nopar" > If you want to change the prefix separator (<span class="cmtt-10">\glsprefixsep</span>) then the following is better: </p> - <div class="verbatim" id="verbatim-399"> + <div class="verbatim" id="verbatim-400"> \newglossarystyle{plist}{%  <br />  \setglossarystyle{list}%  <br />  \renewcommand*{\glossentry}[2]{% @@ -27835,12 +27718,12 @@ class="cmtt-10">\glsprefixsep</span>) then the following is better:  <br />       \glossentrydesc{##1}\glspostdescription\space ##2}%  <br />} </div> -<!--l. 14015--><p class="nopar" > The conditional is also useful if you want the style to use an uppercase letter at the start of the entry +<!--l. 14028--><p class="nopar" > The conditional is also useful if you want the style to use an uppercase letter at the start of the entry item: </p> - <div class="verbatim" id="verbatim-400"> + <div class="verbatim" id="verbatim-401"> \newglossarystyle{plist}{%  <br />  \setglossarystyle{list}%  <br />  \renewcommand*{\glossentry}[2]{% @@ -27854,18 +27737,18 @@ item:  <br />       \glossentrydesc{##1}\glspostdescription\space ##2}%  <br />} </div> -<!--l. 14031--><p class="nopar" > </p> +<!--l. 14044--><p class="nopar" > </p> <div class="center" > -<!--l. 14032--><p class="noindent" > -</p><!--l. 14032--><p class="noindent" >____________________________</p></div> +<!--l. 14045--><p class="noindent" > +</p><!--l. 14045--><p class="noindent" >____________________________</p></div> -<!--l. 14034--><p class="indent" > </div> -</p><!--l. 14034--><p class="noindent" ><a +<!--l. 14047--><p class="indent" > </div> +</p><!--l. 14047--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">18. <a id="sec:accsupp"></a>Accessibility Support</h2> -</p><!--l. 14036--><p class="indent" > Limited accessibility support is provided by the accompanying <span +</p><!--l. 14049--><p class="indent" > Limited accessibility support is provided by the accompanying <span class="cmss-10">glossaries-accsupp</span><a id="dx1-172001"></a> package, but note that this package is experimental and it requires the <span @@ -27880,17 +27763,17 @@ For example: </p> - <div class="verbatim" id="verbatim-401"> + <div class="verbatim" id="verbatim-402"> \usepackage[acronym]{glossaries-accsupp} </div> -<!--l. 14044--><p class="nopar" > This will load <span +<!--l. 14057--><p class="nopar" > This will load <span class="cmss-10">glossaries</span><a id="dx1-172005"></a> with the <span class="cmss-10">acronym</span><a id="dx1-172006"></a> package option as well as loading <span class="cmss-10">glossaries-accsupp</span><a id="dx1-172007"></a>. -</p><!--l. 14048--><p class="indent" > If you are using the <a +</p><!--l. 14061--><p class="indent" > If you are using the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> extension package, you need to load <a href="#glo:glossaries-extra"><span @@ -27901,10 +27784,10 @@ package option. For example: </p> - <div class="verbatim" id="verbatim-402"> + <div class="verbatim" id="verbatim-403"> \usepackage[abbreviations,accsupp]{glossaries-extra} </div> -<!--l. 14053--><p class="nopar" > This will load <a +<!--l. 14066--><p class="nopar" > This will load <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> (with the <span id="textcolor284"><span class="cmss-10">abbreviations</span></span><a @@ -27914,7 +27797,7 @@ class="cmss-10">glossaries</span><a class="cmss-10">glossaries-accsupp</span><a id="dx1-172011"></a> and make appropriate patches to integrate the accessibility support with the extension commands. -</p><!--l. 14059--><p class="indent" > The <span +</p><!--l. 14072--><p class="indent" > The <span class="cmss-10">glossaries-accsupp</span><a id="dx1-172012"></a> package defines additional keys that may be used when defining glossary entries. The keys are as follows: @@ -28233,30 +28116,30 @@ class="description"> class="cmtt-10">user6</span><a id="dx1-172054"></a> key.</dd></dl> -<!--l. 14120--><p class="noindent" >For example: +<!--l. 14133--><p class="noindent" >For example: </p> - <div class="verbatim" id="verbatim-403"> + <div class="verbatim" id="verbatim-404"> \newglossaryentry{tex}{name={\TeX},description={Document  <br />preparation language},access={TeX}} </div> -<!--l. 14124--><p class="nopar" > Now the <a +<!--l. 14137--><p class="nopar" > Now the <a href="#glo:linktext">link text<a id="dx1-172055"></a></a> produced by <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{tex}</span></span></span> will be: </p> - <div class="verbatim" id="verbatim-404"> + <div class="verbatim" id="verbatim-405"> \BeginAccSupp{ActualText={TeX}}\TeX\EndAccSupp{} </div> -<!--l. 14128--><p class="nopar" > The sample file <a +<!--l. 14141--><p class="nopar" > The sample file <a href="#ex:sampleaccsupp"><span class="cmtt-10">sampleaccsupp.tex</span></a> illustrates the <span class="cmss-10">glossaries-accsupp</span><a id="dx1-172056"></a> package. -</p><!--l. 14132--><p class="indent" > If you prefer to use <span +</p><!--l. 14145--><p class="indent" > If you prefer to use <span class="cmss-10">accessibility</span><a id="dx1-172057"></a> or <span class="cmss-10">tagpdf</span><a @@ -28269,7 +28152,7 @@ class="cmtt-10">\gls@accessibility </span>before loading <span class="cmss-10">glossaries-accsupp</span><a id="dx1-172060"></a>. See the section “Accessibility Support”in the documented code for further details. -</p><!--l. 14139--><p class="indent" > The PDF specification identifies three different types of replacement text: +</p><!--l. 14152--><p class="indent" > The PDF specification identifies three different types of replacement text: </p><dl class="description"><dt class="description"> <span class="cmbx-10">Alt</span> </dt><dd @@ -28285,25 +28168,25 @@ class="description">A character or sequence of characters that replaces textual class="cmbx-10">E</span> </dt><dd class="description">Expansion of an abbreviation to avoid ambiguity (for example, “St” could be short for “saint” or “street”).</dd></dl> -<!--l. 14151--><p class="indent" > <div class="important" title="Important Note"> Many PDF viewers don’t actually support any type of replacement text. Some may support “ActualText” +<!--l. 14164--><p class="indent" > <div class="important" title="Important Note"> Many PDF viewers don’t actually support any type of replacement text. Some may support “ActualText” but not “Alt” or “E”. <a href="https://pdfbox.apache.org/" >PDFBox</a>’s “PDFDebugger” tool can be used to inspect the PDF content to make sure that the replacement text has been correctly set. </div> -</p><!--l. 14157--><p class="noindent" > -</p><!--l. 14159--><p class="indent" > If you define abbreviations with <span +</p><!--l. 14170--><p class="noindent" > +</p><!--l. 14172--><p class="indent" > If you define abbreviations with <span class="cmtt-10">\newacronym</span><a id="dx1-172061"></a>, the <span class="cmtt-10">shortaccess</span><a id="dx1-172062"></a> field will automatically be set to: -</p><!--l. 14161--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 14174--><p class="indent" > <hr><div title="Definition"><a id="dx1-172063"></a> <span class="cmtt-10">\glsdefaultshortaccess{</span>⟨<span class="cmitt-10">long</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">short</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 14163--><p class="noindent" > +</p><!--l. 14176--><p class="noindent" > With the base <span class="cmss-10">glossaries </span>package this just expands to ⟨<span class="cmti-10">long</span>⟩. With <a @@ -28312,22 +28195,22 @@ class="cmss-10">glossaries-extra</span></a> this expands to ⟨<span class="cmti-10">long</span>⟩ (⟨<span class="cmti-10">short</span>⟩). This command must be fully expandable. It expands when the abbreviation is defined. -</p><!--l. 14169--><p class="indent" > As from <span +</p><!--l. 14182--><p class="indent" > As from <span class="cmss-10">glossaries-accsupp</span><a id="dx1-172064"></a> v4.45, the helper command used to identify the replacement text depends on the field name. Previous versions just used: -</p><!--l. 14172--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 14185--><p class="indent" > <hr><div title="Definition"><a id="dx1-172065"></a> <span class="cmtt-10">\glsaccsupp{</span>⟨<span class="cmitt-10">replacement</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">content</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 14174--><p class="noindent" > +</p><!--l. 14187--><p class="noindent" > for all fields. This is defined to use <span class="cmtt-10">ActualText</span>, which is appropriate for symbols but not for abbreviations. -</p><!--l. 14178--><p class="indent" > As from v4.45, there’s a new helper command: -</p><!--l. 14179--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 14191--><p class="indent" > As from v4.45, there’s a new helper command: +</p><!--l. 14192--><p class="indent" > <hr><div title="Definition"><a id="dx1-172066"></a> <span class="cmtt-10">\glsfieldaccsupp{</span>⟨<span class="cmitt-10">replacement</span>⟩<span @@ -28338,7 +28221,7 @@ class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 14181--><p class="noindent" > +</p><!--l. 14194--><p class="noindent" > This will use <span class="cmtt-10">\gls</span>⟨<span class="cmitt-10">field</span>⟩<span @@ -28350,19 +28233,19 @@ class="cmtt-10">short</span><a id="dx1-172068"></a> and <span class="cmtt-10">shortplural</span><a id="dx1-172069"></a>: -</p><!--l. 14185--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 14198--><p class="indent" > <hr><div title="Definition"><a id="dx1-172070"></a> <span class="cmtt-10">\glsshortaccsupp{</span>⟨<span class="cmitt-10">replacement</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">content</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 14187--><p class="noindent" > +</p><!--l. 14200--><p class="noindent" > which is like <span class="cmtt-10">\glsaccsupp </span>but uses <span class="cmtt-10">E </span>instead of <span class="cmtt-10">ActualText </span>and -</p><!--l. 14190--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 14203--><p class="indent" > <hr><div title="Definition"><a id="dx1-172071"></a> <span class="cmtt-10">\glsshortplaccsupp{</span>⟨<span class="cmitt-10">replacement</span>⟩<span @@ -28371,7 +28254,7 @@ class="cmitt-10">content</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 14192--><p class="noindent" > +</p><!--l. 14205--><p class="noindent" > which just does <span class="cmtt-10">\glsshortaccsupp{</span>⟨<span class="cmti-10">replacement</span>⟩<span @@ -28384,10 +28267,10 @@ class="cmti-10">internal </span>field name class="cmtt-10">shortpl</span>) not the key name (such as <span class="cmtt-10">shortplural</span>). See <a href="#tab:fieldmap">table 4.1</a>. -</p><!--l. 14198--><p class="indent" > Rather than explicitly using <span +</p><!--l. 14211--><p class="indent" > Rather than explicitly using <span class="cmtt-10">\BeginAccSupp</span><a id="dx1-172072"></a>, these helper commands can use: -</p><!--l. 14200--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 14213--><p class="indent" > <hr><div title="Definition"><a id="dx1-172073"></a> <span class="cmtt-10">\glsaccessibility[</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -28398,7 +28281,7 @@ class="cmitt-10">value</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">content</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 14202--><p class="noindent" > +</p><!--l. 14215--><p class="noindent" > where ⟨<span class="cmti-10">tag</span>⟩ is one of <span class="cmtt-10">E</span>, <span @@ -28430,28 +28313,28 @@ class="cmss-10">showaccsupp</span><a id="dx1-172076"></a> is used. If you explicitly use <span class="cmtt-10">\BeginAccSupp</span> instead of this command then the debugging support won’t be available. -<!--l. 14214--><p class="indent" > You can define your own custom helper commands for specific fields that require them. For +<!--l. 14227--><p class="indent" > You can define your own custom helper commands for specific fields that require them. For example: </p> - <div class="verbatim" id="verbatim-405"> + <div class="verbatim" id="verbatim-406"> \newcommand{\glssymbolaccsupp}[2]{%  <br /> \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}%  <br />} </div> -<!--l. 14220--><p class="nopar" > This definition requires the replacement text to be specified with the hexadecimal character code. For +<!--l. 14233--><p class="nopar" > This definition requires the replacement text to be specified with the hexadecimal character code. For example: </p> - <div class="verbatim" id="verbatim-406"> + <div class="verbatim" id="verbatim-407"> \newglossaryentry{int}{name={int},description={integral},  <br />  symbol={\ensuremath{\int}},symbolaccess={222B}  <br />} </div> -<!--l. 14227--><p class="nopar" > -</p><!--l. 14229--><p class="indent" > If you are using <a +<!--l. 14240--><p class="nopar" > +</p><!--l. 14242--><p class="indent" > If you are using <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, then <span class="cmtt-10">\glsfieldaccsupp </span>will first test for the existence of @@ -28473,7 +28356,7 @@ example: </p> - <div class="verbatim" id="verbatim-407"> + <div class="verbatim" id="verbatim-408"> \usepackage{siunitx}  <br />\usepackage[accsupp]{glossaries-extra}  <br />\glsnoexpandfields @@ -28490,7 +28373,7 @@ example:  <br />  description={integral},category={symbol}  <br />} </div> -<!--l. 14255--><p class="nopar" > The above uses the <span id="textcolor287"><span +<!--l. 14268--><p class="nopar" > The above uses the <span id="textcolor287"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">category</span>⟩<span class="cmtt-10">accsupp</span></span><a @@ -28510,7 +28393,7 @@ class="cmtt-10">first</span><a </p> - <div class="verbatim" id="verbatim-408"> + <div class="verbatim" id="verbatim-409"> \newcommand{\glsnameaccsupp}[2]{%  <br /> \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}%  <br />} @@ -28519,8 +28402,8 @@ class="cmtt-10">first</span><a  <br />\newcommand{\glsfirstaccsupp}{\glsnameaccsupp}  <br />\newcommand{\glsfirstplaccsupp}{\glsnameaccsupp} </div> -<!--l. 14269--><p class="nopar" > -</p><!--l. 14271--><p class="indent" > See the documented code (<span +<!--l. 14282--><p class="nopar" > +</p><!--l. 14284--><p class="indent" > See the documented code (<span class="cmtt-10">glossaries-code.pdf</span>) for further details. I recommend that you also read the <span class="cmss-10">accsupp</span><a @@ -28532,22 +28415,21 @@ class="cmss-10">tagpdf</span><a </p> -<!--l. 14276--><p class="indent" > </div> -</p><!--l. 14276--><p class="noindent" ><a +<!--l. 14289--><p class="indent" > </div> +</p><!--l. 14289--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">19. <a id="sec:samples"></a>Sample Documents</h2> -</p><!--l. 14279--><p class="indent" > The <span +</p><!--l. 14292--><p class="indent" > The <span class="cmss-10">glossaries </span>package is provided with some sample documents that illustrate the various functions. These should be located in the <span class="cmtt-10">samples </span>subdirectory (folder) of the <span class="cmss-10">glossaries </span>documentation directory. This -location varies according to your operating system and <span class="TEX">T<span -class="E">E</span>X</span> distribution. You can use <span +location varies according to your operating system and TeX distribution. You can use <span class="cmtt-10">texdoc</span> to locate the main glossaries documentation. For example, in a <a href="http://www.dickimaw-books.com/latex/novices/html/terminal.html" >terminal or command prompt</a>, type: -</p><!--l. 14287--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14300--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />texdoc -l glossaries <br /></pre><spacer type=vertical size=10> <br /></span> @@ -28555,12 +28437,12 @@ This should display a list of all the files in the <span class="cmss-10">glossaries </span>documentation directory with their full pathnames. (The GUI version of <span class="cmtt-10">texdoc </span>may also provide you with the information.) -</p><!--l. 14294--><p class="indent" > If you can’t find the sample files on your computer, they are also available from your nearest CTAN mirror +</p><!--l. 14307--><p class="indent" > If you can’t find the sample files on your computer, they are also available from your nearest CTAN mirror at <a href="http://mirror.ctan.org/macros/latex/contrib/glossaries/samples/" class="url" ><span class="cmtt-10">http://mirror.ctan.org/macros/latex/contrib/glossaries/samples/</span></a>. Each sample file listed below has a hyperlink to the file’s location on the CTAN mirror. -</p><!--l. 14300--><p class="indent" > The <a +</p><!--l. 14313--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package and <a href="#glo:bib2gls"><span @@ -28568,14 +28450,14 @@ class="cmtt-10">bib2gls</span><a id="dx1-173001"></a></a> provide some additional sample files. There are also examples in the <a href="https://www.dickimaw-books.com/gallery/" >Dickimaw Books Gallery</a>. -</p><!--l. 14304--><p class="indent" > If you prefer to use UTF-8 aware engines (<span +</p><!--l. 14317--><p class="indent" > If you prefer to use UTF-8 aware engines (<span class="cmtt-10">xelatex </span>or <span class="cmtt-10">lualatex</span>) remember that you’ll need to switch from <span class="cmss-10">fontenc </span>& <span class="cmss-10">inputenc </span>to <span class="cmss-10">fontspec </span>where appropriate. -</p><!--l. 14310--><p class="indent" > If you get any errors or unexpected results, check that you have up-to-date versions of all the required +</p><!--l. 14323--><p class="indent" > If you get any errors or unexpected results, check that you have up-to-date versions of all the required packages. (Search the log file for lines starting with “<span class="cmtt-10">Package:</span><span class="cmtt-10"> </span>”.) Where <span @@ -28585,33 +28467,31 @@ warnings about non-existent references that look something like: </p> - <div class="verbatim" id="verbatim-409"> + <div class="verbatim" id="verbatim-410"> pdfTeX warning (dest): name{glo:aca} has been  <br />referenced but does not exist, replaced by a fixed one </div> -<!--l. 14317--><p class="nopar" > These warnings may be ignored on the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run. (The destinations won’t be defined until the glossary +<!--l. 14330--><p class="nopar" > These warnings may be ignored on the first LaTeX run. (The destinations won’t be defined until the glossary has been created.) </p> -<!--l. 14321--><p class="noindent" ><a +<!--l. 14334--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.1 </span> <a id="sec:samplesbasic"></a>Basic</h3> <a id="x1-174001r1"></a> -<!--l. 14324--><p class="noindent" > +<!--l. 14337--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:minimalgls"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:minimalgls">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/minimalgls.tex" ><span class="cmtt-10">minimalgls.tex</span></a></h4> -<!--l. 14324--><p class="noindent" >This document is a minimal working example. You can test your installation using this file. To create the +<!--l. 14337--><p class="noindent" >This document is a minimal working example. You can test your installation using this file. To create the complete document you will need to do the following steps: </p><ol class="enumerate1" > <li class="enumerate" id="x1-175002x1">Run <span -class="cmtt-10">minimalgls.tex </span>through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> either by typing - <!--l. 14331--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +class="cmtt-10">minimalgls.tex </span>through LaTeX either by typing + <!--l. 14344--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex minimalgls <br /></pre><spacer type=vertical size=10> <br /></span> @@ -28626,12 +28506,12 @@ class="cmtt-10">makeglossaries</span><a href="#sec:makeglossaries">§1.4 </a><a href="#sec:makeglossaries">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a>). This can be done on a terminal by typing: - <!--l. 14340--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <!--l. 14353--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries minimalgls <br /></pre><spacer type=vertical size=10> <br /></span> otherwise do: - </p><!--l. 14344--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 14357--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries-lite minimalgls <br /></pre><spacer type=vertical size=10> <br /></span> @@ -28642,7 +28522,7 @@ class="cmtt-10">makeindex</span><a one line): - </p><!--l. 14349--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 14362--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s minimalgls.ist -t minimalgls.glg -o minimalgls.gls minimalgls.glo <br /></pre><spacer type=vertical size=10> <br /></span> @@ -28654,16 +28534,15 @@ class="cmtt-10">makeindex</span><a id="dx1-175007"></a></a> explicitly (Option 2)<!--tex4ht:ref: sec:makeindexapp --></a> for further details on using <span class="cmtt-10">makeindex</span><a id="dx1-175008"></a> explicitly. - </p><!--l. 14355--><p class="noindent" >Note that if the file name contains spaces, you will need to use the double-quote character to delimit the + </p><!--l. 14368--><p class="noindent" >Note that if the file name contains spaces, you will need to use the double-quote character to delimit the name. </p></li> <li class="enumerate" id="x1-175010x3">Run <span -class="cmtt-10">minimalgls.tex </span>through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> again (as step 1)</li></ol> -<!--l. 14360--><p class="noindent" >You should now have a complete document. The number following each entry in the glossary is the location +class="cmtt-10">minimalgls.tex </span>through LaTeX again (as step 1)</li></ol> +<!--l. 14373--><p class="noindent" >You should now have a complete document. The number following each entry in the glossary is the location number. By default, this is the page number where the entry was referenced. -</p><!--l. 14364--><p class="indent" > The <span +</p><!--l. 14377--><p class="indent" > The <span class="cmss-10">acronym</span><a id="dx1-175011"></a> package option creates a second glossary with the label <span class="cmtt-10">acronym </span>(which can be referenced with @@ -28687,7 +28566,7 @@ class="cmtt-10">makeindex</span><a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-175016"></a></a>) the appropriate number of times. -</p><!--l. 14374--><p class="indent" > If for some reason you don’t want to use <a +</p><!--l. 14387--><p class="indent" > If for some reason you don’t want to use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-175017"></a></a> or <a @@ -28697,14 +28576,14 @@ class="cmtt-10">makeglossaries-lite</span><a <span class="cmss-10">acronym</span><a id="dx1-175019"></a> package option then the complete build process is: -</p><!--l. 14377--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14390--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex minimalgls <br />makeindex -s minimalgls.ist -t minimalgls.glg -o minimalgls.gls minimalgls.glo <br />makeindex -s minimalgls.ist -t minimalgls.alg -o minimalgls.acr minimalgls.acn <br />pdflatex minimalgls <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 14384--><p class="indent" > There are three other files that can be used as <a +</p><!--l. 14397--><p class="indent" > There are three other files that can be used as <a href="http://www.dickimaw-books.com/latex/minexample/" >minimal working examples</a>: <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/mwe-gls.tex" ><span class="cmtt-10">mwe-gls.tex</span></a>, <a @@ -28713,7 +28592,7 @@ class="cmtt-10">mwe-acr.tex</span></a> and <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/mwe-acr-desc.tex" ><span class="cmtt-10">mwe-acr-desc.tex</span></a>. -</p><!--l. 14389--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 14402--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to try out the <a href="#glo:glossaries-extra"><span @@ -28751,7 +28630,7 @@ href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> load <span class="cmss-10">glossaries</span>). -<!--l. 14406--><p class="indent" > Next, replace: </p><div class="alltt"> +<!--l. 14419--><p class="indent" > Next, replace: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\setacronymstyle{long-short}</span> @@ -28778,7 +28657,7 @@ class="cmtt-10">\newabbreviation</span></span><a the category set to <span id="textcolor293"><span class="cmss-10">acronym</span></span><a id="dx1-175024"></a>. -<!--l. 14420--><p class="indent" > If you prefer to replace <span +<!--l. 14433--><p class="indent" > If you prefer to replace <span class="cmtt-10">\newacronym </span>with <span id="textcolor294"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-175025"></a> then the default category is <span id="textcolor295"><span @@ -28814,7 +28693,7 @@ class="cmss-10">short-nolong</span></span><a id="dx1-175032"></a>, which only shows the short form on <a href="#glo:firstuse">first use</a>.) -<!--l. 14437--><p class="indent" > As mentioned earlier, the <span +<!--l. 14450--><p class="indent" > As mentioned earlier, the <span class="cmss-10">acronym</span><a id="dx1-175033"></a> package option creates a new glossary with the label <span class="cmtt-10">acronym</span>. This is @@ -28827,7 +28706,7 @@ class="cmtt-10">\newacronym </span>or <span id="textcolor303"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-175036"></a>. -</p><!--l. 14442--><p class="indent" > You may instead prefer to use the <span id="textcolor304"><span +</p><!--l. 14455--><p class="indent" > You may instead prefer to use the <span id="textcolor304"><span class="cmss-10">abbreviations</span></span><a id="dx1-175037"></a> package option, which creates a new glossary with the label <span @@ -28867,7 +28746,7 @@ class="cmtt-10">xindy</span><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details. -<!--l. 14455--><p class="indent" > If you use both the <span +<!--l. 14468--><p class="indent" > If you use both the <span class="cmss-10">acronym</span><a id="dx1-175043"></a> and <span id="textcolor309"><span class="cmss-10">abbreviations</span></span><a @@ -28878,7 +28757,7 @@ glossary and <span id="textcolor310"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-175045"></a> will default to the <span class="cmtt-10">abbreviations </span>glossary. -</p><!--l. 14460--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 14473--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-175046"></a></a></span>If you want to try <a @@ -28912,7 +28791,7 @@ done with <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a id="dx1-175051"></a></a>. For example: -<!--l. 14470--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 14483--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only minimalgls.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -28940,7 +28819,7 @@ class="cmtt-10">\newglossaryentry </span>and <span class="cmtt-10">\newacronym </span>or <span class="cmtt-10">\newabbreviation</span>). -<!--l. 14485--><p class="indent" > The abbreviation style command must go before <span id="textcolor317"><span +<!--l. 14498--><p class="indent" > The abbreviation style command must go before <span id="textcolor317"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a id="dx1-175054"></a>. For example (if you are using <span @@ -28961,17 +28840,17 @@ class="cmtt-10">=entries]</span> </div> Finally, replace: - <div class="verbatim" id="verbatim-410"> + <div class="verbatim" id="verbatim-411"> \printglossaries </div> -<!--l. 14495--><p class="nopar" > with: </p><div class="alltt"> +<!--l. 14508--><p class="nopar" > with: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor321"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-175058"></a> </div> </div> The document build is now: -<!--l. 14501--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 14514--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex minimalgls <br />bib2gls minimalgls <br />pdflatex minimalgls @@ -28979,13 +28858,13 @@ class="cmtt-10">\printunsrtglossaries</span></span><a <br /></span> <a id="x1-175059r2"></a> -</p><!--l. 14507--><p class="noindent" > +</p><!--l. 14520--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleDB"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleDB">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleDB.tex" ><span class="cmtt-10">sampleDB.tex</span></a></h4> -<!--l. 14507--><p class="noindent" >This document illustrates how to load external files containing the glossary definitions. It also illustrates how to +<!--l. 14520--><p class="noindent" >This document illustrates how to load external files containing the glossary definitions. It also illustrates how to define a new glossary type. This document has the <a href="#glo:numberlist">number list<a id="dx1-176001"></a></a> suppressed and uses <a @@ -29000,14 +28879,14 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-176003"></a></a> if you have a large number of entries.) To create the document do: -</p><!--l. 14515--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14528--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleDB <br />makeglossaries sampleDB <br />pdflatex sampleDB <br /></pre><spacer type=vertical size=10> <br /></span> or -</p><!--l. 14521--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14534--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleDB <br />makeglossaries-lite sampleDB <br />pdflatex sampleDB @@ -29028,14 +28907,14 @@ glossary: </p><ol class="enumerate1" > <li class="enumerate" id="x1-176006x1">Create the main glossary (all on one line): - <!--l. 14532--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <!--l. 14545--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s sampleDB.ist -t sampleDB.glg -o sampleDB.gls sampleDB.glo <br /></pre><spacer type=vertical size=10> <br /></span> </p></li> <li class="enumerate" id="x1-176008x2">Create the secondary glossary (all on one line): - <!--l. 14536--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <!--l. 14549--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s sampleDB.ist -t sampleDB.nlg -o sampleDB.not sampleDB.ntn <br /></pre><spacer type=vertical size=10> <br /></span> @@ -29051,7 +28930,7 @@ class="cmtt-10">makeglossaries-lite</span><a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-176011"></a></a> the appropriate number of times.</p></li></ol> -<!--l. 14545--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 14558--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-176012"></a></a></span>If you want to switch to using <a @@ -29070,7 +28949,7 @@ class="cmtt-10">bib</span><a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a id="dx1-176015"></a></a>: -</p><!--l. 14549--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14562--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib database1.tex database1.bib <br />convertgls2bib database2.tex database2.bib <br /></pre><spacer type=vertical size=10> @@ -29158,14 +29037,14 @@ href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-176026"></a></a> extensions are now irrelevant. -<!--l. 14577--><p class="indent" > Instead of using <a +<!--l. 14590--><p class="indent" > Instead of using <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-176027"></a></a> you need to use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-176028"></a></a> when you build the document: -</p><!--l. 14579--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14592--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleDB <br />bib2gls sampleDB <br />pdflatex sampleDB @@ -29189,15 +29068,15 @@ Multiple glossaries may be processed in a single resource set or sub-blocks of a by multiple resource sets. In this example, there happens to be one resource set per glossary because each glossary requires a different sort method. (A locale-sensitive alphabetical sort for the first and a character code sort for the second.) -</p><!--l. 14595--><p class="indent" > If you want letter groups, you need to use the <span id="textcolor334"><span +</p><!--l. 14608--><p class="indent" > If you want letter groups, you need to use the <span id="textcolor334"><span class="cmtt-10">--group</span></span><a id="dx1-176033"></a> switch: -</p><!--l. 14597--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14610--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />bib2gls --group sampleDB <br /></pre><spacer type=vertical size=10> <br /></span> and use an appropriate glossary style. -</p><!--l. 14602--><p class="indent" > See also <a +</p><!--l. 14615--><p class="indent" > See also <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a>, <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf" ><span @@ -29207,23 +29086,22 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-176034"></a></a> user manual. -</p><!--l. 14604--><p class="noindent" > +</p><!--l. 14617--><p class="noindent" > </p> -<!--l. 14604--><p class="noindent" ><a +<!--l. 14617--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.2 </span> <a id="sec:sampleacronyms"></a>Acronyms and First Use</h3> <a id="x1-177001r3"></a> -<!--l. 14607--><p class="noindent" > +<!--l. 14620--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleAcr"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleAcr">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleAcr.tex" ><span class="cmtt-10">sampleAcr.tex</span></a></h4> -<!--l. 14607--><p class="noindent" >This document has some sample abbreviations. It also adds the glossary to the table of contents, so an extra run -through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is required to ensure the document is up to date: -</p><!--l. 14611--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 14620--><p class="noindent" >This document has some sample abbreviations. It also adds the glossary to the table of contents, so an extra run +through LaTeX is required to ensure the document is up to date: +</p><!--l. 14624--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleAcr <br />makeglossaries sampleAcr <br />pdflatex sampleAcr @@ -29236,17 +29114,16 @@ class="E">E</span>X</span></span> is required to ensure the document is u href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-178001"></a></a>). -</p><!--l. 14619--><p class="indent" > Note that if the glossary is at the start of the document and spans across multiple pages, then this can cause +</p><!--l. 14632--><p class="indent" > Note that if the glossary is at the start of the document and spans across multiple pages, then this can cause the locations to be shifted. In that case, an extra <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-178002"></a></a> and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call are required. In + id="dx1-178002"></a></a> and LaTeX call are required. In this particular example, the glossary is at the end of the document so it’s not a problem. It’s also not a problem for a glossary at the start of the document if the page numbering is reset at the end of the glossary. For example, if the glossary is at the end of the front matter in a book-style document. -</p><!--l. 14628--><p class="indent" > This document uses <span +</p><!--l. 14641--><p class="indent" > This document uses <span class="cmtt-10">\ifglsused</span><a id="dx1-178003"></a> to determine whether to use “a” or “an” in: </p><div class="alltt"> <div class="obeylines-v"> @@ -29268,10 +29145,10 @@ class="cmss-10">glossaries </span>and passes all its options to the base package of: - <div class="verbatim" id="verbatim-411"> + <div class="verbatim" id="verbatim-412"> \usepackage[style=long,toc]{glossaries} </div> -<!--l. 14639--><p class="nopar" > with: </p><div class="alltt"> +<!--l. 14652--><p class="nopar" > with: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[style=long,toc]{</span><strong><span @@ -29310,7 +29187,7 @@ class="cmtt-10"> </span><span class="cmtt-10">…</span> </div> </div> -<!--l. 14656--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 14669--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to convert this sample document to use <a href="#glo:glossaries-extra"><span @@ -29350,7 +29227,7 @@ class="cmss-10">glossary-longextra</span></span><a which you may prefer.) -<!--l. 14673--><p class="indent" > If you want to use <span +<!--l. 14686--><p class="indent" > If you want to use <span class="cmss-10">glossaries-prefix</span><a id="dx1-178013"></a>, you can either load it after <a href="#glo:glossaries-extra"><span @@ -29360,38 +29237,34 @@ class="cmss-10">glossaries-extra</span></a> v1.42) you can simply use the <span id="textcolor339"><span class="cmss-10">prefix</span></span><a id="dx1-178014"></a> package option. -</p><!--l. 14678--><p class="indent" > Note that the <span +</p><!--l. 14691--><p class="indent" > Note that the <span class="cmss-10">toc</span><a id="dx1-178015"></a> package option has been dropped. This is the default with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, so it doesn’t need to be specified now. The document build is now shorter: -</p><!--l. 14681--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14694--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleAcr <br />makeglossaries sampleAcr <br />pdflatex sampleAcr <br /></pre><spacer type=vertical size=10> <br /></span> -The third <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call is no longer required to make the table of contents up-to-date. This is because +The third LaTeX call is no longer required to make the table of contents up-to-date. This is because <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> provides boilerplate text on the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call when the glossary files are missing. This means +class="cmss-10">glossaries-extra</span></a> provides boilerplate text on the first LaTeX call when the glossary files are missing. This means that the glossary header is added to the <span class="cmtt-10">toc</span><a - id="dx1-178016"></a> file on the first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call, whereas with just the base <span + id="dx1-178016"></a> file on the first LaTeX call, whereas with just the base <span class="cmss-10">glossaries</span> -package, the header isn’t present until the second <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call. (As with just the base <span +package, the header isn’t present until the second LaTeX call. (As with just the base <span class="cmss-10">glossaries </span>package, if the glossary occurs at the start of the document without a page reset after it then part of the build process needs repeating to ensure all referenced page numbers are up-to-date. This problem isn’t specific to the <span class="cmss-10">glossaries</span><a id="dx1-178017"></a> package.) -</p><!--l. 14698--><p class="indent" > The other different default setting is the post-description punctuation. The base package has <span +</p><!--l. 14711--><p class="indent" > The other different default setting is the post-description punctuation. The base package has <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a @@ -29409,7 +29282,7 @@ class="cmss-10">false</span><a id="dx1-178020"></a> or the shorter synonym <span id="textcolor340"><span class="cmss-10">postdot</span></span><a id="dx1-178021"></a>. -</p><!--l. 14706--><p class="indent" > The <a +</p><!--l. 14719--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package has different abbreviation handling that’s far more flexible than that provided by the base <span @@ -29463,7 +29336,7 @@ applied. If it’s omitted, <span id="textcolor349"><span class="cmss-10">abbreviation</span></span><a id="dx1-178034"></a> is assumed. You can therefore have different styles for different categories.) -<!--l. 14727--><p class="indent" > Finally, you need to replace <span +<!--l. 14740--><p class="indent" > Finally, you need to replace <span class="cmtt-10">\acrshort</span><a id="dx1-178035"></a>, <span class="cmtt-10">\acrlong</span><a @@ -29481,17 +29354,16 @@ class="cmtt-10">\glsxtrfull</span></span><a id="x1-178041r4"></a> -</p><!--l. 14731--><p class="noindent" > +</p><!--l. 14744--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleAcrDesc"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleAcrDesc">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleAcrDesc.tex" ><span class="cmtt-10">sampleAcrDesc.tex</span></a></h4> -<!--l. 14731--><p class="noindent" >This is similar to the previous example, except that the abbreviations have an associated description. As with -the previous example, the glossary is added to the table of contents, so an extra run through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is +<!--l. 14744--><p class="noindent" >This is similar to the previous example, except that the abbreviations have an associated description. As with +the previous example, the glossary is added to the table of contents, so an extra run through LaTeX is required: -</p><!--l. 14735--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14748--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleAcrDesc <br />makeglossaries sampleAcrDesc <br />pdflatex sampleAcrDesc @@ -29514,7 +29386,7 @@ class="cmss-10">nomain</span><a id="dx1-179003"></a> option as the <span class="cmtt-10">main </span>glossary will now be required. -</p><!--l. 14751--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 14764--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>As with the previous example, if you want to convert this document to use <a href="#glo:glossaries-extra"><span @@ -29558,7 +29430,7 @@ href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-179011"></a></a> you don’t need to worry about it. -<!--l. 14769--><p class="indent" > Again the style command needs to be changed: </p><div class="alltt"> +<!--l. 14782--><p class="indent" > Again the style command needs to be changed: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor356"><span class="cmtt-10">\setabbreviationstyle</span></span><a @@ -29573,7 +29445,7 @@ class="cmss-10">long-sc-short-desc</span><a <span id="textcolor358"><span class="cmss-10">acronym</span></span><a id="dx1-179015"></a>.) -<!--l. 14776--><p class="indent" > As with the previous example, if you prefer to use <span id="textcolor359"><span +<!--l. 14789--><p class="indent" > As with the previous example, if you prefer to use <span id="textcolor359"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-179016"></a> instead of <span class="cmtt-10">\newacronym</span><a @@ -29645,7 +29517,7 @@ class="cmtt-10">\glsfmtname</span></span><a class="cmtt-10">{#1}}</span> </div> </div> -<!--l. 14806--><p class="indent" > The <a +<!--l. 14819--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides two additional cross-referencing keys <span id="textcolor364"><span id="textcolor365"><span class="cmtt-10">seealso</span></span><a @@ -29682,7 +29554,7 @@ class="cmtt-10"> vector</span><span class="cmtt-10"> machine}</span> </div> </div> -<!--l. 14817--><p class="indent" > Finally, as with the previous example, you need to replace <span +<!--l. 14830--><p class="indent" > Finally, as with the previous example, you need to replace <span class="cmtt-10">\acrshort</span><a id="dx1-179036"></a>, <span class="cmtt-10">\acrlong</span><a @@ -29696,7 +29568,7 @@ class="cmtt-10">\glsxtrlong</span></span><a id="dx1-179040"></a> and <span id="textcolor372"><span class="cmtt-10">\glsxtrfull</span></span><a id="dx1-179041"></a> etc. -</p><!--l. 14821--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 14834--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-179042"></a></a></span>If you want to convert this document so that it uses <a @@ -29731,7 +29603,7 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-179046"></a></a>. This can be done with: -<!--l. 14831--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 14844--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only sampleAcrDesc.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -29788,7 +29660,7 @@ class="cmtt-10">\newabbreviation</span></span><a id="dx1-179050"></a> then the entries will instead be defined with <span id="textcolor381"><span class="cmtt-10">@abbreviation</span></span><a id="dx1-179051"></a>. -<!--l. 14849--><p class="indent" > Next replace <span +<!--l. 14862--><p class="indent" > Next replace <span class="cmtt-10">\makeglossaries </span>with the resource command, but note that the abbreviation style must be set first: </p><div class="alltt"> <div class="obeylines-v"> @@ -29846,7 +29718,7 @@ class="cmss-10">acronym</span></span><a class="cmtt-10">\setabbreviationstyle</span></span><a id="dx1-179063"></a> needs adjusting. -<!--l. 14866--><p class="indent" > If the <span +<!--l. 14879--><p class="indent" > If the <span class="cmtt-10">sort</span><a id="dx1-179064"></a> field is missing (which should usually be the case), then both <span id="textcolor395"><span class="cmtt-10">@acronym</span></span><a @@ -29869,7 +29741,7 @@ changed. (Remember that you will break this fallback mechanism if you explicitly href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-179070"></a></a> manual for further details and other examples. -</p><!--l. 14876--><p class="indent" > Remember to delete any <span +</p><!--l. 14889--><p class="indent" > Remember to delete any <span class="cmtt-10">\newacronym </span>or <span class="cmtt-10">\newabbreviation </span>in the <span class="cmtt-10">tex</span><a @@ -29878,13 +29750,13 @@ class="cmtt-10">\printglossary</span> with <span id="textcolor397"><span class="cmtt-10">\printunsrtglossary</span></span><a id="dx1-179072"></a>. The document build is now: -</p><!--l. 14880--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14893--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleAcrDesc <br />bib2gls sampleAcrDesc <br />pdflatex sampleAcrDesc <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 14886--><p class="indent" > Note that it’s now much easier to revert back to the descriptionless style used in <a +</p><!--l. 14899--><p class="indent" > Note that it’s now much easier to revert back to the descriptionless style used in <a href="#ex:sampleAcr"><span class="cmtt-10">sampleAcr.tex</span></a>: </p><div class="alltt"> @@ -29922,21 +29794,20 @@ This makes it much easier to have a large database of abbreviations for use acro or may not require the description. <a id="x1-179080r5"></a> -<!--l. 14899--><p class="noindent" > +<!--l. 14912--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleDesc"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleDesc">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleDesc.tex" ><span class="cmtt-10">sampleDesc.tex</span></a></h4> -<!--l. 14899--><p class="noindent" >This is similar to the previous example, except that it defines the abbreviations using <span +<!--l. 14912--><p class="noindent" >This is similar to the previous example, except that it defines the abbreviations using <span class="cmtt-10">\newglossaryentry</span><a id="dx1-180001"></a> instead of <span class="cmtt-10">\newacronym</span><a id="dx1-180002"></a>. As with the previous example, the glossary is added to the table of contents, so an -extra run through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is required: -</p><!--l. 14904--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +extra run through LaTeX is required: +</p><!--l. 14917--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleDesc <br />makeglossaries sampleDesc <br />pdflatex sampleDesc @@ -29966,19 +29837,18 @@ Guide</a>. id="x1-180007r6"></a> -</p><!--l. 14918--><p class="noindent" > +</p><!--l. 14931--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleFnAcrDesc"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleFnAcrDesc">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleFnAcrDesc.tex" ><span class="cmtt-10">sampleFnAcrDesc.tex</span></a></h4> -<!--l. 14918--><p class="noindent" >This document has some sample abbreviations that use the <span +<!--l. 14931--><p class="noindent" >This document has some sample abbreviations that use the <span class="cmss-10">footnote-sc-desc</span><a id="dx1-181001"></a> acronym style. As with the -previous example, the glossary is added to the table of contents, so an extra run through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is +previous example, the glossary is added to the table of contents, so an extra run through LaTeX is required: -</p><!--l. 14922--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14935--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleFnAcrDesc <br />makeglossaries sampleFnAcrDesc <br />pdflatex sampleFnAcrDesc @@ -30005,7 +29875,7 @@ class="cmtt-10">[acronym]{short-sc-footnote-desc}</span> </div> The command redefinitions (performed with <span class="cmtt-10">\renewcommand</span>) should now all be deleted as they are no longer applicable. -<!--l. 14939--><p class="indent" > You may prefer to use the <span id="textcolor405"><span +<!--l. 14952--><p class="indent" > You may prefer to use the <span id="textcolor405"><span class="cmss-10">short-sc-postfootnote-desc</span></span><a id="dx1-181004"></a> style instead. There are subtle differences between the <span id="textcolor406"><span @@ -30016,8 +29886,8 @@ class="cmss-10">footnote</span></span><a class="cmss-10">short-sc-footnote</span></span><a id="dx1-181007"></a> and compare the location of the footnote marker with the two styles. -</p><!--l. 14945--><p class="indent" > This modified sample file now has a shorter build: -</p><!--l. 14946--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14958--><p class="indent" > This modified sample file now has a shorter build: +</p><!--l. 14959--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleFnAcrDesc <br />makeglossaries sampleFnAcrDesc <br />pdflatex sampleFnAcrDesc @@ -30026,22 +29896,20 @@ location of the footnote marker with the two styles. This is because the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package produces boilerplate text when the glossary file is missing (on the -first <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run) which adds the glossary title to the table of contents (<span +first LaTeX run) which adds the glossary title to the table of contents (<span class="cmtt-10">toc</span><a id="dx1-181008"></a>) file. <a id="x1-181009r7"></a> -</p><!--l. 14956--><p class="noindent" > +</p><!--l. 14969--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleCustomAcr"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleCustomAcr">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleCustomAcr.tex" ><span class="cmtt-10">sampleCustomAcr.tex</span></a></h4> -<!--l. 14956--><p class="noindent" >This document has some sample abbreviations with a custom acronym style. It also adds the glossary to the -table of contents, so an extra run through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is required: -</p><!--l. 14959--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 14969--><p class="noindent" >This document has some sample abbreviations with a custom acronym style. It also adds the glossary to the +table of contents, so an extra run through LaTeX is required: +</p><!--l. 14972--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleCustomAcr <br />makeglossaries sampleCustomAcr @@ -30065,7 +29933,7 @@ class="cmti-10">description</span>⟩ (instead of just the long form). This inherits from the <span class="cmss-10">footnote-sc-desc</span><a id="dx1-182002"></a> style. -</p><!--l. 14973--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 14986--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>The conversion to <a href="#glo:glossaries-extra"><span @@ -30086,7 +29954,7 @@ class="cmtt-10">}</span> </div> </div> The abbreviation styles have associated helper commands that may be redefined to make minor modifications. These redefinitions should be done before the abbreviations are defined. -<!--l. 14984--><p class="indent" > The <span id="textcolor411"><span +<!--l. 14997--><p class="indent" > The <span id="textcolor411"><span class="cmss-10">short-sc-footnote-desc</span></span><a id="dx1-182003"></a> abbreviation style is the closest match to the requirement, so replace the <span @@ -30100,7 +29968,7 @@ class="cmtt-10">[acronym]{short-sc-footnote-desc}</span> </div> Again, you may prefer <span id="textcolor413"><span class="cmss-10">short-sc-postfootnote-desc</span></span><a id="dx1-182005"></a>. Both styles use the same helper commands. -<!--l. 14993--><p class="indent" > Next some adjustments need to be made to fit the new requirements. The name needs to be ⟨<span +<!--l. 15006--><p class="indent" > Next some adjustments need to be made to fit the new requirements. The name needs to be ⟨<span class="cmti-10">long</span>⟩ (⟨<span class="cmti-10">short</span>⟩): </p><div class="alltt"> @@ -30190,7 +30058,7 @@ class="cmtt-10"> \glsentrydesc</span><a class="cmtt-10">{#1}}}</span> </div> </div> This will mimic the result from the original sample document. -<!--l. 15024--><p class="indent" > You may prefer to replace <span class="obeylines-h"><span class="verb"><span +<!--l. 15037--><p class="indent" > You may prefer to replace <span class="obeylines-h"><span class="verb"><span class="cmtt-10">#2</span></span></span> with a reference to a specific field (or fields). For example: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -30220,18 +30088,18 @@ class="cmtt-10">\glsseeitemformat</span><a id="dx1-182025"></a> since <span class="cmtt-10">\acronymfont </span>is no longer appropriate. -<!--l. 15033--><p class="indent" > In the original <span +<!--l. 15046--><p class="indent" > In the original <span class="cmtt-10">sampleCustomAcr.tex </span>source code, I started the description with a capital: </p> - <div class="verbatim" id="verbatim-412"> + <div class="verbatim" id="verbatim-413"> \newacronym[description={Statistical pattern recognition  <br />technique using the ``kernel trick''},  <br />see={[see also]{svm}},  <br />]{ksvm}{ksvm}{kernel support vector machine} </div> -<!--l. 15040--><p class="nopar" > This leads to a capital letter after the colon in the footnote, which is undesirable, but I would like to +<!--l. 15053--><p class="nopar" > This leads to a capital letter after the colon in the footnote, which is undesirable, but I would like to have the description start with a capital in the glossary. The solution to this problem is easy with <a href="#glo:glossaries-extra"><span @@ -30278,7 +30146,7 @@ class="cmtt-10">seealso</span></span><a id="dx1-182030"></a></span> key, which is only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. -<!--l. 15060--><p class="indent" > If you prefer to use <span id="textcolor431"><span +<!--l. 15073--><p class="indent" > If you prefer to use <span id="textcolor431"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-182031"></a> instead of <span class="cmtt-10">\newacronym</span><a @@ -30309,15 +30177,15 @@ class="cmtt-10">{short-sc-postfootnote-desc}</span> id="x1-182037r8"></a> -<!--l. 15072--><p class="noindent" > +<!--l. 15085--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-FnDesc"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-FnDesc">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-FnDesc.tex" ><span class="cmtt-10">sample-FnDesc.tex</span></a></h4> -<!--l. 15072--><p class="noindent" >This example defines a custom display format that puts the description in a footnote on <a +<!--l. 15085--><p class="noindent" >This example defines a custom display format that puts the description in a footnote on <a href="#glo:firstuse">first use</a>. -</p><!--l. 15075--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15088--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-FnDesc <br />makeglossaries sample-FnDesc <br />pdflatex sample-FnDesc @@ -30332,7 +30200,7 @@ footnote marker hyperlink would be inside the hyperlink around the <a href="#glo:linktext">link text<a id="dx1-183002"></a></a> which would result in a nested hyperlink). -</p><!--l. 15085--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15098--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>The <a href="#glo:glossaries-extra"><span @@ -30359,15 +30227,15 @@ class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 15096--><p class="indent" > <div class="important" title="Important Note"> Never use commands like <span +<!--l. 15109--><p class="indent" > <div class="important" title="Important Note"> Never use commands like <span class="cmtt-10">\gls </span>or <span class="cmtt-10">\glsdesc </span>in the post-link hook as you can end up with infinite recursion. Use commands that don’t themselves have a post-link hook, such as <span class="cmtt-10">\glsentrydesc </span>or <span class="cmtt-10">\glossentrydesc</span>, instead. </div> -</p><!--l. 15101--><p class="noindent" > -</p><!--l. 15103--><p class="indent" > In the original <span +</p><!--l. 15114--><p class="noindent" > +</p><!--l. 15116--><p class="indent" > In the original <span class="cmtt-10">sample-FnDesc.tex </span>file, the format was adjusted with: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -30424,21 +30292,21 @@ class="cmss-10">general</span></span><a class="cmtt-10">\newglossaryentry</span><a id="dx1-183019"></a>). If I added some abbreviations (which have a different category) then this change wouldn’t apply to them. -<!--l. 15122--><p class="indent" > The first paragraph in the document is: +<!--l. 15135--><p class="indent" > The first paragraph in the document is: </p> - <div class="verbatim" id="verbatim-413"> + <div class="verbatim" id="verbatim-414"> First use: \gls{sample}. </div> -<!--l. 15125--><p class="nopar" > So the PDF will have the word “sample” (the <a +<!--l. 15138--><p class="nopar" > So the PDF will have the word “sample” (the <a href="#glo:linktext">link text<a id="dx1-183020"></a></a> created by <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{sample}</span></span></span>) as a hyperlink to the entry in the glossary followed by the footnote marker, which is a hyperlink to the footnote. This is then followed by the sentence terminator. “First use: sample<sup class="textsuperscript"><span class="cmr-9">1</span></sup>.” -</p><!--l. 15132--><p class="indent" > It would look tidier if the footnote marker could be shifted after the full stop. “First use: sample.<sup class="textsuperscript"><span +</p><!--l. 15145--><p class="indent" > It would look tidier if the footnote marker could be shifted after the full stop. “First use: sample.<sup class="textsuperscript"><span class="cmr-9">1</span></sup>” This can easily be achieved with a minor modification: </p><div class="alltt"> <div class="obeylines-v"> @@ -30529,17 +30397,17 @@ class="cmtt-10">\Glsentrydesc</span><a id="dx1-183040"></a> and explicitly append the full stop. <a id="x1-183041r9"></a> -<!--l. 15161--><p class="noindent" > +<!--l. 15174--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-custom-acronym"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-custom-acronym">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-custom-acronym.tex" ><span class="cmtt-10">sample-custom-acronym.tex</span></a></h4> -<!--l. 15162--><p class="noindent" >This document illustrates how to define your own acronym style if the predefined styles don’t suit your +<!--l. 15175--><p class="noindent" >This document illustrates how to define your own acronym style if the predefined styles don’t suit your requirements. -</p><!--l. 15164--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15177--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-custom-acronym <br />makeglossaries sample-custom-acronym <br />pdflatex sample-custom-acronym @@ -30558,7 +30426,7 @@ class="cmtt-10">name</span><a id="dx1-184003"></a> is set to the long form (starting with an initial capital) followed by the all caps short form in parentheses. The final requirement is that the inline form should show the long form followed by the short form in parentheses. -</p><!--l. 15180--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15193--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>As with <a href="#ex:sampleFnAcrDesc"><span @@ -30840,7 +30708,7 @@ class="cmtt-10">}</span> </div> (See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details.) -<!--l. 15222--><p class="indent" > This new custom style now needs to be set: </p><div class="alltt"> +<!--l. 15235--><p class="indent" > This new custom style now needs to be set: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor493"><span class="cmtt-10">\setabbreviationstyle</span></span><a @@ -30901,7 +30769,7 @@ class="cmtt-10"> \glsentrydesc</span><a class="cmtt-10">{#1}.}}</span> </div> </div> -<!--l. 15248--><p class="indent" > The <span +<!--l. 15261--><p class="indent" > The <span class="cmtt-10">name</span><a id="dx1-184060"></a> now needs to be the long form followed by the short form in parentheses, but note the new requirement that the short form should now be in all capitals not <a @@ -30955,7 +30823,7 @@ class="cmtt-10">\glslongtok</span><a class="cmtt-10">}</span> </div> </div> -<!--l. 15265--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you want to switch to using <a +<!--l. 15278--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you want to switch to using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-184071"></a></a>, remember to set the abbreviation style before the @@ -30965,17 +30833,17 @@ class="cmtt-10">long</span><a href="#ex:sampleAcrDesc"><span class="cmtt-10">sampleAcrDesc.tex</span></a>. </div> -</p><!--l. 15270--><p class="noindent" > +</p><!--l. 15283--><p class="noindent" > <a id="x1-184073r10"></a> -</p><!--l. 15272--><p class="noindent" > +</p><!--l. 15285--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-dot-abbr"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-dot-abbr">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-dot-abbr.tex" ><span class="cmtt-10">sample-dot-abbr.tex</span></a></h4> -<!--l. 15272--><p class="noindent" >This document illustrates how to use the base post link hook to adjust the space factor after abbreviations. -</p><!--l. 15274--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 15285--><p class="noindent" >This document illustrates how to use the base post link hook to adjust the space factor after abbreviations. +</p><!--l. 15287--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-dot-abbr <br />makeglossaries sampledot-abbrf <br />pdflatex sample-dot-abbr @@ -30987,7 +30855,7 @@ class="cmss-10">glossaries-extra</span>’s</a> <span id="textcolor504"><spa class="cmtt-10">category</span></span><a id="dx1-185001"></a></span> key. -</p><!--l. 15282--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15295--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>This example is much simpler with <a href="#glo:glossaries-extra"><span @@ -31000,7 +30868,7 @@ class="cmtt-10">\glsaddstoragekey</span><a class="cmtt-10">{abbrtype}{word}{\abbrtype}</span> </div> </div> can now be removed. -<!--l. 15290--><p class="indent" > The <span id="textcolor506"><span id="textcolor507"><span +<!--l. 15303--><p class="indent" > The <span id="textcolor506"><span id="textcolor507"><span class="cmtt-10">category</span></span><a id="dx1-185003"></a></span> key is set to <span class="cmtt-10">initials </span>for the initialisms (which are defined with the custom <span @@ -31034,7 +30902,7 @@ class="cmss-10">noshortplural</span></span><a class="cmss-10">pluraldiscardperiod</span></span><a id="dx1-185009"></a> attribute.) -<!--l. 15305--><p class="indent" > The <a +<!--l. 15318--><p class="indent" > The <a href="#glo:firstuse">first use</a> is governed by the <span id="textcolor514"><span class="cmss-10">retainfirstuseperiod</span></span><a id="dx1-185010"></a> attribute. If set, the period won’t be discarded if it @@ -31054,7 +30922,7 @@ class="cmtt-10">\glssetcategoryattribute</span></span><a class="cmtt-10">{initials}{retainfirstuseperiod}{true}</span> </div> </div> -<!--l. 15316--><p class="indent" > The <span id="textcolor517"><span +<!--l. 15329--><p class="indent" > The <span id="textcolor517"><span class="cmss-10">insertdots</span></span><a id="dx1-185013"></a> attribute can automatically insert dots into the short form with a final space factor adjustment: </p><div class="alltt"> @@ -31065,7 +30933,7 @@ class="cmtt-10">\glssetcategoryattribute</span></span><a class="cmtt-10">{initials}{insertdots}{true}</span> </div> </div> -<!--l. 15322--><p class="indent" > The custom helper command defined in the example needs to be slightly modified: </p><div class="alltt"> +<!--l. 15335--><p class="indent" > The custom helper command defined in the example needs to be slightly modified: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newcommand*{\newabbr}[1][]{%</span> @@ -31109,33 +30977,33 @@ class="cmtt-10">}{AGM}</span> </div> (This makes it much easier to change your mind if you decide at a later date to omit the dots, especially if you are storing all your definitions in a file that’s shared across multiple documents, but note the need to group “Sc”.) -<!--l. 15342--><p class="indent" > The “laser” definition remains unchanged: +<!--l. 15355--><p class="indent" > The “laser” definition remains unchanged: </p> - <div class="verbatim" id="verbatim-414"> + <div class="verbatim" id="verbatim-415"> \newacronym{laser}{laser}{light amplification by stimulated  <br />emission of radiation} </div> -<!--l. 15346--><p class="nopar" > The remaining code in the preamble must now be removed. (It will interfere with <a +<!--l. 15359--><p class="nopar" > The remaining code in the preamble must now be removed. (It will interfere with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span>’s</a> category post-link hooks.) No change is required in the document body. -</p><!--l. 15351--><p class="indent" > See the <a +</p><!--l. 15364--><p class="indent" > See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details about category attributes and post-link hooks. <a id="x1-185017r11"></a> -</p><!--l. 15354--><p class="noindent" > +</p><!--l. 15367--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-font-abbr"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-font-abbr">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-font-abbr.tex" ><span class="cmtt-10">sample-font-abbr.tex</span></a></h4> -<!--l. 15354--><p class="noindent" >This document illustrates how to have different fonts for abbreviations within the style. The document build +<!--l. 15367--><p class="noindent" >This document illustrates how to have different fonts for abbreviations within the style. The document build is: -</p><!--l. 15356--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15369--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-font-abbr <br />makeglossaries sample-font-abbr <br />pdflatex sample-font-abbr @@ -31151,29 +31019,29 @@ class="cmtt-10">\em</span>). </p> - <div class="verbatim" id="verbatim-415"> + <div class="verbatim" id="verbatim-416"> \glsaddstoragekey{font}{}{\entryfont} </div> -<!--l. 15368--><p class="nopar" > A new custom acronym style is defined that fetches the font information from this new key so that it can be +<!--l. 15381--><p class="nopar" > A new custom acronym style is defined that fetches the font information from this new key so that it can be applied to the abbreviation. Some helper commands are also provided to define the different types of abbreviation: </p> - <div class="verbatim" id="verbatim-416"> + <div class="verbatim" id="verbatim-417"> \newcommand*{\newitabbr}[1][]{\newacronym[font=\em,#1]}  <br />\newcommand*{\newupabbr}{\newacronym}  <br />\newitabbr{eg}{e.g.}{exempli gratia}  <br />\newupabbr{bsc}{BSc}{Bachelor of Science} </div> -<!--l. 15379--><p class="nopar" > This makes the <a +<!--l. 15392--><p class="nopar" > This makes the <a href="#glo:firstuse">first use</a> of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{eg}</span></span></span> appear as “exempli gratia (<span class="cmti-10">e.g.</span>)” whereas the <a href="#glo:firstuse">first use</a> of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{bsc}</span></span></span> is “Bachelor of Science (BSc)”. -</p><!--l. 15384--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15397--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>This example document is much simpler with <a href="#glo:glossaries-extra"><span @@ -31239,7 +31107,7 @@ class="cmss-10">acronym</span></span><a class="cmtt-10">\setabbreviationstyle</span></span><a id="dx1-186013"></a> command). -<!--l. 15412--><p class="indent" > Finally, the <span +<!--l. 15425--><p class="indent" > Finally, the <span class="cmtt-10">\acrshort</span><a id="dx1-186014"></a>, <span class="cmtt-10">\acrlong</span><a @@ -31252,7 +31120,7 @@ class="cmtt-10">\glsxtrlong</span></span><a id="dx1-186017"></a> and <span id="textcolor537"><span class="cmtt-10">\glsxtrfull</span></span><a id="dx1-186018"></a>. -</p><!--l. 15416--><p class="indent" > You may notice that the spacing after “e.g.” and “i.e.” isn’t correct. This is similar to the <a +</p><!--l. 15429--><p class="indent" > You may notice that the spacing after “e.g.” and “i.e.” isn’t correct. This is similar to the <a href="#ex:sample-dot-abbr"><span class="cmtt-10">sample-dot-abbr.tex</span></a> example where the space factor needs adjusting. In this case I’ve inserted the dots manually (rather than relying @@ -31311,7 +31179,7 @@ class="cmtt-10">}{id</span><span class="cmtt-10"> est}</span> </div> </div> -<!--l. 15438--><p class="indent" > You don’t have to use the <span id="textcolor545"><span +<!--l. 15451--><p class="indent" > You don’t have to use the <span id="textcolor545"><span class="cmss-10">acronym</span></span><a id="dx1-186028"></a> category. You may prefer a different label that fits better semantically. For example: </p><div class="alltt"> @@ -31364,14 +31232,14 @@ class="cmtt-10">}{id</span><span class="cmtt-10"> est}</span> </div> </div> -<!--l. 15450--><p class="noindent" > +<!--l. 15463--><p class="noindent" > </p> -<!--l. 15450--><p class="noindent" ><a +<!--l. 15463--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.3 </span> <a id="sec:samplecounter"></a>Non-Page Locations</h3> <a id="x1-187001r12"></a> -<!--l. 15453--><p class="noindent" > +<!--l. 15466--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleEq"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleEq">🔗</a><a @@ -31379,14 +31247,14 @@ href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleEq.t class="cmtt-10">sampleEq.tex</span></a></h4> -<!--l. 15453--><p class="noindent" >This document illustrates how to change the location to something other than the page number. In this case, +<!--l. 15466--><p class="noindent" >This document illustrates how to change the location to something other than the page number. In this case, the <span class="cmss-10">equation </span>counter is used since all glossary entries appear inside an <span class="cmss-10">equation</span><a id="dx1-188001"></a><a id="dx1-188002"></a> environment. To create the document do: -</p><!--l. 15458--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15471--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleEq <br />makeglossaries sampleEq <br />pdflatex sampleEq @@ -31413,7 +31281,7 @@ class="cmtt-10">xindy</span><a id="dx1-188008"></a></a>, the <span class="cmss-10">glossaries </span>package has to reform the name from a prefix and the location value. -</p><!--l. 15471--><p class="indent" > Unfortunately it’s not always possible to split the link name into a prefix and location. That happens with +</p><!--l. 15484--><p class="indent" > Unfortunately it’s not always possible to split the link name into a prefix and location. That happens with the <span class="cmss-10">equation </span>counter in certain classes, such as the <span class="cmss-10">report </span>class (which is used in this example). @@ -31424,11 +31292,11 @@ requirement: </p> - <div class="verbatim" id="verbatim-417"> + <div class="verbatim" id="verbatim-418"> \renewcommand*\theHequation{\theHchapter.\arabic{equation}} </div> -<!--l. 15478--><p class="nopar" > If you don’t do this, the equation locations in the glossary won’t form valid hyperlinks. -</p><!--l. 15482--><p class="indent" > Each glossary entry represents a mathematical symbol. This means that with Options <a +<!--l. 15491--><p class="nopar" > If you don’t do this, the equation locations in the glossary won’t form valid hyperlinks. +</p><!--l. 15495--><p class="indent" > Each glossary entry represents a mathematical symbol. This means that with Options <a href="#option1">1</a>–<a href="#option3">3</a> it’s necessary to use the <span @@ -31444,7 +31312,7 @@ class="cmtt-10">sort=Gamma</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 15490--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 15503--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-188011"></a></a></span>If you want to switch to using <a @@ -31500,7 +31368,7 @@ class="cmtt-10">bib2gls</span><a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a id="dx1-188021"></a></a>: -<!--l. 15506--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 15519--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only sampleEq.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -31537,7 +31405,7 @@ class="cmtt-10">@symbol</span></span><a replace function.) -<!--l. 15521--><p class="indent" > Note that the <span +<!--l. 15534--><p class="indent" > Note that the <span class="cmtt-10">sort</span><a id="dx1-188025"></a> key has been omitted. This is because it typically shouldn’t be used. The difference between using <span id="textcolor563"><span @@ -31562,7 +31430,7 @@ class="cmtt-10">@symbol</span></span><a id="dx1-188033"></a>. See also <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a>.) -</p><!--l. 15531--><p class="indent" > Next replace <span +</p><!--l. 15544--><p class="indent" > Next replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> <strong><span id="textcolor569"><span @@ -31582,7 +31450,7 @@ class="cmtt-10">\theHequation</span>. Next remove all the lines defining the glossary entries (since they’re now defined in the <span class="cmtt-10">bib</span><a id="dx1-188037"></a> file). -<!--l. 15540--><p class="indent" > Finally, replace <span +<!--l. 15553--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossary</span><a id="dx1-188038"></a> with <span id="textcolor572"><span class="cmtt-10">\printunsrtglossary</span></span><a @@ -31605,19 +31473,18 @@ class="cmtt-10">\glsxtrfmt</span></span><a example). <a id="x1-188042r13"></a> -<!--l. 15548--><p class="noindent" > +<!--l. 15561--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleEqPg"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleEqPg">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleEqPg.tex" ><span class="cmtt-10">sampleEqPg.tex</span></a></h4> -<!--l. 15548--><p class="noindent" >This is similar to the previous example, but the <a +<!--l. 15561--><p class="noindent" >This is similar to the previous example, but the <a href="#glo:numberlist">number list<a id="dx1-189001"></a>s</a> are a mixture of page numbers and -equation numbers. This example adds the glossary to the table of contents, so an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run is +equation numbers. This example adds the glossary to the table of contents, so an extra LaTeX run is required: -</p><!--l. 15552--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15565--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleEqPg <br />makeglossaries sampleEqPg <br />pdflatex sampleEqPg @@ -31628,11 +31495,11 @@ As with the previous example, entries are defined like this: </p> - <div class="verbatim" id="verbatim-418"> + <div class="verbatim" id="verbatim-419"> \newglossaryentry{Gamma}{name=\ensuremath{\Gamma(z)},  <br />description=Gamma function,sort=Gamma} </div> -<!--l. 15562--><p class="nopar" > The <span +<!--l. 15575--><p class="nopar" > The <span class="cmss-10">counter</span><span class="cmtt-10">=</span><span class="cmss-10">equation</span><a @@ -31642,10 +31509,10 @@ has to be changed for indexing outside of any numbered equation. For example: </p> - <div class="verbatim" id="verbatim-419"> + <div class="verbatim" id="verbatim-420"> \glslink[format=hyperbf,counter=page]{Gamma}{gamma function} </div> -<!--l. 15569--><p class="nopar" > I’ve set the <span +<!--l. 15582--><p class="nopar" > I’ve set the <span class="cmtt-10">format</span><a id="dx1-189003"></a> to <span class="cmtt-10">hyperbf</span><a @@ -31655,7 +31522,7 @@ class="cmtt-10">\hyperbf</span><a <span class="cmtt-10">\textbf</span><a id="dx1-189006"></a> in order to include a hyperlink in the location.) -</p><!--l. 15574--><p class="indent" > The <a +</p><!--l. 15587--><p class="indent" > The <a href="#glo:linktext">link text<a id="dx1-189007"></a></a> here is almost identical to the description. The only difference is that the description starts with a capital. If it started with a lowercase character instead, I could simply use <span @@ -31669,7 +31536,7 @@ class="cmtt-10">\Glossentrydesc</span><a id="dx1-189010"></a> instead of <span class="cmtt-10">\glossentrydesc</span><a id="dx1-189011"></a>. -</p><!--l. 15582--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15595--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If I switch to using <a href="#glo:glossaries-extra"><span @@ -31731,7 +31598,7 @@ class="cmtt-10">\glsdesc</span><a id="dx1-189016"></a> instead of <span class="cmtt-10">\glslink</span><a id="dx1-189017"></a>. -<!--l. 15605--><p class="indent" > It’s a bit cumbersome typing <span +<!--l. 15618--><p class="indent" > It’s a bit cumbersome typing <span class="cmtt-10">[format=hyperbf,counter=page] </span>for each primary reference, but <a href="#glo:glossaries-extra"><span @@ -31791,7 +31658,7 @@ class="cmtt-10"> defined</span><span class="cmtt-10"> as</span> </div> </div> -<!--l. 15630--><p class="indent" > There are three other instances of <span +<!--l. 15643--><p class="indent" > There are three other instances of <span class="cmtt-10">\glslink</span><a id="dx1-189025"></a>, such as: </p><div class="alltt"> <div class="obeylines-v"> @@ -31807,7 +31674,7 @@ href="#glo:linktext">link text<a id="dx1-189027"></a></a>. For entries like this that represent functions with variable parameters it would be more convenient (and help with consistency) if a command was available to easily replace the parameters. -<!--l. 15640--><p class="indent" > With the base <span +<!--l. 15653--><p class="indent" > With the base <span class="cmss-10">glossaries </span>package, one simple solution that works for this example is to save just the function symbol in the <span class="cmtt-10">symbol</span><a @@ -31850,17 +31717,17 @@ href="#glo:linktext">link text<a can simply follow the symbol, and it can also be used with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. -<!--l. 15660--><p class="indent" > The <a +<!--l. 15673--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides another possibility. It requires a command that takes a single argument, for example: </p> - <div class="verbatim" id="verbatim-420"> + <div class="verbatim" id="verbatim-421"> \newcommand{\Gammafunction}[1]{\Gamma(#1)} </div> -<!--l. 15664--><p class="nopar" > The control sequence name (the command name without the leading backslash) is stored in the field identified +<!--l. 15677--><p class="nopar" > The control sequence name (the command name without the leading backslash) is stored in the field identified by the command <span id="textcolor581"><span class="cmtt-10">\GlsXtrFmtField</span></span><a id="dx1-189034"></a> (this should be the internal field name not the key name, see <a @@ -31874,7 +31741,7 @@ class="cmtt-10">Gamma </span>entry would need to be defined with <span class="cmtt-10">user1=Gammafunction</span>. With this approach, each function entry would need a separate associated command. -</p><!--l. 15673--><p class="indent" > Another approach is to store the parameterless function in the <span +</p><!--l. 15686--><p class="indent" > Another approach is to store the parameterless function in the <span class="cmtt-10">symbol</span><a id="dx1-189037"></a> key (as earlier) and have a more generic command that uses this symbol. This requires the entry label, which can be obtained with <span @@ -31896,7 +31763,7 @@ href="#glo:linktext">link text<a <span class="cmtt-10">\glslabel</span><a id="dx1-189042"></a>.) -<!--l. 15683--><p class="indent" > So the entry now needs the parameterless function in <span +<!--l. 15696--><p class="indent" > So the entry now needs the parameterless function in <span class="cmtt-10">symbol</span><a id="dx1-189043"></a> and the control sequence name of this generic command in <span @@ -31916,12 +31783,12 @@ class="cmtt-10"> function,sort=Gamma}</span> </div> (This doesn’t need to be done for the <span class="cmtt-10">C </span>and <span class="cmtt-10">G </span>entries since they’re constants not functions.) -<!--l. 15694--><p class="indent" > You may want to consider providing helper commands to make the functions easier to define. For +<!--l. 15707--><p class="indent" > You may want to consider providing helper commands to make the functions easier to define. For example: </p> - <div class="verbatim" id="verbatim-421"> + <div class="verbatim" id="verbatim-422"> \newcommand{\func}[2]{#1(#2)}  <br />\newcommand{\entryfunc}[1]{\func{\glsentrysymbol{\glslabel}}{#1}}  <br />\newcommand{\newfunc}[5][]{% @@ -31933,20 +31800,20 @@ example:  <br /> }%  <br />} </div> -<!--l. 15707--><p class="nopar" > The entries can now be defined using this custom <span +<!--l. 15720--><p class="nopar" > The entries can now be defined using this custom <span class="cmtt-10">\newfunc </span>command. For example: </p> - <div class="verbatim" id="verbatim-422"> + <div class="verbatim" id="verbatim-423"> \newfunc{Gamma}{\Gamma}{z}{gamma function}  <br />\newfunc[sort=gamma1]{gamma}{\gamma}{\alpha,x}{lower  <br />  incomplete gamma function}  <br />\newfunc[sort=Gamma2]{iGamma}{\Gamma}{\alpha,x}{upper  <br />  incomplete gamma function} </div> -<!--l. 15716--><p class="nopar" > -</p><!--l. 15718--><p class="indent" > Note that in <span +<!--l. 15729--><p class="nopar" > +</p><!--l. 15731--><p class="indent" > Note that in <span class="cmtt-10">\newfunc </span>the <span class="cmtt-10">symbol</span><a id="dx1-189046"></a> key doesn’t have its value encapsulated with <span @@ -31963,7 +31830,7 @@ class="cmtt-10">symbol</span><a encapsulation with the <span id="textcolor582"><span class="cmss-10">glosssymbolfont</span></span><a id="dx1-189050"></a> attribute. -</p><!--l. 15726--><p class="indent" > Now <span class="obeylines-h"><span class="verb"><span +</p><!--l. 15739--><p class="indent" > Now <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslink{Znu}{Z_\nu}</span></span></span> can simply be replaced with <span class="cmtt-10">\glssymbol</span><a id="dx1-189051"></a><span @@ -31989,7 +31856,7 @@ class="cmtt-10">\glslink </span>but omits the post-link hook. (See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details.) -<!--l. 15738--><p class="indent" > <div class="important" title="Important Note"> Don’t use <span id="textcolor585"><span +<!--l. 15751--><p class="indent" > <div class="important" title="Important Note"> Don’t use <span id="textcolor585"><span class="cmtt-10">\glsxtrfmt</span></span><a id="dx1-189056"></a> within the argument of another <span id="textcolor586"><span class="cmtt-10">\glsxtrfmt</span></span><a @@ -31997,8 +31864,8 @@ class="cmtt-10">\glsxtrfmt</span></span><a href="#glo:linktext">link text<a id="dx1-189058"></a></a>). </div> -</p><!--l. 15741--><p class="noindent" > -</p><!--l. 15743--><p class="indent" > Similarly <span class="obeylines-h"><span class="verb"><span +</p><!--l. 15754--><p class="noindent" > +</p><!--l. 15756--><p class="indent" > Similarly <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslink{Gamma}{\Gamma(\alpha)}</span></span></span> can now be replaced with: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor587"><span @@ -32017,10 +31884,10 @@ class="cmtt-10">{Gamma}[(\alpha)]</span> example: - <div class="verbatim" id="verbatim-423"> + <div class="verbatim" id="verbatim-424"> \newcommand*{\Fn}[3][]{\glssymbol[#1]{#2}[(#3)]} </div> -<!--l. 15756--><p class="nopar" > or: </p><div class="alltt"> +<!--l. 15769--><p class="nopar" > or: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newcommand*{\Fn}[3][]{</span><span id="textcolor588"><span @@ -32029,7 +31896,7 @@ class="cmtt-10">\glsxtrfmt</span></span><a class="cmtt-10">[#1]{#2}{#3}}</span> </div> </div> -<!--l. 15762--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 15775--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-189062"></a></a></span>If you want to convert this example so that it works with <a @@ -32048,7 +31915,7 @@ class="cmtt-10">convertgls2bib</span><a class="cmtt-10">\newcommand </span>so it will be able to parse the custom <span class="cmtt-10">\newfunc</span> commands. -</p><!--l. 15769--><p class="indent" > Note that <a +</p><!--l. 15782--><p class="indent" > Note that <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-189065"></a></a> allows you to separate the locations in the <a @@ -32071,18 +31938,17 @@ class="cmtt-10">bib2gls</span><a manual for further details. <a id="x1-189072r14"></a> -</p><!--l. 15779--><p class="noindent" > +</p><!--l. 15792--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleSec"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleSec">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleSec.tex" ><span class="cmtt-10">sampleSec.tex</span></a></h4> -<!--l. 15779--><p class="noindent" >This document also illustrates how to change the location to something other than the page number. In this +<!--l. 15792--><p class="noindent" >This document also illustrates how to change the location to something other than the page number. In this case, the <span class="cmtt-10">section </span>counter is used. This example adds the glossary to the table of contents, so an extra -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run is required: -</p><!--l. 15784--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +LaTeX run is required: +</p><!--l. 15797--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSec <br />makeglossaries sampleSec <br />pdflatex sampleSec @@ -32096,7 +31962,7 @@ class="cmtt-10">makeindex</span><a </p> - <div class="verbatim" id="verbatim-424"> + <div class="verbatim" id="verbatim-425"> ## Warning (input = sampleSec.glo, line = 6; output =  <br />sampleSec.gls, line = 9):  <br />   -- Conflicting entries: multiple encaps for the same page @@ -32106,7 +31972,7 @@ class="cmtt-10">makeindex</span><a  <br />   -- Conflicting entries: multiple encaps for the same page  <br />under same key. </div> -<!--l. 15802--><p class="nopar" > This is the result of indexing an entry multiple times for the same +<!--l. 15815--><p class="nopar" > This is the result of indexing an entry multiple times for the same location<span class="footnote-mark"><a href="#fn1x19" id="fn1x19-bk"><sup class="textsuperscript">19.1</sup></a></span><a id="x1-190002f1"></a> @@ -32118,13 +31984,13 @@ section 2.1: </p> - <div class="verbatim" id="verbatim-425"> + <div class="verbatim" id="verbatim-426"> \gls[format=hyperit]{ident}  <br />\glspl{ident} % default format=glsnumberformat  <br />\gls*[format=hyperbf]{ident} </div> -<!--l. 15811--><p class="nopar" > -</p><!--l. 15813--><p class="indent" > If you use the <a +<!--l. 15824--><p class="nopar" > +</p><!--l. 15826--><p class="indent" > If you use the <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-190005"></a></a> Perl script it will detect the warnings in the <a @@ -32137,16 +32003,16 @@ class="cmtt-10">glo</span><a </p> - <div class="verbatim" id="verbatim-426"> + <div class="verbatim" id="verbatim-427"> Multiple encaps detected. Attempting to remedy.  <br />Reading sampleSec.glo...  <br />Writing sampleSec.glo...  <br />Retrying </div> -<!--l. 15821--><p class="nopar" > (Range formats have highest precedence. The default <span +<!--l. 15834--><p class="nopar" > (Range formats have highest precedence. The default <span class="cmtt-10">glsnumberformat</span><a id="dx1-190008"></a> has the lowest precedence.) -</p><!--l. 15825--><p class="indent" > If you use <a +</p><!--l. 15838--><p class="indent" > If you use <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-190009"></a></a> or call <a @@ -32169,7 +32035,7 @@ class="cmtt-10">makeglossaries</span><a id="dx1-190014"></a></a> then only the bold entry (<span class="cmbx-10">2.1</span>) will be present. -</p><!--l. 15834--><p class="indent" > If you switch to <a +</p><!--l. 15847--><p class="indent" > If you switch to <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-190015"></a></a>: </p><div class="alltt"> @@ -32209,11 +32075,11 @@ class="cmtt-10">format</span><a class="cmtt-10">=primary</span><a id="dx1-190020"></a> the highest priority. (It’s also better practice to provide this kind of semantic command.) -<!--l. 15851--><p class="indent" > With <a +<!--l. 15864--><p class="indent" > With <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-190021"></a></a>, you can supply rules to deal with location format conflicts, as illustrated below. -</p><!--l. 15854--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 15867--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-190022"></a></a></span>In order to switch to <a @@ -32242,7 +32108,7 @@ class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 15865--><p class="indent" > The entry definitions now need to be converted into <a +<!--l. 15878--><p class="indent" > The entry definitions now need to be converted into <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-190025"></a></a> format and saved in a <span @@ -32255,11 +32121,11 @@ class="cmtt-10">convertgls2bib</span><a id="dx1-190027"></a></a>: -</p><!--l. 15868--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15881--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only sampleSec.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 15872--><p class="indent" > Next replace <span +</p><!--l. 15885--><p class="indent" > Next replace <span class="cmtt-10">\makeglossaries</span><a id="dx1-190028"></a> with: </p><div class="alltt"> <div class="obeylines-v"> @@ -32270,12 +32136,12 @@ class="cmtt-10">[src=entries]</span> </div> </div> and remove all the <span class="cmtt-10">\newglossaryentry </span>commands. -<!--l. 15878--><p class="indent" > Finally, replace <span +<!--l. 15891--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossaries</span><a id="dx1-190030"></a> with <span id="textcolor595"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-190031"></a>. The document build is now: -</p><!--l. 15880--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15893--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSec <br />bib2gls sampleSec <br />pdflatex sampleSec @@ -32288,19 +32154,19 @@ class="cmtt-10">bib2gls</span><a </p> - <div class="verbatim" id="verbatim-427"> + <div class="verbatim" id="verbatim-428"> Warning: Entry location conflict for formats: hyperbf and hyperit  <br />Discarding: {ident}{}{section}{hyperbf}{2.1}  <br />Conflicts with: {ident}{}{section}{hyperit}{2.1} </div> -<!--l. 15891--><p class="nopar" > This means that it has discarded the bold location and kept the italic one. (As with <a +<!--l. 15904--><p class="nopar" > This means that it has discarded the bold location and kept the italic one. (As with <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-190033"></a></a>, range formats have the highest priority and <span class="cmtt-10">glsnumberformat</span><a id="dx1-190034"></a> has the lowest.) -</p><!--l. 15896--><p class="indent" > It would be better if the conflict could be merged into a single location that was both bold and italic. To +</p><!--l. 15909--><p class="indent" > It would be better if the conflict could be merged into a single location that was both bold and italic. To achieve this, it’s first necessary to define a command that produces this effect: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -32317,7 +32183,7 @@ class="cmtt-10">--map-format</span></span><a class="cmtt-10">-m</span></span><a id="dx1-190038"></a> switch: -<!--l. 15904--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 15917--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />bib2gls -m ”hyperbf:hyperbfit,hyperit:hyperbfit” sampleSec <br /></pre><spacer type=vertical size=10> <br /></span> @@ -32344,7 +32210,7 @@ class="cmtt-10"> ]</span><span class="cmtt-10"> }</span> </div> </div> -<!--l. 15913--><p class="indent" > If you try out this example, notice the difference between <span id="textcolor598"><span +<!--l. 15926--><p class="indent" > If you try out this example, notice the difference between <span id="textcolor598"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">only</span></span><a @@ -32369,7 +32235,7 @@ class="cmitt-10">title</span>⟩<span class="cmtt-10">}</span> </div> </div> -<!--l. 15922--><p class="indent" > In this case the counter is <span +<!--l. 15935--><p class="indent" > In this case the counter is <span class="cmss-10">section</span>, so the command should be <span id="textcolor601"><span class="cmtt-10">\glsxtrsectionlocfmt</span></span><a id="dx1-190043"></a>. It takes two @@ -32393,28 +32259,27 @@ class="cmtt-10">\glsxtrequationlocfmt</span></span><a id="dx1-190046"></a>.) Make sure that you have at least version 1.42 of <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. -<!--l. 15932--><p class="noindent" > +<!--l. 15945--><p class="noindent" > </p> -<!--l. 15932--><p class="noindent" ><a +<!--l. 15945--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.4 </span> <a id="sec:samplestype"></a>Multiple Glossaries</h3> -<!--l. 15935--><p class="noindent" >See also <a +<!--l. 15948--><p class="noindent" >See also <a href="#ex:sampleSort"><span class="cmtt-10">sampleSort.tex</span></a> in <a href="#sec:samplessort">§19.5 </a><a href="#sec:samplessort">Sorting<!--tex4ht:ref: sec:samplessort --></a>, which has three glossaries. <a id="x1-191001r15"></a> -</p><!--l. 15938--><p class="noindent" > +</p><!--l. 15951--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleNtn"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleNtn">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleNtn.tex" ><span class="cmtt-10">sampleNtn.tex</span></a></h4> -<!--l. 15938--><p class="noindent" >This document illustrates how to create an additional glossary type. This example adds the glossary to the table -of contents, so an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run is required: -</p><!--l. 15942--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 15951--><p class="noindent" >This document illustrates how to create an additional glossary type. This example adds the glossary to the table +of contents, so an extra LaTeX run is required: +</p><!--l. 15955--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleNtn <br />makeglossaries sampleNtn <br />pdflatex sampleNtn @@ -32438,19 +32303,19 @@ class="cmtt-10">makeindex</span><a </p><ol class="enumerate1" > <li class="enumerate" id="x1-192006x1">Create the main glossary (all on one line): - <!--l. 15953--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <!--l. 15966--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s sampleNtn.ist -t sampleNtn.glg -o sampleNtn.gls sampleNtn.glo <br /></pre><spacer type=vertical size=10> <br /></span> </p></li> <li class="enumerate" id="x1-192008x2">Create the secondary glossary (all on one line): - <!--l. 15957--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <!--l. 15970--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s sampleNtn.ist -t sampleNtn.nlg -o sampleNtn.not sampleNtn.ntn <br /></pre><spacer type=vertical size=10> <br /></span> </p></li></ol> -<!--l. 15961--><p class="noindent" >This document creates a new glossary using: </p><div class="alltt"> +<!--l. 15974--><p class="noindent" >This document creates a new glossary using: </p><div class="alltt"> <div class="obeylines-v"> @@ -32472,7 +32337,7 @@ class="cmtt-10">makeindex</span><a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-192011"></a></a>. -<!--l. 15971--><p class="indent" > (The optional argument is the file extension of the indexing transcript file, which <span +<!--l. 15984--><p class="indent" > (The optional argument is the file extension of the indexing transcript file, which <span class="cmss-10">glossaries </span>doesn’t need to know about, but it writes the information to the <span class="cmtt-10">aux</span><a @@ -32484,7 +32349,7 @@ class="cmtt-10">makeglossaries</span><a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-192014"></a></a>.) -</p><!--l. 15976--><p class="indent" > If you switch to a different indexing option then these file extensions aren’t required, in which case it’s +</p><!--l. 15989--><p class="indent" > If you switch to a different indexing option then these file extensions aren’t required, in which case it’s simpler to use the starred form: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -32493,32 +32358,32 @@ class="cmtt-10">\newglossary*</span><a class="cmtt-10">{notation}{Notation}</span> </div> </div> -<!--l. 15982--><p class="indent" > This example uses a label prefixing system<span class="footnote-mark"><a +<!--l. 15995--><p class="indent" > This example uses a label prefixing system<span class="footnote-mark"><a href="#fn2x19" id="fn2x19-bk"><sup class="textsuperscript">19.2</sup></a></span><a id="x1-192016f2"></a> to differentiate between the different types of entries. For example, the term “set” is defined as: </p> - <div class="verbatim" id="verbatim-428"> + <div class="verbatim" id="verbatim-429"> \newglossaryentry{gls:set}{name=set,  <br />description={A collection of distinct objects}} </div> -<!--l. 15990--><p class="nopar" > and the set notation is defined as: +<!--l. 16003--><p class="nopar" > and the set notation is defined as: </p> - <div class="verbatim" id="verbatim-429"> + <div class="verbatim" id="verbatim-430"> \newglossaryentry{not:set}{type=notation,  <br />name={\ensuremath{\mathcal{S}}},  <br />description={A \gls{gls:set}},sort={S}} </div> -<!--l. 15996--><p class="nopar" > Notice that the latter description contains <span +<!--l. 16009--><p class="nopar" > Notice that the latter description contains <span class="cmtt-10">\gls</span>. This means you shouldn’t use <span class="cmtt-10">\glsdesc</span><a id="dx1-192018"></a> with this entry otherwise you will end up with nested links. -</p><!--l. 16001--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 16014--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>The <a href="#glo:glossaries-extra"><span @@ -32570,7 +32435,7 @@ class="cmtt-10">\glsdesc</span><a id="dx1-192026"></a>. It will also suppress indexing within the glossary but will have a hyperlink (if <span class="cmss-10">hyperref </span>is used). -<!--l. 16020--><p class="indent" > The <a +<!--l. 16033--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides a way of defining commands like <span class="cmtt-10">\gls </span>that automatically insert a @@ -32591,7 +32456,7 @@ replaced with <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\sym{set}</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{gls:set}</span></span></span> can be replaced with <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\term{set}</span></span></span>. -<!--l. 16031--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 16044--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-192029"></a></a></span>These two commands are primarily provided for the benefit of <a @@ -32612,7 +32477,7 @@ class="cmtt-10">label-prefix</span></span><a class="cmtt-10">ext-prefixes</span></span><a id="dx1-192035"></a> (see below) this makes it much simpler to change the prefixes if necessary. -</p><!--l. 16040--><p class="indent" > If you want to convert this document to use <a +</p><!--l. 16053--><p class="indent" > If you want to convert this document to use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-192036"></a></a>, remember that you need the <span id="textcolor612"><span @@ -32647,7 +32512,7 @@ href="#fn3x19" id="fn3x19-bk"><sup class="textsuperscript">19.3</sup></a></span> id="x1-192041f3"></a> This is useful if you want to reuse a large database of entries across multiple documents as it doesn’t lock you into using a specific glossary. For example: -<!--l. 16053--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16066--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --split-on-type --preamble-only sampleNtn.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -32778,7 +32643,7 @@ class="cmtt-10"> objects}</span> class="cmtt-10">}</span> </div> </div> -<!--l. 16096--><p class="indent" > Now you can replace <span +<!--l. 16109--><p class="indent" > Now you can replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor625"><span @@ -32814,17 +32679,17 @@ class="cmtt-10">\newglossaryentry </span>definitions and replace <span class="cmtt-10">\printglossaries </span>with <span id="textcolor633"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-192059"></a>. -<!--l. 16105--><p class="indent" > Regardless of how many resource sets the document contains, only one <a +<!--l. 16118--><p class="indent" > Regardless of how many resource sets the document contains, only one <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-192060"></a></a> call is required: -</p><!--l. 16107--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16120--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleNtn <br />bib2gls sampleNtn <br />pdflatex sampleNtn <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 16113--><p class="indent" > You may notice that the ordering in the notations list has changed from the original. This is because the +</p><!--l. 16126--><p class="indent" > You may notice that the ordering in the notations list has changed from the original. This is because the <span class="cmtt-10">sort</span><a id="dx1-192061"></a> field was automatically removed by <a @@ -32885,15 +32750,15 @@ sorting</a>.) id="x1-192072r16"></a> -<!--l. 16134--><p class="noindent" > +<!--l. 16147--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-dual"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-dual">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-dual.tex" ><span class="cmtt-10">sample-dual.tex</span></a></h4> -<!--l. 16134--><p class="noindent" >This document illustrates how to define an entry that both appears in the list of acronyms and in the main +<!--l. 16147--><p class="noindent" >This document illustrates how to define an entry that both appears in the list of acronyms and in the main glossary. To create the document do: -</p><!--l. 16137--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16150--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-dual <br />makeglossaries sample-dual <br />pdflatex sample-dual @@ -32909,7 +32774,7 @@ indexed: </p> - <div class="verbatim" id="verbatim-430"> + <div class="verbatim" id="verbatim-431"> \newcommand*{\newdualentry}[5][]{%  <br />  % main entry:  <br />  \newglossaryentry{main-#2}{name={#4},% @@ -32921,17 +32786,17 @@ indexed:  <br />  \newacronym{#2}{#3\glsadd{main-#2}}{#4}%  <br />} </div> -<!--l. 16156--><p class="nopar" > A sample dual entry is defined with this command: +<!--l. 16169--><p class="nopar" > A sample dual entry is defined with this command: </p> - <div class="verbatim" id="verbatim-431"> + <div class="verbatim" id="verbatim-432"> \newdualentry{svm}% label  <br />  {SVM}% abbreviation  <br />  {support vector machine}% long form  <br />  {Statistical pattern recognition technique}% description </div> -<!--l. 16163--><p class="nopar" > This defines an acronym with the label <span +<!--l. 16176--><p class="nopar" > This defines an acronym with the label <span class="cmtt-10">svm </span>that can be referenced with <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{svm}</span></span></span> but it also defines an entry with the label <span @@ -32940,11 +32805,11 @@ class="cmtt-10">\gls </span>but it’s automatically added from the <span class="cmtt-10">\glsadd{main-svm} </span>in the short form of <span class="cmtt-10">svm</span>. -</p><!--l. 16171--><p class="indent" > For this trivial document, this kind of dual entry is redundant and unnecessarily leads the +</p><!--l. 16184--><p class="indent" > For this trivial document, this kind of dual entry is redundant and unnecessarily leads the reader down a trail, first to the list of acronyms and from there the reader then has to go to the main glossary to look up the description. It’s better to simply include the description in the list of acronyms. -</p><!--l. 16177--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 16190--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-193003"></a></a></span>If you want to switch over to <a @@ -32971,7 +32836,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-193006"></a></a>. If you do: -<!--l. 16185--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16198--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only sample-dual.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -32982,13 +32847,13 @@ class="cmtt-10">convertgls2bib</span><a </p> - <div class="verbatim" id="verbatim-432"> + <div class="verbatim" id="verbatim-433"> Overriding default definition of \newdualentry with custom  <br />definition. (Change \newcommand to \providecommand if you want  <br />\newdualentry[options]{label}{short}{long}{description}  <br />converted to @dualabbreviationentry.) </div> -<!--l. 16194--><p class="nopar" > This is because <a +<!--l. 16207--><p class="nopar" > This is because <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a id="dx1-193008"></a></a> has its own internal definition of <span @@ -33004,7 +32869,7 @@ class="cmtt-10">\providecommand </span>in the document source and rerun href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a id="dx1-193010"></a></a>. -</p><!--l. 16202--><p class="indent" > With <span +</p><!--l. 16215--><p class="indent" > With <span class="cmtt-10">\providecommand</span>, the new <span class="cmtt-10">entries.bib </span>file created by <a href="#glo:convertgls2bib"><span @@ -33095,7 +32960,7 @@ class="cmtt-10">bib2gls</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-193016"></a></a> creates two entries that simply reference each other. -<!--l. 16228--><p class="indent" > Assuming that your <span +<!--l. 16241--><p class="indent" > Assuming that your <span class="cmtt-10">entries.bib </span>file just contains <span id="textcolor647"><span class="cmtt-10">@dualabbreviationentry</span></span><a id="dx1-193017"></a>, now replace @@ -33124,19 +32989,19 @@ class="cmtt-10">={main-}]</span> </div> </div> -<!--l. 16236--><p class="indent" > Then remove the definition of <span +<!--l. 16249--><p class="indent" > Then remove the definition of <span class="cmtt-10">\newdualentry </span>and the entry definition. Finally, replace <span class="cmtt-10">\printglossaries</span> with <span id="textcolor652"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-193022"></a>. The document build is: -</p><!--l. 16240--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16253--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-dual <br />bib2gls sample-dual <br />pdflatex sample-dual <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 16246--><p class="indent" > If, instead, your <span +</p><!--l. 16259--><p class="indent" > If, instead, your <span class="cmtt-10">entries.bib </span>file contains separate <span id="textcolor653"><span class="cmtt-10">@entry</span></span><a id="dx1-193023"></a> and <span id="textcolor654"><span @@ -33158,7 +33023,7 @@ class="cmtt-10">=entries]</span> </div> If you need <a href="#glo:numberlist">number list<a id="dx1-193028"></a>s</a>, the document build is now -<!--l. 16253--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16266--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-dual <br />bib2gls sample-dual <br />pdflatex sample-dual @@ -33179,8 +33044,7 @@ class="cmtt-10">text</span><a this can be problematic. (The extra <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-193033"></a></a> and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> calls are to ensure the <a + id="dx1-193033"></a></a> and LaTeX calls are to ensure the <a href="#glo:numberlist">number list<a id="dx1-193034"></a></a> is up to date for the <span @@ -33188,7 +33052,7 @@ class="cmtt-10">main-svm </span>entry, which can only be indexed with <span class="cmtt-10">\glsadd </span>after <span class="cmtt-10">svm </span>has been defined.) -</p><!--l. 16267--><p class="indent" > Dual entries make much more sense when one entry is for a glossary with the description displayed but +</p><!--l. 16280--><p class="indent" > Dual entries make much more sense when one entry is for a glossary with the description displayed but no <a href="#glo:numberlist">number list<a id="dx1-193035"></a></a>, and the other is for the index without the description but with a <a @@ -33341,15 +33205,15 @@ class="cmtt-10">bib2gls</span><a id="dx1-193052"></a></a> manual for further details. <a id="x1-193053r17"></a> -<!--l. 16310--><p class="noindent" > +<!--l. 16323--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-langdict"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-langdict">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-langdict.tex" ><span class="cmtt-10">sample-langdict.tex</span></a></h4> -<!--l. 16310--><p class="noindent" >This document illustrates how to use the glossaries package to create English to French and French to English +<!--l. 16323--><p class="noindent" >This document illustrates how to use the glossaries package to create English to French and French to English dictionaries. To create the document do: -</p><!--l. 16314--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16327--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-langdict <br />makeglossaries sample-langdict <br />pdflatex sample-langdict @@ -33365,16 +33229,16 @@ document must provide its own glossaries: </p> - <div class="verbatim" id="verbatim-433"> + <div class="verbatim" id="verbatim-434"> \newglossary[glg]{english}{gls}{glo}{English to French}  <br />\newglossary[flg]{french}{flx}{flo}{French to English} </div> -<!--l. 16325--><p class="nopar" > This means that if you want to call <a +<!--l. 16338--><p class="nopar" > This means that if you want to call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-194002"></a></a> explicitly you need to take these new extensions into account: -</p><!--l. 16328--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16341--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s sample-langdict.ist -t sample-langdict.glg -o sample-langdict.gls sample-langdict.glo <br />makeindex -s sample-langdict.ist -t sample-langdict.flg -o sample-langdict.flx sample-langdict.flo <br /></pre><spacer type=vertical size=10> @@ -33384,14 +33248,14 @@ entries: </p> - <div class="verbatim" id="verbatim-434"> + <div class="verbatim" id="verbatim-435"> \newcommand*{\newword}[4]{%  <br />  \newglossaryentry{en-#1}{type=english,name={#2},description={#3 #4}}%  <br />  \newglossaryentry{fr-#1}{type=french,name={#3 #4},text={#4},sort={#4},  <br />    description={#2}}%  <br />} </div> -<!--l. 16340--><p class="nopar" > This has the syntax: </p><div class="alltt"> +<!--l. 16353--><p class="nopar" > This has the syntax: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newword{</span>⟨<span @@ -33413,20 +33277,20 @@ class="cmitt-10">label</span>⟩ (for the French term). So - <div class="verbatim" id="verbatim-435"> + <div class="verbatim" id="verbatim-436"> \newword{cat}{cat}{le}{chat} </div> -<!--l. 16351--><p class="nopar" > is equivalent to: +<!--l. 16364--><p class="nopar" > is equivalent to: </p> - <div class="verbatim" id="verbatim-436"> + <div class="verbatim" id="verbatim-437"> \newglossaryentry{en-cat}{type=english,name={cat},description={le chat}}  <br />\newglossaryentry{fr-cat}{type=french,name={le chat},sort={chat},  <br />  description={cat}} </div> -<!--l. 16357--><p class="nopar" > -</p><!--l. 16359--><p class="indent" > Unlike the previous example (<a +<!--l. 16370--><p class="nopar" > +</p><!--l. 16372--><p class="indent" > Unlike the previous example (<a href="#ex:sample-dual"><span class="cmtt-10">sample-dual.tex</span></a>), there’s no link between these two entries. If the document only uses <span class="obeylines-h"><span class="verb"><span @@ -33436,7 +33300,7 @@ class="cmtt-10">english </span>glossary but the <span class="cmtt-10">fr-cat </span>entry won’t appear in the <span class="cmtt-10">french </span>one. -</p><!--l. 16365--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 16378--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-194003"></a></a></span>If you want to switch to <a @@ -33488,7 +33352,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-194008"></a></a>: -<!--l. 16381--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16394--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --only-preamble sample-langdict.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -33551,7 +33415,7 @@ class="cmtt-10">}</span> </div> (Note that the <span class="cmtt-10">sort</span><a id="dx1-194011"></a> field has been omitted.) -<!--l. 16402--><p class="indent" > This would be more flexible, and much briefer, if these entries were defined using <a +<!--l. 16415--><p class="indent" > This would be more flexible, and much briefer, if these entries were defined using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-194012"></a>’s</a> dual entry @@ -33620,14 +33484,14 @@ class="cmtt-10"> {les}</span> class="cmtt-10">}</span> </div> </div> -<!--l. 16423--><p class="indent" > With <span id="textcolor686"><span +<!--l. 16436--><p class="indent" > With <span id="textcolor686"><span class="cmtt-10">@dualentry</span></span><a id="dx1-194020"></a>, the English and French terms are now automatically linked from <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-194021"></a>’s</a> point of view. If only one is referenced in the document, the other will also be added by default. -</p><!--l. 16427--><p class="indent" > Now that the determiner has been moved out of the description, it won’t show in the glossary. However, it’s +</p><!--l. 16440--><p class="indent" > Now that the determiner has been moved out of the description, it won’t show in the glossary. However, it’s possible to include it by providing a command to encapsulate the description (which can also apply the language change as well). </p> @@ -33716,7 +33580,7 @@ class="cmtt-10">\glssetcategoryattribute</span></span><a class="cmtt-10">{french}{glossdescfont}{EnEncap}</span> </div> </div> -<!--l. 16450--><p class="indent" > Remember to remove <span +<!--l. 16463--><p class="indent" > Remember to remove <span class="cmtt-10">\makeglossaries</span>, the definition of <span class="cmtt-10">\newword </span>and the entry definitions from the document preamble, and replace <span @@ -33727,19 +33591,19 @@ class="cmtt-10">\printunsrtglossary</span></span><a id="dx1-194039"></a> </div> </div> -<!--l. 16457--><p class="indent" > Other refinements that you might like to make include using <span id="textcolor703"><span +<!--l. 16470--><p class="indent" > Other refinements that you might like to make include using <span id="textcolor703"><span class="cmtt-10">\glsxtrnewglslike</span></span><a id="dx1-194040"></a> so you don’t have to worry about the label prefix (“en-” and “fr-”). <a id="x1-194041r18"></a> -</p><!--l. 16461--><p class="noindent" > +</p><!--l. 16474--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-index"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-index">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-index.tex" ><span class="cmtt-10">sample-index.tex</span></a></h4> -<!--l. 16461--><p class="noindent" >This document uses the <span +<!--l. 16474--><p class="noindent" >This document uses the <span class="cmss-10">glossaries </span>package to create both a glossary and an index. This requires two <a href="#glo:makeglossaries"><span @@ -33748,7 +33612,7 @@ class="cmtt-10">makeglossaries</span><a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-195002"></a></a>) calls to ensure the document is up to date: -</p><!--l. 16466--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16479--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-index <br />makeglossaries sample-index <br />pdflatex sample-index @@ -33756,24 +33620,24 @@ class="cmtt-10">makeglossaries-lite</span><a <br />pdflatex sample-index <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 16474--><p class="noindent" > +</p><!--l. 16487--><p class="noindent" > </p> -<!--l. 16474--><p class="noindent" ><a +<!--l. 16487--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.5 </span> <a id="sec:samplessort"></a>Sorting</h3> <a id="x1-196001r19"></a> -<!--l. 16477--><p class="noindent" > +<!--l. 16490--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:samplePeople"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:samplePeople">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/samplePeople.tex" ><span class="cmtt-10">samplePeople.tex</span></a></h4> -<!--l. 16477--><p class="noindent" >This document illustrates how you can hook into the standard sort mechanism to adjust the way the sort key is +<!--l. 16490--><p class="noindent" >This document illustrates how you can hook into the standard sort mechanism to adjust the way the sort key is set. This requires an additional run to ensure the table of contents is up-to-date: -</p><!--l. 16481--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16494--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplePeople <br />makeglossaries samplePeople <br />pdflatex samplePeople @@ -33784,20 +33648,20 @@ This provides two commands for typesetting a name: </p> - <div class="verbatim" id="verbatim-437"> + <div class="verbatim" id="verbatim-438"> \newcommand{\sortname}[2]{#2, #1}  <br />\newcommand{\textname}[2]{#1 #2} </div> -<!--l. 16491--><p class="nopar" > where the first argument contains the forenames and the second is the surname. The first command is the one +<!--l. 16504--><p class="nopar" > where the first argument contains the forenames and the second is the surname. The first command is the one required for sorting the name and the second is the one required for displaying the name in the document. A synonym is then defined: </p> - <div class="verbatim" id="verbatim-438"> + <div class="verbatim" id="verbatim-439"> \let\name\textname </div> -<!--l. 16498--><p class="nopar" > This command defaults to the display name command (<span +<!--l. 16511--><p class="nopar" > This command defaults to the display name command (<span class="cmtt-10">\textname</span>) but is temporarily redefined to the sort name command (<span class="cmtt-10">\sortname</span>) within the <span @@ -33837,7 +33701,7 @@ class="cmtt-10">\name </span>is temporarily changed while the <span class="cmtt-10">sort</span><a id="dx1-197004"></a> key is being assigned, the sort value for this entry ends up as “Bloggs, Joe”, but the name appears in the document as “Joe Bloggs”. -<!--l. 16519--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 16532--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-197005"></a></a></span>If you want to use <a @@ -33866,7 +33730,7 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-197009"></a></a>. You can simply do: -<!--l. 16528--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16541--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only samplePeople people.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -33897,7 +33761,7 @@ class="cmtt-10">}</span> </div> However, you may prefer to use the <span class="cmtt-10">--index-conversion </span>(<span class="cmtt-10">-i</span>) switch: -<!--l. 16541--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16554--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib -i --preamble-only samplePeople people.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -33951,7 +33815,7 @@ class="cmtt-10"> #1}"}</span> </div> Note the use of <span class="cmtt-10">\providecommand </span>instead of <span class="cmtt-10">\newcommand</span>. -<!--l. 16562--><p class="indent" > In the document (<span +<!--l. 16575--><p class="indent" > In the document (<span class="cmtt-10">samplePeople.tex</span>) you now need to delete <span class="cmtt-10">\makeglossaries</span>, the definitions of <span @@ -33996,15 +33860,14 @@ class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-197028"></a> </div> </div> The document build is now: -<!--l. 16581--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16594--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplePeople <br />bib2gls samplePeople <br />pdflatex samplePeople <br />pdflatex samplePeople <br /></pre><spacer type=vertical size=10> <br /></span> -The third <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call is required to ensure that the PDF bookmarks are up to date, as the entries +The third LaTeX call is required to ensure that the PDF bookmarks are up to date, as the entries aren’t defined until after the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a @@ -34013,7 +33876,7 @@ class="cmtt-10">\glsfmttext</span></span><a id="dx1-197030"></a> instead of <span class="cmtt-10">\glsentrytext</span>). -</p><!--l. 16592--><p class="indent" > This again leads to a list sorted by surname. The reason this works is because <a +</p><!--l. 16605--><p class="indent" > This again leads to a list sorted by surname. The reason this works is because <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-197031"></a></a> only sees the @@ -34030,22 +33893,22 @@ class="cmtt-10">@preamble</span></span><a id="dx1-197034"></a> prevents <span class="cmtt-10">\name </span>from being redefined within the document. -</p><!--l. 16599--><p class="indent" > See also the “Examples” chapter of the <a +</p><!--l. 16612--><p class="indent" > See also the “Examples” chapter of the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-197035"></a></a> user manual, which provides another “people” example. <a id="x1-197036r20"></a> -</p><!--l. 16602--><p class="noindent" > +</p><!--l. 16615--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleSort"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleSort">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleSort.tex" ><span class="cmtt-10">sampleSort.tex</span></a></h4> -<!--l. 16602--><p class="noindent" >This is another document that illustrates how to hook into the standard sort mechanism. An additional run is +<!--l. 16615--><p class="noindent" >This is another document that illustrates how to hook into the standard sort mechanism. An additional run is required to ensure the table of contents is up-to-date: -</p><!--l. 16605--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16618--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSort <br />makeglossaries sampleSort <br />pdflatex sampleSort @@ -34064,7 +33927,7 @@ href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-198002"></a></a> calls with the appropriate file extensions: -</p><!--l. 16615--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16628--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSort <br />makeindex -s sampleSort.ist -t sampleSort.alg -o sampleSort.acr sampleSort.acn <br />makeindex -s sampleSort.ist -t sampleSort.glg -o sampleSort.gls sampleSort.glo @@ -34082,22 +33945,22 @@ class="cmtt-10">makeglossaries</span><a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-198004"></a></a>. -</p><!--l. 16625--><p class="indent" > In this example, the sort hook is adjusted to ensure the list of notation is sorted according to the order of +</p><!--l. 16638--><p class="indent" > In this example, the sort hook is adjusted to ensure the list of notation is sorted according to the order of definition. A new counter is defined to keep track of the entry number: </p> - <div class="verbatim" id="verbatim-439"> + <div class="verbatim" id="verbatim-440"> \newcounter{sortcount} </div> -<!--l. 16630--><p class="nopar" > The sort hook is then redefined to increment this counter and assign the sort key to that numerical +<!--l. 16643--><p class="nopar" > The sort hook is then redefined to increment this counter and assign the sort key to that numerical value, but only for the <span class="cmtt-10">notation </span>glossary. The other two glossaries have their sort keys assigned as normal: </p> - <div class="verbatim" id="verbatim-440"> + <div class="verbatim" id="verbatim-441"> \renewcommand{\glsprestandardsort}[3]{%  <br />  \ifdefstring{#2}{notation}%  <br />  {% @@ -34109,11 +33972,11 @@ normal:  <br />  }%  <br />} </div> -<!--l. 16646--><p class="nopar" > This means that <a +<!--l. 16659--><p class="nopar" > This means that <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-198005"></a></a> will sort the notation in numerical order. -</p><!--l. 16649--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 16662--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to convert this document to use <a href="#glo:glossaries-extra"><span @@ -34137,10 +34000,10 @@ class="cmtt-10">\newabbreviation</span></span><a replace: - <div class="verbatim" id="verbatim-441"> + <div class="verbatim" id="verbatim-442"> \setacronymstyle{long-short} </div> -<!--l. 16660--><p class="nopar" > with: </p><div class="alltt"> +<!--l. 16673--><p class="nopar" > with: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor724"><span class="cmtt-10">\setabbreviationstyle</span></span><a @@ -34148,7 +34011,7 @@ class="cmtt-10">\setabbreviationstyle</span></span><a class="cmtt-10">[acronym]{long-short}</span> </div> </div> -<!--l. 16666--><p class="indent" > The custom counter and redefinition of <span +<!--l. 16679--><p class="indent" > The custom counter and redefinition of <span class="cmtt-10">\glsprestandardsort </span>can now be removed. The file extensions for the custom <span class="cmtt-10">notation </span>glossary are no longer relevant so the glossary definition can be changed to: @@ -34192,7 +34055,7 @@ class="cmtt-10">\makeglossaries</span>, must be displayed with <span class="cmtt-10">\printnoidxglossary</span><a id="dx1-198011"></a>. -<!--l. 16687--><p class="indent" > This means that <a +<!--l. 16700--><p class="indent" > This means that <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-198012"></a></a> only needs to process the <span @@ -34204,10 +34067,9 @@ class="cmtt-10">notation </span>glossary because, when used with <a class="cmtt-10">sort=def</span>, <span class="cmtt-10">\printnoidxglossary </span>simply iterates over the list of entries that have been indexed. -</p><!--l. 16693--><p class="indent" > The document build doesn’t need the third <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call now (since none of the glossaries extend beyond a +</p><!--l. 16706--><p class="indent" > The document build doesn’t need the third LaTeX call now (since none of the glossaries extend beyond a page break): -</p><!--l. 16695--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16708--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSort <br />makeglossaries sampleSort @@ -34222,27 +34084,27 @@ class="cmtt-10">makeglossaries</span><a </p> - <div class="verbatim" id="verbatim-442"> + <div class="verbatim" id="verbatim-443"> only processing subset 'main,acronym' </div> -<!--l. 16703--><p class="nopar" > This means that although <a +<!--l. 16716--><p class="nopar" > This means that although <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-198015"></a></a> has noticed the <span class="cmtt-10">notation </span>glossary, it will be skipped. -</p><!--l. 16707--><p class="indent" > If you are explicitly calling <a +</p><!--l. 16720--><p class="indent" > If you are explicitly calling <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-198016"></a></a> then you need to drop the call for the <span class="cmtt-10">notation </span>glossary: -</p><!--l. 16709--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16722--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSort <br />makeindex -s sampleSort.ist -t sampleSort.alg -o sampleSort.acr sampleSort.acn <br />makeindex -s sampleSort.ist -t sampleSort.glg -o sampleSort.gls sampleSort.glo <br />pdflatex sampleSort <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 16716--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 16729--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-198017"></a></a></span>If you prefer to use <a @@ -34267,11 +34129,11 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-198020"></a></a>. -<!--l. 16725--><p class="indent" > For this example, it’s simpler to split the entries into different files according to the glossary type. This can +<!--l. 16738--><p class="indent" > For this example, it’s simpler to split the entries into different files according to the glossary type. This can be done with the <span class="cmtt-10">--split-on-type </span>or <span class="cmtt-10">-t </span>switch: -</p><!--l. 16728--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16741--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib -t --preamble-only sampleSort.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -34405,7 +34267,7 @@ class="cmtt-10">@entry</span></span><a id="dx1-198031"></a> with <span id="textcolor735"><span class="cmtt-10">@symbol</span></span><a id="dx1-198032"></a> in this file.</dd></dl> -<!--l. 16771--><p class="noindent" ><span +<!--l. 16784--><p class="noindent" ><span class="cmti-10">After </span>the definition of the <span class="cmtt-10">notation </span>glossary (<span class="cmtt-10">\newglossary</span>), add: </p><div class="alltt"> @@ -34452,20 +34314,20 @@ class="cmtt-10">]</span> </div> </div> Delete the remainder of the preamble (<span class="cmtt-10">\makeglossaries </span>and entry definitions). -<!--l. 16783--><p class="indent" > Finally, replace the lines that display the glossaries with: </p><div class="alltt"> +<!--l. 16796--><p class="indent" > Finally, replace the lines that display the glossaries with: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor743"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-198039"></a> </div> </div> The build process is now: -<!--l. 16788--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16801--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSort <br />bib2gls sampleSort <br />pdflatex sampleSort <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 16794--><p class="indent" > In this case, I have one resource command that processes two glossaries (<span +</p><!--l. 16807--><p class="indent" > In this case, I have one resource command that processes two glossaries (<span class="cmtt-10">main </span>and <span class="cmtt-10">acronym</span>) at the same time. The entries in these glossaries are ordered alphabetically. The second resource command processes the @@ -34474,7 +34336,7 @@ class="cmtt-10">notation </span>glossary but the entries in this glossary aren&# within the <span class="cmtt-10">bib</span><a id="dx1-198040"></a> file). -</p><!--l. 16801--><p class="indent" > See also <a +</p><!--l. 16814--><p class="indent" > See also <a href="#ex:sampleNtn"><span class="cmtt-10">sampleNtn.tex</span></a>, <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span @@ -34482,26 +34344,25 @@ class="cmtt-10">bib2gls </span>gallery: sorting</a> and the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-198041"></a></a> user manual for more examples. -</p><!--l. 16804--><p class="noindent" > +</p><!--l. 16817--><p class="noindent" > </p> -<!--l. 16804--><p class="noindent" ><a +<!--l. 16817--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.6 </span> <a id="sec:samplesparent"></a>Child Entries</h3> <a id="x1-199001r21"></a> -<!--l. 16807--><p class="noindent" > +<!--l. 16820--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample.tex" ><span class="cmtt-10">sample.tex</span></a></h4> -<!--l. 16807--><p class="noindent" >This document illustrates some of the basics, including how to create child entries that use the same name as +<!--l. 16820--><p class="noindent" >This document illustrates some of the basics, including how to create child entries that use the same name as the parent entry. This example adds the glossary to the table of contents and it also uses <span class="cmtt-10">\glsrefentry</span><a id="dx1-200001"></a>, so an -extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run is required: -</p><!--l. 16812--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +extra LaTeX run is required: +</p><!--l. 16825--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample <br />makeglossaries sample <br />pdflatex sample @@ -34528,7 +34389,7 @@ class="cmtt-10">makeindex</span><a explicitly, you will need to use the <span class="cmtt-10">-l</span><a id="dx1-200006"></a> switch to indicate letter ordering.) -</p><!--l. 16825--><p class="indent" > One of the entries has its name encapsulated with a semantic command: </p><div class="alltt"> +</p><!--l. 16838--><p class="indent" > One of the entries has its name encapsulated with a semantic command: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newcommand{</span><strong><span @@ -34556,7 +34417,7 @@ href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-200009"></a></a> simply treats as punctuation). -<!--l. 16837--><p class="indent" > The homograph entries “glossary” and “bravo” are defined as sub-entries that inherit the name from the +<!--l. 16850--><p class="indent" > The homograph entries “glossary” and “bravo” are defined as sub-entries that inherit the name from the parent entry. The parent entry doesn’t have a description, but with the default <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span @@ -34566,7 +34427,7 @@ lead to a spurious dot. This can be removed by adding <span class="cmtt-10">\nopostdesc</span><a id="dx1-200011"></a> to the description, which suppresses the post-description hook for that entry. -</p><!--l. 16844--><p class="indent" > Since the child entries have the same name as the parent, this means that the child entries will have +</p><!--l. 16857--><p class="indent" > Since the child entries have the same name as the parent, this means that the child entries will have duplicate sort values unless the default is changed with the <span class="cmtt-10">sort</span><a id="dx1-200012"></a> key: </p><div class="alltt"> @@ -34621,7 +34482,7 @@ class="cmtt-10">glossarylist </span>before <span class="cmtt-10">glossarycol</span>, but both will come immediately after their parent <span class="cmtt-10">glossary </span>entry. -<!--l. 16867--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 16880--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you switch to using <a href="#glo:glossaries-extra"><span @@ -34643,19 +34504,19 @@ class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 16875--><p class="indent" > You may now want to consider replacing <span +<!--l. 16888--><p class="indent" > You may now want to consider replacing <span class="cmtt-10">\nopostdesc</span><a id="dx1-200015"></a> in the descriptions with <span id="textcolor746"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a id="dx1-200016"></a> (using your text editor’s search and replace function). This suppresses the post-description punctuation but not the category post-description hook. -</p><!--l. 16881--><p class="indent" > You may have noticed that some of the descriptions include the plural form, but it’s not done very +</p><!--l. 16894--><p class="indent" > You may have noticed that some of the descriptions include the plural form, but it’s not done very consistently. For example: </p> - <div class="verbatim" id="verbatim-443"> + <div class="verbatim" id="verbatim-444"> \newglossaryentry{cow}{name=cow,  <br />  plural=cows,% not required as this is the default  <br />  user1=kine, @@ -34663,47 +34524,47 @@ consistently. For example:  <br />female of any bovine animal}  <br />} </div> -<!--l. 16890--><p class="nopar" > which has the parenthetical material at the start of the description with emphasis, +<!--l. 16903--><p class="nopar" > which has the parenthetical material at the start of the description with emphasis, </p> - <div class="verbatim" id="verbatim-444"> + <div class="verbatim" id="verbatim-445"> \newglossaryentry{bravocry}{  <br />  description={cry of approval (pl.\ bravos)},  <br />  sort={1},  <br />  parent={bravo}  <br />} </div> -<!--l. 16899--><p class="nopar" > which has the parenthetical material at the end of the description without emphasis even though it’s a regular +<!--l. 16912--><p class="nopar" > which has the parenthetical material at the end of the description without emphasis even though it’s a regular plural, </p> - <div class="verbatim" id="verbatim-445"> + <div class="verbatim" id="verbatim-446"> \newglossaryentry{bravoruffian}{  <br />  description={hired ruffian or killer (pl.\ bravoes)},  <br />  sort={2},  <br />  plural={bravoes},  <br />  parent=bravo} </div> -<!--l. 16908--><p class="nopar" > which has the parenthetical material at the end of the description without emphasis, and +<!--l. 16921--><p class="nopar" > which has the parenthetical material at the end of the description without emphasis, and </p> - <div class="verbatim" id="verbatim-446"> + <div class="verbatim" id="verbatim-447"> \newglossaryentry{glossary}{name=glossary,  <br />  description={\nopostdesc},  <br />  plural={glossaries}} </div> -<!--l. 16915--><p class="nopar" > which doesn’t show the plural in the description. -</p><!--l. 16918--><p class="indent" > With <a +<!--l. 16928--><p class="nopar" > which doesn’t show the plural in the description. +</p><!--l. 16931--><p class="indent" > With <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, you can remove this parenthetical material and implement it using the category post-description hook instead. For example, the above definitions become: </p> - <div class="verbatim" id="verbatim-447"> + <div class="verbatim" id="verbatim-448"> \newglossaryentry{cow}{name=cow,  <br />  user1=kine,  <br />  description={an adult female of any bovine animal} @@ -34719,7 +34580,7 @@ post-description hook instead. For example, the above definitions become:  <br />  plural={bravoes},  <br />  parent=bravo} </div> -<!--l. 16938--><p class="nopar" > </p><div class="alltt"> +<!--l. 16951--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{glossary}{name=glossary,</span> @@ -35007,14 +34868,14 @@ class="cmss-10">glossaries-extra</span></a> user manual for further details and href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf" ><span class="cmss-10">glossaries-extra </span>and <span class="cmtt-10">bib2gls</span>: An Introductory Guide</a>. -<!--l. 16985--><p class="indent" > The “bravo” homographs are an oddity where the singular form is identical but the plural is different +<!--l. 16998--><p class="indent" > The “bravo” homographs are an oddity where the singular form is identical but the plural is different (“bravos” and “bravoes”). In the original, both descriptions included the plural term. The above modifications drop the display of the regular “bravos” plural (for the <span class="cmtt-10">bravocry </span>term) and only show the “bravoes” plural (for the <span class="cmtt-10">bravoruffian </span>term). In this particular case it might be useful to show the regular plural in order to highlight the difference. -</p><!--l. 16994--><p class="indent" > While it’s straightforward to access an entry’s parent label (with <span +</p><!--l. 17007--><p class="indent" > While it’s straightforward to access an entry’s parent label (with <span class="cmtt-10">\glsentryparent</span><a id="dx1-200035"></a>) it’s much harder to access entry’s children or siblings. The <span @@ -35023,7 +34884,7 @@ class="cmtt-10">\ifglshaschildren</span><a if any have a parent that matches the given label. This is obviously very time-consuming if you have a large database of entries. It also doesn’t provide a way of determining whether or not the child entries have been indexed. -</p><!--l. 17002--><p class="indent" > With <a +</p><!--l. 17015--><p class="indent" > With <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-200037"></a></a>, it’s possible to save this information with the <span id="textcolor754"><span @@ -35036,7 +34897,7 @@ class="cmss-10">etoolbox</span><a id="dx1-200040"></a> internal list. This makes the information much faster to access and also only includes the labels of those entries that have actually been indexed. -</p><!--l. 17009--><p class="indent" > In the above, the comment line: </p><div class="alltt"> +</p><!--l. 17022--><p class="indent" > In the above, the comment line: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmti-10">%</span><span @@ -35171,20 +35032,20 @@ class="cmtt-10">plural</span><a id="dx1-200052"></a> field. If they are the same, it does nothing. If they are different, it displays the current entry’s plural and breaks the loop. -<!--l. 17045--><p class="indent" > Note that this assumes that the parent entry hasn’t had the plural form explicitly set to “bravoes” instead of +<!--l. 17058--><p class="indent" > Note that this assumes that the parent entry hasn’t had the plural form explicitly set to “bravoes” instead of the default “bravos”. In that case, the parent entry would show the plural but the <span class="cmtt-10">bravoruffian </span>child entry wouldn’t show the plural (since this case would led to the empty code block identified with the comment “child and parent plurals the same”). The “bravoes” plural form would instead be shown for the parent, which wouldn’t look right. -</p><!--l. 17054--><p class="indent" > If you don’t use <a +</p><!--l. 17067--><p class="indent" > If you don’t use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-200053"></a></a> or if you use it without the <span id="textcolor762"><span class="cmtt-10">save-sibling-count</span></span><a id="dx1-200054"></a> resource option then the sibling information won’t be available. -</p><!--l. 17058--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 17071--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-200055"></a></a></span>In order to switch to using <a @@ -35237,7 +35098,7 @@ class="cmtt-10">@preamble</span></span><a class="cmtt-10">{"\providecommand{\scriptlang}[1]{\textsf{#1}}"}</span> </div> </div> -<!--l. 17078--><p class="indent" > The <span +<!--l. 17091--><p class="indent" > The <span class="cmtt-10">sort</span><a id="dx1-200063"></a> field typically shouldn’t be set when using <a href="#glo:bib2gls"><span @@ -35262,7 +35123,7 @@ class="cmtt-10">name</span><a <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a> for other examples). -</p><!--l. 17086--><p class="indent" > Therefore the “Perl” entry is simply defined as: </p><div class="alltt"> +</p><!--l. 17099--><p class="indent" > Therefore the “Perl” entry is simply defined as: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor769"><span class="cmtt-10">@entry</span></span><a @@ -35305,7 +35166,7 @@ class="cmtt-10">xindy</span><a id="dx1-200077"></a></a> does) so the sort value will still end up as <span class="cmtt-10">Perl</span>. -<!--l. 17100--><p class="indent" > The homograph entries have also had their <span +<!--l. 17113--><p class="indent" > The homograph entries have also had their <span class="cmtt-10">sort</span><a id="dx1-200078"></a> fields omitted: </p><div class="alltt"> <div class="obeylines-v"> @@ -35351,7 +35212,7 @@ class="cmtt-10">}</span> </div> -<!--l. 17113--><p class="indent" > This means that the sort value for both these child entries is “glossary”. When <a +<!--l. 17126--><p class="indent" > This means that the sort value for both these child entries is “glossary”. When <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-200081"></a></a> encounters identical @@ -35390,20 +35251,20 @@ class="cmtt-10">\makeglossaries</span>. If you want the sibling information (see need to remember to add <span id="textcolor778"><span class="cmtt-10">save-sibling-count</span></span><a id="dx1-200088"></a> to the list of options. -<!--l. 17130--><p class="indent" > Note that this is a better solution than in the original example. If I edit the document so that <span +<!--l. 17143--><p class="indent" > Note that this is a better solution than in the original example. If I edit the document so that <span class="cmtt-10">glossarycol</span> is used first, then the ordering will be updated accordingly, but with the original example, the <span class="cmtt-10">sort</span><a id="dx1-200089"></a> keys would need to be manually changed. -</p><!--l. 17135--><p class="indent" > The remainder of the preamble (that is, the definition of <span +</p><!--l. 17148--><p class="indent" > The remainder of the preamble (that is, the definition of <span class="cmtt-10">\scriptlang </span>and all the entry definitions) should now be removed. -</p><!--l. 17139--><p class="indent" > Finally, replace <span +</p><!--l. 17152--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossaries </span>with <span id="textcolor779"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-200090"></a>. The document build is now: -</p><!--l. 17141--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17154--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample <br />bib2gls --group sample <br />pdflatex sample @@ -35417,11 +35278,10 @@ class="cmtt-10">-g</span></span><a id="dx1-200092"></a>) switch, which is needed to support the <span class="cmss-10">treenonamegroup</span><a id="dx1-200093"></a> style. The third -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call is needed because the document contains <span +LaTeX call is needed because the document contains <span class="cmtt-10">\glsrefentry</span><a id="dx1-200094"></a>. -</p><!--l. 17151--><p class="indent" > Note that you can’t use the <span +</p><!--l. 17164--><p class="indent" > Note that you can’t use the <span class="cmss-10">order</span><span class="cmtt-10">=</span><span class="cmss-10">letter</span><a @@ -35454,20 +35314,20 @@ class="cmtt-10">]</span> </div> <a id="x1-200100r22"></a> -<!--l. 17160--><p class="noindent" > +<!--l. 17173--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-inline"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-inline">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-inline.tex" ><span class="cmtt-10">sample-inline.tex</span></a></h4> -<!--l. 17160--><p class="noindent" >This document is like <span +<!--l. 17173--><p class="noindent" >This document is like <span class="cmtt-10">sample.tex</span>, above, but uses the <span class="cmss-10">inline</span><a id="dx1-201001"></a> glossary style to put the glossary in a footnote. The document build is: -</p><!--l. 17164--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17177--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-inline <br />makeglossaries sample-inline <br />pdflatex sample-inline @@ -35485,15 +35345,15 @@ class="cmtt-10">--group</span></span><a id="dx1-201003"></a> switch since no letter groups are required. <a id="x1-201004r23"></a> -</p><!--l. 17175--><p class="noindent" > +</p><!--l. 17188--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampletree"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampletree">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampletree.tex" ><span class="cmtt-10">sampletree.tex</span></a></h4> -<!--l. 17175--><p class="noindent" >This document illustrates a hierarchical glossary structure where child entries have different names to their +<!--l. 17188--><p class="noindent" >This document illustrates a hierarchical glossary structure where child entries have different names to their corresponding parent entry. To create the document do: -</p><!--l. 17179--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17192--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampletree <br />makeglossaries sampletree <br />pdflatex sampletree @@ -35508,11 +35368,11 @@ class="cmtt-10">\glssetwidest</span><a </p> - <div class="verbatim" id="verbatim-448"> + <div class="verbatim" id="verbatim-449"> \glssetwidest{Roman letters} % level 0 widest name  <br />\glssetwidest[1]{Sigma}      % level 1 widest name </div> -<!--l. 17191--><p class="nopar" > (Level 0 is the top-most level. That is, entries that don’t have a parent.) It’s possible to get <span +<!--l. 17204--><p class="nopar" > (Level 0 is the top-most level. That is, entries that don’t have a parent.) It’s possible to get <span class="cmss-10">glossaries </span>to compute the widest top-level entry with <span class="cmtt-10">\glsfindwidesttoplevelname</span><a @@ -35520,7 +35380,7 @@ class="cmtt-10">\glsfindwidesttoplevelname</span><a entries, regardless of whether or not they appear in the glossary. If you have a large database of entries, this will firstly take time and secondly the width may be too large due to an unindexed entry with a big name. -</p><!--l. 17200--><p class="indent" > This sample document doesn’t require any of the tabular styles so I’ve prevented those packages from being +</p><!--l. 17213--><p class="indent" > This sample document doesn’t require any of the tabular styles so I’ve prevented those packages from being loaded with <span class="cmss-10">nolong</span><a id="dx1-202004"></a> and <span @@ -35538,7 +35398,7 @@ class="cmtt-10">{glossaries}</span> class="cmss-10">glossary-topic</span></span><a id="dx1-202006"></a>, see below.) -<!--l. 17210--><p class="indent" > This is obviously a contrived example since it’s strange to have the symbol names (such as “Sigma”) in the +<!--l. 17223--><p class="indent" > This is obviously a contrived example since it’s strange to have the symbol names (such as “Sigma”) in the glossary. The purpose is to demonstrate the <span class="cmss-10">alttreehypergroup</span><a id="dx1-202007"></a> with an entry that’s noticeably wider than the @@ -35546,7 +35406,7 @@ others in the same hierarchical level. A more sensible document would have the s class="cmtt-10">name</span><a id="dx1-202008"></a> key. -</p><!--l. 17217--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 17230--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to switch to <a href="#glo:glossaries-extra"><span @@ -35592,13 +35452,13 @@ class="cmtt-10">\glsFindWidestUsedLevelTwo</span></span><a </div> </div> This will only take into account the entries that have actually been used in the document, but it can still be time-consuming if you have a large number of entries. -<!--l. 17240--><p class="indent" > <div class="important" title="Important Note"> Note that the glossary must be at the end of the document (after all required entries have been used) with +<!--l. 17253--><p class="indent" > <div class="important" title="Important Note"> Note that the glossary must be at the end of the document (after all required entries have been used) with this method. The alternative is to perform the calculation at the end of the document and save the results in the <span class="cmtt-10">aux</span><a id="dx1-202016"></a> file for the next run. </div> -</p><!--l. 17245--><p class="noindent" > -</p><!--l. 17247--><p class="indent" > This example document is using top-level entries for topics without descriptions. This means that the +</p><!--l. 17258--><p class="noindent" > +</p><!--l. 17260--><p class="indent" > This example document is using top-level entries for topics without descriptions. This means that the descriptions simply contain <span class="cmtt-10">\nopostdesc</span><a id="dx1-202017"></a> to prevent the post-description punctuation from being automatically @@ -35606,18 +35466,18 @@ inserted. For example: </p> - <div class="verbatim" id="verbatim-449"> + <div class="verbatim" id="verbatim-450"> \newglossaryentry{greekletter}{name={Greek letters},  <br />text={Greek letter},  <br />description={\nopostdesc}} </div> -<!--l. 17255--><p class="nopar" > With <a +<!--l. 17268--><p class="nopar" > With <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, you can convert this to <span id="textcolor795"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a id="dx1-202018"></a> which will prevent the post-description punctuation without interfering with the category post-description hook. -</p><!--l. 17261--><p class="indent" > In order to distinguish between the child entries, which are symbols, and the parent entries, which are topics, +</p><!--l. 17274--><p class="indent" > In order to distinguish between the child entries, which are symbols, and the parent entries, which are topics, it’s useful to give these two different types of entries different categories. The topics can use the default <span id="textcolor796"><span class="cmss-10">general</span></span><a id="dx1-202019"></a> @@ -35638,20 +35498,20 @@ class="cmtt-10">=symbol,</span></strong> class="cmtt-10">parent=romanletter}</span> </div> </div> -<!--l. 17274--><p class="indent" > There is some redundancy caused by a parenthetical note after the <a +<!--l. 17287--><p class="indent" > There is some redundancy caused by a parenthetical note after the <a href="#glo:firstuse">first use</a> in some of the symbol entries. For example: </p> - <div class="verbatim" id="verbatim-450"> + <div class="verbatim" id="verbatim-451"> \newglossaryentry{pi}{name={pi},  <br />text={\ensuremath{\pi}},  <br />first={\ensuremath{\pi} (lowercase pi)},  <br />description={Transcendental number},  <br />parent=greekletter} </div> -<!--l. 17282--><p class="nopar" > With <a +<!--l. 17295--><p class="nopar" > With <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> this can be dealt with through the category post-link hook: </p><div class="alltt"> <div class="obeylines-v"> @@ -35742,7 +35602,7 @@ class="cmtt-10">category</span></span><a id="dx1-202030"></a></span> set to <span id="textcolor806"><span class="cmss-10">symbol</span></span><a id="dx1-202031"></a>. -<!--l. 17312--><p class="indent" > With <a +<!--l. 17325--><p class="indent" > With <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, it’s now possible to use the topic styles provided with the <span id="textcolor807"><span class="cmss-10">glossary-topic</span></span><a @@ -35821,18 +35681,18 @@ class="cmss-10">topic</span></span><a <span class="cmss-10">alttree</span><a id="dx1-202046"></a>. -<!--l. 17340--><p class="indent" > Since there’s no description for the top-level entries, the <span id="textcolor815"><span +<!--l. 17353--><p class="indent" > Since there’s no description for the top-level entries, the <span id="textcolor815"><span class="cmss-10">topic</span></span><a id="dx1-202047"></a> style ignores the widest name setting for the top-level, so I can just have the level 1 setting: </p> - <div class="verbatim" id="verbatim-451"> + <div class="verbatim" id="verbatim-452"> \glssetwidest[1]{Sigma} </div> -<!--l. 17345--><p class="nopar" > -</p><!--l. 17347--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 17358--><p class="nopar" > +</p><!--l. 17360--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-202048"></a></a></span>If you want to convert this document so that it uses <a @@ -35866,7 +35726,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-202052"></a></a>: -<!--l. 17358--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17371--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only sampletree.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -35892,7 +35752,7 @@ class="cmtt-10">bib2gls</span><a this if it can correctly interpret any commands contained in the <span class="cmtt-10">name</span><a id="dx1-202057"></a> field.) -<!--l. 17370--><p class="indent" > This means that the <span +<!--l. 17383--><p class="indent" > This means that the <span class="cmtt-10">\glssetwidest</span><a id="dx1-202058"></a> commands can now be removed completely. All the <span class="cmtt-10">\newglossaryentry</span> @@ -35901,13 +35761,13 @@ class="cmtt-10">\printunsrtglossaries </span>needs to be replaced with <span id="textcolor824"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-202059"></a>. The document build is now: -</p><!--l. 17374--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17387--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampletree <br />bib2gls sampletree <br />pdflatex sampletree <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 17380--><p class="indent" > This produces the same result as with just <a +</p><!--l. 17393--><p class="indent" > This produces the same result as with just <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> and <a href="#glo:makeglossaries"><span @@ -35916,7 +35776,7 @@ class="cmtt-10">makeglossaries</span><a modifications that can be made to the <span class="cmtt-10">bib</span><a id="dx1-202061"></a> file to make it neater. -</p><!--l. 17384--><p class="indent" > The top-level entries are defined as: </p><div class="alltt"> +</p><!--l. 17397--><p class="indent" > The top-level entries are defined as: </p><div class="alltt"> <div class="obeylines-v"> @@ -36015,7 +35875,7 @@ class="cmtt-10">plural</span><a class="cmtt-10">text</span><a id="dx1-202072"></a> field. -<!--l. 17416--><p class="indent" > Now let’s assume that the symbol entries are defined in a more rational manner, with the actual symbol in +<!--l. 17429--><p class="indent" > Now let’s assume that the symbol entries are defined in a more rational manner, with the actual symbol in the <span class="cmtt-10">name</span><a id="dx1-202073"></a> field. For example: </p><div class="alltt"> @@ -36092,7 +35952,7 @@ class="cmtt-10">}</span> class="cmtt-10">\glsdefpostdesc</span></span><a id="dx1-202076"></a>) should now be removed from the document. -<!--l. 17438--><p class="indent" > If you make these changes and rebuild the document, you’ll find that the order has changed. Now the <span +<!--l. 17451--><p class="indent" > If you make these changes and rebuild the document, you’ll find that the order has changed. Now the <span class="cmtt-10">sigma</span> entry is before the <span class="cmtt-10">pi </span>entry. This is because <a @@ -36114,7 +35974,7 @@ class="cmtt-10">\Sigma</span><a class="cmtt-10">\pi</span><a id="dx1-202082"></a> and converts them to the Unicode characters 0x1D6F4 and 0x1D70B). -</p><!--l. 17447--><p class="indent" > If you change <span id="textcolor835"><span +</p><!--l. 17460--><p class="indent" > If you change <span id="textcolor835"><span class="cmtt-10">@entry</span></span><a id="dx1-202083"></a> to <span id="textcolor836"><span class="cmtt-10">@symbol</span></span><a @@ -36134,7 +35994,7 @@ class="cmtt-10">sort</span><a <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a>.) -</p><!--l. 17455--><p class="indent" > You can further tidy the <span +</p><!--l. 17468--><p class="indent" > You can further tidy the <span class="cmtt-10">bib</span><a id="dx1-202089"></a> file by removing the <span id="textcolor838"><span id="textcolor839"><span class="cmtt-10">category</span></span><a @@ -36205,7 +36065,7 @@ class="cmtt-10">indexplural</span>. (Only the <span id="textcolor853"><span class="cmss-10">symbol</span></span><a id="dx1-202099"></a> category is significant in this example.) -<!--l. 17475--><p class="indent" > You can make the <span +<!--l. 17488--><p class="indent" > You can make the <span class="cmtt-10">bib</span><a id="dx1-202100"></a> files even more flexible by introducing field and entry aliases with <span id="textcolor854"><span class="cmtt-10">field-aliases</span></span><a @@ -36216,23 +36076,23 @@ class="cmtt-10">entry-type-aliases</span></span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-202103"></a></a> manual for further details. -</p><!--l. 17480--><p class="noindent" > +</p><!--l. 17493--><p class="noindent" > </p> -<!--l. 17480--><p class="noindent" ><a +<!--l. 17493--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.7 </span> <a id="sec:samplescrossref"></a>Cross-Referencing</h3> <a id="x1-203001r24"></a> -<!--l. 17483--><p class="noindent" > +<!--l. 17496--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-crossref"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-crossref">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-crossref.tex" ><span class="cmtt-10">sample-crossref.tex</span></a></h4> -<!--l. 17484--><p class="noindent" >This document illustrates how to cross-reference entries in the glossary. -</p><!--l. 17486--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17497--><p class="noindent" >This document illustrates how to cross-reference entries in the glossary. +</p><!--l. 17499--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-crossref <br />makeglossaries sample-crossref <br />pdflatex sample-crossref @@ -36245,10 +36105,10 @@ appropriate (usually within a language hook): </p> - <div class="verbatim" id="verbatim-452"> + <div class="verbatim" id="verbatim-453"> \providecommand{\alsoname}{see also} </div> -<!--l. 17495--><p class="nopar" > I’ve used <span +<!--l. 17508--><p class="nopar" > I’ve used <span class="cmtt-10">\providecommand </span>as some packages define this command. This is used to create a “see also” cross-reference with the <span class="cmtt-10">see</span><a @@ -36256,15 +36116,15 @@ class="cmtt-10">see</span><a </p> - <div class="verbatim" id="verbatim-453"> + <div class="verbatim" id="verbatim-454"> \newglossaryentry{apple}{name=apple,description={firm, round fruit},  <br />see=[\alsoname]{pear}}  <br />\newglossaryentry{marrow}{name={marrow},  <br /> description={long vegetable with thin green skin and white flesh},  <br /> see={[\alsoname]courgette}} </div> -<!--l. 17506--><p class="nopar" > -</p><!--l. 17508--><p class="indent" > Note that “marrow” is included in the glossary even though it hasn’t been referenced in the text. This is +<!--l. 17519--><p class="nopar" > +</p><!--l. 17521--><p class="indent" > Note that “marrow” is included in the glossary even though it hasn’t been referenced in the text. This is because the <span class="cmtt-10">see</span><a id="dx1-204003"></a> key automatically triggers <span @@ -36276,7 +36136,7 @@ used in a particular document. In that case, you may want to consider using <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> (see below). -</p><!--l. 17518--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 17531--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>This example is quite simple to convert to <a href="#glo:glossaries-extra"><span @@ -36291,7 +36151,7 @@ class="cmss-10">postdot</span></span><a <span id="textcolor857"><span class="cmss-10">stylemods</span></span><a id="dx1-204007"></a> option. -</p><!--l. 17524--><p class="indent" > In order to prevent the “marrow” entry from being automatically being added to the glossary as a result of +</p><!--l. 17537--><p class="indent" > In order to prevent the “marrow” entry from being automatically being added to the glossary as a result of the cross-reference, you can use <span id="textcolor858"><span class="cmss-10">autoseeindex</span><span class="cmtt-10">=</span><span @@ -36319,13 +36179,13 @@ class="cmtt-10">]{glossaries-extra}</span> </div> </div> The document build is the same, but now the “marrow” and “zucchini” entries aren’t present in the document. -<!--l. 17536--><p class="indent" > Note that the “fruit” entry is still included even though it hasn’t been used in the document. This is because +<!--l. 17549--><p class="indent" > Note that the “fruit” entry is still included even though it hasn’t been used in the document. This is because it was explicitly indexed with <span class="cmtt-10">\glssee</span><a id="dx1-204011"></a> not via the <span class="cmtt-10">see</span><a id="dx1-204012"></a> key. -</p><!--l. 17540--><p class="indent" > The entries that contains <span +</p><!--l. 17553--><p class="indent" > The entries that contains <span class="cmtt-10">see=[\alsoname] </span>can be converted to use the <span id="textcolor864"><span id="textcolor865"><span class="cmtt-10">seealso</span></span><a id="dx1-204013"></a></span> key: </p><div class="alltt"> @@ -36361,7 +36221,7 @@ class="cmtt-10">}</span> </div> </div> (The provided <span class="cmtt-10">\alsoname </span>definition may be removed.) -<!--l. 17552--><p class="indent" > The original example redefines the cross-referencing format to use <a +<!--l. 17565--><p class="indent" > The original example redefines the cross-referencing format to use <a href="#glo:smallcaps">small caps<a id="dx1-204014"></a></a>: </p><div class="alltt"> <div class="obeylines-v"> @@ -36380,7 +36240,7 @@ href="#ex:sampleAcrDesc"><span class="cmtt-10">sampleAcrDesc.tex</span></a>, this redefinition isn’t necessary if you have at least <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> v1.42. -<!--l. 17562--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 17575--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-204017"></a></a></span>If you want to switch to <a @@ -36413,7 +36273,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-204022"></a></a>. -<!--l. 17572--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17585--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib sample-crossref.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -36425,10 +36285,10 @@ by: </p> - <div class="verbatim" id="verbatim-454"> + <div class="verbatim" id="verbatim-455"> \glssee{fruit}{pear,apple,banana} </div> -<!--l. 17579--><p class="nopar" > into the <span +<!--l. 17592--><p class="nopar" > into the <span class="cmtt-10">fruit </span>definition: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor873"><span @@ -36476,7 +36336,7 @@ class="cmtt-10">=entries.bib]</span> class="cmtt-10">\printglossaries </span>with <span id="textcolor876"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-204027"></a>. The document build is now: -<!--l. 17595--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17608--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-crossref <br />bib2gls sample-crossref <br />pdflatex sample-crossref @@ -36484,7 +36344,7 @@ class="cmtt-10">\printunsrtglossaries</span></span><a <br /></span> The glossary now contains: apple, banana, courgette and pear. Note that it doesn’t contain fruit, zucchini or marrow. -</p><!--l. 17603--><p class="indent" > Now change the selection criteria: </p><div class="alltt"> +</p><!--l. 17616--><p class="indent" > Now change the selection criteria: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor877"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a @@ -36504,7 +36364,7 @@ class="cmtt-10"> see}</span></strong><span class="cmtt-10">]</span> </div> </div> The glossary now includes fruit, zucchini and marrow. -<!--l. 17610--><p class="indent" > The fruit and zucchini use the <span +<!--l. 17623--><p class="indent" > The fruit and zucchini use the <span class="cmtt-10">see</span><a id="dx1-204030"></a> key which is a simple redirection for the reader. There’s no <a href="#glo:numberlist">number list<a @@ -36516,7 +36376,7 @@ supplement to a <a href="#glo:numberlist">number list<a id="dx1-204033"></a></a> but in this case there are no locations as marrow hasn’t been used in the text. -</p><!--l. 17617--><p class="indent" > With at least v2.0, there’s an alternative: </p><div class="alltt"> +</p><!--l. 17630--><p class="indent" > With at least v2.0, there’s an alternative: </p><div class="alltt"> <div class="obeylines-v"> @@ -36541,20 +36401,20 @@ class="cmtt-10"> also</span></strong><span class="cmtt-10">}]</span> </div> </div> In this case, the glossary includes fruit and zucchini but not marrow. -<!--l. 17625--><p class="noindent" > +<!--l. 17638--><p class="noindent" > </p> -<!--l. 17625--><p class="noindent" ><a +<!--l. 17638--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.8 </span> <a id="sec:samplescustomkeys"></a>Custom Keys</h3> <a id="x1-205001r25"></a> -<!--l. 17628--><p class="noindent" > +<!--l. 17641--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-newkeys"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-newkeys">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-newkeys.tex" ><span class="cmtt-10">sample-newkeys.tex</span></a></h4> -<!--l. 17628--><p class="noindent" >This document illustrates how add custom keys (using <span +<!--l. 17641--><p class="noindent" >This document illustrates how add custom keys (using <span class="cmtt-10">\glsaddkey</span><a id="dx1-206001"></a>). There are two custom keys <span class="cmtt-10">ed</span>, where the @@ -36570,11 +36430,11 @@ class="cmtt-10">text</span><a class="cmtt-10">\glsaddkey*</span> is required to ensure that the default value is expanded on definition if no alternative has been provided. -</p><!--l. 17637--><p class="indent" > The entries are then defined as follows: +</p><!--l. 17650--><p class="indent" > The entries are then defined as follows: </p> - <div class="verbatim" id="verbatim-455"> + <div class="verbatim" id="verbatim-456"> \newglossaryentry{jump}{name={jump},description={}}  <br />\newglossaryentry{run}{name={run},%  <br /> ed={ran},% @@ -36585,31 +36445,31 @@ provided.  <br /> ing={waddling},%  <br /> description={}} </div> -<!--l. 17650--><p class="nopar" > -</p><!--l. 17652--><p class="indent" > Each custom key is provided a set of commands analogous to <span +<!--l. 17663--><p class="nopar" > +</p><!--l. 17665--><p class="indent" > Each custom key is provided a set of commands analogous to <span class="cmtt-10">\glsentrytext</span>, that allows the key value to be accessed, and <span class="cmtt-10">\glstext </span>that allows the key value to be access with indexing and hyperlinking (where applicable). -</p><!--l. 17657--><p class="indent" > If you find yourself wanting to create a lot of custom keys that produce minor variations of existing keys +</p><!--l. 17670--><p class="indent" > If you find yourself wanting to create a lot of custom keys that produce minor variations of existing keys (such as different tenses) you may find it simpler to just use <span class="cmtt-10">\glsdisp</span>. When editing the document source, it’s usually simpler to read: </p> - <div class="verbatim" id="verbatim-456"> + <div class="verbatim" id="verbatim-457"> The dog \glsdisp{jump}{jumped} over the duck. </div> -<!--l. 17663--><p class="nopar" > than +<!--l. 17676--><p class="nopar" > than </p> - <div class="verbatim" id="verbatim-457"> + <div class="verbatim" id="verbatim-458"> The dog \glsed{jump} over the duck. </div> -<!--l. 17667--><p class="nopar" > -</p><!--l. 17669--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 17680--><p class="nopar" > +</p><!--l. 17682--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-206005"></a></a></span>If you want to convert this document to use <a @@ -36634,7 +36494,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-206009"></a></a>: -<!--l. 17678--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17691--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --index-conversion --preamble-only sample-newkeys.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -36726,8 +36586,8 @@ class="cmtt-10">\newglossaryentry </span>commands. Finally replace <span class="cmtt-10">\printglossaries </span>with <span id="textcolor895"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-206019"></a>. -<!--l. 17710--><p class="indent" > The document build is now: -</p><!--l. 17711--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17723--><p class="indent" > The document build is now: +</p><!--l. 17724--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-newkeys <br />bib2gls sample-newkeys <br />pdflatex sample-newkeys @@ -36743,22 +36603,22 @@ class="cmtt-10">--group</span> switch. <a id="x1-206022r26"></a> -</p><!--l. 17720--><p class="noindent" > +</p><!--l. 17733--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-storage-abbr"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-storage-abbr">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-storage-abbr.tex" ><span class="cmtt-10">sample-storage-abbr.tex</span></a></h4> -<!--l. 17720--><p class="noindent" >This document illustrates how add custom storage keys (using <span +<!--l. 17733--><p class="noindent" >This document illustrates how add custom storage keys (using <span class="cmtt-10">\glsaddstoragekey</span>). The document build is: -</p><!--l. 17722--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17735--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-storage-abbr <br />makeglossaries sample-storage-abbr <br />pdflatex sample-storage-abbr <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 17728--><p class="indent" > The custom storage key is called <span +</p><!--l. 17741--><p class="indent" > The custom storage key is called <span class="cmtt-10">abbrtype </span>which defaults to <span class="cmtt-10">word </span>if not explicitly set. Its value can be accessed with the provided custom command <span @@ -36772,7 +36632,7 @@ class="cmtt-10">{abbrtype}{word}{\abbrtype}</span> </div> A custom abbreviation style is then defined that checks the value of this key and makes certain adjustments depending on whether or not its value is the default <span class="cmtt-10">word</span>. -<!--l. 17738--><p class="indent" > This essentially forms a very similar function to the <a +<!--l. 17751--><p class="indent" > This essentially forms a very similar function to the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package’s <span id="textcolor896"><span id="textcolor897"><span class="cmtt-10">category</span></span><a @@ -36786,7 +36646,7 @@ class="cmtt-10">\glscategory</span></span><a class="cmtt-10">}</span> </div> </div> -<!--l. 17745--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 17758--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>This document is much simpler with the <a href="#glo:glossaries-extra"><span @@ -36881,22 +36741,22 @@ class="cmtt-10">\end{document}</span> </div> <a id="x1-207010r27"></a> -<!--l. 17774--><p class="noindent" > +<!--l. 17787--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-storage-abbr-desc"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-storage-abbr-desc">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-storage-abbr-desc.tex" ><span class="cmtt-10">sample-storage-abbr-desc.tex</span></a></h4> -<!--l. 17774--><p class="noindent" >An extension of the previous example where the user needs to provide a description. +<!--l. 17787--><p class="noindent" >An extension of the previous example where the user needs to provide a description. <a id="x1-208001r28"></a> -</p><!--l. 17777--><p class="noindent" > +</p><!--l. 17790--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-chap-hyperfirst"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-chap-hyperfirst">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-chap-hyperfirst.tex" ><span class="cmtt-10">sample-chap-hyperfirst.tex</span></a></h4> -<!--l. 17777--><p class="noindent" >This document illustrates how to add a custom key using <span +<!--l. 17790--><p class="noindent" >This document illustrates how to add a custom key using <span class="cmtt-10">\glsaddstoragekey </span>and hook into the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> and @@ -36904,7 +36764,7 @@ class="cmtt-10">\gls</span>-like</a> and href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> mechanism used to determine whether or not to hyperlink an entry. The document build is: -</p><!--l. 17782--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17795--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-chap-hyperfirst @@ -36970,7 +36830,7 @@ existence of the field. The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides utility commands designed to work on internal fields that don’t have an associated key and may not have had a value assigned. -<!--l. 17815--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 17828--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to switch to <a href="#glo:glossaries-extra"><span @@ -37034,12 +36894,12 @@ class="cmtt-10">}</span> </div> </div> The field name is still called <span class="cmtt-10">chapter </span>but there’s no longer an associated key or command. -<!--l. 17838--><p class="noindent" > +<!--l. 17851--><p class="noindent" > </p> -<!--l. 17838--><p class="noindent" ><a +<!--l. 17851--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.9 </span> <a id="sec:samplesxindy"></a>Xindy (Option 3)</h3> -<!--l. 17841--><p class="noindent" >Most of the earlier <a +<!--l. 17854--><p class="noindent" >Most of the earlier <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-210001"></a></a> sample files can be adapted to use <a @@ -37065,13 +36925,13 @@ class="cmtt-10">makeindex</span><a id="dx1-210007"></a></a>. <a id="x1-210008r29"></a> -</p><!--l. 17850--><p class="noindent" > +</p><!--l. 17863--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:samplexdy"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:samplexdy">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/samplexdy.tex" ><span class="cmtt-10">samplexdy.tex</span></a></h4> -<!--l. 17850--><p class="noindent" >The document uses UTF8 encoding (with the <span +<!--l. 17863--><p class="noindent" >The document uses UTF8 encoding (with the <span class="cmss-10">inputenc</span><a id="dx1-211001"></a> package). This is information that needs to be passed to <a @@ -37083,7 +36943,7 @@ class="cmtt-10">makeglossaries</span><a id="dx1-211003"></a></a> from the <span class="cmtt-10">aux</span><a id="dx1-211004"></a> file. -</p><!--l. 17855--><p class="indent" > By default, this document will create a <a +</p><!--l. 17868--><p class="indent" > By default, this document will create a <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-211005"></a></a> style file called <span @@ -37092,12 +36952,12 @@ lines </p> - <div class="verbatim" id="verbatim-458"> + <div class="verbatim" id="verbatim-459"> \setStyleFile{samplexdy-mc}  <br />\noist  <br />\GlsSetXdyLanguage{} </div> -<!--l. 17861--><p class="nopar" > it will set the style file to <span +<!--l. 17874--><p class="nopar" > it will set the style file to <span class="cmtt-10">samplexdy-mc.xdy </span>instead. This provides an additional letter group for entries starting with “Mc” or “Mac”. If you use <a href="#glo:makeglossaries"><span @@ -37117,8 +36977,8 @@ otherwise the <span class="cmss-10">glossaries </span>package will overwrite <span class="cmtt-10">samplexdy-mc.xdy </span>and you will lose the “Mc” letter group. -</p><!--l. 17874--><p class="indent" > To create the document do: -</p><!--l. 17875--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17887--><p class="indent" > To create the document do: +</p><!--l. 17888--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplexdy <br />makeglossaries samplexdy <br />pdflatex samplexdy @@ -37145,19 +37005,19 @@ class="cmtt-10">makeglossaries-lite</span><a <ul class="itemize1"> <li class="itemize">if you are using the default style file <span class="cmtt-10">samplexdy.xdy</span>, then do (no line breaks): - <!--l. 17888--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <!--l. 17901--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L english -C utf8 -I xindy -M samplexdy -t samplexdy.glg -o samplexdy.gls samplexdy.glo <br /></pre><spacer type=vertical size=10> <br /></span> </p></li> <li class="itemize">if you are using <span class="cmtt-10">samplexdy-mc.xdy</span>, then do (no line breaks): - <!--l. 17893--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <!--l. 17906--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -I xindy -M samplexdy-mc -t samplexdy.glg -o samplexdy.gls samplexdy.glo <br /></pre><spacer type=vertical size=10> <br /></span> </p></li></ul> -<!--l. 17898--><p class="indent" > This document creates a new command to use with the <span +<!--l. 17911--><p class="indent" > This document creates a new command to use with the <span class="cmtt-10">format</span><a id="dx1-211015"></a> key in the optional argument of commands like <span @@ -37172,27 +37032,26 @@ href="#tab:hyperxx">table 6.1</a>: </p> - <div class="verbatim" id="verbatim-459"> + <div class="verbatim" id="verbatim-460"> \newcommand*{\hyperbfit}[1]{\textit{\hyperbf{#1}}} </div> -<!--l. 17906--><p class="nopar" > Unfortunately, this definition doesn’t work for this particular document and some adjustments are needed (see -below). As a result of the adjustments, this command doesn’t actually get used by <span class="TEX">T<span -class="E">E</span>X</span>, even though -<span -class="cmtt-10">hyperbfit </span>is used in the <span +<!--l. 17919--><p class="nopar" > Unfortunately, this definition doesn’t work for this particular document and some adjustments are needed (see +below). As a result of the adjustments, this command doesn’t actually get used by TeX, even though <span +class="cmtt-10">hyperbfit</span> +is used in the <span class="cmtt-10">format</span><a id="dx1-211018"></a> key. It does, however, need to be identified as an attribute so that <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-211019"></a></a> can -recognise it: + id="dx1-211019"></a></a> can recognise +it: </p> - <div class="verbatim" id="verbatim-460"> + <div class="verbatim" id="verbatim-461"> \GlsAddXdyAttribute{hyperbfit} </div> -<!--l. 17915--><p class="nopar" > This will add information to the <span +<!--l. 17928--><p class="nopar" > This will add information to the <span class="cmtt-10">xdy</span><a id="dx1-211020"></a> file when it’s created by <span class="cmtt-10">\makeglossaries</span>. If you prevent the creation of @@ -37203,7 +37062,7 @@ class="cmtt-10">xdy</span><a id="dx1-211022"></a> file (see the provided <span class="cmtt-10">samplexdy-mc.xdy </span>file). -</p><!--l. 17922--><p class="indent" > In order to illustrate unusual location formats, this sample document provides a command called +</p><!--l. 17935--><p class="indent" > In order to illustrate unusual location formats, this sample document provides a command called <span class="cmtt-10">\tallynum{</span>⟨<span class="cmti-10">n</span>⟩<span @@ -37213,7 +37072,7 @@ class="cmti-10">n</span>⟩: </p> - <div class="verbatim" id="verbatim-461"> + <div class="verbatim" id="verbatim-462"> \newrobustcmd*{\tallynum}[1]{%  <br /> \ifnum\number#1<7  <br />  $\csname dice\romannumeral#1\endcsname$% @@ -37223,7 +37082,7 @@ class="cmti-10">n</span>⟩:  <br /> \fi  <br />} </div> -<!--l. 17934--><p class="nopar" > This command needs to be robust to prevent it from being expanded when it’s written to any of the auxiliary +<!--l. 17947--><p class="nopar" > This command needs to be robust to prevent it from being expanded when it’s written to any of the auxiliary files. The <span class="cmtt-10">\dicei</span><a id="dx1-211023"></a>, …, <span @@ -37231,7 +37090,7 @@ class="cmtt-10">\dicevi </span>commands are provided by the <span class="cmss-10">stix</span><a id="dx1-211024"></a> package, so that needs to be loaded. -</p><!--l. 17940--><p class="indent" > An associated command <span +</p><!--l. 17953--><p class="indent" > An associated command <span class="cmtt-10">\tally{</span>⟨<span class="cmti-10">counter</span>⟩<span class="cmtt-10">} </span>is defined that formats the value of the named ⟨<span @@ -37241,14 +37100,14 @@ class="cmtt-10">\tallynum</span>: </p> - <div class="verbatim" id="verbatim-462"> + <div class="verbatim" id="verbatim-463"> \newcommand*{\tally}[1]{\tallynum{\arabic{#1}}} </div> -<!--l. 17945--><p class="nopar" > (This shouldn’t be robust as it needs the counter value to expand.) The page numbers are altered to use this +<!--l. 17958--><p class="nopar" > (This shouldn’t be robust as it needs the counter value to expand.) The page numbers are altered to use this format (by redefining <span class="cmtt-10">\thepage</span><a id="dx1-211025"></a>). -</p><!--l. 17949--><p class="indent" > This custom location format also needs to be identified in the <span +</p><!--l. 17962--><p class="indent" > This custom location format also needs to be identified in the <span class="cmtt-10">xdy</span><a id="dx1-211026"></a> file so that <a href="#glo:xindy"><span @@ -37258,14 +37117,14 @@ determine how to form ranges if required. </p> - <div class="verbatim" id="verbatim-463"> + <div class="verbatim" id="verbatim-464"> \GlsAddXdyLocation{tally}{% tally location format  <br /> :sep "\string\tallynum\space\glsopenbrace"  <br /> "arabic-numbers"  <br /> :sep "\glsclosebrace"  <br />} </div> -<!--l. 17958--><p class="nopar" > Again this information is written to the <span +<!--l. 17971--><p class="nopar" > Again this information is written to the <span class="cmtt-10">xdy</span><a id="dx1-211028"></a> file by <span class="cmtt-10">\makeglossaries </span>so if you use <span @@ -37273,7 +37132,7 @@ class="cmtt-10">\noist </span>then you need to manually add it to your custom <span class="cmtt-10">xdy</span><a id="dx1-211029"></a> file. -</p><!--l. 17963--><p class="indent" > When <a +</p><!--l. 17976--><p class="indent" > When <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-211030"></a></a> creates the associated glossary files, the locations will be written using: </p><div class="alltt"> @@ -37313,7 +37172,7 @@ to be redefined in order to grab the number part in order to work out the locati If the value of <span class="cmtt-10">\tally </span>is changed so that it expands differently then these modifications won’t work. -<!--l. 17985--><p class="indent" > Remember that in both cases, the second argument <span class="obeylines-h"><span class="verb"><span +<!--l. 17998--><p class="indent" > Remember that in both cases, the second argument <span class="obeylines-h"><span class="verb"><span class="cmtt-10">#2</span></span></span> is in the form <span class="cmtt-10">\tally{</span>⟨<span class="cmti-10">n</span>⟩<span @@ -37321,7 +37180,7 @@ class="cmtt-10">}</span>: </p> - <div class="verbatim" id="verbatim-464"> + <div class="verbatim" id="verbatim-465"> \renewcommand{\glsXpageXglsnumberformat}[2]{%  <br /> \linkpagenumber#2%  <br />} @@ -37329,15 +37188,15 @@ class="cmtt-10">}</span>:  <br /> \textbf{\em\linkpagenumber#2}%  <br />} </div> -<!--l. 17994--><p class="nopar" > These need a command that can grab the actual number and correctly encapsulate it: +<!--l. 18007--><p class="nopar" > These need a command that can grab the actual number and correctly encapsulate it: </p> - <div class="verbatim" id="verbatim-465"> + <div class="verbatim" id="verbatim-466"> \newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} </div> -<!--l. 17999--><p class="nopar" > -</p><!--l. 18001--><p class="indent" > If you want to try out the <span +<!--l. 18012--><p class="nopar" > +</p><!--l. 18014--><p class="indent" > If you want to try out the <span class="cmtt-10">samplexdy-mc.xdy </span>file, the entries starting with “Mac” or “Mc” will be placed in their own “Mc” letter group. Ideally it should be possible to do this simply with <span class="cmtt-10">\GlsAddLetterGroup</span><a @@ -37350,27 +37209,27 @@ suppressed: </p> - <div class="verbatim" id="verbatim-466"> + <div class="verbatim" id="verbatim-467"> \setStyleFile{samplexdy-mc}  <br />\noist  <br />\GlsSetXdyLanguage{} </div> -<!--l. 18013--><p class="nopar" > -</p><!--l. 18015--><p class="indent" > This “Mc” group is suitable for names like “Maclaurin” but not for “Mach”. To prevent this, the <span +<!--l. 18026--><p class="nopar" > +</p><!--l. 18028--><p class="indent" > This “Mc” group is suitable for names like “Maclaurin” but not for “Mach”. To prevent this, the <span class="cmtt-10">sort</span><a id="dx1-211034"></a> key for that value is set to lower case: </p> - <div class="verbatim" id="verbatim-467"> + <div class="verbatim" id="verbatim-468"> \newglossaryentry{mach}{name={Mach, Ernst},  <br />first={Ernst Mach},text={Mach},  <br />sort={mach, Ernst},  <br />description={Czech/Austrian physicist and philosopher}} </div> -<!--l. 18023--><p class="nopar" > -</p><!--l. 18025--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 18036--><p class="nopar" > +</p><!--l. 18038--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-211035"></a></a></span>If you want to convert this document so that it uses <a @@ -37413,19 +37272,19 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-211040"></a></a> and so should be removed. -<!--l. 18040--><p class="indent" > The definitions of <span +<!--l. 18053--><p class="indent" > The definitions of <span class="cmtt-10">\hyperbfit </span>should be retained (as well as <span class="cmtt-10">\tallynum</span>, <span class="cmtt-10">\tally </span>and the redefinition of <span class="cmtt-10">\thepage</span>). -</p><!--l. 18043--><p class="indent" > The entries all need to be converted to the <span +</p><!--l. 18056--><p class="indent" > The entries all need to be converted to the <span class="cmtt-10">bib</span><a id="dx1-211041"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-211042"></a></a>. -</p><!--l. 18045--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18058--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only samplexdy.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -37451,12 +37310,12 @@ class="cmtt-10">\glsentryname</span><a <span id="textcolor912"><span class="cmtt-10">\glsfmtname</span></span><a id="dx1-211048"></a>. -<!--l. 18057--><p class="indent" > Finally, replace <span +<!--l. 18070--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossaries</span><a id="dx1-211049"></a> with <span id="textcolor913"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-211050"></a>. The document build is now: -</p><!--l. 18059--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18072--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplexdy <br />bib2gls --group samplexdy <br />pdflatex samplexdy @@ -37464,7 +37323,7 @@ class="cmtt-10">\printunsrtglossaries</span></span><a <br /></span> -</p><!--l. 18065--><p class="indent" > This results in a slightly different ordering from the original document (without the “Mc” letter group). In +</p><!--l. 18078--><p class="indent" > This results in a slightly different ordering from the original document (without the “Mc” letter group). In the original example, “Mach number” was listed before “Mach, Ernest”. The modified document now has “Mach, Ernest” before “Mach number”. This difference is due to <a href="#glo:bib2gls"><span @@ -37486,7 +37345,7 @@ class="cmtt-10">bib2gls</span><a id="dx1-211054"></a></a> manual for further details of this option, and also see the examples chapter of that manual for alternative approaches when creating entries that contain people’s names. -</p><!--l. 18077--><p class="indent" > If you want the “Mc” letter group, it can be obtained by providing a custom sort rule: </p><div class="alltt"> +</p><!--l. 18090--><p class="indent" > If you want the “Mc” letter group, it can be obtained by providing a custom sort rule: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor915"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a @@ -37560,7 +37419,7 @@ class="cmtt-10">]</span> href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-211065"></a></a>, this puts “Mach” into the “Mc” letter group. -<!--l. 18094--><p class="indent" > One way to get around this problem is to define a custom command to help identify genuine “Mc”/“Mac” +<!--l. 18107--><p class="indent" > One way to get around this problem is to define a custom command to help identify genuine “Mc”/“Mac” prefixes with names that happen to start with “Mac”. For example: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor926"><span @@ -37670,14 +37529,13 @@ class="cmtt-10"> Mach}</span> <br /><span class="cmtt-10">}</span> </div> -</div> With <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>, this command should simply do its argument: +</div> With LaTeX, this command should simply do its argument: - <div class="verbatim" id="verbatim-468"> + <div class="verbatim" id="verbatim-469"> \newcommand{\Mac}[1]{#1} </div> -<!--l. 18125--><p class="nopar" > However, when <a +<!--l. 18138--><p class="nopar" > However, when <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-211069"></a></a> works out the <span @@ -37687,10 +37545,10 @@ happen to occur at the start of another term. For example: </p> - <div class="verbatim" id="verbatim-469"> + <div class="verbatim" id="verbatim-470"> \providecommand{\Mac}[1]{MC} </div> -<!--l. 18131--><p class="nopar" > (Remember that <span id="textcolor929"><span +<!--l. 18144--><p class="nopar" > (Remember that <span id="textcolor929"><span class="cmtt-10">break-at</span></span><span class="cmtt-10">=word</span><a id="dx1-211071"></a> will strip spaces and punctuation so don’t include them unless you switch to @@ -37698,7 +37556,7 @@ class="cmtt-10">=word</span><a class="cmtt-10">break-at</span></span><span class="cmtt-10">=none</span><a id="dx1-211072"></a>.) -</p><!--l. 18136--><p class="indent" > So add the first definition of <span +</p><!--l. 18149--><p class="indent" > So add the first definition of <span class="cmtt-10">\Mac </span>to the <span class="cmtt-10">tex</span><a id="dx1-211073"></a> file and modify <span @@ -37712,7 +37570,7 @@ class="cmtt-10">{"\providecommand{\Mac}[1]{MC}"}</span> </div> </div> Then modify the “Mc”/“Mac” entries as appropriate (see the above “McAdam” and “Maclaurin” examples). -<!--l. 18144--><p class="indent" > The custom sort rule needs to be modified: </p><div class="alltt"> +<!--l. 18157--><p class="indent" > The custom sort rule needs to be modified: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor932"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a @@ -37790,7 +37648,7 @@ class="cmtt-10">]</span> </div> This will create a “Mc” letter group that only includes the names that start with the custom <span class="cmtt-10">\Mac</span> command. -<!--l. 18161--><p class="indent" > Other alternatives include moving <span id="textcolor944"><span +<!--l. 18174--><p class="indent" > Other alternatives include moving <span id="textcolor944"><span class="cmtt-10">@preamble</span></span><a id="dx1-211086"></a> into a separate <span class="cmtt-10">bib</span><a @@ -37802,13 +37660,13 @@ class="cmtt-10">bib2gls</span><a examples. <a id="x1-211089r30"></a> -</p><!--l. 18166--><p class="noindent" > +</p><!--l. 18179--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:samplexdy2"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:samplexdy2">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/samplexdy2.tex" ><span class="cmtt-10">samplexdy2.tex</span></a></h4> -<!--l. 18166--><p class="noindent" >This document illustrates how to use the <span +<!--l. 18179--><p class="noindent" >This document illustrates how to use the <span class="cmss-10">glossaries </span>package where the location numbers don’t follow a standard format. This example will only work with <a href="#glo:xindy"><span @@ -37816,7 +37674,7 @@ class="cmtt-10">xindy</span><a id="dx1-212001"></a></a>. To create the document do: -</p><!--l. 18170--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18183--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplexdy2 <br />makeglossaries samplexdy2 <br />pdflatex samplexdy2 @@ -37826,7 +37684,7 @@ The explicit <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-212002"></a></a> call is: -</p><!--l. 18176--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18189--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L english -C utf8 -I xindy -M samplexdy2 -t samplexdy2.glg -o samplexdy2.gls samplexdy2.glo <br /></pre><spacer type=vertical size=10> <br /></span> @@ -37838,57 +37696,57 @@ class="cmtt-10">xindy</span><a </p> - <div class="verbatim" id="verbatim-470"> + <div class="verbatim" id="verbatim-471"> \usepackage[xindy,counter=section]{glossaries} </div> -<!--l. 18182--><p class="nopar" > The document employs an eccentric section numbering system for illustrative purposes. The section numbers +<!--l. 18195--><p class="nopar" > The document employs an eccentric section numbering system for illustrative purposes. The section numbers are prefixed by the chapter number in square brackets: </p> - <div class="verbatim" id="verbatim-471"> + <div class="verbatim" id="verbatim-472"> \renewcommand*{\thesection}{[\thechapter]\arabic{section}} </div> -<!--l. 18188--><p class="nopar" > Parts use Roman numerals: +<!--l. 18201--><p class="nopar" > Parts use Roman numerals: </p> - <div class="verbatim" id="verbatim-472"> + <div class="verbatim" id="verbatim-473"> \renewcommand*{\thepart}{\Roman{part}} </div> -<!--l. 18192--><p class="nopar" > The section hyperlink name includes the part: +<!--l. 18205--><p class="nopar" > The section hyperlink name includes the part: </p> - <div class="verbatim" id="verbatim-473"> + <div class="verbatim" id="verbatim-474"> \renewcommand*{\theHsection}{\thepart.\thesection} </div> -<!--l. 18196--><p class="nopar" > This custom numbering scheme needs to be identified in the <span +<!--l. 18209--><p class="nopar" > This custom numbering scheme needs to be identified in the <span class="cmtt-10">xdy</span><a id="dx1-212004"></a> file: </p> - <div class="verbatim" id="verbatim-474"> + <div class="verbatim" id="verbatim-475"> \GlsAddXdyLocation["roman-numbers-uppercase"]{section}{:sep "["  <br />  "arabic-numbers" :sep "]" "arabic-numbers"  <br />} </div> -<!--l. 18203--><p class="nopar" > If the part is 0 then <span +<!--l. 18216--><p class="nopar" > If the part is 0 then <span class="cmtt-10">\thepart </span>will be empty (there isn’t a zero Roman numeral). An extra case is needed to catch this: </p> - <div class="verbatim" id="verbatim-475"> + <div class="verbatim" id="verbatim-476"> \GlsAddXdyLocation{zero.section}{:sep "["  <br />  "arabic-numbers" :sep "]" "arabic-numbers"  <br />} </div> -<!--l. 18210--><p class="nopar" > Note that this will stop xindy giving a warning, but the location hyperlinks will be invalid if no <span +<!--l. 18223--><p class="nopar" > Note that this will stop xindy giving a warning, but the location hyperlinks will be invalid if no <span class="cmtt-10">\part </span>is used. -</p><!--l. 18214--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 18227--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-212005"></a></a></span>If you want to switch to <a @@ -37918,7 +37776,7 @@ by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-212010"></a></a>: -<!--l. 18224--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 18237--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only samplexdy2.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -37939,14 +37797,14 @@ class="cmtt-10">\printglossaries </span>with <span id="textcolor949"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-212013"></a>. -<!--l. 18234--><p class="indent" > The document build is: -</p><!--l. 18235--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 18247--><p class="indent" > The document build is: +</p><!--l. 18248--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplexdy2 <br />bib2gls samplexdy2 <br />pdflatex samplexdy2 <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 18241--><p class="indent" > With unusual numbering systems, it’s sometimes better to use <span id="textcolor950"><span +</p><!--l. 18254--><p class="indent" > With unusual numbering systems, it’s sometimes better to use <span id="textcolor950"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a @@ -37978,13 +37836,13 @@ href="#ex:sampleSec"><span class="cmtt-10">sampleSec.tex</span></a>. <a id="x1-212016r31"></a> -<!--l. 18254--><p class="noindent" > +<!--l. 18267--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:samplexdy3"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:samplexdy3">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/samplexdy3.tex" ><span class="cmtt-10">samplexdy3.tex</span></a></h4> -<!--l. 18254--><p class="noindent" >This document is very similar to <a +<!--l. 18267--><p class="noindent" >This document is very similar to <a href="#ex:samplexdy"><span class="cmtt-10">samplexdy.tex</span></a> but uses the command <span class="cmtt-10">\Numberstring </span>from the @@ -37995,13 +37853,13 @@ class="cmtt-10">\tally </span>command from the earlier example. <a id="x1-213002r32"></a> -</p><!--l. 18259--><p class="noindent" > +</p><!--l. 18272--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleutf8"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleutf8">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleutf8.tex" ><span class="cmtt-10">sampleutf8.tex</span></a></h4> -<!--l. 18259--><p class="noindent" >This is another example that uses <a +<!--l. 18272--><p class="noindent" >This is another example that uses <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-214001"></a></a>. Unlike <a @@ -38014,7 +37872,7 @@ class="cmtt-10">xindy</span><a href="#glo:nonlatinchar">non-Latin character<a id="dx1-214004"></a>s</a>. This document uses UTF-8 encoding. To create the document do: -</p><!--l. 18263--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18276--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleutf8 <br />makeglossaries sampleutf8 <br />pdflatex sampleutf8 @@ -38024,7 +37882,7 @@ The explicit <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-214005"></a></a> call is (no line breaks): -</p><!--l. 18270--><p class="indent" > +</p><!--l. 18283--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L @@ -38044,18 +37902,18 @@ sampleutf8.gls sampleutf8.glo <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 18274--><p class="indent" > If you remove the <span +</p><!--l. 18287--><p class="indent" > If you remove the <span class="cmss-10">xindy</span><a id="dx1-214006"></a> option from <span class="cmtt-10">sampleutf8.tex </span>and do: -</p><!--l. 18276--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18289--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleutf8 <br />makeglossaries sampleutf8 <br />pdflatex sampleutf8 <br /></pre><spacer type=vertical size=10> <br /></span> or -</p><!--l. 18282--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18295--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleutf8 <br />makeglossaries-lite sampleutf8 <br />pdflatex sampleutf8 @@ -38069,11 +37927,11 @@ href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-214008"></a></a> (no line breaks): -</p><!--l. 18291--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18304--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s sampleutf8.ist -t sampleutf8.glg -o sampleutf8.gls sampleutf8.glo <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 18295--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 18308--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-214009"></a></a></span>If you want to switch to <a @@ -38112,13 +37970,13 @@ simply not save the <a href="#glo:numberlist">number list<a id="dx1-214016"></a>s</a>, but in this case there won’t be any locations as there’s no actual indexing. -<!--l. 18307--><p class="indent" > The entries need to be converted to the <span +<!--l. 18320--><p class="indent" > The entries need to be converted to the <span class="cmtt-10">bib</span><a id="dx1-214017"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-214018"></a></a>: -</p><!--l. 18309--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18322--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only --texenc UTF-8 --bibenc UTF-8 sampleutf8.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -38151,7 +38009,7 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-214023"></a></a> manual for further details.) -<!--l. 18324--><p class="indent" > Next replace <span +<!--l. 18337--><p class="indent" > Next replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor957"><span @@ -38169,7 +38027,7 @@ class="cmtt-10">]</span> </div> </div> and remove all the <span class="cmtt-10">\newglossaryentry </span>commands. -<!--l. 18330--><p class="indent" > Iterative commands like <span +<!--l. 18343--><p class="indent" > Iterative commands like <span class="cmtt-10">\glsaddall</span><a id="dx1-214027"></a> don’t work with <a href="#glo:bib2gls"><span @@ -38200,11 +38058,11 @@ class="cmtt-10">bib2gls</span><a this case there are no <a href="#glo:numberlist">number list<a id="dx1-214034"></a>s</a>. -</p><!--l. 18342--><p class="indent" > Finally, replace <span +</p><!--l. 18355--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossaries </span>with <span id="textcolor962"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-214035"></a>. The build process is now: -</p><!--l. 18344--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18357--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleutf8 <br />bib2gls --group sampleutf8 <br />pdflatex sampleutf8 @@ -38238,11 +38096,11 @@ class="cmtt-10">glg</span><a like: - <div class="verbatim" id="verbatim-476"> + <div class="verbatim" id="verbatim-477"> TeX character encoding: UTF-8 </div> -<!--l. 18360--><p class="nopar" > -</p><!--l. 18362--><p class="indent" > The document language, if it has been set, is also added to the <span +<!--l. 18373--><p class="nopar" > +</p><!--l. 18375--><p class="indent" > The document language, if it has been set, is also added to the <span class="cmtt-10">aux</span><a id="dx1-214044"></a> file when the <span class="cmss-10">record</span><a @@ -38292,25 +38150,25 @@ class="cmtt-10">=is</span></strong><span class="cmtt-10">]</span> </div> </div> (Icelandic). -<!--l. 18378--><p class="noindent" > +<!--l. 18391--><p class="noindent" > </p> -<!--l. 18378--><p class="noindent" ><a +<!--l. 18391--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.10 </span> <a id="sec:samplesnoidx"></a>No Indexing Application (Option 1)</h3> <a id="x1-215001r33"></a> -<!--l. 18381--><p class="noindent" > +<!--l. 18394--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-noidxapp"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-noidxapp">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-noidxapp.tex" ><span class="cmtt-10">sample-noidxapp.tex</span></a></h4> -<!--l. 18381--><p class="noindent" >This document illustrates how to use the <span +<!--l. 18394--><p class="noindent" >This document illustrates how to use the <span class="cmss-10">glossaries </span>package without an external <a href="#glo:indexingapp">indexing application</a> (<a href="#option1">Option 1</a>). To create the complete document, you need to do: -</p><!--l. 18384--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18397--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-noidxapp <br />pdflatex sample-noidxapp <br /></pre><spacer type=vertical size=10> @@ -38351,22 +38209,22 @@ href="#option3">3</a> or, with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, <a href="#option4">Option 4</a>). -<!--l. 18402--><p class="indent" > The larger the list of entries, the longer the document build time. This method is very inefficient for large +<!--l. 18415--><p class="indent" > The larger the list of entries, the longer the document build time. This method is very inefficient for large glossaries. See <a href="https://www.dickimaw-books.com/gallery/glossaries-performance.shtml" >Gallery: glossaries performance</a> for a comparison. <a id="x1-216005r34"></a> -</p><!--l. 18406--><p class="noindent" > +</p><!--l. 18419--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-noidxapp-utf8"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-noidxapp-utf8">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-noidxapp-utf8.tex" ><span class="cmtt-10">sample-noidxapp-utf8.tex</span></a></h4> -<!--l. 18406--><p class="noindent" >As the previous example, except that it uses the <span +<!--l. 18419--><p class="noindent" >As the previous example, except that it uses the <span class="cmss-10">inputenc</span><a id="dx1-217001"></a> package. To create the complete document, you need to do: -</p><!--l. 18409--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18422--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-noidxapp-utf8 <br />pdflatex sample-noidxapp-utf8 <br /></pre><spacer type=vertical size=10> @@ -38377,22 +38235,22 @@ href="#glo:nonlatinalph">non-Latin alphabets</a>. Use Options <a href="#option3">3</a> or <a href="#option4">4</a> instead. -</p><!--l. 18416--><p class="noindent" > +</p><!--l. 18429--><p class="noindent" > </p> -<!--l. 18416--><p class="noindent" ><a +<!--l. 18429--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.11 </span> <a id="sec:samplesother"></a>Other</h3> <a id="x1-218001r35"></a> -<!--l. 18419--><p class="noindent" > +<!--l. 18432--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample4col"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample4col">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample4col.tex" ><span class="cmtt-10">sample4col.tex</span></a></h4> -<!--l. 18419--><p class="noindent" >This document illustrates a four column glossary where the entries have a symbol in addition to the name and +<!--l. 18432--><p class="noindent" >This document illustrates a four column glossary where the entries have a symbol in addition to the name and description. To create the complete document, you need to do: -</p><!--l. 18423--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18436--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample4col <br />makeglossaries sample4col <br />pdflatex sample4col @@ -38401,7 +38259,7 @@ description. To create the complete document, you need to do: <br /></pre><spacer type=vertical size=10> <br /></span> or -</p><!--l. 18429--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18442--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample4col <br />makeglossaries-lite sample4col <br />pdflatex sample4col @@ -38416,7 +38274,7 @@ class="cmtt-10">bib2gls</span><a id="dx1-219002"></a></a>, simply omit the <span class="cmtt-10">--group </span>command line option.) -</p><!--l. 18439--><p class="indent" > This example uses the <span +</p><!--l. 18452--><p class="indent" > This example uses the <span class="cmss-10">long4colheaderborder</span><a id="dx1-219003"></a>. This style doesn’t allow multi-line descriptions. You may prefer to use <span @@ -38442,7 +38300,7 @@ class="cmtt-10">\usepackage{glossary-longbooktabs}</span> class="cmtt-10">\setglossarystyle{altlongragged4col-booktabs}</span> </div> </div> -<!--l. 18453--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 18466--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>The <a href="#glo:glossaries-extra"><span @@ -38506,18 +38364,17 @@ class="cmtt-10">{glossaries-extra}</span> href="https://www.dickimaw-books.com/gallery/glossaries-styles/" >gallery of predefined styles</a>. <a id="x1-219014r36"></a> -<!--l. 18478--><p class="noindent" > +<!--l. 18491--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-numberlist"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-numberlist">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-numberlist.tex" ><span class="cmtt-10">sample-numberlist.tex</span></a></h4> -<!--l. 18478--><p class="noindent" >This document illustrates how to reference the <a +<!--l. 18491--><p class="noindent" >This document illustrates how to reference the <a href="#glo:numberlist">number list<a id="dx1-220001"></a></a> in the document text. This requires an additional -<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run: -</p><!--l. 18481--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +LaTeX run: +</p><!--l. 18494--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-numberlist <br />makeglossaries sample-numberlist <br />pdflatex sample-numberlist @@ -38539,10 +38396,10 @@ numbers. </p> - <div class="verbatim" id="verbatim-477"> + <div class="verbatim" id="verbatim-478"> \usepackage[savenumberlist,counter=chapter]{glossaries} </div> -<!--l. 18494--><p class="nopar" > The <a +<!--l. 18507--><p class="nopar" > The <a href="#glo:numberlist">number list<a id="dx1-220006"></a></a> can’t be obtained until <a href="#glo:makeindex"><span @@ -38557,9 +38414,8 @@ picked up when this file is input by <span class="cmtt-10">\printglossary </span>and is then saved in the <span class="cmtt-10">aux</span><a id="dx1-220010"></a> file so that it’s available on -the next <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> run. -</p><!--l. 18501--><p class="indent" > This document contains both commands: </p><div class="alltt"> +the next LaTeX run. +</p><!--l. 18514--><p class="indent" > This document contains both commands: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">This</span><span @@ -38586,7 +38442,7 @@ class="cmtt-10">{sample}).</span> </div> Without <span class="cmss-10">hyperref</span><a id="dx1-220013"></a>, the first list shows as “1–3, 5 & 6” and the second list shows as “1–3, 5, 6”. -<!--l. 18510--><p class="indent" > Note that you can’t use <span +<!--l. 18523--><p class="indent" > Note that you can’t use <span class="cmtt-10">\glsdisplaynumberlist</span><a id="dx1-220014"></a> with <span class="cmss-10">hyperref</span><a @@ -38597,20 +38453,20 @@ the warning: </p> - <div class="verbatim" id="verbatim-478"> + <div class="verbatim" id="verbatim-479"> Package glossaries Warning: \glsdisplaynumberlist doesn't work with  <br />hyperref.  <br />Using \glsentrynumberlist instead </div> -<!--l. 18516--><p class="nopar" > Now both lists show as “1–3, 5, 6”. -</p><!--l. 18519--><p class="indent" > If you switch to <a +<!--l. 18529--><p class="nopar" > Now both lists show as “1–3, 5, 6”. +</p><!--l. 18532--><p class="indent" > If you switch to <a href="#option1">Option 1</a> (replace <span class="cmtt-10">\makeglossaries </span>with <span class="cmtt-10">\makenoidxglossaries </span>and replace <span class="cmtt-10">\printglossaries </span>with <span class="cmtt-10">\printnoidxglossaries</span>), then the document build is simply: -</p><!--l. 18522--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18535--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-numberlist <br />pdflatex sample-numberlist <br /></pre><spacer type=vertical size=10> @@ -38621,7 +38477,7 @@ class="cmtt-10">\glsdisplaynumberlist</span><a class="cmss-10">hyperref</span><a id="dx1-220017"></a>, however there are no ranges, so the first list shows as “1, 2, 3, 5, & 6” and the second list shows as “1, 2, 3, 4, 5, 6”. -</p><!--l. 18530--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 18543--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-220018"></a></a></span>If you want to switch to <a @@ -38650,7 +38506,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-220023"></a></a>: -<!--l. 18540--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 18553--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib sample-numberlist.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -38671,7 +38527,7 @@ class="cmtt-10">\newglossaryentry </span>command from the document preamble. Fin class="cmtt-10">\printglossaries </span>with <span id="textcolor986"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-220026"></a>. The build process is now: -<!--l. 18550--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 18563--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-numberlist <br />bib2gls sample-numberlist <br />pdflatex sample-numberlist @@ -38688,7 +38544,7 @@ class="cmtt-10">\glsxtrfieldformatlist</span></span><a class="cmtt-10">{sample}{loclist}</span> </div> </div> which will show the complete list without ranges “1, 2, 3, 5 & 6”. -<!--l. 18564--><p class="indent" > This method works much better than using the <span +<!--l. 18577--><p class="indent" > This method works much better than using the <span class="cmss-10">savenumberlist</span><a id="dx1-220028"></a> option because <a href="#glo:bib2gls"><span @@ -38711,7 +38567,7 @@ class="cmtt-10">loclist</span><a id="dx1-220034"></a> internal field (which is also used by <a href="#option1">Option 1</a>). -</p><!--l. 18571--><p class="indent" > With Options <a +</p><!--l. 18584--><p class="indent" > With Options <a href="#option2">2</a> and <a href="#option3">3</a>, both <a href="#glo:makeindex"><span @@ -38724,7 +38580,7 @@ the glossary, which is input by <span class="cmtt-10">\printglossary</span>. This means that it’s quite hard to gather information obtained by the <a href="#glo:indexingapp">indexing application</a>. -</p><!--l. 18576--><p class="indent" > <a +</p><!--l. 18589--><p class="indent" > <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-220037"></a></a>, on the other hand, doesn’t write a file containing the glossary. It writes a file containing the entry @@ -38733,7 +38589,7 @@ definitions and uses internal fields to save the indexing information. The gloss class="cmtt-10">\printunsrtglossary</span></span><a id="dx1-220038"></a>, which simply iterates over all defined entries and fetches the required information from those internal fields. -</p><!--l. 18583--><p class="indent" > The <span +</p><!--l. 18596--><p class="indent" > The <span class="cmtt-10">\glsdisplaynumberlist</span><a id="dx1-220039"></a> and <span class="cmtt-10">\glsentrynumberlist</span><a @@ -38751,7 +38607,7 @@ class="cmtt-10">\glsxtrfieldformatlist</span></span><a class="cmtt-10">{sample}{loclist}</span> </div> </div> In this example, this produces “1, 2, 3, 5 & 6”. -<!--l. 18592--><p class="indent" > Note the difference if you use the <span id="textcolor992"><span +<!--l. 18605--><p class="indent" > Note the difference if you use the <span id="textcolor992"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a @@ -38760,17 +38616,17 @@ class="cmss-10">record</span></span><a id="dx1-220045"></a>. <a id="x1-220046r37"></a> -</p><!--l. 18595--><p class="noindent" > +</p><!--l. 18608--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-nomathhyper"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-nomathhyper">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-nomathhyper.tex" ><span class="cmtt-10">sample-nomathhyper.tex</span></a></h4> -<!--l. 18595--><p class="noindent" >This document illustrates how to selectively enable and disable entry hyperlinks in <span +<!--l. 18608--><p class="noindent" >This document illustrates how to selectively enable and disable entry hyperlinks in <span class="cmtt-10">\glsentryfmt</span><a id="dx1-221001"></a>. The document build is: -</p><!--l. 18598--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18611--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-nomathhyper <br />makeglossaries sample-nomathhyper <br />pdflatex sample-nomathhyper @@ -38791,7 +38647,7 @@ been forced off (with the <span class="cmtt-10">hyper</span><a id="dx1-221003"></a><span class="cmtt-10">=false </span>key). -<!--l. 18611--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 18624--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to switch to <a href="#glo:glossaries-extra"><span @@ -38825,18 +38681,18 @@ class="cmtt-10"> definition</span> </div> <a id="x1-221005r38"></a> -<!--l. 18627--><p class="noindent" > +<!--l. 18640--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-entryfmt"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-entryfmt">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-entryfmt.tex" ><span class="cmtt-10">sample-entryfmt.tex</span></a></h4> -<!--l. 18627--><p class="noindent" >This document illustrates how to change the way an entry is displayed in the text. (This is just a test document. +<!--l. 18640--><p class="noindent" >This document illustrates how to change the way an entry is displayed in the text. (This is just a test document. For a real document, I recommend you use the <span class="cmss-10">siunitx</span><a id="dx1-222001"></a> package to typeset units.) The document build is: -</p><!--l. 18631--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18644--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-entryfmt <br />makeglossaries sample-entryfmt <br />pdflatex sample-entryfmt @@ -38871,7 +38727,7 @@ class="cmti-10">not </span><span class="cmtt-10">\glssymbol </span>(which would result in nested <a href="#glo:linktext">link text<a id="dx1-222006"></a></a>). -<!--l. 18647--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 18660--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to switch to the <a href="#glo:glossaries-extra"><span @@ -38921,17 +38777,17 @@ class="cmtt-10">symbol={km}}</span> </div> Note that in this case the symbol is now outside of the hyperlink. <a id="x1-222009r39"></a> -<!--l. 18665--><p class="noindent" > +<!--l. 18678--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-prefix"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-prefix">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-prefix.tex" ><span class="cmtt-10">sample-prefix.tex</span></a></h4> -<!--l. 18665--><p class="noindent" >This document illustrates the use of the <span +<!--l. 18678--><p class="noindent" >This document illustrates the use of the <span class="cmss-10">glossaries-prefix</span><a id="dx1-223001"></a> package. An additional run is required to ensure the table of contents is up-to-date: -</p><!--l. 18668--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18681--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-prefix <br />makeglossaries sample-prefix <br />pdflatex sample-prefix @@ -38988,7 +38844,7 @@ class="cmtt-10">\space</span></strong><span class="cmtt-10">}}</span> </div> </div> -<!--l. 18694--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 18707--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to convert this example to use <a href="#glo:glossaries-extra"><span @@ -39016,7 +38872,7 @@ class="cmss-10">glossaries </span>package, unless you want to switch to using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-223005"></a></a>. -<!--l. 18705--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 18718--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-223006"></a></a></span>If you want to switch to <a @@ -39044,7 +38900,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-223010"></a></a>: -<!--l. 18714--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 18727--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />convertgls2bib --preamble-only sample-prefix.tex entries.bib <br /></pre><spacer type=vertical size=10> <br /></span> @@ -39083,13 +38939,13 @@ class="cmtt-10">\printunsrtacronyms</span></span><a </div> </div> The document build is now: -<!--l. 18733--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 18746--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-prefix <br />bib2gls sample-prefix <br />pdflatex sample-prefix <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 18739--><p class="indent" > With <a +</p><!--l. 18752--><p class="indent" > With <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-223016"></a></a> v2.0+, you don’t need to manually insert the spaces at the end of the prefixes. Instead you @@ -39217,13 +39073,13 @@ class="cmtt-10">bib2gls</span><a id="x1-223025r40"></a> -<!--l. 18773--><p class="noindent" > +<!--l. 18786--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sampleaccsupp"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sampleaccsupp">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleaccsupp.tex" ><span class="cmtt-10">sampleaccsupp.tex</span></a></h4> -<!--l. 18773--><p class="noindent" >This document uses the <span +<!--l. 18786--><p class="noindent" >This document uses the <span class="cmss-10">glossaries-accsupp</span><a id="dx1-224001"></a> package (see <a href="#sec:accsupp">§18 </a><a @@ -39234,10 +39090,10 @@ just: </p> - <div class="verbatim" id="verbatim-479"> + <div class="verbatim" id="verbatim-480"> \usepackage[acronym]{glossaries-accsupp} </div> -<!--l. 18779--><p class="nopar" > This provides additional keys that aren’t available with just the base package, which may be used to provide +<!--l. 18792--><p class="nopar" > This provides additional keys that aren’t available with just the base package, which may be used to provide replacement text. The replacement text is inserted using <span class="cmss-10">accsupp</span><a id="dx1-224002"></a>’s <span @@ -39248,7 +39104,7 @@ class="cmtt-10">\EndAccSupp</span><a commands. See the <span class="cmss-10">accsupp</span><a id="dx1-224005"></a> package for further details of those commands. -</p><!--l. 18786--><p class="indent" > Note that this example document is provided to demonstrate <span +</p><!--l. 18799--><p class="indent" > Note that this example document is provided to demonstrate <span class="cmss-10">glossaries-accsupp</span><a id="dx1-224006"></a> as succinctly as possible. The resulting document isn’t fully accessible as it’s not tagged. See the <span @@ -39257,14 +39113,14 @@ class="cmss-10">accessibility</span><a class="cmss-10">tagpdf</span><a id="dx1-224008"></a> packages for further information about tagging documents. -</p><!--l. 18792--><p class="indent" > It’s not essential to use <span +</p><!--l. 18805--><p class="indent" > It’s not essential to use <span class="cmss-10">glossaries-accsupp</span><a id="dx1-224009"></a>. You can simply insert the replacement text directly into the field values. For example: </p> - <div class="verbatim" id="verbatim-480"> + <div class="verbatim" id="verbatim-481"> \newglossaryentry{Drive}{  <br /> name={\BeginAccSupp{Actual=Drive}Dr.\EndAccSupp{}},  <br /> description={Drive} @@ -39276,29 +39132,28 @@ values. For example:  <br />  [height=20pt]{example-image}\protect\EndAccSupp{}}  <br />} </div> -<!--l. 18805--><p class="nopar" > However, this can cause interference (especially with case-changing). With <span +<!--l. 18818--><p class="nopar" > However, this can cause interference (especially with case-changing). With <span class="cmss-10">glossaries-accsupp</span><a id="dx1-224010"></a> it’s possible to obtain the field values without the accessibility information if required. (If in the future <span class="cmtt-10">\includegraphics </span>is given extra options to provide replacement text then the image example here won’t be necessary. However, the -example can be adapted for images created with <span class="TEX">T<span -class="E">E</span>X</span> code.) -</p><!--l. 18814--><p class="indent" > The acronym style is set using: +example can be adapted for images created with TeX code.) +</p><!--l. 18827--><p class="indent" > The acronym style is set using: </p> - <div class="verbatim" id="verbatim-481"> + <div class="verbatim" id="verbatim-482"> \setacronymstyle{long-short} </div> -<!--l. 18817--><p class="nopar" > The first abbreviation is straightforward: +<!--l. 18830--><p class="nopar" > The first abbreviation is straightforward: </p> - <div class="verbatim" id="verbatim-482"> + <div class="verbatim" id="verbatim-483"> \newacronym{eg}{e.g.}{for example} </div> -<!--l. 18821--><p class="nopar" > The <span +<!--l. 18834--><p class="nopar" > The <span class="cmtt-10">shortaccess</span><a id="dx1-224011"></a> replacement text is automatically set to the long form. The next abbreviation is awkward as the long form contains formatting commands which can’t be included in the replacement text. This means that @@ -39321,7 +39176,7 @@ class="cmtt-10"> Zeichenprogramm}</span> </div> </div> In the above two cases, the short form obtained in <span class="cmtt-10">\gls </span>will use the “E” PDF element. -<!--l. 18833--><p class="indent" > By way of comparison, there are some entries that are technically abbreviations but are defined using +<!--l. 18846--><p class="indent" > By way of comparison, there are some entries that are technically abbreviations but are defined using <span class="cmtt-10">\newglossaryentry</span><a id="dx1-224013"></a> instead of <span @@ -39344,35 +39199,35 @@ class="cmtt-10">access</span></strong><span class="cmtt-10">={Drive}}</span> </div> </div> These will use PDF’s “ActualText” element (not “E”). -<!--l. 18844--><p class="indent" > The next entry is a symbol (the integration symbol <span +<!--l. 18857--><p class="indent" > The next entry is a symbol (the integration symbol <span class="cmex-10">∫</span> ). This could be defined simply as: </p> - <div class="verbatim" id="verbatim-483"> + <div class="verbatim" id="verbatim-484"> \newglossaryentry{int}{name={int},description={integral},  <br /> symbol={\ensuremath{\int}}} </div> -<!--l. 18849--><p class="nopar" > and then referenced in the text like this: +<!--l. 18862--><p class="nopar" > and then referenced in the text like this: </p> - <div class="verbatim" id="verbatim-484"> + <div class="verbatim" id="verbatim-485"> Symbol: \gls{int} (\glssymbol{int}). </div> -<!--l. 18853--><p class="nopar" > This results in the text “Symbol: integral (<span +<!--l. 18866--><p class="nopar" > This results in the text “Symbol: integral (<span class="cmex-10">∫</span> ).” However if you copy and paste this from the PDF you will find the resulting text is “Symbol: int (R).” This is what’s actually read out by the text-to-speech system. -</p><!--l. 18859--><p class="indent" > It would be better if the actual text was the Unicode character 0x222B. This would not only assist the +</p><!--l. 18872--><p class="indent" > It would be better if the actual text was the Unicode character 0x222B. This would not only assist the text-to-speech system but also make it easier to copy and paste the text. The simplest method is to identify the character by its hexadecimal code, but in order to do this the <span class="cmtt-10">\BeginAccSupp</span><a id="dx1-224016"></a> command needs to have the options adjusted. -</p><!--l. 18865--><p class="indent" > In order to determine whether to use “E”, “ActualText” or “Alt” for a particular field, <span +</p><!--l. 18878--><p class="indent" > In order to determine whether to use “E”, “ActualText” or “Alt” for a particular field, <span class="cmss-10">glossaries-accsupp</span><a id="dx1-224017"></a> will check if the command <span @@ -39393,7 +39248,7 @@ class="cmtt-10">shortaccess</span><a class="cmtt-10">\glsaccsupp</span><a id="dx1-224022"></a> command is used instead. -</p><!--l. 18874--><p class="indent" > This means that in order to simply set <span +</p><!--l. 18887--><p class="indent" > This means that in order to simply set <span class="cmtt-10">symbolaccess</span><a id="dx1-224023"></a> to the hexadecimal character code, I need to provide a command called <span @@ -39428,7 +39283,7 @@ class="cmtt-10">symbolaccess={222B}</span></strong> class="cmtt-10">}</span> </div> </div> -<!--l. 18889--><p class="indent" > The final entry has an image stored in the <span +<!--l. 18902--><p class="indent" > The final entry has an image stored in the <span class="cmtt-10">user1</span><a id="dx1-224026"></a> key. (The image file is provided with the <span class="cmss-10">mwe</span><a @@ -39488,7 +39343,7 @@ class="cmtt-10">\glsnoexpandfields </span>before defining the command. See <a href="#sec:expansion">§4.4 </a><a href="#sec:expansion">Expansion<!--tex4ht:ref: sec:expansion --></a>.) -<!--l. 18910--><p class="indent" > If you try this example and inspect the +<!--l. 18923--><p class="indent" > If you try this example and inspect the PDF<span class="footnote-mark"><a href="#fn4x19" id="fn4x19-bk"><sup class="textsuperscript">19.4</sup></a></span><a id="x1-224033f4"></a> then @@ -39496,7 +39351,7 @@ you will find content like: </p> - <div class="verbatim" id="verbatim-485"> + <div class="verbatim" id="verbatim-486"> /Span << /ActualText (Doctor) >> BDC  <br />  BT  <br />    /F8 9.9626 Tf @@ -39505,7 +39360,7 @@ you will find content like:  <br />  ET  <br />EMC </div> -<!--l. 18923--><p class="nopar" > This shows that “ActualText” was used for <span class="obeylines-h"><span class="verb"><span +<!--l. 18936--><p class="nopar" > This shows that “ActualText” was used for <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{Doctor}</span></span></span>. The integral symbol (<span class="cmex-10">∫</span> ) created with @@ -39514,7 +39369,7 @@ class="cmtt-10">\glssymbol{int}</span></span></span> is: </p> - <div class="verbatim" id="verbatim-486"> + <div class="verbatim" id="verbatim-487"> /Span << /ActualText (\376\377"+) >> BDC  <br />  BT  <br />    /F1 9.9626 Tf @@ -39523,13 +39378,13 @@ class="cmtt-10">\glssymbol{int}</span></span></span> is:  <br />  ET  <br />EMC </div> -<!--l. 18934--><p class="nopar" > Again, “ActualText” has been used, but the character code has been supplied. The image created with +<!--l. 18947--><p class="nopar" > Again, “ActualText” has been used, but the character code has been supplied. The image created with <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuseri{sampleimage}</span></span></span> is: </p> - <div class="verbatim" id="verbatim-487"> + <div class="verbatim" id="verbatim-488"> /Span << /Alt (a boilerplate image used in examples) >> BDC  <br />  1 0 0 1 106.588 618.391 cm  <br />  q @@ -39541,14 +39396,14 @@ class="cmtt-10">\glsuseri{sampleimage}</span></span></span> is:  <br />  Q  <br />EMC </div> -<!--l. 18948--><p class="nopar" > This shows that “Alt” has been used. -</p><!--l. 18951--><p class="indent" > The first use of <span class="obeylines-h"><span class="verb"><span +<!--l. 18961--><p class="nopar" > This shows that “Alt” has been used. +</p><!--l. 18964--><p class="indent" > The first use of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{eg}</span></span></span> produces the long form (not reproduced here) followed by the short form: </p> - <div class="verbatim" id="verbatim-488"> + <div class="verbatim" id="verbatim-489"> /Span << /E (for example) >> BDC  <br />  BT  <br />    /F8 9.9626 Tf @@ -39557,11 +39412,11 @@ form:  <br />  ET  <br />EMC </div> -<!--l. 18961--><p class="nopar" > The subsequent use also has the “E” element: +<!--l. 18974--><p class="nopar" > The subsequent use also has the “E” element: </p> - <div class="verbatim" id="verbatim-489"> + <div class="verbatim" id="verbatim-490"> /Span << /E (for example) >> BDC  <br />  BT  <br />    /F8 9.9626 Tf @@ -39570,7 +39425,7 @@ form:  <br />  ET  <br />EMC </div> -<!--l. 18971--><p class="nopar" > Similarly for <span class="obeylines-h"><span class="verb"><span +<!--l. 18984--><p class="nopar" > Similarly for <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrshort{eg}</span></span></span>. You can also use the <span class="cmss-10">debug</span><span class="cmtt-10">=</span><span @@ -39579,7 +39434,7 @@ class="cmss-10">showaccsupp</span><a the replacement text in the document, but note that this is the content before it’s processed by <span class="cmtt-10">\BeginAccSupp</span>. -</p><!--l. 18977--><p class="indent" > If the <span +</p><!--l. 18990--><p class="indent" > If the <span class="cmtt-10">\setacronymstyle</span><a id="dx1-224035"></a> command is removed (or commented out) then the result would be different. The <a @@ -39591,12 +39446,12 @@ class="cmtt-10">\setacronymstyle</span><a acronym mechanism that’s triggered with <span class="cmtt-10">\setacronymstyle</span><a id="dx1-224037"></a>. -</p><!--l. 18984--><p class="indent" > <div class="important" title="Important Note"> If you want to convert this example so that it uses <a +</p><!--l. 18997--><p class="indent" > <div class="important" title="Important Note"> If you want to convert this example so that it uses <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, make sure you have at least version 1.42 of the extension package. </div> -</p><!--l. 18988--><p class="noindent" > -</p><!--l. 18990--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 19001--><p class="noindent" > +</p><!--l. 19003--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a></span>If you want to convert this example so that it uses <a href="#glo:glossaries-extra"><span @@ -39633,7 +39488,7 @@ class="cmtt-10">makeglossaries-lite</span><a id="dx1-224044"></a></a> you don’t need to worry about it. However, if you’re not using those helper scripts then you will need to adjust the file extensions in your document build process. -<!--l. 19005--><p class="indent" > The style command <span +<!--l. 19018--><p class="indent" > The style command <span class="cmtt-10">\setacronymstyle{long-short} </span>needs to be replaced with: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -39686,7 +39541,7 @@ class="cmtt-10">\glsxtrlong</span></span><a <span id="textcolor1028"><span class="cmtt-10">\glsxtrfull</span></span><a id="dx1-224053"></a>. -<!--l. 19026--><p class="indent" > You may notice a slight difference from the original example. The <span +<!--l. 19039--><p class="indent" > You may notice a slight difference from the original example. The <span class="cmtt-10">shortaccess</span><a id="dx1-224054"></a> field now shows ⟨<span class="cmti-10">long</span>⟩ (⟨<span @@ -39698,9 +39553,9 @@ class="cmss-10">glossaries-extra</span></a> redefines <span class="cmtt-10">\glsdefaultshortaccess</span><a id="dx1-224055"></a> to include the short form. -</p><!--l. 19031--><p class="indent" > Now that the extension package is being used, there are some other modifications that would tidy up the +</p><!--l. 19044--><p class="indent" > Now that the extension package is being used, there are some other modifications that would tidy up the code and fix a few issues. -</p><!--l. 19034--><p class="indent" > The “Doctor” and “Drive” entries should really be defined as abbreviations but they shouldn’t be +</p><!--l. 19047--><p class="indent" > The “Doctor” and “Drive” entries should really be defined as abbreviations but they shouldn’t be expanded on first use. The <span id="textcolor1029"><span class="cmss-10">short-nolong</span></span><a id="dx1-224056"></a> style can achieve this and it happens to be the default style @@ -39719,22 +39574,22 @@ href="#glo:firstuse">first use</a> of <span class="obeylines-h"><span class="ver class="cmtt-10">\gls{Doctor}</span></span></span> is just “Dr”. This means that the “E” element will be used instead of “ActualText”. Now I don’t need to supply the accessibility text as its obtained from the long form. -<!--l. 19047--><p class="indent" > The “Drive” entry can be similarly defined but it has the awkward terminating full stop. This means that I +<!--l. 19060--><p class="indent" > The “Drive” entry can be similarly defined but it has the awkward terminating full stop. This means that I had to omit the end of sentence terminator in: </p> - <div class="verbatim" id="verbatim-490"> + <div class="verbatim" id="verbatim-491"> \gls{Doctor} Smith lives at 2, Blueberry \gls{Drive} </div> -<!--l. 19052--><p class="nopar" > This looks odd when reading the document source and it’s easy to forgot. This is very similar to the situation +<!--l. 19065--><p class="nopar" > This looks odd when reading the document source and it’s easy to forgot. This is very similar to the situation in the <a href="#ex:sample-dot-abbr"><span class="cmtt-10">sample-dot-abbr.tex</span></a> example. I can again use the <span id="textcolor1031"><span class="cmss-10">discardperiod</span></span><a id="dx1-224059"></a> attribute, but I need to assign a different category so that it doesn’t interfere with the “Doctor” entry. -</p><!--l. 19059--><p class="indent" > The category is simply a label that’s used in the construction of some internal command names. This means +</p><!--l. 19072--><p class="indent" > The category is simply a label that’s used in the construction of some internal command names. This means that it must be fully expandable, but I can choose whatever label I like (<span id="textcolor1032"><span class="cmss-10">general</span></span><a id="dx1-224060"></a>, <span id="textcolor1033"><span @@ -39751,7 +39606,7 @@ class="cmss-10">number</span></span><a id="dx1-224065"></a> are used by various commands provided by <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>). -</p><!--l. 19066--><p class="indent" > In this case, I’ve decided to have a category called <span +</p><!--l. 19079--><p class="indent" > In this case, I’ve decided to have a category called <span class="cmtt-10">shortdotted </span>to indicate an abbreviation that ends with a dot but only the short form is shown on <a href="#glo:firstuse">first use</a>: </p><div class="alltt"> @@ -39783,13 +39638,13 @@ class="cmtt-10">\@</span><a example: - <div class="verbatim" id="verbatim-491"> + <div class="verbatim" id="verbatim-492"> \gls{Doctor} Smith lives at 2, Blueberry \gls{Drive}. Next sentence.  <br />\gls{Doctor} Smith lives at 2, Blueberry \gls{Drive} end of sentence. </div> -<!--l. 19084--><p class="nopar" > (The spacing is more noticeable if you first switch to a monospaced font with <span +<!--l. 19097--><p class="nopar" > (The spacing is more noticeable if you first switch to a monospaced font with <span class="cmtt-10">\ttfamily</span>.) -</p><!--l. 19088--><p class="indent" > The “e.g.” abbreviation similarly ends with a dot. It’s not usual to write “for example (e.g.)” in a +</p><!--l. 19101--><p class="indent" > The “e.g.” abbreviation similarly ends with a dot. It’s not usual to write “for example (e.g.)” in a document, so it really ought to have the same <span class="cmtt-10">shortdotted </span>category, but it has a long-short form for illustrative purposes in this test document. In this case I need to choose another category so that I can apply a different @@ -39811,7 +39666,7 @@ class="cmtt-10">[category=longshortdotted]{e.g.}{e.g.\@}{for</span> class="cmtt-10">example}</span> </div> </div> -<!--l. 19101--><p class="indent" > To further illustrate categories, let’s suppose the symbol and image should be in the <span +<!--l. 19114--><p class="indent" > To further illustrate categories, let’s suppose the symbol and image should be in the <span class="cmtt-10">name</span><a id="dx1-224075"></a> field instead of the <span @@ -39823,7 +39678,7 @@ class="cmtt-10">\glssymbolaccsupp </span>and <span class="cmtt-10">\glsuseriaccsupp </span>commands won’t be used. I can’t deal with both cases if I just provide <span class="cmtt-10">\glsnameaccsupp</span>. -</p><!--l. 19108--><p class="indent" > I could provide category-field versions, such as <span id="textcolor1046"><span +</p><!--l. 19121--><p class="indent" > I could provide category-field versions, such as <span id="textcolor1046"><span class="cmtt-10">\glsxtrsymbolnameaccsupp</span></span>, but remember that this only covers accessing the <span class="cmtt-10">name</span><a @@ -39929,15 +39784,15 @@ class="cmtt-10">accsupp</span></span><a id="dx1-224087"></a>. <a id="x1-224088r41"></a> -<!--l. 19139--><p class="noindent" > +<!--l. 19152--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-ignored"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-ignored">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-ignored.tex" ><span class="cmtt-10">sample-ignored.tex</span></a></h4> -<!--l. 19139--><p class="noindent" >This document defines an ignored glossary for common terms that don’t need a definition. The document build +<!--l. 19152--><p class="noindent" >This document defines an ignored glossary for common terms that don’t need a definition. The document build is: -</p><!--l. 19141--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 19154--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-ignored <br />makeglossaries sample-ignored <br />pdflatex sample-ignored @@ -39954,23 +39809,23 @@ class="cmtt-10">{common}</span> type: - <div class="verbatim" id="verbatim-492"> + <div class="verbatim" id="verbatim-493"> \newglossaryentry{commonex}{type=common,name={common term}} </div> -<!--l. 19154--><p class="nopar" > Note that the <span +<!--l. 19167--><p class="nopar" > Note that the <span class="cmtt-10">description</span><a id="dx1-225002"></a> key isn’t required. This term may be referenced with <span class="cmtt-10">\gls </span>(which is useful for consistent formatting) but it won’t be indexed. <a id="x1-225003r42"></a> -</p><!--l. 19159--><p class="noindent" > +</p><!--l. 19172--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="ex:sample-entrycount"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#ex:sample-entrycount">🔗</a><a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sample-entrycount.tex" ><span class="cmtt-10">sample-entrycount.tex</span></a></h4> -<!--l. 19159--><p class="noindent" >This document uses <span +<!--l. 19172--><p class="noindent" >This document uses <span class="cmtt-10">\glsenableentrycount</span><a id="dx1-226001"></a> and <span class="cmtt-10">\cgls</span><a @@ -39979,26 +39834,24 @@ href="#sec:enableentrycount">§14.1 </a><a href="#sec:enableentrycount">Counting the Number of Times an Entry has been Used (First Use Flag Unset)<!--tex4ht:ref: sec:enableentrycount --></a>) so that acronyms only used once don’t appear in the list of acronyms. The document build is: -</p><!--l. 19163--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 19176--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-entrycount <br />pdflatex sample-entrycount <br />makeglossaries sample-entrycount <br />pdflatex sample-entrycount <br /></pre><spacer type=vertical size=10> <br /></span> -Note the need to call <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> twice before <a +Note the need to call LaTeX twice before <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-226003"></a></a>, and then a final <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> call is required at the + id="dx1-226003"></a></a>, and then a final LaTeX call is required at the end. -</p><!--l. 19172--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 19185--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package has additions that extend this mechanism and comes with some other sample files related to entry counting. </div> -</p><!--l. 19175--><p class="noindent" > -</p><!--l. 19177--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you switch to <a +</p><!--l. 19188--><p class="noindent" > +</p><!--l. 19190--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-226004"></a></a> you can use record counting instead. See the <a @@ -40006,15 +39859,15 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-226005"></a></a> manual for further details. </div> -</p><!--l. 19180--><p class="noindent" > +</p><!--l. 19193--><p class="noindent" > </p> -<!--l. 19182--><p class="indent" > </div> -</p><!--l. 19182--><p class="noindent" ><a +<!--l. 19195--><p class="indent" > </div> +</p><!--l. 19195--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">20. <a id="sec:trouble"></a>Troubleshooting</h2> -</p><!--l. 19185--><p class="indent" > In addition to the sample files listed in <a +</p><!--l. 19198--><p class="indent" > In addition to the sample files listed in <a href="#sec:samples">§19 </a><a href="#sec:samples">Sample Documents<!--tex4ht:ref: sec:samples --></a>, the <span class="cmss-10">glossaries </span>package comes with some @@ -40026,27 +39879,23 @@ class="cmtt-10">mwe-acr-desc.tex</span>, which can be used for testing. These should be located in the <span class="cmtt-10">samples </span>subdirectory (folder) of the <span class="cmss-10">glossaries </span>documentation -directory. The location varies according to your operating system and <span class="TEX">T<span -class="E">E</span>X</span> installation. For example, on my +directory. The location varies according to your operating system and TeX installation. For example, on my Linux partition it can be found in <span class="cmtt-10">/usr/local/texlive/2014/texmf-dist/doc/latex/glossaries/</span>. The <a href="#glo:makeglossariesgui"><span class="cmtt-10">makeglossariesgui</span><a id="dx1-227001"></a></a> application can also be used to test for various problems. Further information on -debugging <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> code is available at <a +debugging LaTeX code is available at <a href="http://www.dickimaw-books.com/latex/minexample/" class="url" ><span class="cmtt-10">http://www.dickimaw-books.com/latex/minexample/</span></a>. -</p><!--l. 19200--><p class="indent" > If you have any problems, please first consult the <a +</p><!--l. 19213--><p class="indent" > If you have any problems, please first consult the <a href="http://www.dickimaw-books.com/faqs/glossariesfaq.html" ><span class="cmss-10">glossaries </span>FAQ</a>. If that doesn’t help, try posting your query to somewhere like the <span class="cmtt-10">comp.text.tex </span>newsgroup, the <a -href="http://www.latex-community.org/" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> Community Forum</a> or <a -href="http://tex.stackexchange.com/" ><span class="TEX">T<span -class="E">E</span>X</span> on StackExchange</a>. +href="http://www.latex-community.org/" >LaTeX Community Forum</a> or <a +href="http://tex.stackexchange.com/" >TeX on StackExchange</a>. Bug reports can be submitted via <a href="http://www.dickimaw-books.com/bug-report.html" >my package bug report form</a>. @@ -41228,9 +41077,9 @@ class="cmss-10">etoolbox </span>package  <a href="glossaries-user.html#dx1-7" >735</a>, <a href="glossaries-user.html#dx1-73041" >736</a>, <a href="glossaries-user.html#dx1-135018" >737</a>, <a -href="glossaries-user.html#dx1-169030" >738</a>, <a -href="glossaries-user.html#dx1-169033" >739</a>, <a -href="glossaries-user.html#dx1-169035" >740</a>, <a +href="glossaries-user.html#dx1-169031" >738</a>, <a +href="glossaries-user.html#dx1-169034" >739</a>, <a +href="glossaries-user.html#dx1-169036" >740</a>, <a href="glossaries-user.html#dx1-200040" >741</a>, <a href="glossaries-user.html#dx1-200050" >742</a> <br /></span> <span class="index-item">Extended Latin Alphabet  <a @@ -42491,7 +42340,7 @@ href="glossaries-user.html#dx1-200033" >1487</a>, <a href="glossaries-user.html#dx1-202029" >1488</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glscurrentfieldvalue</span></span></span>  <a -href="glossaries-user.html#dx1-169027" ><span +href="glossaries-user.html#dx1-169028" ><span class="cmti-10">1489</span></a>, <a href="glossaries-user.html#dx1-200024" >1490</a>, <a href="glossaries-user.html#dx1-202025" >1491</a> <br /></span> @@ -42608,23 +42457,23 @@ href="glossaries-user.html#dx1-220039" >1559</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdoifexists</span></span></span>  <a -href="glossaries-user.html#dx1-169005" ><span +href="glossaries-user.html#dx1-169006" ><span class="cmti-10">1560</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdoifexistsordo</span></span></span>  <a -href="glossaries-user.html#dx1-169008" ><span +href="glossaries-user.html#dx1-169009" ><span class="cmti-10">1561</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdoifexistsorwarn</span></span></span>  <a -href="glossaries-user.html#dx1-169007" ><span +href="glossaries-user.html#dx1-169008" ><span class="cmti-10">1562</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdoifnoexists</span></span></span>  <a -href="glossaries-user.html#dx1-169006" ><span +href="glossaries-user.html#dx1-169007" ><span class="cmti-10">1563</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdoifnoexistsordo</span></span></span>  <a -href="glossaries-user.html#dx1-169009" ><span +href="glossaries-user.html#dx1-169010" ><span class="cmti-10">1564</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdosanitizesort</span></span></span>  <a @@ -44561,37 +44410,37 @@ href="glossaries-user.html#dx1-169001" ><span class="cmti-10">2452</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsdescsuppressed</span></span></span>  <a -href="glossaries-user.html#dx1-169023" ><span +href="glossaries-user.html#dx1-169024" ><span class="cmti-10">2453</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsentryexists</span></span></span>  <a -href="glossaries-user.html#dx1-169002" ><span +href="glossaries-user.html#dx1-169003" ><span class="cmti-10">2454</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsfieldcseq</span></span></span>  <a -href="glossaries-user.html#dx1-169034" ><span +href="glossaries-user.html#dx1-169035" ><span class="cmti-10">2455</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsfielddefeq</span></span></span>  <a -href="glossaries-user.html#dx1-169032" ><span +href="glossaries-user.html#dx1-169033" ><span class="cmti-10">2456</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsfieldeq</span></span></span>  <a href="glossaries-user.html#dx1-150085" >2457</a>, <a -href="glossaries-user.html#dx1-169029" ><span +href="glossaries-user.html#dx1-169030" ><span class="cmti-10">2458</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshaschildren</span></span></span>  <a -href="glossaries-user.html#dx1-169011" ><span +href="glossaries-user.html#dx1-169012" ><span class="cmti-10">2459</span></a>, <a href="glossaries-user.html#dx1-200036" >2460</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasdesc</span></span></span>  <a -href="glossaries-user.html#dx1-169021" ><span +href="glossaries-user.html#dx1-169022" ><span class="cmti-10">2461</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasfield</span></span></span>  <a -href="glossaries-user.html#dx1-169026" ><span +href="glossaries-user.html#dx1-169027" ><span class="cmti-10">2462</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshaslong</span></span></span>  <a @@ -44599,11 +44448,11 @@ href="glossaries-user.html#dx1-34021" >2463</a>, <a href="glossaries-user.html#dx1-117009" >2464</a>, <a href="glossaries-user.html#dx1-117010" >2465</a>, <a href="glossaries-user.html#dx1-150013" >2466</a>, <a -href="glossaries-user.html#dx1-169015" ><span +href="glossaries-user.html#dx1-169016" ><span class="cmti-10">2467</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasparent</span></span></span>  <a -href="glossaries-user.html#dx1-169012" ><span +href="glossaries-user.html#dx1-169013" ><span class="cmti-10">2468</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasprefix</span></span></span>  <a @@ -44624,14 +44473,14 @@ class="cmti-10">2472</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasshort</span></span></span>  <a href="glossaries-user.html#dx1-150012" >2473</a>, <a -href="glossaries-user.html#dx1-169018" ><span +href="glossaries-user.html#dx1-169019" ><span class="cmti-10">2474</span></a>, <a href="glossaries-user.html#dx1-179026" >2475</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshassymbol</span></span></span>  <a href="glossaries-user.html#dx1-11052" >2476</a>, <a href="glossaries-user.html#dx1-166088" >2477</a>, <a -href="glossaries-user.html#dx1-169013" ><span +href="glossaries-user.html#dx1-169014" ><span class="cmti-10">2478</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsucmark</span></span></span>  <a @@ -44644,7 +44493,7 @@ href="glossaries-user.html#dx1-150004" >2482</a>, <a href="glossaries-user.html#dx1-150089" >2483</a>, <a href="glossaries-user.html#dx1-153011" ><span class="cmti-10">2484</span></a>, <a -href="glossaries-user.html#dx1-169010" ><span +href="glossaries-user.html#dx1-169011" ><span class="cmti-10">2485</span></a>, <a href="glossaries-user.html#dx1-178003" >2486</a>, <a href="glossaries-user.html#dx1-178004" >2487</a>, <a @@ -45382,8 +45231,8 @@ href="glossaries-user.html#dx1-150023" >3067</a>, <a href="glossaries-user.html#dx1-150083" >3068</a>, <a href="glossaries-user.html#dx1-152006" >3069</a>, <a href="glossaries-user.html#dx1-154002" >3070</a>, <a -href="glossaries-user.html#dx1-169017" >3071</a>, <a -href="glossaries-user.html#dx1-169020" >3072</a>, <a +href="glossaries-user.html#dx1-169018" >3071</a>, <a +href="glossaries-user.html#dx1-169021" >3072</a>, <a href="glossaries-user.html#dx1-172033" >3073</a>, <a href="glossaries-user.html#dx1-172036" >3074</a>, <a href="glossaries-user.html#dx1-172039" >3075</a>, <a @@ -45522,8 +45371,8 @@ href="glossaries-user.html#dx1-149027" >3181</a>, <a href="glossaries-user.html#dx1-149044" >3182</a>, <a href="glossaries-user.html#dx1-149072" >3183</a>, <a href="glossaries-user.html#dx1-150029" >3184</a>, <a -href="glossaries-user.html#dx1-169022" >3185</a>, <a -href="glossaries-user.html#dx1-169024" >3186</a>, <a +href="glossaries-user.html#dx1-169023" >3185</a>, <a +href="glossaries-user.html#dx1-169025" >3186</a>, <a href="glossaries-user.html#dx1-172028" >3187</a>, <a href="glossaries-user.html#dx1-179077" >3188</a>, <a href="glossaries-user.html#dx1-197012" >3189</a>, <a @@ -45617,7 +45466,7 @@ href="glossaries-user.html#dx1-135051" >3258</a>, <a href="glossaries-user.html#dx1-147010" >3259</a>, <a href="glossaries-user.html#dx1-147066" >3260</a>, <a href="glossaries-user.html#dx1-148005" >3261</a>, <a -href="glossaries-user.html#dx1-169016" >3262</a>, <a +href="glossaries-user.html#dx1-169017" >3262</a>, <a href="glossaries-user.html#dx1-172032" >3263</a>, <a href="glossaries-user.html#dx1-184072" >3264</a> <br /></span> <span class="index-subitem">    <span @@ -45831,7 +45680,7 @@ href="glossaries-user.html#dx1-135052" >3439</a>, <a href="glossaries-user.html#dx1-147012" >3440</a>, <a href="glossaries-user.html#dx1-147055" >3441</a>, <a href="glossaries-user.html#dx1-148006" >3442</a>, <a -href="glossaries-user.html#dx1-169019" >3443</a>, <a +href="glossaries-user.html#dx1-169020" >3443</a>, <a href="glossaries-user.html#dx1-172035" >3444</a>, <a href="glossaries-user.html#dx1-172068" >3445</a>, <a href="glossaries-user.html#dx1-179067" >3446</a>, <a @@ -45945,7 +45794,7 @@ href="glossaries-user.html#dx1-134046" >3541</a>, <a href="glossaries-user.html#dx1-135077" >3542</a>, <a href="glossaries-user.html#dx1-135086" >3543</a>, <a href="glossaries-user.html#dx1-150065" >3544</a>, <a -href="glossaries-user.html#dx1-169014" >3545</a>, <a +href="glossaries-user.html#dx1-169015" >3545</a>, <a href="glossaries-user.html#dx1-172024" >3546</a>, <a href="glossaries-user.html#dx1-189028" >3547</a>, <a href="glossaries-user.html#dx1-189037" >3548</a>, <a @@ -46026,8 +45875,8 @@ href="glossaries-user.html#dx1-118014" >3608</a>, <a href="glossaries-user.html#dx1-134056" >3609</a>, <a href="glossaries-user.html#dx1-166098" >3610</a>, <a href="glossaries-user.html#dx1-166101" >3611</a>, <a -href="glossaries-user.html#dx1-169028" >3612</a>, <a -href="glossaries-user.html#dx1-169031" >3613</a>, <a +href="glossaries-user.html#dx1-169029" >3612</a>, <a +href="glossaries-user.html#dx1-169032" >3613</a>, <a href="glossaries-user.html#dx1-172044" >3614</a>, <a href="glossaries-user.html#dx1-189036" >3615</a>, <a href="glossaries-user.html#dx1-189044" >3616</a>, <a @@ -46099,1790 +45948,1795 @@ href="glossaries-user.html#dx1-123003" >3654</a>, <a href="glossaries-user.html#dx1-141020" >3655</a>, <a href="glossaries-user.html#dx1-146010" ><span class="cmti-10">3656</span></a>, <a -href="glossaries-user.html#dx1-225001" >3657</a> <br /></span> +href="glossaries-user.html#dx1-169002" >3657</a>, <a +href="glossaries-user.html#dx1-225001" >3658</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newline</span></span></span>  <a -href="glossaries-user.html#dx1-112023" >3658</a>, <a -href="glossaries-user.html#dx1-156026" >3659</a> <br /></span> +href="glossaries-user.html#dx1-112023" >3659</a>, <a +href="glossaries-user.html#dx1-156026" >3660</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newterm</span></span></span>  <a href="glossaries-user.html#dx1-87001" ><span -class="cmti-10">3660</span></a>, <a -href="glossaries-user.html#dx1-138014" >3661</a> <br /></span> +class="cmti-10">3661</span></a>, <a +href="glossaries-user.html#dx1-138014" >3662</a> <br /></span> <span class="index-item"><span class="cmss-10">ngerman </span>package  <a -href="glossaries-user.html#dx1-13029" >3662</a>, <a -href="glossaries-user.html#dx1-13038" >3663</a>, <a -href="glossaries-user.html#dx1-13047" >3664</a>, <a -href="glossaries-user.html#dx1-142013" >3665</a> <br /></span> +href="glossaries-user.html#dx1-13029" >3663</a>, <a +href="glossaries-user.html#dx1-13038" >3664</a>, <a +href="glossaries-user.html#dx1-13047" >3665</a>, <a +href="glossaries-user.html#dx1-142013" >3666</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\nohyperpage</span></span></span>  <a -href="glossaries-user.html#dx1-130013" >3666</a> <br /></span> +href="glossaries-user.html#dx1-130013" >3667</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\noist</span></span></span>  <a href="glossaries-user.html#dx1-111008" ><span -class="cmti-10">3667</span></a>, <a -href="glossaries-user.html#dx1-130006" >3668</a>, <a -href="glossaries-user.html#dx1-130015" >3669</a>, <a -href="glossaries-user.html#dx1-142017" >3670</a>, <a -href="glossaries-user.html#dx1-143012" >3671</a>, <a -href="glossaries-user.html#dx1-144024" >3672</a>, <a -href="glossaries-user.html#dx1-144029" >3673</a>, <a -href="glossaries-user.html#dx1-144062" >3674</a>, <a -href="glossaries-user.html#dx1-144068" >3675</a>, <a -href="glossaries-user.html#dx1-145008" >3676</a>, <a -href="glossaries-user.html#dx1-211009" >3677</a>, <a -href="glossaries-user.html#dx1-211021" >3678</a> <br /></span> +class="cmti-10">3668</span></a>, <a +href="glossaries-user.html#dx1-130006" >3669</a>, <a +href="glossaries-user.html#dx1-130015" >3670</a>, <a +href="glossaries-user.html#dx1-142017" >3671</a>, <a +href="glossaries-user.html#dx1-143012" >3672</a>, <a +href="glossaries-user.html#dx1-144024" >3673</a>, <a +href="glossaries-user.html#dx1-144029" >3674</a>, <a +href="glossaries-user.html#dx1-144062" >3675</a>, <a +href="glossaries-user.html#dx1-144068" >3676</a>, <a +href="glossaries-user.html#dx1-145008" >3677</a>, <a +href="glossaries-user.html#dx1-211009" >3678</a>, <a +href="glossaries-user.html#dx1-211021" >3679</a> <br /></span> <span class="index-item">Non-Latin Alphabet  <a href="glossaries-user.html#dx1-3054" ><span -class="cmbx-10">3679</span></a> <br /></span> +class="cmbx-10">3680</span></a> <br /></span> <span class="index-item">non-Latin character  <a -href="glossaries-user.html#dx1-3020" >3680</a>, <a -href="glossaries-user.html#dx1-3055" >3681</a>, <a +href="glossaries-user.html#dx1-3020" >3681</a>, <a +href="glossaries-user.html#dx1-3055" >3682</a>, <a href="glossaries-user.html#dx1-3056" ><span -class="cmbx-10">3682</span></a>, <a -href="glossaries-user.html#dx1-13013" >3683</a>, <a -href="glossaries-user.html#dx1-13016" >3684</a>, <a -href="glossaries-user.html#dx1-14055" >3685</a>, <a -href="glossaries-user.html#dx1-15011" >3686</a>, <a -href="glossaries-user.html#dx1-112008" >3687</a>, <a -href="glossaries-user.html#dx1-112151" >3688</a>, <a -href="glossaries-user.html#dx1-112159" >3689</a>, <a -href="glossaries-user.html#dx1-214004" >3690</a> <br /></span> +class="cmbx-10">3683</span></a>, <a +href="glossaries-user.html#dx1-13013" >3684</a>, <a +href="glossaries-user.html#dx1-13016" >3685</a>, <a +href="glossaries-user.html#dx1-14055" >3686</a>, <a +href="glossaries-user.html#dx1-15011" >3687</a>, <a +href="glossaries-user.html#dx1-112008" >3688</a>, <a +href="glossaries-user.html#dx1-112151" >3689</a>, <a +href="glossaries-user.html#dx1-112159" >3690</a>, <a +href="glossaries-user.html#dx1-214004" >3691</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\nopostdesc</span></span></span>  <a -href="glossaries-user.html#dx1-87003" >3691</a>, <a +href="glossaries-user.html#dx1-87003" >3692</a>, <a href="glossaries-user.html#dx1-112021" ><span -class="cmti-10">3692</span></a>, <a -href="glossaries-user.html#dx1-120004" >3693</a>, <a -href="glossaries-user.html#dx1-121002" >3694</a>, <a -href="glossaries-user.html#dx1-156040" >3695</a>, <a -href="glossaries-user.html#dx1-169025" >3696</a>, <a -href="glossaries-user.html#dx1-197011" >3697</a>, <a -href="glossaries-user.html#dx1-197016" >3698</a>, <a -href="glossaries-user.html#dx1-200011" >3699</a>, <a -href="glossaries-user.html#dx1-200013" >3700</a>, <a -href="glossaries-user.html#dx1-200015" >3701</a>, <a -href="glossaries-user.html#dx1-202017" >3702</a>, <a -href="glossaries-user.html#dx1-206010" >3703</a> <br /></span> +class="cmti-10">3693</span></a>, <a +href="glossaries-user.html#dx1-120004" >3694</a>, <a +href="glossaries-user.html#dx1-121002" >3695</a>, <a +href="glossaries-user.html#dx1-156040" >3696</a>, <a +href="glossaries-user.html#dx1-169026" >3697</a>, <a +href="glossaries-user.html#dx1-197011" >3698</a>, <a +href="glossaries-user.html#dx1-197016" >3699</a>, <a +href="glossaries-user.html#dx1-200011" >3700</a>, <a +href="glossaries-user.html#dx1-200013" >3701</a>, <a +href="glossaries-user.html#dx1-200015" >3702</a>, <a +href="glossaries-user.html#dx1-202017" >3703</a>, <a +href="glossaries-user.html#dx1-206010" >3704</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\nopostdot</span></span></span>  <a -href="glossaries-user.html#dx1-202034" >3704</a> <br /></span> +href="glossaries-user.html#dx1-202034" >3705</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\null</span></span></span>  <a -href="glossaries-user.html#dx1-141009" >3705</a>, <a -href="glossaries-user.html#dx1-141010" >3706</a> <br /></span> +href="glossaries-user.html#dx1-141009" >3706</a>, <a +href="glossaries-user.html#dx1-141010" >3707</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\number</span></span></span>  <a -href="glossaries-user.html#dx1-129027" >3707</a> <br /></span> +href="glossaries-user.html#dx1-129027" >3708</a> <br /></span> <span class="index-item">number list  <a href="glossaries-user.html#dx1-3059" ><span -class="cmbx-10">3708</span></a>, <a -href="glossaries-user.html#dx1-6019" >3709</a>, <a -href="glossaries-user.html#dx1-7011" >3710</a>, <a -href="glossaries-user.html#dx1-9038" >3711</a>, <a -href="glossaries-user.html#dx1-10006" >3712</a>, <a -href="glossaries-user.html#dx1-16007" >3713</a>, <a -href="glossaries-user.html#dx1-16077" >3714</a>, <a -href="glossaries-user.html#dx1-31006" >3715</a>, <a -href="glossaries-user.html#dx1-45001" >3716</a>, <a -href="glossaries-user.html#dx1-45009" >3717</a>, <a -href="glossaries-user.html#dx1-55001" >3718</a>, <a -href="glossaries-user.html#dx1-55004" >3719</a>, <a -href="glossaries-user.html#dx1-55007" >3720</a>, <a -href="glossaries-user.html#dx1-55008" >3721</a>, <a -href="glossaries-user.html#dx1-56001" >3722</a>, <a -href="glossaries-user.html#dx1-57002" >3723</a>, <a -href="glossaries-user.html#dx1-67005" >3724</a>, <a -href="glossaries-user.html#dx1-111016" >3725</a>, <a -href="glossaries-user.html#dx1-111020" >3726</a>, <a -href="glossaries-user.html#dx1-111021" >3727</a>, <a -href="glossaries-user.html#dx1-112111" >3728</a>, <a -href="glossaries-user.html#dx1-112113" >3729</a>, <a -href="glossaries-user.html#dx1-112117" >3730</a>, <a -href="glossaries-user.html#dx1-112118" >3731</a>, <a -href="glossaries-user.html#dx1-119002" >3732</a>, <a -href="glossaries-user.html#dx1-121003" >3733</a>, <a -href="glossaries-user.html#dx1-127001" >3734</a>, <a -href="glossaries-user.html#dx1-127005" >3735</a>, <a -href="glossaries-user.html#dx1-127011" >3736</a>, <a -href="glossaries-user.html#dx1-127012" >3737</a>, <a -href="glossaries-user.html#dx1-127014" >3738</a>, <a -href="glossaries-user.html#dx1-128001" >3739</a>, <a -href="glossaries-user.html#dx1-128006" >3740</a>, <a -href="glossaries-user.html#dx1-128007" >3741</a>, <a -href="glossaries-user.html#dx1-128010" >3742</a>, <a -href="glossaries-user.html#dx1-128015" >3743</a>, <a -href="glossaries-user.html#dx1-129018" >3744</a>, <a -href="glossaries-user.html#dx1-130018" >3745</a>, <a -href="glossaries-user.html#dx1-130021" >3746</a>, <a -href="glossaries-user.html#dx1-132004" >3747</a>, <a -href="glossaries-user.html#dx1-132009" >3748</a>, <a -href="glossaries-user.html#dx1-137008" >3749</a>, <a -href="glossaries-user.html#dx1-138019" >3750</a>, <a -href="glossaries-user.html#dx1-138020" >3751</a>, <a -href="glossaries-user.html#dx1-138021" >3752</a>, <a -href="glossaries-user.html#dx1-138025" >3753</a>, <a -href="glossaries-user.html#dx1-140061" >3754</a>, <a -href="glossaries-user.html#dx1-141013" >3755</a>, <a -href="glossaries-user.html#dx1-144002" >3756</a>, <a -href="glossaries-user.html#dx1-144054" >3757</a>, <a -href="glossaries-user.html#dx1-144065" >3758</a>, <a -href="glossaries-user.html#dx1-146002" >3759</a>, <a -href="glossaries-user.html#dx1-157014" >3760</a>, <a -href="glossaries-user.html#dx1-157038" >3761</a>, <a -href="glossaries-user.html#dx1-157041" >3762</a>, <a -href="glossaries-user.html#dx1-158011" >3763</a>, <a -href="glossaries-user.html#dx1-158021" >3764</a>, <a -href="glossaries-user.html#dx1-159011" >3765</a>, <a -href="glossaries-user.html#dx1-159021" >3766</a>, <a -href="glossaries-user.html#dx1-161016" >3767</a>, <a -href="glossaries-user.html#dx1-161026" >3768</a>, <a -href="glossaries-user.html#dx1-162013" >3769</a>, <a -href="glossaries-user.html#dx1-162023" >3770</a>, <a -href="glossaries-user.html#dx1-165003" >3771</a>, <a -href="glossaries-user.html#dx1-166039" >3772</a>, <a -href="glossaries-user.html#dx1-166080" >3773</a>, <a -href="glossaries-user.html#dx1-176001" >3774</a>, <a -href="glossaries-user.html#dx1-188005" >3775</a>, <a -href="glossaries-user.html#dx1-189001" >3776</a>, <a -href="glossaries-user.html#dx1-189066" >3777</a>, <a -href="glossaries-user.html#dx1-189070" >3778</a>, <a -href="glossaries-user.html#dx1-190011" >3779</a>, <a -href="glossaries-user.html#dx1-193028" >3780</a>, <a -href="glossaries-user.html#dx1-193034" >3781</a>, <a -href="glossaries-user.html#dx1-193035" >3782</a>, <a -href="glossaries-user.html#dx1-193036" >3783</a>, <a -href="glossaries-user.html#dx1-204031" >3784</a>, <a -href="glossaries-user.html#dx1-204033" >3785</a>, <a -href="glossaries-user.html#dx1-211016" >3786</a>, <a -href="glossaries-user.html#dx1-214016" >3787</a>, <a -href="glossaries-user.html#dx1-214034" >3788</a>, <a -href="glossaries-user.html#dx1-216004" >3789</a>, <a -href="glossaries-user.html#dx1-220001" >3790</a>, <a -href="glossaries-user.html#dx1-220005" >3791</a>, <a -href="glossaries-user.html#dx1-220006" >3792</a>, <a -href="glossaries-user.html#dx1-220009" >3793</a>, <a -href="glossaries-user.html#dx1-220030" >3794</a>, <a -href="glossaries-user.html#dx1-220033" >3795</a> <br /></span> +class="cmbx-10">3709</span></a>, <a +href="glossaries-user.html#dx1-6019" >3710</a>, <a +href="glossaries-user.html#dx1-7011" >3711</a>, <a +href="glossaries-user.html#dx1-9038" >3712</a>, <a +href="glossaries-user.html#dx1-10006" >3713</a>, <a +href="glossaries-user.html#dx1-16007" >3714</a>, <a +href="glossaries-user.html#dx1-16077" >3715</a>, <a +href="glossaries-user.html#dx1-31006" >3716</a>, <a +href="glossaries-user.html#dx1-45001" >3717</a>, <a +href="glossaries-user.html#dx1-45009" >3718</a>, <a +href="glossaries-user.html#dx1-55001" >3719</a>, <a +href="glossaries-user.html#dx1-55004" >3720</a>, <a +href="glossaries-user.html#dx1-55007" >3721</a>, <a +href="glossaries-user.html#dx1-55008" >3722</a>, <a +href="glossaries-user.html#dx1-56001" >3723</a>, <a +href="glossaries-user.html#dx1-57002" >3724</a>, <a +href="glossaries-user.html#dx1-67005" >3725</a>, <a +href="glossaries-user.html#dx1-111016" >3726</a>, <a +href="glossaries-user.html#dx1-111020" >3727</a>, <a +href="glossaries-user.html#dx1-111021" >3728</a>, <a +href="glossaries-user.html#dx1-112111" >3729</a>, <a +href="glossaries-user.html#dx1-112113" >3730</a>, <a +href="glossaries-user.html#dx1-112117" >3731</a>, <a +href="glossaries-user.html#dx1-112118" >3732</a>, <a +href="glossaries-user.html#dx1-119002" >3733</a>, <a +href="glossaries-user.html#dx1-121003" >3734</a>, <a +href="glossaries-user.html#dx1-127001" >3735</a>, <a +href="glossaries-user.html#dx1-127005" >3736</a>, <a +href="glossaries-user.html#dx1-127011" >3737</a>, <a +href="glossaries-user.html#dx1-127012" >3738</a>, <a +href="glossaries-user.html#dx1-127014" >3739</a>, <a +href="glossaries-user.html#dx1-128001" >3740</a>, <a +href="glossaries-user.html#dx1-128006" >3741</a>, <a +href="glossaries-user.html#dx1-128007" >3742</a>, <a +href="glossaries-user.html#dx1-128010" >3743</a>, <a +href="glossaries-user.html#dx1-128015" >3744</a>, <a +href="glossaries-user.html#dx1-129018" >3745</a>, <a +href="glossaries-user.html#dx1-130018" >3746</a>, <a +href="glossaries-user.html#dx1-130021" >3747</a>, <a +href="glossaries-user.html#dx1-132004" >3748</a>, <a +href="glossaries-user.html#dx1-132009" >3749</a>, <a +href="glossaries-user.html#dx1-137008" >3750</a>, <a +href="glossaries-user.html#dx1-138019" >3751</a>, <a +href="glossaries-user.html#dx1-138020" >3752</a>, <a +href="glossaries-user.html#dx1-138021" >3753</a>, <a +href="glossaries-user.html#dx1-138025" >3754</a>, <a +href="glossaries-user.html#dx1-140061" >3755</a>, <a +href="glossaries-user.html#dx1-141013" >3756</a>, <a +href="glossaries-user.html#dx1-144002" >3757</a>, <a +href="glossaries-user.html#dx1-144054" >3758</a>, <a +href="glossaries-user.html#dx1-144065" >3759</a>, <a +href="glossaries-user.html#dx1-146002" >3760</a>, <a +href="glossaries-user.html#dx1-157014" >3761</a>, <a +href="glossaries-user.html#dx1-157038" >3762</a>, <a +href="glossaries-user.html#dx1-157041" >3763</a>, <a +href="glossaries-user.html#dx1-158011" >3764</a>, <a +href="glossaries-user.html#dx1-158021" >3765</a>, <a +href="glossaries-user.html#dx1-159011" >3766</a>, <a +href="glossaries-user.html#dx1-159021" >3767</a>, <a +href="glossaries-user.html#dx1-161016" >3768</a>, <a +href="glossaries-user.html#dx1-161026" >3769</a>, <a +href="glossaries-user.html#dx1-162013" >3770</a>, <a +href="glossaries-user.html#dx1-162023" >3771</a>, <a +href="glossaries-user.html#dx1-165003" >3772</a>, <a +href="glossaries-user.html#dx1-166039" >3773</a>, <a +href="glossaries-user.html#dx1-166080" >3774</a>, <a +href="glossaries-user.html#dx1-176001" >3775</a>, <a +href="glossaries-user.html#dx1-188005" >3776</a>, <a +href="glossaries-user.html#dx1-189001" >3777</a>, <a +href="glossaries-user.html#dx1-189066" >3778</a>, <a +href="glossaries-user.html#dx1-189070" >3779</a>, <a +href="glossaries-user.html#dx1-190011" >3780</a>, <a +href="glossaries-user.html#dx1-193028" >3781</a>, <a +href="glossaries-user.html#dx1-193034" >3782</a>, <a +href="glossaries-user.html#dx1-193035" >3783</a>, <a +href="glossaries-user.html#dx1-193036" >3784</a>, <a +href="glossaries-user.html#dx1-204031" >3785</a>, <a +href="glossaries-user.html#dx1-204033" >3786</a>, <a +href="glossaries-user.html#dx1-211016" >3787</a>, <a +href="glossaries-user.html#dx1-214016" >3788</a>, <a +href="glossaries-user.html#dx1-214034" >3789</a>, <a +href="glossaries-user.html#dx1-216004" >3790</a>, <a +href="glossaries-user.html#dx1-220001" >3791</a>, <a +href="glossaries-user.html#dx1-220005" >3792</a>, <a +href="glossaries-user.html#dx1-220006" >3793</a>, <a +href="glossaries-user.html#dx1-220009" >3794</a>, <a +href="glossaries-user.html#dx1-220030" >3795</a>, <a +href="glossaries-user.html#dx1-220033" >3796</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\numberline</span></span></span>  <a -href="glossaries-user.html#dx1-40002" >3796</a> <br /></span> +href="glossaries-user.html#dx1-40002" >3797</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">O</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\oldacronym</span></span></span>  <a href="glossaries-user.html#dx1-152004" ><span -class="cmti-10">3797</span></a>, <a -href="glossaries-user.html#dx1-152007" >3798</a> <br /></span> +class="cmti-10">3798</span></a>, <a +href="glossaries-user.html#dx1-152007" >3799</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">P</span> <span class="index-item">package options:<br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">abbreviations</span>  <a -href="glossaries-user.html#dx1-4011" >3799</a>, <a -href="glossaries-user.html#dx1-90016" >3800</a>, <a -href="glossaries-user.html#x1-920002.7" >3801</a>, <a -href="glossaries-user.html#dx1-147005" >3802</a>, <a -href="glossaries-user.html#dx1-172009" >3803</a>, <a -href="glossaries-user.html#dx1-175037" >3804</a>, <a -href="glossaries-user.html#dx1-175044" >3805</a>, <a -href="glossaries-user.html#dx1-179009" >3806</a> <br /></span> +href="glossaries-user.html#dx1-4011" >3800</a>, <a +href="glossaries-user.html#dx1-90016" >3801</a>, <a +href="glossaries-user.html#x1-920002.7" >3802</a>, <a +href="glossaries-user.html#dx1-147005" >3803</a>, <a +href="glossaries-user.html#dx1-172009" >3804</a>, <a +href="glossaries-user.html#dx1-175037" >3805</a>, <a +href="glossaries-user.html#dx1-175044" >3806</a>, <a +href="glossaries-user.html#dx1-179009" >3807</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">accsupp</span>  <a -href="glossaries-user.html#x1-1020002.8" >3807</a>, <a -href="glossaries-user.html#dx1-172008" >3808</a>, <a -href="glossaries-user.html#dx1-224039" >3809</a> <br /></span> +href="glossaries-user.html#x1-1020002.8" >3808</a>, <a +href="glossaries-user.html#dx1-172008" >3809</a>, <a +href="glossaries-user.html#dx1-224039" >3810</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">acronym</span>  <a -href="glossaries-user.html#dx1-14026" >3810</a>, <a -href="glossaries-user.html#dx1-19015" >3811</a>, <a -href="glossaries-user.html#dx1-19019" >3812</a>, <a -href="glossaries-user.html#dx1-20011" >3813</a>, <a -href="glossaries-user.html#dx1-20016" >3814</a>, <a -href="glossaries-user.html#dx1-25001" >3815</a>, <a -href="glossaries-user.html#dx1-25003" >3816</a>, <a -href="glossaries-user.html#dx1-43008" >3817</a>, <a -href="glossaries-user.html#dx1-43009" >3818</a>, <a -href="glossaries-user.html#dx1-84002" >3819</a>, <a -href="glossaries-user.html#x1-900002.7" >3820</a>, <a -href="glossaries-user.html#dx1-90005" >3821</a>, <a -href="glossaries-user.html#dx1-90018" >3822</a>, <a -href="glossaries-user.html#dx1-90023" >3823</a>, <a -href="glossaries-user.html#dx1-93002" >3824</a>, <a -href="glossaries-user.html#dx1-108015" >3825</a>, <a -href="glossaries-user.html#dx1-122019" >3826</a>, <a -href="glossaries-user.html#dx1-122020" >3827</a>, <a -href="glossaries-user.html#dx1-122025" >3828</a>, <a -href="glossaries-user.html#dx1-137016" >3829</a>, <a -href="glossaries-user.html#dx1-146016" >3830</a>, <a -href="glossaries-user.html#dx1-146017" >3831</a>, <a -href="glossaries-user.html#dx1-146019" >3832</a>, <a -href="glossaries-user.html#dx1-151005" >3833</a>, <a -href="glossaries-user.html#dx1-172006" >3834</a>, <a -href="glossaries-user.html#dx1-175011" >3835</a>, <a -href="glossaries-user.html#dx1-175019" >3836</a>, <a -href="glossaries-user.html#dx1-175020" >3837</a>, <a -href="glossaries-user.html#dx1-175033" >3838</a>, <a -href="glossaries-user.html#dx1-175035" >3839</a>, <a -href="glossaries-user.html#dx1-175043" >3840</a>, <a -href="glossaries-user.html#dx1-179001" >3841</a>, <a -href="glossaries-user.html#dx1-179008" >3842</a>, <a -href="glossaries-user.html#dx1-90010" >3843</a>, <a -href="glossaries-user.html#dx1-122024" >3844</a> <br /></span> +href="glossaries-user.html#dx1-14026" >3811</a>, <a +href="glossaries-user.html#dx1-19015" >3812</a>, <a +href="glossaries-user.html#dx1-19019" >3813</a>, <a +href="glossaries-user.html#dx1-20011" >3814</a>, <a +href="glossaries-user.html#dx1-20016" >3815</a>, <a +href="glossaries-user.html#dx1-25001" >3816</a>, <a +href="glossaries-user.html#dx1-25003" >3817</a>, <a +href="glossaries-user.html#dx1-43008" >3818</a>, <a +href="glossaries-user.html#dx1-43009" >3819</a>, <a +href="glossaries-user.html#dx1-84002" >3820</a>, <a +href="glossaries-user.html#x1-900002.7" >3821</a>, <a +href="glossaries-user.html#dx1-90005" >3822</a>, <a +href="glossaries-user.html#dx1-90018" >3823</a>, <a +href="glossaries-user.html#dx1-90023" >3824</a>, <a +href="glossaries-user.html#dx1-93002" >3825</a>, <a +href="glossaries-user.html#dx1-108015" >3826</a>, <a +href="glossaries-user.html#dx1-122019" >3827</a>, <a +href="glossaries-user.html#dx1-122020" >3828</a>, <a +href="glossaries-user.html#dx1-122025" >3829</a>, <a +href="glossaries-user.html#dx1-137016" >3830</a>, <a +href="glossaries-user.html#dx1-146016" >3831</a>, <a +href="glossaries-user.html#dx1-146017" >3832</a>, <a +href="glossaries-user.html#dx1-146019" >3833</a>, <a +href="glossaries-user.html#dx1-151005" >3834</a>, <a +href="glossaries-user.html#dx1-172006" >3835</a>, <a +href="glossaries-user.html#dx1-175011" >3836</a>, <a +href="glossaries-user.html#dx1-175019" >3837</a>, <a +href="glossaries-user.html#dx1-175020" >3838</a>, <a +href="glossaries-user.html#dx1-175033" >3839</a>, <a +href="glossaries-user.html#dx1-175035" >3840</a>, <a +href="glossaries-user.html#dx1-175043" >3841</a>, <a +href="glossaries-user.html#dx1-179001" >3842</a>, <a +href="glossaries-user.html#dx1-179008" >3843</a>, <a +href="glossaries-user.html#dx1-90010" >3844</a>, <a +href="glossaries-user.html#dx1-122024" >3845</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-25002" >3845</a>, <a -href="glossaries-user.html#dx1-91001" >3846</a> <br /></span> +href="glossaries-user.html#dx1-25002" >3846</a>, <a +href="glossaries-user.html#dx1-91001" >3847</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">acronymlists</span>  <a -href="glossaries-user.html#x1-930002.7" >3847</a>, <a -href="glossaries-user.html#dx1-93001" >3848</a>, <a -href="glossaries-user.html#dx1-93004" >3849</a>, <a -href="glossaries-user.html#dx1-135010" >3850</a>, <a -href="glossaries-user.html#dx1-146020" >3851</a>, <a -href="glossaries-user.html#dx1-147015" >3852</a>, <a -href="glossaries-user.html#dx1-168004" >3853</a> <br /></span> +href="glossaries-user.html#x1-930002.7" >3848</a>, <a +href="glossaries-user.html#dx1-93001" >3849</a>, <a +href="glossaries-user.html#dx1-93004" >3850</a>, <a +href="glossaries-user.html#dx1-135010" >3851</a>, <a +href="glossaries-user.html#dx1-146020" >3852</a>, <a +href="glossaries-user.html#dx1-147015" >3853</a>, <a +href="glossaries-user.html#dx1-168004" >3854</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">acronyms</span>  <a -href="glossaries-user.html#dx1-84003" >3854</a>, <a -href="glossaries-user.html#dx1-90024" >3855</a>, <a -href="glossaries-user.html#x1-910002.7" >3856</a> <br /></span> +href="glossaries-user.html#dx1-84003" >3855</a>, <a +href="glossaries-user.html#dx1-90024" >3856</a>, <a +href="glossaries-user.html#x1-910002.7" >3857</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">automake</span>  <a -href="glossaries-user.html#dx1-7010" >3857</a>, <a -href="glossaries-user.html#dx1-16006" >3858</a>, <a -href="glossaries-user.html#x1-790002.5" >3859</a>, <a -href="glossaries-user.html#dx1-79014" >3860</a> <br /></span> +href="glossaries-user.html#dx1-7010" >3858</a>, <a +href="glossaries-user.html#dx1-16006" >3859</a>, <a +href="glossaries-user.html#x1-790002.5" >3860</a>, <a +href="glossaries-user.html#dx1-79014" >3861</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-79021" >3861</a> <br /></span> +href="glossaries-user.html#dx1-79021" >3862</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">immediate</span>  <a -href="glossaries-user.html#dx1-79005" >3862</a>, <a -href="glossaries-user.html#dx1-79010" >3863</a>, <a -href="glossaries-user.html#dx1-79011" >3864</a> <br /></span> +href="glossaries-user.html#dx1-79005" >3863</a>, <a +href="glossaries-user.html#dx1-79010" >3864</a>, <a +href="glossaries-user.html#dx1-79011" >3865</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-79001" >3865</a>, <a -href="glossaries-user.html#dx1-79009" >3866</a> <br /></span> +href="glossaries-user.html#dx1-79001" >3866</a>, <a +href="glossaries-user.html#dx1-79009" >3867</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">autoseeindex</span>  <a -href="glossaries-user.html#x1-660002.4" >3867</a> <br /></span> +href="glossaries-user.html#x1-660002.4" >3868</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-204008" >3868</a>, <a -href="glossaries-user.html#dx1-204020" >3869</a> <br /></span> +href="glossaries-user.html#dx1-204008" >3869</a>, <a +href="glossaries-user.html#dx1-204020" >3870</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">compatible-2.07</span>  <a -href="glossaries-user.html#x1-1050002.8" >3870</a>, <a -href="glossaries-user.html#dx1-108012" >3871</a>, <a -href="glossaries-user.html#dx1-111010" >3872</a> <br /></span> +href="glossaries-user.html#x1-1050002.8" >3871</a>, <a +href="glossaries-user.html#dx1-108012" >3872</a>, <a +href="glossaries-user.html#dx1-111010" >3873</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">compatible-3.07</span>  <a -href="glossaries-user.html#dx1-90003" >3873</a>, <a -href="glossaries-user.html#x1-1060002.8" >3874</a>, <a -href="glossaries-user.html#dx1-135005" >3875</a> <br /></span> +href="glossaries-user.html#dx1-90003" >3874</a>, <a +href="glossaries-user.html#x1-1060002.8" >3875</a>, <a +href="glossaries-user.html#dx1-135005" >3876</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">counter</span>  <a -href="glossaries-user.html#x1-570002.3" >3876</a>, <a -href="glossaries-user.html#dx1-111017" >3877</a>, <a -href="glossaries-user.html#dx1-127003" >3878</a>, <a -href="glossaries-user.html#dx1-144004" >3879</a>, <a -href="glossaries-user.html#dx1-144041" >3880</a> <br /></span> +href="glossaries-user.html#x1-570002.3" >3877</a>, <a +href="glossaries-user.html#dx1-111017" >3878</a>, <a +href="glossaries-user.html#dx1-127003" >3879</a>, <a +href="glossaries-user.html#dx1-144004" >3880</a>, <a +href="glossaries-user.html#dx1-144041" >3881</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">equation</span>  <a -href="glossaries-user.html#dx1-189002" >3881</a> <br /></span> +href="glossaries-user.html#dx1-189002" >3882</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">page</span>  <a -href="glossaries-user.html#dx1-57001" >3882</a> <br /></span> +href="glossaries-user.html#dx1-57001" >3883</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">counterwithin</span>  <a -href="glossaries-user.html#x1-470002.3" >3883</a>, <a -href="glossaries-user.html#dx1-47004" >3884</a>, <a -href="glossaries-user.html#dx1-156002" >3885</a>, <a -href="glossaries-user.html#dx1-166047" >3886</a>, <a -href="glossaries-user.html#dx1-166084" >3887</a> <br /></span> +href="glossaries-user.html#x1-470002.3" >3884</a>, <a +href="glossaries-user.html#dx1-47004" >3885</a>, <a +href="glossaries-user.html#dx1-156002" >3886</a>, <a +href="glossaries-user.html#dx1-166047" >3887</a>, <a +href="glossaries-user.html#dx1-166084" >3888</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">debug</span>  <a -href="glossaries-user.html#dx1-27002" >3888</a>, <a -href="glossaries-user.html#x1-300002.1" >3889</a>, <a -href="glossaries-user.html#dx1-30019" >3890</a>, <a -href="glossaries-user.html#dx1-30020" >3891</a> <br /></span> +href="glossaries-user.html#dx1-27002" >3889</a>, <a +href="glossaries-user.html#x1-300002.1" >3890</a>, <a +href="glossaries-user.html#dx1-30019" >3891</a>, <a +href="glossaries-user.html#dx1-30020" >3892</a> <br /></span> <span class="index-subsubitem">        <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">all</span>  <a -href="glossaries-user.html#dx1-30004" >3892</a> <br /></span> +href="glossaries-user.html#dx1-30004" >3893</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-30001" >3893</a>, <a -href="glossaries-user.html#dx1-30005" >3894</a> <br /></span> +href="glossaries-user.html#dx1-30001" >3894</a>, <a +href="glossaries-user.html#dx1-30005" >3895</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">showaccsupp</span>  <a -href="glossaries-user.html#dx1-30011" >3895</a>, <a -href="glossaries-user.html#dx1-172076" >3896</a>, <a -href="glossaries-user.html#dx1-224034" >3897</a> <br /></span> +href="glossaries-user.html#dx1-30011" >3896</a>, <a +href="glossaries-user.html#dx1-172076" >3897</a>, <a +href="glossaries-user.html#dx1-224034" >3898</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">showtargets</span>  <a -href="glossaries-user.html#dx1-30007" >3898</a> <br /></span> +href="glossaries-user.html#dx1-30007" >3899</a> <br /></span> <span class="index-subsubitem">        <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">showwrgloss</span>  <a -href="glossaries-user.html#dx1-30003" >3899</a> <br /></span> +href="glossaries-user.html#dx1-30003" >3900</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-30002" >3900</a> <br /></span> +href="glossaries-user.html#dx1-30002" >3901</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">description </span>(deprecated)  <a -href="glossaries-user.html#x1-960002.7.1" >3901</a>, <a -href="glossaries-user.html#dx1-97002" >3902</a>, <a -href="glossaries-user.html#dx1-97003" >3903</a>, <a -href="glossaries-user.html#dx1-98005" >3904</a>, <a -href="glossaries-user.html#dx1-98006" >3905</a>, <a -href="glossaries-user.html#dx1-99004" >3906</a>, <a -href="glossaries-user.html#dx1-99006" >3907</a>, <a -href="glossaries-user.html#dx1-99008" >3908</a>, <a -href="glossaries-user.html#dx1-100002" >3909</a> <br /></span> +href="glossaries-user.html#x1-960002.7.1" >3902</a>, <a +href="glossaries-user.html#dx1-97002" >3903</a>, <a +href="glossaries-user.html#dx1-97003" >3904</a>, <a +href="glossaries-user.html#dx1-98005" >3905</a>, <a +href="glossaries-user.html#dx1-98006" >3906</a>, <a +href="glossaries-user.html#dx1-99004" >3907</a>, <a +href="glossaries-user.html#dx1-99006" >3908</a>, <a +href="glossaries-user.html#dx1-99008" >3909</a>, <a +href="glossaries-user.html#dx1-100002" >3910</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">disablemakegloss</span>  <a -href="glossaries-user.html#x1-800002.5" >3910</a>, <a -href="glossaries-user.html#dx1-81001" >3911</a> <br /></span> +href="glossaries-user.html#x1-800002.5" >3911</a>, <a +href="glossaries-user.html#dx1-81001" >3912</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">docdef</span>  <a -href="glossaries-user.html#x1-370002.1" >3912</a> <br /></span> +href="glossaries-user.html#x1-370002.1" >3913</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">atom</span>  <a -href="glossaries-user.html#dx1-23002" >3913</a>, <a -href="glossaries-user.html#dx1-35003" >3914</a> <br /></span> +href="glossaries-user.html#dx1-23002" >3914</a>, <a +href="glossaries-user.html#dx1-35003" >3915</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-5013" >3915</a> <br /></span> +href="glossaries-user.html#dx1-5013" >3916</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">restricted</span>  <a -href="glossaries-user.html#dx1-5012" >3916</a>, <a -href="glossaries-user.html#dx1-5014" >3917</a>, <a -href="glossaries-user.html#dx1-23004" >3918</a>, <a -href="glossaries-user.html#dx1-31004" >3919</a> <br /></span> +href="glossaries-user.html#dx1-5012" >3917</a>, <a +href="glossaries-user.html#dx1-5014" >3918</a>, <a +href="glossaries-user.html#dx1-23004" >3919</a>, <a +href="glossaries-user.html#dx1-31004" >3920</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-5011" >3920</a>, <a -href="glossaries-user.html#dx1-37007" >3921</a> <br /></span> +href="glossaries-user.html#dx1-5011" >3921</a>, <a +href="glossaries-user.html#dx1-37007" >3922</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">dua </span>(deprecated)  <a -href="glossaries-user.html#dx1-96009" >3922</a>, <a -href="glossaries-user.html#x1-1000002.7.1" >3923</a> <br /></span> +href="glossaries-user.html#dx1-96009" >3923</a>, <a +href="glossaries-user.html#x1-1000002.7.1" >3924</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">entrycounter</span>  <a -href="glossaries-user.html#x1-460002.3" >3924</a>, <a -href="glossaries-user.html#dx1-48004" >3925</a>, <a -href="glossaries-user.html#dx1-156001" >3926</a>, <a -href="glossaries-user.html#dx1-166046" >3927</a>, <a -href="glossaries-user.html#dx1-166083" >3928</a> <br /></span> +href="glossaries-user.html#x1-460002.3" >3925</a>, <a +href="glossaries-user.html#dx1-48004" >3926</a>, <a +href="glossaries-user.html#dx1-156001" >3927</a>, <a +href="glossaries-user.html#dx1-166046" >3928</a>, <a +href="glossaries-user.html#dx1-166083" >3929</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-46001" >3929</a> <br /></span> +href="glossaries-user.html#dx1-46001" >3930</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-47001" >3930</a> <br /></span> +href="glossaries-user.html#dx1-47001" >3931</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">equations</span>  <a -href="glossaries-user.html#x1-680002.4" >3931</a> <br /></span> +href="glossaries-user.html#x1-680002.4" >3932</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">esclocations</span>  <a -href="glossaries-user.html#x1-630002.4" >3932</a> <br /></span> +href="glossaries-user.html#x1-630002.4" >3933</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-63003" >3933</a>, <a -href="glossaries-user.html#dx1-63009" >3934</a>, <a -href="glossaries-user.html#dx1-129002" >3935</a> <br /></span> +href="glossaries-user.html#dx1-63003" >3934</a>, <a +href="glossaries-user.html#dx1-63009" >3935</a>, <a +href="glossaries-user.html#dx1-129002" >3936</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-63001" >3936</a> <br /></span> +href="glossaries-user.html#dx1-63001" >3937</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">floats</span>  <a -href="glossaries-user.html#x1-690002.4" >3937</a> <br /></span> +href="glossaries-user.html#x1-690002.4" >3938</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">footnote </span>(deprecated)  <a -href="glossaries-user.html#dx1-96004" >3938</a>, <a -href="glossaries-user.html#dx1-96005" >3939</a>, <a -href="glossaries-user.html#dx1-96007" >3940</a>, <a -href="glossaries-user.html#dx1-97004" >3941</a>, <a -href="glossaries-user.html#dx1-98007" >3942</a>, <a -href="glossaries-user.html#x1-990002.7.1" >3943</a> <br /></span> +href="glossaries-user.html#dx1-96004" >3939</a>, <a +href="glossaries-user.html#dx1-96005" >3940</a>, <a +href="glossaries-user.html#dx1-96007" >3941</a>, <a +href="glossaries-user.html#dx1-97004" >3942</a>, <a +href="glossaries-user.html#dx1-98007" >3943</a>, <a +href="glossaries-user.html#x1-990002.7.1" >3944</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">hyperfirst</span>  <a -href="glossaries-user.html#x1-340002.1" >3944</a>, <a -href="glossaries-user.html#dx1-34010" >3945</a>, <a -href="glossaries-user.html#dx1-136015" >3946</a>, <a -href="glossaries-user.html#dx1-136017" >3947</a> <br /></span> +href="glossaries-user.html#x1-340002.1" >3945</a>, <a +href="glossaries-user.html#dx1-34010" >3946</a>, <a +href="glossaries-user.html#dx1-136015" >3947</a>, <a +href="glossaries-user.html#dx1-136017" >3948</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-34014" >3948</a>, <a -href="glossaries-user.html#dx1-132037" >3949</a>, <a -href="glossaries-user.html#dx1-136010" >3950</a>, <a -href="glossaries-user.html#dx1-136013" >3951</a>, <a -href="glossaries-user.html#dx1-149073" >3952</a>, <a -href="glossaries-user.html#dx1-183001" >3953</a>, <a -href="glossaries-user.html#dx1-183005" >3954</a> <br /></span> +href="glossaries-user.html#dx1-34014" >3949</a>, <a +href="glossaries-user.html#dx1-132037" >3950</a>, <a +href="glossaries-user.html#dx1-136010" >3951</a>, <a +href="glossaries-user.html#dx1-136013" >3952</a>, <a +href="glossaries-user.html#dx1-149073" >3953</a>, <a +href="glossaries-user.html#dx1-183001" >3954</a>, <a +href="glossaries-user.html#dx1-183005" >3955</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-34001" >3955</a>, <a -href="glossaries-user.html#dx1-34005" >3956</a> <br /></span> +href="glossaries-user.html#dx1-34001" >3956</a>, <a +href="glossaries-user.html#dx1-34005" >3957</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">index</span>  <a -href="glossaries-user.html#dx1-84006" >3957</a>, <a -href="glossaries-user.html#x1-870002.6" >3958</a>, <a -href="glossaries-user.html#dx1-87012" >3959</a>, <a -href="glossaries-user.html#dx1-87015" >3960</a>, <a -href="glossaries-user.html#dx1-88001" >3961</a>, <a -href="glossaries-user.html#dx1-88002" >3962</a>, <a -href="glossaries-user.html#dx1-146023" >3963</a> <br /></span> +href="glossaries-user.html#dx1-84006" >3958</a>, <a +href="glossaries-user.html#x1-870002.6" >3959</a>, <a +href="glossaries-user.html#dx1-87012" >3960</a>, <a +href="glossaries-user.html#dx1-87015" >3961</a>, <a +href="glossaries-user.html#dx1-88001" >3962</a>, <a +href="glossaries-user.html#dx1-88002" >3963</a>, <a +href="glossaries-user.html#dx1-146023" >3964</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">indexcounter</span>  <a -href="glossaries-user.html#x1-700002.4" >3964</a> <br /></span> +href="glossaries-user.html#x1-700002.4" >3965</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">indexcrossrefs</span>  <a -href="glossaries-user.html#x1-650002.4" >3965</a> <br /></span> +href="glossaries-user.html#x1-650002.4" >3966</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">indexonlyfirst</span>  <a -href="glossaries-user.html#x1-640002.4" >3966</a>, <a -href="glossaries-user.html#dx1-64006" >3967</a>, <a -href="glossaries-user.html#dx1-64008" >3968</a>, <a -href="glossaries-user.html#dx1-127009" >3969</a> <br /></span> +href="glossaries-user.html#x1-640002.4" >3967</a>, <a +href="glossaries-user.html#dx1-64006" >3968</a>, <a +href="glossaries-user.html#dx1-64008" >3969</a>, <a +href="glossaries-user.html#dx1-127009" >3970</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-64001" >3970</a> <br /></span> +href="glossaries-user.html#dx1-64001" >3971</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">kernelglossredefs</span>  <a -href="glossaries-user.html#x1-1070002.8" >3971</a> <br /></span> +href="glossaries-user.html#x1-1070002.8" >3972</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-107002" >3972</a> <br /></span> +href="glossaries-user.html#dx1-107002" >3973</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">makeindex</span>  <a -href="glossaries-user.html#dx1-25004" >3973</a>, <a -href="glossaries-user.html#x1-750002.5" >3974</a>, <a -href="glossaries-user.html#dx1-108005" >3975</a> <br /></span> +href="glossaries-user.html#dx1-25004" >3974</a>, <a +href="glossaries-user.html#x1-750002.5" >3975</a>, <a +href="glossaries-user.html#dx1-108005" >3976</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">noglossaryindex</span>  <a -href="glossaries-user.html#x1-880002.6" >3976</a> <br /></span> +href="glossaries-user.html#x1-880002.6" >3977</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nogroupskip</span>  <a -href="glossaries-user.html#x1-590002.3" >3977</a>, <a -href="glossaries-user.html#dx1-141046" >3978</a>, <a -href="glossaries-user.html#dx1-156009" >3979</a>, <a -href="glossaries-user.html#dx1-156037" >3980</a>, <a -href="glossaries-user.html#dx1-160020" >3981</a>, <a -href="glossaries-user.html#dx1-166037" >3982</a>, <a -href="glossaries-user.html#dx1-166096" >3983</a>, <a -href="glossaries-user.html#dx1-219001" >3984</a> <br /></span> +href="glossaries-user.html#x1-590002.3" >3978</a>, <a +href="glossaries-user.html#dx1-141046" >3979</a>, <a +href="glossaries-user.html#dx1-156009" >3980</a>, <a +href="glossaries-user.html#dx1-156037" >3981</a>, <a +href="glossaries-user.html#dx1-160020" >3982</a>, <a +href="glossaries-user.html#dx1-166037" >3983</a>, <a +href="glossaries-user.html#dx1-166096" >3984</a>, <a +href="glossaries-user.html#dx1-219001" >3985</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-59001" >3985</a> <br /></span> +href="glossaries-user.html#dx1-59001" >3986</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nohyperfirst</span>  <a -href="glossaries-user.html#dx1-34025" >3986</a> <br /></span> +href="glossaries-user.html#dx1-34025" >3987</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nohypertypes</span>  <a -href="glossaries-user.html#dx1-34003" >3987</a>, <a -href="glossaries-user.html#dx1-34004" >3988</a>, <a -href="glossaries-user.html#dx1-34011" >3989</a>, <a -href="glossaries-user.html#x1-830002.6" >3990</a>, <a -href="glossaries-user.html#dx1-132022" >3991</a>, <a -href="glossaries-user.html#dx1-132029" >3992</a>, <a -href="glossaries-user.html#dx1-135026" >3993</a>, <a -href="glossaries-user.html#dx1-136004" >3994</a>, <a -href="glossaries-user.html#dx1-146011" >3995</a> <br /></span> +href="glossaries-user.html#dx1-34003" >3988</a>, <a +href="glossaries-user.html#dx1-34004" >3989</a>, <a +href="glossaries-user.html#dx1-34011" >3990</a>, <a +href="glossaries-user.html#x1-830002.6" >3991</a>, <a +href="glossaries-user.html#dx1-132022" >3992</a>, <a +href="glossaries-user.html#dx1-132029" >3993</a>, <a +href="glossaries-user.html#dx1-135026" >3994</a>, <a +href="glossaries-user.html#dx1-136004" >3995</a>, <a +href="glossaries-user.html#dx1-146011" >3996</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">index</span>  <a -href="glossaries-user.html#dx1-87013" >3996</a> <br /></span> +href="glossaries-user.html#dx1-87013" >3997</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nolangwarn</span>  <a -href="glossaries-user.html#dx1-3" >3997</a>, <a -href="glossaries-user.html#x1-280002.1" >3998</a> <br /></span> +href="glossaries-user.html#dx1-3" >3998</a>, <a +href="glossaries-user.html#x1-280002.1" >3999</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nolist</span>  <a -href="glossaries-user.html#x1-520002.3" >3999</a>, <a -href="glossaries-user.html#dx1-108008" >4000</a>, <a -href="glossaries-user.html#dx1-157004" >4001</a> <br /></span> +href="glossaries-user.html#x1-520002.3" >4000</a>, <a +href="glossaries-user.html#dx1-108008" >4001</a>, <a +href="glossaries-user.html#dx1-157004" >4002</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nolong</span>  <a -href="glossaries-user.html#x1-500002.3" >4002</a>, <a -href="glossaries-user.html#dx1-108006" >4003</a>, <a -href="glossaries-user.html#dx1-158004" >4004</a>, <a -href="glossaries-user.html#dx1-202004" >4005</a>, <a -href="glossaries-user.html#dx1-156019" >4006</a> <br /></span> +href="glossaries-user.html#x1-500002.3" >4003</a>, <a +href="glossaries-user.html#dx1-108006" >4004</a>, <a +href="glossaries-user.html#dx1-158004" >4005</a>, <a +href="glossaries-user.html#dx1-202004" >4006</a>, <a +href="glossaries-user.html#dx1-156019" >4007</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nomain</span>  <a -href="glossaries-user.html#x1-840002.6" >4007</a>, <a -href="glossaries-user.html#dx1-85004" >4008</a>, <a -href="glossaries-user.html#dx1-86004" >4009</a>, <a -href="glossaries-user.html#dx1-87007" >4010</a>, <a -href="glossaries-user.html#dx1-90015" >4011</a>, <a -href="glossaries-user.html#dx1-107003" >4012</a>, <a -href="glossaries-user.html#dx1-108011" >4013</a>, <a -href="glossaries-user.html#dx1-146015" >4014</a>, <a -href="glossaries-user.html#dx1-179002" >4015</a>, <a -href="glossaries-user.html#dx1-179003" >4016</a>, <a -href="glossaries-user.html#dx1-194001" >4017</a>, <a -href="glossaries-user.html#dx1-90012" >4018</a> <br /></span> +href="glossaries-user.html#x1-840002.6" >4008</a>, <a +href="glossaries-user.html#dx1-85004" >4009</a>, <a +href="glossaries-user.html#dx1-86004" >4010</a>, <a +href="glossaries-user.html#dx1-87007" >4011</a>, <a +href="glossaries-user.html#dx1-90015" >4012</a>, <a +href="glossaries-user.html#dx1-107003" >4013</a>, <a +href="glossaries-user.html#dx1-108011" >4014</a>, <a +href="glossaries-user.html#dx1-146015" >4015</a>, <a +href="glossaries-user.html#dx1-179002" >4016</a>, <a +href="glossaries-user.html#dx1-179003" >4017</a>, <a +href="glossaries-user.html#dx1-194001" >4018</a>, <a +href="glossaries-user.html#dx1-90012" >4019</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">nomissingglstext</span>  <a -href="glossaries-user.html#x1-1040002.8" >4019</a> <br /></span> +href="glossaries-user.html#x1-1040002.8" >4020</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nonumberlist</span>  <a -href="glossaries-user.html#dx1-3060" >4020</a>, <a -href="glossaries-user.html#x1-550002.3" >4021</a>, <a -href="glossaries-user.html#dx1-56002" >4022</a>, <a -href="glossaries-user.html#dx1-112112" >4023</a>, <a -href="glossaries-user.html#dx1-127002" >4024</a>, <a -href="glossaries-user.html#dx1-127008" >4025</a>, <a -href="glossaries-user.html#dx1-137009" >4026</a>, <a -href="glossaries-user.html#dx1-157042" >4027</a>, <a -href="glossaries-user.html#dx1-166059" >4028</a>, <a -href="glossaries-user.html#dx1-166061" >4029</a>, <a -href="glossaries-user.html#dx1-176023" >4030</a>, <a -href="glossaries-user.html#dx1-206020" >4031</a>, <a -href="glossaries-user.html#dx1-214013" >4032</a> <br /></span> +href="glossaries-user.html#dx1-3060" >4021</a>, <a +href="glossaries-user.html#x1-550002.3" >4022</a>, <a +href="glossaries-user.html#dx1-56002" >4023</a>, <a +href="glossaries-user.html#dx1-112112" >4024</a>, <a +href="glossaries-user.html#dx1-127002" >4025</a>, <a +href="glossaries-user.html#dx1-127008" >4026</a>, <a +href="glossaries-user.html#dx1-137009" >4027</a>, <a +href="glossaries-user.html#dx1-157042" >4028</a>, <a +href="glossaries-user.html#dx1-166059" >4029</a>, <a +href="glossaries-user.html#dx1-166061" >4030</a>, <a +href="glossaries-user.html#dx1-176023" >4031</a>, <a +href="glossaries-user.html#dx1-206020" >4032</a>, <a +href="glossaries-user.html#dx1-214013" >4033</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nopostdot</span>  <a -href="glossaries-user.html#x1-580002.3" >4033</a>, <a -href="glossaries-user.html#dx1-156042" >4034</a> <br /></span> +href="glossaries-user.html#x1-580002.3" >4034</a>, <a +href="glossaries-user.html#dx1-156042" >4035</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-58003" >4035</a>, <a -href="glossaries-user.html#dx1-58006" >4036</a>, <a -href="glossaries-user.html#dx1-178018" >4037</a>, <a -href="glossaries-user.html#dx1-178020" >4038</a>, <a -href="glossaries-user.html#dx1-200010" >4039</a>, <a -href="glossaries-user.html#dx1-204005" >4040</a> <br /></span> +href="glossaries-user.html#dx1-58003" >4036</a>, <a +href="glossaries-user.html#dx1-58006" >4037</a>, <a +href="glossaries-user.html#dx1-178018" >4038</a>, <a +href="glossaries-user.html#dx1-178020" >4039</a>, <a +href="glossaries-user.html#dx1-200010" >4040</a>, <a +href="glossaries-user.html#dx1-204005" >4041</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-58001" >4041</a>, <a -href="glossaries-user.html#dx1-58002" >4042</a>, <a -href="glossaries-user.html#dx1-58004" >4043</a>, <a -href="glossaries-user.html#dx1-178019" >4044</a> <br /></span> +href="glossaries-user.html#dx1-58001" >4042</a>, <a +href="glossaries-user.html#dx1-58002" >4043</a>, <a +href="glossaries-user.html#dx1-58004" >4044</a>, <a +href="glossaries-user.html#dx1-178019" >4045</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">noredefwarn</span>  <a -href="glossaries-user.html#x1-290002.1" >4045</a> <br /></span> +href="glossaries-user.html#x1-290002.1" >4046</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nostyles</span>  <a -href="glossaries-user.html#dx1-11021" >4046</a>, <a -href="glossaries-user.html#dx1-11074" >4047</a>, <a -href="glossaries-user.html#x1-540002.3" >4048</a>, <a -href="glossaries-user.html#dx1-108010" >4049</a>, <a -href="glossaries-user.html#dx1-157005" >4050</a>, <a -href="glossaries-user.html#dx1-158005" >4051</a>, <a -href="glossaries-user.html#dx1-161005" >4052</a>, <a -href="glossaries-user.html#dx1-163003" >4053</a>, <a -href="glossaries-user.html#dx1-178011" >4054</a>, <a -href="glossaries-user.html#dx1-202009" >4055</a>, <a -href="glossaries-user.html#dx1-219013" >4056</a>, <a -href="glossaries-user.html#dx1-156021" >4057</a> <br /></span> +href="glossaries-user.html#dx1-11021" >4047</a>, <a +href="glossaries-user.html#dx1-11074" >4048</a>, <a +href="glossaries-user.html#x1-540002.3" >4049</a>, <a +href="glossaries-user.html#dx1-108010" >4050</a>, <a +href="glossaries-user.html#dx1-157005" >4051</a>, <a +href="glossaries-user.html#dx1-158005" >4052</a>, <a +href="glossaries-user.html#dx1-161005" >4053</a>, <a +href="glossaries-user.html#dx1-163003" >4054</a>, <a +href="glossaries-user.html#dx1-178011" >4055</a>, <a +href="glossaries-user.html#dx1-202009" >4056</a>, <a +href="glossaries-user.html#dx1-219013" >4057</a>, <a +href="glossaries-user.html#dx1-156021" >4058</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nosuper</span>  <a -href="glossaries-user.html#x1-510002.3" >4058</a>, <a -href="glossaries-user.html#dx1-108007" >4059</a>, <a -href="glossaries-user.html#dx1-161004" >4060</a>, <a -href="glossaries-user.html#dx1-202005" >4061</a>, <a -href="glossaries-user.html#dx1-156020" >4062</a> <br /></span> +href="glossaries-user.html#x1-510002.3" >4059</a>, <a +href="glossaries-user.html#dx1-108007" >4060</a>, <a +href="glossaries-user.html#dx1-161004" >4061</a>, <a +href="glossaries-user.html#dx1-202005" >4062</a>, <a +href="glossaries-user.html#dx1-156020" >4063</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">notranslate</span>  <a -href="glossaries-user.html#dx1-14010" >4063</a>, <a -href="glossaries-user.html#x1-330002.1" >4064</a>, <a -href="glossaries-user.html#dx1-108014" >4065</a> <br /></span> +href="glossaries-user.html#dx1-14010" >4064</a>, <a +href="glossaries-user.html#x1-330002.1" >4065</a>, <a +href="glossaries-user.html#dx1-108014" >4066</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">notree</span>  <a -href="glossaries-user.html#x1-530002.3" >4066</a>, <a -href="glossaries-user.html#dx1-108009" >4067</a>, <a -href="glossaries-user.html#dx1-163002" >4068</a>, <a -href="glossaries-user.html#dx1-164011" >4069</a> <br /></span> +href="glossaries-user.html#x1-530002.3" >4067</a>, <a +href="glossaries-user.html#dx1-108009" >4068</a>, <a +href="glossaries-user.html#dx1-163002" >4069</a>, <a +href="glossaries-user.html#dx1-164011" >4070</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nowarn</span>  <a -href="glossaries-user.html#x1-270002.1" >4070</a>, <a -href="glossaries-user.html#dx1-29001" >4071</a>, <a -href="glossaries-user.html#dx1-30006" >4072</a> <br /></span> +href="glossaries-user.html#x1-270002.1" >4071</a>, <a +href="glossaries-user.html#dx1-29001" >4072</a>, <a +href="glossaries-user.html#dx1-30006" >4073</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">numberedsection</span>  <a -href="glossaries-user.html#dx1-41001" >4073</a>, <a -href="glossaries-user.html#x1-430002.2" >4074</a>, <a -href="glossaries-user.html#dx1-43001" >4075</a>, <a -href="glossaries-user.html#dx1-141029" >4076</a>, <a -href="glossaries-user.html#dx1-141030" >4077</a>, <a -href="glossaries-user.html#dx1-141070" >4078</a> <br /></span> +href="glossaries-user.html#dx1-41001" >4074</a>, <a +href="glossaries-user.html#x1-430002.2" >4075</a>, <a +href="glossaries-user.html#dx1-43001" >4076</a>, <a +href="glossaries-user.html#dx1-141029" >4077</a>, <a +href="glossaries-user.html#dx1-141030" >4078</a>, <a +href="glossaries-user.html#dx1-141070" >4079</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">autolabel</span>  <a -href="glossaries-user.html#dx1-43004" >4079</a>, <a -href="glossaries-user.html#dx1-43011" >4080</a>, <a -href="glossaries-user.html#dx1-141058" >4081</a> <br /></span> +href="glossaries-user.html#dx1-43004" >4080</a>, <a +href="glossaries-user.html#dx1-43011" >4081</a>, <a +href="glossaries-user.html#dx1-141058" >4082</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-43002" >4082</a> <br /></span> +href="glossaries-user.html#dx1-43002" >4083</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">nameref</span>  <a -href="glossaries-user.html#dx1-43010" >4083</a> <br /></span> +href="glossaries-user.html#dx1-43010" >4084</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">nolabel</span>  <a -href="glossaries-user.html#dx1-43003" >4084</a> <br /></span> +href="glossaries-user.html#dx1-43003" >4085</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">numberline</span>  <a -href="glossaries-user.html#x1-400002.2" >4085</a>, <a -href="glossaries-user.html#dx1-40006" >4086</a> <br /></span> +href="glossaries-user.html#x1-400002.2" >4086</a>, <a +href="glossaries-user.html#dx1-40006" >4087</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">numbers</span>  <a -href="glossaries-user.html#dx1-84005" >4087</a>, <a -href="glossaries-user.html#x1-860002.6" >4088</a>, <a -href="glossaries-user.html#dx1-146022" >4089</a> <br /></span> +href="glossaries-user.html#dx1-84005" >4088</a>, <a +href="glossaries-user.html#x1-860002.6" >4089</a>, <a +href="glossaries-user.html#dx1-146022" >4090</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">order</span>  <a -href="glossaries-user.html#dx1-71002" >4090</a>, <a -href="glossaries-user.html#x1-740002.5" >4091</a>, <a -href="glossaries-user.html#dx1-74003" >4092</a>, <a -href="glossaries-user.html#dx1-141042" >4093</a> <br /></span> +href="glossaries-user.html#dx1-71002" >4091</a>, <a +href="glossaries-user.html#x1-740002.5" >4092</a>, <a +href="glossaries-user.html#dx1-74003" >4093</a>, <a +href="glossaries-user.html#dx1-141042" >4094</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">letter</span>  <a -href="glossaries-user.html#dx1-7047" >4094</a>, <a -href="glossaries-user.html#dx1-8049" >4095</a>, <a -href="glossaries-user.html#dx1-16088" >4096</a>, <a -href="glossaries-user.html#dx1-74002" >4097</a>, <a -href="glossaries-user.html#dx1-200002" >4098</a>, <a -href="glossaries-user.html#dx1-200095" >4099</a> <br /></span> +href="glossaries-user.html#dx1-7047" >4095</a>, <a +href="glossaries-user.html#dx1-8049" >4096</a>, <a +href="glossaries-user.html#dx1-16088" >4097</a>, <a +href="glossaries-user.html#dx1-74002" >4098</a>, <a +href="glossaries-user.html#dx1-200002" >4099</a>, <a +href="glossaries-user.html#dx1-200095" >4100</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">word</span>  <a -href="glossaries-user.html#dx1-16091" >4100</a>, <a -href="glossaries-user.html#dx1-74001" >4101</a> <br /></span> +href="glossaries-user.html#dx1-16091" >4101</a>, <a +href="glossaries-user.html#dx1-74001" >4102</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">postdot</span>  <a -href="glossaries-user.html#dx1-4012" >4102</a>, <a -href="glossaries-user.html#dx1-58005" >4103</a>, <a -href="glossaries-user.html#dx1-178021" >4104</a>, <a -href="glossaries-user.html#dx1-183031" >4105</a>, <a -href="glossaries-user.html#dx1-188018" >4106</a>, <a -href="glossaries-user.html#dx1-204006" >4107</a> <br /></span> +href="glossaries-user.html#dx1-4012" >4103</a>, <a +href="glossaries-user.html#dx1-58005" >4104</a>, <a +href="glossaries-user.html#dx1-178021" >4105</a>, <a +href="glossaries-user.html#dx1-183031" >4106</a>, <a +href="glossaries-user.html#dx1-188018" >4107</a>, <a +href="glossaries-user.html#dx1-204006" >4108</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">postpunc</span>  <a -href="glossaries-user.html#dx1-58007" >4108</a> <br /></span> +href="glossaries-user.html#dx1-58007" >4109</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">prefix</span>  <a -href="glossaries-user.html#x1-1030002.8" >4109</a>, <a -href="glossaries-user.html#dx1-178014" >4110</a>, <a -href="glossaries-user.html#dx1-194005" >4111</a>, <a -href="glossaries-user.html#dx1-223003" >4112</a> <br /></span> +href="glossaries-user.html#x1-1030002.8" >4110</a>, <a +href="glossaries-user.html#dx1-178014" >4111</a>, <a +href="glossaries-user.html#dx1-194005" >4112</a>, <a +href="glossaries-user.html#dx1-223003" >4113</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">record</span>  <a -href="glossaries-user.html#dx1-9018" >4113</a>, <a -href="glossaries-user.html#dx1-11023" >4114</a>, <a -href="glossaries-user.html#dx1-13010" >4115</a>, <a -href="glossaries-user.html#dx1-45005" >4116</a>, <a -href="glossaries-user.html#x1-670002.4" >4117</a>, <a -href="glossaries-user.html#dx1-175048" >4118</a>, <a -href="glossaries-user.html#dx1-179044" >4119</a>, <a -href="glossaries-user.html#dx1-188013" >4120</a>, <a -href="glossaries-user.html#dx1-188015" >4121</a>, <a -href="glossaries-user.html#dx1-190024" >4122</a>, <a -href="glossaries-user.html#dx1-192037" >4123</a>, <a -href="glossaries-user.html#dx1-197007" >4124</a>, <a -href="glossaries-user.html#dx1-200057" >4125</a>, <a -href="glossaries-user.html#dx1-202050" >4126</a>, <a -href="glossaries-user.html#dx1-204019" >4127</a>, <a -href="glossaries-user.html#dx1-206007" >4128</a>, <a -href="glossaries-user.html#dx1-211037" >4129</a>, <a -href="glossaries-user.html#dx1-212007" >4130</a>, <a -href="glossaries-user.html#dx1-214012" >4131</a>, <a -href="glossaries-user.html#dx1-220045" >4132</a>, <a -href="glossaries-user.html#dx1-223008" >4133</a> <br /></span> +href="glossaries-user.html#dx1-9018" >4114</a>, <a +href="glossaries-user.html#dx1-11023" >4115</a>, <a +href="glossaries-user.html#dx1-13010" >4116</a>, <a +href="glossaries-user.html#dx1-45005" >4117</a>, <a +href="glossaries-user.html#x1-670002.4" >4118</a>, <a +href="glossaries-user.html#dx1-175048" >4119</a>, <a +href="glossaries-user.html#dx1-179044" >4120</a>, <a +href="glossaries-user.html#dx1-188013" >4121</a>, <a +href="glossaries-user.html#dx1-188015" >4122</a>, <a +href="glossaries-user.html#dx1-190024" >4123</a>, <a +href="glossaries-user.html#dx1-192037" >4124</a>, <a +href="glossaries-user.html#dx1-197007" >4125</a>, <a +href="glossaries-user.html#dx1-200057" >4126</a>, <a +href="glossaries-user.html#dx1-202050" >4127</a>, <a +href="glossaries-user.html#dx1-204019" >4128</a>, <a +href="glossaries-user.html#dx1-206007" >4129</a>, <a +href="glossaries-user.html#dx1-211037" >4130</a>, <a +href="glossaries-user.html#dx1-212007" >4131</a>, <a +href="glossaries-user.html#dx1-214012" >4132</a>, <a +href="glossaries-user.html#dx1-220045" >4133</a>, <a +href="glossaries-user.html#dx1-223008" >4134</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">alsoindex</span>  <a -href="glossaries-user.html#dx1-9021" >4134</a>, <a -href="glossaries-user.html#dx1-24010" >4135</a> <br /></span> +href="glossaries-user.html#dx1-9021" >4135</a>, <a +href="glossaries-user.html#dx1-24010" >4136</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">nameref</span>  <a -href="glossaries-user.html#dx1-9020" >4136</a>, <a -href="glossaries-user.html#dx1-24016" >4137</a>, <a -href="glossaries-user.html#dx1-45007" >4138</a>, <a -href="glossaries-user.html#dx1-71005" >4139</a>, <a -href="glossaries-user.html#dx1-81005" >4140</a>, <a -href="glossaries-user.html#dx1-188016" >4141</a>, <a -href="glossaries-user.html#dx1-188036" >4142</a>, <a -href="glossaries-user.html#dx1-190041" >4143</a>, <a -href="glossaries-user.html#dx1-192038" >4144</a>, <a -href="glossaries-user.html#dx1-212014" >4145</a>, <a -href="glossaries-user.html#dx1-220044" >4146</a> <br /></span> +href="glossaries-user.html#dx1-9020" >4137</a>, <a +href="glossaries-user.html#dx1-24016" >4138</a>, <a +href="glossaries-user.html#dx1-45007" >4139</a>, <a +href="glossaries-user.html#dx1-71005" >4140</a>, <a +href="glossaries-user.html#dx1-81005" >4141</a>, <a +href="glossaries-user.html#dx1-188016" >4142</a>, <a +href="glossaries-user.html#dx1-188036" >4143</a>, <a +href="glossaries-user.html#dx1-190041" >4144</a>, <a +href="glossaries-user.html#dx1-192038" >4145</a>, <a +href="glossaries-user.html#dx1-212014" >4146</a>, <a +href="glossaries-user.html#dx1-220044" >4147</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">only</span>  <a -href="glossaries-user.html#dx1-5016" >4147</a>, <a -href="glossaries-user.html#dx1-45006" >4148</a>, <a -href="glossaries-user.html#dx1-71004" >4149</a>, <a -href="glossaries-user.html#dx1-81004" >4150</a>, <a -href="glossaries-user.html#dx1-188014" >4151</a>, <a -href="glossaries-user.html#dx1-190040" >4152</a> <br /></span> +href="glossaries-user.html#dx1-5016" >4148</a>, <a +href="glossaries-user.html#dx1-45006" >4149</a>, <a +href="glossaries-user.html#dx1-71004" >4150</a>, <a +href="glossaries-user.html#dx1-81004" >4151</a>, <a +href="glossaries-user.html#dx1-188014" >4152</a>, <a +href="glossaries-user.html#dx1-190040" >4153</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">record</span>  <a -href="glossaries-user.html#dx1-214045" >4153</a>, <a -href="glossaries-user.html#dx1-220020" >4154</a> <br /></span> +href="glossaries-user.html#dx1-214045" >4154</a>, <a +href="glossaries-user.html#dx1-220020" >4155</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">restoremakegloss</span>  <a -href="glossaries-user.html#x1-810002.5" >4155</a>, <a -href="glossaries-user.html#dx1-81006" >4156</a> <br /></span> +href="glossaries-user.html#x1-810002.5" >4156</a>, <a +href="glossaries-user.html#dx1-81006" >4157</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">sanitizesort</span>  <a -href="glossaries-user.html#dx1-5006" >4157</a>, <a -href="glossaries-user.html#x1-720002.5" >4158</a>, <a -href="glossaries-user.html#dx1-73031" >4159</a> <br /></span> +href="glossaries-user.html#dx1-5006" >4158</a>, <a +href="glossaries-user.html#x1-720002.5" >4159</a>, <a +href="glossaries-user.html#dx1-73031" >4160</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-6005" >4160</a>, <a -href="glossaries-user.html#dx1-6006" >4161</a>, <a -href="glossaries-user.html#dx1-72002" >4162</a>, <a -href="glossaries-user.html#dx1-72004" >4163</a>, <a -href="glossaries-user.html#dx1-73032" >4164</a>, <a -href="glossaries-user.html#dx1-112092" >4165</a> <br /></span> +href="glossaries-user.html#dx1-6005" >4161</a>, <a +href="glossaries-user.html#dx1-6006" >4162</a>, <a +href="glossaries-user.html#dx1-72002" >4163</a>, <a +href="glossaries-user.html#dx1-72004" >4164</a>, <a +href="glossaries-user.html#dx1-73032" >4165</a>, <a +href="glossaries-user.html#dx1-112092" >4166</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-6007" >4166</a>, <a -href="glossaries-user.html#dx1-6008" >4167</a>, <a -href="glossaries-user.html#dx1-72003" >4168</a>, <a -href="glossaries-user.html#dx1-112085" >4169</a>, <a -href="glossaries-user.html#dx1-112087" >4170</a>, <a -href="glossaries-user.html#dx1-112090" >4171</a>, <a -href="glossaries-user.html#dx1-112099" >4172</a>, <a -href="glossaries-user.html#dx1-112161" >4173</a>, <a -href="glossaries-user.html#dx1-141055" >4174</a> <br /></span> +href="glossaries-user.html#dx1-6007" >4167</a>, <a +href="glossaries-user.html#dx1-6008" >4168</a>, <a +href="glossaries-user.html#dx1-72003" >4169</a>, <a +href="glossaries-user.html#dx1-112085" >4170</a>, <a +href="glossaries-user.html#dx1-112087" >4171</a>, <a +href="glossaries-user.html#dx1-112090" >4172</a>, <a +href="glossaries-user.html#dx1-112099" >4173</a>, <a +href="glossaries-user.html#dx1-112161" >4174</a>, <a +href="glossaries-user.html#dx1-141055" >4175</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">savenumberlist</span>  <a -href="glossaries-user.html#x1-450002.3" >4175</a>, <a -href="glossaries-user.html#dx1-140058" >4176</a>, <a -href="glossaries-user.html#dx1-220002" >4177</a>, <a -href="glossaries-user.html#dx1-220021" >4178</a>, <a -href="glossaries-user.html#dx1-220028" >4179</a> <br /></span> +href="glossaries-user.html#x1-450002.3" >4176</a>, <a +href="glossaries-user.html#dx1-140058" >4177</a>, <a +href="glossaries-user.html#dx1-220002" >4178</a>, <a +href="glossaries-user.html#dx1-220021" >4179</a>, <a +href="glossaries-user.html#dx1-220028" >4180</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-45002" >4180</a> <br /></span> +href="glossaries-user.html#dx1-45002" >4181</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">savewrites</span>  <a -href="glossaries-user.html#x1-310002.1" >4181</a>, <a -href="glossaries-user.html#dx1-31005" >4182</a>, <a -href="glossaries-user.html#dx1-31015" >4183</a> <br /></span> +href="glossaries-user.html#x1-310002.1" >4182</a>, <a +href="glossaries-user.html#dx1-31005" >4183</a>, <a +href="glossaries-user.html#dx1-31015" >4184</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-31001" >4184</a> <br /></span> +href="glossaries-user.html#dx1-31001" >4185</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">section</span>  <a -href="glossaries-user.html#x1-410002.2" >4185</a>, <a -href="glossaries-user.html#dx1-141068" >4186</a> <br /></span> +href="glossaries-user.html#x1-410002.2" >4186</a>, <a +href="glossaries-user.html#dx1-141068" >4187</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">seeautonumberlist</span>  <a -href="glossaries-user.html#x1-560002.3" >4187</a>, <a -href="glossaries-user.html#dx1-56006" >4188</a>, <a -href="glossaries-user.html#dx1-112120" >4189</a>, <a -href="glossaries-user.html#dx1-138026" >4190</a> <br /></span> +href="glossaries-user.html#x1-560002.3" >4188</a>, <a +href="glossaries-user.html#dx1-56006" >4189</a>, <a +href="glossaries-user.html#dx1-112120" >4190</a>, <a +href="glossaries-user.html#dx1-138026" >4191</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">seenoindex</span>  <a -href="glossaries-user.html#x1-620002.4" >4191</a>, <a -href="glossaries-user.html#dx1-112126" >4192</a> <br /></span> +href="glossaries-user.html#x1-620002.4" >4192</a>, <a +href="glossaries-user.html#dx1-112126" >4193</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">ignore</span>  <a -href="glossaries-user.html#dx1-62005" >4193</a> <br /></span> +href="glossaries-user.html#dx1-62005" >4194</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">warn</span>  <a -href="glossaries-user.html#dx1-62004" >4194</a> <br /></span> +href="glossaries-user.html#dx1-62004" >4195</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">shortcuts</span>  <a -href="glossaries-user.html#x1-940002.7" >4195</a>, <a -href="glossaries-user.html#dx1-147084" >4196</a> <br /></span> +href="glossaries-user.html#x1-940002.7" >4196</a>, <a +href="glossaries-user.html#dx1-147084" >4197</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">smallcaps </span>(deprecated)  <a -href="glossaries-user.html#dx1-96002" >4197</a>, <a -href="glossaries-user.html#dx1-96006" >4198</a>, <a -href="glossaries-user.html#x1-970002.7.1" >4199</a>, <a -href="glossaries-user.html#dx1-99002" >4200</a>, <a -href="glossaries-user.html#dx1-99005" >4201</a>, <a -href="glossaries-user.html#dx1-108018" >4202</a> <br /></span> +href="glossaries-user.html#dx1-96002" >4198</a>, <a +href="glossaries-user.html#dx1-96006" >4199</a>, <a +href="glossaries-user.html#x1-970002.7.1" >4200</a>, <a +href="glossaries-user.html#dx1-99002" >4201</a>, <a +href="glossaries-user.html#dx1-99005" >4202</a>, <a +href="glossaries-user.html#dx1-108018" >4203</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">smaller </span>(deprecated)  <a -href="glossaries-user.html#dx1-96003" >4203</a>, <a -href="glossaries-user.html#dx1-96008" >4204</a>, <a -href="glossaries-user.html#x1-980002.7.1" >4205</a>, <a -href="glossaries-user.html#dx1-99003" >4206</a>, <a -href="glossaries-user.html#dx1-99007" >4207</a> <br /></span> +href="glossaries-user.html#dx1-96003" >4204</a>, <a +href="glossaries-user.html#dx1-96008" >4205</a>, <a +href="glossaries-user.html#x1-980002.7.1" >4206</a>, <a +href="glossaries-user.html#dx1-99003" >4207</a>, <a +href="glossaries-user.html#dx1-99007" >4208</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">sort</span>  <a -href="glossaries-user.html#dx1-71001" >4208</a>, <a -href="glossaries-user.html#x1-730002.5" >4209</a> <br /></span> +href="glossaries-user.html#dx1-71001" >4209</a>, <a +href="glossaries-user.html#x1-730002.5" >4210</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">def</span>  <a -href="glossaries-user.html#dx1-6010" >4210</a>, <a -href="glossaries-user.html#dx1-6017" >4211</a>, <a -href="glossaries-user.html#dx1-73003" >4212</a>, <a -href="glossaries-user.html#dx1-73010" >4213</a>, <a -href="glossaries-user.html#dx1-73014" >4214</a>, <a -href="glossaries-user.html#dx1-73017" >4215</a>, <a -href="glossaries-user.html#dx1-73022" >4216</a>, <a -href="glossaries-user.html#dx1-73034" >4217</a>, <a -href="glossaries-user.html#dx1-112074" >4218</a>, <a -href="glossaries-user.html#dx1-121006" >4219</a>, <a -href="glossaries-user.html#dx1-156007" >4220</a> <br /></span> +href="glossaries-user.html#dx1-6010" >4211</a>, <a +href="glossaries-user.html#dx1-6017" >4212</a>, <a +href="glossaries-user.html#dx1-73003" >4213</a>, <a +href="glossaries-user.html#dx1-73010" >4214</a>, <a +href="glossaries-user.html#dx1-73014" >4215</a>, <a +href="glossaries-user.html#dx1-73017" >4216</a>, <a +href="glossaries-user.html#dx1-73022" >4217</a>, <a +href="glossaries-user.html#dx1-73034" >4218</a>, <a +href="glossaries-user.html#dx1-112074" >4219</a>, <a +href="glossaries-user.html#dx1-121006" >4220</a>, <a +href="glossaries-user.html#dx1-156007" >4221</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">none</span>  <a -href="glossaries-user.html#dx1-5008" >4221</a>, <a -href="glossaries-user.html#dx1-5015" >4222</a>, <a -href="glossaries-user.html#dx1-10002" >4223</a>, <a -href="glossaries-user.html#dx1-11022" >4224</a>, <a -href="glossaries-user.html#dx1-71003" >4225</a>, <a -href="glossaries-user.html#dx1-73019" >4226</a> <br /></span> +href="glossaries-user.html#dx1-5008" >4222</a>, <a +href="glossaries-user.html#dx1-5015" >4223</a>, <a +href="glossaries-user.html#dx1-10002" >4224</a>, <a +href="glossaries-user.html#dx1-11022" >4225</a>, <a +href="glossaries-user.html#dx1-71003" >4226</a>, <a +href="glossaries-user.html#dx1-73019" >4227</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">standard</span>  <a -href="glossaries-user.html#dx1-73005" >4227</a>, <a -href="glossaries-user.html#dx1-73023" >4228</a>, <a -href="glossaries-user.html#dx1-73040" >4229</a> <br /></span> +href="glossaries-user.html#dx1-73005" >4228</a>, <a +href="glossaries-user.html#dx1-73023" >4229</a>, <a +href="glossaries-user.html#dx1-73040" >4230</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">use</span>  <a -href="glossaries-user.html#dx1-6009" >4230</a>, <a -href="glossaries-user.html#dx1-6018" >4231</a>, <a -href="glossaries-user.html#dx1-73004" >4232</a>, <a -href="glossaries-user.html#dx1-73012" >4233</a>, <a -href="glossaries-user.html#dx1-73015" >4234</a>, <a -href="glossaries-user.html#dx1-73018" >4235</a>, <a -href="glossaries-user.html#dx1-73021" >4236</a>, <a -href="glossaries-user.html#dx1-73035" >4237</a>, <a -href="glossaries-user.html#dx1-112075" >4238</a>, <a -href="glossaries-user.html#dx1-121005" >4239</a>, <a -href="glossaries-user.html#dx1-156008" >4240</a> <br /></span> +href="glossaries-user.html#dx1-6009" >4231</a>, <a +href="glossaries-user.html#dx1-6018" >4232</a>, <a +href="glossaries-user.html#dx1-73004" >4233</a>, <a +href="glossaries-user.html#dx1-73012" >4234</a>, <a +href="glossaries-user.html#dx1-73015" >4235</a>, <a +href="glossaries-user.html#dx1-73018" >4236</a>, <a +href="glossaries-user.html#dx1-73021" >4237</a>, <a +href="glossaries-user.html#dx1-73035" >4238</a>, <a +href="glossaries-user.html#dx1-112075" >4239</a>, <a +href="glossaries-user.html#dx1-121005" >4240</a>, <a +href="glossaries-user.html#dx1-156008" >4241</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">style</span>  <a -href="glossaries-user.html#x1-490002.3" >4241</a>, <a -href="glossaries-user.html#dx1-52005" >4242</a>, <a -href="glossaries-user.html#dx1-54002" >4243</a>, <a -href="glossaries-user.html#dx1-141026" >4244</a>, <a -href="glossaries-user.html#dx1-155005" >4245</a>, <a -href="glossaries-user.html#dx1-159008" >4246</a>, <a -href="glossaries-user.html#dx1-160008" >4247</a>, <a -href="glossaries-user.html#dx1-162008" >4248</a> <br /></span> +href="glossaries-user.html#x1-490002.3" >4242</a>, <a +href="glossaries-user.html#dx1-52005" >4243</a>, <a +href="glossaries-user.html#dx1-54002" >4244</a>, <a +href="glossaries-user.html#dx1-141026" >4245</a>, <a +href="glossaries-user.html#dx1-155005" >4246</a>, <a +href="glossaries-user.html#dx1-159008" >4247</a>, <a +href="glossaries-user.html#dx1-160008" >4248</a>, <a +href="glossaries-user.html#dx1-162008" >4249</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">index</span>  <a -href="glossaries-user.html#dx1-49003" >4249</a> <br /></span> +href="glossaries-user.html#dx1-49003" >4250</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">list</span>  <a -href="glossaries-user.html#dx1-49001" >4250</a> <br /></span> +href="glossaries-user.html#dx1-49001" >4251</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">stylemods</span>  <a -href="glossaries-user.html#dx1-4013" >4251</a>, <a -href="glossaries-user.html#dx1-4014" >4252</a>, <a -href="glossaries-user.html#x1-600002.3" >4253</a>, <a -href="glossaries-user.html#dx1-178010" >4254</a>, <a -href="glossaries-user.html#dx1-179007" >4255</a>, <a -href="glossaries-user.html#dx1-188017" >4256</a>, <a -href="glossaries-user.html#dx1-202010" >4257</a>, <a -href="glossaries-user.html#dx1-202011" >4258</a>, <a -href="glossaries-user.html#dx1-202038" >4259</a>, <a -href="glossaries-user.html#dx1-204007" >4260</a>, <a -href="glossaries-user.html#dx1-219009" >4261</a>, <a -href="glossaries-user.html#dx1-219012" >4262</a> <br /></span> +href="glossaries-user.html#dx1-4013" >4252</a>, <a +href="glossaries-user.html#dx1-4014" >4253</a>, <a +href="glossaries-user.html#x1-600002.3" >4254</a>, <a +href="glossaries-user.html#dx1-178010" >4255</a>, <a +href="glossaries-user.html#dx1-179007" >4256</a>, <a +href="glossaries-user.html#dx1-188017" >4257</a>, <a +href="glossaries-user.html#dx1-202010" >4258</a>, <a +href="glossaries-user.html#dx1-202011" >4259</a>, <a +href="glossaries-user.html#dx1-202038" >4260</a>, <a +href="glossaries-user.html#dx1-204007" >4261</a>, <a +href="glossaries-user.html#dx1-219009" >4262</a>, <a +href="glossaries-user.html#dx1-219012" >4263</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">subentrycounter</span>  <a -href="glossaries-user.html#x1-480002.3" >4263</a>, <a -href="glossaries-user.html#dx1-119001" >4264</a>, <a -href="glossaries-user.html#dx1-121007" >4265</a>, <a -href="glossaries-user.html#dx1-156003" >4266</a>, <a -href="glossaries-user.html#dx1-166065" >4267</a>, <a -href="glossaries-user.html#dx1-166085" >4268</a> <br /></span> +href="glossaries-user.html#x1-480002.3" >4264</a>, <a +href="glossaries-user.html#dx1-119001" >4265</a>, <a +href="glossaries-user.html#dx1-121007" >4266</a>, <a +href="glossaries-user.html#dx1-156003" >4267</a>, <a +href="glossaries-user.html#dx1-166065" >4268</a>, <a +href="glossaries-user.html#dx1-166085" >4269</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-48001" >4269</a> <br /></span> +href="glossaries-user.html#dx1-48001" >4270</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">symbols</span>  <a -href="glossaries-user.html#dx1-4015" >4270</a>, <a -href="glossaries-user.html#dx1-6013" >4271</a>, <a -href="glossaries-user.html#dx1-7027" >4272</a>, <a -href="glossaries-user.html#dx1-8015" >4273</a>, <a -href="glossaries-user.html#dx1-8028" >4274</a>, <a -href="glossaries-user.html#dx1-84004" >4275</a>, <a -href="glossaries-user.html#x1-850002.6" >4276</a>, <a -href="glossaries-user.html#dx1-146021" >4277</a> <br /></span> +href="glossaries-user.html#dx1-4015" >4271</a>, <a +href="glossaries-user.html#dx1-6013" >4272</a>, <a +href="glossaries-user.html#dx1-7027" >4273</a>, <a +href="glossaries-user.html#dx1-8015" >4274</a>, <a +href="glossaries-user.html#dx1-8028" >4275</a>, <a +href="glossaries-user.html#dx1-84004" >4276</a>, <a +href="glossaries-user.html#x1-850002.6" >4277</a>, <a +href="glossaries-user.html#dx1-146021" >4278</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">toc</span>  <a -href="glossaries-user.html#dx1-7051" >4278</a>, <a -href="glossaries-user.html#x1-390002.2" >4279</a>, <a -href="glossaries-user.html#dx1-40004" >4280</a>, <a -href="glossaries-user.html#dx1-40005" >4281</a>, <a -href="glossaries-user.html#dx1-141023" >4282</a>, <a -href="glossaries-user.html#dx1-178015" >4283</a>, <a -href="glossaries-user.html#dx1-179004" >4284</a> <br /></span> +href="glossaries-user.html#dx1-7051" >4279</a>, <a +href="glossaries-user.html#x1-390002.2" >4280</a>, <a +href="glossaries-user.html#dx1-40004" >4281</a>, <a +href="glossaries-user.html#dx1-40005" >4282</a>, <a +href="glossaries-user.html#dx1-141023" >4283</a>, <a +href="glossaries-user.html#dx1-178015" >4284</a>, <a +href="glossaries-user.html#dx1-179004" >4285</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-39003" >4285</a> <br /></span> +href="glossaries-user.html#dx1-39003" >4286</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-39004" >4286</a>, <a -href="glossaries-user.html#dx1-40001" >4287</a> <br /></span> +href="glossaries-user.html#dx1-39004" >4287</a>, <a +href="glossaries-user.html#dx1-40001" >4288</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">translate</span>  <a -href="glossaries-user.html#x1-320002.1" >4288</a>, <a -href="glossaries-user.html#dx1-32023" >4289</a>, <a -href="glossaries-user.html#dx1-32025" >4290</a>, <a -href="glossaries-user.html#dx1-108013" >4291</a> <br /></span> +href="glossaries-user.html#x1-320002.1" >4289</a>, <a +href="glossaries-user.html#dx1-32023" >4290</a>, <a +href="glossaries-user.html#dx1-32025" >4291</a>, <a +href="glossaries-user.html#dx1-108013" >4292</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">babel</span>  <a -href="glossaries-user.html#dx1-14012" >4292</a>, <a -href="glossaries-user.html#dx1-14017" >4293</a>, <a -href="glossaries-user.html#dx1-14039" >4294</a>, <a -href="glossaries-user.html#dx1-14043" >4295</a>, <a -href="glossaries-user.html#dx1-14051" >4296</a>, <a -href="glossaries-user.html#dx1-32017" >4297</a>, <a -href="glossaries-user.html#dx1-32020" >4298</a>, <a -href="glossaries-user.html#dx1-32032" >4299</a> <br /></span> +href="glossaries-user.html#dx1-14012" >4293</a>, <a +href="glossaries-user.html#dx1-14017" >4294</a>, <a +href="glossaries-user.html#dx1-14039" >4295</a>, <a +href="glossaries-user.html#dx1-14043" >4296</a>, <a +href="glossaries-user.html#dx1-14051" >4297</a>, <a +href="glossaries-user.html#dx1-32017" >4298</a>, <a +href="glossaries-user.html#dx1-32020" >4299</a>, <a +href="glossaries-user.html#dx1-32032" >4300</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-14011" >4300</a>, <a -href="glossaries-user.html#dx1-32011" >4301</a>, <a -href="glossaries-user.html#dx1-32030" >4302</a>, <a -href="glossaries-user.html#dx1-33001" >4303</a> <br /></span> +href="glossaries-user.html#dx1-14011" >4301</a>, <a +href="glossaries-user.html#dx1-32011" >4302</a>, <a +href="glossaries-user.html#dx1-32030" >4303</a>, <a +href="glossaries-user.html#dx1-33001" >4304</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-32001" >4304</a>, <a -href="glossaries-user.html#dx1-32022" >4305</a>, <a -href="glossaries-user.html#dx1-32024" >4306</a>, <a -href="glossaries-user.html#dx1-32026" >4307</a> <br /></span> +href="glossaries-user.html#dx1-32001" >4305</a>, <a +href="glossaries-user.html#dx1-32022" >4306</a>, <a +href="glossaries-user.html#dx1-32024" >4307</a>, <a +href="glossaries-user.html#dx1-32026" >4308</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">ucmark</span>  <a -href="glossaries-user.html#dx1-41007" >4308</a>, <a -href="glossaries-user.html#x1-420002.2" >4309</a>, <a -href="glossaries-user.html#dx1-42013" >4310</a> <br /></span> +href="glossaries-user.html#dx1-41007" >4309</a>, <a +href="glossaries-user.html#x1-420002.2" >4310</a>, <a +href="glossaries-user.html#dx1-42013" >4311</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-42001" >4311</a> <br /></span> +href="glossaries-user.html#dx1-42001" >4312</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-42003" >4312</a> <br /></span> +href="glossaries-user.html#dx1-42003" >4313</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">undefaction</span>  <a -href="glossaries-user.html#x1-360002.1" >4313</a> <br /></span> +href="glossaries-user.html#x1-360002.1" >4314</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">writeglslabels</span>  <a -href="glossaries-user.html#dx1-23001" >4314</a>, <a -href="glossaries-user.html#x1-350002.1" >4315</a> <br /></span> +href="glossaries-user.html#dx1-23001" >4315</a>, <a +href="glossaries-user.html#x1-350002.1" >4316</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">xindy</span>  <a -href="glossaries-user.html#dx1-8021" >4316</a>, <a -href="glossaries-user.html#dx1-13008" >4317</a>, <a -href="glossaries-user.html#dx1-16092" >4318</a>, <a -href="glossaries-user.html#dx1-19003" >4319</a>, <a -href="glossaries-user.html#dx1-20002" >4320</a>, <a -href="glossaries-user.html#dx1-75008" >4321</a>, <a -href="glossaries-user.html#x1-760002.5" >4322</a>, <a -href="glossaries-user.html#dx1-77001" >4323</a>, <a -href="glossaries-user.html#dx1-108002" >4324</a>, <a -href="glossaries-user.html#dx1-108016" >4325</a>, <a -href="glossaries-user.html#dx1-142002" >4326</a>, <a -href="glossaries-user.html#dx1-144001" >4327</a>, <a -href="glossaries-user.html#dx1-145001" >4328</a>, <a -href="glossaries-user.html#dx1-210003" >4329</a>, <a -href="glossaries-user.html#dx1-212008" >4330</a>, <a -href="glossaries-user.html#dx1-214006" >4331</a>, <a -href="glossaries-user.html#dx1-214011" >4332</a> <br /></span> +href="glossaries-user.html#dx1-8021" >4317</a>, <a +href="glossaries-user.html#dx1-13008" >4318</a>, <a +href="glossaries-user.html#dx1-16092" >4319</a>, <a +href="glossaries-user.html#dx1-19003" >4320</a>, <a +href="glossaries-user.html#dx1-20002" >4321</a>, <a +href="glossaries-user.html#dx1-75008" >4322</a>, <a +href="glossaries-user.html#x1-760002.5" >4323</a>, <a +href="glossaries-user.html#dx1-77001" >4324</a>, <a +href="glossaries-user.html#dx1-108002" >4325</a>, <a +href="glossaries-user.html#dx1-108016" >4326</a>, <a +href="glossaries-user.html#dx1-142002" >4327</a>, <a +href="glossaries-user.html#dx1-144001" >4328</a>, <a +href="glossaries-user.html#dx1-145001" >4329</a>, <a +href="glossaries-user.html#dx1-210003" >4330</a>, <a +href="glossaries-user.html#dx1-212008" >4331</a>, <a +href="glossaries-user.html#dx1-214006" >4332</a>, <a +href="glossaries-user.html#dx1-214011" >4333</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">xindygloss</span>  <a -href="glossaries-user.html#x1-770002.5" >4333</a>, <a -href="glossaries-user.html#dx1-108003" >4334</a> <br /></span> +href="glossaries-user.html#x1-770002.5" >4334</a>, <a +href="glossaries-user.html#dx1-108003" >4335</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">xindynoglsnumbers</span>  <a -href="glossaries-user.html#x1-780002.5" >4335</a>, <a -href="glossaries-user.html#dx1-108004" >4336</a> <br /></span> +href="glossaries-user.html#x1-780002.5" >4336</a>, <a +href="glossaries-user.html#dx1-108004" >4337</a> <br /></span> <span class="index-item"><span class="cmtt-10">page </span>(counter)  <a -href="glossaries-user.html#dx1-144039" >4337</a>, <a -href="glossaries-user.html#dx1-144045" >4338</a> <br /></span> +href="glossaries-user.html#dx1-144039" >4338</a>, <a +href="glossaries-user.html#dx1-144045" >4339</a> <br /></span> <span class="index-item">page type precedence  <a -href="glossaries-user.html#dx1-131005" >4339</a> <br /></span> +href="glossaries-user.html#dx1-131005" >4340</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\pagelistname</span></span></span>  <a -href="glossaries-user.html#dx1-14030" >4340</a> <br /></span> +href="glossaries-user.html#dx1-14030" >4341</a> <br /></span> <span class="index-item"><span class="cmtt-10">pdflatex</span>  <a -href="glossaries-user.html#dx1-27" >4341</a>, <a -href="glossaries-user.html#dx1-132019" >4342</a> <br /></span> +href="glossaries-user.html#dx1-27" >4342</a>, <a +href="glossaries-user.html#dx1-132019" >4343</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\PGLS</span></span></span>  <a href="glossaries-user.html#dx1-171028" ><span -class="cmti-10">4343</span></a> <br /></span> +class="cmti-10">4344</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Pgls</span></span></span>  <a href="glossaries-user.html#dx1-171024" ><span -class="cmti-10">4344</span></a> <br /></span> +class="cmti-10">4345</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\pgls</span></span></span>  <a href="glossaries-user.html#dx1-171021" ><span -class="cmti-10">4345</span></a>, <a -href="glossaries-user.html#dx1-178008" >4346</a> <br /></span> +class="cmti-10">4346</span></a>, <a +href="glossaries-user.html#dx1-178008" >4347</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\PGLSpl</span></span></span>  <a href="glossaries-user.html#dx1-171037" ><span -class="cmti-10">4347</span></a> <br /></span> +class="cmti-10">4348</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Pglspl</span></span></span>  <a href="glossaries-user.html#dx1-171033" ><span -class="cmti-10">4348</span></a> <br /></span> +class="cmti-10">4349</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\pglspl</span></span></span>  <a href="glossaries-user.html#dx1-171030" ><span -class="cmti-10">4349</span></a> <br /></span> +class="cmti-10">4350</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\pi</span></span></span>  <a -href="glossaries-user.html#dx1-202082" >4350</a> <br /></span> +href="glossaries-user.html#dx1-202082" >4351</a> <br /></span> <span class="index-item"><span class="cmss-10">polyglossia </span>package  <a -href="glossaries-user.html#dx1-14002" >4351</a>, <a -href="glossaries-user.html#dx1-14004" >4352</a>, <a -href="glossaries-user.html#dx1-14006" >4353</a>, <a -href="glossaries-user.html#dx1-14041" >4354</a>, <a -href="glossaries-user.html#dx1-32009" >4355</a>, <a -href="glossaries-user.html#dx1-32013" >4356</a>, <a -href="glossaries-user.html#dx1-32028" >4357</a> <br /></span> +href="glossaries-user.html#dx1-14002" >4352</a>, <a +href="glossaries-user.html#dx1-14004" >4353</a>, <a +href="glossaries-user.html#dx1-14006" >4354</a>, <a +href="glossaries-user.html#dx1-14041" >4355</a>, <a +href="glossaries-user.html#dx1-32009" >4356</a>, <a +href="glossaries-user.html#dx1-32013" >4357</a>, <a +href="glossaries-user.html#dx1-32028" >4358</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\primary</span></span></span>  <a -href="glossaries-user.html#dx1-190020" >4358</a> <br /></span> +href="glossaries-user.html#dx1-190020" >4359</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printacronyms</span></span></span>  <a href="glossaries-user.html#dx1-90001" ><span -class="cmti-10">4359</span></a>, <a -href="glossaries-user.html#dx1-147004" >4360</a>, <a -href="glossaries-user.html#dx1-151006" >4361</a> <br /></span> +class="cmti-10">4360</span></a>, <a +href="glossaries-user.html#dx1-147004" >4361</a>, <a +href="glossaries-user.html#dx1-151006" >4362</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printglossaries</span></span></span>  <a -href="glossaries-user.html#dx1-123002" >4362</a>, <a +href="glossaries-user.html#dx1-123002" >4363</a>, <a href="glossaries-user.html#dx1-141004" ><span -class="cmti-10">4363</span></a>, <a -href="glossaries-user.html#dx1-146009" >4364</a>, <a -href="glossaries-user.html#dx1-151010" >4365</a>, <a -href="glossaries-user.html#dx1-166069" >4366</a>, <a -href="glossaries-user.html#dx1-169004" >4367</a>, <a -href="glossaries-user.html#dx1-190030" >4368</a>, <a -href="glossaries-user.html#dx1-198010" >4369</a>, <a -href="glossaries-user.html#dx1-211049" >4370</a> <br /></span> +class="cmti-10">4364</span></a>, <a +href="glossaries-user.html#dx1-146009" >4365</a>, <a +href="glossaries-user.html#dx1-151010" >4366</a>, <a +href="glossaries-user.html#dx1-166069" >4367</a>, <a +href="glossaries-user.html#dx1-169005" >4368</a>, <a +href="glossaries-user.html#dx1-190030" >4369</a>, <a +href="glossaries-user.html#dx1-198010" >4370</a>, <a +href="glossaries-user.html#dx1-211049" >4371</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printglossary</span></span></span>  <a -href="glossaries-user.html#dx1-7002" >4371</a>, <a -href="glossaries-user.html#dx1-8002" >4372</a>, <a -href="glossaries-user.html#dx1-54005" >4373</a>, <a -href="glossaries-user.html#dx1-85002" >4374</a>, <a -href="glossaries-user.html#dx1-86002" >4375</a>, <a -href="glossaries-user.html#dx1-87005" >4376</a>, <a -href="glossaries-user.html#dx1-90002" >4377</a>, <a +href="glossaries-user.html#dx1-7002" >4372</a>, <a +href="glossaries-user.html#dx1-8002" >4373</a>, <a +href="glossaries-user.html#dx1-54005" >4374</a>, <a +href="glossaries-user.html#dx1-85002" >4375</a>, <a +href="glossaries-user.html#dx1-86002" >4376</a>, <a +href="glossaries-user.html#dx1-87005" >4377</a>, <a +href="glossaries-user.html#dx1-90002" >4378</a>, <a href="glossaries-user.html#dx1-141016" ><span -class="cmti-10">4378</span></a>, <a -href="glossaries-user.html#dx1-147003" >4379</a>, <a -href="glossaries-user.html#dx1-151003" >4380</a>, <a -href="glossaries-user.html#dx1-151007" >4381</a>, <a -href="glossaries-user.html#dx1-155003" >4382</a>, <a -href="glossaries-user.html#dx1-156031" >4383</a>, <a -href="glossaries-user.html#dx1-166068" >4384</a>, <a -href="glossaries-user.html#dx1-169003" >4385</a>, <a -href="glossaries-user.html#dx1-188038" >4386</a> <br /></span> +class="cmti-10">4379</span></a>, <a +href="glossaries-user.html#dx1-147003" >4380</a>, <a +href="glossaries-user.html#dx1-151003" >4381</a>, <a +href="glossaries-user.html#dx1-151007" >4382</a>, <a +href="glossaries-user.html#dx1-155003" >4383</a>, <a +href="glossaries-user.html#dx1-156031" >4384</a>, <a +href="glossaries-user.html#dx1-166068" >4385</a>, <a +href="glossaries-user.html#dx1-169004" >4386</a>, <a +href="glossaries-user.html#dx1-188038" >4387</a> <br /></span> <span class="index-item"><span class="cmtt-10">\printglossary </span>options<br /></span> <span class="index-subitem">    <span class="cmtt-10">entrycounter</span>  <a -href="glossaries-user.html#dx1-141034" >4387</a> <br /></span> +href="glossaries-user.html#dx1-141034" >4388</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">label</span>  <a -href="glossaries-user.html#dx1-141057" >4388</a> <br /></span> +href="glossaries-user.html#dx1-141057" >4389</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">nogroupskip</span>  <a -href="glossaries-user.html#dx1-141032" >4389</a> <br /></span> +href="glossaries-user.html#dx1-141032" >4390</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">nonumberlist</span>  <a -href="glossaries-user.html#dx1-141031" >4390</a> <br /></span> +href="glossaries-user.html#dx1-141031" >4391</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">nopostdot</span>  <a -href="glossaries-user.html#dx1-141033" >4391</a> <br /></span> +href="glossaries-user.html#dx1-141033" >4392</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">numberedsection</span>  <a -href="glossaries-user.html#dx1-141028" >4392</a> <br /></span> +href="glossaries-user.html#dx1-141028" >4393</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">prefix</span>  <a -href="glossaries-user.html#dx1-141061" >4393</a> <br /></span> +href="glossaries-user.html#dx1-141061" >4394</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">style</span>  <a -href="glossaries-user.html#dx1-54004" >4394</a>, <a -href="glossaries-user.html#dx1-141025" >4395</a>, <a -href="glossaries-user.html#dx1-155001" >4396</a>, <a -href="glossaries-user.html#dx1-156029" >4397</a>, <a -href="glossaries-user.html#dx1-160019" >4398</a> <br /></span> +href="glossaries-user.html#dx1-54004" >4395</a>, <a +href="glossaries-user.html#dx1-141025" >4396</a>, <a +href="glossaries-user.html#dx1-155001" >4397</a>, <a +href="glossaries-user.html#dx1-156029" >4398</a>, <a +href="glossaries-user.html#dx1-160019" >4399</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">subentrycounter</span>  <a -href="glossaries-user.html#dx1-141036" >4399</a> <br /></span> +href="glossaries-user.html#dx1-141036" >4400</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">target</span>  <a -href="glossaries-user.html#dx1-11081" >4400</a>, <a -href="glossaries-user.html#dx1-141059" >4401</a> <br /></span> +href="glossaries-user.html#dx1-11081" >4401</a>, <a +href="glossaries-user.html#dx1-141059" >4402</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">targetnameprefix</span>  <a -href="glossaries-user.html#dx1-141063" >4402</a> <br /></span> +href="glossaries-user.html#dx1-141063" >4403</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">title</span>  <a -href="glossaries-user.html#dx1-4" >4403</a>, <a -href="glossaries-user.html#dx1-14045" >4404</a>, <a -href="glossaries-user.html#dx1-141021" >4405</a>, <a -href="glossaries-user.html#dx1-141024" >4406</a>, <a -href="glossaries-user.html#dx1-147002" >4407</a> <br /></span> +href="glossaries-user.html#dx1-4" >4404</a>, <a +href="glossaries-user.html#dx1-14045" >4405</a>, <a +href="glossaries-user.html#dx1-141021" >4406</a>, <a +href="glossaries-user.html#dx1-141024" >4407</a>, <a +href="glossaries-user.html#dx1-147002" >4408</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">toctitle</span>  <a -href="glossaries-user.html#dx1-141022" >4408</a> <br /></span> +href="glossaries-user.html#dx1-141022" >4409</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">type</span>  <a -href="glossaries-user.html#dx1-141018" >4409</a>, <a -href="glossaries-user.html#dx1-141019" >4410</a> <br /></span> +href="glossaries-user.html#dx1-141018" >4410</a>, <a +href="glossaries-user.html#dx1-141019" >4411</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printindex</span></span></span>  <a href="glossaries-user.html#dx1-87004" ><span -class="cmti-10">4411</span></a> <br /></span> +class="cmti-10">4412</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printnoidxglossaries</span></span></span>  <a href="glossaries-user.html#dx1-141002" ><span -class="cmti-10">4412</span></a>, <a -href="glossaries-user.html#dx1-151009" >4413</a> <br /></span> +class="cmti-10">4413</span></a>, <a +href="glossaries-user.html#dx1-151009" >4414</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printnoidxglossary</span></span></span>  <a -href="glossaries-user.html#dx1-6002" >4414</a>, <a -href="glossaries-user.html#dx1-73002" >4415</a>, <a -href="glossaries-user.html#dx1-73039" >4416</a>, <a -href="glossaries-user.html#dx1-74006" >4417</a>, <a -href="glossaries-user.html#dx1-85003" >4418</a>, <a -href="glossaries-user.html#dx1-86003" >4419</a>, <a -href="glossaries-user.html#dx1-87006" >4420</a>, <a -href="glossaries-user.html#dx1-90004" >4421</a>, <a +href="glossaries-user.html#dx1-6002" >4415</a>, <a +href="glossaries-user.html#dx1-73002" >4416</a>, <a +href="glossaries-user.html#dx1-73039" >4417</a>, <a +href="glossaries-user.html#dx1-74006" >4418</a>, <a +href="glossaries-user.html#dx1-85003" >4419</a>, <a +href="glossaries-user.html#dx1-86003" >4420</a>, <a +href="glossaries-user.html#dx1-87006" >4421</a>, <a +href="glossaries-user.html#dx1-90004" >4422</a>, <a href="glossaries-user.html#dx1-141014" ><span -class="cmti-10">4422</span></a>, <a -href="glossaries-user.html#dx1-151001" >4423</a>, <a -href="glossaries-user.html#dx1-155002" >4424</a>, <a -href="glossaries-user.html#dx1-156030" >4425</a>, <a -href="glossaries-user.html#dx1-198011" >4426</a> <br /></span> +class="cmti-10">4423</span></a>, <a +href="glossaries-user.html#dx1-151001" >4424</a>, <a +href="glossaries-user.html#dx1-155002" >4425</a>, <a +href="glossaries-user.html#dx1-156030" >4426</a>, <a +href="glossaries-user.html#dx1-198011" >4427</a> <br /></span> <span class="index-item"><span class="cmtt-10">\printnoidxglossary </span>options<br /></span> <span class="index-subitem">    <span class="cmtt-10">sort</span>  <a -href="glossaries-user.html#dx1-73001" >4427</a>, <a -href="glossaries-user.html#dx1-73038" >4428</a>, <a -href="glossaries-user.html#dx1-74005" >4429</a>, <a -href="glossaries-user.html#dx1-141041" >4430</a>, <a -href="glossaries-user.html#dx1-198013" >4431</a> <br /></span> +href="glossaries-user.html#dx1-73001" >4428</a>, <a +href="glossaries-user.html#dx1-73038" >4429</a>, <a +href="glossaries-user.html#dx1-74005" >4430</a>, <a +href="glossaries-user.html#dx1-141041" >4431</a>, <a +href="glossaries-user.html#dx1-198013" >4432</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printnumbers</span></span></span>  <a href="glossaries-user.html#dx1-86001" ><span -class="cmti-10">4432</span></a> <br /></span> +class="cmti-10">4433</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printsymbols</span></span></span>  <a href="glossaries-user.html#dx1-85001" ><span -class="cmti-10">4433</span></a> <br /></span> +class="cmti-10">4434</span></a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printunsrtacronyms</span></span></span>  <a -href="glossaries-user.html#dx1-223015" >4434</a> <br /></span> +href="glossaries-user.html#dx1-223015" >4435</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printunsrtglossaries</span></span></span>  <a -href="glossaries-user.html#dx1-4010" >4435</a>, <a -href="glossaries-user.html#dx1-9032" >4436</a>, <a -href="glossaries-user.html#dx1-10005" >4437</a>, <a -href="glossaries-user.html#dx1-175058" >4438</a>, <a -href="glossaries-user.html#dx1-190031" >4439</a>, <a -href="glossaries-user.html#dx1-192059" >4440</a>, <a -href="glossaries-user.html#dx1-193022" >4441</a>, <a -href="glossaries-user.html#dx1-197028" >4442</a>, <a -href="glossaries-user.html#dx1-198039" >4443</a>, <a -href="glossaries-user.html#dx1-200090" >4444</a>, <a -href="glossaries-user.html#dx1-202059" >4445</a>, <a -href="glossaries-user.html#dx1-204027" >4446</a>, <a -href="glossaries-user.html#dx1-206019" >4447</a>, <a -href="glossaries-user.html#dx1-211050" >4448</a>, <a -href="glossaries-user.html#dx1-212013" >4449</a>, <a -href="glossaries-user.html#dx1-214035" >4450</a>, <a -href="glossaries-user.html#dx1-220026" >4451</a> <br /></span> +href="glossaries-user.html#dx1-4010" >4436</a>, <a +href="glossaries-user.html#dx1-9032" >4437</a>, <a +href="glossaries-user.html#dx1-10005" >4438</a>, <a +href="glossaries-user.html#dx1-175058" >4439</a>, <a +href="glossaries-user.html#dx1-190031" >4440</a>, <a +href="glossaries-user.html#dx1-192059" >4441</a>, <a +href="glossaries-user.html#dx1-193022" >4442</a>, <a +href="glossaries-user.html#dx1-197028" >4443</a>, <a +href="glossaries-user.html#dx1-198039" >4444</a>, <a +href="glossaries-user.html#dx1-200090" >4445</a>, <a +href="glossaries-user.html#dx1-202059" >4446</a>, <a +href="glossaries-user.html#dx1-204027" >4447</a>, <a +href="glossaries-user.html#dx1-206019" >4448</a>, <a +href="glossaries-user.html#dx1-211050" >4449</a>, <a +href="glossaries-user.html#dx1-212013" >4450</a>, <a +href="glossaries-user.html#dx1-214035" >4451</a>, <a +href="glossaries-user.html#dx1-220026" >4452</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\printunsrtglossary</span></span></span>  <a -href="glossaries-user.html#dx1-9005" >4452</a>, <a -href="glossaries-user.html#dx1-9031" >4453</a>, <a -href="glossaries-user.html#dx1-10001" >4454</a>, <a -href="glossaries-user.html#dx1-10004" >4455</a>, <a -href="glossaries-user.html#dx1-11080" >4456</a>, <a -href="glossaries-user.html#dx1-141060" >4457</a>, <a -href="glossaries-user.html#dx1-179072" >4458</a>, <a -href="glossaries-user.html#dx1-188039" >4459</a>, <a -href="glossaries-user.html#dx1-188040" >4460</a>, <a -href="glossaries-user.html#dx1-193050" >4461</a>, <a -href="glossaries-user.html#dx1-193051" >4462</a>, <a -href="glossaries-user.html#dx1-194039" >4463</a>, <a -href="glossaries-user.html#dx1-220038" >4464</a>, <a -href="glossaries-user.html#dx1-223014" >4465</a> <br /></span> +href="glossaries-user.html#dx1-9005" >4453</a>, <a +href="glossaries-user.html#dx1-9031" >4454</a>, <a +href="glossaries-user.html#dx1-10001" >4455</a>, <a +href="glossaries-user.html#dx1-10004" >4456</a>, <a +href="glossaries-user.html#dx1-11080" >4457</a>, <a +href="glossaries-user.html#dx1-141060" >4458</a>, <a +href="glossaries-user.html#dx1-179072" >4459</a>, <a +href="glossaries-user.html#dx1-188039" >4460</a>, <a +href="glossaries-user.html#dx1-188040" >4461</a>, <a +href="glossaries-user.html#dx1-193050" >4462</a>, <a +href="glossaries-user.html#dx1-193051" >4463</a>, <a +href="glossaries-user.html#dx1-194039" >4464</a>, <a +href="glossaries-user.html#dx1-220038" >4465</a>, <a +href="glossaries-user.html#dx1-223014" >4466</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\providecommand</span></span></span>  <a -href="glossaries-user.html#dx1-197022" >4466</a>, <a -href="glossaries-user.html#dx1-197033" >4467</a> <br /></span> +href="glossaries-user.html#dx1-197022" >4467</a>, <a +href="glossaries-user.html#dx1-197033" >4468</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\provideglossaryentry</span></span></span>  <a href="glossaries-user.html#dx1-112005" ><span -class="cmti-10">4468</span></a>, <a -href="glossaries-user.html#dx1-122030" >4469</a> <br /></span> +class="cmti-10">4469</span></a>, <a +href="glossaries-user.html#dx1-122030" >4470</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\provideignoredglossary</span></span></span>  <a -href="glossaries-user.html#dx1-146013" >4470</a> <br /></span> +href="glossaries-user.html#dx1-146013" >4471</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">R</span> <span class="index-item"><span class="cmss-10">relsize </span>package  <a -href="glossaries-user.html#dx1-3065" >4471</a>, <a -href="glossaries-user.html#dx1-98002" >4472</a>, <a -href="glossaries-user.html#dx1-149016" >4473</a> <br /></span> +href="glossaries-user.html#dx1-3065" >4472</a>, <a +href="glossaries-user.html#dx1-98002" >4473</a>, <a +href="glossaries-user.html#dx1-149016" >4474</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Roman</span></span></span>  <a -href="glossaries-user.html#dx1-144035" >4474</a> <br /></span> +href="glossaries-user.html#dx1-144035" >4475</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">S</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\S</span></span></span>  <a -href="glossaries-user.html#dx1-190045" >4475</a> <br /></span> +href="glossaries-user.html#dx1-190045" >4476</a> <br /></span> <span class="index-item">sanitize  <a href="glossaries-user.html#dx1-3061" ><span -class="cmbx-10">4476</span></a>, <a -href="glossaries-user.html#dx1-72001" >4477</a>, <a -href="glossaries-user.html#dx1-73030" >4478</a>, <a -href="glossaries-user.html#dx1-139015" >4479</a>, <a -href="glossaries-user.html#dx1-140055" >4480</a> <br /></span> +class="cmbx-10">4477</span></a>, <a +href="glossaries-user.html#dx1-72001" >4478</a>, <a +href="glossaries-user.html#dx1-73030" >4479</a>, <a +href="glossaries-user.html#dx1-139015" >4480</a>, <a +href="glossaries-user.html#dx1-140055" >4481</a> <br /></span> <span class="index-item"><span class="cmss-10">scrwfile </span>package  <a -href="glossaries-user.html#dx1-31007" >4481</a> <br /></span> +href="glossaries-user.html#dx1-31007" >4482</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\section*</span></span></span>  <a -href="glossaries-user.html#dx1-43013" >4482</a>, <a -href="glossaries-user.html#dx1-141066" >4483</a> <br /></span> +href="glossaries-user.html#dx1-43013" >4483</a>, <a +href="glossaries-user.html#dx1-141066" >4484</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\seealsoname</span></span></span>  <a -href="glossaries-user.html#dx1-112132" >4484</a>, <a -href="glossaries-user.html#dx1-112133" >4485</a> <br /></span> +href="glossaries-user.html#dx1-112132" >4485</a>, <a +href="glossaries-user.html#dx1-112133" >4486</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\seename</span></span></span>  <a -href="glossaries-user.html#dx1-138011" >4486</a>, <a -href="glossaries-user.html#dx1-138018" >4487</a>, <a -href="glossaries-user.html#dx1-139006" >4488</a> <br /></span> +href="glossaries-user.html#dx1-138011" >4487</a>, <a +href="glossaries-user.html#dx1-138018" >4488</a>, <a +href="glossaries-user.html#dx1-139006" >4489</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setabbreviationstyle</span></span></span>  <a -href="glossaries-user.html#dx1-4007" >4489</a>, <a -href="glossaries-user.html#dx1-175021" >4490</a>, <a -href="glossaries-user.html#dx1-175027" >4491</a>, <a -href="glossaries-user.html#dx1-175028" >4492</a>, <a -href="glossaries-user.html#dx1-175055" >4493</a>, <a -href="glossaries-user.html#dx1-178022" >4494</a>, <a -href="glossaries-user.html#dx1-178024" >4495</a>, <a -href="glossaries-user.html#dx1-178031" >4496</a>, <a -href="glossaries-user.html#dx1-178033" >4497</a>, <a -href="glossaries-user.html#dx1-179012" >4498</a>, <a -href="glossaries-user.html#dx1-179018" >4499</a>, <a -href="glossaries-user.html#dx1-179052" >4500</a>, <a -href="glossaries-user.html#dx1-179057" >4501</a>, <a -href="glossaries-user.html#dx1-179063" >4502</a>, <a -href="glossaries-user.html#dx1-179073" >4503</a>, <a -href="glossaries-user.html#dx1-181003" >4504</a>, <a -href="glossaries-user.html#dx1-182004" >4505</a>, <a -href="glossaries-user.html#dx1-182036" >4506</a>, <a -href="glossaries-user.html#dx1-184047" >4507</a>, <a -href="glossaries-user.html#dx1-184052" >4508</a>, <a -href="glossaries-user.html#dx1-185004" >4509</a>, <a -href="glossaries-user.html#dx1-185005" >4510</a>, <a -href="glossaries-user.html#dx1-186003" >4511</a>, <a -href="glossaries-user.html#dx1-186013" >4512</a>, <a -href="glossaries-user.html#dx1-186029" >4513</a>, <a -href="glossaries-user.html#dx1-193025" >4514</a>, <a -href="glossaries-user.html#dx1-193043" >4515</a>, <a -href="glossaries-user.html#dx1-198007" >4516</a>, <a -href="glossaries-user.html#dx1-198033" >4517</a>, <a -href="glossaries-user.html#dx1-207004" >4518</a>, <a -href="glossaries-user.html#dx1-223011" >4519</a>, <a -href="glossaries-user.html#dx1-224066" >4520</a>, <a -href="glossaries-user.html#dx1-224072" >4521</a> <br /></span> +href="glossaries-user.html#dx1-4007" >4490</a>, <a +href="glossaries-user.html#dx1-175021" >4491</a>, <a +href="glossaries-user.html#dx1-175027" >4492</a>, <a +href="glossaries-user.html#dx1-175028" >4493</a>, <a +href="glossaries-user.html#dx1-175055" >4494</a>, <a +href="glossaries-user.html#dx1-178022" >4495</a>, <a +href="glossaries-user.html#dx1-178024" >4496</a>, <a +href="glossaries-user.html#dx1-178031" >4497</a>, <a +href="glossaries-user.html#dx1-178033" >4498</a>, <a +href="glossaries-user.html#dx1-179012" >4499</a>, <a +href="glossaries-user.html#dx1-179018" >4500</a>, <a +href="glossaries-user.html#dx1-179052" >4501</a>, <a +href="glossaries-user.html#dx1-179057" >4502</a>, <a +href="glossaries-user.html#dx1-179063" >4503</a>, <a +href="glossaries-user.html#dx1-179073" >4504</a>, <a +href="glossaries-user.html#dx1-181003" >4505</a>, <a +href="glossaries-user.html#dx1-182004" >4506</a>, <a +href="glossaries-user.html#dx1-182036" >4507</a>, <a +href="glossaries-user.html#dx1-184047" >4508</a>, <a +href="glossaries-user.html#dx1-184052" >4509</a>, <a +href="glossaries-user.html#dx1-185004" >4510</a>, <a +href="glossaries-user.html#dx1-185005" >4511</a>, <a +href="glossaries-user.html#dx1-186003" >4512</a>, <a +href="glossaries-user.html#dx1-186013" >4513</a>, <a +href="glossaries-user.html#dx1-186029" >4514</a>, <a +href="glossaries-user.html#dx1-193025" >4515</a>, <a +href="glossaries-user.html#dx1-193043" >4516</a>, <a +href="glossaries-user.html#dx1-198007" >4517</a>, <a +href="glossaries-user.html#dx1-198033" >4518</a>, <a +href="glossaries-user.html#dx1-207004" >4519</a>, <a +href="glossaries-user.html#dx1-223011" >4520</a>, <a +href="glossaries-user.html#dx1-224066" >4521</a>, <a +href="glossaries-user.html#dx1-224072" >4522</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setabbreviationstyle</span></span></span>  <a -href="glossaries-user.html#dx1-224045" >4522</a> <br /></span> +href="glossaries-user.html#dx1-224045" >4523</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\SetAcronymLists</span></span></span>  <a href="glossaries-user.html#dx1-93005" ><span -class="cmti-10">4523</span></a> <br /></span> +class="cmti-10">4524</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setacronymstyle</span></span></span>  <a -href="glossaries-user.html#dx1-95001" >4524</a>, <a -href="glossaries-user.html#dx1-133017" >4525</a>, <a -href="glossaries-user.html#dx1-147026" >4526</a>, <a +href="glossaries-user.html#dx1-95001" >4525</a>, <a +href="glossaries-user.html#dx1-133017" >4526</a>, <a +href="glossaries-user.html#dx1-147026" >4527</a>, <a href="glossaries-user.html#dx1-148001" ><span -class="cmti-10">4527</span></a>, <a -href="glossaries-user.html#dx1-150016" >4528</a>, <a -href="glossaries-user.html#dx1-178023" >4529</a>, <a -href="glossaries-user.html#dx1-186002" >4530</a>, <a -href="glossaries-user.html#dx1-224035" >4531</a>, <a -href="glossaries-user.html#dx1-224036" >4532</a>, <a -href="glossaries-user.html#dx1-224037" >4533</a> <br /></span> +class="cmti-10">4528</span></a>, <a +href="glossaries-user.html#dx1-150016" >4529</a>, <a +href="glossaries-user.html#dx1-178023" >4530</a>, <a +href="glossaries-user.html#dx1-186002" >4531</a>, <a +href="glossaries-user.html#dx1-224035" >4532</a>, <a +href="glossaries-user.html#dx1-224036" >4533</a>, <a +href="glossaries-user.html#dx1-224037" >4534</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setentrycounter</span></span></span>  <a -href="glossaries-user.html#dx1-166053" >4534</a>, <a -href="glossaries-user.html#dx1-166056" >4535</a> <br /></span> +href="glossaries-user.html#dx1-166053" >4535</a>, <a +href="glossaries-user.html#dx1-166056" >4536</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setglossarypreamble</span></span></span>  <a -href="glossaries-user.html#dx1-47008" >4536</a>, <a +href="glossaries-user.html#dx1-47008" >4537</a>, <a href="glossaries-user.html#dx1-141075" ><span -class="cmti-10">4537</span></a> <br /></span> +class="cmti-10">4538</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setglossarysection</span></span></span>  <a href="glossaries-user.html#dx1-41002" ><span -class="cmti-10">4538</span></a>, <a -href="glossaries-user.html#dx1-141069" >4539</a> <br /></span> +class="cmti-10">4539</span></a>, <a +href="glossaries-user.html#dx1-141069" >4540</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setglossarystyle</span></span></span>  <a -href="glossaries-user.html#dx1-54003" >4540</a>, <a +href="glossaries-user.html#dx1-54003" >4541</a>, <a href="glossaries-user.html#dx1-155004" ><span -class="cmti-10">4541</span></a>, <a -href="glossaries-user.html#dx1-156033" >4542</a>, <a -href="glossaries-user.html#dx1-156036" >4543</a>, <a -href="glossaries-user.html#dx1-164014" >4544</a>, <a -href="glossaries-user.html#dx1-165006" >4545</a>, <a -href="glossaries-user.html#dx1-166091" >4546</a> <br /></span> +class="cmti-10">4542</span></a>, <a +href="glossaries-user.html#dx1-156033" >4543</a>, <a +href="glossaries-user.html#dx1-156036" >4544</a>, <a +href="glossaries-user.html#dx1-164014" >4545</a>, <a +href="glossaries-user.html#dx1-165006" >4546</a>, <a +href="glossaries-user.html#dx1-166091" >4547</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setStyleFile</span></span></span>  <a -href="glossaries-user.html#dx1-19014" >4547</a>, <a -href="glossaries-user.html#dx1-20008" >4548</a>, <a +href="glossaries-user.html#dx1-19014" >4548</a>, <a +href="glossaries-user.html#dx1-20008" >4549</a>, <a href="glossaries-user.html#dx1-111015" ><span -class="cmti-10">4549</span></a> <br /></span> +class="cmti-10">4550</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\setupglossaries</span></span></span>  <a href="glossaries-user.html#dx1-108001" ><span -class="cmti-10">4550</span></a> <br /></span> +class="cmti-10">4551</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Sigma</span></span></span>  <a -href="glossaries-user.html#dx1-202081" >4551</a> <br /></span> +href="glossaries-user.html#dx1-202081" >4552</a> <br /></span> <span class="index-item"><span class="cmss-10">siunitx </span>package  <a -href="glossaries-user.html#dx1-4006" >4552</a>, <a -href="glossaries-user.html#dx1-222001" >4553</a> <br /></span> +href="glossaries-user.html#dx1-4006" >4553</a>, <a +href="glossaries-user.html#dx1-222001" >4554</a> <br /></span> <span class="index-item">small caps  <a href="glossaries-user.html#dx1-3063" ><span -class="cmbx-10">4554</span></a>, <a -href="glossaries-user.html#dx1-147043" >4555</a>, <a -href="glossaries-user.html#dx1-149009" >4556</a>, <a -href="glossaries-user.html#dx1-149090" >4557</a>, <a -href="glossaries-user.html#dx1-149092" >4558</a>, <a -href="glossaries-user.html#dx1-150059" >4559</a>, <a -href="glossaries-user.html#dx1-165017" >4560</a>, <a -href="glossaries-user.html#dx1-184002" >4561</a>, <a -href="glossaries-user.html#dx1-184061" >4562</a>, <a -href="glossaries-user.html#dx1-204014" >4563</a> <br /></span> +class="cmbx-10">4555</span></a>, <a +href="glossaries-user.html#dx1-147043" >4556</a>, <a +href="glossaries-user.html#dx1-149009" >4557</a>, <a +href="glossaries-user.html#dx1-149090" >4558</a>, <a +href="glossaries-user.html#dx1-149092" >4559</a>, <a +href="glossaries-user.html#dx1-150059" >4560</a>, <a +href="glossaries-user.html#dx1-165017" >4561</a>, <a +href="glossaries-user.html#dx1-184002" >4562</a>, <a +href="glossaries-user.html#dx1-184061" >4563</a>, <a +href="glossaries-user.html#dx1-204014" >4564</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\space</span></span></span>  <a -href="glossaries-user.html#dx1-178007" >4564</a> <br /></span> +href="glossaries-user.html#dx1-178007" >4565</a> <br /></span> +<span class="index-item">standard LaTeX extended Latin character  <a +href="glossaries-user.html#dx1-3067" ><span +class="cmbx-10">4566</span></a>, <a +href="glossaries-user.html#dx1-112160" >4567</a> <br /></span> <span class="index-item"><span class="cmss-10">stix </span>package  <a -href="glossaries-user.html#dx1-144038" >4565</a>, <a -href="glossaries-user.html#dx1-211024" >4566</a> <br /></span> +href="glossaries-user.html#dx1-144038" >4568</a>, <a +href="glossaries-user.html#dx1-211024" >4569</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\subglossentry</span></span></span>  <a href="glossaries-user.html#dx1-166062" ><span -class="cmti-10">4567</span></a> <br /></span> +class="cmti-10">4570</span></a> <br /></span> <span class="index-item"><span class="cmss-10">supertabular </span>package  <a -href="glossaries-user.html#dx1-51002" >4568</a>, <a -href="glossaries-user.html#dx1-161015" >4569</a>, <a -href="glossaries-user.html#dx1-162012" >4570</a> <br /></span> +href="glossaries-user.html#dx1-51002" >4571</a>, <a +href="glossaries-user.html#dx1-161015" >4572</a>, <a +href="glossaries-user.html#dx1-162012" >4573</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\symbolname</span></span></span>  <a -href="glossaries-user.html#dx1-14029" >4571</a> <br /></span> +href="glossaries-user.html#dx1-14029" >4574</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">T</span> <span class="index-item"><span class="cmss-10">tabularx </span>package  <a -href="glossaries-user.html#dx1-133005" >4572</a>, <a -href="glossaries-user.html#dx1-133007" >4573</a>, <a -href="glossaries-user.html#dx1-133009" >4574</a>, <a -href="glossaries-user.html#dx1-153024" >4575</a> <br /></span> +href="glossaries-user.html#dx1-133005" >4575</a>, <a +href="glossaries-user.html#dx1-133007" >4576</a>, <a +href="glossaries-user.html#dx1-133009" >4577</a>, <a +href="glossaries-user.html#dx1-153024" >4578</a> <br /></span> <span class="index-item"><span class="cmss-10">tagpdf </span>package  <a -href="glossaries-user.html#dx1-172058" >4576</a>, <a -href="glossaries-user.html#dx1-172088" >4577</a>, <a -href="glossaries-user.html#dx1-224008" >4578</a> <br /></span> +href="glossaries-user.html#dx1-172058" >4579</a>, <a +href="glossaries-user.html#dx1-172088" >4580</a>, <a +href="glossaries-user.html#dx1-224008" >4581</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\texorpdfstring</span></span></span>  <a -href="glossaries-user.html#dx1-11050" >4579</a>, <a -href="glossaries-user.html#dx1-132014" >4580</a> <br /></span> +href="glossaries-user.html#dx1-11050" >4582</a>, <a +href="glossaries-user.html#dx1-132014" >4583</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\textbf</span></span></span>  <a -href="glossaries-user.html#dx1-132046" >4581</a>, <a -href="glossaries-user.html#dx1-189006" >4582</a> <br /></span> +href="glossaries-user.html#dx1-132046" >4584</a>, <a +href="glossaries-user.html#dx1-189006" >4585</a> <br /></span> <span class="index-item"><span class="cmss-10">textcase </span>package  <a -href="glossaries-user.html#dx1-9" >4583</a>, <a -href="glossaries-user.html#dx1-42008" >4584</a>, <a -href="glossaries-user.html#dx1-42010" >4585</a> <br /></span> +href="glossaries-user.html#dx1-9" >4586</a>, <a +href="glossaries-user.html#dx1-42008" >4587</a>, <a +href="glossaries-user.html#dx1-42010" >4588</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\textrm</span></span></span>  <a -href="glossaries-user.html#dx1-144012" >4586</a> <br /></span> +href="glossaries-user.html#dx1-144012" >4589</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\textsc</span></span></span>  <a -href="glossaries-user.html#dx1-3064" >4587</a>, <a -href="glossaries-user.html#dx1-149008" >4588</a>, <a -href="glossaries-user.html#dx1-149011" >4589</a>, <a -href="glossaries-user.html#dx1-150036" >4590</a>, <a -href="glossaries-user.html#dx1-150042" >4591</a>, <a -href="glossaries-user.html#dx1-150043" >4592</a>, <a -href="glossaries-user.html#dx1-150058" >4593</a> <br /></span> +href="glossaries-user.html#dx1-3064" >4590</a>, <a +href="glossaries-user.html#dx1-149008" >4591</a>, <a +href="glossaries-user.html#dx1-149011" >4592</a>, <a +href="glossaries-user.html#dx1-150036" >4593</a>, <a +href="glossaries-user.html#dx1-150042" >4594</a>, <a +href="glossaries-user.html#dx1-150043" >4595</a>, <a +href="glossaries-user.html#dx1-150058" >4596</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\textsmaller</span></span></span>  <a -href="glossaries-user.html#dx1-3066" >4594</a>, <a -href="glossaries-user.html#dx1-98003" >4595</a>, <a -href="glossaries-user.html#dx1-149013" >4596</a>, <a -href="glossaries-user.html#dx1-149014" >4597</a> <br /></span> +href="glossaries-user.html#dx1-3066" >4597</a>, <a +href="glossaries-user.html#dx1-98003" >4598</a>, <a +href="glossaries-user.html#dx1-149013" >4599</a>, <a +href="glossaries-user.html#dx1-149014" >4600</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\textulc</span></span></span>  <a -href="glossaries-user.html#dx1-150037" >4598</a> <br /></span> +href="glossaries-user.html#dx1-150037" >4601</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\textup</span></span></span>  <a -href="glossaries-user.html#dx1-150038" >4599</a> <br /></span> +href="glossaries-user.html#dx1-150038" >4602</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\the</span></span></span>  <a -href="glossaries-user.html#dx1-129026" >4600</a>, <a -href="glossaries-user.html#dx1-150027" >4601</a> <br /></span> +href="glossaries-user.html#dx1-129026" >4603</a>, <a +href="glossaries-user.html#dx1-150027" >4604</a> <br /></span> <span class="index-item"><span class="cmtt-10">theglossary </span>(environment)  <a href="glossaries-user.html#dx1-166002" ><span -class="cmti-10">4602</span></a> <br /></span> +class="cmti-10">4605</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\theHequation</span></span></span>  <a -href="glossaries-user.html#dx1-188009" >4603</a> <br /></span> +href="glossaries-user.html#dx1-188009" >4606</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\thepage</span></span></span>  <a -href="glossaries-user.html#dx1-144051" >4604</a>, <a -href="glossaries-user.html#dx1-211025" >4605</a> <br /></span> +href="glossaries-user.html#dx1-144051" >4607</a>, <a +href="glossaries-user.html#dx1-211025" >4608</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\toprule</span></span></span>  <a -href="glossaries-user.html#dx1-160012" >4606</a> <br /></span> +href="glossaries-user.html#dx1-160012" >4609</a> <br /></span> <span class="index-item"><span class="cmss-10">tracklang </span>package  <a -href="glossaries-user.html#dx1-5" >4607</a>, <a -href="glossaries-user.html#dx1-15001" >4608</a>, <a -href="glossaries-user.html#dx1-15002" >4609</a> <br /></span> +href="glossaries-user.html#dx1-5" >4610</a>, <a +href="glossaries-user.html#dx1-15001" >4611</a>, <a +href="glossaries-user.html#dx1-15002" >4612</a> <br /></span> <span class="index-item"><span class="cmss-10">translator </span>package  <a -href="glossaries-user.html#dx1-14009" >4610</a>, <a -href="glossaries-user.html#dx1-14013" >4611</a>, <a -href="glossaries-user.html#dx1-14014" >4612</a>, <a -href="glossaries-user.html#dx1-14015" >4613</a>, <a -href="glossaries-user.html#dx1-14020" >4614</a>, <a -href="glossaries-user.html#dx1-14021" >4615</a>, <a -href="glossaries-user.html#dx1-14033" >4616</a>, <a -href="glossaries-user.html#dx1-14035" >4617</a>, <a -href="glossaries-user.html#dx1-14036" >4618</a>, <a -href="glossaries-user.html#dx1-14038" >4619</a>, <a -href="glossaries-user.html#dx1-14044" >4620</a>, <a -href="glossaries-user.html#dx1-14046" >4621</a>, <a -href="glossaries-user.html#dx1-14047" >4622</a>, <a -href="glossaries-user.html#dx1-14050" >4623</a>, <a -href="glossaries-user.html#dx1-15005" >4624</a>, <a -href="glossaries-user.html#dx1-15006" >4625</a>, <a -href="glossaries-user.html#dx1-15007" >4626</a>, <a -href="glossaries-user.html#dx1-15012" >4627</a>, <a -href="glossaries-user.html#dx1-32003" >4628</a>, <a -href="glossaries-user.html#dx1-32004" >4629</a>, <a -href="glossaries-user.html#dx1-32005" >4630</a>, <a -href="glossaries-user.html#dx1-32006" >4631</a>, <a -href="glossaries-user.html#dx1-32018" >4632</a>, <a -href="glossaries-user.html#dx1-32029" >4633</a>, <a -href="glossaries-user.html#dx1-146026" >4634</a> <br /></span> +href="glossaries-user.html#dx1-14009" >4613</a>, <a +href="glossaries-user.html#dx1-14013" >4614</a>, <a +href="glossaries-user.html#dx1-14014" >4615</a>, <a +href="glossaries-user.html#dx1-14015" >4616</a>, <a +href="glossaries-user.html#dx1-14020" >4617</a>, <a +href="glossaries-user.html#dx1-14021" >4618</a>, <a +href="glossaries-user.html#dx1-14033" >4619</a>, <a +href="glossaries-user.html#dx1-14035" >4620</a>, <a +href="glossaries-user.html#dx1-14036" >4621</a>, <a +href="glossaries-user.html#dx1-14038" >4622</a>, <a +href="glossaries-user.html#dx1-14044" >4623</a>, <a +href="glossaries-user.html#dx1-14046" >4624</a>, <a +href="glossaries-user.html#dx1-14047" >4625</a>, <a +href="glossaries-user.html#dx1-14050" >4626</a>, <a +href="glossaries-user.html#dx1-15005" >4627</a>, <a +href="glossaries-user.html#dx1-15006" >4628</a>, <a +href="glossaries-user.html#dx1-15007" >4629</a>, <a +href="glossaries-user.html#dx1-15012" >4630</a>, <a +href="glossaries-user.html#dx1-32003" >4631</a>, <a +href="glossaries-user.html#dx1-32004" >4632</a>, <a +href="glossaries-user.html#dx1-32005" >4633</a>, <a +href="glossaries-user.html#dx1-32006" >4634</a>, <a +href="glossaries-user.html#dx1-32018" >4635</a>, <a +href="glossaries-user.html#dx1-32029" >4636</a>, <a +href="glossaries-user.html#dx1-146026" >4637</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">U</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\usepackage</span></span></span>  <a -href="glossaries-user.html#dx1-193042" >4635</a> <br /></span> +href="glossaries-user.html#dx1-193042" >4638</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">W</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\write18</span></span></span>  <a -href="glossaries-user.html#dx1-31012" >4636</a>, <a -href="glossaries-user.html#dx1-79004" >4637</a> <br /></span> +href="glossaries-user.html#dx1-31012" >4639</a>, <a +href="glossaries-user.html#dx1-79004" >4640</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\writeist</span></span></span>  <a -href="glossaries-user.html#dx1-131001" >4638</a> <br /></span> +href="glossaries-user.html#dx1-131001" >4641</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">X</span> <span class="index-item"><span class="cmss-10">xfor </span>package  <a -href="glossaries-user.html#dx1-10" >4639</a> <br /></span> +href="glossaries-user.html#dx1-10" >4642</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\xGlsXtrSetField</span></span></span>  <a -href="glossaries-user.html#dx1-209011" >4640</a> <br /></span> +href="glossaries-user.html#dx1-209011" >4643</a> <br /></span> <span class="index-item"><span class="cmtt-10">xindy</span>  <a -href="glossaries-user.html#dx1-3005" >4641</a>, <a -href="glossaries-user.html#dx1-3037" >4642</a>, <a -href="glossaries-user.html#dx1-3045" >4643</a>, <a -href="glossaries-user.html#dx1-3050" >4644</a>, <a +href="glossaries-user.html#dx1-3005" >4644</a>, <a +href="glossaries-user.html#dx1-3037" >4645</a>, <a +href="glossaries-user.html#dx1-3045" >4646</a>, <a +href="glossaries-user.html#dx1-3050" >4647</a>, <a href="glossaries-user.html#dx1-3069" ><span -class="cmbx-10">4645</span></a>, <a -href="glossaries-user.html#dx1-4016" >4646</a>, <a -href="glossaries-user.html#dx1-4017" >4647</a>, <a -href="glossaries-user.html#dx1-8005" >4648</a>, <a -href="glossaries-user.html#dx1-8006" >4649</a>, <a -href="glossaries-user.html#dx1-8007" >4650</a>, <a -href="glossaries-user.html#dx1-8008" >4651</a>, <a -href="glossaries-user.html#dx1-8009" >4652</a>, <a -href="glossaries-user.html#dx1-8010" >4653</a>, <a -href="glossaries-user.html#dx1-8011" >4654</a>, <a -href="glossaries-user.html#dx1-8012" >4655</a>, <a -href="glossaries-user.html#dx1-8013" >4656</a>, <a -href="glossaries-user.html#dx1-8031" >4657</a>, <a -href="glossaries-user.html#dx1-8035" >4658</a>, <a -href="glossaries-user.html#dx1-8036" >4659</a>, <a -href="glossaries-user.html#dx1-8039" >4660</a>, <a -href="glossaries-user.html#dx1-8041" >4661</a>, <a -href="glossaries-user.html#dx1-8042" >4662</a>, <a -href="glossaries-user.html#dx1-8043" >4663</a>, <a -href="glossaries-user.html#dx1-8046" >4664</a>, <a -href="glossaries-user.html#dx1-8047" >4665</a>, <a -href="glossaries-user.html#dx1-8051" >4666</a>, <a -href="glossaries-user.html#dx1-8052" >4667</a>, <a -href="glossaries-user.html#dx1-8053" >4668</a>, <a -href="glossaries-user.html#dx1-9035" >4669</a>, <a -href="glossaries-user.html#dx1-13001" >4670</a>, <a -href="glossaries-user.html#dx1-13003" >4671</a>, <a -href="glossaries-user.html#dx1-13007" >4672</a>, <a -href="glossaries-user.html#dx1-13019" >4673</a>, <a -href="glossaries-user.html#dx1-13025" >4674</a>, <a -href="glossaries-user.html#dx1-13028" >4675</a>, <a -href="glossaries-user.html#dx1-13044" >4676</a>, <a -href="glossaries-user.html#dx1-14052" >4677</a>, <a -href="glossaries-user.html#dx1-14056" >4678</a>, <a -href="glossaries-user.html#dx1-16009" >4679</a>, <a -href="glossaries-user.html#dx1-16013" >4680</a>, <a -href="glossaries-user.html#dx1-16016" >4681</a>, <a -href="glossaries-user.html#dx1-16018" >4682</a>, <a -href="glossaries-user.html#dx1-16025" >4683</a>, <a -href="glossaries-user.html#dx1-16027" >4684</a>, <a -href="glossaries-user.html#dx1-16030" >4685</a>, <a -href="glossaries-user.html#dx1-16033" >4686</a>, <a -href="glossaries-user.html#dx1-16036" >4687</a>, <a -href="glossaries-user.html#dx1-16039" >4688</a>, <a -href="glossaries-user.html#dx1-16041" >4689</a>, <a -href="glossaries-user.html#dx1-16048" >4690</a>, <a -href="glossaries-user.html#dx1-16061" >4691</a>, <a -href="glossaries-user.html#dx1-16064" >4692</a>, <a -href="glossaries-user.html#dx1-16067" >4693</a>, <a -href="glossaries-user.html#dx1-16072" >4694</a>, <a -href="glossaries-user.html#dx1-16079" >4695</a>, <a -href="glossaries-user.html#dx1-16084" >4696</a>, <a -href="glossaries-user.html#dx1-16087" >4697</a>, <a -href="glossaries-user.html#dx1-17003" >4698</a>, <a -href="glossaries-user.html#dx1-17011" >4699</a>, <a -href="glossaries-user.html#dx1-17022" >4700</a>, <a -href="glossaries-user.html#dx1-17026" >4701</a>, <a -href="glossaries-user.html#dx1-17032" >4702</a>, <a -href="glossaries-user.html#dx1-17033" >4703</a>, <a -href="glossaries-user.html#x1-190001.4.3" >4704</a>, <a -href="glossaries-user.html#dx1-19001" >4705</a>, <a -href="glossaries-user.html#dx1-19002" >4706</a>, <a -href="glossaries-user.html#dx1-19004" >4707</a>, <a -href="glossaries-user.html#dx1-19006" >4708</a>, <a -href="glossaries-user.html#dx1-19009" >4709</a>, <a -href="glossaries-user.html#dx1-19011" >4710</a>, <a -href="glossaries-user.html#dx1-19022" >4711</a>, <a -href="glossaries-user.html#dx1-19024" >4712</a>, <a -href="glossaries-user.html#dx1-21001" >4713</a>, <a -href="glossaries-user.html#dx1-22003" >4714</a>, <a -href="glossaries-user.html#dx1-22008" >4715</a>, <a -href="glossaries-user.html#dx1-22013" >4716</a>, <a -href="glossaries-user.html#dx1-22015" >4717</a>, <a -href="glossaries-user.html#dx1-22018" >4718</a>, <a -href="glossaries-user.html#dx1-31014" >4719</a>, <a -href="glossaries-user.html#dx1-31017" >4720</a>, <a -href="glossaries-user.html#dx1-46008" >4721</a>, <a -href="glossaries-user.html#dx1-55003" >4722</a>, <a -href="glossaries-user.html#dx1-55006" >4723</a>, <a -href="glossaries-user.html#dx1-63006" >4724</a>, <a -href="glossaries-user.html#dx1-63008" >4725</a>, <a -href="glossaries-user.html#dx1-67009" >4726</a>, <a -href="glossaries-user.html#dx1-73028" >4727</a>, <a -href="glossaries-user.html#dx1-75006" >4728</a>, <a -href="glossaries-user.html#dx1-76001" >4729</a>, <a -href="glossaries-user.html#dx1-76003" >4730</a>, <a -href="glossaries-user.html#dx1-76005" >4731</a>, <a -href="glossaries-user.html#dx1-76008" >4732</a>, <a -href="glossaries-user.html#dx1-79003" >4733</a>, <a -href="glossaries-user.html#dx1-79007" >4734</a>, <a -href="glossaries-user.html#dx1-79013" >4735</a>, <a -href="glossaries-user.html#dx1-79016" >4736</a>, <a -href="glossaries-user.html#dx1-79017" >4737</a>, <a -href="glossaries-user.html#dx1-79018" >4738</a>, <a -href="glossaries-user.html#dx1-111004" >4739</a>, <a -href="glossaries-user.html#dx1-111006" >4740</a>, <a -href="glossaries-user.html#dx1-112093" >4741</a>, <a -href="glossaries-user.html#dx1-112095" >4742</a>, <a -href="glossaries-user.html#dx1-112158" >4743</a>, <a -href="glossaries-user.html#dx1-127007" >4744</a>, <a -href="glossaries-user.html#dx1-128012" >4745</a>, <a -href="glossaries-user.html#dx1-128013" >4746</a>, <a -href="glossaries-user.html#dx1-129004" >4747</a>, <a -href="glossaries-user.html#dx1-129007" >4748</a>, <a -href="glossaries-user.html#dx1-129013" >4749</a>, <a -href="glossaries-user.html#dx1-129014" >4750</a>, <a -href="glossaries-user.html#dx1-129020" >4751</a>, <a -href="glossaries-user.html#dx1-129021" >4752</a>, <a -href="glossaries-user.html#dx1-129024" >4753</a>, <a -href="glossaries-user.html#dx1-130002" >4754</a>, <a -href="glossaries-user.html#dx1-130003" >4755</a>, <a -href="glossaries-user.html#dx1-130008" >4756</a>, <a -href="glossaries-user.html#dx1-130011" >4757</a>, <a -href="glossaries-user.html#dx1-131007" >4758</a>, <a -href="glossaries-user.html#dx1-132006" >4759</a>, <a -href="glossaries-user.html#dx1-132048" >4760</a>, <a -href="glossaries-user.html#dx1-132052" >4761</a>, <a -href="glossaries-user.html#dx1-132056" >4762</a>, <a -href="glossaries-user.html#dx1-132075" >4763</a>, <a -href="glossaries-user.html#dx1-140064" >4764</a>, <a -href="glossaries-user.html#dx1-141008" >4765</a>, <a -href="glossaries-user.html#dx1-141012" >4766</a>, <a -href="glossaries-user.html#dx1-141043" >4767</a>, <a -href="glossaries-user.html#dx1-142001" >4768</a>, <a -href="glossaries-user.html#dx1-142003" >4769</a>, <a -href="glossaries-user.html#dx1-142004" >4770</a>, <a -href="glossaries-user.html#dx1-142006" >4771</a>, <a -href="glossaries-user.html#dx1-142011" >4772</a>, <a -href="glossaries-user.html#dx1-142015" >4773</a>, <a -href="glossaries-user.html#dx1-142016" >4774</a>, <a -href="glossaries-user.html#dx1-142018" >4775</a>, <a -href="glossaries-user.html#dx1-142019" >4776</a>, <a -href="glossaries-user.html#dx1-142020" >4777</a>, <a -href="glossaries-user.html#dx1-142021" >4778</a>, <a -href="glossaries-user.html#dx1-143001" >4779</a>, <a -href="glossaries-user.html#dx1-143002" >4780</a>, <a -href="glossaries-user.html#dx1-143006" >4781</a>, <a -href="glossaries-user.html#dx1-143011" >4782</a>, <a -href="glossaries-user.html#dx1-143014" >4783</a>, <a -href="glossaries-user.html#dx1-144003" >4784</a>, <a -href="glossaries-user.html#dx1-144014" >4785</a>, <a -href="glossaries-user.html#dx1-144021" >4786</a>, <a -href="glossaries-user.html#dx1-144028" >4787</a>, <a -href="glossaries-user.html#dx1-144040" >4788</a>, <a -href="glossaries-user.html#dx1-144047" >4789</a>, <a -href="glossaries-user.html#dx1-144067" >4790</a>, <a -href="glossaries-user.html#dx1-145002" >4791</a>, <a -href="glossaries-user.html#dx1-145003" >4792</a>, <a -href="glossaries-user.html#dx1-146004" >4793</a>, <a -href="glossaries-user.html#dx1-163032" >4794</a>, <a -href="glossaries-user.html#dx1-166025" >4795</a>, <a -href="glossaries-user.html#dx1-166029" >4796</a>, <a -href="glossaries-user.html#dx1-175016" >4797</a>, <a -href="glossaries-user.html#dx1-175042" >4798</a>, <a -href="glossaries-user.html#dx1-176026" >4799</a>, <a -href="glossaries-user.html#dx1-176031" >4800</a>, <a -href="glossaries-user.html#dx1-188008" >4801</a>, <a -href="glossaries-user.html#dx1-190015" >4802</a>, <a -href="glossaries-user.html#dx1-192011" >4803</a>, <a -href="glossaries-user.html#dx1-200077" >4804</a>, <a -href="glossaries-user.html#dx1-210002" >4805</a>, <a -href="glossaries-user.html#dx1-210006" >4806</a>, <a -href="glossaries-user.html#dx1-211002" >4807</a>, <a -href="glossaries-user.html#dx1-211005" >4808</a>, <a -href="glossaries-user.html#dx1-211011" >4809</a>, <a -href="glossaries-user.html#dx1-211012" >4810</a>, <a -href="glossaries-user.html#dx1-211019" >4811</a>, <a -href="glossaries-user.html#dx1-211027" >4812</a>, <a -href="glossaries-user.html#dx1-211030" >4813</a>, <a -href="glossaries-user.html#dx1-211038" >4814</a>, <a -href="glossaries-user.html#dx1-211065" >4815</a>, <a -href="glossaries-user.html#dx1-212001" >4816</a>, <a -href="glossaries-user.html#dx1-212002" >4817</a>, <a -href="glossaries-user.html#dx1-212003" >4818</a>, <a -href="glossaries-user.html#dx1-214001" >4819</a>, <a -href="glossaries-user.html#dx1-214003" >4820</a>, <a -href="glossaries-user.html#dx1-214005" >4821</a>, <a -href="glossaries-user.html#dx1-214031" >4822</a>, <a -href="glossaries-user.html#dx1-220008" >4823</a>, <a -href="glossaries-user.html#dx1-220036" >4824</a>, <a -href="glossaries-user.html#dx1-9037" >4825</a> <br /></span> +class="cmbx-10">4648</span></a>, <a +href="glossaries-user.html#dx1-4016" >4649</a>, <a +href="glossaries-user.html#dx1-4017" >4650</a>, <a +href="glossaries-user.html#dx1-8005" >4651</a>, <a +href="glossaries-user.html#dx1-8006" >4652</a>, <a +href="glossaries-user.html#dx1-8007" >4653</a>, <a +href="glossaries-user.html#dx1-8008" >4654</a>, <a +href="glossaries-user.html#dx1-8009" >4655</a>, <a +href="glossaries-user.html#dx1-8010" >4656</a>, <a +href="glossaries-user.html#dx1-8011" >4657</a>, <a +href="glossaries-user.html#dx1-8012" >4658</a>, <a +href="glossaries-user.html#dx1-8013" >4659</a>, <a +href="glossaries-user.html#dx1-8031" >4660</a>, <a +href="glossaries-user.html#dx1-8035" >4661</a>, <a +href="glossaries-user.html#dx1-8036" >4662</a>, <a +href="glossaries-user.html#dx1-8039" >4663</a>, <a +href="glossaries-user.html#dx1-8041" >4664</a>, <a +href="glossaries-user.html#dx1-8042" >4665</a>, <a +href="glossaries-user.html#dx1-8043" >4666</a>, <a +href="glossaries-user.html#dx1-8046" >4667</a>, <a +href="glossaries-user.html#dx1-8047" >4668</a>, <a +href="glossaries-user.html#dx1-8051" >4669</a>, <a +href="glossaries-user.html#dx1-8052" >4670</a>, <a +href="glossaries-user.html#dx1-8053" >4671</a>, <a +href="glossaries-user.html#dx1-9035" >4672</a>, <a +href="glossaries-user.html#dx1-13001" >4673</a>, <a +href="glossaries-user.html#dx1-13003" >4674</a>, <a +href="glossaries-user.html#dx1-13007" >4675</a>, <a +href="glossaries-user.html#dx1-13019" >4676</a>, <a +href="glossaries-user.html#dx1-13025" >4677</a>, <a +href="glossaries-user.html#dx1-13028" >4678</a>, <a +href="glossaries-user.html#dx1-13044" >4679</a>, <a +href="glossaries-user.html#dx1-14052" >4680</a>, <a +href="glossaries-user.html#dx1-14056" >4681</a>, <a +href="glossaries-user.html#dx1-16009" >4682</a>, <a +href="glossaries-user.html#dx1-16013" >4683</a>, <a +href="glossaries-user.html#dx1-16016" >4684</a>, <a +href="glossaries-user.html#dx1-16018" >4685</a>, <a +href="glossaries-user.html#dx1-16025" >4686</a>, <a +href="glossaries-user.html#dx1-16027" >4687</a>, <a +href="glossaries-user.html#dx1-16030" >4688</a>, <a +href="glossaries-user.html#dx1-16033" >4689</a>, <a +href="glossaries-user.html#dx1-16036" >4690</a>, <a +href="glossaries-user.html#dx1-16039" >4691</a>, <a +href="glossaries-user.html#dx1-16041" >4692</a>, <a +href="glossaries-user.html#dx1-16048" >4693</a>, <a +href="glossaries-user.html#dx1-16061" >4694</a>, <a +href="glossaries-user.html#dx1-16064" >4695</a>, <a +href="glossaries-user.html#dx1-16067" >4696</a>, <a +href="glossaries-user.html#dx1-16072" >4697</a>, <a +href="glossaries-user.html#dx1-16079" >4698</a>, <a +href="glossaries-user.html#dx1-16084" >4699</a>, <a +href="glossaries-user.html#dx1-16087" >4700</a>, <a +href="glossaries-user.html#dx1-17003" >4701</a>, <a +href="glossaries-user.html#dx1-17011" >4702</a>, <a +href="glossaries-user.html#dx1-17022" >4703</a>, <a +href="glossaries-user.html#dx1-17026" >4704</a>, <a +href="glossaries-user.html#dx1-17032" >4705</a>, <a +href="glossaries-user.html#dx1-17033" >4706</a>, <a +href="glossaries-user.html#x1-190001.4.3" >4707</a>, <a +href="glossaries-user.html#dx1-19001" >4708</a>, <a +href="glossaries-user.html#dx1-19002" >4709</a>, <a +href="glossaries-user.html#dx1-19004" >4710</a>, <a +href="glossaries-user.html#dx1-19006" >4711</a>, <a +href="glossaries-user.html#dx1-19009" >4712</a>, <a +href="glossaries-user.html#dx1-19011" >4713</a>, <a +href="glossaries-user.html#dx1-19022" >4714</a>, <a +href="glossaries-user.html#dx1-19024" >4715</a>, <a +href="glossaries-user.html#dx1-21001" >4716</a>, <a +href="glossaries-user.html#dx1-22003" >4717</a>, <a +href="glossaries-user.html#dx1-22008" >4718</a>, <a +href="glossaries-user.html#dx1-22013" >4719</a>, <a +href="glossaries-user.html#dx1-22015" >4720</a>, <a +href="glossaries-user.html#dx1-22018" >4721</a>, <a +href="glossaries-user.html#dx1-31014" >4722</a>, <a +href="glossaries-user.html#dx1-31017" >4723</a>, <a +href="glossaries-user.html#dx1-46008" >4724</a>, <a +href="glossaries-user.html#dx1-55003" >4725</a>, <a +href="glossaries-user.html#dx1-55006" >4726</a>, <a +href="glossaries-user.html#dx1-63006" >4727</a>, <a +href="glossaries-user.html#dx1-63008" >4728</a>, <a +href="glossaries-user.html#dx1-67009" >4729</a>, <a +href="glossaries-user.html#dx1-73028" >4730</a>, <a +href="glossaries-user.html#dx1-75006" >4731</a>, <a +href="glossaries-user.html#dx1-76001" >4732</a>, <a +href="glossaries-user.html#dx1-76003" >4733</a>, <a +href="glossaries-user.html#dx1-76005" >4734</a>, <a +href="glossaries-user.html#dx1-76008" >4735</a>, <a +href="glossaries-user.html#dx1-79003" >4736</a>, <a +href="glossaries-user.html#dx1-79007" >4737</a>, <a +href="glossaries-user.html#dx1-79013" >4738</a>, <a +href="glossaries-user.html#dx1-79016" >4739</a>, <a +href="glossaries-user.html#dx1-79017" >4740</a>, <a +href="glossaries-user.html#dx1-79018" >4741</a>, <a +href="glossaries-user.html#dx1-111004" >4742</a>, <a +href="glossaries-user.html#dx1-111006" >4743</a>, <a +href="glossaries-user.html#dx1-112093" >4744</a>, <a +href="glossaries-user.html#dx1-112095" >4745</a>, <a +href="glossaries-user.html#dx1-112158" >4746</a>, <a +href="glossaries-user.html#dx1-127007" >4747</a>, <a +href="glossaries-user.html#dx1-128012" >4748</a>, <a +href="glossaries-user.html#dx1-128013" >4749</a>, <a +href="glossaries-user.html#dx1-129004" >4750</a>, <a +href="glossaries-user.html#dx1-129007" >4751</a>, <a +href="glossaries-user.html#dx1-129013" >4752</a>, <a +href="glossaries-user.html#dx1-129014" >4753</a>, <a +href="glossaries-user.html#dx1-129020" >4754</a>, <a +href="glossaries-user.html#dx1-129021" >4755</a>, <a +href="glossaries-user.html#dx1-129024" >4756</a>, <a +href="glossaries-user.html#dx1-130002" >4757</a>, <a +href="glossaries-user.html#dx1-130003" >4758</a>, <a +href="glossaries-user.html#dx1-130008" >4759</a>, <a +href="glossaries-user.html#dx1-130011" >4760</a>, <a +href="glossaries-user.html#dx1-131007" >4761</a>, <a +href="glossaries-user.html#dx1-132006" >4762</a>, <a +href="glossaries-user.html#dx1-132048" >4763</a>, <a +href="glossaries-user.html#dx1-132052" >4764</a>, <a +href="glossaries-user.html#dx1-132056" >4765</a>, <a +href="glossaries-user.html#dx1-132075" >4766</a>, <a +href="glossaries-user.html#dx1-140064" >4767</a>, <a +href="glossaries-user.html#dx1-141008" >4768</a>, <a +href="glossaries-user.html#dx1-141012" >4769</a>, <a +href="glossaries-user.html#dx1-141043" >4770</a>, <a +href="glossaries-user.html#dx1-142001" >4771</a>, <a +href="glossaries-user.html#dx1-142003" >4772</a>, <a +href="glossaries-user.html#dx1-142004" >4773</a>, <a +href="glossaries-user.html#dx1-142006" >4774</a>, <a +href="glossaries-user.html#dx1-142011" >4775</a>, <a +href="glossaries-user.html#dx1-142015" >4776</a>, <a +href="glossaries-user.html#dx1-142016" >4777</a>, <a +href="glossaries-user.html#dx1-142018" >4778</a>, <a +href="glossaries-user.html#dx1-142019" >4779</a>, <a +href="glossaries-user.html#dx1-142020" >4780</a>, <a +href="glossaries-user.html#dx1-142021" >4781</a>, <a +href="glossaries-user.html#dx1-143001" >4782</a>, <a +href="glossaries-user.html#dx1-143002" >4783</a>, <a +href="glossaries-user.html#dx1-143006" >4784</a>, <a +href="glossaries-user.html#dx1-143011" >4785</a>, <a +href="glossaries-user.html#dx1-143014" >4786</a>, <a +href="glossaries-user.html#dx1-144003" >4787</a>, <a +href="glossaries-user.html#dx1-144014" >4788</a>, <a +href="glossaries-user.html#dx1-144021" >4789</a>, <a +href="glossaries-user.html#dx1-144028" >4790</a>, <a +href="glossaries-user.html#dx1-144040" >4791</a>, <a +href="glossaries-user.html#dx1-144047" >4792</a>, <a +href="glossaries-user.html#dx1-144067" >4793</a>, <a +href="glossaries-user.html#dx1-145002" >4794</a>, <a +href="glossaries-user.html#dx1-145003" >4795</a>, <a +href="glossaries-user.html#dx1-146004" >4796</a>, <a +href="glossaries-user.html#dx1-163032" >4797</a>, <a +href="glossaries-user.html#dx1-166025" >4798</a>, <a +href="glossaries-user.html#dx1-166029" >4799</a>, <a +href="glossaries-user.html#dx1-175016" >4800</a>, <a +href="glossaries-user.html#dx1-175042" >4801</a>, <a +href="glossaries-user.html#dx1-176026" >4802</a>, <a +href="glossaries-user.html#dx1-176031" >4803</a>, <a +href="glossaries-user.html#dx1-188008" >4804</a>, <a +href="glossaries-user.html#dx1-190015" >4805</a>, <a +href="glossaries-user.html#dx1-192011" >4806</a>, <a +href="glossaries-user.html#dx1-200077" >4807</a>, <a +href="glossaries-user.html#dx1-210002" >4808</a>, <a +href="glossaries-user.html#dx1-210006" >4809</a>, <a +href="glossaries-user.html#dx1-211002" >4810</a>, <a +href="glossaries-user.html#dx1-211005" >4811</a>, <a +href="glossaries-user.html#dx1-211011" >4812</a>, <a +href="glossaries-user.html#dx1-211012" >4813</a>, <a +href="glossaries-user.html#dx1-211019" >4814</a>, <a +href="glossaries-user.html#dx1-211027" >4815</a>, <a +href="glossaries-user.html#dx1-211030" >4816</a>, <a +href="glossaries-user.html#dx1-211038" >4817</a>, <a +href="glossaries-user.html#dx1-211065" >4818</a>, <a +href="glossaries-user.html#dx1-212001" >4819</a>, <a +href="glossaries-user.html#dx1-212002" >4820</a>, <a +href="glossaries-user.html#dx1-212003" >4821</a>, <a +href="glossaries-user.html#dx1-214001" >4822</a>, <a +href="glossaries-user.html#dx1-214003" >4823</a>, <a +href="glossaries-user.html#dx1-214005" >4824</a>, <a +href="glossaries-user.html#dx1-214031" >4825</a>, <a +href="glossaries-user.html#dx1-220008" >4826</a>, <a +href="glossaries-user.html#dx1-220036" >4827</a>, <a +href="glossaries-user.html#dx1-9037" >4828</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-C</span>  <a -href="glossaries-user.html#dx1-8033" >4826</a>, <a -href="glossaries-user.html#dx1-13027" >4827</a>, <a -href="glossaries-user.html#dx1-16094" >4828</a>, <a -href="glossaries-user.html#dx1-16098" >4829</a>, <a -href="glossaries-user.html#dx1-143017" >4830</a> <br /></span> +href="glossaries-user.html#dx1-8033" >4829</a>, <a +href="glossaries-user.html#dx1-13027" >4830</a>, <a +href="glossaries-user.html#dx1-16094" >4831</a>, <a +href="glossaries-user.html#dx1-16098" >4832</a>, <a +href="glossaries-user.html#dx1-143017" >4833</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-I</span>  <a -href="glossaries-user.html#dx1-19007" >4831</a>, <a -href="glossaries-user.html#dx1-19008" >4832</a> <br /></span> +href="glossaries-user.html#dx1-19007" >4834</a>, <a +href="glossaries-user.html#dx1-19008" >4835</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-L</span>  <a -href="glossaries-user.html#dx1-8032" >4833</a>, <a -href="glossaries-user.html#dx1-16093" >4834</a>, <a -href="glossaries-user.html#dx1-16096" >4835</a>, <a -href="glossaries-user.html#dx1-143016" >4836</a> <br /></span> +href="glossaries-user.html#dx1-8032" >4836</a>, <a +href="glossaries-user.html#dx1-16093" >4837</a>, <a +href="glossaries-user.html#dx1-16096" >4838</a>, <a +href="glossaries-user.html#dx1-143016" >4839</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-M</span>  <a -href="glossaries-user.html#dx1-16090" >4837</a> <br /></span> +href="glossaries-user.html#dx1-16090" >4840</a> <br /></span> <span class="index-item">xindy attributes  <a -href="glossaries-user.html#dx1-16049" >4838</a>, <a -href="glossaries-user.html#dx1-132076" >4839</a>, <a -href="glossaries-user.html#dx1-144010" >4840</a>, <a -href="glossaries-user.html#dx1-144017" >4841</a>, <a -href="glossaries-user.html#dx1-144022" >4842</a> <br /></span> +href="glossaries-user.html#dx1-16049" >4841</a>, <a +href="glossaries-user.html#dx1-132076" >4842</a>, <a +href="glossaries-user.html#dx1-144010" >4843</a>, <a +href="glossaries-user.html#dx1-144017" >4844</a>, <a +href="glossaries-user.html#dx1-144022" >4845</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">:locref</span>  <a -href="glossaries-user.html#dx1-129022" >4843</a> <br /></span> +href="glossaries-user.html#dx1-129022" >4846</a> <br /></span> <span class="index-item"><span class="cmss-10">xkeyval </span>package  <a -href="glossaries-user.html#dx1-8" >4844</a>, <a -href="glossaries-user.html#dx1-136030" >4845</a>, <a -href="glossaries-user.html#dx1-223002" >4846</a> <br /></span> +href="glossaries-user.html#dx1-8" >4847</a>, <a +href="glossaries-user.html#dx1-136030" >4848</a>, <a +href="glossaries-user.html#dx1-223002" >4849</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\xspace</span></span></span>  <a -href="glossaries-user.html#dx1-152018" >4847</a> <br /></span> +href="glossaries-user.html#dx1-152018" >4850</a> <br /></span> <span class="index-item"><span class="cmss-10">xspace </span>package  <a -href="glossaries-user.html#dx1-152014" >4848</a>, <a -href="glossaries-user.html#dx1-152015" >4849</a>, <a -href="glossaries-user.html#dx1-152017" >4850</a>, <a -href="glossaries-user.html#dx1-152019" >4851</a>, <a -href="glossaries-user.html#dx1-152021" >4852</a>, <a -href="glossaries-user.html#dx1-152023" >4853</a>, <a -href="glossaries-user.html#dx1-152024" >4854</a> <br /></span> +href="glossaries-user.html#dx1-152014" >4851</a>, <a +href="glossaries-user.html#dx1-152015" >4852</a>, <a +href="glossaries-user.html#dx1-152017" >4853</a>, <a +href="glossaries-user.html#dx1-152019" >4854</a>, <a +href="glossaries-user.html#dx1-152021" >4855</a>, <a +href="glossaries-user.html#dx1-152023" >4856</a>, <a +href="glossaries-user.html#dx1-152024" >4857</a> <br /></span> </p></div> @@ -47972,11 +47826,7 @@ class="cmr-8">is no longer fragile and doesn’t need protecting.</span></p> href="#fn8x1-bk" id="fn8x1"><sup class="textsuperscript">1.8</sup></a></span><span class="cmr-8">The batch file </span><span class="cmtt-8">makeglossaries.bat </span><span -class="cmr-8">has been removed since the </span><span class="TEX"><span -class="cmr-8">T</span><span -class="E"><span -class="cmr-8">E</span></span><span -class="cmr-8">X</span></span><span +class="cmr-8">has been removed since the TeX</span><span class="cmr-8"> distributions for Windows provide</span> <span class="cmtt-8">makeglossaries.exe</span><span @@ -48201,7 +48051,7 @@ class="cmr-8"> with the </span><span class="cmss-8">flowfram</span><a id="dx1-161011"></a> <span class="cmr-8">package.</span></p> -<!--l. 13798--><p class="indent" > <span class="footnote-mark"><a +<!--l. 13811--><p class="indent" > <span class="footnote-mark"><a href="#fn1x17-bk" id="fn1x17"><sup class="textsuperscript">17.1</sup></a></span><span class="cmr-8">Single letter words, such as “a” and “I” should typically not appear at the end of a line, hence the non-breakable space after</span> <span @@ -48209,16 +48059,16 @@ class="cmr-8">“a” in the </span><span class="cmtt-8">prefix</span><a id="dx1-171016"></a> <span class="cmr-8">field.</span></p> -<!--l. 13969--><p class="indent" > <span class="footnote-mark"><a +<!--l. 13982--><p class="indent" > <span class="footnote-mark"><a href="#fn2x17-bk" id="fn2x17"><sup class="textsuperscript">17.2</sup></a></span><span class="cmr-8">The earlier caveats about initial non-Latin characters apply.</span></p> -<!--l. 15805--><p class="indent" > <span class="footnote-mark"><a +<!--l. 15818--><p class="indent" > <span class="footnote-mark"><a href="#fn1x19-bk" id="fn1x19"><sup class="textsuperscript">19.1</sup></a></span><a href="#glo:makeindex"><span class="cmtt-8">makeindex</span><a id="dx1-190003"></a></a> <span class="cmr-8">assumes that the location is a page number</span></p> -<!--l. 15984--><p class="indent" > <span class="footnote-mark"><a +<!--l. 15997--><p class="indent" > <span class="footnote-mark"><a href="#fn2x19-bk" id="fn2x19"><sup class="textsuperscript">19.2</sup></a></span><span class="cmr-8">If you use </span><span class="cmss-8">babel</span><a @@ -48226,14 +48076,14 @@ class="cmss-8">babel</span><a class="cmr-8">with a language that makes the colon character </span><span class="cmtt-8">: </span><span class="cmr-8">active you will need to change the prefix.</span></p> -<!--l. 16049--><p class="indent" > <span class="footnote-mark"><a +<!--l. 16062--><p class="indent" > <span class="footnote-mark"><a href="#fn3x19-bk" id="fn3x19"><sup class="textsuperscript">19.3</sup></a></span><span class="cmr-8">Requires at least </span><a href="#glo:bib2gls"><span class="cmtt-8">bib2gls</span><a id="dx1-192042"></a></a> <span class="cmr-8">v2.0.</span></p> -<!--l. 18913--><p class="indent" > <span class="footnote-mark"><a +<!--l. 18926--><p class="indent" > <span class="footnote-mark"><a href="#fn4x19-bk" id="fn4x19"><sup class="textsuperscript">19.4</sup></a></span><span class="cmr-8">You can either uncompress the PDF file and view it in a text editor or you can use a tool such as the PDFDebugger</span> <span diff --git a/macros/latex/contrib/glossaries/glossaries-user.pdf b/macros/latex/contrib/glossaries/glossaries-user.pdf Binary files differindex 91dcdb20a8..2cbcfbdcc2 100644 --- a/macros/latex/contrib/glossaries/glossaries-user.pdf +++ b/macros/latex/contrib/glossaries/glossaries-user.pdf diff --git a/macros/latex/contrib/glossaries/glossaries-user.tex b/macros/latex/contrib/glossaries/glossaries-user.tex index a8465c911f..f4dc52e08e 100644 --- a/macros/latex/contrib/glossaries/glossaries-user.tex +++ b/macros/latex/contrib/glossaries/glossaries-user.tex @@ -671,11 +671,11 @@ and~\hyperlink{option#2}{#2}} \MakeShortVerb{"} \DeleteShortVerb{\|} - \title{User Manual for glossaries.sty v4.45} + \title{User Manual for glossaries.sty v4.46} \author{Nicola L.C. Talbot\\% \href{http://www.dickimaw-books.com/contact}{\nolinkurl{dickimaw-books.com/contact}}} - \date{2020-02-13} + \date{2020-03-19} \maketitle \begin{abstract} @@ -769,7 +769,7 @@ package. \item[\url{glossaries-code.pdf}] Advanced users wishing to know more about the inner workings of all the packages provided in the \styfmt{glossaries} bundle should read -\qt{Documented Code for glossaries v4.45}. +\qt{Documented Code for glossaries v4.46}. \item[INSTALL] Installation instructions. @@ -13404,6 +13404,19 @@ part}} \end{definition} This checks if the glossary given by \meta{label} exists. If it does \meta{true part} is performed, otherwise \meta{false part}. +The unstarred form will do \meta{false part} for ignored glossaries. +As from v4.46, there is now a starred form of this command which +will also consider ignored glossaries as existing. For example, +given: +\begin{alltt} +\ics{newignoredglossary}\mgroup{common} +\end{alltt} +then +\begin{verbatim} +\ifglossaryexists{common}{true}{false} +\ifglossaryexists*{common}{true}{false} +\end{verbatim} +will produce \qt{false true}. \begin{definition}[\DescribeMacro{\ifglsentryexists}] \cs{ifglsentryexists}{\meta{label}}{\meta{true part}}{\meta{false diff --git a/macros/latex/contrib/glossaries/glossaries.dtx b/macros/latex/contrib/glossaries/glossaries.dtx index bd6811d320..b0d0914db2 100644 --- a/macros/latex/contrib/glossaries/glossaries.dtx +++ b/macros/latex/contrib/glossaries/glossaries.dtx @@ -1,12 +1,15 @@ %\iffalse % glossaries.dtx generated using makedtx version 1.2 (c) Nicola Talbot % Command line args: +% -setambles ".*\.perl=>\nopreamble\nopostamble" +% -setambles ".*\.tex=>\nopreamble\nopostamble" % -section "chapter" -% -macrocode ".*\.perl" -% -macrocode ".*\.tex" % -doc "glossaries-manual.tex" % -codetitle "Main Package Code" -% -author "Nicola Talbot" +% -comment ".*\.perl" +% -comment ".*\.tex" +% -macrocode ".*\.perl" +% -macrocode ".*\.tex" % -src "glossaries\.sty\Z=>glossaries.sty" % -src "glossaries-prefix.sty\Z=>glossaries-prefix.sty" % -src "(glossary-.+)\.(sty)\Z=>\1.\2" @@ -17,12 +20,9 @@ % -src "(glossaries-polyglossia)\.(sty)\Z=>\1.\2" % -src "(example-glossaries-.*\.tex)\Z=>\1" % -src "(.*\.perl)\Z=>\1" -% -comment ".*\.perl" -% -comment ".*\.tex" -% -setambles ".*\.perl=>\nopreamble\nopostamble" -% -setambles ".*\.tex=>\nopreamble\nopostamble" +% -author "Nicola Talbot" % glossaries -% Created on 2020/2/14 0:32 +% Created on 2020/3/19 17:03 %\fi %\iffalse %<*package> @@ -136,7 +136,7 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of \setcounter{IndexColumns}{2} -\CheckSum{20333} +\CheckSum{20358} \newcommand*{\ifirstuse}{\iterm{first use}} \newcommand*{\firstuse}{\gls{firstuse}} @@ -163,12 +163,12 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of %\fi %\MakeShortVerb{"} % -% \title{Documented Code For glossaries v4.45} +% \title{Documented Code For glossaries v4.46} % \author{Nicola L.C. Talbot\\[10pt] %Dickimaw Books\\ %\url{http://www.dickimaw-books.com/}} % -% \date{2020-02-13} +% \date{2020-03-19} % \maketitle % %This is the documented code for the \styfmt{glossaries} package. @@ -184,7 +184,7 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of %glossaries package}. % %\item[\url{glossaries-user.pdf}] -%For the main user guide, read \qt{glossaries.sty v4.45: +%For the main user guide, read \qt{glossaries.sty v4.46: %\LaTeX2e\ Package to Assist Generating Glossaries}. % %\item[\url{mfirstuc-manual.pdf}] @@ -239,7 +239,7 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of % This package requires \LaTeXe. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossaries}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} %\changes{4.18}{2015-09-09}{split mfirstuc into separate bundle} % Required packages: @@ -3367,15 +3367,12 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\end{definition} % Code provided by Michael Pock. %\changes{3.07}{2013-07-05}{new} +%\changes{4.46}{2020-03-19}{switched to starred form of \cs{ifglossaryexists}} % \begin{macrocode} \newcommand{\setglossarypreamble}[2][\glsdefaulttype]{% - \ifglossaryexists{#1}{% - \csgdef{@glossarypreamble@#1}{#2}% - }{% - \GlossariesWarning{% - Glossary `#1' is not defined% - }% - }% + \ifglossaryexists*{#1}% + {\csgdef{@glossarypreamble@#1}{#2}}% + {\GlossariesWarning{Glossary `#1' is not defined}}% } % \end{macrocode} %\end{macro} @@ -4159,6 +4156,8 @@ false,nolabel,autolabel,nameref}[nolabel]{% % Define a command that allows the user to set the language % for a given glossary type. The first argument indicates the % glossary type. If omitted the main glossary is assumed. +% This uses the unstarred form of \cs{ifglossaryexists} because +% ignored glossaries can't be used with xindy. % \begin{macrocode} \ifglsxindy \newcommand*\GlsSetXdyLanguage[2][\glsdefaulttype]{% @@ -4315,13 +4314,37 @@ false,nolabel,autolabel,nameref}[nolabel]{% %where \meta{type} is the glossary's label. %\changes{3.0}{2011-04-02}{replaced \cs{@ifundefined} with %\cs{ifcsundef}} +%\changes{4.46}{2020-03-19}{added starred form} +%The unstarred form will do \meta{false-text} for ignored +%glossaries. The starred form will do \meta{true-text} for ignored +%glossaries. +% \begin{macrocode} +\newcommand{\ifglossaryexists}{% + \@ifstar\s@ifglossaryexists\@ifglossaryexists +} +% \end{macrocode} +%\end{macro} +% +%\begin{macro}{\@ifglossaryexists} +%\changes{4.46}{2020-03-19}{new} +% Unstarred form only tests the existence of non-ignored glossaries. % \begin{macrocode} -\newcommand{\ifglossaryexists}[3]{% +\newcommand{\@ifglossaryexists}[3]{% \ifcsundef{@glotype@#1@out}{#3}{#2}% } % \end{macrocode} %\end{macro} % +%\begin{macro}{\s@ifglossaryexists} +%\changes{4.46}{2020-03-19}{new} +% Starred form includes ignored glossaries. +% \begin{macrocode} +\newcommand{\s@ifglossaryexists}[3]{% + \ifcsundef{glolist@#1}{#3}{#2}% +} +% \end{macrocode} +%\end{macro} +% % Since the label is used to form the name of control sequences, by % default UTF8 etc characters can't be used in the label. A possible % workaround is to use \ics{scantokens}, but commands such as @@ -4455,9 +4478,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\changes{4.19}{2015-11-22}{new} %If glossary given by \meta{label} doesn't exist do \meta{code} %otherwise generate an error and do \meta{else code}. +%\changes{4.46}{2020-03-19}{switched to starred form of \cs{ifglossaryexists}} % \begin{macrocode} \newcommand{\doifglossarynoexistsordo}[3]{% - \ifglossaryexists{#1}% + \ifglossaryexists*{#1}% {% \PackageError{glossaries}{Glossary type `#1' already exists}{}% #3% @@ -13100,6 +13124,8 @@ false,nolabel,autolabel,nameref}[nolabel]{% % file). The relevant glossary must be defined prior to using \cs{@makeglossary}. % \sty{glossaries-extra} allows for a hybrid approach. %\begin{macro}{\@makeglossary} +%Unstarred form of \cs{ifglossaryexists} is used as +%\cs{@makeglossary} can't be used with an ignored glossary. % \begin{macrocode} \newcommand*{\@makeglossary}[1]{% \ifglossaryexists{#1}% @@ -13149,6 +13175,8 @@ false,nolabel,autolabel,nameref}[nolabel]{% % %\begin{macro}{\@gls@automake} %\changes{4.08}{2014-07-30}{new} +%Unstarred form of \cs{ifglossaryexists} is used as +%\cs{@gls@automake} can't be used with an ignored glossary. % \begin{macrocode} \ifglsxindy \newcommand*{\@gls@automake}[1]{% @@ -13203,6 +13231,8 @@ false,nolabel,autolabel,nameref}[nolabel]{% % %\begin{macro}{\@gls@automake@immediate} %\changes{4.42}{2019-01-06}{new} +%Unstarred form of \cs{ifglossaryexists} is used as +%\cs{@gls@automake@immediate} can't be used with an ignored glossary. % \begin{macrocode} \ifglsxindy \newcommand*{\@gls@automake@immediate}[1]{% @@ -14557,11 +14587,51 @@ you \undef\printglossary } % \end{macrocode} +% Neither \cs{printglossary} nor \cs{printnoidxglossary} can work +% with an ignored glossary (since ignored glossaries normally +% suppress indexing and there's no associated file for +% \gls{makeindex}/\gls{xindy} to process). However \cs{printunsrtglossary} can be used +% with an ignored glossary, so provide a command to warn if the +% glossary doesn't exist or is an ignored glossary. +%\begin{macro}{\@printgloss@checkexists@noignored} +%\changes{4.46}{2020-03-19}{new} +% \begin{macrocode} +\newcommand*{\@printgloss@checkexists@noignored}[2]{% + \@ifglossaryexists{#1}% + {#2}% + {% + \ifignoredglossary{#1}% + {\GlossariesWarning{Glossary `#1' is an ignored glossary}}% + {\GlossariesWarning{Glossary `#1' doesn't exist}}% + }% +} +% \end{macrocode} +%\end{macro} +%\begin{macro}{\@printgloss@checkexists@allowignored} +%\changes{4.46}{2020-03-19}{new} +%For use with \cs{printunsrtglossary}. +% \begin{macrocode} +\newcommand*{\@printgloss@checkexists@allowignored}[2]{% + \s@ifglossaryexists{#1}% + {#2}% + {\GlossariesWarning{Glossary `#1' doesn't exist}}% +} +% \end{macrocode} +%\end{macro} +%\begin{macro}{\@printgloss@checkexists} +%\changes{4.46}{2020-03-19}{new} +% \begin{macrocode} +\let\@printgloss@checkexists\@printgloss@checkexists@noignored +% \end{macrocode} +%\end{macro} +% +% % \cs{printglossary} has an optional argument. The default % value is to set the glossary type to the main glossary. %\changes{4.04}{2014-03-06}{changed to use new \cs{@printglossary}} % \begin{macrocode} \newcommand*{\printglossary}[1][type=\glsdefaulttype]{% + \let\@printgloss@checkexists\@printgloss@checkexists@noignored \@printglossary{#1}{\@print@glossary}% } % \end{macrocode} @@ -14593,6 +14663,7 @@ you % location list will be empty. % \begin{macrocode} \newcommand*{\printnoidxglossary}[1][type=\glsdefaulttype]{% + \let\@printgloss@checkexists\@printgloss@checkexists@noignored \@printglossary{#1}{\@print@noidx@glossary}% } % \end{macrocode} @@ -14629,7 +14700,9 @@ you % Sets up the glossary for either \cs{printglossary} or % \cs{printnoidxglossary}. The first argument is the options list, % the second argument is the handler macro that -% deals with the actual glossary. +% deals with the actual glossary. This is also used by +% \sty{glossaries-extra}'s \ics{printunsrtglossary} which may be +% used with an ignored glossary. % \begin{macrocode} \newcommand{\@printglossary}[2]{% % \end{macrocode} @@ -14675,8 +14748,10 @@ you \setkeys{printgloss}{#1}% % \end{macrocode} % Does the glossary exist? +%\changes{4.46}{2020-03-19}{replaced \cs{ifglossaryexists} with +%\cs{@printgloss@checkexists}} % \begin{macrocode} - \ifglossaryexists{\@glo@type}% + \@printgloss@checkexists{\@glo@type}% {% % \end{macrocode} % If title has been set, but toctitle hasn't, make toctitle the same @@ -14742,7 +14817,6 @@ you % \begin{macrocode} #2% }% - {\GlossariesWarning{Glossary `\@glo@type' doesn't exist}}% % \end{macrocode} % End the current scope % \begin{macrocode} @@ -19414,7 +19488,7 @@ you % \cs{gls}\marg{label}} on subsequent use. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-prefix}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossaries-prefix}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Pass all options to \sty{glossaries}: % \begin{macrocode} @@ -19879,7 +19953,7 @@ you %\label{sec:code:hypernav} % Package Definition: % \begin{macrocode} -\ProvidesPackage{glossary-hypernav}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-hypernav}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % % The commands defined in this package are provided to @@ -20075,7 +20149,7 @@ you % This defines an in-line style where the entries are % comma-separated with just the name and description displayed. % \begin{macrocode} -\ProvidesPackage{glossary-inline}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-inline}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % %\begin{style}{inline} @@ -20266,7 +20340,7 @@ you % \ics{item} command, it will appear in a bold font by % default. % \begin{macrocode} -\ProvidesPackage{glossary-list}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-list}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} %\begin{macro}{\indexspace} %\changes{4.13}{2015-02-03}{new} @@ -20548,7 +20622,7 @@ you % The glossary styles defined in the \isty{glossary-long} package % used the \env{longtable} environment in the glossary. % \begin{macrocode} -\ProvidesPackage{glossary-long}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-long}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Requires the \isty{longtable} package: % \begin{macrocode} @@ -21045,7 +21119,7 @@ you % \url{http://tex.stackexchange.com/a/56890} % % \begin{macrocode} -\ProvidesPackage{glossary-longbooktabs}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-longbooktabs}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Requires \sty{booktabs} package: % \begin{macrocode} @@ -21386,7 +21460,7 @@ you % used the \env{longtable} environment in the glossary and use % ragged right formatting for the multiline columns. % \begin{macrocode} -\ProvidesPackage{glossary-longragged}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-longragged}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Requires the \isty{array} package: % \begin{macrocode} @@ -21819,7 +21893,7 @@ you %use the \sty{multicol} package. These use the tree-like glossary %styles in a multicol environment. % \begin{macrocode} -\ProvidesPackage{glossary-mcols}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-mcols}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Required packages: % \begin{macrocode} @@ -22256,7 +22330,7 @@ you % The glossary styles defined in the \isty{glossary-super} package % use the \env{supertabular} environment. % \begin{macrocode} -\ProvidesPackage{glossary-super}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-super}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Requires the \isty{supertabular} package: % \begin{macrocode} @@ -22788,7 +22862,7 @@ you % are like those provided by the \isty{glossary-super} package, % except that the multiline columns have ragged right justification. % \begin{macrocode} -\ProvidesPackage{glossary-superragged}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-superragged}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Requires the \isty{array} package: % \begin{macrocode} @@ -23228,7 +23302,7 @@ you % that have a tree-like structure. These are designed for % hierarchical glossaries. % \begin{macrocode} -\ProvidesPackage{glossary-tree}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossary-tree}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % %\begin{macro}{\indexspace} @@ -23949,7 +24023,7 @@ you % hyperlinks may not work properly. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-compatible-207}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossaries-compatible-207}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} %\begin{macro}{\GlsAddXdyAttribute} % Adds an attribute in old format. @@ -24310,7 +24384,7 @@ you %\section{glossaries-compatible-307} % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-compatible-307}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossaries-compatible-307}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % % Compatibility macros for predefined glossary styles: @@ -25118,7 +25192,7 @@ you % \end{macrocode} % Package version number now in line with main glossaries package number. % \begin{macrocode} -\ProvidesPackage{glossaries-accsupp}[2020/02/13 v4.45 (NLCT) +\ProvidesPackage{glossaries-accsupp}[2020/03/19 v4.46 (NLCT) Experimental glossaries accessibility] % \end{macrocode} % Pass all options to \sty{glossaries}: @@ -28424,7 +28498,7 @@ you % modules. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-babel}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossaries-babel}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Load \sty{tracklang} to obtain language settings. % \begin{macrocode} @@ -28468,7 +28542,7 @@ you % modules. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-polyglossia}[2020/02/13 v4.45 (NLCT)] +\ProvidesPackage{glossaries-polyglossia}[2020/03/19 v4.46 (NLCT)] % \end{macrocode} % Load \sty{tracklang} to obtain language settings. % \begin{macrocode} diff --git a/macros/latex/contrib/glossaries/glossaries.ins b/macros/latex/contrib/glossaries/glossaries.ins index ced7110daa..30d939a39e 100644 --- a/macros/latex/contrib/glossaries/glossaries.ins +++ b/macros/latex/contrib/glossaries/glossaries.ins @@ -1,4 +1,4 @@ -% glossaries.ins generated using makedtx version 1.2 2020/2/14 0:32 +% glossaries.ins generated using makedtx version 1.2 2020/3/19 17:03 \input docstrip \preamble diff --git a/macros/latex/contrib/glossaries/glossariesbegin.html b/macros/latex/contrib/glossaries/glossariesbegin.html index d9d639897e..91e6cd7014 100644 --- a/macros/latex/contrib/glossaries/glossariesbegin.html +++ b/macros/latex/contrib/glossaries/glossariesbegin.html @@ -18,32 +18,32 @@ .cmr-17{font-size:170%;} .cmr-12{font-size:120%;} .cmr-8{font-size:80%;} -.cmtt-12{font-size:120%;font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} +.cmtt-12{font-size:120%;font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} .cmr-9{font-size:90%;} .cmbx-9{font-size:90%; font-weight: bold;} .cmbx-9{ font-weight: bold;} .cmss-9{font-size:90%; font-family: sans-serif;} .cmss-9{ font-family: sans-serif;} .cmss-9{ font-family: sans-serif;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} .cmti-10{ font-style: italic;} -.cmtt-9{font-size:90%;font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmitt-10{font-family: monospace; font-style: italic;} +.cmtt-9{font-size:90%;font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmitt-10{font-family: monospace,monospace; font-style: italic;} .cmbx-10{ font-weight: bold;} .cmbx-10{ font-weight: bold;} -.cmsy-9{font-size:90%;} +.tcrm-0900{font-size:90%;} .cmss-8{font-size:80%; font-family: sans-serif;} .cmss-8{ font-family: sans-serif;} .cmss-8{ font-family: sans-serif;} @@ -114,11 +114,6 @@ table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } .hline td, .cline td{ padding: 0; } .hline hr, .cline hr{border:none;border-top:1px solid black;} .tabbing-right {text-align:right;} -span.TEX {letter-spacing: -0.125em; } -span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} -a span.TEX span.E {text-decoration: none; } -span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} -span.LATEX span.TEX{ position:relative; left: -0.4em; } div.float, div.figure {margin-left: auto; margin-right: auto;} div.float img {text-align:center;} div.figure img {text-align:center;} @@ -248,22 +243,22 @@ span#textcolor40{color:#00FF00} </style> </head><body > -<!--l. 55--><p class="noindent" ><a +<!--l. 59--><p class="noindent" ><a id="top"></a> -</p><!--l. 55--><p class="indent" > +</p><!--l. 59--><p class="indent" > -</p><!--l. 55--><p class="indent" > +</p><!--l. 59--><p class="indent" > </p> <div class="center" > -<!--l. 55--><p class="noindent" > -</p><!--l. 55--><p class="noindent" ><span -class="cmr-17">The glossaries package v4.45: a guide for</span> +<!--l. 59--><p class="noindent" > +</p><!--l. 59--><p class="noindent" ><span +class="cmr-17">The glossaries package v4.46: a guide for</span> <span class="cmr-17">beginners</span> </p> @@ -272,20 +267,25 @@ cellspacing="0" cellpadding="0" ><colgroup id="TBL-1-1g"><col id="TBL-1-1" /></colgroup><tr style="vertical-align:baseline;" id="TBL-1-1-"><td style="white-space:nowrap; text-align:center;" id="TBL-1-1-1" -class="td11"> <span -class="cmr-12">Nicola L.C. Talbot </span></td></tr></table> +class="td11"> <span +class="cmr-12">Nicola L.C. Talbot </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-1-2-"><td style="white-space:nowrap; text-align:center;" id="TBL-1-2-1" +class="td11"> <a +href="https://www.dickimaw-books.com/" ><span +class="cmtt-12">dickimaw-books.com</span></a> </td></tr></table> </div> -<!--l. 55--><p class="noindent" ><span -class="cmr-12">2020-02-13</span></p></div> +<!--l. 59--><p class="noindent" ><span +class="cmr-12">2020-03-19</span></p></div> <div class="abstract" > <div class="center" > -<!--l. 57--><p class="noindent" > -</p><!--l. 57--><p class="noindent" ><span +<!--l. 61--><p class="noindent" > +</p><!--l. 61--><p class="noindent" ><span class="cmbx-9">Abstract</span></p></div> - <!--l. 58--><p class="indent" > <span + <!--l. 62--><p class="indent" > <span class="cmr-9">The </span><span class="cmss-9">glossaries </span><span class="cmr-9">package is very flexible, but this means that it has a</span><span @@ -304,7 +304,7 @@ class="cmr-9">…?” then it’s time to move on to the </span><a href="glossaries-user.html" ><span class="cmr-9">main user manual</span></a><span class="cmr-9">.</span> - </p><!--l. 67--><p class="indent" > <span + </p><!--l. 71--><p class="indent" > <span class="cmr-9">I’ve made some statements in this document that don’t actually tell</span> <span class="cmr-9">you the full truth, but it would clutter the document and cause confusion</span> @@ -342,12 +342,12 @@ href="#sec:xr" id="QQ2-1-10">Cross-References</a></span> <br /> <span class="sectionToc" >9 <a href="#sec:moreinfo" id="QQ2-1-11">Further Information</a></span> </div> -<!--l. 77--><p class="noindent" > +<!--l. 81--><p class="noindent" > </p> -<!--l. 77--><p class="noindent" ><a +<!--l. 81--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1 </span> <a id="sec:start"></a>Getting Started</h3> -<!--l. 80--><p class="noindent" >As with all packages, you need to load <span +<!--l. 84--><p class="noindent" >As with all packages, you need to load <span class="cmss-10">glossaries </span>with <span class="cmtt-10">\usepackage</span>, but there are certain packages that must be loaded before <span @@ -367,7 +367,7 @@ class="cmss-10">fontenc</span><a to load these packages, but if you want them, you must load them before <span class="cmss-10">glossaries</span>.) -</p><!--l. 87--><p class="indent" > <div class="important" title="Important Note"> If you require multilingual support you must also install the relevant +</p><!--l. 91--><p class="indent" > <div class="important" title="Important Note"> If you require multilingual support you must also install the relevant language module. Each language module is called <span class="cmtt-10">glossaries-</span>⟨<span class="cmti-10">language</span>⟩, where @@ -379,8 +379,8 @@ class="cmtt-10">glossaries-german</span>. If a language module is required, the class="cmss-10">glossaries </span>package will automatically try to load it and will give a warning if the module isn’t found. </div> -</p><!--l. 95--><p class="noindent" > -</p><!--l. 97--><p class="indent" > Once you have loaded <span +</p><!--l. 99--><p class="noindent" > +</p><!--l. 101--><p class="indent" > Once you have loaded <span class="cmss-10">glossaries</span>, you need to define your terms in the preamble and then you can use them throughout the document. Here’s a simple example: @@ -396,10 +396,10 @@ example:  <br /> Here's my \gls{ex} term.  <br /> \end{document} </div> -<!--l. 110--><p class="nopar" > This produces: +<!--l. 114--><p class="nopar" > This produces: </p><div class="quote"> - <!--l. 113--><p class="noindent" >Here’s my sample term.</p></div> -<!--l. 115--><p class="noindent" >Here’s another example: + <!--l. 117--><p class="noindent" >Here’s my sample term.</p></div> +<!--l. 119--><p class="noindent" >Here’s another example: @@ -413,10 +413,10 @@ example:  <br /> First use: \gls{svm}. Second use: \gls{svm}.  <br /> \end{document} </div> -<!--l. 128--><p class="nopar" > This produces: +<!--l. 132--><p class="nopar" > This produces: </p><div class="quote"> - <!--l. 131--><p class="noindent" >First use: support vector machine (SVM). Second use: SVM.</p></div> -<!--l. 133--><p class="noindent" >In this case, the text produced by <span class="obeylines-h"><span class="verb"><span + <!--l. 135--><p class="noindent" >First use: support vector machine (SVM). Second use: SVM.</p></div> +<!--l. 137--><p class="noindent" >In this case, the text produced by <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{svm}</span></span></span> changed after the first use. The first use produced the long form followed by the short form in parentheses because I set the acronym style to <span @@ -430,13 +430,13 @@ class="cmtt-10">.log </span>file and search for the line that starts with <span class="cmtt-10">Package: glossaries </span>followed by a date and version.) -</p><!--l. 144--><p class="indent" > <div class="important" title="Important Note"> Be careful of fragile commands. If a command causes a problem when used in one +</p><!--l. 148--><p class="indent" > <div class="important" title="Important Note"> Be careful of fragile commands. If a command causes a problem when used in one of the <span class="cmtt-10">\newglossaryentry </span>fields, consider adding <span class="cmtt-10">\glsnoexpandfields </span>before you start defining your entries. </div> -</p><!--l. 148--><p class="noindent" > -</p><!--l. 150--><p class="indent" > Abbreviations are slightly different if you use the extension package <span +</p><!--l. 152--><p class="noindent" > +</p><!--l. 154--><p class="indent" > Abbreviations are slightly different if you use the extension package <span class="cmss-10">glossaries-extra</span><a id="dx1-2006"></a> (which needs to be installed separately): @@ -453,10 +453,17 @@ class="cmss-10">glossaries-extra</span><a  <br /> First use: \gls{svm}. Second use: \gls{svm}.  <br /> \end{document} </div> -<!--l. 164--><p class="nopar" > If you still want to use <span +<!--l. 168--><p class="nopar" > Since <span +class="cmtt-10">long-short </span>happens to be the default for <span +class="cmtt-10">\newabbreviation </span>(if you haven’t +set the <span +class="cmtt-10">category </span>key) you may omit the <span +class="cmtt-10">\setabbreviationstyle </span>line in this +example. +</p><!--l. 173--><p class="indent" > If you still want to use <span class="cmtt-10">\newacronym </span>(rather than <span -class="cmtt-10">\newabbreviation</span>) then you need -the optional argument of <span +class="cmtt-10">\newabbreviation</span>) then you +need the optional argument of <span class="cmtt-10">\setabbreviationstyle</span>: @@ -471,13 +478,21 @@ class="cmtt-10">\setabbreviationstyle</span>:  <br /> First use: \gls{svm}. Second use: \gls{svm}.  <br /> \end{document} </div> -<!--l. 180--><p class="nopar" > -</p><!--l. 181--><p class="indent" > <div class="important" title="Important Note"> You can’t use <span +<!--l. 188--><p class="nopar" > In this example, if you omit the <span +class="cmtt-10">\setabbreviationstyle </span>line you will notice a +difference because the <span +class="cmtt-10">short-nolong </span>style (not the <span +class="cmtt-10">long-short </span>style) is the default +with <span +class="cmtt-10">\newacronym</span>. With the <span +class="cmtt-10">short-nolong </span>style the first use simply shows just the +short form. +</p><!--l. 195--><p class="indent" > <div class="important" title="Important Note"> You can’t use <span class="cmtt-10">\setacronymstyle </span>with <span class="cmss-10">glossaries-extra</span><a id="dx1-2007"></a>. </div> -</p><!--l. 183--><p class="noindent" > -</p><!--l. 185--><p class="indent" > If you like, you can put all your definitions in another file (for example, +</p><!--l. 197--><p class="noindent" > +</p><!--l. 199--><p class="indent" > If you like, you can put all your definitions in another file (for example, <span class="cmtt-10">defns.tex</span>) and load that file in the preamble using <span class="cmtt-10">\loadglsentries </span>with the @@ -489,7 +504,7 @@ filename as the argument. For example: <div class="verbatim" id="verbatim-5"> \loadglsentries{defns} </div> -<!--l. 190--><p class="nopar" > If you find you have a really large number of definitions that are hard to manage in a +<!--l. 204--><p class="nopar" > If you find you have a really large number of definitions that are hard to manage in a <span class="cmtt-10">.tex </span>file, you might want to have a look at <span class="cmtt-10">bib2gls</span><a @@ -497,7 +512,7 @@ class="cmtt-10">bib2gls</span><a requires a <span class="cmtt-10">.bib </span>format instead that can be managed by an application such as JabRef. -</p><!--l. 197--><p class="indent" > Don’t try inserting formatting commands into the definitions as they can interfere +</p><!--l. 211--><p class="indent" > Don’t try inserting formatting commands into the definitions as they can interfere with the underlying mechanism. Instead, the formatting should be done by the style. For example, suppose I want to replace <span class="cmtt-10">SVM </span>with <span class="obeylines-h"><span class="verb"><span @@ -519,7 +534,7 @@ style):  <br /> First use: \gls{svm}. Second use: \gls{svm}.  <br /> \end{document} </div> -<!--l. 215--><p class="nopar" > The abbreviation styles have a different naming scheme with <span +<!--l. 229--><p class="nopar" > The abbreviation styles have a different naming scheme with <span class="cmss-10">glossaries-extra</span><a id="dx1-2009"></a>: @@ -535,7 +550,7 @@ class="cmss-10">glossaries-extra</span><a  <br /> First use: \gls{svm}. Second use: \gls{svm}.  <br /> \end{document} </div> -<!--l. 230--><p class="nopar" > With <span +<!--l. 244--><p class="nopar" > With <span class="cmss-10">glossaries-extra</span><a id="dx1-2010"></a> you can have multiple abbreviation styles for different categories. Many of these styles have their own associated formatting commands that @@ -570,22 +585,22 @@ can be redefined for minor adjustments. For example:  <br /> Next use: \gls{svm}, \gls{cbot}.  <br /> \end{document} </div> -<!--l. 268--><p class="nopar" > This produces: +<!--l. 282--><p class="nopar" > This produces: </p><div class="quote"> - <!--l. 271--><p class="noindent" >First use: support vector machine (<span + <!--l. 285--><p class="noindent" >First use: support vector machine (<span class="cmcsc-10"><span class="small-caps">s</span><span class="small-caps">v</span><span class="small-caps">m</span></span>), <span class="cmti-10">Clostridium botulinum</span>. - </p><!--l. 274--><p class="noindent" >Next use: <span + </p><!--l. 288--><p class="noindent" >Next use: <span class="cmcsc-10"><span class="small-caps">s</span><span class="small-caps">v</span><span class="small-caps">m</span></span>, <span class="cmti-10">C.</span><span class="cmti-10"> botulinum</span>.</p></div> -<!--l. 277--><p class="indent" > As you can hopefully see from the above examples, there are two main ways of +<!--l. 291--><p class="indent" > As you can hopefully see from the above examples, there are two main ways of defining a term: as a general entry (<span class="cmtt-10">\newglossaryentry</span>) or as an abbreviation (<span @@ -593,36 +608,38 @@ class="cmtt-10">\newacronym </span>or, with <span class="cmss-10">glossaries-extra</span><a id="dx1-2011"></a>, <span class="cmtt-10">\newabbreviation</span>). -</p><!--l. 282--><p class="indent" > Regardless of the method of defining a term, the term is always given a label. In +</p><!--l. 296--><p class="indent" > Regardless of the method of defining a term, the term is always given a -the first example, the label was <span -class="cmtt-10">ex </span>and in the other examples the label was <span -class="cmtt-10">svm </span>(and -<span -class="cmtt-10">cbot </span>in the last example). The label is used to uniquely identify the term (like the -standard <span +label. In the first example, the label was <span +class="cmtt-10">ex </span>and in the other examples the +label was <span +class="cmtt-10">svm </span>(and <span +class="cmtt-10">cbot </span>in the last example). The label is used to uniquely +identify the term (like the standard <span class="cmtt-10">\label</span>/<span class="cmtt-10">\ref </span>or <span -class="cmtt-10">\cite </span>mechanism). It’s best to just use the following -alphanumerics in the labels: <span +class="cmtt-10">\cite </span>mechanism). +It’s best to just use the following alphanumerics in the labels: <span class="cmtt-10">a</span>, …, <span class="cmtt-10">z</span>, <span -class="cmtt-10">A</span>, …, <span +class="cmtt-10">A</span>, …, +<span class="cmtt-10">Z</span>, <span class="cmtt-10">0</span>, …, <span -class="cmtt-10">9</span>. Sometimes you can also use -punctuation characters but not if another package (such as <span +class="cmtt-10">9</span>. Sometimes you can also use punctuation characters but not if +another package (such as <span class="cmss-10">babel</span><a - id="dx1-2012"></a>) meddles with -them. Don’t try using any characters outside of the basic Latin set with -<span + id="dx1-2012"></a>) makes them active. Don’t try using any +characters outside of the basic Latin set with <span class="cmss-10">inputenc</span><a - id="dx1-2013"></a> (for example, é or ß) or things will go horribly wrong. This warning -only applies to the label. It doesn’t apply to the text that appears in the -document. -</p><!--l. 297--><p class="indent" > <div class="important" title="Important Note"> Don’t use <span + id="dx1-2013"></a> (for example, é or ß) +or things will go horribly wrong. This warning only applies to the label. +It doesn’t apply to the text that appears in the document. If you really +need UTF-8 characters in your labels then you’ll need to use XeLaTeX or +LuaLaTeX. +</p><!--l. 313--><p class="indent" > <div class="important" title="Important Note"> Don’t use <span class="cmtt-10">\gls </span>in chapter or section headings as it can have some unpleasant side-effects. Instead use <span class="cmtt-10">\glsentrytext </span>for regular entries and one of <span @@ -632,14 +649,13 @@ class="cmtt-10">\glsentrylong </span>or <span class="cmtt-10">\glsentryfull </span>for acronyms. Alternatively use <span class="cmss-10">glossaries-extra</span><a id="dx1-2014"></a> -which provides special commands for use in section headings, such as <span -class="cmtt-10">\glsfmtshort</span> +which provides special commands for use in section headings and captions, such as <span -class="cmtt-10">{</span>⟨<span +class="cmtt-10">\glsfmtshort{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>. </div> -</p><!--l. 304--><p class="noindent" > -</p><!--l. 306--><p class="indent" > The above examples are reasonably straightforward. The difficulty comes if you +</p><!--l. 320--><p class="noindent" > +</p><!--l. 322--><p class="indent" > The above examples are reasonably straightforward. The difficulty comes if you want to display a <span class="cmti-10">sorted </span>list of all the entries you have used in the document. The <span @@ -666,19 +682,19 @@ entries:  <br /> \printunsrtglossaries % list all entries  <br /> \end{document} </div> -<!--l. 332--><p class="nopar" > However this method doesn’t sort the entries (they’re listed in order of definition) +<!--l. 348--><p class="nopar" > However this method doesn’t sort the entries (they’re listed in order of definition) and it will display all the defined entries, regardless of whether or not you’ve used them all in the document, so “turnip” appears in the glossary even though there’s no <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{turnip}</span></span></span> (or similar) in the document. -</p><!--l. 339--><p class="indent" > The <span +</p><!--l. 355--><p class="indent" > The <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">none</span><a id="dx1-2016"></a> option isn’t essential in this case (there’s no other sort option available for this document), but it prevents the automatic construction of the sort value and so slightly improves the document build time. -</p><!--l. 344--><p class="indent" > Note that this example document uses the same command (<span +</p><!--l. 360--><p class="indent" > Note that this example document uses the same command (<span class="cmtt-10">\printunsrtglossaries</span>) that’s used with <span class="cmtt-10">bib2gls</span><a @@ -691,11 +707,10 @@ class="cmss-10">record</span><a id="dx1-2019"></a> package option and one or more instances of <span class="cmtt-10">\GlsXtrLoadResources </span>in the preamble (see below). -</p><!--l. 350--><p class="indent" > Most users prefer to have an automatically sorted list that only contains entries +</p><!--l. 366--><p class="indent" > Most users prefer to have an automatically sorted list that only contains entries that have been used in the document. The <span -class="cmss-10">glossaries </span>package provides three options: -use <span class="TEX">T<span -class="E">E</span>X</span> to perform the sorting (<a +class="cmss-10">glossaries </span>package provides three +options: use TeX to perform the sorting (<a href="#option1">Option 1</a>); use <span class="cmtt-10">makeindex</span><a id="dx1-2020"></a> to perform @@ -711,17 +726,17 @@ class="cmtt-10">bib2gls</span><a id="dx1-2023"></a> (<a href="#option4">Option 4</a>). -</p><!--l. 358--><p class="indent" > The first option (using <span class="TEX">T<span -class="E">E</span>X</span>) is the simplest method, as it doesn’t require an -external tool, but it’s very inefficient and the sorting is done according to the English -alphabet. To use this method, add <span -class="cmtt-10">\makenoidxglossaries </span>to the preamble and put -<span -class="cmtt-10">\printnoidxglossaries </span>at the place where you want your glossary. For +</p><!--l. 374--><p class="indent" > The first option (using TeX) is the simplest method, as it doesn’t require an +external tool, but it’s very inefficient and the sorting is done according to lower case +character code (which matches basic Latin alphabets, such as English, but +not extended Latin alphabets, such as Icelandic). To use this method, add -example: +<span +class="cmtt-10">\makenoidxglossaries </span>to the preamble and put <span +class="cmtt-10">\printnoidxglossaries </span>at the +place where you want your glossary. For example: @@ -743,21 +758,21 @@ example:  <br /> \printnoidxglossaries  <br /> \end{document} </div> -<!--l. 388--><p class="nopar" > -</p><!--l. 390--><p class="indent" > <div class="important" title="Important Note"> The <span +<!--l. 406--><p class="nopar" > +</p><!--l. 408--><p class="indent" > <div class="important" title="Important Note"> The <span class="cmtt-10">\makenoidxglossaries </span>method is very slow, uses an ASCII comparator and often breaks if there are commands in the <span -class="cmtt-10">name </span>key. </div> -</p><!--l. 394--><p class="noindent" > -</p><!--l. 396--><p class="indent" > Try this out and run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> (or pdf<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>) <span +class="cmtt-10">name </span>key. See <a +href="https://www.dickimaw-books.com/gallery/glossaries-performance.shtml" >Glossaries Performance</a> for a +comparison. </div> +</p><!--l. 414--><p class="noindent" > +</p><!--l. 416--><p class="indent" > Try this out and run LaTeX (or pdfLaTeX) <span class="cmti-10">twice</span>. The first run won’t show the glossary. It will only appear on the second run. This doesn’t include “turnip” in the glossary because that term hasn’t been used (with commands like <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{turnip}</span></span></span>) in the document. -</p><!--l. 401--><p class="indent" > The glossary has a vertical gap between the “carrot” term and the “potato” term. +</p><!--l. 421--><p class="indent" > The glossary has a vertical gap between the “carrot” term and the “potato” term. This is because the entries in the glossaries are grouped according to their first letter. If you don’t want this gap, just add <span class="cmss-10">nogroupskip</span><a @@ -770,7 +785,7 @@ options: <div class="verbatim" id="verbatim-11"> \usepackage[nogroupskip]{glossaries} </div> -<!--l. 407--><p class="nopar" > or you may want to try out a style that shows the group headings: +<!--l. 427--><p class="nopar" > or you may want to try out a style that shows the group headings: @@ -778,7 +793,7 @@ options: <div class="verbatim" id="verbatim-12"> \usepackage[style=indexgroup]{glossaries} </div> -<!--l. 411--><p class="nopar" > If you try out this example you may also notice that the description is followed by a +<!--l. 431--><p class="nopar" > If you try out this example you may also notice that the description is followed by a full stop (period) and a number. The number is the location in the document where the entry was used (page 1 in this case), so you can lookup the term in the glossary and be directed to the relevant pages. It may be that you don’t want this @@ -793,7 +808,7 @@ option: <div class="verbatim" id="verbatim-13"> \usepackage[nonumberlist]{glossaries} </div> -<!--l. 421--><p class="nopar" > If you don’t like the terminating full stop, you can suppress that with the <span +<!--l. 441--><p class="nopar" > If you don’t like the terminating full stop, you can suppress that with the <span class="cmss-10">nopostdot</span><a id="dx1-2026"></a> package option: @@ -804,13 +819,13 @@ package option: <div class="verbatim" id="verbatim-14"> \usepackage[nopostdot]{glossaries} </div> -<!--l. 426--><p class="nopar" > -</p><!--l. 428--><p class="indent" > If you tried out the previous example with <span +<!--l. 446--><p class="nopar" > +</p><!--l. 448--><p class="indent" > If you try out the earlier example with <span class="cmss-10">glossaries-extra</span><a id="dx1-2027"></a> and <span class="cmtt-10">\printunsrtglossaries</span> -the terminating full stop is missing and there are no number lists. You can add the -full stop back with +you may notice that the terminating full stop is missing and there are no number +lists. You can add the full stop back with @@ -818,7 +833,7 @@ full stop back with <div class="verbatim" id="verbatim-15"> \usepackage[nopostdot=false]{glossaries-extra} </div> -<!--l. 433--><p class="nopar" > or +<!--l. 453--><p class="nopar" > or @@ -826,15 +841,14 @@ full stop back with <div class="verbatim" id="verbatim-16"> \usepackage[postdot]{glossaries-extra} </div> -<!--l. 437--><p class="nopar" > If you want the number lists then you need to use an indexing option. -</p><!--l. 441--><p class="indent" > You may have noticed that I’ve used another command in the above example: +<!--l. 457--><p class="nopar" > If you want the number lists then you need to use an indexing option. +</p><!--l. 460--><p class="indent" > You may have noticed that I’ve used another command in the above examples: <span class="cmtt-10">\glspl</span>. This displays the plural form. By default, this is just the singular form with the letter “s” appended, but in the case of “potato” I had to specify the correct plural using the <span class="cmtt-10">plural </span>key. -</p><!--l. 447--><p class="indent" > As I mentioned earlier, using <span class="TEX">T<span -class="E">E</span>X</span> to sort the entries is the simplest but least +</p><!--l. 466--><p class="indent" > As I mentioned earlier, using TeX to sort the entries is the simplest but least efficient method. If you have a large glossary or if your terms contain non-Latin or extended Latin characters, then you will have a much faster build time if you use <span @@ -854,28 +868,28 @@ class="cmtt-10">bib2gls</span><a id="dx1-2032"></a> are the recommended methods. These methods are described in more detail in <a href="#sec:printglossaries"><span -class="cmsy-10">§</span>4 </a><a +class="tcrm-1000">§</span>4 </a><a href="#sec:printglossaries">Displaying a List of Entries<!--tex4ht:ref: sec:printglossaries --></a>. -</p><!--l. 457--><p class="indent" > The rest of this document briefly describes the main commands provided by the +</p><!--l. 476--><p class="indent" > The rest of this document briefly describes the main commands provided by the <span class="cmss-10">glossaries </span>package. (Most of these are also available with <span class="cmss-10">glossaries-extra</span><a id="dx1-2033"></a> but may behave slightly differently.) -</p><!--l. 462--><p class="noindent" > +</p><!--l. 481--><p class="noindent" > </p> -<!--l. 462--><p class="noindent" ><a +<!--l. 481--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2 </span> <a id="sec:defterm"></a>Defining Terms</h3> -<!--l. 465--><p class="noindent" >When you use the <span +<!--l. 484--><p class="noindent" >When you use the <span class="cmss-10">glossaries</span><a id="dx1-3001"></a> package, you need to define glossary entries in the document preamble. These entries could be a word, phrase, abbreviation or symbol. They’re usually accompanied by a description, which could be a short sentence or an in-depth explanation that spans multiple paragraphs. The simplest method of defining an entry is to use: -</p><!--l. 472--><p class="indent" > <hr><div title="Definition"></p><div class="alltt"> +</p><!--l. 491--><p class="indent" > <hr><div title="Definition"></p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{</span>⟨<span @@ -905,7 +919,7 @@ class="cmtt-10">}</span></span> -<!--l. 480--><p class="noindent" > +<!--l. 499--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is a unique label that identifies this entry. (Don’t include the angle brackets ⟨ ⟩. They just indicate the parts of the code you need to change when you use @@ -914,11 +928,11 @@ class="cmti-10">name</span>⟩ is the word, phrase or symbol you are defining, and ⟨<span class="cmti-10">description</span>⟩ is the description to be displayed in the glossary. -</p><!--l. 488--><p class="indent" > This command is a “short” command, which means that ⟨<span +</p><!--l. 507--><p class="indent" > This command is a “short” command, which means that ⟨<span class="cmti-10">description</span>⟩ can’t contain a paragraph break. If you have a long description, you can instead use: -</p><!--l. 492--><p class="indent" > <hr><div title="Definition"></p><div class="alltt"> +</p><!--l. 511--><p class="indent" > <hr><div title="Definition"></p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\longnewglossaryentry{</span>⟨<span @@ -944,8 +958,8 @@ class="cmitt-10">description</span>⟩<span class="cmtt-10">}</span> </div> </div> </div><hr> -<!--l. 500--><p class="noindent" > -</p><!--l. 502--><p class="indent" > Examples: +<!--l. 519--><p class="noindent" > +</p><!--l. 521--><p class="indent" > Examples: </p><ol class="enumerate1" > <li class="enumerate" id="x1-3003x1">Define the term “set” with the label <span @@ -960,7 +974,7 @@ class="cmtt-10">set</span>:  <br />  description={a collection of objects}  <br />} </div> - <!--l. 511--><p class="nopar" > + <!--l. 530--><p class="nopar" > </p></li> <li class="enumerate" id="x1-3005x2">Define the symbol <span @@ -976,7 +990,7 @@ class="cmtt-10">emptyset</span>:  <br />  description={the empty set}  <br />} </div> - <!--l. 521--><p class="nopar" > (This will also need a <span + <!--l. 540--><p class="nopar" > (This will also need a <span class="cmtt-10">sort </span>key if you use Options <a href="#option1">1</a> or <a href="#option3">3</a>, see below.) @@ -998,7 +1012,7 @@ class="cmtt-10">fishage</span>:  <br />  fish species.  <br />} </div> - <!--l. 538--><p class="nopar" > (The percent character discards the end of line character that would otherwise + <!--l. 557--><p class="nopar" > (The percent character discards the end of line character that would otherwise cause an unwanted space to appear at the start of the description.) </p></li> <li @@ -1019,7 +1033,7 @@ class="cmtt-10">é</span>). This first letter must be placed in a g  <br />  description={select group or class}  <br />} </div> - <!--l. 554--><p class="nopar" > or </p><div class="alltt"> + <!--l. 573--><p class="nopar" > or </p><div class="alltt"> <div class="obeylines-v"> <span class="verb"><span class="cmtt-10">\newglossaryentry{elite}</span></span> @@ -1043,10 +1057,11 @@ class="cmtt-10"> class}</span></span> class="cmtt-10">}</span></span> </div> </div></li></ol> -<!--l. 564--><p class="noindent" >(For further details, see the section “UTF-8” of the <a +<!--l. 583--><p class="noindent" >(This isn’t necessary for UTF-8 characters with XeLaTeX or LuaLaTeX. For further +details, see the section “UTF-8” of the <a href="https://ctan.org/pkg/mfirstuc" ><span class="cmss-10">mfirstuc</span></a> user manual.) -</p><!--l. 567--><p class="indent" > If you use <span +</p><!--l. 587--><p class="indent" > If you use <span class="cmtt-10">bib2gls</span><a id="dx1-3011"></a> with <span class="cmss-10">glossaries-extra</span><a @@ -1137,6 +1152,9 @@ class="cmtt-10"> the</span><span class="cmtt-10"> Silurian</span><span class="cmtt-10"> Period</span><span class="cmtt-10"> to</span> + + + <br /><span class="cmtt-10"> </span><span class="cmtt-10"> the</span><span @@ -1145,9 +1163,6 @@ class="cmtt-10"> of</span><span class="cmtt-10"> the</span><span class="cmtt-10"> Carboniferous</span><span class="cmtt-10"> Period.</span> - - - <br /> <br /><span class="cmtt-10"> </span><span @@ -1205,7 +1220,7 @@ package option: <div class="verbatim" id="verbatim-21"> \usepackage[record]{glossaries-extra} </div> -<!--l. 604--><p class="nopar" > and the <span +<!--l. 624--><p class="nopar" > and the <span class="cmtt-10">.bib </span>file is specified in the resource command. For example, if the <span class="cmtt-10">.bib </span>file is called <span @@ -1218,7 +1233,7 @@ preamble: <div class="verbatim" id="verbatim-22"> \GlsXtrLoadResources[src={entries}] </div> -<!--l. 610--><p class="nopar" > You can have a comma-separated list. For example, if you also have entries defined +<!--l. 630--><p class="nopar" > You can have a comma-separated list. For example, if you also have entries defined in the file <span class="cmtt-10">entries2.bib</span>: @@ -1226,10 +1241,10 @@ class="cmtt-10">entries2.bib</span>: </p> <div class="verbatim" id="verbatim-23"> -\GlsXtrLoadResources[src={entries,entries2.bib}] +\GlsXtrLoadResources[src={entries,entries2}] </div> -<!--l. 615--><p class="nopar" > -</p><!--l. 617--><p class="indent" > There are other keys you can use when you define an entry. For example, the <span +<!--l. 635--><p class="nopar" > +</p><!--l. 637--><p class="indent" > There are other keys you can use when you define an entry. For example, the <span class="cmtt-10">name</span> key indicates how the term should appear in the list of entries (glossary), but if the term should appear differently when you reference it with <span @@ -1238,7 +1253,7 @@ class="cmti-10">label</span>⟩<span class="cmtt-10">} </span>in the document, you need to use the <span class="cmtt-10">text </span>key as well. -</p><!--l. 623--><p class="indent" > For example: +</p><!--l. 643--><p class="indent" > For example: @@ -1252,7 +1267,7 @@ class="cmtt-10">text </span>key as well.  <br />  a, \ldots, z, A, \ldots, Z}  <br />} </div> -<!--l. 632--><p class="nopar" > This will appear in the text as “Latin alphabet” but will be listed in the glossary +<!--l. 652--><p class="nopar" > This will appear in the text as “Latin alphabet” but will be listed in the glossary as “Latin Alphabet”. With <span class="cmtt-10">bib2gls</span><a id="dx1-3015"></a> this entry is defined in the <span @@ -1270,8 +1285,8 @@ as:  <br />  a, \ldots, z, A, \ldots, Z}  <br />} </div> -<!--l. 644--><p class="nopar" > -</p><!--l. 646--><p class="indent" > Another commonly used key is <span +<!--l. 664--><p class="nopar" > +</p><!--l. 666--><p class="indent" > Another commonly used key is <span class="cmtt-10">plural </span>for specifying the plural of the term. This defaults to the value of the <span class="cmtt-10">text </span>key with an “s” appended, but if this is incorrect, @@ -1289,10 +1304,10 @@ class="cmtt-10">plural </span>key to override it:  <br />  description={canal from mouth to stomach}  <br />} </div> -<!--l. 657--><p class="nopar" > (Remember from earlier that the initial ligature <span +<!--l. 677--><p class="nopar" > (Remember from earlier that the initial ligature <span class="cmtt-10">\oe </span>needs to be grouped.) -</p><!--l. 661--><p class="indent" > Abbreviations can be defined using -</p><!--l. 663--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 681--><p class="indent" > Abbreviations can be defined using: +</p><!--l. 683--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\newacronym[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -1302,7 +1317,7 @@ class="cmitt-10">short</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">long</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 664--><p class="noindent" > +</p><!--l. 684--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the label (as per <span class="cmtt-10">\newglossaryentry</span>), ⟨<span @@ -1316,7 +1331,7 @@ class="cmti-10">long</span>⟩ is the long form. For example, the following <div class="verbatim" id="verbatim-27"> \newacronym{svm}{SVM}{support vector machine} </div> -<!--l. 671--><p class="nopar" > This internally uses <span +<!--l. 691--><p class="nopar" > This internally uses <span class="cmtt-10">\newglossaryentry </span>to define an entry with the label <span class="cmtt-10">svm</span>. By default, the <span @@ -1336,14 +1351,14 @@ the optional argument:  <br /> [description={statistical pattern recognition technique}]  <br /> {svm}{SVM}{support vector machine} </div> -<!--l. 683--><p class="nopar" > -</p><!--l. 685--><p class="indent" > Before you define your acronyms (or other types of abbreviations), you need to -specify which style to use with -</p><!--l. 688--><p class="indent" > <hr><div title="Definition"><span +<!--l. 703--><p class="nopar" > +</p><!--l. 705--><p class="indent" > Before you define your acronyms (or other types of abbreviations), you need to +specify which style to use with: +</p><!--l. 708--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\setacronymstyle{</span>⟨<span class="cmitt-10">style name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 689--><p class="noindent" > +</p><!--l. 709--><p class="noindent" > where ⟨<span class="cmti-10">style name</span>⟩ is the name of the style. There are a number of predefined styles, such as: <span @@ -1360,13 +1375,13 @@ description). There are some other styles as well that use <span class="cmtt-10">\textsc </span>to typeset the acronym or that use a footnote on first use. See the main user guide for further details. -</p><!--l. 701--><p class="indent" > The <span +</p><!--l. 721--><p class="indent" > The <span class="cmss-10">glossaries-extra</span><a id="dx1-3016"></a> package provides improved abbreviation handling with <a href="http://www.dickimaw-books.com/gallery/sample-abbr-styles.shtml" >a lot more predefined styles</a>. With this extension package, abbreviations are defined using: -</p><!--l. 705--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 725--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\newabbreviation[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -1376,17 +1391,17 @@ class="cmitt-10">short</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">long</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 706--><p class="noindent" > +</p><!--l. 726--><p class="noindent" > You can still use <span class="cmtt-10">\newacronym </span>but it’s redefined to use the new abbreviation interface. The style must now be set using: -</p><!--l. 710--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 730--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\setabbreviationstyle[</span>⟨<span class="cmitt-10">category</span>⟩<span class="cmtt-10">]{</span>⟨<span class="cmitt-10">style name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 711--><p class="noindent" > +</p><!--l. 731--><p class="noindent" > The default ⟨<span class="cmti-10">category</span>⟩ is <span class="cmtt-10">abbreviation</span>. If you use <span @@ -1434,7 +1449,7 @@ class="cmtt-10">}</span> class="cmsy-10">}</span> </div> </div> -<!--l. 728--><p class="indent" > The plural forms for abbreviations can be specified using the <span +<!--l. 748--><p class="indent" > The plural forms for abbreviations can be specified using the <span class="cmtt-10">longplural </span>and <span class="cmtt-10">shortplural </span>keys. For example: @@ -1447,7 +1462,7 @@ class="cmtt-10">shortplural </span>keys. For example:  <br /> [longplural={diagonal matrices}]  <br /> {dm}{DM}{diagonal matrix} </div> -<!--l. 734--><p class="nopar" > or (with <span +<!--l. 754--><p class="nopar" > or (with <span class="cmss-10">glossaries-extra</span><a id="dx1-3019"></a>): @@ -1459,7 +1474,7 @@ class="cmss-10">glossaries-extra</span><a  <br /> [longplural={diagonal matrices}]  <br /> {dm}{DM}{diagonal matrix} </div> -<!--l. 740--><p class="nopar" > If omitted, the defaults are again obtained by appending an “s” to the singular +<!--l. 760--><p class="nopar" > If omitted, the defaults are again obtained by appending an “s” to the singular versions. With <span class="cmtt-10">bib2gls</span><a id="dx1-3020"></a>, the definition in the <span @@ -1475,8 +1490,8 @@ class="cmtt-10">.bib </span>file is:  <br />  longplural={diagonal matrices}  <br />} </div> -<!--l. 750--><p class="nopar" > -</p><!--l. 752--><p class="indent" > It’s also possible to have both a name and a corresponding symbol. +<!--l. 770--><p class="nopar" > +</p><!--l. 772--><p class="indent" > It’s also possible to have both a name and a corresponding symbol. Just use the <span class="cmtt-10">name </span>key for the name and the <span class="cmtt-10">symbol </span>key for the symbol. For @@ -1493,7 +1508,7 @@ example:  <br />  description={the set containing no elements}  <br />} </div> -<!--l. 762--><p class="nopar" > or with <span +<!--l. 782--><p class="nopar" > or with <span class="cmtt-10">bib2gls</span><a id="dx1-3021"></a> the definition in the <span class="cmtt-10">.bib </span>file is: @@ -1508,14 +1523,13 @@ class="cmtt-10">.bib </span>file is:  <br />  description={the set containing no elements}  <br />} </div> -<!--l. 770--><p class="nopar" > -</p><!--l. 772--><p class="indent" > If you want the symbol in the <span +<!--l. 790--><p class="nopar" > +</p><!--l. 792--><p class="indent" > If you want the symbol in the <span class="cmtt-10">name </span>field then you must supply a <span class="cmtt-10">sort </span>value with Options <a href="#option1">1</a> and <a -href="#option3">3</a> otherwise you’ll end up with errors from <span class="TEX">T<span -class="E">E</span>X</span> or <span +href="#option3">3</a> otherwise you’ll end up with errors from TeX or <span class="cmtt-10">xindy</span><a id="dx1-3022"></a>. With <a @@ -1535,7 +1549,7 @@ order is a little odd. For example:  <br />  description={the set containing no elements}  <br />} </div> -<!--l. 784--><p class="nopar" > This displays the symbol as <span +<!--l. 804--><p class="nopar" > This displays the symbol as <span class="cmsy-10">∅ </span>but sorts according to “empty set”. You may want to consider using <span class="cmss-10">glossaries-extra</span><a @@ -1543,7 +1557,7 @@ class="cmss-10">glossaries-extra</span><a class="cmss-10">symbols</span><a id="dx1-3025"></a> package option which provides -</p><!--l. 790--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 810--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\glsxtrnewsymbol[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -1551,7 +1565,7 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">symbol</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 791--><p class="noindent" > +</p><!--l. 811--><p class="noindent" > This internally uses <span class="cmtt-10">\newglossaryentry </span>but automatically sets the <span class="cmtt-10">sort </span>key to the @@ -1574,8 +1588,8 @@ class="cmti-10">label</span>⟩. For example:  <br />\printglossaries  <br />\end{document} </div> -<!--l. 811--><p class="nopar" > Now the sort value is “emptyset” rather than the previous “empty set”. -</p><!--l. 815--><p class="indent" > With <span +<!--l. 831--><p class="nopar" > Now the sort value is “emptyset” rather than the previous “empty set”. +</p><!--l. 835--><p class="indent" > With <span class="cmtt-10">bib2gls</span><a id="dx1-3026"></a> you can define this in the <span class="cmtt-10">.bib </span>file as @@ -1589,7 +1603,7 @@ class="cmtt-10">.bib </span>file as  <br />  description={the set containing no elements}  <br />} </div> -<!--l. 822--><p class="nopar" > in which case <span +<!--l. 842--><p class="nopar" > in which case <span class="cmtt-10">bib2gls</span><a id="dx1-3027"></a> will try to interpret the <span class="cmtt-10">name </span>field to determine the sort @@ -1604,7 +1618,7 @@ value. Alternatively you can use:  <br />  description={the set containing no elements}  <br />} </div> -<!--l. 830--><p class="nopar" > which will use the label (<span +<!--l. 850--><p class="nopar" > which will use the label (<span class="cmtt-10">emptyset</span>) as the sort value. (You don’t need the <span class="cmss-10">symbols</span><a id="dx1-3028"></a> @@ -1625,20 +1639,34 @@ now:  <br />\printunsrtglossaries  <br />\end{document} </div> -<!--l. 847--><p class="nopar" > -</p><!--l. 849--><p class="noindent" > +<!--l. 867--><p class="nopar" > +</p><!--l. 869--><p class="indent" > Note that while the <span +class="cmtt-10">sort </span>key is advised for symbols when using <span +class="cmtt-10">\makeglossaries </span>or +<span +class="cmtt-10">\makenoidxglossaries </span>it shouldn’t be used with <span +class="cmtt-10">bib2gls</span><a + id="dx1-3029"></a>. Instead, <span +class="cmtt-10">bib2gls</span><a + id="dx1-3030"></a> has its +own algorithm for determining the sort value based on the entry type (<span +class="cmtt-10">@entry</span>, +<span +class="cmtt-10">@symbol </span>etc). See <a +href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" >bib2gls gallery: sorting</a> for further details. +</p><!--l. 877--><p class="noindent" > </p> -<!--l. 849--><p class="noindent" ><a +<!--l. 877--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">3 </span> <a id="sec:useterm"></a>Using Entries</h3> -<!--l. 852--><p class="noindent" >Once you have defined your entries, as described above, you can reference them in +<!--l. 880--><p class="noindent" >Once you have defined your entries, as described above, you can reference them in your document. There are a number of commands to do this, but the most common one is: -</p><!--l. 856--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 884--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\gls{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 857--><p class="noindent" > +</p><!--l. 885--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the label you assigned to the entry when you defined it. For example, <span class="obeylines-h"><span class="verb"><span @@ -1650,10 +1678,9 @@ class="cmtt-10">bib2gls</span><a class="cmtt-10">\ref </span>and <span class="cmtt-10">\cite</span>) until <span class="cmtt-10">bib2gls</span><a - id="dx1-4002"></a> has created the relevant files and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> is + id="dx1-4002"></a> has created the relevant files and LaTeX is rerun. -</p><!--l. 865--><p class="indent" > If you are using the <span +</p><!--l. 893--><p class="indent" > If you are using the <span class="cmss-10">hyperref</span><a id="dx1-4003"></a> package (remember to load it before <span class="cmss-10">glossaries</span>) <span @@ -1664,7 +1691,7 @@ class="cmtt-10">\gls* </span>for example, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls*{fishage}</span></span></span>. The other commands described in this section all have a similar starred form. -</p><!--l. 872--><p class="indent" > If the entry was defined as an acronym (using <span +</p><!--l. 900--><p class="indent" > If the entry was defined as an acronym (using <span class="cmtt-10">\newacronym </span>with <span class="cmss-10">glossaries</span> described above) or an abbreviation (using <span @@ -1677,6 +1704,9 @@ short form on subsequent use. For example, if the style is set to <span class="cmtt-10">long-short</span>, then <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{svm}</span></span></span> will display “support vector machine (SVM)” the first time + + + it’s used, but the next occurrence of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{svm}</span></span></span> will just display “SVM”. (If you use <span @@ -1685,33 +1715,30 @@ class="cmss-10">glossaries-extra</span><a id="dx1-4005"></a> the default doesn’t show the long form on first use. You’ll need to change the style first, as described earlier.) - - - -</p><!--l. 884--><p class="indent" > If you want the plural form, you can use: -</p><!--l. 886--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 912--><p class="indent" > If you want the plural form, you can use: +</p><!--l. 914--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\glspl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 887--><p class="noindent" > +</p><!--l. 915--><p class="noindent" > instead of <span class="cmtt-10">\gls{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>. For example, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspl{set}</span></span></span> displays “sets”. -</p><!--l. 891--><p class="indent" > If the term appears at the start of a sentence, you can convert the first letter to +</p><!--l. 919--><p class="indent" > If the term appears at the start of a sentence, you can convert the first letter to upper case using: -</p><!--l. 894--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 922--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\Gls{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 895--><p class="noindent" > +</p><!--l. 923--><p class="noindent" > for the singular form or -</p><!--l. 898--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 926--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\Glspl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 899--><p class="noindent" > +</p><!--l. 927--><p class="noindent" > for the plural form. For example: @@ -1720,23 +1747,23 @@ for the plural form. For example: <div class="verbatim" id="verbatim-39"> \Glspl{set} are collections. </div> -<!--l. 903--><p class="nopar" > produces “Sets are collections”. -</p><!--l. 906--><p class="indent" > If you’ve specified a symbol using the <span +<!--l. 931--><p class="nopar" > produces “Sets are collections”. +</p><!--l. 934--><p class="indent" > If you’ve specified a symbol using the <span class="cmtt-10">symbol </span>key, you can display it using: -</p><!--l. 909--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 937--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\glssymbol{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 910--><p class="noindent" > -</p><!--l. 912--><p class="noindent" > +</p><!--l. 938--><p class="noindent" > +</p><!--l. 940--><p class="noindent" > </p> -<!--l. 912--><p class="noindent" ><a +<!--l. 940--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4 </span> <a id="sec:printglossaries"></a>Displaying a List of Entries</h3> -<!--l. 915--><p class="noindent" >In <a +<!--l. 943--><p class="noindent" >In <a href="#sec:start"><span -class="cmsy-10">§</span>1 </a><a +class="tcrm-1000">§</span>1 </a><a href="#sec:start">Getting Started<!--tex4ht:ref: sec:start --></a>, I mentioned that there are three options you can choose from to create an automatically sorted glossary with the base <span class="cmss-10">glossaries</span> @@ -1755,7 +1782,7 @@ build</a>. -<!--l. 925--><p class="indent" > <a +<!--l. 953--><p class="indent" > <a id="tab:optionsp+c"></a></p><hr class="float" /><div class="float" > @@ -1773,7 +1800,7 @@ id="TBL-2-3" /><col id="TBL-2-4" /><col id="TBL-2-5" /></colgroup><tr style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:normal; text-align:left;" id="TBL-2-1-1" -class="td11"> <!--l. 931--><p class="noindent" > </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-1-2" +class="td11"> <!--l. 959--><p class="noindent" > </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-1-2" class="td11"> <a href="#option1"><span class="cmbx-10">Option</span><span @@ -1792,7 +1819,7 @@ class="cmbx-10">Option</span><span class="cmbx-10"> 4</span></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-2-"><td style="white-space:normal; text-align:left;" id="TBL-2-2-1" -class="td11"> <!--l. 933--><p class="noindent" >Requires +class="td11"> <!--l. 961--><p class="noindent" >Requires <span class="cmss-10">glossaries-extra</span><a id="dx1-5002"></a>? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-2-2" @@ -1806,7 +1833,7 @@ class="td11"> <span id="textcolor4"><span class="pzdr-">✔</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-3-"><td style="white-space:normal; text-align:left;" id="TBL-2-3-1" -class="td11"> <!--l. 935--><p class="noindent" >Requires +class="td11"> <!--l. 963--><p class="noindent" >Requires an external application? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-3-2" @@ -1820,7 +1847,7 @@ class="td11"> <span id="textcolor8"><span class="pzdr-">✔</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-4-"><td style="white-space:normal; text-align:left;" id="TBL-2-4-1" -class="td11"> <!--l. 937--><p class="noindent" >Requires +class="td11"> <!--l. 965--><p class="noindent" >Requires Perl? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-4-2" class="td11"> <span id="textcolor9"><span class="pzdr-">✘</span></span> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-4-3" @@ -1832,7 +1859,7 @@ class="td11"> <span id="textcolor12"><span class="pzdr-">✘</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-5-"><td style="white-space:normal; text-align:left;" id="TBL-2-5-1" -class="td11"> <!--l. 939--><p class="noindent" >Requires +class="td11"> <!--l. 967--><p class="noindent" >Requires Java? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-5-2" class="td11"> <span id="textcolor13"><span class="pzdr-">✘</span></span> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-5-3" @@ -1844,7 +1871,7 @@ class="td11"> <span id="textcolor16"><span class="pzdr-">✔</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-6-"><td style="white-space:normal; text-align:left;" id="TBL-2-6-1" -class="td11"> <!--l. 941--><p class="noindent" >Can +class="td11"> <!--l. 969--><p class="noindent" >Can sort extended Latin @@ -1861,7 +1888,7 @@ class="td11"> <span id="textcolor20"><span class="pzdr-">✔</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-7-"><td style="white-space:normal; text-align:left;" id="TBL-2-7-1" -class="td11"> <!--l. 944--><p class="noindent" >Efficient +class="td11"> <!--l. 972--><p class="noindent" >Efficient sort algorithm? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-7-2" class="td11"> <span id="textcolor21"><span @@ -1874,7 +1901,7 @@ class="td11"> <span id="textcolor24"><span class="pzdr-">✔</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-8-"><td style="white-space:normal; text-align:left;" id="TBL-2-8-1" -class="td11"> <!--l. 946--><p class="noindent" >Can +class="td11"> <!--l. 974--><p class="noindent" >Can use different sort @@ -1892,7 +1919,7 @@ class="td11"> <span id="textcolor28"><span class="pzdr-">✔</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-9-"><td style="white-space:normal; text-align:left;" id="TBL-2-9-1" -class="td11"> <!--l. 948--><p class="noindent" >Any +class="td11"> <!--l. 976--><p class="noindent" >Any problematic sort values? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-9-2" @@ -1906,7 +1933,7 @@ class="td11"> <span id="textcolor32"><span class="pzdr-">✘</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-10-"><td style="white-space:normal; text-align:left;" id="TBL-2-10-1" -class="td11"> <!--l. 950--><p class="noindent" >Can +class="td11"> <!--l. 978--><p class="noindent" >Can form ranges in @@ -1923,7 +1950,7 @@ class="td11"> <span id="textcolor36"><span class="pzdr-">✔</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-11-"><td style="white-space:normal; text-align:left;" id="TBL-2-11-1" -class="td11"> <!--l. 952--><p class="noindent" >Can +class="td11"> <!--l. 980--><p class="noindent" >Can have non-standard locations? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-11-2" @@ -1933,12 +1960,12 @@ class="td11"> <span id="textcolor38"><span class="pzdr-">✘</span></span> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-11-4" class="td11"> <span id="textcolor39"><span class="pzdr-">✔</span></span><sup class="textsuperscript"><span -class="cmsy-9">†</span></sup> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-11-5" +class="tcrm-0900">†</span></sup> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-11-5" class="td11"> <span id="textcolor40"><span class="pzdr-">✔</span></span> </td> </tr></table></div> -<!--l. 955--><p class="noindent" ><sup class="textsuperscript"><span -class="cmsy-9">†</span></sup> <span +<!--l. 983--><p class="noindent" ><sup class="textsuperscript"><span +class="tcrm-0900">†</span></sup> <span class="cmr-8">Requires some setting up.</span> @@ -1952,12 +1979,12 @@ class="description"><a id="option1"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 1</span>: - <!--l. 962--><p class="noindent" >This is the simplest option but it’s slow and if you want a sorted - list, it doesn’t work for non-Latin alphabets. The <span -class="cmtt-10">name </span>mustn’t contain - commands (or, if it does, the <span -class="cmtt-10">sort </span>value must be supplied) unless you - have the package option <span + <!--l. 990--><p class="noindent" >This is the simplest option but it’s slow and if you want a sorted list, + it doesn’t work for extended or non-Latin alphabets. The <span +class="cmtt-10">name </span>mustn’t + contain commands (or, if it does, the <span +class="cmtt-10">sort </span>value must be supplied) unless + you have the package option <span class="cmss-10">sanitizesort</span><a id="dx1-5003"></a> or <span class="cmss-10">sort</span><span @@ -1974,18 +2001,18 @@ class="cmss-10">use</span><a class="cmtt-10">\makenoidxglossaries </span>to your preamble (before you start defining your entries, as described in <a href="#sec:defterm"><span -class="cmsy-10">§</span>2 </a><a +class="tcrm-1000">§</span>2 </a><a href="#sec:defterm">Defining Terms<!--tex4ht:ref: sec:defterm --></a>). </li> <li class="enumerate" id="x1-5009x2">Put - <!--l. 976--><p class="noindent" ><hr><div title="Definition"><span + <!--l. 1004--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printnoidxglossary[sort=</span>⟨<span class="cmitt-10">order</span>⟩<span class="cmtt-10">,</span>⟨<span class="cmitt-10">other options</span>⟩<span class="cmtt-10">] </span></div><hr> - </p><!--l. 977--><p class="noindent" > + </p><!--l. 1005--><p class="noindent" > where you want your list of entries to appear. The sort ⟨<span class="cmti-10">order</span>⟩ may be one of: <span @@ -1996,12 +2023,12 @@ class="cmtt-10">case </span>(case-sensitive class="cmtt-10">def </span>(in order of definition) or <span class="cmtt-10">use </span>(in order of use). Alternatively, use - </p><!--l. 984--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 1012--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printnoidxglossaries </span></div><hr> - </p><!--l. 985--><p class="noindent" > + </p><!--l. 1013--><p class="noindent" > to display all your glossaries (if you have more than one). This command doesn’t have any arguments. - </p><!--l. 989--><p class="noindent" >This option allows you to have different sort methods. For example: + </p><!--l. 1017--><p class="noindent" >This option allows you to have different sort methods. For example: @@ -2010,15 +2037,13 @@ class="cmtt-10">\printnoidxglossaries </span></div><hr> \printnoidxglossary[sort=word]% main glossary  <br />\printnoidxglossary[type=symbols,sort=use]% symbols glossary </div> - <!--l. 994--><p class="nopar" > + <!--l. 1022--><p class="nopar" > </p></li> <li - class="enumerate" id="x1-5011x3">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> twice on your document. (As you would do to make a table + class="enumerate" id="x1-5011x3">Run LaTeX twice on your document. (As you would do to make a table of contents appear.) For example, click twice on the “typeset” or “build” - or “PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>” button in your editor.</li></ol> - <!--l. 1000--><p class="noindent" >Here’s a complete document (<span + or “PDFLaTeX” button in your editor.</li></ol> + <!--l. 1028--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): @@ -2035,7 +2060,7 @@ class="cmtt-10">myDoc.tex</span>):  <br />\printnoidxglossaries % iterate over all indexed entries  <br />\end{document} </div> - <!--l. 1016--><p class="nopar" > Document build: + <!--l. 1044--><p class="nopar" > Document build: @@ -2044,28 +2069,25 @@ class="cmtt-10">myDoc.tex</span>): pdflatex myDoc  <br />pdflatex myDoc </div> - <!--l. 1021--><p class="nopar" > + <!--l. 1049--><p class="nopar" > </p></dd><dt class="description"> </dt><dd class="description"><a id="option2"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 2</span>: - <!--l. 1025--><p class="noindent" >This option uses an application called <span + <!--l. 1053--><p class="noindent" >This option uses an application called <span class="cmtt-10">makeindex</span><a id="dx1-5012"></a> to sort the entries. This - application comes with all modern <span class="TEX">T<span -class="E">E</span>X</span> distributions, but it’s hard-coded for - the non-extended Latin alphabet. This process involves making <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> write + application comes with all modern TeX distributions, but it’s hard-coded for + the non-extended Latin alphabet. This process involves making LaTeX write the glossary information to a temporary file which <span class="cmtt-10">makeindex</span><a id="dx1-5013"></a> reads. Then <span class="cmtt-10">makeindex</span><a id="dx1-5014"></a> writes a new file containing the code to typeset the - glossary. <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> then reads this file on the next run. The <span + glossary. LaTeX then reads this file on the next run. The <span class="cmtt-10">makeindex</span><a id="dx1-5015"></a> application is automatically invoked by the helper <span @@ -2092,7 +2114,7 @@ class="cmtt-10">\GlsSetQuote </span>to change this to some other character. <div class="verbatim" id="verbatim-43"> \GlsSetQuote{+} </div> - <!--l. 1044--><p class="nopar" > Use this as soon as possible after you’ve loaded the <span + <!--l. 1072--><p class="nopar" > Use this as soon as possible after you’ve loaded the <span class="cmss-10">glossaries</span> package. </p></li> @@ -2103,21 +2125,21 @@ class="cmtt-10">\makeglossaries </span>to your preamble (before you start defini </li> <li class="enumerate" id="x1-5025x3">Put - <!--l. 1053--><p class="noindent" ><hr><div title="Definition"><span + <!--l. 1081--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printglossary[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> - </p><!--l. 1054--><p class="noindent" > + </p><!--l. 1082--><p class="noindent" > where you want your list of entries (glossary) to appear. (The <span class="cmtt-10">sort </span>key isn’t available in ⟨<span class="cmti-10">options</span>⟩.) Alternatively, use - </p><!--l. 1059--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 1087--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printglossaries </span></div><hr> - </p><!--l. 1060--><p class="noindent" > + </p><!--l. 1088--><p class="noindent" > which will display all glossaries (if you have more than one). This command doesn’t have any arguments. - </p><!--l. 1064--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified + </p><!--l. 1092--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified with one of the package options: <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span @@ -2132,21 +2154,19 @@ class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a id="dx1-5028"></a>. </div> - </p><!--l. 1069--><p class="noindent" > + </p><!--l. 1097--><p class="noindent" > </p></li> <li - class="enumerate" id="x1-5030x4">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document. This creates files with the extensions - <span -class="cmtt-10">.glo </span>and <span -class="cmtt-10">.ist </span>(for example, if your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document is called - <span -class="cmtt-10">myDoc.tex</span>, then you’ll have two extra files called <span -class="cmtt-10">myDoc.glo </span>and - <span -class="cmtt-10">myDoc.ist</span>). If you look at your document at this point, you won’t see the - glossary as it hasn’t been created yet. + class="enumerate" id="x1-5030x4">Run LaTeX on your document. This creates files with the extensions <span +class="cmtt-10">.glo</span> + and <span +class="cmtt-10">.ist </span>(for example, if your LaTeX document is called <span +class="cmtt-10">myDoc.tex</span>, then + you’ll have two extra files called <span +class="cmtt-10">myDoc.glo </span>and <span +class="cmtt-10">myDoc.ist</span>). If you look + at your document at this point, you won’t see the glossary as it hasn’t + been created yet. </li> <li class="enumerate" id="x1-5032x5">Run <span @@ -2163,12 +2183,11 @@ class="cmtt-10">.tex</span>) extension. If you have access to a terminal or a co <div class="verbatim" id="verbatim-44"> makeglossaries myDoc </div> - <!--l. 1085--><p class="nopar" > (Replace <span -class="cmtt-10">myDoc </span>with the base name of your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document file - without the <span -class="cmtt-10">.tex </span>extension. Avoid spaces in the file name.) If you don’t - have Perl installed use <span + <!--l. 1113--><p class="nopar" > (Replace <span +class="cmtt-10">myDoc </span>with the base name of your LaTeX document file without + the <span +class="cmtt-10">.tex </span>extension. Avoid spaces in the file name.) If you don’t have Perl + installed use <span class="cmtt-10">makeglossaries-lite</span><a id="dx1-5034"></a> instead: @@ -2178,18 +2197,17 @@ class="cmtt-10">makeglossaries-lite</span><a <div class="verbatim" id="verbatim-45"> makeglossaries-lite myDoc </div> - <!--l. 1092--><p class="nopar" > - </p><!--l. 1094--><p class="noindent" ><div class="important" title="Important Note"> Some beginners get confused by <span + <!--l. 1120--><p class="nopar" > + </p><!--l. 1122--><p class="noindent" ><div class="important" title="Important Note"> Some beginners get confused by <span class="cmtt-10">makeglossaries</span><a id="dx1-5035"></a> the application (run as a system command) and <span -class="cmtt-10">\makeglossaries </span>the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> command +class="cmtt-10">\makeglossaries </span>the LaTeX command which should be typed in the document preamble. These are two different concepts that happen to have similar looking names. </div> - </p><!--l. 1100--><p class="noindent" > - </p><!--l. 1102--><p class="noindent" >If you don’t know how to use the command prompt, then you can + </p><!--l. 1128--><p class="noindent" > + </p><!--l. 1130--><p class="noindent" >If you don’t know how to use the command prompt, then you can probably configure your text editor to add <span class="cmtt-10">makeglossaries</span><a id="dx1-5036"></a> (or @@ -2197,10 +2215,13 @@ class="cmtt-10">makeglossaries</span><a class="cmtt-10">makeglossaries-lite</span><a id="dx1-5037"></a>) as a build tool, but each editor has a different method of doing this, so I can’t give a general description. You will have - to check your editor’s manual. If you still have problems, try adding the - <span + to check your editor’s manual. (There are some guidelines in <a +href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating + makeglossaries or makeglossaries-lite or bib2gls into the document + build</a>.) If you still have problems, try adding the <span class="cmss-10">automake</span><a - id="dx1-5038"></a> package option: + id="dx1-5038"></a> package + option: @@ -2208,8 +2229,8 @@ class="cmss-10">automake</span><a <div class="verbatim" id="verbatim-46"> \usepackage[automake]{glossaries} </div> - <!--l. 1112--><p class="nopar" > - </p><!--l. 1114--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you + <!--l. 1144--><p class="nopar" > + </p><!--l. 1146--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you want letter ordering you need to add the <span class="cmss-10">order</span><span class="cmtt-10">=</span><span @@ -2223,13 +2244,12 @@ class="cmss-10">letter</span><a <div class="verbatim" id="verbatim-47"> \usepackage[order=letter]{glossaries} </div> - <!--l. 1119--><p class="nopar" > + <!--l. 1151--><p class="nopar" > </p></li> <li class="enumerate" id="x1-5041x6">Once you have successfully completed the previous step, you can now run - <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document again.</li></ol> - <!--l. 1124--><p class="noindent" >Here’s a complete document (<span + LaTeX on your document again.</li></ol> + <!--l. 1156--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): @@ -2246,7 +2266,7 @@ class="cmtt-10">myDoc.tex</span>):  <br />\printglossaries % input files created by makeindex  <br />\end{document} </div> - <!--l. 1140--><p class="nopar" > Document build: + <!--l. 1172--><p class="nopar" > Document build: @@ -2256,7 +2276,7 @@ class="cmtt-10">myDoc.tex</span>):  <br />makeglossaries myDoc  <br />pdflatex myDoc </div> - <!--l. 1146--><p class="nopar" > or + <!--l. 1178--><p class="nopar" > or @@ -2266,36 +2286,32 @@ class="cmtt-10">myDoc.tex</span>):  <br />makeglossaries-lite myDoc  <br />pdflatex myDoc </div> - <!--l. 1152--><p class="nopar" > + <!--l. 1184--><p class="nopar" > </p></dd><dt class="description"> </dt><dd class="description"><a id="option3"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 3</span>: - <!--l. 1157--><p class="noindent" >This option uses an application called <span + <!--l. 1189--><p class="noindent" >This option uses an application called <span class="cmtt-10">xindy</span><a id="dx1-5042"></a> to sort the entries. This application is more flexible than <span class="cmtt-10">makeindex</span><a id="dx1-5043"></a> and is able to sort extended Latin - or non-Latin alphabets. It comes with both <span class="TEX">T<span -class="E">E</span>X</span> Live and MiK<span class="TEX">T<span -class="E">E</span>X</span>. + or non-Latin alphabets. It comes with both TeX Live and MiKTeX. Since <span class="cmtt-10">xindy</span><a id="dx1-5044"></a> is a Perl script, you will also need to ensure that Perl is installed. In a similar way to <a href="#option2">Option 2</a>, this option involves making - <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> write the glossary information to a temporary file which <span + LaTeX write the glossary information to a temporary file which <span class="cmtt-10">xindy</span><a id="dx1-5045"></a> reads. Then <span class="cmtt-10">xindy</span><a id="dx1-5046"></a> writes a new file containing the code to typeset - the glossary. <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> then reads this file on the next run. The <span + the glossary. LaTeX then reads this file on the next run. The <span class="cmtt-10">xindy</span><a id="dx1-5047"></a> application is automatically invoked by the helper <span @@ -2317,7 +2333,7 @@ class="cmss-10">glossaries</span><a <div class="verbatim" id="verbatim-51"> \usepackage[xindy]{glossaries} </div> - <!--l. 1176--><p class="nopar" > + <!--l. 1208--><p class="nopar" > </p></li> <li class="enumerate" id="x1-5054x2">Add <span @@ -2326,19 +2342,19 @@ class="cmtt-10">\makeglossaries </span>to your preamble (before you start defini </li> <li class="enumerate" id="x1-5056x3">Put - <!--l. 1183--><p class="noindent" ><hr><div title="Definition"><span + <!--l. 1215--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printglossary[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> - </p><!--l. 1184--><p class="noindent" > + </p><!--l. 1216--><p class="noindent" > where you want your list of entries (glossary) to appear. (The <span class="cmtt-10">sort </span>key isn’t available in ⟨<span class="cmti-10">options</span>⟩.) Alternatively, use - </p><!--l. 1189--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 1221--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printglossaries </span></div><hr> - </p><!--l. 1190--><p class="noindent" > - </p><!--l. 1192--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified + </p><!--l. 1222--><p class="noindent" > + </p><!--l. 1224--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified with one of the package options: <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span @@ -2353,21 +2369,19 @@ class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a id="dx1-5059"></a>. </div> - </p><!--l. 1197--><p class="noindent" > + </p><!--l. 1229--><p class="noindent" > </p></li> <li - class="enumerate" id="x1-5061x4">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document. This creates files with the extensions - <span -class="cmtt-10">.glo </span>and <span -class="cmtt-10">.xdy </span>(for example, if your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document is called - <span -class="cmtt-10">myDoc.tex</span>, then you’ll have two extra files called <span -class="cmtt-10">myDoc.glo </span>and - <span -class="cmtt-10">myDoc.xdy</span>). If you look at your document at this point, you won’t see the - glossary as it hasn’t been created yet. + class="enumerate" id="x1-5061x4">Run LaTeX on your document. This creates files with the extensions <span +class="cmtt-10">.glo</span> + and <span +class="cmtt-10">.xdy </span>(for example, if your LaTeX document is called <span +class="cmtt-10">myDoc.tex</span>, then + you’ll have two extra files called <span +class="cmtt-10">myDoc.glo </span>and <span +class="cmtt-10">myDoc.xdy</span>). If you look + at your document at this point, you won’t see the glossary as it hasn’t + been created yet. </li> <li class="enumerate" id="x1-5063x5">Run <span @@ -2384,17 +2398,16 @@ class="cmtt-10">.tex </span>extension). If you have access to a terminal or a co <div class="verbatim" id="verbatim-52"> makeglossaries myDoc </div> - <!--l. 1213--><p class="nopar" > (Replace <span -class="cmtt-10">myDoc </span>with the base name of your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document file - without the <span -class="cmtt-10">.tex </span>extension. Avoid spaces in the file name. If you don’t - know how to use the command prompt, then as mentioned above, you may - be able to configure your text editor to add <span + <!--l. 1245--><p class="nopar" > (Replace <span +class="cmtt-10">myDoc </span>with the base name of your LaTeX document file without + the <span +class="cmtt-10">.tex </span>extension. Avoid spaces in the file name. If you don’t know how + to use the command prompt, then as mentioned above, you may be able to + configure your text editor to add <span class="cmtt-10">makeglossaries</span><a id="dx1-5065"></a> as a build tool. - </p><!--l. 1221--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you + </p><!--l. 1253--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you want letter ordering you need to add the <span class="cmtt-10">order=letter </span>package option: @@ -2405,14 +2418,13 @@ class="cmtt-10">order=letter </span>package <div class="verbatim" id="verbatim-53"> \usepackage[xindy,order=letter]{glossaries} </div> - <!--l. 1227--><p class="nopar" > + <!--l. 1259--><p class="nopar" > </p></li> <li class="enumerate" id="x1-5067x6">Once you have successfully completed the previous step, you can now run - <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document again. + LaTeX on your document again. </li></ol> - <!--l. 1233--><p class="noindent" >Here’s a complete document (<span + <!--l. 1265--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): @@ -2429,7 +2441,7 @@ class="cmtt-10">myDoc.tex</span>):  <br />\printglossaries % input files created by xindy  <br />\end{document} </div> - <!--l. 1249--><p class="nopar" > Document build: + <!--l. 1281--><p class="nopar" > Document build: @@ -2439,23 +2451,21 @@ class="cmtt-10">myDoc.tex</span>):  <br />makeglossaries myDoc  <br />pdflatex myDoc </div> - <!--l. 1255--><p class="nopar" > + <!--l. 1287--><p class="nopar" > </p></dd><dt class="description"> </dt><dd class="description"><a id="option4"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 4</span>: - <!--l. 1259--><p class="noindent" >This requires the extension package <span + <!--l. 1291--><p class="noindent" >This requires the extension package <span class="cmss-10">glossaries-extra</span><a id="dx1-5068"></a> and an application called <span class="cmtt-10">bib2gls</span><a id="dx1-5069"></a>. This application is able to sort extended Latin or non-Latin - alphabets. It comes with both <span class="TEX">T<span -class="E">E</span>X</span> Live and MiK<span class="TEX">T<span -class="E">E</span>X</span> but requires at least - Java 7. This method works differently to Options <a + alphabets. It comes with both TeX Live and MiKTeX but requires at least + Java 8. This method works differently to Options <a href="#option2">2</a> and <a href="#option3">3</a>. Instead of creating a file containing the code to typeset the glossary it creates a @@ -2482,17 +2492,17 @@ class="cmss-10">glossaries-extra</span><a <div class="verbatim" id="verbatim-56"> \usepackage[record]{glossaries-extra} </div> - <!--l. 1278--><p class="nopar" > + <!--l. 1310--><p class="nopar" > </p></li> <li class="enumerate" id="x1-5075x2">Add one or more - <!--l. 1282--><p class="noindent" ><hr><div title="Definition"><span + <!--l. 1314--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\GlsXtrLoadResources[src={</span>⟨<span class="cmitt-10">bib list</span>⟩<span class="cmtt-10">},</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> - </p><!--l. 1283--><p class="noindent" > + </p><!--l. 1315--><p class="noindent" > to your preamble where ⟨<span class="cmti-10">bib list</span>⟩ is the list of <span class="cmtt-10">.bib </span>files containing the @@ -2530,7 +2540,7 @@ class="cmtt-10">.bib </span>files containing the  <br />  sort={double}% double-precision sort  <br />] </div> - <!--l. 1315--><p class="nopar" > The last resource set assumes that the entries defined in the file + <!--l. 1347--><p class="nopar" > The last resource set assumes that the entries defined in the file <span class="cmtt-10">constants.bib </span>have a number stored in the <span class="cmtt-10">user1 </span>field. For @@ -2546,37 +2556,36 @@ class="cmtt-10">user1 </span>field. For  <br />  user1={3.141592654}  <br />} </div> - <!--l. 1325--><p class="nopar" > + <!--l. 1357--><p class="nopar" > </p></li> <li class="enumerate" id="x1-5077x3">Put - <!--l. 1329--><p class="noindent" ><hr><div title="Definition"><span + <!--l. 1361--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printunsrtglossary[type={</span>⟨<span class="cmitt-10">type</span>⟩<span class="cmtt-10">},</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> - </p><!--l. 1330--><p class="noindent" > + </p><!--l. 1362--><p class="noindent" > where you want your list of entries (glossary) to appear. (The <span class="cmtt-10">sort </span>key isn’t available in ⟨<span class="cmti-10">options</span>⟩. It needs to be used in <span class="cmtt-10">\GlsXtrLoadResources</span> instead.) Alternatively, use - </p><!--l. 1336--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 1368--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\printunsrtglossaries </span></div><hr> - </p><!--l. 1337--><p class="noindent" > + </p><!--l. 1369--><p class="noindent" > </p></li> <li - class="enumerate" id="x1-5079x4">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> on your document. The <span + class="enumerate" id="x1-5079x4">Run LaTeX on your document. The <span class="cmss-10">record</span><a - id="dx1-5080"></a> option adds information to - the <span + id="dx1-5080"></a> option adds information to the + <span class="cmtt-10">.aux </span>file that provides <span class="cmtt-10">bib2gls</span><a - id="dx1-5081"></a> with all required details for each - resource set. For example, if the file is called <span + id="dx1-5081"></a> with all required details for each resource + set. For example, if the file is called <span class="cmtt-10">myDoc.tex</span>: @@ -2584,7 +2593,7 @@ class="cmtt-10">myDoc.tex</span>: <div class="verbatim" id="verbatim-59"> pdflatex myDoc </div> - <!--l. 1345--><p class="nopar" > + <!--l. 1377--><p class="nopar" > </p></li> <li class="enumerate" id="x1-5083x5">Run <span @@ -2596,7 +2605,7 @@ class="cmtt-10">bib2gls</span><a <div class="verbatim" id="verbatim-60"> bib2gls myDoc </div> - <!--l. 1350--><p class="nopar" > or (if you need letter groups) + <!--l. 1382--><p class="nopar" > or (if you need letter groups) @@ -2604,12 +2613,11 @@ class="cmtt-10">bib2gls</span><a <div class="verbatim" id="verbatim-61"> bib2gls --group myDoc </div> - <!--l. 1354--><p class="nopar" > + <!--l. 1386--><p class="nopar" > </p></li> <li - class="enumerate" id="x1-5086x6">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> again.</li></ol> - <!--l. 1358--><p class="noindent" >Here’s a complete document (<span + class="enumerate" id="x1-5086x6">Run LaTeX again.</li></ol> + <!--l. 1390--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): @@ -2630,7 +2638,7 @@ class="cmtt-10">myDoc.tex</span>):  <br />\printunsrtglossaries % iterate over all defined entries  <br />\end{document} </div> - <!--l. 1378--><p class="nopar" > The accompanying <span + <!--l. 1410--><p class="nopar" > The accompanying <span class="cmtt-10">entries.bib </span>file: @@ -2642,7 +2650,7 @@ class="cmtt-10">entries.bib </span>file:  <br />  description = {an example}  <br />} </div> - <!--l. 1385--><p class="nopar" > Document build: + <!--l. 1417--><p class="nopar" > Document build: @@ -2652,10 +2660,10 @@ class="cmtt-10">entries.bib </span>file:  <br />bib2gls myDoc  <br />pdflatex myDoc </div> - <!--l. 1391--><p class="nopar" > + <!--l. 1423--><p class="nopar" > </p> </dd></dl> -<!--l. 1395--><p class="indent" > If you are having difficulty integrating <span +<!--l. 1427--><p class="indent" > If you are having difficulty integrating <span class="cmtt-10">makeglossaries</span><a id="dx1-5087"></a> into your document build process, you may want to consider using <span @@ -2678,7 +2686,7 @@ class="cmtt-10">myDoc.tex </span>might start with:  <br /> \usepackage{glossaries}  <br /> \makeglossaries </div> -<!--l. 1408--><p class="nopar" > then to build the document you just need the single system call: +<!--l. 1440--><p class="nopar" > then to build the document you just need the single system call: @@ -2686,20 +2694,17 @@ class="cmtt-10">myDoc.tex </span>might start with: <div class="verbatim" id="verbatim-66">  arara myDoc </div> -<!--l. 1412--><p class="nopar" > (The currently pending version 4.0 of <span +<!--l. 1444--><p class="nopar" > (As from version 4.0, <span class="cmtt-10">arara</span><a - id="dx1-5090"></a> has directives for <span + id="dx1-5090"></a> also has directives for <span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-5091"></a> -and <span + id="dx1-5091"></a> and +<span class="cmtt-10">bib2gls</span><a - id="dx1-5092"></a>. These aren’t available in earlier versions, but you could try copying -and adapting the <span -class="cmtt-10">makeglossaries.yaml </span>file and replace <span -class="cmtt-10">makeglossaries</span><a - id="dx1-5093"></a> as -appropriate.) -</p><!--l. 1419--><p class="indent" > When sorting the entries, the string comparisons are made according to each + id="dx1-5092"></a>. See the <span +class="cmtt-10">arara</span><a + id="dx1-5093"></a> manual for further details.) +</p><!--l. 1449--><p class="indent" > When sorting the entries, the string comparisons are made according to each entry’s <span class="cmtt-10">sort </span>key. If this is omitted, the <span class="cmtt-10">name </span>key is used. For example, recall the @@ -2715,7 +2720,7 @@ earlier definition:  <br />   description={select group or class}  <br /> } </div> -<!--l. 1429--><p class="nopar" > No <span +<!--l. 1459--><p class="nopar" > No <span class="cmtt-10">sort </span>key was used, so it’s set to the same as the <span class="cmtt-10">name </span>key: <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{\’e}lite</span></span></span>. How this @@ -2769,10 +2774,9 @@ class="cmbx-10"> 3</span></a><span class="cmbx-10">:</span> </dt><dd class="description"><span class="cmtt-10">xindy</span><a - id="dx1-5096"></a> disregards <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> commands so it sorts on <span -class="cmtt-10">elite</span>, which puts - this entry in the “E” group. If stripping all commands leads to an empty string + id="dx1-5096"></a> disregards LaTeX commands so it sorts on <span +class="cmtt-10">elite</span>, which puts this + entry in the “E” group. If stripping all commands leads to an empty string (such as <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ensuremath{\emptyset}</span></span></span>) then <span class="cmtt-10">xindy</span><a @@ -2782,7 +2786,7 @@ class="cmtt-10">sort </span>value that <span class="cmtt-10">xindy</span><a id="dx1-5098"></a> will accept. - <!--l. 1455--><p class="noindent" ><div class="important" title="Important Note"> <span + <!--l. 1485--><p class="noindent" ><div class="important" title="Important Note"> <span class="cmtt-10">xindy</span><a id="dx1-5099"></a> merges entries with duplicate sort values. <span class="cmtt-10">xindy</span><a @@ -2791,7 +2795,7 @@ class="cmtt-10">xindy</span><a class="cmtt-10">xindy</span><a id="dx1-5101"></a> has stripped all commands and braces. </div> - </p><!--l. 1460--><p class="noindent" > + </p><!--l. 1490--><p class="noindent" > </p></dd><dt class="description"> <a href="#option4"><span @@ -2800,8 +2804,7 @@ class="cmbx-10"> 4</span></a><span class="cmbx-10">:</span> </dt><dd class="description"><span class="cmtt-10">bib2gls</span><a - id="dx1-5102"></a> has a primitive <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> parser that recognises a limited set of + id="dx1-5102"></a> has a primitive LaTeX parser that recognises a limited set of commands, which includes the standard accent commands and some maths commands, so it can convert <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{\’e}lite</span></span></span> to <span @@ -2811,7 +2814,7 @@ class="cmtt-10">lite</span>. It disregards unknown class="cmtt-10">bib2gls</span><a id="dx1-5103"></a> doesn’t mind that. - <!--l. 1469--><p class="noindent" >Note that even if the name is given as <span class="obeylines-h"><span class="verb"><span + <!--l. 1499--><p class="noindent" >Note that even if the name is given as <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{\’e}lite</span></span></span>, the letter group heading (if the <span class="obeylines-h"><span class="verb"><span class="cmtt-10">--group</span></span></span> switch is used) may end up with the character É @@ -2822,14 +2825,18 @@ class="cmtt-10">--group</span></span></span> switch is used) may end up with the will need to ensure the document can support this character either with <span class="cmss-10">inputenc</span><a - id="dx1-5104"></a> or by switching to a <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> engine with native UTF-8 + id="dx1-5104"></a> or by switching to a LaTeX engine with native UTF-8 support. + </p><!--l. 1506--><p class="noindent" >There’s more information on how <span +class="cmtt-10">bib2gls</span><a + id="dx1-5105"></a> obtains the sort value in <a +href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" >bib2gls + gallery: sorting</a>. </p> </dd></dl> -<!--l. 1479--><p class="indent" > If the <span +<!--l. 1513--><p class="indent" > If the <span class="cmss-10">inputenc</span><a - id="dx1-5105"></a> package is used: + id="dx1-5106"></a> package is used: @@ -2837,7 +2844,7 @@ class="cmss-10">inputenc</span><a <div class="verbatim" id="verbatim-68">  \usepackage[utf8]{inputenc} </div> -<!--l. 1482--><p class="nopar" > and the entry is defined as: </p><div class="alltt"> +<!--l. 1516--><p class="nopar" > and the entry is defined as: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10"> </span><span class="verb"><span @@ -2877,7 +2884,7 @@ class="cmtt-10">elite </span>so the entry class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-5106"></a> package + id="dx1-5107"></a> package option, the sort value will be interpreted as <span class="cmtt-10">é</span><span class="cmtt-10">lite </span>where é has been @@ -2892,7 +2899,7 @@ class="cmbx-10"> 2</span></a><span class="cmbx-10">:</span> </dt><dd class="description"><span class="cmtt-10">makeindex</span><a - id="dx1-5107"></a> sees <span + id="dx1-5108"></a> sees <span class="cmtt-10">é</span> as two octets (0xC3 0xA9) rather than a single character so it tries to put <span class="cmtt-10">é</span><span @@ -2906,7 +2913,7 @@ class="cmbx-10"> 3</span></a><span class="cmbx-10">:</span> </dt><dd class="description"><span class="cmtt-10">xindy</span><a - id="dx1-5108"></a> will correctly recognise the sort value <span + id="dx1-5109"></a> will correctly recognise the sort value <span class="cmtt-10">é</span><span class="cmtt-10">lite </span>and will place it in whatever letter group is appropriate for the given language setting. @@ -2920,16 +2927,16 @@ class="cmbx-10"> 4</span></a><span class="cmbx-10">:</span> </dt><dd class="description">The <span class="cmss-10">inputenc</span><a - id="dx1-5109"></a> package doesn’t affect the encoding used with <span + id="dx1-5110"></a> package doesn’t affect the encoding used with <span class="cmtt-10">.bib </span>entry definitions, since these are dependent on the encoding used to save the <span class="cmtt-10">.bib </span>file - (although the labels must still be ASCII). You can help <span + (although the labels must still be ASCII unless you use XeLaTeX/LuaLaTeX). + You can help <span class="cmtt-10">bib2gls</span><a - id="dx1-5110"></a> (and - JabRef) by putting an encoding comment at the start of the <span -class="cmtt-10">.bib </span>file: - <div class="alltt"> + id="dx1-5111"></a> (and JabRef) by putting an encoding comment at the + start of the <span +class="cmtt-10">.bib </span>file: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">%</span><span @@ -2940,9 +2947,9 @@ class="cmtt-10"> UTF-8</span> </div> </div> - <!--l. 1522--><p class="noindent" >With the correct encoding set up, <span + <!--l. 1556--><p class="noindent" >With the correct encoding set up, <span class="cmtt-10">bib2gls</span><a - id="dx1-5111"></a> will determine that the sort value is + id="dx1-5112"></a> will determine that the sort value is <span class="cmtt-10">é</span><span class="cmtt-10">lite </span>and will place it in whatever letter group is appropriate for the given @@ -2955,21 +2962,21 @@ class="cmtt-10">lite </span>in the group. </p> </dd></dl> -<!--l. 1531--><p class="indent" > Therefore if you have extended Latin or non-Latin characters, your best option is +<!--l. 1565--><p class="indent" > Therefore if you have extended Latin or non-Latin characters, your best option is to use either <span class="cmtt-10">xindy</span><a - id="dx1-5112"></a> (<a + id="dx1-5113"></a> (<a href="#option3">Option 3</a>) or <span class="cmtt-10">bib2gls</span><a - id="dx1-5113"></a> (<a + id="dx1-5114"></a> (<a href="#option4">Option 4</a>) with the <span class="cmss-10">inputenc</span><a - id="dx1-5114"></a> or <span + id="dx1-5115"></a> or <span class="cmss-10">fontspec</span><a - id="dx1-5115"></a> + id="dx1-5116"></a> package. If you use <span class="cmtt-10">makeindex</span><a - id="dx1-5116"></a> (<a + id="dx1-5117"></a> (<a href="#option2">Option 2</a>) you need to specify the <span class="cmtt-10">sort </span>key like this: @@ -2985,7 +2992,7 @@ this:  <br />  description={select group or class}  <br />} </div> -<!--l. 1543--><p class="nopar" > or </p><div class="alltt"> +<!--l. 1577--><p class="nopar" > or </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry</span><span @@ -3029,7 +3036,7 @@ need to be careful about fragile commands in the <span class="cmtt-10">name </span>key if you don’t set the <span class="cmtt-10">sort</span> key. -<!--l. 1557--><p class="indent" > If you use <a +<!--l. 1591--><p class="indent" > If you use <a href="#option3">Option 3</a> and the <span class="cmtt-10">name </span>only contains a command or commands (such as <span @@ -3048,12 +3055,12 @@ example:  \newglossaryentry{P}{name={\P},sort={P},  <br />  description={paragraph symbol}} </div> -<!--l. 1564--><p class="nopar" > +<!--l. 1598--><p class="nopar" > </p> -<!--l. 1566--><p class="noindent" ><a +<!--l. 1600--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5 </span> <a id="sec:glosstyle"></a>Customising the Glossary</h3> -<!--l. 1569--><p class="noindent" >The default glossary style uses the <span +<!--l. 1603--><p class="noindent" >The default glossary style uses the <span class="cmss-10">description</span><a id="dx1-6001"></a><a id="dx1-6002"></a> environment to display the entry list. @@ -3069,14 +3076,14 @@ class="cmtt-10">\glsnamefont</span>: <div class="verbatim" id="verbatim-71"> \renewcommand*{\glsnamefont}[1]{\textmd{#1}} </div> -<!--l. 1576--><p class="nopar" > Some classes and packages redefine the <span +<!--l. 1610--><p class="nopar" > Some classes and packages redefine the <span class="cmss-10">description</span><a id="dx1-6003"></a><a id="dx1-6004"></a> environment in such as way that’s incompatible with the <span class="cmss-10">glossaries </span>package. In which case you’ll need to select a different glossary style (see below). -</p><!--l. 1582--><p class="indent" > By default, a full stop is appended to the description (unless you use +</p><!--l. 1616--><p class="indent" > By default, a full stop is appended to the description (unless you use <span class="cmss-10">glossaries-extra</span><a id="dx1-6005"></a>). To prevent this from happening use the <span @@ -3090,7 +3097,7 @@ option: <div class="verbatim" id="verbatim-72"> \usepackage[nopostdot]{glossaries} </div> -<!--l. 1587--><p class="nopar" > or to add it with <span +<!--l. 1621--><p class="nopar" > or to add it with <span class="cmss-10">glossaries-extra</span>: @@ -3099,8 +3106,8 @@ class="cmss-10">glossaries-extra</span>: <div class="verbatim" id="verbatim-73"> \usepackage[postdot]{glossaries-extra} </div> -<!--l. 1591--><p class="nopar" > -</p><!--l. 1593--><p class="indent" > By default, a location list is displayed for each entry (unless you use +<!--l. 1625--><p class="nopar" > +</p><!--l. 1627--><p class="indent" > By default, a location list is displayed for each entry (unless you use <span class="cmtt-10">\printunsrtglossary </span>without <span class="cmtt-10">bib2gls</span><a @@ -3110,7 +3117,7 @@ Options <a href="#option2">2</a> or <a href="#option3">3</a> described in <a href="#sec:printglossaries"><span -class="cmsy-10">§</span>4 </a><a +class="tcrm-1000">§</span>4 </a><a href="#sec:printglossaries">Displaying a List of Entries<!--tex4ht:ref: sec:printglossaries --></a> or <a href="#option4">Option 4</a> (with <span @@ -3135,19 +3142,20 @@ option: <div class="verbatim" id="verbatim-74"> \usepackage[nonumberlist]{glossaries} </div> -<!--l. 1605--><p class="nopar" > or with <span +<!--l. 1639--><p class="nopar" > or with <span class="cmtt-10">bib2gls</span><a id="dx1-6011"></a> use <span class="cmtt-10">save-locations=false </span>in the optional argument of the appropriate <span class="cmtt-10">\GlsXtrLoadResources </span>(it’s possible to have some resource sets with locations and some without). -</p><!--l. 1611--><p class="indent" > Entries are grouped according to the first letter of each entry’s <span -class="cmtt-10">sort </span>key. By -default a vertical gap is placed between letter groups. You can suppress this with the -<span +</p><!--l. 1645--><p class="indent" > Entries are grouped according to the first letter of each entry’s <span +class="cmtt-10">sort</span> +key. By default a vertical gap is placed between letter groups for most of +the predefined styles. You can suppress this with the <span class="cmss-10">nogroupskip</span><a - id="dx1-6012"></a> package option: + id="dx1-6012"></a> package +option: @@ -3155,14 +3163,14 @@ class="cmss-10">nogroupskip</span><a <div class="verbatim" id="verbatim-75"> \usepackage[nogroupskip]{glossaries} </div> -<!--l. 1617--><p class="nopar" > -</p><!--l. 1619--><p class="indent" > If the default style doesn’t suit your document, you can change the style +<!--l. 1651--><p class="nopar" > +</p><!--l. 1653--><p class="indent" > If the default style doesn’t suit your document, you can change the style using: -</p><!--l. 1622--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 1656--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\setglossarystyle{</span>⟨<span class="cmitt-10">style name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 1623--><p class="noindent" > +</p><!--l. 1657--><p class="noindent" > <a href="http://www.dickimaw-books.com/gallery/glossaries-styles/" >There are a number of predefined styles.</a> Glossaries can vary from a list of symbols with a terse description to a list of words or phrases with descriptions that span @@ -3175,7 +3183,7 @@ a style that suits your document. For example: <div class="verbatim" id="verbatim-76"> \setglossarystyle{index} </div> -<!--l. 1631--><p class="nopar" > You can also use the <span +<!--l. 1665--><p class="nopar" > You can also use the <span class="cmss-10">style</span><a id="dx1-6013"></a> package option for the preloaded styles. For example: @@ -3185,8 +3193,8 @@ class="cmss-10">style</span><a <div class="verbatim" id="verbatim-77"> \usepackage[style=index]{glossaries} </div> -<!--l. 1636--><p class="nopar" > -</p><!--l. 1638--><p class="indent" > Examples: +<!--l. 1670--><p class="nopar" > +</p><!--l. 1672--><p class="indent" > Examples: </p><ol class="enumerate1" > <li class="enumerate" id="x1-6015x1">You have entries where the name is a symbol and the description is a brief @@ -3202,7 +3210,7 @@ class="cmss-10">glossary-mcols</span><a  <br />\usepackage{glossary-mcols}  <br />\setglossarystyle{mcolindex} </div> - <!--l. 1647--><p class="nopar" > or + <!--l. 1681--><p class="nopar" > or @@ -3210,7 +3218,7 @@ class="cmss-10">glossary-mcols</span><a <div class="verbatim" id="verbatim-79"> \usepackage[stylemods={mcols},style=mcolindex]{glossaries-extra} </div> - <!--l. 1651--><p class="nopar" > + <!--l. 1685--><p class="nopar" > </p></li> <li class="enumerate" id="x1-6018x2">You have entries where the name is a word or phrase and the description spans @@ -3222,7 +3230,7 @@ class="cmss-10">glossary-mcols</span><a \usepackage[nopostdot]{glossaries}  <br />\setglossarystyle{altlist} </div> - <!--l. 1659--><p class="nopar" > or + <!--l. 1693--><p class="nopar" > or @@ -3230,7 +3238,7 @@ class="cmss-10">glossary-mcols</span><a <div class="verbatim" id="verbatim-81"> \usepackage[stylemods,style=altlist]{glossaries-extra} </div> - <!--l. 1663--><p class="nopar" > + <!--l. 1697--><p class="nopar" > </p></li> <li class="enumerate" id="x1-6020x3">You have entries where the name is a single word, the description is @@ -3241,20 +3249,18 @@ class="cmss-10">glossary-mcols</span><a <div class="verbatim" id="verbatim-82"> - \usepackage[nopostdot,nonumberlist]{glossaries} -  <br />\setglossarystyle{long4col} + \usepackage[nopostdot,nonumberlist,style=long4col]{glossaries} </div> - <!--l. 1672--><p class="nopar" > or one of the “tree” styles: + <!--l. 1705--><p class="nopar" > or one of the “tree” styles: </p> <div class="verbatim" id="verbatim-83"> - \usepackage[nopostdot,nonumberlist]{glossaries} -  <br />\setglossarystyle{tree} + \usepackage[nopostdot,nonumberlist,style=tree]{glossaries} </div> - <!--l. 1677--><p class="nopar" ></p></li></ol> -<!--l. 1680--><p class="indent" > If your glossary consists of a list of abbreviations and you also want to specify + <!--l. 1709--><p class="nopar" ></p></li></ol> +<!--l. 1712--><p class="indent" > If your glossary consists of a list of abbreviations and you also want to specify a description as well as the long form, then you need to use an abbreviation style that will suit the glossary style. For example, use the <span class="cmtt-10">long-short-desc </span>acronym @@ -3266,7 +3272,7 @@ style: <div class="verbatim" id="verbatim-84"> \setacronymstyle{long-short-desc} </div> -<!--l. 1686--><p class="nopar" > Define the acronyms with a description: +<!--l. 1718--><p class="nopar" > Define the acronyms with a description: @@ -3276,7 +3282,7 @@ style:  <br /> [description={statistical pattern recognition technique}]  <br /> {svm}{SVM}{support vector machine} </div> -<!--l. 1692--><p class="nopar" > Alternatively with <span +<!--l. 1724--><p class="nopar" > Alternatively with <span class="cmss-10">glossaries-extra</span><a id="dx1-6021"></a>: @@ -3289,8 +3295,8 @@ class="cmss-10">glossaries-extra</span><a  <br /> [description={statistical pattern recognition technique}]  <br /> {svm}{SVM}{support vector machine} </div> -<!--l. 1700--><p class="nopar" > -</p><!--l. 1702--><p class="indent" > Choose a glossary style that suits wide entry names. For example: +<!--l. 1732--><p class="nopar" > +</p><!--l. 1734--><p class="indent" > Choose a glossary style that suits wide entry names. For example: @@ -3298,25 +3304,25 @@ class="cmss-10">glossaries-extra</span><a <div class="verbatim" id="verbatim-87"> \setglossarystyle{altlist} </div> -<!--l. 1705--><p class="nopar" > -</p><!--l. 1707--><p class="noindent" > +<!--l. 1737--><p class="nopar" > +</p><!--l. 1739--><p class="noindent" > </p> -<!--l. 1707--><p class="noindent" ><a +<!--l. 1739--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6 </span> <a id="sec:multigloss"></a>Multiple Glossaries</h3> -<!--l. 1710--><p class="noindent" >The <span +<!--l. 1742--><p class="noindent" >The <span class="cmss-10">glossaries</span><a id="dx1-7001"></a> package predefines a default <span class="cmtt-10">main </span>glossary. When you define an entry (using one of the commands described in <a href="#sec:defterm"><span -class="cmsy-10">§</span>2 </a><a +class="tcrm-1000">§</span>2 </a><a href="#sec:defterm">Defining Terms<!--tex4ht:ref: sec:defterm --></a>), that entry is automatically assigned to the default glossary, unless you indicate otherwise using the <span class="cmtt-10">type </span>key. However you first need to make sure the desired glossary has been defined. This is done using: -</p><!--l. 1717--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 1749--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\newglossary[</span>⟨<span class="cmitt-10">glg</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -3328,7 +3334,7 @@ class="cmitt-10">glo</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">title</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 1718--><p class="noindent" > +</p><!--l. 1750--><p class="noindent" > The ⟨<span class="cmti-10">label</span>⟩ is a label that uniquely identifies this new glossary. As with other types of identifying labels, be careful not to use active characters in ⟨<span @@ -3344,7 +3350,7 @@ class="cmtt-10">makeindex</span><a class="cmtt-10">xindy</span><a id="dx1-7003"></a> (described in <a href="#sec:printglossaries"><span -class="cmsy-10">§</span>4 </a><a +class="tcrm-1000">§</span>4 </a><a href="#sec:printglossaries">Displaying a List of Entries<!--tex4ht:ref: sec:printglossaries --></a>). If you use <a href="#option1">Option 1</a> described above (or <span @@ -3354,26 +3360,27 @@ class="cmtt-10">\printunsrtglossaries</span>), then the ⟨<span class="cmti-10">glg</span>⟩, ⟨<span class="cmti-10">gls</span>⟩ and ⟨<span class="cmti-10">glo</span>⟩ -arguments are ignored, in which case you may prefer to use the starred version where -you don’t specify the extensions: -</p><!--l. 1732--><p class="indent" > <hr><div title="Definition"><span +arguments aren’t relevant, in which case you may prefer to use the starred version +where you don’t specify the extensions: +</p><!--l. 1764--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\newglossary*{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">title</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 1733--><p class="noindent" > -</p><!--l. 1735--><p class="indent" > In the case of Options <a +</p><!--l. 1765--><p class="noindent" > +</p><!--l. 1767--><p class="indent" > In the case of Options <a href="#option2">2</a> or <a href="#option3">3</a>, all glossary definitions must come before <span -class="cmtt-10">\makeglossaries</span>. (Entries definitions should come after <span +class="cmtt-10">\makeglossaries</span>. (<span +class="cmti-10">Entry </span>definitions should come after <span class="cmtt-10">\makeglossaries</span>.) In the case of <a href="#option4">Option 4</a>, all glossary definitions must come before any <span class="cmtt-10">\GlsXtrLoadResources</span> that requires them. -</p><!--l. 1740--><p class="indent" > Since it’s quite common for documents to have both a list of terms and a list of +</p><!--l. 1772--><p class="indent" > Since it’s quite common for documents to have both a list of terms and a list of abbreviations, the <span class="cmss-10">glossaries</span><a id="dx1-7005"></a> package provides the package option <span @@ -3389,7 +3396,7 @@ class="cmss-10">acronyms</span><a <div class="verbatim" id="verbatim-88"> \newglossary[alg]{acronym}{acr}{acn}{\acronymname} </div> -<!--l. 1746--><p class="nopar" > The option also changes the behaviour of <span +<!--l. 1778--><p class="nopar" > The option also changes the behaviour of <span class="cmtt-10">\newacronym </span>so that acronyms are automatically put in the list of acronyms instead of the main glossary. The <span @@ -3401,7 +3408,7 @@ class="cmss-10">abbreviations</span><a id="dx1-7009"></a> to create a list of abbreviations for <span class="cmtt-10">\newabbreviation</span>. -</p><!--l. 1754--><p class="indent" > There are some other package options for creating commonly used lists: <span +</p><!--l. 1786--><p class="indent" > There are some other package options for creating commonly used lists: <span class="cmss-10">symbols</span><a id="dx1-7010"></a> (lists of symbols), <span @@ -3415,7 +3422,7 @@ class="cmti-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>). -</p><!--l. 1759--><p class="indent" > For example, suppose you want a main glossary for terms, a list of acronyms and +</p><!--l. 1791--><p class="indent" > For example, suppose you want a main glossary for terms, a list of acronyms and a list of notation: @@ -3425,7 +3432,7 @@ a list of notation:  \usepackage[acronyms]{glossaries}  <br /> \newglossary[nlg]{notation}{not}{ntn}{Notation} </div> -<!--l. 1764--><p class="nopar" > After <span +<!--l. 1796--><p class="nopar" > After <span class="cmtt-10">\makeglossaries </span>(or <span class="cmtt-10">\makenoidxglossaries</span>) you can define the entries in the preamble. For example: @@ -3448,7 +3455,7 @@ the preamble. For example:  <br />   description={A set},  <br />   sort={S}} </div> -<!--l. 1783--><p class="nopar" > or if you don’t like using <span +<!--l. 1815--><p class="nopar" > or if you don’t like using <span class="cmtt-10">\ensuremath</span>: @@ -3463,34 +3470,34 @@ class="cmtt-10">\ensuremath</span>:  <br />   description={A set},  <br />   sort={S}} </div> -<!--l. 1793--><p class="nopar" > -</p><!--l. 1795--><p class="indent" > Each glossary is displayed using: -</p><!--l. 1797--><p class="indent" > <hr><div title="Definition"><span +<!--l. 1825--><p class="nopar" > +</p><!--l. 1827--><p class="indent" > Each glossary is displayed using: +</p><!--l. 1829--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\printnoidxglossary[type=</span>⟨<span class="cmitt-10">type</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 1798--><p class="noindent" > +</p><!--l. 1830--><p class="noindent" > (<a href="#option1">Option 1</a>) or -</p><!--l. 1801--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 1833--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\printglossary[type=</span>⟨<span class="cmitt-10">type</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 1802--><p class="noindent" > +</p><!--l. 1834--><p class="noindent" > (Options <a href="#option2">2</a> and <a href="#option3">3</a>). Where ⟨<span class="cmti-10">type</span>⟩ is the glossary label. If the type is omitted the default <span class="cmtt-10">main </span>glossary is assumed. -</p><!--l. 1806--><p class="indent" > If you’re using <span +</p><!--l. 1838--><p class="indent" > If you’re using <span class="cmtt-10">bib2gls</span><a id="dx1-7013"></a> then each glossary is displayed using: -</p><!--l. 1809--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 1841--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\printunsrtglossary[type=</span>⟨<span class="cmitt-10">type</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 1810--><p class="noindent" > +</p><!--l. 1842--><p class="noindent" > With this method you don’t use <span class="cmtt-10">\makeglossaries </span>or <span class="cmtt-10">\makenoidxglossaries</span>. @@ -3514,7 +3521,7 @@ Instead you can assign the entry type with the resource command. For example:  <br />  type={symbols}% put in symbols glossary  <br /> ] </div> -<!--l. 1829--><p class="nopar" > Later in the document: +<!--l. 1861--><p class="nopar" > Later in the document: @@ -3524,26 +3531,26 @@ Instead you can assign the entry type with the resource command. For example:  <br /> \printunsrtglossary[type=abbreviations]  <br /> \printunsrtglossary[type=symbols] </div> -<!--l. 1835--><p class="nopar" > -</p><!--l. 1837--><p class="indent" > There’s a convenient shortcut that will display all the defined glossaries +<!--l. 1867--><p class="nopar" > +</p><!--l. 1869--><p class="indent" > There’s a convenient shortcut that will display all the defined glossaries depending on the indexing method: -</p><!--l. 1840--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 1872--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\printnoidxglossaries </span></div><hr> -</p><!--l. 1841--><p class="noindent" > +</p><!--l. 1873--><p class="noindent" > (<a href="#option1">Option 1</a>) or -</p><!--l. 1844--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 1876--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\printglossaries </span></div><hr> -</p><!--l. 1845--><p class="noindent" > +</p><!--l. 1877--><p class="noindent" > (Options <a href="#option2">2</a> and <a href="#option3">3</a>) or (<span class="cmss-10">glossaries-extra</span><a id="dx1-7014"></a> only) -</p><!--l. 1848--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 1880--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\printunsrtglossaries </span></div><hr> -</p><!--l. 1849--><p class="noindent" > -</p><!--l. 1851--><p class="indent" > If you use <a +</p><!--l. 1881--><p class="noindent" > +</p><!--l. 1883--><p class="indent" > If you use <a href="#option1">Option 1</a>, you don’t need to do anything else. If you use Options <a href="#option2">2</a> or <a @@ -3551,19 +3558,23 @@ href="#option3">3</a> with the <span class="cmtt-10">makeglossaries</span><a id="dx1-7015"></a> Perl script or the <span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-7016"></a> Lua script, -you similarly don’t need to do anything else. If you use Options <a -href="#option2">2</a> or <a -href="#option3">3</a> without the -<span + id="dx1-7016"></a> Lua +script, you similarly don’t need to do anything else. If you use Options <a +href="#option2">2</a> +or <a +href="#option3">3</a> without the <span class="cmtt-10">makeglossaries</span><a - id="dx1-7017"></a> Perl script then you need to make sure you run <span + id="dx1-7017"></a> Perl script or <span +class="cmtt-10">makeglossaries-lite</span><a + id="dx1-7018"></a> +Lua script then you need to make sure you run <span class="cmtt-10">makeindex</span><a - id="dx1-7018"></a>/<span + id="dx1-7019"></a>/<span class="cmtt-10">xindy</span><a - id="dx1-7019"></a> + id="dx1-7020"></a> <span +class="cmti-10">for each</span> <span -class="cmti-10">for each defined glossary</span>. The ⟨<span +class="cmti-10">defined glossary</span>. The ⟨<span class="cmti-10">gls</span>⟩ and ⟨<span class="cmti-10">glo</span>⟩ arguments of <span class="cmtt-10">\newglossary </span>specify the file @@ -3574,11 +3585,11 @@ class="cmti-10">glg</span>⟩ is the file extension for the transcript file. This should be different for each glossary in case you need to check for <span class="cmtt-10">makeindex</span><a - id="dx1-7020"></a>/<span + id="dx1-7021"></a>/<span class="cmtt-10">xindy</span><a - id="dx1-7021"></a> errors or warnings if things go + id="dx1-7022"></a> errors or warnings if things go wrong. -</p><!--l. 1865--><p class="indent" > For example, suppose you have three glossaries in your document (<span +</p><!--l. 1898--><p class="indent" > For example, suppose you have three glossaries in your document (<span class="cmtt-10">main</span>, <span class="cmtt-10">acronym</span> and <span @@ -3591,25 +3602,24 @@ class="cmtt-10">notation</span>), specified using: \usepackage[acronyms]{glossaries}  <br />\newglossary[nlg]{notation}{not}{ntn}{Notation} </div> -<!--l. 1871--><p class="nopar" > Then (assuming your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> document is in a file called <span +<!--l. 1904--><p class="nopar" > Then (assuming your LaTeX document is in a file called <span class="cmtt-10">myDoc.tex</span>): -</p><!--l. 1875--><p class="indent" > +</p><!--l. 1908--><p class="indent" > </p><dl class="description"><dt class="description"> </dt><dd class="description"><a href="#option2">Option 2</a> Either use one <span class="cmtt-10">makeglossaries</span><a - id="dx1-7022"></a> or <span + id="dx1-7023"></a> or <span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-7023"></a> call: + id="dx1-7024"></a> call: <div class="verbatim" id="verbatim-95"> makeglossaries myDoc </div> - <!--l. 1881--><p class="nopar" > or + <!--l. 1914--><p class="nopar" > or @@ -3617,9 +3627,9 @@ class="cmtt-10">makeglossaries-lite</span><a <div class="verbatim" id="verbatim-96"> makeglossaries-lite myDoc </div> - <!--l. 1885--><p class="nopar" > Or you need to run <span + <!--l. 1918--><p class="nopar" > Or you need to run <span class="cmtt-10">makeindex</span><a - id="dx1-7024"></a> three times: + id="dx1-7025"></a> three times: @@ -3629,22 +3639,22 @@ class="cmtt-10">makeindex</span><a  <br />makeindex -t myDoc.alg -s myDoc.ist -o myDoc.acr myDoc.acn  <br />makeindex -t myDoc.nlg -s myDoc.ist -o myDoc.not myDoc.ntn </div> - <!--l. 1891--><p class="nopar" > + <!--l. 1924--><p class="nopar" > </p></dd><dt class="description"> </dt><dd class="description"><a href="#option3">Option 3</a> Either use one <span class="cmtt-10">makeglossaries</span><a - id="dx1-7025"></a> call: + id="dx1-7026"></a> call: <div class="verbatim" id="verbatim-98"> makeglossaries myDoc </div> - <!--l. 1897--><p class="nopar" > Or you need to run <span + <!--l. 1930--><p class="nopar" > Or you need to run <span class="cmtt-10">xindy</span><a - id="dx1-7026"></a> three times (be careful not to insert line breaks + id="dx1-7027"></a> three times (be careful not to insert line breaks where the line has wrapped.) @@ -3658,13 +3668,13 @@ class="cmtt-10">xindy</span><a  <br />xindy  -L english -C utf8 -I xindy -M myDoc -t myDoc.nlg  <br />-o myDoc.not myDoc.ntn </div> - <!--l. 1907--><p class="nopar" > + <!--l. 1940--><p class="nopar" > </p></dd><dt class="description"> </dt><dd class="description"><a href="#option4">Option 4</a> With <span class="cmtt-10">bib2gls</span><a - id="dx1-7027"></a> only one call is required: + id="dx1-7028"></a> only one call is required: @@ -3673,16 +3683,16 @@ class="cmtt-10">bib2gls</span><a  <br />bib2gls --group myDoc  <br />pdflatex myDoc </div> - <!--l. 1915--><p class="nopar" > (Omit <span class="obeylines-h"><span class="verb"><span + <!--l. 1948--><p class="nopar" > (Omit <span class="obeylines-h"><span class="verb"><span class="cmtt-10">--group</span></span></span> if you don’t need letter groups.)</p></dd></dl> -<!--l. 1920--><p class="noindent" > +<!--l. 1953--><p class="noindent" > </p> -<!--l. 1920--><p class="noindent" ><a +<!--l. 1953--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">7 </span> <a id="sec:hyperref"></a><span class="cmss-10">glossaries </span>and <span class="cmss-10">hyperref</span></h3> -<!--l. 1923--><p class="noindent" >Take care if you use the <span +<!--l. 1956--><p class="noindent" >Take care if you use the <span class="cmss-10">glossaries</span><a id="dx1-8001"></a> package with <span class="cmss-10">hyperref</span><a @@ -3706,25 +3716,23 @@ class="cmss-10">hyperref</span><a \usepackage[colorlinks]{hyperref}  <br />\usepackage{glossaries} </div> -<!--l. 1930--><p class="nopar" > If you use <span +<!--l. 1963--><p class="nopar" > If you use <span class="cmss-10">hyperref</span><a - id="dx1-8007"></a> make sure you use PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> rather than the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> to DVI + id="dx1-8007"></a> make sure you use PDFLaTeX rather than the LaTeX to DVI engine. The DVI format can’t break hyperlinks across a line so long glossary entries (such as the full form of acronyms) won’t line wrap with the DVI engine. Also, hyperlinks in sub- or superscripts aren’t correctly sized with the DVI format. -</p><!--l. 1937--><p class="indent" > By default, if the <span +</p><!--l. 1970--><p class="indent" > By default, if the <span class="cmss-10">hyperref</span><a id="dx1-8008"></a> package has been loaded, commands like <span class="cmtt-10">\gls </span>will form -a hyperlink to the relevant entry in the glossary. If you to disable this for <span -class="cmti-10">all </span>your -glossaries, then use -</p><!--l. 1942--><p class="indent" > <hr><div title="Definition"><span +a hyperlink to the relevant entry in the glossary. If you want to disable this for <span +class="cmti-10">all</span> +your glossaries, then use: +</p><!--l. 1975--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\glsdisablehyper </span></div><hr> -</p><!--l. 1943--><p class="noindent" > +</p><!--l. 1976--><p class="noindent" > If you want hyperlinks suppressed for entries in specific glossaries, then use the <span class="cmss-10">nohypertypes</span><a @@ -3743,8 +3751,8 @@ glossary, then do:  <br />\usepackage[acronym,nohypertypes={acronym,notation}]{glossaries}  <br />\newglossary[nlg]{notation}{not}{ntn}{Notation} </div> -<!--l. 1953--><p class="nopar" > -</p><!--l. 1955--><p class="indent" > If you want the hyperlinks suppressed the first time an entry is used, but you +<!--l. 1986--><p class="nopar" > +</p><!--l. 1988--><p class="indent" > If you want the hyperlinks suppressed the first time an entry is used, but you want hyperlinks for subsequence references then use the <span class="cmss-10">hyperfirst</span><span class="cmtt-10">=</span><span @@ -3759,11 +3767,16 @@ option: \usepackage[colorlinks]{hyperref}  <br />\usepackage[hyperfirst=false]{glossaries} </div> -<!--l. 1961--><p class="nopar" > -</p><!--l. 1963--><p class="indent" > Take care not to use non-expandable commands in PDF bookmarks. This isn’t +<!--l. 1994--><p class="nopar" > The <span +class="cmss-10">glossaries-extra</span><a + id="dx1-8011"></a> extension package provides another method using category +attributes. See the <span +class="cmss-10">glossaries-extra</span><a + id="dx1-8012"></a> user manual for further details. +</p><!--l. 1999--><p class="indent" > Take care not to use non-expandable commands in PDF bookmarks. This isn’t specific to the <span class="cmss-10">glossaries</span><a - id="dx1-8011"></a> package but is a limitation of PDF bookmarks. + id="dx1-8013"></a> package but is a limitation of PDF bookmarks. Non-expandable commands include commands like <span class="cmtt-10">\gls</span>, <span class="cmtt-10">\glspl</span>, <span @@ -3771,7 +3784,7 @@ class="cmtt-10">\Gls </span>and <span class="cmtt-10">\Glspl</span>. The <span class="cmss-10">hyperref</span><a - id="dx1-8012"></a> package provides a way of specifying alternative text for the PDF + id="dx1-8014"></a> package provides a way of specifying alternative text for the PDF bookmarks via <span class="cmtt-10">\texorpdfstring</span>. For example: @@ -3781,15 +3794,15 @@ class="cmtt-10">\texorpdfstring</span>. For example: <div class="verbatim" id="verbatim-104"> \section{The \texorpdfstring{\gls{fishage}}{Fish Age}} </div> -<!--l. 1971--><p class="nopar" > However, it’s not a good idea to use commands like <span +<!--l. 2007--><p class="nopar" > However, it’s not a good idea to use commands like <span class="cmtt-10">\gls </span>in a section heading as -you’ll end up with the table of contents in your location list. Instead you can +you’ll end up with the table of contents page in your location list. Instead you can use -</p><!--l. 1976--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 2012--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\glsentrytext{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 1977--><p class="noindent" > +</p><!--l. 2013--><p class="noindent" > This is expandable provided that the <span class="cmtt-10">text </span>key doesn’t contain non-expandable code. For example, the following works: @@ -3800,10 +3813,10 @@ For example, the following works: <div class="verbatim" id="verbatim-105"> \section{The \glsentrytext{fishage}} </div> -<!--l. 1982--><p class="nopar" > and it doesn’t put the table of contents in the location list. -</p><!--l. 1985--><p class="indent" > If you use <span +<!--l. 2018--><p class="nopar" > and it doesn’t put the table of contents in the location list. +</p><!--l. 2021--><p class="indent" > If you use <span class="cmss-10">glossaries-extra</span><a - id="dx1-8013"></a> then use the commands that are provided specifically for + id="dx1-8015"></a> then use the commands that are provided specifically for use in section headers. For example: @@ -3812,19 +3825,19 @@ use in section headers. For example: <div class="verbatim" id="verbatim-106"> \section{The \glsfmttext{fishage}} </div> -<!--l. 1989--><p class="nopar" > -</p><!--l. 1991--><p class="noindent" > +<!--l. 2025--><p class="nopar" > +</p><!--l. 2027--><p class="noindent" > </p> -<!--l. 1991--><p class="noindent" ><a +<!--l. 2027--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">8 </span> <a id="sec:xr"></a>Cross-References</h3> -<!--l. 1994--><p class="noindent" >You can add a reference to another entry in a location list using the <span +<!--l. 2030--><p class="noindent" >You can add a reference to another entry in a location list using the <span class="cmtt-10">see={</span>⟨<span class="cmti-10">label list</span>⟩<span class="cmtt-10">}</span> key when you define an entry. The referenced entry (or entries) must also be defined. -</p><!--l. 1998--><p class="indent" > For example: +</p><!--l. 2034--><p class="indent" > For example: @@ -3844,7 +3857,7 @@ defined.  <br />  see={devonian}  <br />} </div> -<!--l. 2015--><p class="nopar" > The cross-reference will appear as “<span +<!--l. 2051--><p class="nopar" > The cross-reference will appear as “<span class="cmti-10">see </span>Devonian”. You can change the “see” tag using the format <span class="cmtt-10">see=[</span>⟨<span @@ -3870,7 +3883,7 @@ class="cmti-10">label</span>⟩. For example:  <br />   other letters such as ligatures or diacritics.}  <br />} </div> -<!--l. 2033--><p class="nopar" > If you use the <span +<!--l. 2069--><p class="nopar" > If you use the <span class="cmtt-10">see </span>key in the optional argument of <span class="cmtt-10">\newacronym</span>, make sure you enclose the value in braces. For example: @@ -3884,7 +3897,7 @@ enclose the value in braces. For example:  <br /> [see={[see also]{ksvm}}]  <br /> {svm}{svm}{support vector machine} </div> -<!--l. 2042--><p class="nopar" > The <span +<!--l. 2078--><p class="nopar" > The <span class="cmss-10">glossaries-extra</span><a id="dx1-9001"></a> package provides a <span class="cmtt-10">seealso </span>key. This doesn’t allow a tag but @@ -3905,8 +3918,8 @@ class="cmsy-10">}</span>. For example:  <br /> [seealso={ksvm}]  <br /> {svm}{svm}{support vector machine} </div> -<!--l. 2051--><p class="nopar" > -</p><!--l. 2053--><p class="indent" > Since the cross-reference appears in the location list, if you suppress the +<!--l. 2087--><p class="nopar" > +</p><!--l. 2089--><p class="indent" > Since the cross-reference appears in the location list, if you suppress the location list using the <span class="cmss-10">nonumberlist</span><a id="dx1-9002"></a> package option, then the cross-reference @@ -3938,10 +3951,10 @@ example:  <br /> type={symbols}% put in symbols glossary  <br />] </div> -<!--l. 2075--><p class="nopar" > -</p><!--l. 2077--><p class="noindent" > +<!--l. 2111--><p class="nopar" > +</p><!--l. 2113--><p class="noindent" > </p> -<!--l. 2077--><p class="noindent" ><a +<!--l. 2113--><p class="noindent" ><a href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">9 </span> <a id="sec:moreinfo"></a>Further Information</h3> <ul class="itemize1"> @@ -3969,12 +3982,14 @@ class="cmss-10">glossaries-extra</span></a> package. <li class="itemize">The <a href="https://ctan.org/pkg/bib2gls" ><span class="cmtt-10">bib2gls</span></a> application.</li></ul> - <div class="footnotes"><!--l. 1038--><p class="noindent" ><span class="footnote-mark"><a +<!--l. 2128--><p class="noindent" >The <a +href="https://www.dickimaw-books.com/gallery" >Dickimaw Books Gallery</a> provides additional example documents. +</p><div class="footnotes"><!--l. 1066--><p class="noindent" ><span class="footnote-mark"><a href="#fn1x0-bk" id="fn1x0"><sup class="textsuperscript">1</sup></a></span><span class="cmr-8">deprecated, use </span><span class="cmss-8">babel</span><a id="dx1-5021"></a> <span -class="cmr-8">instead</span></p> </div> +class="cmr-8">instead</span></p> </div> </body></html> diff --git a/macros/latex/contrib/glossaries/glossariesbegin.pdf b/macros/latex/contrib/glossaries/glossariesbegin.pdf Binary files differindex bfdff9d737..b3fb491273 100644 --- a/macros/latex/contrib/glossaries/glossariesbegin.pdf +++ b/macros/latex/contrib/glossaries/glossariesbegin.pdf diff --git a/macros/latex/contrib/glossaries/glossariesbegin.tex b/macros/latex/contrib/glossaries/glossariesbegin.tex index e0793626a8..c84ff3074e 100644 --- a/macros/latex/contrib/glossaries/glossariesbegin.tex +++ b/macros/latex/contrib/glossaries/glossariesbegin.tex @@ -2,11 +2,15 @@ \usepackage[utf8]{inputenc} \ifpdf -\usepackage[T1]{fontenc} -\usepackage{mathpazo} -\usepackage[scaled=.88]{helvet} -\usepackage{courier} -\usepackage{xr-hyper} + \usepackage[T1]{fontenc} + \usepackage{mathpazo} + \usepackage[scaled=.88]{helvet} + \usepackage{courier} + \usepackage{metalogo} + \usepackage{xr-hyper} +\else + \providecommand{\XeLaTeX}{XeLaTeX} + \providecommand{\LuaLaTeX}{LuaLaTeX} \fi \usepackage{alltt} @@ -31,10 +35,10 @@ \texorpdfstring{{\frenchspacing\obeyspaces\ttfamily#1}}{#1}} \newcommand*{\file}[1]{\texorpdfstring{\texttt{#1}}{#1}} -\title{The glossaries package v4.45: +\title{The glossaries package v4.46: a guide for beginners} -\author{Nicola L.C. Talbot} -\date{2020-02-13} +\author{Nicola L.C. Talbot\\\href{https://www.dickimaw-books.com/}{\nolinkurl{dickimaw-books.com}}} +\date{2020-03-19} \ifpdf \externaldocument{glossaries-user} @@ -162,6 +166,10 @@ Abbreviations are slightly different if you use the extension package First use: \gls{svm}. Second use: \gls{svm}. \end{document} \end{verbatim} +Since \code{long-short} happens to be the default for +\cs{newabbreviation} (if you haven't set the \code{category} key) +you may omit the \cs{setabbreviationstyle} line in this example. + If you still want to use \cs{newacronym} (rather than \cs{newabbreviation}) then you need the optional argument of \cs{setabbreviationstyle}: @@ -178,6 +186,12 @@ argument of \cs{setabbreviationstyle}: First use: \gls{svm}. Second use: \gls{svm}. \end{document} \end{verbatim} +In this example, if you omit the \cs{setabbreviationstyle} line you +will notice a difference because the \code{short-nolong} style (not +the \code{long-short} style) is the default with \cs{newacronym}. +With the \code{short-nolong} style the first use simply shows just +the short form. + \begin{important} You can't use \cs{setacronymstyle} with \sty{glossaries-extra}. \end{important} @@ -288,11 +302,13 @@ label is used to uniquely identify the term (like the standard following alphanumerics in the labels: \code{a}, \ldots, \code{z}, \code{A}, \ldots, \code{Z}, \code{0}, \ldots, \code{9}. Sometimes you can also use punctuation characters but -not if another package (such as \sty{babel}) meddles with them. +not if another package (such as \sty{babel}) makes them active. Don't try using any characters outside of the basic Latin set with \sty{inputenc} (for example, \'e or \ss) or things will go horribly wrong. This warning only applies to the label. It doesn't apply to -the text that appears in the document. +the text that appears in the document. If you really need UTF-8 +characters in your labels then you'll need to use \XeLaTeX\ or +\LuaLaTeX. \begin{important} Don't use \cs{gls} in chapter or section headings as it can have @@ -300,7 +316,7 @@ some unpleasant side-effects. Instead use \cs{glsentrytext} for regular entries and one of \cs{glsentryshort}, \cs{glsentrylong} or \cs{glsentryfull} for acronyms. Alternatively use \sty{glossaries-extra} which provides special commands for use in -section headings, such as \cs{glsfmtshort}\marg{label}. +section headings and captions, such as \cs{glsfmtshort}\marg{label}. \end{important} The above examples are reasonably straightforward. The difficulty @@ -357,7 +373,9 @@ provides a fourth method: use \app{bib2gls} (\opt4). The first option (using \TeX) is the simplest method, as it doesn't require an external tool, but it's very inefficient and the sorting -is done according to the English alphabet. To use this method, add +is done according to lower case character code (which matches basic Latin +alphabets, such as English, but not extended Latin alphabets, such +as Icelandic). To use this method, add \cs{makenoidxglossaries} to the preamble and put \cs{printnoidxglossaries} at the place where you want your glossary. For example: @@ -390,7 +408,9 @@ For example: \begin{important} The \cs{makenoidxglossaries} method is very slow, uses an ASCII comparator and often breaks if there are commands in the -\code{name} key. +\code{name} key. See +\href{https://www.dickimaw-books.com/gallery/glossaries-performance.shtml}{Glossaries +Performance} for a comparison. \end{important} Try this out and run \LaTeX\ (or pdf\LaTeX) \emph{twice}. The first @@ -425,8 +445,8 @@ with the \pkgopt{nopostdot} package option: \usepackage[nopostdot]{glossaries} \end{verbatim} -If you tried out the previous example with \sty{glossaries-extra} -and \cs{printunsrtglossaries} the terminating full stop is missing +If you try out the earlier example with \sty{glossaries-extra} +and \cs{printunsrtglossaries} you may notice that the terminating full stop is missing and there are no number lists. You can add the full stop back with \begin{verbatim} \usepackage[nopostdot=false]{glossaries-extra} @@ -437,8 +457,7 @@ or \end{verbatim} If you want the number lists then you need to use an indexing option. - -You may have noticed that I've used another command in the above example: +You may have noticed that I've used another command in the above examples: \cs{glspl}. This displays the plural form. By default, this is just the singular form with the letter \qt{s} appended, but in the case of \qt{potato} I had to specify the correct plural using the @@ -561,7 +580,8 @@ or \verb|}| \end{alltt} \end{enumerate} -(For further details, see the section \qt{UTF-8} of the +(This isn't necessary for UTF-8 characters with \XeLaTeX\ or +\LuaLaTeX. For further details, see the section \qt{UTF-8} of the \href{https://ctan.org/pkg/mfirstuc}{\styfmt{mfirstuc}} user manual.) If you use \app{bib2gls} with \sty{glossaries-extra} then the @@ -611,7 +631,7 @@ then put the following line in the document preamble: You can have a comma-separated list. For example, if you also have entries defined in the file \file{entries2.bib}: \begin{verbatim} -\GlsXtrLoadResources[src={entries,entries2.bib}] +\GlsXtrLoadResources[src={entries,entries2}] \end{verbatim} There are other keys you can use when you define an entry. For @@ -658,7 +678,7 @@ key with an \qt{s} appended, but if this is incorrect, just use the (Remember from earlier that the initial ligature \cs{oe} needs to be grouped.) -Abbreviations can be defined using +Abbreviations can be defined using: \begin{definition} \cs{newacronym}\oarg{options}\marg{label}\marg{short}\marg{long} \end{definition} @@ -683,7 +703,7 @@ argument: \end{verbatim} Before you define your acronyms (or other types of abbreviations), you -need to specify which style to use with +need to specify which style to use with: \begin{definition} \cs{setacronymstyle}\marg{style name} \end{definition} @@ -846,6 +866,14 @@ unless you want a separate symbols list.) The corresponding document \end{document} \end{verbatim} +Note that while the \code{sort} key is advised for symbols when +using \cs{makeglossaries} or \cs{makenoidxglossaries} it shouldn't +be used with \app{bib2gls}. Instead, \app{bib2gls} has its own +algorithm for determining the sort value based on the entry type +(\code{@entry}, \code{@symbol} etc). See +\href{https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting}{bib2gls +gallery: sorting} for further details. + \section{Using Entries} \label{sec:useterm} @@ -960,7 +988,7 @@ disadvantages. (There's a more detailed summary in the main \item[]\optionlabel1: This is the simplest option but it's slow and if - you want a sorted list, it doesn't work for non-Latin alphabets. + you want a sorted list, it doesn't work for extended or non-Latin alphabets. The \code{name} mustn't contain commands (or, if it does, the \code{sort} value must be supplied) unless you have the package option \pkgopt{sanitizesort} or \pkgopt[def]{sort} @@ -1105,6 +1133,10 @@ similar looking names. as a build tool, but each editor has a different method of doing this, so I~can't give a~general description. You will have to check your editor's manual. + (There are some guidelines in +\href{https://www.dickimaw-books.com/latex/buildglossaries/}{Incorporating +makeglossaries or makeglossaries-lite or bib2gls into the document +build}.) If you still have problems, try adding the \pkgopt{automake} package option: \begin{verbatim} @@ -1259,7 +1291,7 @@ pdflatex myDoc This requires the extension package \sty{glossaries-extra} and an application called \app{bib2gls}. This application is able to sort extended Latin or non-Latin alphabets. It comes with both - \TeX~Live and MiK\TeX\ but requires at least Java~7. This method + \TeX~Live and MiK\TeX\ but requires at least Java~8. This method works differently to \optsand23. Instead of creating a file containing the code to typeset the glossary it creates a \file{.glstex} file containing the entry definitions fetched @@ -1410,11 +1442,9 @@ then to build the document you just need the single system call: \begin{verbatim} arara myDoc \end{verbatim} -(The currently pending version 4.0 of \app{arara} has -directives for \app{makeglossaries-lite} and \app{bib2gls}. -These aren't available in earlier versions, but you could try -copying and adapting the \file{makeglossaries.yaml} file and -replace \app{makeglossaries} as appropriate.) +(As from version 4.0, \app{arara} also has +directives for \app{makeglossaries-lite} and \app{bib2gls}. See the +\app{arara} manual for further details.) When sorting the entries, the string comparisons are made according to each entry's \code{sort} key. If this is omitted, the @@ -1473,8 +1503,12 @@ comparator. In this case you will need to ensure the document can support this character either with \sty{inputenc} or by switching to a \LaTeX\ engine with native UTF-8 support. -\end{description} +There's more information on how \app{bib2gls} obtains the sort value +in +\href{https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting}{bib2gls +gallery: sorting}. +\end{description} If the \sty{inputenc} package is used: \begin{verbatim} @@ -1513,7 +1547,7 @@ might put it in the \qt{\'E} letter group.) \item[\opt4:] The \sty{inputenc} package doesn't affect the encoding used with \file{.bib} entry definitions, since these are dependent on the encoding used to save the \file{.bib} file (although the -labels must still be ASCII). You can help \app{bib2gls} (and +labels must still be ASCII unless you use \XeLaTeX/\LuaLaTeX). You can help \app{bib2gls} (and JabRef) by putting an encoding comment at the start of the \file{.bib} file: \begin{alltt} \% Encoding: UTF-8 @@ -1610,7 +1644,7 @@ without). Entries are grouped according to the first letter of each entry's \code{sort} key. By default a~vertical gap is placed -between letter groups. You can suppress this with the +between letter groups for most of the predefined styles. You can suppress this with the \pkgopt{nogroupskip} package option: \begin{verbatim} \usepackage[nogroupskip]{glossaries} @@ -1667,13 +1701,11 @@ or Use one of the styles that display the symbol (not all of them do). For example, one of the tabular styles: \begin{verbatim} -\usepackage[nopostdot,nonumberlist]{glossaries} -\setglossarystyle{long4col} +\usepackage[nopostdot,nonumberlist,style=long4col]{glossaries} \end{verbatim} or one of the \qt{tree} styles: \begin{verbatim} -\usepackage[nopostdot,nonumberlist]{glossaries} -\setglossarystyle{tree} +\usepackage[nopostdot,nonumberlist,style=tree]{glossaries} \end{verbatim} \end{enumerate} @@ -1725,15 +1757,15 @@ indicate the file extensions used by \app{makeindex}\slash\app{xindy} (described in \sectionref{sec:printglossaries}). If you use \opt1 described above (or \app{bib2gls} and \cs{printunsrtglossaries}), -then the \meta{glg}, \meta{gls} and \meta{glo} arguments are -ignored, in which case you may prefer to use the starred version +then the \meta{glg}, \meta{gls} and \meta{glo} arguments aren't +relevant, in which case you may prefer to use the starred version where you don't specify the extensions: \begin{definition} \cs{newglossary*}\marg{label}\marg{title} \end{definition} In the case of \optsor23, all glossary definitions must come before -\cs{makeglossaries}. (Entries definitions should come after +\cs{makeglossaries}. (\emph{Entry} definitions should come after \cs{makeglossaries}.) In the case of \opt4, all glossary definitions must come before any \cs{GlsXtrLoadResources} that requires them. @@ -1852,7 +1884,8 @@ If you use \opt1, you don't need to do anything else. If you use \optsor23 with the \app{makeglossaries} Perl script or the \app{makeglossaries-lite} Lua script, you similarly don't need to do anything else. If you use \optsor23 -without the \app{makeglossaries} Perl script then you need to +without the \app{makeglossaries} Perl script or +\app{makeglossaries-lite} Lua script then you need to make sure you run \app{makeindex}\slash\app{xindy} \emph{for each defined glossary}. The \meta{gls} and \meta{glo} arguments of \cs{newglossary} specify the file extensions to use instead of @@ -1936,8 +1969,8 @@ superscripts aren't correctly sized with the DVI format. By default, if the \sty{hyperref} package has been loaded, commands like \cs{gls} will form a~hyperlink to the relevant entry in the -glossary. If you to disable this for \emph{all} your -glossaries, then use +glossary. If you want to disable this for \emph{all} your +glossaries, then use: \begin{definition} \cs{glsdisablehyper} \end{definition} @@ -1959,6 +1992,9 @@ the \pkgopt[false]{hyperfirst} package option: \usepackage[colorlinks]{hyperref} \usepackage[hyperfirst=false]{glossaries} \end{verbatim} +The \sty{glossaries-extra} extension package provides another method +using category attributes. See the \sty{glossaries-extra} user +manual for further details. Take care not to use non-expandable commands in PDF bookmarks. This isn't specific to the \sty{glossaries} package but is a~limitation @@ -1970,7 +2006,7 @@ bookmarks via \cs{texorpdfstring}. For example: \section{The \texorpdfstring{\gls{fishage}}{Fish Age}} \end{verbatim} However, it's not a~good idea to use commands like \cs{gls} in -a~section heading as you'll end up with the table of contents in +a~section heading as you'll end up with the table of contents page in your location list. Instead you can use \begin{definition} \cs{glsentrytext}\marg{label} @@ -2089,4 +2125,6 @@ build}. \item The \href{https://ctan.org/pkg/bib2gls}{\appfmt{bib2gls}} application. \end{itemize} +The \href{https://www.dickimaw-books.com/gallery}{Dickimaw Books +Gallery} provides additional example documents. \end{document} diff --git a/macros/latex/contrib/glossaries/glossary2glossaries.html b/macros/latex/contrib/glossaries/glossary2glossaries.html index e733386eb1..409159bbde 100644 --- a/macros/latex/contrib/glossaries/glossary2glossaries.html +++ b/macros/latex/contrib/glossaries/glossary2glossaries.html @@ -18,42 +18,42 @@ .cmr-17{font-size:170%;} .cmr-12{font-size:120%;} .cmr-8{font-size:80%;} -.cmtt-12{font-size:120%;font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} -.cmtt-12{font-family: monospace;} +.cmtt-12{font-size:120%;font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} +.cmtt-12{font-family: monospace,monospace;} .cmr-9{font-size:90%;} .cmbx-9{font-size:90%; font-weight: bold;} .cmbx-9{ font-weight: bold;} .cmss-9{font-size:90%; font-family: sans-serif;} .cmss-9{ font-family: sans-serif;} .cmss-9{ font-family: sans-serif;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} -.cmtt-10{font-family: monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} +.cmtt-10{font-family: monospace,monospace;} .cmti-10{ font-style: italic;} .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} -.cmtt-8{font-size:80%;font-family: monospace;} -.cmtt-8{font-family: monospace;} -.cmtt-8{font-family: monospace;} -.cmtt-8{font-family: monospace;} -.cmtt-8{font-family: monospace;} +.cmtt-8{font-size:80%;font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} +.cmtt-8{font-family: monospace,monospace;} .cmbx-10{ font-weight: bold;} .cmbx-10{ font-weight: bold;} .cmssbx-10{ font-family: sans-serif; font-weight: bold;} .cmssbx-10{ font-family: sans-serif; font-weight: bold;} .cmssbx-10{ font-family: sans-serif; font-weight: bold;} -.cmitt-10{font-family: monospace; font-style: italic;} -.cmtt-9{font-size:90%;font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} -.cmtt-9{font-family: monospace;} +.cmitt-10{font-family: monospace,monospace; font-style: italic;} +.cmtt-9{font-size:90%;font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} +.cmtt-9{font-family: monospace,monospace;} .cmti-8{font-size:80%; font-style: italic;} p{margin-top:0;margin-bottom:0} p.indent{text-indent:0;} @@ -121,11 +121,6 @@ table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } .hline td, .cline td{ padding: 0; } .hline hr, .cline hr{border:none;border-top:1px solid black;} .tabbing-right {text-align:right;} -span.TEX {letter-spacing: -0.125em; } -span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} -a span.TEX span.E {text-decoration: none; } -span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} -span.LATEX span.TEX{ position:relative; left: -0.4em; } div.float, div.figure {margin-left: auto; margin-right: auto;} div.float img {text-align:center;} div.figure img {text-align:center;} @@ -205,7 +200,7 @@ class="td11"><span class="cmr-12">Nicola L.C. Talbot</span></td></tr></table> </div> <!--l. 52--><p class="noindent" ><span -class="cmr-12">2020-02-13</span></p></div> +class="cmr-12">2020-03-19</span></p></div> <div class="abstract" > @@ -217,13 +212,7 @@ class="cmbx-9">Abstract</span></p></div> <!--l. 55--><p class="indent" > <span class="cmr-9">The purpose of this document is to provide advice if you want to</span> <span -class="cmr-9">convert a </span><span class="LATEX"><span -class="cmr-9">L</span><span class="A"><span -class="cmr-9">A</span></span><span class="TEX"><span -class="cmr-9">T</span><span -class="E"><span -class="cmr-9">E</span></span><span -class="cmr-9">X</span></span></span><span +class="cmr-9">convert a LaTeX</span><span class="cmr-9"> document from using the obsolete </span><span class="cmss-9">glossary </span><span class="cmr-9">package to</span> @@ -715,7 +704,7 @@ only used <span class="cmtt-10">\glossary</span><a id="dx1-6006"></a>, then see <a href="#sec:csglossary"><span -class="cmsy-10">§</span>6.4 </a><a +class="tcrm-1000">§</span>6.4 </a><a href="#sec:csglossary"><span class="cmtt-10">\glossary</span><!--tex4ht:ref: sec:csglossary --></a>. </p><!--l. 245--><p class="indent" > Substitute all instances of @@ -943,7 +932,7 @@ The mapping from ⟨<span class="cmti-10">old options</span>⟩ to ⟨<span class="cmti-10">new options</span>⟩ is the same as that given <a href="#sec:useglosentry"><span -class="cmsy-10">§</span>6.1 +class="tcrm-1000">§</span>6.1 </a><a href="#sec:useglosentry"><span class="cmtt-10">\useglosentry</span><!--tex4ht:ref: sec:useglosentry --></a>. @@ -1247,8 +1236,7 @@ class="cmss-10">glossaries</span></span><span class="obeylines-h"> </div><hr> </p><!--l. 463--><p class="noindent" ></p></span> You can then continue to use <span -class="cmtt-10">\SVM</span>. However, remember that <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> generally +class="cmtt-10">\SVM</span>. However, remember that LaTeX generally ignores spaces after command names that consist of alphabetical characters. You will therefore need to force a space after <span class="cmtt-10">\</span>⟨<span diff --git a/macros/latex/contrib/glossaries/glossary2glossaries.pdf b/macros/latex/contrib/glossaries/glossary2glossaries.pdf Binary files differindex 9662f4df4d..8c19ab6ef2 100644 --- a/macros/latex/contrib/glossaries/glossary2glossaries.pdf +++ b/macros/latex/contrib/glossaries/glossary2glossaries.pdf diff --git a/macros/latex/contrib/glossaries/glossary2glossaries.tex b/macros/latex/contrib/glossaries/glossary2glossaries.tex index 11a8aaeff4..78c5090561 100644 --- a/macros/latex/contrib/glossaries/glossary2glossaries.tex +++ b/macros/latex/contrib/glossaries/glossary2glossaries.tex @@ -34,7 +34,7 @@ \title{Upgrading from the glossary package to the glossaries package} \author{Nicola L.C. Talbot} -\date{2020-02-13} +\date{2020-03-19} \newenvironment{oldway}{% \begin{labelledbox}{\styfmt{glossary}}\ttfamily\obeylines diff --git a/macros/latex/contrib/glossaries/makeglossaries-lite.1 b/macros/latex/contrib/glossaries/makeglossaries-lite.1 index f411574cb1..5497796c45 100644 --- a/macros/latex/contrib/glossaries/makeglossaries-lite.1 +++ b/macros/latex/contrib/glossaries/makeglossaries-lite.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "MAKEGLOSSARIES-LITE 1" -.TH MAKEGLOSSARIES-LITE 1 "2020-02-14" "perl v5.30.1" "makeglossaries-lite Lua Script" +.TH MAKEGLOSSARIES-LITE 1 "2020-03-19" "perl v5.30.1" "makeglossaries-lite Lua Script" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/macros/latex/contrib/glossaries/makeglossaries.1 b/macros/latex/contrib/glossaries/makeglossaries.1 index 188483d548..029cd23a56 100644 --- a/macros/latex/contrib/glossaries/makeglossaries.1 +++ b/macros/latex/contrib/glossaries/makeglossaries.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "MAKEGLOSSARIES 1" -.TH MAKEGLOSSARIES 1 "2020-02-14" "perl v5.30.1" "makeglossaries Perl Script" +.TH MAKEGLOSSARIES 1 "2020-03-19" "perl v5.30.1" "makeglossaries Perl Script" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/macros/latex/contrib/glossaries/samples/glossary-lipsum-examples.pdf b/macros/latex/contrib/glossaries/samples/glossary-lipsum-examples.pdf Binary files differindex 6d29420797..4ede660f69 100644 --- a/macros/latex/contrib/glossaries/samples/glossary-lipsum-examples.pdf +++ b/macros/latex/contrib/glossaries/samples/glossary-lipsum-examples.pdf diff --git a/macros/latex/contrib/glossaries/samples/minimalgls.pdf b/macros/latex/contrib/glossaries/samples/minimalgls.pdf Binary files differindex 778390fb7d..0f9932375f 100644 --- a/macros/latex/contrib/glossaries/samples/minimalgls.pdf +++ b/macros/latex/contrib/glossaries/samples/minimalgls.pdf diff --git a/macros/latex/contrib/glossaries/samples/mwe-acr-desc.pdf b/macros/latex/contrib/glossaries/samples/mwe-acr-desc.pdf Binary files differindex d87c391ba6..bc356403a9 100644 --- a/macros/latex/contrib/glossaries/samples/mwe-acr-desc.pdf +++ b/macros/latex/contrib/glossaries/samples/mwe-acr-desc.pdf diff --git a/macros/latex/contrib/glossaries/samples/mwe-acr.pdf b/macros/latex/contrib/glossaries/samples/mwe-acr.pdf Binary files differindex 74bfe9d3d0..1f007570c0 100644 --- a/macros/latex/contrib/glossaries/samples/mwe-acr.pdf +++ b/macros/latex/contrib/glossaries/samples/mwe-acr.pdf diff --git a/macros/latex/contrib/glossaries/samples/mwe-gls.pdf b/macros/latex/contrib/glossaries/samples/mwe-gls.pdf Binary files differindex 1102d17dda..e965ca4065 100644 --- a/macros/latex/contrib/glossaries/samples/mwe-gls.pdf +++ b/macros/latex/contrib/glossaries/samples/mwe-gls.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-FnDesc.pdf b/macros/latex/contrib/glossaries/samples/sample-FnDesc.pdf Binary files differindex 1d60e8b3aa..7ab3c2b318 100644 --- a/macros/latex/contrib/glossaries/samples/sample-FnDesc.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-FnDesc.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-chap-hyperfirst.pdf b/macros/latex/contrib/glossaries/samples/sample-chap-hyperfirst.pdf Binary files differindex c8f7619280..eed73e8ade 100644 --- a/macros/latex/contrib/glossaries/samples/sample-chap-hyperfirst.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-chap-hyperfirst.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-crossref.pdf b/macros/latex/contrib/glossaries/samples/sample-crossref.pdf Binary files differindex 470d21abeb..c8c6109af8 100644 --- a/macros/latex/contrib/glossaries/samples/sample-crossref.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-crossref.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-custom-acronym.pdf b/macros/latex/contrib/glossaries/samples/sample-custom-acronym.pdf Binary files differindex dff41fe7d0..431e2b1f12 100644 --- a/macros/latex/contrib/glossaries/samples/sample-custom-acronym.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-custom-acronym.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-dot-abbr.pdf b/macros/latex/contrib/glossaries/samples/sample-dot-abbr.pdf Binary files differindex 5aa9bd92ad..a133b10a59 100644 --- a/macros/latex/contrib/glossaries/samples/sample-dot-abbr.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-dot-abbr.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-dual.pdf b/macros/latex/contrib/glossaries/samples/sample-dual.pdf Binary files differindex 89b2c1bd14..1641d2035a 100644 --- a/macros/latex/contrib/glossaries/samples/sample-dual.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-dual.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-entrycount.pdf b/macros/latex/contrib/glossaries/samples/sample-entrycount.pdf Binary files differindex ad043608c7..c0809e795c 100644 --- a/macros/latex/contrib/glossaries/samples/sample-entrycount.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-entrycount.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-entryfmt.pdf b/macros/latex/contrib/glossaries/samples/sample-entryfmt.pdf Binary files differindex 352558f6fd..e3cfdc9f90 100644 --- a/macros/latex/contrib/glossaries/samples/sample-entryfmt.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-entryfmt.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-font-abbr.pdf b/macros/latex/contrib/glossaries/samples/sample-font-abbr.pdf Binary files differindex f681c18f32..03b437a0ff 100644 --- a/macros/latex/contrib/glossaries/samples/sample-font-abbr.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-font-abbr.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-ignored.pdf b/macros/latex/contrib/glossaries/samples/sample-ignored.pdf Binary files differindex 50c9524d6e..0e67c7f41f 100644 --- a/macros/latex/contrib/glossaries/samples/sample-ignored.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-ignored.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-index.pdf b/macros/latex/contrib/glossaries/samples/sample-index.pdf Binary files differindex 5ec92b819c..eaa8b2cdd2 100644 --- a/macros/latex/contrib/glossaries/samples/sample-index.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-index.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-inline.pdf b/macros/latex/contrib/glossaries/samples/sample-inline.pdf Binary files differindex c0c3acfae1..14a6b5a2f6 100644 --- a/macros/latex/contrib/glossaries/samples/sample-inline.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-inline.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-langdict.pdf b/macros/latex/contrib/glossaries/samples/sample-langdict.pdf Binary files differindex 0e47ca4e2e..28ac311328 100644 --- a/macros/latex/contrib/glossaries/samples/sample-langdict.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-langdict.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-newkeys.pdf b/macros/latex/contrib/glossaries/samples/sample-newkeys.pdf Binary files differindex 9f1760b8d5..c93fb606af 100644 --- a/macros/latex/contrib/glossaries/samples/sample-newkeys.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-newkeys.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-noidxapp-utf8.pdf b/macros/latex/contrib/glossaries/samples/sample-noidxapp-utf8.pdf Binary files differindex da250c769a..509a5f4703 100644 --- a/macros/latex/contrib/glossaries/samples/sample-noidxapp-utf8.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-noidxapp-utf8.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-noidxapp.pdf b/macros/latex/contrib/glossaries/samples/sample-noidxapp.pdf Binary files differindex cc8e587039..683c4ed8f2 100644 --- a/macros/latex/contrib/glossaries/samples/sample-noidxapp.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-noidxapp.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-nomathhyper.pdf b/macros/latex/contrib/glossaries/samples/sample-nomathhyper.pdf Binary files differindex f7b1087f4c..1caec7d491 100644 --- a/macros/latex/contrib/glossaries/samples/sample-nomathhyper.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-nomathhyper.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-numberlist.pdf b/macros/latex/contrib/glossaries/samples/sample-numberlist.pdf Binary files differindex c139c1728c..734c0abc0e 100644 --- a/macros/latex/contrib/glossaries/samples/sample-numberlist.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-numberlist.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-prefix.pdf b/macros/latex/contrib/glossaries/samples/sample-prefix.pdf Binary files differindex 4abf0d0d21..4310008784 100644 --- a/macros/latex/contrib/glossaries/samples/sample-prefix.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-prefix.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-si.pdf b/macros/latex/contrib/glossaries/samples/sample-si.pdf Binary files differindex ba749704a6..bf51182aec 100644 --- a/macros/latex/contrib/glossaries/samples/sample-si.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-si.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-storage-abbr-desc.pdf b/macros/latex/contrib/glossaries/samples/sample-storage-abbr-desc.pdf Binary files differindex 340ff6f9f1..0791bedabb 100644 --- a/macros/latex/contrib/glossaries/samples/sample-storage-abbr-desc.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-storage-abbr-desc.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample-storage-abbr.pdf b/macros/latex/contrib/glossaries/samples/sample-storage-abbr.pdf Binary files differindex bc995c55f4..5b9c99c628 100644 --- a/macros/latex/contrib/glossaries/samples/sample-storage-abbr.pdf +++ b/macros/latex/contrib/glossaries/samples/sample-storage-abbr.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample.pdf b/macros/latex/contrib/glossaries/samples/sample.pdf Binary files differindex 3d4e2a49ae..96c5e7362b 100644 --- a/macros/latex/contrib/glossaries/samples/sample.pdf +++ b/macros/latex/contrib/glossaries/samples/sample.pdf diff --git a/macros/latex/contrib/glossaries/samples/sample4col.pdf b/macros/latex/contrib/glossaries/samples/sample4col.pdf Binary files differindex ee58db4282..d8ed5cf314 100644 --- a/macros/latex/contrib/glossaries/samples/sample4col.pdf +++ b/macros/latex/contrib/glossaries/samples/sample4col.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleAcr.pdf b/macros/latex/contrib/glossaries/samples/sampleAcr.pdf Binary files differindex 8a80268474..28ae1c1320 100644 --- a/macros/latex/contrib/glossaries/samples/sampleAcr.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleAcr.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleAcrDesc.pdf b/macros/latex/contrib/glossaries/samples/sampleAcrDesc.pdf Binary files differindex 65899e6a7b..4c3995525e 100644 --- a/macros/latex/contrib/glossaries/samples/sampleAcrDesc.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleAcrDesc.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleCustomAcr.pdf b/macros/latex/contrib/glossaries/samples/sampleCustomAcr.pdf Binary files differindex 22f1bb1990..a2118b973b 100644 --- a/macros/latex/contrib/glossaries/samples/sampleCustomAcr.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleCustomAcr.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleDB.pdf b/macros/latex/contrib/glossaries/samples/sampleDB.pdf Binary files differindex 4bceb441f4..0c677ce3ff 100644 --- a/macros/latex/contrib/glossaries/samples/sampleDB.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleDB.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleDesc.pdf b/macros/latex/contrib/glossaries/samples/sampleDesc.pdf Binary files differindex d6ec5a570d..0a649ea48c 100644 --- a/macros/latex/contrib/glossaries/samples/sampleDesc.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleDesc.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleEq.pdf b/macros/latex/contrib/glossaries/samples/sampleEq.pdf Binary files differindex 576b164ffe..da5b1210ec 100644 --- a/macros/latex/contrib/glossaries/samples/sampleEq.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleEq.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleEqPg.pdf b/macros/latex/contrib/glossaries/samples/sampleEqPg.pdf Binary files differindex fc9ad3deaa..4ea1b17797 100644 --- a/macros/latex/contrib/glossaries/samples/sampleEqPg.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleEqPg.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleFnAcrDesc.pdf b/macros/latex/contrib/glossaries/samples/sampleFnAcrDesc.pdf Binary files differindex f7fff7a080..e8a47def42 100644 --- a/macros/latex/contrib/glossaries/samples/sampleFnAcrDesc.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleFnAcrDesc.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleNtn.pdf b/macros/latex/contrib/glossaries/samples/sampleNtn.pdf Binary files differindex 149c40c796..076ad52791 100644 --- a/macros/latex/contrib/glossaries/samples/sampleNtn.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleNtn.pdf diff --git a/macros/latex/contrib/glossaries/samples/samplePeople.pdf b/macros/latex/contrib/glossaries/samples/samplePeople.pdf Binary files differindex cbc7beaed0..b8b2b11295 100644 --- a/macros/latex/contrib/glossaries/samples/samplePeople.pdf +++ b/macros/latex/contrib/glossaries/samples/samplePeople.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleSec.pdf b/macros/latex/contrib/glossaries/samples/sampleSec.pdf Binary files differindex 710ab4ab77..d06551a306 100644 --- a/macros/latex/contrib/glossaries/samples/sampleSec.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleSec.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleSort.pdf b/macros/latex/contrib/glossaries/samples/sampleSort.pdf Binary files differindex 5e60c52d16..d3dcdfada9 100644 --- a/macros/latex/contrib/glossaries/samples/sampleSort.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleSort.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleaccsupp.pdf b/macros/latex/contrib/glossaries/samples/sampleaccsupp.pdf Binary files differindex b16f769006..c955313619 100644 --- a/macros/latex/contrib/glossaries/samples/sampleaccsupp.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleaccsupp.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleacronyms.pdf b/macros/latex/contrib/glossaries/samples/sampleacronyms.pdf Binary files differindex ea045bb081..dc7db40a49 100644 --- a/macros/latex/contrib/glossaries/samples/sampleacronyms.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleacronyms.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampletree.pdf b/macros/latex/contrib/glossaries/samples/sampletree.pdf Binary files differindex f884d9fd89..48099f51e5 100644 --- a/macros/latex/contrib/glossaries/samples/sampletree.pdf +++ b/macros/latex/contrib/glossaries/samples/sampletree.pdf diff --git a/macros/latex/contrib/glossaries/samples/sampleutf8.pdf b/macros/latex/contrib/glossaries/samples/sampleutf8.pdf Binary files differindex 155441d4fe..aa19448f78 100644 --- a/macros/latex/contrib/glossaries/samples/sampleutf8.pdf +++ b/macros/latex/contrib/glossaries/samples/sampleutf8.pdf diff --git a/macros/latex/contrib/glossaries/samples/samplexdy.pdf b/macros/latex/contrib/glossaries/samples/samplexdy.pdf Binary files differindex 69261d7c8b..6b67853660 100644 --- a/macros/latex/contrib/glossaries/samples/samplexdy.pdf +++ b/macros/latex/contrib/glossaries/samples/samplexdy.pdf diff --git a/macros/latex/contrib/glossaries/samples/samplexdy2.pdf b/macros/latex/contrib/glossaries/samples/samplexdy2.pdf Binary files differindex 854bf4e3c2..340c46cd7b 100644 --- a/macros/latex/contrib/glossaries/samples/samplexdy2.pdf +++ b/macros/latex/contrib/glossaries/samples/samplexdy2.pdf diff --git a/macros/latex/contrib/glossaries/samples/samplexdy3.pdf b/macros/latex/contrib/glossaries/samples/samplexdy3.pdf Binary files differindex 290f85b163..acf90a1303 100644 --- a/macros/latex/contrib/glossaries/samples/samplexdy3.pdf +++ b/macros/latex/contrib/glossaries/samples/samplexdy3.pdf diff --git a/macros/latex/contrib/srdp-mathematik/README.txt b/macros/latex/contrib/srdp-mathematik/README.txt index 85d0ea711c..670d47be52 100644 --- a/macros/latex/contrib/srdp-mathematik/README.txt +++ b/macros/latex/contrib/srdp-mathematik/README.txt @@ -2,9 +2,9 @@ __________________________________ The srdp-mathematik package - v1.3 + v1.4 - 2019/10/07 + 2020/03/19 ___________________________________ Maintainer: Christoph Weberndorfer diff --git a/macros/latex/contrib/srdp-mathematik/srdp-mathematik.pdf b/macros/latex/contrib/srdp-mathematik/srdp-mathematik.pdf Binary files differindex 2af5d7cf30..f0dea329a6 100644 --- a/macros/latex/contrib/srdp-mathematik/srdp-mathematik.pdf +++ b/macros/latex/contrib/srdp-mathematik/srdp-mathematik.pdf diff --git a/macros/latex/contrib/srdp-mathematik/srdp-mathematik.sty b/macros/latex/contrib/srdp-mathematik/srdp-mathematik.sty index a69265b603..0a7b633552 100644 --- a/macros/latex/contrib/srdp-mathematik/srdp-mathematik.sty +++ b/macros/latex/contrib/srdp-mathematik/srdp-mathematik.sty @@ -10,7 +10,7 @@ % \NeedsTeXFormat{LaTeX2e}[1996/12/26] -\ProvidesPackage{srdp-mathematik}[2019/07/10 v1.3 Standard-Schularbeitsformate] +\ProvidesPackage{srdp-mathematik}[2019/07/10 v1.4 Standard-Schularbeitsformate] \usepackage{color} @@ -53,7 +53,8 @@ \renewcommand{\vec}[1]{\vv{#1}} \usepackage{graphicx} \usepackage{setspace} -\usepackage{enumerate} +%\usepackage{enumerate} +\usepackage[inline, shortlabels]{enumitem} \usepackage{xparse} \usepackage{eurosym, xspace} \renewcommand*\euro{\officialeuro\xspace} @@ -84,9 +85,23 @@ % % \newcounter{Antworten} +\newcounter{Zufall} +\newcounter{info} \newcounter{marker} \DeclareOption{solution_on}{\setcounter{Antworten}{1}} \DeclareOption{solution_off}{\setcounter{Antworten}{0}} +\DeclareOption{info_on}{\setcounter{info}{1}} +\DeclareOption{info_off}{\setcounter{info}{0}} +\DeclareOption{random=0}{\setcounter{Zufall}{0}} +\DeclareOption{random=1}{\setcounter{Zufall}{1}} +\DeclareOption{random=2}{\setcounter{Zufall}{2}} +\DeclareOption{random=3}{\setcounter{Zufall}{3}} +\DeclareOption{random=4}{\setcounter{Zufall}{4}} +\DeclareOption{random=5}{\setcounter{Zufall}{5}} +\DeclareOption{random=6}{\setcounter{Zufall}{6}} +\DeclareOption{random=7}{\setcounter{Zufall}{7}} +\DeclareOption{random=8}{\setcounter{Zufall}{8}} +\DeclareOption{random=9}{\setcounter{Zufall}{9}} \AtBeginDocument{\@ifpackagewith{srdp-mathematik}{solution_on}{ \AddToShipoutPictureBG{% @@ -104,6 +119,16 @@ \newcommand{\antwort}[2][]{\ifthenelse{\theAntworten=1}{\color[rgb]{1,0,0}#2\color[rgb]{0,0,0}}{#1}} +\newcommand{\info}[2][]{\ifthenelse{\theinfo=1}{ +\color[rgb]{0,0,1}{#2}\color[rgb]{0,0,0} +}{#1}} + + +%\NewEnviron{antwort}[1][hallo]{\textcolor{red}{\BODY}} +%\NewEnviron{antwort}[2][]{\ifthenelse{\theAntworten=1}{\color[rgb]{1,0,0}#1\color[rgb]{0,0,0}}{#2}} +%\newenvironment{antwort}[2][]{\color[rgb]{1,0,0}{#1}}{\color[rgb]{0,0,0}} + + \newcounter{A1} \newcounter{A2} @@ -155,7 +180,7 @@ \NewEnviron{beispiel}[2][\unskip]{\begin{minipage}[t]{0.88\textwidth} \addtocounter{number}{1} -\begin{enumerate} +\begin{enumerate}[leftmargin=0pt] \item[\thenumber.] \BODY \end{enumerate} @@ -207,7 +232,8 @@ \renewcommand{\labelenumii}{(\roman{enumii})} \list {} - {% + {% + \leftmargin.0pt \rightmargin.12\textwidth \def\makelabel##1{\stepcounter{number}% \hss\llap{\thenumber.}% @@ -216,13 +242,38 @@ \llap{\small\_\_\_/##1}}}}% } {\endlist} + \makeatother + +\newcommand{\typzwei}{} +\newcounter{subitemcounter} +\newcommand{\Subitem}[1]{\stepcounter{subitemcounter}\begin{enumerate}[\thesubitemcounter),leftmargin=*]\itemalt{#1}\end{enumerate}} +\newcommand{\Aitem}{\item \fbox{A} } +\newcommand{\ASubitem}[1]{\Subitem{\fbox{A} #1}} +\NewEnviron{aufgabenstellung}[1]{\let\itemalt\item +\renewcommand*{\item}{\setcounter{subitemcounter}{0}\itemalt} +\subsubsection{Aufgabenstellung:}% +\begin{enumerate}[a),leftmargin=*] +\item \BODY +\end{enumerate}% +\let\item\itemalt} + +\NewEnviron{loesung}[1]{\let\itemalt\item +\renewcommand*{\item}{\setcounter{subitemcounter}{0}\itemalt} +\antwort{%% +\begin{enumerate}[a),leftmargin=*] +\item \BODY +\end{enumerate}}% +\let\item\itemalt} + % % % % % % + + %%%%%%%%%%%%%%%%%%%%%%%%% Vektorendefinition \newcommand{\vek}[1]{\overrightarrow{#1}}% @@ -246,6 +297,12 @@ % % +%%%%%%%%%%%%%%%%%%%% INTEGRAL BEFEHL +%\newcommand{\dx}{\,\text{d}x} +\newcommand{\dx}[1][x]{\,\text{d}#1} +\newcommand{\dint}{\displaystyle\int} + + %%%%%%%%%% HOMEWORK BEFEHL \newcommand{\hw}[1]{ @@ -461,7 +518,7 @@ Beurteilung: \rule{8cm}{0.4pt} %%%%%%%%%%%%%%%% -\newcounter{Zufall} + \makeatletter \def\prunelist#1{% \expandafter\edef\csname pgfmath@randomlist@#1\endcsname diff --git a/macros/latex/contrib/srdp-mathematik/srdp-mathematik.tex b/macros/latex/contrib/srdp-mathematik/srdp-mathematik.tex index 5529373e67..4151db1272 100644 --- a/macros/latex/contrib/srdp-mathematik/srdp-mathematik.tex +++ b/macros/latex/contrib/srdp-mathematik/srdp-mathematik.tex @@ -53,7 +53,7 @@ hidelinks \begin{center} \vfill -\Huge The \textit{srdp-mathematik} package v1.3\\[1cm] +\Huge The \textit{srdp-mathematik} package v1.4\\[1cm] Documentation \\ [1cm] @@ -218,7 +218,7 @@ oder \end{verbatim} -Die korrekte Lösungseingabe der vorformatierten Typ1-Aufgaben wird bei den entsprechenden Befehlen direkt erklärt. Unabhängig davon, gibt es die Möglichkeit mithilfe des \texttt{antwort}-Befehls, beliebige Abschnitte als \textit{Antwort} zu deklarieren. +Die korrekte Lösungseingabe der vorformatierten Typ-1-Aufgaben wird bei den entsprechenden Befehlen direkt erklärt. Unabhängig davon, gibt es die Möglichkeit mithilfe des \texttt{antwort}-Befehls, beliebige Abschnitte als \textit{Antwort} zu deklarieren. (verwendeter counter: \texttt{Antworten=0, 1}) \subsubsection{\texttt{antwort}-Befehl} @@ -254,16 +254,26 @@ wird.] \texttt{'solution\_on'} eingestellt ist.} -\subsection{Erstellung von Gruppen} -Das \texttt{srdp-mathematik}-Paket ermöglicht auch die automatische Erstellung von Gruppen für Schularbeiten, durch Vertauschung der Antwortmöglichkeiten aller Typ1-Aufgaben. Dazu muss im Preamble (Bereich vor \texttt{\textbackslash begin\{document\}}) folgender Befehl eingefügt werden:\\ +\subsection{Erstellung von Gruppen -- Option: \texttt{[random=0,1,2,\ldots]}} +Das \texttt{srdp-mathematik}-Paket ermöglicht auch die automatische Erstellung von Gruppen für Schularbeiten, durch Vertauschung der Antwortmöglichkeiten aller Typ-1-Aufgaben. Dazu kann die \texttt{random}-Option im \texttt{srdp-mathematik}-Paket eingebunden geladen werden. Also: -\texttt{\textbackslash setcounter\{Zufall\}\{0\}} \leer +\begin{verbatim} +\usepackage[random=0]{srdp-mathematik} +\end{verbatim} + +oder + +\begin{verbatim} +\usepackage[random=1]{srdp-mathematik} +\end{verbatim} + +usw. Die Zahl "`0"' bedeutet dabei, dass keine Vertauschung stattfindet und somit die Antwortmöglichkeiten in der Reihenfolge angezeigt werden, in der sie in der \texttt{tex}-Datei eingegeben wurden. Durch das Ersetzen der Zahl "`0"' durch die Zahlen $1, 2, 3, \ldots$ (und anschließendem Kompilieren) werden die Antwortmöglichkeiten bei \textbf{allen} Typ1-Formaten der Datei in einer zufälligen Reihenfolge vertauscht. Es können somit in kurzer Zeit mehrere Gruppen der selben Schularbeit erstellt werden. Die eingegebenen Lösungen werden gleichermaßen übernommen. \leer -Die Erstellung der Gruppen ist dabei reproduzierbar. Die Reihenfolge der Antwortmöglichkeiten einer Gruppe bleibt daher immer gleich. Mithilfe des Befehls \texttt{\textbackslash Gruppe} kann die Gruppennummer innerhalb der \texttt{PDF}-Datei (z.B. am Deckblatt) angezeigt werden. +Die Erstellung der Gruppen ist dabei reproduzierbar. Die Reihenfolge der Antwortmöglichkeiten einer Gruppe bleibt daher immer gleich. Mithilfe des Befehls \texttt{\textbackslash Gruppe} kann die Gruppennummer innerhalb der \texttt{PDF}-Datei (z.B. am Deckblatt) angezeigt werden. (verwendeter counter: \texttt{Zufall=0, 1, 2, \ldots}) %Dieses Prinzip wird exemplarisch am Multiplechoice-Format gezeigt:\leer % @@ -350,9 +360,24 @@ Die Erstellung der Gruppen ist dabei reproduzierbar. Die Reihenfolge der Antwort %A4=0, % 4. Antwort %A5=0, % 5. Antwort %} + +\subsection{Informationseingabe -- Option: \texttt{[info\_on/off]}} +Es ist darüber hinaus möglich zusätzliche Informationen (Erläuterungen, Hilfestellungen, \ldots) hinzuzufügen und einzublenden. Dazu kann die Option \texttt{info\_on/off} im \texttt{srdp-mathematik}-Paket eingebunden werden. Die Infos werden in \textcolor[rgb]{0,0,1}{blau} angegeben und nur dann angezeigt, wenn die Option \texttt{info\_on} gewählt wurde (verwendeter counter: \texttt{info=0,1}). Also: + + +\begin{verbatim} +\usepackage[info_on]{srdp-mathematik} +\end{verbatim} + +oder + +\begin{verbatim} +\usepackage[info_off]{srdp-mathematik} +\end{verbatim} + -\subsubsection{Weitere allgemeine Befehle} -Darüber hinaus gibt es noch weitere Befehle, die die Formatierung erleichtern. +\subsection{Weitere allgemeine Befehle} +Außerdem gibt es noch weitere Befehle, die die Formatierung erleichtern. \subsubsection*{\texttt{\textbackslash leer} - Befehl} Eine Leerzeile, etwa zwischen zwei Beispielen. \\ @@ -412,18 +437,12 @@ Teilt die Seite in drei gleich große Teile \leer - -\newpage \section{Typ-1-Aufgaben} Das \texttt{srdp-mathematik}-Paket ermöglicht die Verwendung vorgefertigter Aufgabenformate, die bei der österreichischen, standardisierten Reifeprüfung Anwendung finden. - - - - \subsection{\texttt{multiplechoice}-Befehl} Dieser Befehl liefert eine vollständige Formatierung für eine Multiplechoice-Aufgabe. Die Anzahl der Antwortmöglichkeiten kann dabei frei (max. 9) gewählt werden. Als Standard ist dabei das Format mit fünf Antwortmöglichkeiten eingestellt. \leer @@ -539,8 +558,6 @@ Wichtig zu erwähnen ist dabei, dass ausschließlich die Zahl in eckigen Klammer A5=0, % 5. Antwort } -\newpage - \textsc{Eingabe:} @@ -972,6 +989,93 @@ R1={Dabei wird die linke Box vergrößert.}, % Response 1 Analog funktioniert die Verkleinerung der linken Box. Dazu müssen Werte kleiner 0 angegeben werden. +\section{Typ-2-Aufgaben} +Um die Struktur der Teil-2-Aufgaben ähnlich jener bei der standardisierten Reifeprüfung einhalten zu können, beinhaltet das Paket einige Befehle, die die Erstellung von Typ-2-Aufagben erleichtern. + +\subsection{\texttt{aufgabenstellung}-Umgebung} +Typ-2-Aufgaben sollten innerhalb einer Prüfung mithilfe der \texttt{langesbeispiel}-Umgebung eingegeben werden, um die volle Funktionalität (wie \texttt{notenschluessel}) des Pakets zu ermöglichen. Der einleitenden Aufgabentext kann dann eingegeben werden. Für die Eingabe der Aufgabenstellung kann dann die \texttt{aufgabenstellung}-Umgebung verwendet werden.\leer + +\subsubsection{\texttt{\textbackslash item} und \texttt{\textbackslash Subitem\{\}}} +Innerhalb dieser Umgebung können dann mithilfe von \texttt{\textbackslash item} (nummeriert mit a), b) ,c), \ldots) und \texttt{\textbackslash Subitem\{\}} (nummeriert mit 1), 2), \ldots) die jeweiligen Items und Subitems der Aufgabe eingegeben werden. \leer + +\subsubsection{Ausgleichspunkte} +Um die notwendigen Ausgleichspunkte in den Typ-2-Aufgaben zu markieren, können die Befehle \texttt{item} und \texttt{Subitem} durch \texttt{\textbackslash Aitem} und \texttt{\textbackslash ASubitem\{\}} ersetzt werden. Dabei wird vor den geschriebenen Text noch ein \fbox{A} eingefügt -- die Nummerierung wird aber wie gewohnt fortgesetzt. + +\subsection{\texttt{loesung}-Umgebung} +Mithilfe der \texttt{loesung}-Umgebung kann die Lösungserwartung sowie der Lösungsschlüssel eingegeben werden. Analog zur Aufgabenstellung können \texttt{\textbackslash item} und \texttt{\textbackslash Subitem\{\}} verwendet werden. Die Eingabe innerhalb der \texttt{loesung}-Umgebung werden nur dann angezeigt, wenn die Lösungsanzeige aktiviert wurde. Die Nummerierung der Subitems kann man mit folgender Eingabe zurücksetzen: \texttt{\textbackslash setcounter{subitemcounter}{0}}.\leer + +Eine vollständige Typ-2-Aufgabe könnte also wie folgt aussehen: + +\textsc{Eingabe:} + +\begin{verbatim} +\begin{langesbeispiel} \item[0] %PUNKTE DES BEISPIELS +Hier steht der einleitende Text der Typ-2-Aufgabe. + +\begin{aufgabenstellung} +\item Hier steht der Aufgabentext des ersten Items. + +\Subitem{Aufgabentext des ersten Unterpunkts} %Unterpunkt1 +\Subitem{Aufgabentext des zweiten Unterpunkts} %Unterpunkt2 + +\end{aufgabenstellung} + +\begin{loesung} +\item \subsection{Lösungserwartung:} + +\Subitem{Lösungserwartung des ersten Unterpunkts} %Lösung von Unterpunkt1 +\Subitem{Lösungserwartung des zweiten Unterpunkts} %%Lösung von Unterpunkt2 + +\setcounter{subitemcounter}{0} +\subsection{Lösungsschlüssel:} + +\Subitem{Lösungsschlüssel des ersten Unterpunkts} %Unterpunkt1 +\Subitem{Lösungsschlüssel des ersten Unterpunkts} %Unterpunkt2 + +\end{loesung} + +\end{langesbeispiel} +\end{verbatim} +\newpage + +\textsc{Ausgabe:} +\setcounter{Antworten}{1} +\setcounter{secnumdepth}{-1} +\setcounter{number}{0} +\begin{langesbeispiel} \item[0] %PUNKTE DES BEISPIELS +Hier steht der einleitende Text der Typ-2-Aufgabe. + +\begin{aufgabenstellung} +\item Hier steht der Aufgabentext des ersten Items. + +\Subitem{Aufgabentext des ersten Unterpunkts} %Unterpunkt1 +\Subitem{Aufgabentext des zweiten Unterpunkts} %Unterpunkt2 + +\end{aufgabenstellung} + +\begin{loesung} +\item \subsection*{Lösungserwartung:} + +\Subitem{Lösungserwartung des ersten Unterpunkts} %Lösung von Unterpunkt1 +\Subitem{Lösungserwartung des zweiten Unterpunkts} %%Lösung von Unterpunkt2 + +\setcounter{subitemcounter}{0} +\subsection*{Lösungsschlüssel:} + +\Subitem{Lösungsschlüssel des ersten Unterpunkts} %Lösungschlüssel von Unterpunkt1 +\Subitem{Lösungsschlüssel des ersten Unterpunkts} %Lösungschlüssel von Unterpunkt2 + +\end{loesung} + +\end{langesbeispiel} + + +% +%\subsection{\texttt} +%\textsc{Eingabe:} +%\begin{small} +%\begin{verbatim} +%\end{verbatim} \section{Einfügen von GeoGebra-Grafiken} diff --git a/macros/latex/contrib/turabian-formatting/README b/macros/latex/contrib/turabian-formatting/README index 7a023e9f9d..a08b2544d7 100644 --- a/macros/latex/contrib/turabian-formatting/README +++ b/macros/latex/contrib/turabian-formatting/README @@ -1,4 +1,4 @@ -Turabian Formatting for LaTeX (2018/08/01) +Turabian Formatting for LaTeX (2020/03/19) INTRODUCTION @@ -37,7 +37,7 @@ manual, turabian-formatting-doc.pdf, included in this package. ============================== -Copyright 2013-2018 Omar Abdool +Copyright 2013-2020 Omar Abdool This work may be distributed and/or modified under the conditions of the LaTeX Project Public License (LPPL), either version 1.3 of this license diff --git a/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.pdf b/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.pdf Binary files differindex 99fbe5bcfd..f200f9042c 100644 --- a/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.pdf +++ b/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.pdf diff --git a/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.tex b/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.tex index 1b55094487..e9616ac054 100644 --- a/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.tex +++ b/macros/latex/contrib/turabian-formatting/turabian-formatting-doc.tex @@ -1,7 +1,7 @@ % Turabian Formatting for LaTeX -- Package Documentation % % ============================== -% Copyright 2013-2018 Omar Abdool +% Copyright 2013-2020 Omar Abdool % % This work may be distributed and/or modified under the conditions of the LaTeX % Project Public License (LPPL), either version 1.3 of this license or (at your @@ -19,7 +19,7 @@ % and turabian-formatting-doc.pdf (in addition to the README file). % % ============================== -% Last updated: 2018/08/01 +% Last updated: 2020/03/19 % % @@ -50,7 +50,7 @@ \usepackage{marginnote} \renewcommand*{\raggedleftmarginnote}{} \renewcommand*{\marginfont}{\ttfamily} -\renewcommand*{\marginnotevadjust}{2\baselineskip} +\renewcommand*{\marginnotevadjust}{\parskip} \usepackage{geometry} \geometry{top=1.5in, bottom=1.75in, left=1.75in, right=1.75in} @@ -196,7 +196,7 @@ The default page size, for both document classes, is 8\nicefrac{1}{2} × 11 inch The \texttt{twocolumn} option, however, is not supported. More so, the \texttt{turabian-thesis} document class does not support the \texttt{notitlepage} option. -Both documents classes, by default, are set to \texttt{oneside}. The \texttt{twoside} option is also supported. +Both document classes, by default, are set to \texttt{oneside}. The \texttt{twoside} option is also supported. \clearpage \subsection{Ragged Right (Left Align) Text} @@ -230,7 +230,9 @@ With the \texttt{endnotes} option, footnotes are restarted on each page and labe To produce a list of endnotes, use the \textcmd{theendnotes} command provided by the \texttt{endnotes} package. Through the \texttt{endnotes} option, each endnote is single-spaced with a ``blank line between notes." The default heading for this list of endnotes is typeset as \emph{Notes}.\footnote{% The \emph{Notes} heading, when using the \texttt{turabian-researchpaper} document class, is typeset with \textcmd{section*}. The \texttt{turabian-thesis} document class, however, typesets the \emph{Notes} heading with \textcmd{chapter*}. If there are no endnotes preceding \textcmd{theendnotes}, this command will generate a \emph{Notes} heading with an empty endnotes list.} -When used with \texttt{turabian-thesis}, the numbering of endnotes is restarted at the beginning of each chapter. In this case, the endnotes list then uses subheadings that divide endnotes by each chapter.\autocite[162]{turabian_manual_2018} +When used with \texttt{turabian-thesis}, the numbering of endnotes is restarted at the beginning of each chapter (using the \textcmd{chapter} command).\footnote{% + The starred \textcmd{chapter*} command does not restart the numbering of endnotes.} +In this case, the endnotes list then uses subheadings that divide endnotes by each chapter.\autocite[162]{turabian_manual_2018} \clearpage @@ -335,7 +337,7 @@ For a research paper, \textcmd{submissioninfo} is used for typesetting ``any inf \texttt{turabian-researchpaper} provides the optional \textcmd{course} command for typesetting course information (such as the course title). \marginnote{\textbackslash institution\{\}\newline \textbackslash department\{\}\newline \textbackslash location\{\}} -\texttt{turabian-thesis} also provides: (1) \textcmd{institution} for typesetting the institution at the top of the page, (2) for typesetting the name of the department, and (3) \textcmd{location} for typesetting a location just above the date. +\texttt{turabian-thesis} also provides: (1) \textcmd{institution} for typesetting the institution at the top of the page, (2) \textcmd{department} for typesetting the name of the department, and (3) \textcmd{location} for typesetting a location just above the date. To create a custom title page, use the \texttt{titlepage} environment. @@ -416,9 +418,9 @@ With the \texttt{turabian-researchpaper} document class, the heading of each app \label{sec:required_packages} -This package requires \LaTeX{}2e and makes use of the following packages installed as part of a standard \LaTeX{} distribution: \texttt{etoolbox}, \texttt{setspace}, \texttt{nowidow}, \texttt{footmisc}, \texttt{endnotes}, and \texttt{xparse}. +This package requires \LaTeX{}2e and makes use of the following packages installed as part of a standard \LaTeX{} distribution: \texttt{etoolbox}, \texttt{setspace}, \texttt{nowidow}, \texttt{footmisc}, and \texttt{endnotes}. -The following packages are highly recommended: \texttt{biblatex-chicago}, \texttt{csquotes}, \texttt{fancyhdr}, \texttt{tocloft}, \texttt{ellipsis}, and \texttt{threeparttable}. +The following packages are highly recommended: \texttt{biblatex-chicago}, \texttt{csquotes}, \texttt{tocloft}, \texttt{ellipsis}, and \texttt{threeparttable}. \clearpage @@ -426,6 +428,24 @@ The following packages are highly recommended: \texttt{biblatex-chicago}, \textt \label{sec:updates} +\marginnote{\rmfamily{2020/03/19}}% + +Part, chapter, section, and subsection headings are easier to adjust. This includes better support for \textcmd{MakeUppercase}. + +Vertical spacing, in typesetting part, chapter, section, and subsection headings, is more precise. + +The \texttt{appendixes} environment provides better support for adjusting the typesetting of appendix headings. + +Improved support for \texttt{biblatex}. + +The bibliography/references list, by default, is no longer included in the table of contents (instead, use the \texttt{heading=bibintoc} option with \textcmd{printbibliography}). + +Significantly improved support for implementing endnotes with the \texttt{endnotes} package. + +The \textcmd{chapter*} command no longer resets footnote and endnote counters. + +The \texttt{xparse} package is no longer required. + \marginnote{\rmfamily{2018/08/01}}% If the \texttt{biblatex-chicago} package is loaded by the user, the \texttt{noibid} option is no longer passed to the package by default. @@ -438,7 +458,7 @@ The default page style for pages in the front matter has been changed to \texttt The \textcmd{tableofcontents} command no longer causes subsequent pages to be typeset using the \texttt{plain} page style. -Paragraphs immediately following chapter, section, and subsection headings now have an indentation of 0.5 inches. +Paragraphs, immediately following chapter, section, and subsection headings, now have an indentation of 0.5 inches. The lists of figures, tables, and illustrations each appear as entries in the table of contents. diff --git a/macros/latex/contrib/turabian-formatting/turabian-formatting.sty b/macros/latex/contrib/turabian-formatting/turabian-formatting.sty index fad71334e8..b2e56dccda 100644 --- a/macros/latex/contrib/turabian-formatting/turabian-formatting.sty +++ b/macros/latex/contrib/turabian-formatting/turabian-formatting.sty @@ -4,7 +4,7 @@ % and Dissertations," 9th edition. % % ============================== -% Copyright 2013-2018 Omar Abdool +% Copyright 2013-2020 Omar Abdool % % This work may be distributed and/or modified under the conditions of the LaTeX % Project Public License (LPPL), either version 1.3 of this license or (at your @@ -27,7 +27,7 @@ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{turabian-formatting}[2018/08/01 Turabian Formatting] +\ProvidesPackage{turabian-formatting}[2020/03/19 Turabian Formatting] % Package options: flags and variables @@ -74,13 +74,12 @@ \setlength\footskip{0.5in} -% Text spacing is double spaced +% Text spacing is double-spaced \RequirePackage{setspace} \setstretch{2} -% Preserve normalsize and footnotesize single spacing baselineskip values - +% Preserve normalsize and footnotesize single-spacing baselineskip values \newlength\tf@singlelineskip \newlength\tf@fnsinglelineskip @@ -143,13 +142,12 @@ % Footnotes: readjust footnote rule size and placement \renewcommand{\footnoterule}{% - \vspace*{-3pt} - \hrule width 2in height 0.4pt - \vspace*{-4pt}} + \kern-3\p@ + \hrule \@width 2in height 0.4\p@ + \kern-4\p@} -% Footnotes: make command to set footnote punctuation -\newcommand{\tf@setfnpunct}[1]{\def\tf@thefnpunct{#1\,\,}} -\tf@setfnpunct{.} +% Footnotes: set default footnote punctuation +\def\tf@thefnpunct{.\,\,} % Footnotes: renew command for typesetting footnotes \renewcommand{\@makefntext}[1]{% @@ -163,8 +161,8 @@ \def\ps@headings{% \let\@oddfoot\@empty \let\@evenfoot\@empty - \def\@evenhead{\thepage\hfil\slshape\leftmark} - \def\@oddhead{{\slshape\rightmark}\hfil\thepage} + \def\@evenhead{\thepage} + \def\@oddhead{\hfil\thepage} \let\@mkboth\@gobbletwo \let\markboth\@mkboth \let\chaptermark\@gobble @@ -192,8 +190,10 @@ % Set top section command name to "section" (default) \def\tf@topsecname{section} -% Set adjustment for baselineskip after \section and \section* headings -\def\tf@adjaftersec{\dimexpr \baselineskip -\tf@singlelineskip -\p@ \relax} +% Redefine \@afterheading to adjust for baselineskip after headings +\def\tf@adjaftersec{\dimexpr \baselineskip -\tf@singlelineskip \relax} +\let\tf@tempafterheading\@afterheading +\def\@afterheading{\vskip -\tf@adjaftersec\relax \tf@tempafterheading} % Headings formatting: \section, \subsection, and \subsubsection \setcounter{secnumdepth}{0} @@ -201,47 +201,96 @@ \renewcommand{\section}{% \@startsection{section}{1}% {\z@}% - {-\tf@singlelineskip}% + {2\tf@singlelineskip}% {\tf@singlelineskip}% - {\normalfont\bfseries\normalsize\singlespacing\centering}} + {\normalfont\bfseries\normalsize\centering}} \renewcommand{\subsection}{% \@startsection{subsection}{2}% {\z@}% - {-\tf@singlelineskip}% + {2\tf@singlelineskip}% {\tf@singlelineskip}% - {\normalfont\mdseries\normalsize\singlespacing\centering}} + {\normalfont\mdseries\normalsize\centering}} \renewcommand{\subsubsection}{% \@startsection{subsubsection}{3}% {\z@}% - {-\tf@singlelineskip}% + {2\tf@singlelineskip}% {\tf@singlelineskip}% - {\normalfont\bfseries\normalsize\singlespacing\raggedright}} + {\normalfont\bfseries\normalsize\raggedright}} -% Headings formatting: following paragraphs start with an indent -\def\tf@afterindent{\@afterindenttrue} +% Sections: section heading formatting +\def\tf@makesectionhead#1#2#3#4#5{% + \vskip -\tf@singlelineskip\relax + \begingroup + \singlespacing + #4{% + \@hangfrom{\hskip #3\relax\@svsec}% + \interlinepenalty \@M #5\@@par}% + \endgroup} + +% Sections: formatting of TOC \addcontentsline +\def\tf@tocline#1#2{\protect{\csname the#1\endcsname\quad}} + +% Sections: redefine \@sect to use \tf@makesectionhead and \tf@tocline +\def\@sect#1#2#3#4#5#6[#7]#8{% + \ifnum #2>\c@secnumdepth + \let\@svsec\@empty + \else + \refstepcounter{#1}% + \protected@edef\@svsec{\@seccntformat{#1}\relax}% + \fi + \@tempskipa #5\relax + \ifdim \@tempskipa>\z@ + \tf@makesectionhead{#1}{#2}{#3}{#6}{#8} + \csname #1mark\endcsname{#7}% + \addcontentsline{toc}{#1}{% + \ifnum #2>\c@secnumdepth \else \tf@tocline{#1}{#2} \fi #7}% + \else + \def\@svsechd{% + #6{\hskip #3\relax \@svsec #8}% + \csname #1mark\endcsname{#7}% + \addcontentsline{toc}{#1}{% + \ifnum #2>\c@secnumdepth \else \tf@tocline{#1}{#2} \fi #7}}% + \fi + \@xsect{#5}} + +% Sections: redefine \@ssect +\def\@ssect#1#2#3#4#5{% + \@tempskipa #3\relax + \ifdim \@tempskipa>\z@ + \vskip -\tf@singlelineskip\relax + \begingroup + \singlespacing + #4{% + \@hangfrom{\hskip #1}% + \interlinepenalty \@M #5\@@par}% + \endgroup + \else + \def\@svsechd{#4{\hskip #1\relax #5}}% + \fi + \@xsect{#3}} -% Table of Contents: renew formatting +% Table of Contents: set adjustment for baselineskip after toc heading +\def\tf@adjaftersectoc{% + \vspace{\dimexpr \baselineskip -3\tf@singlelineskip \relax}} -\def\tf@tocpagestyle{\@empty} +% Table of Contents: \@starttoc formatting hook +\def\tf@starttocformat{\singlespacing} \renewcommand{\tableofcontents}{% - \tf@tocpagestyle \expandafter\csname \tf@topsecname\endcsname*{\contentsname}% - \@mkboth{\contentsname}{\contentsname}% + \@mkboth{}{}% \if@optraggedright \let\tf@tocrmarg\@tocrmarg \def\@tocrmarg{\tf@tocrmarg plus1fil} \fi - { \vspace{\dimexpr -3\tf@singlelineskip +1\baselineskip \relax}% - \singlespacing - \@starttoc{toc}}}% + \tf@adjaftersectoc + {\tf@starttocformat\@starttoc{toc}}}% % List of Figures and List of Tables: adjust titles - \renewcommand{\listfigurename}{Figures} \renewcommand{\listtablename}{Tables} @@ -262,20 +311,18 @@ % List of Figures \renewcommand{\listoffigures}{% \expandafter\csname \tf@topsecname\endcsname*{\listfigurename}% - \@mkboth{\listfigurename}{\listfigurename}% + \@mkboth{}{}% \addcontentsline{toc}{\tf@topsecname}{\listfigurename}% - { \vspace{\dimexpr -3\tf@singlelineskip +1\baselineskip \relax}% - \singlespacing - \@starttoc{lof}}} + \tf@adjaftersectoc + {\tf@starttocformat\@starttoc{lof}}} % List of Tables \renewcommand{\listoftables}{% \expandafter\csname \tf@topsecname\endcsname*{\listtablename}% - \@mkboth{\listtablename}{\listtablename}% + \@mkboth{}{}% \addcontentsline{toc}{\tf@topsecname}{\listtablename}% - { \vspace{\dimexpr -3\tf@singlelineskip +1\baselineskip \relax}% - \singlespacing - \@starttoc{lot}}} + \tf@adjaftersectoc + {\tf@starttocformat\@starttoc{lot}}} % List of Illustrations \newcommand{\listillustrationname}{Illustrations} @@ -283,10 +330,10 @@ \newcommand{\listofillustrations}{% \expandafter\csname \tf@topsecname\endcsname*{\listillustrationname}% - \@mkboth{\listillustrationname}{\listillustrationname}% + \@mkboth{}{}% \addcontentsline{toc}{\tf@topsecname}{\listillustrationname}% - { \vspace{\dimexpr -3\tf@singlelineskip +1\baselineskip \relax}% - \singlespacing + \tf@adjaftersectoc + { \tf@starttocformat {\tf@illustrsection Figures}\par\nopagebreak \@starttoc{lof} \vspace{\tf@singlelineskip} @@ -295,7 +342,6 @@ % Figures and Tables: float positioning - \setlength\textfloatsep{% \dimexpr 2\tf@singlelineskip +\p@ \relax minus 1\tf@singlelineskip} \setlength\floatsep{% @@ -307,7 +353,6 @@ \def\fps@figure{!htb} % Figures and Tables: caption formatting - \setlength\abovecaptionskip{\z@} \setlength\belowcaptionskip{\z@} @@ -317,7 +362,6 @@ \small#1. #2\par \vskip\belowcaptionskip} - % Lists: enumerate and itemize formatting \setlength\leftmargini{1.5\parindent} \setlength\leftmargin{\leftmargini} @@ -391,7 +435,6 @@ % thebibliography environment: formatting (adjust \@openbib@code hook default) - \setlength\bibindent{\parindent} \renewcommand\@openbib@code{% @@ -422,52 +465,36 @@ \DefineBibliographyStrings{english}{% references = {Bibliography}} \fi - \renewcommand{\bibsetup}{% - \addcontentsline{toc}{\tf@topsecname}{\bibname} - \vspace{\dimexpr -2\tf@singlelineskip +1\baselineskip \relax}% - \singlespacing% - \def\tf@adjaftersec{\dimexpr \tf@singlelineskip -\p@ \relax}} - \renewcommand{\bibitemsep}{1\baselineskip} + \renewcommand{\bibitemsep}{\tf@singlelineskip} \renewcommand{\bibhang}{0.5in} + \renewcommand{\bibsetup}{% + \vskip \tf@adjaftersec\relax + \vskip -\tf@singlelineskip\relax + \singlespacing}% }{}} \fi % Endnotes: support and formatting - \if@endnotesformat - \RequirePackage{endnotes, xparse} + \RequirePackage{endnotes} % Changes footnote marker type and formatting - \tf@setfnpunct{} + \def\tf@thefnpunct{\,\,} \renewcommand*{\thefootnote}{\fnsymbol{footnote}} \PassOptionsToPackage{notetype=endonly}{biblatex-chicago} - \AtEndPreamble{% - % Make endnotes use of "_" not a special character when in text mode - \appto{\enoteheading}{% - \catcode`_=12 - \begingroup\lccode`~=`_ - \lowercase{\endgroup\let~}\sb - \mathcode`_="8000} - - % Create \jobname.ent if not already defined to avoid missing file error - \preto{\theendnotes}{% - \IfFileExists{./\jobname.ent}% - {}% - {% - \immediate\openout\@enotes=\jobname.ent\relax - \immediate\write\@enotes{}% - }}} + % Create \jobname.ent to avoid missing file error + \@openenotes % Set default endnotes formatting \renewcommand{\enotesize}{\normalsize} \renewcommand{\enoteformat}{% + \singlespacing \if@optraggedright \raggedright \fi \setlength\parindent{\footnotemargin} - \vspace{\tf@singlelineskip} \theenmark.\,\,} \else diff --git a/macros/latex/contrib/turabian-formatting/turabian-researchpaper.cls b/macros/latex/contrib/turabian-formatting/turabian-researchpaper.cls index ae2b8ce881..e97d559a64 100644 --- a/macros/latex/contrib/turabian-formatting/turabian-researchpaper.cls +++ b/macros/latex/contrib/turabian-formatting/turabian-researchpaper.cls @@ -4,7 +4,7 @@ % and Dissertations," 9th edition. % % ============================== -% Copyright 2013-2018 Omar Abdool +% Copyright 2013-2020 Omar Abdool % % This work may be distributed and/or modified under the conditions of the LaTeX % Project Public License (LPPL), either version 1.3 of this license or (at your @@ -27,7 +27,7 @@ \NeedsTeXFormat{LaTeX2e} -\ProvidesClass{turabian-researchpaper}[2018/08/01 Turabian Research Paper] +\ProvidesClass{turabian-researchpaper}[2020/03/19 Turabian Research Paper] % Default point size @@ -79,118 +79,69 @@ \RequirePackage{turabian-formatting} -% Part: formatting -\def\tf@partformat{\normalfont\bfseries\singlespacing\centering} - -\def\@part[#1]#2{% - \ifnum \c@secnumdepth >-2\relax - \refstepcounter{part}% - \addcontentsline{toc}{part}% - {\protect{\partname\space\thepart}}% - \else - \addcontentsline{toc}{part}{#1}% - \fi - \markboth{}{}% - { \tf@partformat - \interlinepenalty \@M - \ifnum \c@secnumdepth >-2\relax - \partname\nobreakspace\thepart - \par\nobreak - \vspace*{1\baselineskip}% - \fi - \ifstrempty{#2}% - {}% - {#2\par\nobreak}}% - \vspace{\dimexpr 3\tf@singlelineskip -\baselineskip \relax}} - -\def\@spart#1{% - { \tf@partformat - \interlinepenalty \@M - #1\par\nobreak}% - \vspace{\dimexpr 3\tf@singlelineskip -\baselineskip \relax}} - +% Sections: \section* adjustment to space after heading +\newif\if@adjustssect\@adjustssecttrue +\newlength\tf@ssectafterskip % Sections: command to disable differentiate and reformat \section* \gdef\noadjustssect{\@adjustssectionfalse} -% Sections: \section* adjustment to space after heading -\newif\if@adjustssection\@adjustssectiontrue -\newlength\tf@ssect@afterskip -\setlength\tf@ssect@afterskip{1\p@} +% Sections: \section* heading formatting hook +\def\tf@ssectformat#1{#1} -% Sections: adjustment to space after \section heading -\newif\if@tf@adjustsection\@tf@adjustsectionfalse -\newlength\tf@sect@afterskip -\setlength\tf@sect@afterskip{1\p@} - -% Sections: redefine \@startsection to differentiate starred version +% Sections: redefine \@startsection to support \if@adjustssect and \tf@ssectformat \def\@startsection#1#2#3#4#5#6{% \if@noskipsec \leavevmode \fi \par \@tempskipa #4\relax \@afterindenttrue \ifdim \@tempskipa <\z@ - \@tempskipa -\@tempskipa \tf@afterindent + \@tempskipa -\@tempskipa \@afterindentfalse \fi \if@nobreak \everypar{} \else \addpenalty\@secpenalty\addvspace\@tempskipa \fi - \setlength\tf@ssect@afterskip{\dimexpr #5 -\tf@adjaftersec \relax} - \if@adjustssection - \ifstrequal{#1}{section}% - {\setlength\tf@ssect@afterskip{% - \dimexpr 2\tf@singlelineskip -\tf@adjaftersec \relax}}% - {} - \fi - \setlength\tf@sect@afterskip{\dimexpr #5 -\tf@adjaftersec \relax} - \if@tf@adjustsection - \ifstrequal{#1}{section}% - {\setlength\tf@sect@afterskip{% - \dimexpr 2\tf@singlelineskip -\tf@adjaftersec \relax}}% - {} + \setlength\tf@ssectafterskip{#5} + \ifnum #2 =1 + \if@adjustssect \setlength\tf@ssectafterskip{2\tf@singlelineskip} \fi \fi \@ifstar - {\@ssect{#3}{#4}{\tf@ssect@afterskip}{#6}}% - {\@dblarg{\@sect{#1}{#2}{#3}{#4}{\tf@sect@afterskip}{#6}}}} + {\@ssect{#3}{#4}{\tf@ssectafterskip}{\tf@ssectformat{#6}}}% + {\@dblarg{\@sect{#1}{#2}{#3}{#4}{#5}{#6}}}} -% Sections: formatting between \@svsec and heading -\protected@edef\tf@secsep#1#2{\@empty} -% Sections: formatting of TOC \addcontentsline -\def\tf@tocline#1{\protect{\csname the#1\endcsname\quad}} +% Part: formatting (unsupported) +\def\tf@partformat{\normalfont\bfseries\centering} -% Sections: redefine \@sect to support optional two-line formatting -\def\@sect#1#2#3#4#5#6[#7]#8{% - \ifnum #2>\c@secnumdepth - \let\@svsec\@empty - \else - \refstepcounter{#1}% - \protected@edef\@svsec{\@seccntformat{#1}\relax}% - \fi - \@tempskipa #5\relax - \ifdim \@tempskipa>\z@ - \begingroup - #6{% - \@hangfrom{\hskip #3\relax\@svsec}% - \interlinepenalty \@M \tf@secsep{#1}{#8}#8\@@par}% - \endgroup - \csname #1mark\endcsname{#7}% - \addcontentsline{toc}{#1}{% - \ifnum #2>\c@secnumdepth \else - \tf@tocline{#1}% - \fi - #7}% +\def\@part[#1]#2{% + \@afterindenttrue + \ifnum \c@secnumdepth >\m@ne + \refstepcounter{part}% + \addcontentsline{toc}{part}{\protect{\partname\space\thepart}}% \else - \def\@svsechd{% - #6{\hskip #3\relax\@svsec #8}% - \csname #1mark\endcsname{#7}% - \addcontentsline{toc}{#1}{% - \ifnum #2>\c@secnumdepth \else - \tf@tocline{#1}% - \fi - #7}}% + \addcontentsline{toc}{part}{#1}% \fi - \@xsect{#5}} + \markboth{}{}% + \begingroup + \setlength\parskip{\tf@singlelineskip} + \singlespacing + \interlinepenalty \@M + \tf@partformat{% + \ifnum \c@secnumdepth >\m@ne + \partname\nobreakspace\thepart\relax\@@par + \fi% + #2\@@par}% + \endgroup + \vskip 2\tf@singlelineskip + \@afterheading} + +\def\@spart#1{% + \@afterindenttrue + { \singlespacing + \interlinepenalty \@M + \tf@partformat{#1\@@par}}% + \vskip 2\tf@singlelineskip + \@afterheading} % Title page: commands for use with \maketitle @@ -230,7 +181,7 @@ % Formatting for titlepage option \renewcommand{\maketitle}{% \begin{titlepage}% - \tf@setfnpunct{} + \def\tf@thefnpunct{\,\,} \renewcommand*{\thefootnote}{\fnsymbol{footnote}} \let\footnoterule\relax \normalfont\normalsize\centering\singlespacing @@ -276,7 +227,6 @@ % Table of Contents, List of Figures, and List of Tables: item number alignment -%\def\numberline#1{\hb@xt@\@tempdima{\hfil #1\hspace{1em}}} \def\@tocrmarg{0.75in} \def\@pnumwidth{3.5ex} @@ -288,30 +238,33 @@ \renewcommand*{\l@part}[2]{% \ifnum \c@tocdepth >-2\relax \addpenalty{-\@highpenalty}% - \addvspace{1\baselineskip}% + \vskip 2\tf@singlelineskip % \setlength\@tempdima{0.5in}% - \vskip \tf@singlelineskip - { \parindent \z@ - \rightskip \z@ + { \parindent \z@ \rightskip \z@ \parfillskip -\@rightskip \leavevmode \advance\leftskip\@tempdima \hskip -\leftskip \bfseries #1\nobreak\hfil \nobreak\par} + \if@compatibility + \global\@nobreaktrue + \everypar{\global\@nobreakfalse\everypar{}}% + \fi \fi} \renewcommand*{\l@section}[2]{% \ifnum \c@tocdepth >\z@ \addpenalty\@secpenalty - \setlength\@tempdima{\z@}% \vskip \tf@singlelineskip - { \parindent \z@ - \rightskip \@tocrmarg + \setlength\@tempdima{\z@}% + \begingroup + \parindent \z@ \rightskip \@tocrmarg \parfillskip -\rightskip \leavevmode \advance\leftskip\@tempdima \hskip -\leftskip - #1\nobreak\hfil \nobreak\hb@xt@\@pnumwidth{\hss #2}\par} + #1\nobreak\hfil \nobreak\hb@xt@\@pnumwidth{\hss #2}\par + \endgroup \fi} \renewcommand*{\l@subsection}{% @@ -344,31 +297,43 @@ % Appendixes: adjust formatting of section headings \def\tf@appendixsecfrmt{% - \DeclareRobustCommand{\@seccntformat}[1]{% - \ifstrequal{##1}{section}% - {\appendixname\space \csname the##1\endcsname}% - {\csname the##1\endcsname\quad}} - \DeclareRobustCommand{\tf@secsep}[2]{% - \ifstrequal{##1}{section}% - {\ifstrempty{##2}{}{\par\nobreak}}% - {\@empty}} - \def\tf@tocline##1{\appendixname\space \csname the##1\endcsname.\quad} - \@tf@adjustsectiontrue} + \def\thesection{\@Alph\c@section} + \protect\def\tf@makesectionhead##1##2##3##4##5{% + \vskip -\tf@singlelineskip\relax + \ifnum ##2 =1 + \begingroup + \singlespacing + \interlinepenalty \@M + ##4{\appendixname\space\thesection\relax\@@par ##5\@@par}% + \vskip \tf@singlelineskip + \endgroup + \else + \begingroup + \singlespacing + ##4{% + \@hangfrom{\hskip ##3\relax\@svsec}% + \interlinepenalty \@M ##5\@@par}% + \endgroup + \fi} + \def\tf@tocline##1##2{% + \ifnum ##2 =1 + \protect{\appendixname\space\thesection.\quad} + \else + \protect{\csname the##1\endcsname\quad} + \fi}} % Appendixes: make environment \newenvironment{appendixes}% {% \setcounter{secnumdepth}{1} - \tf@appendixsecfrmt - \setcounter{section}{0}% - \setcounter{subsection}{0}% - \gdef\thesection{\@Alph\c@section}% + \setcounter{section}{0} + \setcounter{subsection}{0} + \tf@appendixsecfrmt% }% {% \setcounter{secnumdepth}{0}% \setcounter{section}{0}% \setcounter{subsection}{0}% - \gdef\thesection{\@arabic\c@section}% }% % Appendixes: remove \appendix command @@ -377,14 +342,10 @@ % Endnotes: Notes heading formatted as \section* \if@endnotesformat - \renewcommand{\enoteheading}{% + \def\enoteheading{% \section*{\notesname}% - \markboth{\notesname}{\notesname}% - \addcontentsline{toc}{section}{\notesname}% - \vspace{\dimexpr -4\tf@singlelineskip +1\baselineskip \relax} - \singlespacing\mbox{}% - \def\tf@adjaftersec{\dimexpr \tf@singlelineskip -\p@ \relax} - \let\tf@afterindent\@afterindenttrue}% + \markboth{}{}% + \addcontentsline{toc}{section}{\notesname}} \fi diff --git a/macros/latex/contrib/turabian-formatting/turabian-thesis.cls b/macros/latex/contrib/turabian-formatting/turabian-thesis.cls index a95a62a7b6..0fdcff0aa4 100644 --- a/macros/latex/contrib/turabian-formatting/turabian-thesis.cls +++ b/macros/latex/contrib/turabian-formatting/turabian-thesis.cls @@ -4,7 +4,7 @@ % and Dissertations," 9th edition. % % ============================== -% Copyright 2013-2018 Omar Abdool +% Copyright 2013-2020 Omar Abdool % % This work may be distributed and/or modified under the conditions of the LaTeX % Project Public License (LPPL), either version 1.3 of this license or (at your @@ -27,7 +27,7 @@ \NeedsTeXFormat{LaTeX2e} -\ProvidesClass{turabian-thesis}[2018/08/01 Turabian Theses and Dissertations] +\ProvidesClass{turabian-thesis}[2020/03/19 Turabian Theses and Dissertations] % Default point size @@ -128,57 +128,56 @@ \if@openright \cleardoublepage \else \clearpage \fi \secdef\@part\@spart} -\def\tf@partformat{\normalfont\bfseries\normalsize\singlespacing\centering} +\def\tf@partformat{\normalfont\bfseries\normalsize\centering} % Part: heading with empty page \def\@part[#1]#2{% \ifnum \c@secnumdepth >-2\relax - \if@mainmatter - \refstepcounter{part}% - \addcontentsline{toc}{part}% - {\protect\numberline{\partname\space\thepart}#1}% - \else - \addcontentsline{toc}{part}{#1}% - \fi + \refstepcounter{part} + \setcounter{footnote}{0} + \addcontentsline{toc}{part}% + {\protect\numberline{\partname\space\thepart}#1} \else - \addcontentsline{toc}{part}{#1}% + \addcontentsline{toc}{part}{#1} \fi - \markboth{}{}% - { \tf@partformat + \markboth{}{} + \thispagestyle{empty} + \begingroup + \setlength\parskip{\tf@singlelineskip} + \singlespacing \interlinepenalty \@M - \thispagestyle{empty}% - \ifnum \c@secnumdepth >-2\relax - \if@mainmatter - \partname\nobreakspace\thepart - \par\nobreak - \vspace*{1\baselineskip}% - \fi - \fi - #2\par} + \tf@partformat{ + \ifnum \c@secnumdepth >-2\relax + \partname\nobreakspace\thepart\relax\@@par + \fi% + #1\@@par}% + \endgroup \@endpart} % Part: heading with plain page style; allows following part description \def\@spart#1{% \ifnum \c@secnumdepth >-2\relax - \if@mainmatter - \refstepcounter{part}% - \addcontentsline{toc}{part}% - {\protect\numberline{\partname\space\thepart}#1}% - \fi + \refstepcounter{part} + \setcounter{footnote}{0} + \addcontentsline{toc}{part}% + {\protect\numberline{\partname\space\thepart}#1} + \else + \addcontentsline{toc}{part}{#1} \fi - \markboth{}{}% - { \tf@partformat + \markboth{}{} + \thispagestyle{plain} + \begingroup + \setlength\parskip{\tf@singlelineskip} + \singlespacing \interlinepenalty \@M - \thispagestyle{plain}% - \ifnum \c@secnumdepth >-2\relax - \if@mainmatter - \partname\nobreakspace\thepart - \par\nobreak - \vspace*{1\baselineskip}% - \fi - \fi - \ifstrempty{#1}{}{#1\par\nobreak}}% - \vspace{\dimexpr 3\tf@singlelineskip -\baselineskip \relax} + \tf@partformat{ + \ifnum \c@secnumdepth >-2\relax + \partname\nobreakspace\thepart\relax\@@par + \fi% + #1\@@par}% + \endgroup + \vskip 2\tf@singlelineskip + \@afterindenttrue \@afterheading} \def\@endpart{\if@openright \cleardoublepage \else \clearpage \fi} @@ -220,83 +219,62 @@ \@tfchapterbeforefalse \fi} -% Chapter: formatting -\def\tf@chapformat{\normalfont\bfseries\normalsize\singlespacing\centering} - -\newlength\tf@adjafterchapskip -\setlength\tf@adjafterchapskip{\z@} - -\def\tf@setafterchapskip{% - \setlength\tf@adjafterchapskip{% - \dimexpr 3\tf@singlelineskip -\baselineskip \relax}} - +% Chapter: heading layout \def\@chapter[#1]#2{% \@figuredblnumfalse \@tabledblnumfalse - \tf@afterindent + \@afterindenttrue \ifnum \c@secnumdepth >\m@ne + \setcounter{footnote}{0} \if@mainmatter \tf@chapcounter - \typeout{\@chapapp\space\thechapter.}% + \typeout{\@chapapp\space\thechapter} \addcontentsline{toc}{chapter}% - {\protect\numberline{\@chapapp\space\thechapter}#1}% + {\protect\numberline{\@chapapp\space\thechapter}#1} + \tf@endnotesection{\@chapapp\space\thechapter} \else \tf@restoreftcounters - \addcontentsline{toc}{chapter}{#1}% + \addcontentsline{toc}{chapter}{#1} + \tf@endnotesection{#1} \fi \else - \addcontentsline{toc}{chapter}{#1}% + \addcontentsline{toc}{chapter}{#1} \fi - \chaptermark{#1}% - \@makechapterhead{#2}% + \chaptermark{#1} + \@makechapterhead{#2} \@afterheading} \def\@schapter#1{% \@figuredblnumfalse \@tabledblnumfalse \tf@restoreftcounters - \tf@afterindent - \@makeschapterhead{#1}% + \@afterindenttrue + \@makeschapterhead{#1} \@afterheading} +% Chapter: heading formatting +\def\tf@chapformat{\normalfont\bfseries\normalsize\centering} + \def\@makechapterhead#1{% - \tf@setafterchapskip - { \tf@chapformat - \ifnum \c@secnumdepth >\m@ne - \if@mainmatter - \@chapapp\space \thechapter - \par\nobreak - \vspace*{1\baselineskip}% - \fi - \fi + \begingroup + \setlength\parskip{\tf@singlelineskip} + \singlespacing \interlinepenalty\@M - \ifstrempty{#1}{}{#1\par\nobreak \vspace{\tf@adjafterchapskip}}}} + \tf@chapformat{ + \ifnum \c@secnumdepth >\m@ne + \if@mainmatter + \@chapapp\space \thechapter\relax\@@par + \fi% + \fi% + #1\@@par} + \endgroup + \vskip 2\tf@singlelineskip} \def\@makeschapterhead#1{% - \tf@setafterchapskip - { \tf@chapformat + { \singlespacing \interlinepenalty\@M - #1\par\nobreak - \vspace{\tf@adjafterchapskip}}} - - -% Sections: redefine \@startsection to support adjusting space after section headings -\def\@startsection#1#2#3#4#5#6{% - \if@noskipsec \leavevmode \fi - \par - \@tempskipa #4\relax - \@afterindenttrue - \ifdim \@tempskipa <\z@ - \@tempskipa -\@tempskipa \tf@afterindent - \fi - \if@nobreak - \everypar{}% - \else - \addpenalty\@secpenalty\addvspace\@tempskipa - \fi - \@ifstar - {\@ssect{#3}{#4}{\dimexpr #5 -\tf@adjaftersec \relax}{#6}}% - {\@dblarg{\@sect{#1}{#2}{#3}{#4}{\dimexpr #5 -\tf@adjaftersec \relax}{#6}}}} + \tf@chapformat{#1}\par\nobreak}% + \vskip 2\tf@singlelineskip} % Title page: commands for use with \maketitle @@ -357,7 +335,7 @@ \renewcommand{\maketitle}{% \begin{titlepage}% \singlespacing - \tf@setfnpunct{} + \def\tf@thefnpunct{\,\,} \renewcommand*{\thefootnote}{\fnsymbol{footnote}} \let\footnoterule\relax \normalfont\normalsize @@ -404,9 +382,8 @@ \renewcommand*{\l@part}[2]{% \ifnum \c@tocdepth >-2\relax \addpenalty{-\@highpenalty}% - \addvspace{1\baselineskip}% + \vskip 2\tf@singlelineskip % \setlength\@tempdima{1.25in}% - \vskip 1\baselineskip { \parindent \z@ \rightskip \z@ \parfillskip -\@rightskip @@ -433,7 +410,7 @@ \renewcommand*{\l@section}{% \ifnum \c@tocdepth >\z@ \vskip \tf@singlelineskip \fi - \@dottedtocline{1}{1.5in}{\z@}} + \@dottedtocline{1}{1.25in}{\z@}} \renewcommand*{\l@subsection}{% \ifnum \c@tocdepth >1 \vskip \tf@singlelineskip \fi @@ -493,19 +470,36 @@ \newcounter{appendix} +% Appendixes: heading formatting +\def\tf@appendixchapfrmt{% + \def\thechapter{\@Alph\c@appendix} + \def\@chapapp{\appendixname}% + \protect\def\@chapter[##1]##2{% + \tf@appendixcounter + \setcounter{footnote}{0} + \@afterindenttrue + \typeout{\@chapapp\space\thechapter} + \addcontentsline{toc}{chapter}% + {\protect\numberline{\@chapapp\space\thechapter}##1} + \chaptermark{##1} + \tf@endnotesection{\@chapapp\space\thechapter} + \begingroup + \setlength\parskip{\tf@singlelineskip} + \singlespacing + \interlinepenalty\@M + \tf@chapformat{\@chapapp\space \thechapter\@@par ##2\@@par} + \endgroup + \vskip 2\tf@singlelineskip + \@afterheading}} + \newenvironment{appendixes}% {% - \@mainmattertrue - \setcounter{section}{0}% - \def\@chapapp{\appendixname}% - \def\thechapter{\@Alph\c@appendix} - \def\tf@chapcounter{\refstepcounter{appendix}} \if@doublenumerate \if@tfchapterbefore \else \setcounter{tf@tempchapfcnt}{\value{figure}} \setcounter{tf@tempchaptcnt}{\value{table}} \fi - \def\tf@chapcounter{% + \def\tf@appendixcounter{% \refstepcounter{appendix} \@figuredblnumtrue \@tabledblnumtrue} @@ -513,70 +507,48 @@ \setcounter{table}{0} \def\tf@figuredblnumprefix{A} \def\tf@tabledblnumprefix{A} + \else + \def\tf@appendixcounter{% + \refstepcounter{appendix} + \@figuredblnumfalse + \@tabledblnumfalse} \fi + \tf@appendixchapfrmt% }% {% \if@doublenumerate \setcounter{figure}{\value{tf@tempchapfcnt}} \setcounter{table}{\value{tf@tempchaptcnt}} - \fi + \fi% } % Appendixes: remove \appendix command \def\appendix{\@empty} -% Endnotes: layout and formatting +% Endnotes: reset endnote counter and create endnote section heading +\def\tf@endnotesection#1{% + \if@endnotesformat + \setcounter{endnote}{0} + \if@enotesopen + \addtoendnotes{\noexpand\tf@enotesechead{#1}} + \fi + \fi} +% Endnotes: format and make endnote section heading if followed by an endnote \if@endnotesformat + \def\tf@enotesechead#1{% + \@ifnextchar\@doanenote% + {\vskip\tf@singlelineskip\relax \section*{#1}}% + {}} +\fi - \let\tf@chapter\chapter - - \@addtoreset{endnote}{chapter} - - % Renew Notes heading formatted as \chapter* (also added to Table of Content) - \renewcommand{\enoteheading}{% - \tf@chapter*{\notesname}% - \@mkboth{\notesname}{\notesname}% - \addcontentsline{toc}{chapter}{\notesname}% - \vspace{\dimexpr -5\tf@singlelineskip +1\baselineskip \relax}% - \singlespacing\mbox{}% - \def\tf@adjaftersec{\dimexpr \tf@singlelineskip -\p@ \relax} - \let\tf@afterindent\@afterindenttrue}% - - % Renew \chapter command to: (1) reset endnotes counter at each chapter, and (2) add subheadings for each chapter in \endnotes formatting. - \RenewDocumentCommand{\chapter}{som}{% - \IfBooleanTF{#1}% - {% if \chapter* - \tf@chapter*{#3}% - \setcounter{endnote}{0}% - \addtoendnotes{% - \noexpand\tf@enotedivider% - {\noexpand\section*}{\unexpanded{#3}}}% - }% - {% if \chapter - \IfNoValueTF{#2}% - {\tf@chapter{#3}}% - {\tf@chapter[#2]{#3}}% - \setcounter{endnote}{0}% - \if@mainmatter - \addtoendnotes{% - \noexpand\tf@enotedivider% - {\noexpand\section*}{\@chapapp\space \thechapter}}% - \else - \addtoendnotes{% - \noexpand\tf@enotedivider% - {\noexpand\section*}{\unexpanded{#3}}}% - \fi - }} - - % Empty subheading divider before \theendnotes for use with \tf@enotedivider - \preto{\theendnotes}{% - \addtoendnotes{\noexpand\tf@enotedivider{}{}}} - - % Make endnote divider if not followed by another endnote divider - \def\tf@enotedivider#1#2{\@ifnextchar\tf@enotedivider{}{#1{#2}}}% - +% Endnotes: Notes heading formatted as \chapter* +\if@endnotesformat + \def\enoteheading{% + \chapter*{\notesname}% + \@mkboth{}{}% + \addcontentsline{toc}{chapter}{\notesname}} \fi diff --git a/macros/latex/contrib/xsim/README b/macros/latex/contrib/xsim/README index e99d361202..3d29077438 100644 --- a/macros/latex/contrib/xsim/README +++ b/macros/latex/contrib/xsim/README @@ -1,5 +1,5 @@ -------------------------------------------------------------------------- -XSIM 2020/03/16 v0.19 +XSIM 2020/03/19 v0.19a XSIMVERB 2019/12/29 v0.1a eXercise Sheets IMproved diff --git a/macros/latex/contrib/xsim/code/xsim.modules.code.tex b/macros/latex/contrib/xsim/code/xsim.modules.code.tex index 51b595fdd3..c487c73036 100644 --- a/macros/latex/contrib/xsim/code/xsim.modules.code.tex +++ b/macros/latex/contrib/xsim/code/xsim.modules.code.tex @@ -54,6 +54,8 @@ % ---------------------------------------------------------------------------- +\cs_generate_variant:Nn \str_if_eq:nnF {xx} + \tl_const:Nn \c__xsim_module_extension_tl {code.tex} \tl_const:Nn \c__xsim_module_prefix_tl {xsim} diff --git a/macros/latex/contrib/xsim/code/xsim.sty b/macros/latex/contrib/xsim/code/xsim.sty index 79ab9b4b80..9ab9d38680 100644 --- a/macros/latex/contrib/xsim/code/xsim.sty +++ b/macros/latex/contrib/xsim/code/xsim.sty @@ -29,10 +29,10 @@ \ExplSyntaxOn -\tl_const:Nn \c_xsim_date_tl {2020/03/16} +\tl_const:Nn \c_xsim_date_tl {2020/03/19} \tl_const:Nn \c_xsim_version_major_number_tl {0} \tl_const:Nn \c_xsim_version_minor_number_tl {19} -\tl_const:Nn \c_xsim_version_subrelease_tl {} +\tl_const:Nn \c_xsim_version_subrelease_tl {a} \tl_const:Nx \c_xsim_version_number_tl { \c_xsim_version_major_number_tl . diff --git a/macros/latex/contrib/xsim/doc/xsim-manual.cls b/macros/latex/contrib/xsim/doc/xsim-manual.cls index e40029df10..c3353f6c4e 100644 --- a/macros/latex/contrib/xsim/doc/xsim-manual.cls +++ b/macros/latex/contrib/xsim/doc/xsim-manual.cls @@ -970,6 +970,7 @@ \xsim@add@version{0.17} {2020-02-21} \xsim@add@version{0.18} {2020-02-23} \xsim@add@version{0.19} {2020-03-16} +\xsim@add@version{0.19a} {2020-03-19} % ---------------------------------------------------------------------------- \newrobustcmd*\xsimauxfileinfo{% diff --git a/macros/latex/contrib/xsim/doc/xsim.history b/macros/latex/contrib/xsim/doc/xsim.history index b957f1e1da..b72b43baa5 100644 --- a/macros/latex/contrib/xsim/doc/xsim.history +++ b/macros/latex/contrib/xsim/doc/xsim.history @@ -153,3 +153,4 @@ HISTORY: correct values when exercises (of different types) are nested - new load-time option `debug' - only for development + v0.19a 2020/03/18 - fix missing-variant-bug introduced with the last update diff --git a/macros/latex/contrib/xsim/doc/xsim_manual.pdf b/macros/latex/contrib/xsim/doc/xsim_manual.pdf Binary files differindex f3d4e64233..9f8ec3ae69 100644 --- a/macros/latex/contrib/xsim/doc/xsim_manual.pdf +++ b/macros/latex/contrib/xsim/doc/xsim_manual.pdf |