diff options
| author | Norbert Preining <norbert@preining.info> | 2021-09-24 03:01:47 +0000 |
|---|---|---|
| committer | Norbert Preining <norbert@preining.info> | 2021-09-24 03:01:47 +0000 |
| commit | 5d714d9476cbb90b125ff14a9d764ad90bb7c2ed (patch) | |
| tree | b426e6a4c96fc80fefa171542b39fd4725b7aea2 /macros/latex/contrib/glossaries | |
| parent | a26e6aee249adb0efff5d0eecaa2dfb8794585a5 (diff) | |
CTAN sync 202109240301
Diffstat (limited to 'macros/latex/contrib/glossaries')
66 files changed, 34469 insertions, 23263 deletions
diff --git a/macros/latex/contrib/glossaries/CHANGES b/macros/latex/contrib/glossaries/CHANGES index 9b66723996..95fcef16c5 100644 --- a/macros/latex/contrib/glossaries/CHANGES +++ b/macros/latex/contrib/glossaries/CHANGES @@ -1,5 +1,111 @@ glossaries change log: +v4.47 (2021-09-20): + + * added new files containing dummy entries for testing: + + - example-glossaries-longchild.tex + - example-glossaries-childmultipar.tex + + * glossaries.sty: + + - Rollback to v4.46 is available, if necessary: + + \usepackage{glossaries}[=v4.46] + + - bug fix #173 https://www.dickimaw-books.com/bugtracker.php?key=173 + (.glsdefs not updated if entry definition modified) + + This bug fix has also led to support for the use of the 'see' key + within the document environment. + + ** Delete your .glsdefs files on upgrading ** + + Note that this update slightly changes the format of the .glsdefs file. + If you have a system that parses this file (for example, to pick + up labels for autocompletion) it will need to be modified. + + Old format: + +\ifglsentryexists{<label>}{}% +{% +\gls@defglossaryentry{<label>}% +{% +<key value list> +}% +}% + + New format: + +\glsdefs@newdocentry{<label>}% +{% +<key value list> +}% + + - bug fix #162 https://www.dickimaw-books.com/bugtracker.php?key=162 + (\newacronym without \setacronymstyle but with + \glsnoexpandfields has incorrect plurals) + + - bug fix #166 https://www.dickimaw-books.com/bugtracker.php?key=166 + (\ also needs escaping with makeindex's quote character in the + event that the sort value contains commands like \| or \! with + sanitizesort=true) + + - bug file #177 https://www.dickimaw-books.com/bugtracker.php?key=177 + (spurious \glolist@ at the end of glslabels file with writeglslabels option) + + - new package option 'writeglslabelnames' + (as writeglslabels but also writes the name) + + - added warnings to deprecated acronym style package options + 'description', 'footnote', 'smaller', 'smallcaps', 'dua' + and corresponding commands, such as \SetDescriptionFootnoteAcronymStyle. + + (These package options and commands were deprecated in v4.02 2013-12-05 + and have been labelled as deprecated in the manual since then.) + The warnings can be suppressed with the 'nowarn' package option + but it's better to use \setacronymstyle instead (or switch to + glossaries-extra's abbreviations). + + - replaced some instances of \edef with \protected@edef when + defining control sequences that store labels or lists of + labels. Similarly for \xdef and \eappto. (Aiming towards + support for UTF-8 characters in labels with PDFLaTeX, but may + not be fully implemented so not yet documented.) + + Note that letter group formations using TeX + (\printnoidxglossary or \printunsrtglossary without bib2gls) still + don't work if the sort value starts with a UTF-8 character with + PDFLaTeX. (This is also a limitation of makeindex regardless of + the TeX engine.) + + - added internal command \@makeglossaries@warn@noprintglossary + + * makeglossaries-lite: + + - added hybrid instructions if glossaries-extra record option detected but not + \makeglossaries + + - bug fix #183 https://www.dickimaw-books.com/bugtracker.php?key=183 + ("bad argument #1 to 'gsub'" when \makeglossaries missing) + + - Only add double-quotes if filename contains any spaces + (should address issue #129) + + * makeglossaries: + + - added hybrid instructions if glossaries-extra record option detected but not + \makeglossaries + + - only add double-quotes to makeindex/xindy if space occurs in + the pathname. (Issue #129 for makeglossaries-lite will probably + also cause the same problem for makeglossaries since it relates + to the behaviour of certain versions of cmd.exe in Windows.) + + * user manual: + + - some sections have been rearranged. + v4.46 (2020-03-19): * glossaries.sty: diff --git a/macros/latex/contrib/glossaries/README.md b/macros/latex/contrib/glossaries/README.md index e50691e1c8..aa4dddd044 100644 --- a/macros/latex/contrib/glossaries/README.md +++ b/macros/latex/contrib/glossaries/README.md @@ -1,4 +1,4 @@ -# glossaries v4.46 (2020-03-19) +# glossaries v4.47 (2021-09-20) Author: Nicola Talbot ([contact](http://www.dickimaw-books.com/contact)) @@ -8,7 +8,7 @@ This material is subject to the LaTeX Project Public License. See http://www.ctan.org/license/lppl1.3 for the details of that license. -Copyright 2007-2020 Nicola Talbot +Copyright 2007-2021 Nicola Talbot ## DESCRIPTION diff --git a/macros/latex/contrib/glossaries/glossaries-code.pdf b/macros/latex/contrib/glossaries/glossaries-code.pdf Binary files differindex f96bdbddfc..4cdb4e8dbc 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 a71a00fa29..e046b89f54 100644 --- a/macros/latex/contrib/glossaries/glossaries-user.html +++ b/macros/latex/contrib/glossaries/glossaries-user.html @@ -6,8 +6,8 @@ > <head><title></title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)" /> -<meta name="originator" content="TeX4ht (http://www.tug.org/tex4ht/)" /> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" /> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)" /> <!-- xhtml,fn-in,css-in,uni-html4,utf8 --> <meta name="src" content="glossaries-user.tex" /> @@ -28,6 +28,7 @@ .cmtt-12{font-family: monospace,monospace;} .cmbx-10{ font-weight: bold;} .cmbx-10{ font-weight: bold;} +.cmbx-10{ font-weight: bold;} .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} .cmss-10{ font-family: sans-serif;} @@ -45,6 +46,9 @@ .cmssbx-10{ font-family: sans-serif; font-weight: bold;} .cmssbx-10{ font-family: sans-serif; font-weight: bold;} .cmr-9{font-size:90%;} +.cmbx-8{font-size:80%; font-weight: bold;} +.cmbx-8{ font-weight: bold;} +.cmbx-8{ font-weight: bold;} .cmtt-8{font-size:80%;font-family: monospace,monospace;} .cmtt-8{font-family: monospace,monospace;} .cmtt-8{font-family: monospace,monospace;} @@ -71,6 +75,7 @@ .cmss-8{ font-family: sans-serif;} .cmbx-12{font-size:120%; font-weight: bold;} .cmbx-12{ font-weight: bold;} +.cmbx-12{ font-weight: bold;} .tctt-1000{font-family: monospace,monospace;} .cmti-8{font-size:80%; font-style: italic;} .cmitt-10{font-family: monospace,monospace; font-style: italic;} @@ -86,15 +91,19 @@ p.indent{text-indent:0;} p + p{margin-top:1em;} p + div, p + pre {margin-top:1em;} div + p, pre + p {margin-top:1em;} +a { overflow-wrap: break-word; word-wrap: break-word; word-break: break-word; hyphens: auto; } @media print {div.crosslinks {visibility:hidden;}} a img { border-top: 0; border-left: 0; border-right: 0; } center { margin-top:1em; margin-bottom:1em; } td center { margin-top:0em; margin-bottom:0em; } .Canvas { position:relative; } img.math{vertical-align:middle;} +div.par-math-display, div.math-display{text-align:center;} li p.indent { text-indent: 0em } li p:first-child{ margin-top:0em; } +li p:first-child{ margin-bottom; } li p:last-child, li div:last-child { margin-bottom:0.5em; } +li p:first-child{ margin-bottom:0; } li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; } .enumerate1 {list-style-type:decimal;} .enumerate2 {list-style-type:lower-alpha;} @@ -108,7 +117,7 @@ div.obeylines-v p { margin-top:0; margin-bottom:0; } td.displaylines {text-align:center; white-space:nowrap;} .centerline {text-align:center;} .rightline {text-align:right;} -div.verbatim {font-family: monospace,monospace; white-space: nowrap; text-align:left; clear:both; } +pre.verbatim {font-family: monospace,monospace; text-align:left; clear:both; } .fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } div.fbox {display:table} div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } @@ -179,17 +188,16 @@ p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } .paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} .subparagraphHead, .likesubparagraphHead { font-weight: bold;} -.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;} .verse{white-space:nowrap; margin-left:2em} div.maketitle {text-align:center;} h2.titleHead{text-align:center;} div.maketitle{ margin-bottom: 2em; } div.author, div.date {text-align:center;} div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } -.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } h1.partHead{text-align: center} -.abstract p {margin-left:5%; margin-right:5%;} +div.abstract p {margin-left:5%; margin-right:5%;} div.abstract {width:100%;} +.abstracttitle{text-align:center;margin-bottom:1em;} div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } table.tabular td p{margin-top:0em;} table.tabular {margin-left: auto; margin-right: auto;} @@ -210,7 +218,7 @@ table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } .hline hr, .cline hr{border:none;border-top:1px solid black;} div.array {text-align:center;} .alltt P { margin-bottom : 0em; margin-top : 0em; } -.alltt { margin-bottom : 1em; margin-top : 1em; } +.alltt { margin-bottom : 1em; margin-top : 1em; font-family:monospace,monospace; } .equation td{text-align:center; } .equation-star td{text-align:center; } table.equation-star { width:100%; } @@ -1284,6 +1292,32 @@ span#textcolor1050{color:#008080} span#textcolor1051{color:#008080} span#textcolor1052{color:#008080} span#textcolor1053{color:#008080} +span#textcolor1054{color:#008080} +span#textcolor1055{color:#008080} +span#textcolor1056{color:#008080} +span#textcolor1057{color:#008080} +span#textcolor1058{color:#008080} +span#textcolor1059{color:#008080} +span#textcolor1060{color:#008080} +span#textcolor1061{color:#008080} +span#textcolor1062{color:#008080} +span#textcolor1063{color:#008080} +span#textcolor1064{color:#008080} +span#textcolor1065{color:#008080} +span#textcolor1066{color:#008080} +span#textcolor1067{color:#008080} +span#textcolor1068{color:#008080} +span#textcolor1069{color:#008080} +span#textcolor1070{color:#008080} +span#textcolor1071{color:#008080} +span#textcolor1072{color:#008080} +span#textcolor1073{color:#008080} +span#textcolor1074{color:#008080} +span#textcolor1075{color:#008080} +span#textcolor1076{color:#008080} +span#textcolor1077{color:#008080} +span#textcolor1078{color:#008080} +span#textcolor1079{color:#008080} span#textcolor3{color:#008080} /* end css.sty */ @@ -1292,23 +1326,23 @@ span#textcolor3{color:#008080} </style> </head><body > -<!--l. 679--><p class="noindent" ><a +<!--l. 690--><p class="noindent" ><a id="top"></a> -</p><!--l. 679--><p class="indent" > +</p><!--l. 690--><p class="indent" > -</p><!--l. 679--><p class="indent" > +</p><!--l. 690--><p class="indent" > </p> <div class="center" > -<!--l. 679--><p class="noindent" > -</p><!--l. 679--><p class="noindent" ><span -class="cmr-17">User Manual for glossaries.sty v4.46</span> +<!--l. 690--><p class="noindent" > +</p><!--l. 690--><p class="noindent" ><span +class="cmr-17">User Manual for glossaries.sty v4.47</span> </p> <div class="tabular"> <table id="TBL-1" class="tabular" -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" @@ -1320,36 +1354,35 @@ class="td11"> <a 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-03-19</span></p></div> +<!--l. 690--><p class="noindent" ><span +class="cmr-12">2021-09-20</span></p></div> <div class="abstract" > -<!--l. 681--><p class="indent" > +<!--l. 692--><p class="indent" > </p> -<div class="center" -> -<!--l. 681--><p class="noindent" > -</p><!--l. 681--><p class="noindent" ><span -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 TeX or using a supplementary -<a + <h3 class="abstracttitle"> +<span +class="cmbx-10">Abstract</span> +</h3> +<!--l. 693--><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 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 -href="#sec:samples">§19 </a><a -href="#sec:samples">Sample -Documents<!--tex4ht:ref: sec:samples --></a>. -</p><!--l. 688--><p class="indent" > +class="cmss-10">glossaries </span>package. These are +listed in <a +href="#sec:samples">§18 </a><a +href="#sec:samples">Sample Documents<!--tex4ht:ref: sec:samples --></a>. +</p><!--l. 699--><p class="indent" > </p> </div> -<!--l. 690--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> Additional features not provided here may be available through the extension package <a +<!--l. 701--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> Additional features not provided here may be available through the extension package <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> which, if required, needs to be installed separately. New features will be added to <span @@ -1364,8 +1397,8 @@ class="cmtt-10">bib2gls</span><a id="dx1-2"></a></a>) which isn’t available with just the base <span class="cmss-10">glossaries </span>package. </div> -</p><!--l. 698--><p class="noindent" > -</p><!--l. 700--><p class="indent" > If you require multilingual support you must also separately install the relevant language module. Each +</p><!--l. 709--><p class="noindent" > +</p><!--l. 711--><p class="indent" > If you require multilingual support you must also separately install the relevant language module. Each language module is distributed under the name <span class="cmtt-10">glossaries-</span>⟨<span class="cmti-10">language</span>⟩, where ⟨<span @@ -1385,7 +1418,7 @@ class="cmtt-10">title</span><a id="dx1-4"></a> key in <span class="cmtt-10">\printglossary</span>.) -</p><!--l. 713--><p class="indent" > The <span +</p><!--l. 724--><p class="indent" > The <span class="cmss-10">glossaries </span>package requires a number of other packages including, but not limited to, <span class="cmss-10">tracklang</span><a id="dx1-5"></a>, <span @@ -1412,7 +1445,7 @@ see, for example, <a 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 +</p><!--l. 739--><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 by <span class="cmss-10">glossaries</span>. For example, a package ⟨<span @@ -1424,143 +1457,148 @@ class="cmss-10">amsgen</span><a id="dx1-15"></a>), then ⟨<span class="cmti-10">X</span>⟩, and finally load <span class="cmss-10">glossaries</span>. -</p><!--l. 734--><p class="indent" > <div class="important" title="Important Note"> Documents have wide-ranging styles when it comes to presenting glossaries or lists of terms or +</p><!--l. 745--><p class="indent" > <div class="important" title="Important Note"> Documents have wide-ranging styles when it comes to presenting glossaries or lists of terms or notation. People have their own preferences and to a large extent this is determined by the kind of information that needs to go in the glossary. They may just have symbols with terse descriptions or they may have long technical words with complicated descriptions. The <span class="cmss-10">glossaries </span>package is flexible enough to accommodate such varied requirements, but this flexibility comes at a price: a big manual. -</p><!--l. 744--><p class="indent" > 😱 If you’re freaking out at the size of this manual, start with <span +</p><!--l. 755--><p class="indent" > 😱 If you’re freaking out at the size of this manual, start with <span class="cmtt-10">glossariesbegin.pdf </span>(“The glossaries package: a guide for beginnners”). You should find it in the same directory as this document or try <span class="cmtt-10">texdoc</span> <span class="cmtt-10">glossariesbegin.pdf</span>. Once you’ve got to grips with the basics, then come back to this manual to find out how to adjust the settings. </div> -</p><!--l. 750--><p class="noindent" > -</p><!--l. 752--><p class="noindent" >The <span -class="cmss-10">glossaries </span>bundle comes with the following documentation: +</p><!--l. 761--><p class="noindent" > +</p><!--l. 763--><p class="noindent" >The <span +class="cmss-10">glossaries </span>bundle includes the following documentation: </p><dl class="description"><dt class="description"> + <!--l. 766--><p class="noindent" > <a href="glossariesbegin.pdf" class="url" ><span -class="cmtt-10">glossariesbegin.pdf</span></a> </dt><dd -class="description">If you are a complete beginner, start with <a -href="glossariesbegin.html" >“The glossaries package: a guide for - beginners”</a>. - </dd><dt class="description"> -<a -href="glossary2glossaries.pdf" class="url" ><span -class="cmtt-10">glossary2glossaries.pdf</span></a> </dt><dd -class="description">If you are moving over from the obsolete <span -class="cmss-10">glossary</span><a - id="dx1-16"></a> package, read <a -href="glossary2glossaries.html" >“Upgrading - from the glossary package to the glossaries package”</a>. +class="cmtt-10">glossariesbegin.pdf</span></a> </p></dt><dd +class="description"> + <!--l. 766--><p class="noindent" >If you are a complete beginner, start with <a +href="glossariesbegin.html" >“The glossaries package: a guide for beginners”</a>. + </p></dd><dt class="description"> + <!--l. 771--><p class="noindent" > - </dd><dt class="description"> <span -class="cmbx-10">glossaries-user.pdf</span> </dt><dd -class="description">This document is the main user guide for the <span +class="cmbx-10">glossaries-user.pdf</span> </p></dt><dd +class="description"> + <!--l. 771--><p class="noindent" >This document is the main user guide for the <span class="cmss-10">glossaries </span>package. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 775--><p class="noindent" > <a 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.46”. - </dd><dt class="description"> -<span -class="cmbx-10">INSTALL</span> </dt><dd -class="description">Installation instructions. - </dd><dt class="description"> +class="cmtt-10">glossaries-code.pdf</span></a> </p></dt><dd +class="description"> + <!--l. 775--><p class="noindent" >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.47”. + </p></dd><dt class="description"> + <!--l. 780--><p class="noindent" > <span -class="cmbx-10">CHANGES</span> </dt><dd -class="description">Change log. - </dd><dt class="description"> +class="cmbx-10">CHANGES</span> </p></dt><dd +class="description"> + <!--l. 780--><p class="noindent" >Change log. + </p></dd><dt class="description"> + <!--l. 782--><p class="noindent" > <span -class="cmbx-10">README.md</span> </dt><dd -class="description">Package summary. +class="cmbx-10">README.md</span> </p></dt><dd +class="description"> + <!--l. 782--><p class="noindent" >Package summary. +</p> </dd></dl> -<!--l. 781--><p class="noindent" >Related resources: </p> +<!--l. 785--><p class="noindent" >Related resources: </p> <ul class="itemize1"> - <li class="itemize"><a + <li class="itemize"> + <!--l. 787--><p class="noindent" ><a 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>. - </li> - <li class="itemize"><a + </p></li> + <li class="itemize"> + <!--l. 789--><p class="noindent" ><a href="http://www.dickimaw-books.com/faqs/glossariesfaq.html" ><span class="cmss-10">glossaries </span>FAQ</a> - </li> - <li class="itemize"><a + </p></li> + <li class="itemize"> + <!--l. 792--><p class="noindent" ><a href="https://www.dickimaw-books.com/gallery/#glossaries" ><span -class="cmtt-10">https://www.dickimaw-books.com/gallery/#glossaries</span></a><span -class="cmss-10">glossaries </span>gallery - </li> - <li class="itemize"><a +class="cmss-10">glossaries </span>gallery</a> + </p></li> + <li class="itemize"> + <!--l. 795--><p class="noindent" ><a href="https://www.dickimaw-books.com/gallery/glossaries-styles/" >a summary of all glossary styles provided by <span class="cmss-10">glossaries </span>and <span class="cmss-10">glossaries-extra</span></a> - </li> - <li class="itemize"><a + </p></li> + <li class="itemize"> + <!--l. 799--><p class="noindent" ><a href="https://www.dickimaw-books.com/gallery/glossaries-performance.shtml" ><span class="cmss-10">glossaries </span>performance</a> (comparing document build times for the different options provided by <span class="cmss-10">glossaries </span>and <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>). - </li> - <li class="itemize"><a + + + </p></li> + <li class="itemize"> + <!--l. 803--><p class="noindent" ><a href="http://www.dickimaw-books.com/latex/thesis/" >Using LaTeX to Write a PhD Thesis</a> (chapter 6). - </li> - <li class="itemize"><a + </p></li> + <li class="itemize"> + <!--l. 807--><p class="noindent" ><a href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a> - </li> - <li class="itemize">The <a + </p></li> + <li class="itemize"> + <!--l. 809--><p class="noindent" >The <a href="http://ctan.org/pkg/glossaries-extra" ><span class="cmss-10">glossaries-extra </span>package</a> - </li> - <li class="itemize"><a + </p></li> + <li class="itemize"> + <!--l. 812--><p class="noindent" ><a href="http://ctan.org/pkg/bib2gls" ><span -class="cmtt-10">bib2gls</span></a></li></ul> -<!--l. 811--><p class="indent" > <div class="important" title="Important Note"><span class="warningsymbol">⚠</span> If you use <span +class="cmtt-10">bib2gls</span></a></p></li></ul> +<!--l. 815--><p class="indent" > <div class="important" title="Important Note"><span class="warningsymbol">⚠</span> If you use <span class="cmss-10">hyperref</span><a - id="dx1-17"></a> and <span + id="dx1-16"></a> and <span class="cmss-10">glossaries</span>, you must load <span class="cmss-10">hyperref</span><a - id="dx1-18"></a> <span + id="dx1-17"></a> <span class="cmti-10">first </span>(although <span class="cmss-10">hyperref</span><a - id="dx1-19"></a> should be loaded after + id="dx1-18"></a> should be loaded after most other packages). Similarly the <span class="cmss-10">doc</span><a - id="dx1-20"></a> package must also be loaded before <span + id="dx1-19"></a> package must also be loaded before <span class="cmss-10">glossaries</span>. (If <span class="cmss-10">doc</span><a - id="dx1-21"></a> is loaded, the file + id="dx1-20"></a> is loaded, the file extensions for the default main glossary are changed to <span class="cmtt-10">gls2</span><a - id="dx1-22"></a>, <span + id="dx1-21"></a>, <span class="cmtt-10">glo2</span><a - id="dx1-23"></a> and <span + id="dx1-22"></a> and <span class="cmtt-10">glg2</span><a - id="dx1-24"></a> to avoid conflict with <span + id="dx1-23"></a> to avoid conflict with <span class="cmss-10">doc</span><a - id="dx1-25"></a>’s changes + id="dx1-24"></a>’s changes glossary.)<a id="pdflatexnote"></a> - - -</p><!--l. 821--><p class="indent" > If you are using <span +</p><!--l. 825--><p class="indent" > If you are using <span class="cmss-10">hyperref</span><a - id="dx1-26"></a>, it’s best to use <span + id="dx1-25"></a>, it’s best to use <span class="cmtt-10">pdflatex</span><a - id="dx1-27"></a> rather than <span + id="dx1-26"></a> rather than <span class="cmtt-10">latex</span><a - id="dx1-28"></a> (DVI format) as <span + id="dx1-27"></a> (DVI format) as <span class="cmtt-10">pdflatex </span>deals with hyperlinks much better. If you use the DVI format, you will encounter problems where you have long hyperlinks or hyperlinks in subscripts or superscripts. This is an issue with the DVI format not with <span @@ -1570,12 +1608,12 @@ need to use the DVI format and have a problem with hyperlinks in maths mode, I r href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> with the <span id="textcolor1"><span class="cmss-10">hyperoutside</span></span><a - id="dx1-29"></a> and <span id="textcolor2"><span + id="dx1-28"></a> and <span id="textcolor2"><span class="cmss-10">textformat</span></span><a - id="dx1-30"></a> attributes set to appropriate values for problematic entries. + id="dx1-29"></a> attributes set to appropriate values for problematic entries. </div> -</p><!--l. 831--><p class="noindent" > -</p><!--l. 834--><p class="indent" > <strong>The <span +</p><!--l. 835--><p class="noindent" > +</p><!--l. 838--><p class="indent" > <strong>The <span class="cmss-10">glossaries </span>package replaces the <span class="cmss-10">glossary </span>package which is now obsolete.</strong> Please see the document <a @@ -1600,6 +1638,8 @@ href="#sec:lipsum" id="QQ2-1-14">Dummy Entries for Testing</a></span> href="#sec:languages" id="QQ2-1-15">Multi-Lingual Support</a></span> <br />   <span class="subsectionToc" >1.3.1 <a href="#sec:fixednames" id="QQ2-1-16">Changing the Fixed Names</a></span> +<br />   <span class="subsectionToc" >1.3.2 <a +href="#pluralsuffix" id="QQ2-1-18">Creating a New Language Module</a></span> <br />  <span class="sectionToc" >1.4 <a href="#sec:makeglossaries" id="QQ2-1-19">Generating the Associated Glossary Files</a></span> <br />   <span class="subsectionToc" >1.4.1 <a @@ -1607,9 +1647,9 @@ href="#sec:makeglossariesapp" id="QQ2-1-21">Using the makeglossaries Perl Script <br />   <span class="subsectionToc" >1.4.2 <a href="#sec:makeglossarieslua" id="QQ2-1-22">Using the makeglossaries-lite Lua Script</a></span> <br />   <span class="subsectionToc" >1.4.3 <a -href="#sec:xindyapp" id="QQ2-1-23">Using xindy explicitly (Option 3)</a></span> +href="#sec:xindyapp" id="QQ2-1-23">Using xindy explicitly (Option3)</a></span> <br />   <span class="subsectionToc" >1.4.4 <a -href="#sec:makeindexapp" id="QQ2-1-24">Using makeindex explicitly (Option 2)</a></span> +href="#sec:makeindexapp" id="QQ2-1-24">Using makeindex explicitly (Option2)</a></span> <br />  <span class="sectionToc" >1.5 <a href="#sec:notedev" id="QQ2-1-25">Note to Front-End and Script Developers</a></span> <br />   <span class="subsectionToc" >1.5.1 <a @@ -1623,184 +1663,188 @@ href="#sec:pkgopts" id="QQ2-1-29">Package Options</a></span> <br />  <span class="sectionToc" >2.1 <a href="#sec:pkgopts-general" id="QQ2-1-30">General Options</a></span> <br />  <span class="sectionToc" >2.2 <a -href="#sec:pkgopts-sec" id="QQ2-1-42">Sectioning, Headings and TOC Options</a></span> +href="#sec:pkgopts-sec" id="QQ2-1-43">Sectioning, Headings and TOC Options</a></span> <br />  <span class="sectionToc" >2.3 <a -href="#sec:pkgopts-printglos" id="QQ2-1-48">Glossary Appearance Options</a></span> +href="#sec:pkgopts-printglos" id="QQ2-1-49">Glossary Appearance Options</a></span> <br />  <span class="sectionToc" >2.4 <a -href="#sec:pkgopts-indexing" id="QQ2-1-65">Indexing Options</a></span> +href="#sec:pkgopts-indexing" id="QQ2-1-66">Indexing Options</a></span> <br />  <span class="sectionToc" >2.5 <a -href="#sec:pkgopts-sort" id="QQ2-1-75">Sorting Options</a></span> +href="#sec:pkgopts-sort" id="QQ2-1-76">Sorting Options</a></span> <br />  <span class="sectionToc" >2.6 <a -href="#sec:pkgopts-type" id="QQ2-1-86">Glossary Type Options</a></span> +href="#sec:pkgopts-type" id="QQ2-1-87">Glossary Type Options</a></span> <br />  <span class="sectionToc" >2.7 <a -href="#sec:pkgopts-acronym" id="QQ2-1-93">Acronym and Abbreviation Options</a></span> -<br />   <span class="subsectionToc" >2.7.1 <a -href="#sec:pkgopts-old-acronym" id="QQ2-1-99">Deprecated Acronym Style Options</a></span> +href="#sec:pkgopts-acronym" id="QQ2-1-94">Acronym and Abbreviation Options</a></span> <br />  <span class="sectionToc" >2.8 <a -href="#sec:pkgopts-other" id="QQ2-1-105">Other Options</a></span> +href="#sec:pkgopts-old-acronym" id="QQ2-1-100">Deprecated Acronym Style Options</a></span> <br />  <span class="sectionToc" >2.9 <a -href="#sec:setupglossaries" id="QQ2-1-112">Setting Options After the Package is Loaded</a></span> +href="#sec:pkgopts-other" id="QQ2-1-106">Other Options</a></span> +<br />  <span class="sectionToc" >2.10 <a +href="#sec:setupglossaries" id="QQ2-1-113">Setting Options After the Package is Loaded</a></span> <br /> <span class="chapterToc" >3 <a -href="#sec:setup" id="QQ2-1-113">Setting Up</a></span> +href="#sec:setup" id="QQ2-1-114">Setting Up</a></span> <br />  <span class="sectionToc" >3.1 <a -href="#sec:setupopt1" id="QQ2-1-114">Option 1</a></span> +href="#sec:setupopt1" id="QQ2-1-115">Option 1</a></span> <br />  <span class="sectionToc" >3.2 <a -href="#sec:setupopt23" id="QQ2-1-115">Options 2 and 3</a></span> +href="#sec:setupopt23" id="QQ2-1-116">Options 2 and 3</a></span> <br /> <span class="chapterToc" >4 <a -href="#sec:newglosentry" id="QQ2-1-116">Defining Glossary Entries</a></span> +href="#sec:newglosentry" id="QQ2-1-117">Defining Glossary Entries</a></span> <br />  <span class="sectionToc" >4.1 <a -href="#sec:plurals" id="QQ2-1-117">Plurals</a></span> +href="#sec:plurals" id="QQ2-1-118">Plurals</a></span> <br />  <span class="sectionToc" >4.2 <a -href="#sec:grammar" id="QQ2-1-118">Other Grammatical Constructs</a></span> +href="#sec:grammar" id="QQ2-1-119">Other Grammatical Constructs</a></span> <br />  <span class="sectionToc" >4.3 <a -href="#sec:addkey" id="QQ2-1-119">Additional Keys</a></span> +href="#sec:addkey" id="QQ2-1-120">Additional Keys</a></span> <br />   <span class="subsectionToc" >4.3.1 <a -href="#sec:glsaddkey" id="QQ2-1-120">Document Keys</a></span> -<br />   <span class="subsectionToc" >4.3.2 <a -href="#sec:glsaddstoragekey" id="QQ2-1-121">Storage Keys</a></span> +href="#sec:glsaddkey" id="QQ2-1-121">Document Keys</a></span> +<br />   <span class="subsectionToc" >4.3.2 <a +href="#sec:glsaddstoragekey" id="QQ2-1-122">Storage Keys</a></span> <br />  <span class="sectionToc" >4.4 <a -href="#sec:expansion" id="QQ2-1-122">Expansion</a></span> +href="#sec:expansion" id="QQ2-1-123">Expansion</a></span> <br />  <span class="sectionToc" >4.5 <a -href="#sec:subentries" id="QQ2-1-124">Sub-Entries</a></span> +href="#sec:subentries" id="QQ2-1-125">Sub-Entries</a></span> <br />   <span class="subsectionToc" >4.5.1 <a -href="#sec:hierarchical" id="QQ2-1-125">Hierarchical Categories</a></span> +href="#sec:hierarchical" id="QQ2-1-126">Hierarchical Categories</a></span> <br />   <span class="subsectionToc" >4.5.2 <a -href="#sec:homographs" id="QQ2-1-126">Homographs</a></span> +href="#sec:homographs" id="QQ2-1-127">Homographs</a></span> <br />  <span class="sectionToc" >4.6 <a -href="#sec:loadglsentries" id="QQ2-1-127">Loading Entries From a File</a></span> +href="#sec:loadglsentries" id="QQ2-1-128">Loading Entries From a File</a></span> <br />  <span class="sectionToc" >4.7 <a -href="#sec:moveentry" id="QQ2-1-128">Moving Entries to Another Glossary</a></span> +href="#sec:moveentry" id="QQ2-1-129">Moving Entries to Another Glossary</a></span> <br />  <span class="sectionToc" >4.8 <a -href="#sec:docdefs" id="QQ2-1-129">Drawbacks With Defining Entries in the Document Environment</a></span> +href="#sec:docdefs" id="QQ2-1-130">Drawbacks With Defining Entries in the Document Environment</a></span> <br />   <span class="subsectionToc" >4.8.1 <a -href="#sec:techissues" id="QQ2-1-130">Technical Issues</a></span> +href="#sec:techissues" id="QQ2-1-131">Technical Issues</a></span> <br />   <span class="subsectionToc" >4.8.2 <a -href="#sec:goodpractice" id="QQ2-1-131">Good Practice Issues</a></span> +href="#sec:goodpractice" id="QQ2-1-132">Good Practice Issues</a></span> <br /> <span class="chapterToc" >5 <a -href="#sec:numberlists" id="QQ2-1-132">Number lists</a></span> +href="#sec:usingentries" id="QQ2-1-133">Referencing Entries in the Document</a></span> <br />  <span class="sectionToc" >5.1 <a -href="#sec:encap" id="QQ2-1-133">Encap Values</a></span> +href="#sec:glslink" id="QQ2-1-134">Links to Glossary Entries</a></span> +<br />   <span class="subsectionToc" >5.1.1 <a +href="#sec:gls-like" id="QQ2-1-136">The <span +class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)</a></span> +<br />   <span class="subsectionToc" >5.1.2 <a +href="#sec:glstext-like" id="QQ2-1-137">The <span +class="cmtt-10">\glstext</span>-Like Commands (First Use Flag Not Queried)</a></span> +<br />   <span class="subsectionToc" >5.1.3 <a +href="#sec:glsdisplay" id="QQ2-1-138">Changing the format of the link text</a></span> +<br />   <span class="subsectionToc" >5.1.4 <a +href="#sec:disablehyperlinks" id="QQ2-1-139">Enabling and disabling hyperlinks to glossary entries</a></span> <br />  <span class="sectionToc" >5.2 <a -href="#sec:locationsyntax" id="QQ2-1-134">Locations</a></span> -<br />  <span class="sectionToc" >5.3 <a -href="#sec:ranges" id="QQ2-1-135">Range Formations</a></span> -<br />  <span class="sectionToc" >5.4 <a -href="#sec:isthook" id="QQ2-1-136">Style Hook</a></span> +href="#sec:glsnolink" id="QQ2-1-140">Using Glossary Terms Without Links</a></span> <br /> <span class="chapterToc" >6 <a -href="#sec:glslink" id="QQ2-1-137">Links to Glossary Entries</a></span> +href="#sec:acronyms" id="QQ2-1-141">Acronyms and Other Abbreviations</a></span> <br />  <span class="sectionToc" >6.1 <a -href="#sec:gls-like" id="QQ2-1-139">The <span -class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)</a></span> +href="#sec:longshortfull" id="QQ2-1-142">Displaying the Long, Short and Full Forms (Independent of First Use)</a></span> <br />  <span class="sectionToc" >6.2 <a -href="#sec:glstext-like" id="QQ2-1-140">The <span -class="cmtt-10">\glstext</span>-Like Commands (First Use Flag Not Queried)</a></span> +href="#sec:setacronymstyle" id="QQ2-1-144">Changing the Acronym Style</a></span> +<br />   <span class="subsectionToc" >6.2.1 <a +href="#sec:predefinedacrstyles" id="QQ2-1-145">Predefined Acronym Styles</a></span> +<br />   <span class="subsectionToc" >6.2.2 <a +href="#sec:customacronym" id="QQ2-1-146">Defining A Custom Acronym Style</a></span> <br />  <span class="sectionToc" >6.3 <a -href="#sec:glsdisplay" id="QQ2-1-141">Changing the format of the link text</a></span> +href="#sec:disploa" id="QQ2-1-147">Displaying the List of Acronyms</a></span> <br />  <span class="sectionToc" >6.4 <a -href="#sec:disablehyperlinks" id="QQ2-1-142">Enabling and disabling hyperlinks to glossary entries</a></span> +href="#sec:oldacronym" id="QQ2-1-148">Upgrading From the glossary Package</a></span> <br /> <span class="chapterToc" >7 <a -href="#sec:glsadd" id="QQ2-1-143">Adding an Entry to the Glossary Without Generating Text</a></span> +href="#sec:glsunset" id="QQ2-1-150">Unsetting and Resetting Entry Flags</a></span> +<br />  <span class="sectionToc" >7.1 <a +href="#sec:enableentrycount" id="QQ2-1-151">Counting the Number of Times an Entry has been Used (First Use Flag Unset)</a></span> <br /> <span class="chapterToc" >8 <a -href="#sec:crossref" id="QQ2-1-144">Cross-Referencing Entries</a></span> -<br />  <span class="sectionToc" >8.1 <a -href="#sec:customxr" id="QQ2-1-145">Customising Cross-reference Text</a></span> +href="#sec:printglossary" id="QQ2-1-152">Displaying a Glossary</a></span> <br /> <span class="chapterToc" >9 <a -href="#sec:glsnolink" id="QQ2-1-146">Using Glossary Terms Without Links</a></span> +href="#sec:newglossary" id="QQ2-1-153">Defining New Glossaries</a></span> <br /> <span class="chapterToc" >10 <a -href="#sec:printglossary" id="QQ2-1-147">Displaying a glossary</a></span> +href="#sec:glsadd" id="QQ2-1-154">Adding an Entry to the Glossary Without Generating Text</a></span> <br /> <span class="chapterToc" >11 <a -href="#sec:xindy" id="QQ2-1-148">Xindy (Option 3)</a></span> +href="#sec:crossref" id="QQ2-1-155">Cross-Referencing Entries</a></span> <br />  <span class="sectionToc" >11.1 <a -href="#sec:langenc" id="QQ2-1-149">Language and Encodings</a></span> -<br />  <span class="sectionToc" >11.2 <a -href="#sec:xindyloc" id="QQ2-1-150">Locations and Number lists</a></span> -<br />  <span class="sectionToc" >11.3 <a -href="#sec:groups" id="QQ2-1-151">Glossary Groups</a></span> +href="#sec:customxr" id="QQ2-1-156">Customising Cross-reference Text</a></span> <br /> <span class="chapterToc" >12 <a -href="#sec:newglossary" id="QQ2-1-152">Defining New Glossaries</a></span> +href="#sec:numberlists" id="QQ2-1-157">Number Lists</a></span> +<br />  <span class="sectionToc" >12.1 <a +href="#sec:encap" id="QQ2-1-158">Encap Values (Location Formats)</a></span> +<br />  <span class="sectionToc" >12.2 <a +href="#sec:locationsyntax" id="QQ2-1-159">Locations</a></span> +<br />  <span class="sectionToc" >12.3 <a +href="#sec:ranges" id="QQ2-1-160">Range Formations</a></span> +<br />  <span class="sectionToc" >12.4 <a +href="#sec:isthook" id="QQ2-1-161">Style Hook</a></span> <br /> <span class="chapterToc" >13 <a -href="#sec:acronyms" id="QQ2-1-153">Acronyms and Other Abbreviations</a></span> +href="#sec:styles" id="QQ2-1-162">Glossary Styles</a></span> <br />  <span class="sectionToc" >13.1 <a -href="#sec:setacronymstyle" id="QQ2-1-155">Changing the Abbreviation Style</a></span> +href="#sec:predefinedstyles" id="QQ2-1-163">Predefined Styles</a></span> <br />   <span class="subsectionToc" >13.1.1 <a -href="#sec:predefinedacrstyles" id="QQ2-1-156">Predefined Acronym Styles</a></span> +href="#sec:liststyles" id="QQ2-1-165">List Styles</a></span> <br />   <span class="subsectionToc" >13.1.2 <a -href="#sec:customacronym" id="QQ2-1-157">Defining A Custom Acronym Style</a></span> +href="#sec:longstyles" id="QQ2-1-166">Longtable Styles</a></span> +<br />   <span class="subsectionToc" >13.1.3 <a +href="#sec:longraggedstyles" id="QQ2-1-167">Longtable Styles (Ragged Right)</a></span> +<br />   <span class="subsectionToc" >13.1.4 <a +href="#sec:longbooktabsstyles" id="QQ2-1-168">Longtable Styles (<span +class="cmss-10">booktabs</span>)</a></span> +<br />   <span class="subsectionToc" >13.1.5 <a +href="#sec:superstyles" id="QQ2-1-169">Supertabular Styles</a></span> +<br />   <span class="subsectionToc" >13.1.6 <a +href="#sec:superraggedstyles" id="QQ2-1-170">Supertabular Styles (Ragged Right)</a></span> +<br />   <span class="subsectionToc" >13.1.7 <a +href="#sec:treestyles" id="QQ2-1-171">Tree-Like Styles</a></span> +<br />   <span class="subsectionToc" >13.1.8 <a +href="#sec:mcolstyles" id="QQ2-1-172">Multicols Style</a></span> + + +<br />   <span class="subsectionToc" >13.1.9 <a +href="#sec:inline" id="QQ2-1-174">In-Line Style</a></span> <br />  <span class="sectionToc" >13.2 <a -href="#sec:disploa" id="QQ2-1-158">Displaying the List of Acronyms</a></span> -<br />  <span class="sectionToc" >13.3 <a -href="#sec:oldacronym" id="QQ2-1-159">Upgrading From the glossary Package</a></span> +href="#sec:newglossarystyle" id="QQ2-1-175">Defining your own glossary style</a></span> <br /> <span class="chapterToc" >14 <a -href="#sec:glsunset" id="QQ2-1-161">Unsetting and Resetting Entry Flags</a></span> +href="#sec:xindy" id="QQ2-1-176">Xindy (Option 3)</a></span> <br />  <span class="sectionToc" >14.1 <a -href="#sec:enableentrycount" id="QQ2-1-162">Counting the Number of Times an Entry has been Used (First Use Flag Unset)</a></span> +href="#sec:langenc" id="QQ2-1-177">Language and Encodings</a></span> +<br />  <span class="sectionToc" >14.2 <a +href="#sec:xindyloc" id="QQ2-1-178">Locations and Number lists</a></span> +<br />  <span class="sectionToc" >14.3 <a +href="#sec:groups" id="QQ2-1-179">Glossary Groups</a></span> <br /> <span class="chapterToc" >15 <a -href="#sec:styles" id="QQ2-1-163">Glossary Styles</a></span> +href="#sec:utilities" id="QQ2-1-180">Utilities</a></span> <br />  <span class="sectionToc" >15.1 <a -href="#sec:predefinedstyles" id="QQ2-1-164">Predefined Styles</a></span> -<br />   <span class="subsectionToc" >15.1.1 <a -href="#sec:liststyles" id="QQ2-1-166">List Styles</a></span> -<br />   <span class="subsectionToc" >15.1.2 <a -href="#sec:longstyles" id="QQ2-1-167">Longtable Styles</a></span> -<br />   <span class="subsectionToc" >15.1.3 <a -href="#sec:longraggedstyles" id="QQ2-1-168">Longtable Styles (Ragged Right)</a></span> -<br />   <span class="subsectionToc" >15.1.4 <a -href="#sec:longbooktabsstyles" id="QQ2-1-169">Longtable Styles (<span -class="cmss-10">booktabs</span>)</a></span> -<br />   <span class="subsectionToc" >15.1.5 <a -href="#sec:superstyles" id="QQ2-1-170">Supertabular Styles</a></span> -<br />   <span class="subsectionToc" >15.1.6 <a -href="#sec:superraggedstyles" id="QQ2-1-171">Supertabular Styles (Ragged Right)</a></span> -<br />   <span class="subsectionToc" >15.1.7 <a -href="#sec:treestyles" id="QQ2-1-172">Tree-Like Styles</a></span> - - -<br />   <span class="subsectionToc" >15.1.8 <a -href="#sec:mcolstyles" id="QQ2-1-173">Multicols Style</a></span> -<br />   <span class="subsectionToc" >15.1.9 <a -href="#sec:inline" id="QQ2-1-175">In-Line Style</a></span> +href="#sec:loops" id="QQ2-1-181">Loops</a></span> <br />  <span class="sectionToc" >15.2 <a -href="#sec:newglossarystyle" id="QQ2-1-176">Defining your own glossary style</a></span> +href="#sec:conditionals" id="QQ2-1-182">Conditionals</a></span> +<br />  <span class="sectionToc" >15.3 <a +href="#sec:fetchset" id="QQ2-1-183">Fetching and Updating the Value of a Field</a></span> <br /> <span class="chapterToc" >16 <a -href="#sec:utilities" id="QQ2-1-177">Utilities</a></span> -<br />  <span class="sectionToc" >16.1 <a -href="#sec:loops" id="QQ2-1-178">Loops</a></span> -<br />  <span class="sectionToc" >16.2 <a -href="#sec:conditionals" id="QQ2-1-179">Conditionals</a></span> -<br />  <span class="sectionToc" >16.3 <a -href="#sec:fetchset" id="QQ2-1-180">Fetching and Updating the Value of a Field</a></span> +href="#sec:prefix" id="QQ2-1-184">Prefixes or Determiners</a></span> <br /> <span class="chapterToc" >17 <a -href="#sec:prefix" id="QQ2-1-181">Prefixes or Determiners</a></span> +href="#sec:accsupp" id="QQ2-1-185">Accessibility Support</a></span> <br /> <span class="chapterToc" >18 <a -href="#sec:accsupp" id="QQ2-1-182">Accessibility Support</a></span> +href="#sec:samples" id="QQ2-1-186">Sample Documents</a></span> +<br />  <span class="sectionToc" >18.1 <a +href="#sec:samplesbasic" id="QQ2-1-187">Basic</a></span> +<br />  <span class="sectionToc" >18.2 <a +href="#sec:sampleacronyms" id="QQ2-1-190">Acronyms and First Use</a></span> +<br />  <span class="sectionToc" >18.3 <a +href="#sec:samplecounter" id="QQ2-1-200">Non-Page Locations</a></span> +<br />  <span class="sectionToc" >18.4 <a +href="#sec:samplestype" id="QQ2-1-204">Multiple Glossaries</a></span> +<br />  <span class="sectionToc" >18.5 <a +href="#sec:samplessort" id="QQ2-1-209">Sorting</a></span> +<br />  <span class="sectionToc" >18.6 <a +href="#sec:samplesparent" id="QQ2-1-212">Child Entries</a></span> +<br />  <span class="sectionToc" >18.7 <a +href="#sec:samplescrossref" id="QQ2-1-216">Cross-Referencing</a></span> +<br />  <span class="sectionToc" >18.8 <a +href="#sec:samplescustomkeys" id="QQ2-1-218">Custom Keys</a></span> +<br />  <span class="sectionToc" >18.9 <a +href="#sec:samplesxindy" id="QQ2-1-223">Xindy (Option 3)</a></span> +<br />  <span class="sectionToc" >18.10 <a +href="#sec:samplesnoidx" id="QQ2-1-228">No Indexing Application (Option 1)</a></span> +<br />  <span class="sectionToc" >18.11 <a +href="#sec:samplesother" id="QQ2-1-231">Other</a></span> <br /> <span class="chapterToc" >19 <a -href="#sec:samples" id="QQ2-1-183">Sample Documents</a></span> -<br />  <span class="sectionToc" >19.1 <a -href="#sec:samplesbasic" id="QQ2-1-184">Basic</a></span> -<br />  <span class="sectionToc" >19.2 <a -href="#sec:sampleacronyms" id="QQ2-1-187">Acronyms and First Use</a></span> -<br />  <span class="sectionToc" >19.3 <a -href="#sec:samplecounter" id="QQ2-1-197">Non-Page Locations</a></span> -<br />  <span class="sectionToc" >19.4 <a -href="#sec:samplestype" id="QQ2-1-201">Multiple Glossaries</a></span> -<br />  <span class="sectionToc" >19.5 <a -href="#sec:samplessort" id="QQ2-1-206">Sorting</a></span> -<br />  <span class="sectionToc" >19.6 <a -href="#sec:samplesparent" id="QQ2-1-209">Child Entries</a></span> -<br />  <span class="sectionToc" >19.7 <a -href="#sec:samplescrossref" id="QQ2-1-213">Cross-Referencing</a></span> -<br />  <span class="sectionToc" >19.8 <a -href="#sec:samplescustomkeys" id="QQ2-1-215">Custom Keys</a></span> -<br />  <span class="sectionToc" >19.9 <a -href="#sec:samplesxindy" id="QQ2-1-220">Xindy (Option 3)</a></span> -<br />  <span class="sectionToc" >19.10 <a -href="#sec:samplesnoidx" id="QQ2-1-225">No Indexing Application (Option 1)</a></span> -<br />  <span class="sectionToc" >19.11 <a -href="#sec:samplesother" id="QQ2-1-228">Other</a></span> -<br /> <span class="chapterToc" >20 <a -href="#sec:trouble" id="QQ2-1-237">Troubleshooting</a></span> +href="#sec:trouble" id="QQ2-1-240">Troubleshooting</a></span> </div> @@ -1816,14 +1860,14 @@ href="#tab:predefinednames">Customised Text</a></span><br /><span class="lotToc" href="#tab:makeglossariesCmds">Commands and package options that have no effect when using xindy or makeindex explicitly</a></span><br /><span class="lotToc" >4.1 <a -href="#tab:fieldmap">Key to Field Mappings</a></span><br /><span class="lotToc" >6.1 <a +href="#tab:fieldmap">Key to Field Mappings</a></span><br /><span class="lotToc" >5.1 <a href="#tab:hyperxx">Predefined Hyperlinked Location -Formats</a></span><br /><span class="lotToc" >13.1 <a +Formats</a></span><br /><span class="lotToc" >6.1 <a href="#tab:shortcuts">Synonyms provided by the package option <span -class="cmss-10">shortcuts</span></a></span><br /><span class="lotToc" >13.2 <a -href="#tab:xspace">The -effect of using xspace</a></span><br /><span class="lotToc" >15.1 <a -href="#tab:styles">Glossary Styles</a></span><br /><span class="lotToc" >15.2 <a +class="cmss-10">shortcuts</span></a></span><br /><span class="lotToc" >6.2 <a +href="#tab:xspace">The effect +of using xspace</a></span><br /><span class="lotToc" >13.1 <a +href="#tab:styles">Glossary Styles</a></span><br /><span class="lotToc" >13.2 <a href="#tab:mcols">Multicolumn Styles</a></span><br /> </div> @@ -1832,16 +1876,17 @@ href="#tab:mcols">Multicolumn Styles</a></span><br /> <!--l. 1--><p class="indent" > <a id="likesection.1"></a><a + id="x1-2001x1"></a><a id="Q1-1-3"></a> </p> <h2 class="likechapterHead"><a - id="x1-3000"></a>Glossary</h2> + id="x1-30001"></a>Glossary</h2> <!--l. 1--><p class="noindent" ><span class="cmti-10">This glossary style was setup using:</span> </p> <table -cellpadding="0" border="0" cellspacing="0" +cellpadding="0" border="0" class="tabbing"><tr style="vertical-align:baseline;" class="tabbing"><td style="width:94;" class="tabbing"><span @@ -1850,35 +1895,35 @@ class="tabbing"><span class="cmtt-10">xindy,</span> </td></tr></table> <!--l. 1--><p class="indent" > </p><table -cellpadding="0" border="0" cellspacing="0" +cellpadding="0" border="0" class="tabbing"><tr style="vertical-align:baseline;" class="tabbing"><td style="width:94;" class="tabbing"> </td><td class="tabbing"><span class="cmtt-10">nonumberlist,</span></td></tr></table> <!--l. 1--><p class="indent" > </p><table -cellpadding="0" border="0" cellspacing="0" +cellpadding="0" border="0" class="tabbing"><tr style="vertical-align:baseline;" class="tabbing"><td style="width:94;" class="tabbing"></td><td class="tabbing"><span class="cmtt-10">toc,</span></td></tr></table> <!--l. 1--><p class="indent" > </p><table -cellpadding="0" border="0" cellspacing="0" +cellpadding="0" border="0" class="tabbing"><tr style="vertical-align:baseline;" class="tabbing"><td style="width:94;" class="tabbing"></td><td class="tabbing"><span class="cmtt-10">nopostdot,</span></td></tr></table> <!--l. 1--><p class="indent" > </p><table -cellpadding="0" border="0" cellspacing="0" +cellpadding="0" border="0" class="tabbing"><tr style="vertical-align:baseline;" class="tabbing"><td style="width:94;" class="tabbing"></td><td class="tabbing"><span class="cmtt-10">style=altlist,</span></td></tr></table> <!--l. 1--><p class="indent" > </p><table -cellpadding="0" border="0" cellspacing="0" +cellpadding="0" border="0" class="tabbing"><tr style="vertical-align:baseline;" class="tabbing"><td style="width:94;" class="tabbing"></td><td @@ -1889,11 +1934,13 @@ class="cmtt-10">glossaries</span><span class="cmsy-10">}</span></td></tr></table> <!--l. 1--><p class="indent" > </p><dl class="description"><dt class="description"> + <!--l. 90--><p class="noindent" > <a id="glo:bib2gls"></a><span class="cmtt-10">bib2gls</span><a - id="dx1-3001"></a> </dt><dd -class="description"><br + id="dx1-3001"></a> </p></dt><dd +class="description"> + <!--l. 90--><p class="noindent" ><br class="newline" />An <a href="#glo:indexingapp">indexing application</a> that combines two functions in one: (1) fetches entry definition from a <span class="cmtt-10">bib</span><a @@ -1915,21 +1962,25 @@ class="cmss-10">glossaries-extra</span></a> and can’t be used with just th class="cmss-10">glossaries </span>package. See <a href="#option4">Option 4</a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 96--><p class="noindent" > <a id="glo:cli"></a><span -class="cmbx-10">Command Line Interface (CLI)</span> </dt><dd -class="description"><br +class="cmbx-10">Command Line Interface (CLI)</span> </p></dt><dd +class="description"> + <!--l. 96--><p class="noindent" ><br class="newline" />An application that doesn’t have a graphical user interface. That is, an application that doesn’t have any windows, buttons or menus and can be run in <a href="http://www.dickimaw-books.com/latex/novices/html/terminal.html" >a command prompt or terminal</a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 109--><p class="noindent" > <a id="glo:convertgls2bib"></a><span class="cmtt-10">convertgls2bib</span><a - id="dx1-3006"></a> </dt><dd -class="description"><br + id="dx1-3006"></a> </p></dt><dd +class="description"> + <!--l. 109--><p class="noindent" ><br class="newline" />An application provided with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a @@ -1942,6 +1993,8 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-3010"></a></a>. This application is designed for files that just contain entry + + definitions, but it can work on a complete document file. However, there will be a lot of “undefined command” warnings as <a href="#glo:convertgls2bib"><span @@ -1954,33 +2007,39 @@ class="cmtt-10">bib2gls</span><a id="dx1-3012"></a></a> v2.0). <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 113--><p class="noindent" > <a id="glo:entrylocation"></a><span class="cmbx-10">Entry location</span><a - id="dx1-3013"></a> </dt><dd -class="description"><br + id="dx1-3013"></a> </p></dt><dd +class="description"> + <!--l. 113--><p class="noindent" ><br class="newline" />The location of the entry in the document. This defaults to the page number on which the entry appears. An entry may have multiple locations. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 121--><p class="noindent" > <a id="glo:exlatinalph"></a><span class="cmbx-10">Extended Latin Alphabet</span><a - id="dx1-3014"></a> </dt><dd -class="description"><br + id="dx1-3014"></a> </p></dt><dd +class="description"> + <!--l. 121--><p class="noindent" ><br class="newline" />An alphabet consisting of <a href="#glo:latinchar">Latin character<a id="dx1-3015"></a>s</a> and <a href="#glo:exlatinchar">extended Latin character<a id="dx1-3016"></a>s</a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 126--><p class="noindent" > <a id="glo:exlatinchar"></a><span class="cmbx-10">Extended Latin Character</span><a - id="dx1-3017"></a> </dt><dd -class="description"><br + id="dx1-3017"></a> </p></dt><dd +class="description"> + <!--l. 126--><p class="noindent" ><br class="newline" />A character that’s created by combining <a href="#glo:latinchar">Latin character<a id="dx1-3018"></a>s</a> to form ligatures (e.g. æ) or by applying @@ -1989,12 +2048,14 @@ href="#glo:latinchar">Latin character<a href="#glo:nonlatinchar">non-Latin character<a id="dx1-3020"></a></a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 161--><p class="noindent" > <a id="glo:firstuse"></a><span class="cmbx-10">First use</span><a - id="dx1-3021"></a> </dt><dd -class="description"><br + id="dx1-3021"></a> </p></dt><dd +class="description"> + <!--l. 161--><p class="noindent" ><br class="newline" />The first time a glossary entry is used (from the start of the document or after a reset) with one of the following commands: <span class="cmtt-10">\gls</span><a @@ -2015,25 +2076,32 @@ href="#glo:firstuseflag">first use flag</a> & <a href="#glo:firstusetext">first use text</a>.) <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 180--><p class="noindent" > <a id="glo:firstuseflag"></a><span class="cmbx-10">First use flag</span><a - id="dx1-3029"></a> </dt><dd -class="description"><br + id="dx1-3029"></a> </p></dt><dd +class="description"> + <!--l. 180--><p class="noindent" ><br class="newline" />A conditional that determines whether or not the entry has been used according to the rules of <a href="#glo:firstuse">first use</a>. Commands to unset or reset this conditional are described in <a -href="#sec:glsunset">§14 </a><a -href="#sec:glsunset">Unsetting and Resetting - Entry Flags<!--tex4ht:ref: sec:glsunset --></a>. <br +href="#sec:glsunset">§<span +class="cmbx-10">??</span>sec:glsunset </a><a +href="#sec:glsunset">Unsetting + and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>. <br class="newline" /> - </dd><dt class="description"> + + + </p></dd><dt class="description"> + <!--l. 182--><p class="noindent" > <a id="glo:firstusetext"></a><span class="cmbx-10">First use text</span><a - id="dx1-3030"></a> </dt><dd -class="description"><br + id="dx1-3030"></a> </p></dt><dd +class="description"> + <!--l. 182--><p class="noindent" ><br class="newline" />The text that is displayed on <a href="#glo:firstuse">first use</a>, which is governed by the <span class="cmtt-10">first</span><a @@ -2048,11 +2116,13 @@ class="cmtt-10">\glsdisp</span><a class="cmtt-10">\defglsentry</span><a id="dx1-3035"></a>.) <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 278--><p class="noindent" > <a id="glo:glossaries-extra"></a><span -class="cmssbx-10">glossaries-extra</span> </dt><dd -class="description"><br +class="cmssbx-10">glossaries-extra</span> </p></dt><dd +class="description"> + <!--l. 278--><p class="noindent" ><br class="newline" />A separate package that extends the <span class="cmss-10">glossaries </span>package, providing new features or improving existing features. If you want to use <span @@ -2061,11 +2131,13 @@ class="cmss-10">glossaries </span>package and the <span class="cmss-10">glossaries-extra </span>package installed. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 298--><p class="noindent" > <a id="glo:indexingapp"></a><span -class="cmbx-10">Indexing application</span> </dt><dd -class="description"><br +class="cmbx-10">Indexing application</span> </p></dt><dd +class="description"> + <!--l. 298--><p class="noindent" ><br 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 @@ -2078,25 +2150,27 @@ class="cmtt-10">xindy</span><a id="dx1-3037"></a></a>. These are both <a href="#glo:cli">command line interface (CLI)</a> applications. <br class="newline" /> - - - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 302--><p class="noindent" > <a id="glo:latinalph"></a><span class="cmbx-10">Latin Alphabet</span><a - id="dx1-3038"></a> </dt><dd -class="description"><br + id="dx1-3038"></a> </p></dt><dd +class="description"> + <!--l. 302--><p class="noindent" ><br class="newline" />The alphabet consisting of <a href="#glo:latinchar">Latin character<a id="dx1-3039"></a>s</a>. See also <a href="#glo:exlatinalph">extended Latin alphabet</a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 306--><p class="noindent" > <a id="glo:latinchar"></a><span class="cmbx-10">Latin Character</span><a - id="dx1-3040"></a> </dt><dd -class="description"><br + id="dx1-3040"></a> </p></dt><dd +class="description"> + <!--l. 306--><p class="noindent" ><br class="newline" />One of the letters <span class="cmtt-10">a</span>, …, <span class="cmtt-10">z</span>, <span @@ -2105,23 +2179,29 @@ class="cmtt-10">Z</span>. See also <a href="#glo:exlatinchar">extended Latin character<a id="dx1-3041"></a></a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 326--><p class="noindent" > <a id="glo:linktext"></a><span class="cmbx-10">Link text</span><a - id="dx1-3042"></a> </dt><dd -class="description"><br + id="dx1-3042"></a> </p></dt><dd +class="description"> + + + <!--l. 326--><p class="noindent" ><br class="newline" />The text produced by commands such as <span class="cmtt-10">\gls</span><a id="dx1-3043"></a>. It may or may not be a hyperlink to the glossary. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 362--><p class="noindent" > <a id="glo:makeglossaries"></a><span class="cmtt-10">makeglossaries</span><a - id="dx1-3044"></a> </dt><dd -class="description"><br + id="dx1-3044"></a> </p></dt><dd +class="description"> + <!--l. 362--><p class="noindent" ><br class="newline" />A custom designed Perl script interface to <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a @@ -2135,12 +2215,14 @@ class="cmtt-10">makeglossaries </span>script into an executable <span class="cmtt-10">makeglossaries.exe </span>for convenience (but Perl is still required). <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 365--><p class="noindent" > <a id="glo:makeglossariesgui"></a><span class="cmtt-10">makeglossariesgui</span><a - id="dx1-3047"></a> </dt><dd -class="description"><br + id="dx1-3047"></a> </p></dt><dd +class="description"> + <!--l. 365--><p class="noindent" ><br class="newline" />A Java GUI alternative to <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a @@ -2148,12 +2230,14 @@ class="cmtt-10">makeglossaries</span><a on <a href="http://ctan.org/pkg/makeglossariesgui" >CTAN</a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 385--><p class="noindent" > <a id="glo:makeglossaries-lite.lua"></a><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-3049"></a> </dt><dd -class="description"><br + id="dx1-3049"></a> </p></dt><dd +class="description"> + <!--l. 385--><p class="noindent" ><br class="newline" />A custom designed Lua script interface to <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a @@ -2175,58 +2259,68 @@ class="cmtt-10">.lua </span>extension) to the actual <span class="cmtt-10">makeglossaries-lite.lua</span> script. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 440--><p class="noindent" > <a id="glo:makeindex"></a><span class="cmtt-10">makeindex</span><a - id="dx1-3053"></a> </dt><dd -class="description"><br + id="dx1-3053"></a> </p></dt><dd +class="description"> + <!--l. 440--><p class="noindent" ><br class="newline" />An <a href="#glo:indexingapp">indexing application</a>. See <a href="#option2">Option 2</a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 448--><p class="noindent" > <a id="glo:nonlatinalph"></a><span class="cmbx-10">Non-Latin Alphabet</span><a - id="dx1-3054"></a> </dt><dd -class="description"><br + id="dx1-3054"></a> </p></dt><dd +class="description"> + + + <!--l. 448--><p class="noindent" ><br class="newline" />An alphabet consisting of <a href="#glo:nonlatinchar">non-Latin character<a id="dx1-3055"></a>s</a>. <br class="newline" /> - - - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 458--><p class="noindent" > <a id="glo:nonlatinchar"></a><span class="cmbx-10">Non-Latin Character</span><a - id="dx1-3056"></a> </dt><dd -class="description"><br + id="dx1-3056"></a> </p></dt><dd +class="description"> + <!--l. 458--><p class="noindent" ><br class="newline" />An <a href="#glo:exlatinchar">extended Latin character<a id="dx1-3057"></a></a> or a character that isn’t a <a href="#glo:latinchar">Latin character<a id="dx1-3058"></a></a>. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 506--><p class="noindent" > <a id="glo:numberlist"></a><span class="cmbx-10">Number list</span><a - id="dx1-3059"></a> </dt><dd -class="description"><br + id="dx1-3059"></a> </p></dt><dd +class="description"> + <!--l. 506--><p class="noindent" ><br class="newline" />A list of <a href="#glo:entrylocation">entry locations</a> (also called a location list). The number list can be suppressed using the <span class="cmss-10">nonumberlist</span><a id="dx1-3060"></a> package option. <br class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 512--><p class="noindent" > <a id="glo:sanitize"></a><span class="cmbx-10">Sanitize</span><a - id="dx1-3061"></a> </dt><dd -class="description"><br + id="dx1-3061"></a> </p></dt><dd +class="description"> + <!--l. 512--><p class="noindent" ><br class="newline" />Converts command names into character sequences. That is, a command called, say, <span class="cmtt-10">\foo</span>, is converted into the sequence of characters: <span @@ -2236,7 +2330,7 @@ class="cmtt-10">o</span>, <span class="cmtt-10">o</span>. Depending on the font, the backslash character may appear as a dash when used in the main document text, so <span class="cmtt-10">\foo </span>will appear as: —foo. - <!--l. 496--><p class="noindent" >Earlier versions of <span + </p><!--l. 512--><p class="noindent" >Earlier versions of <span class="cmss-10">glossaries </span>used this technique to write information to the files used by the indexing applications to prevent problems caused by fragile commands. Now, this is only used for the <span class="cmtt-10">sort</span><a @@ -2244,11 +2338,13 @@ class="cmtt-10">sort</span><a key. <br class="newline" /> </p></dd><dt class="description"> + <!--l. 521--><p class="noindent" > <a id="glo:smallcaps"></a><span class="cmbx-10">Small caps</span><a - id="dx1-3063"></a> </dt><dd -class="description"><br + id="dx1-3063"></a> </p></dt><dd +class="description"> + <!--l. 521--><p class="noindent" ><br class="newline" />Small capitals. The LaTeX kernel provides <span class="cmtt-10">\textsc</span><a id="dx1-3064"></a><span @@ -2272,13 +2368,17 @@ class="cmti-10">text</span>⟩ should be uppercase (otherwise the effect slanted properties. In this case, there will be a font substitution warning and one of the properties (such as small caps or slanted) will be dropped. <br class="newline" /> - </dd><dt class="description"> + + + </p></dd><dt class="description"> + <!--l. 525--><p class="noindent" > <a id="glo:latexexlatinchar"></a><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 + id="dx1-3067"></a> </p></dt><dd +class="description"> + <!--l. 525--><p class="noindent" ><br class="newline" />An <a href="#glo:exlatinchar">extended Latin character<a id="dx1-3068"></a></a> that can be created by a core LaTeX command, such as <span @@ -2286,84 +2386,100 @@ 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 class="newline" /> - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 535--><p class="noindent" > +<a + id="glo:UTF-8"></a><span +class="cmbx-10">UTF-8</span><a + id="dx1-3069"></a> </p></dt><dd +class="description"> + <!--l. 535--><p class="noindent" ><br +class="newline" />A variable-width character encoding. This means that some characters are represented by more + that one byte. XeLaTeX and LuaLaTeX treat the multi-byte sequence as a single token, but the + older LaTeX formats have single-byte tokens, which causes complications. Related blog article: + <a +href="https://www.dickimaw-books.com/blog/binary-files-text-files-and-file-encodings/" >Binary Files, Text Files and File Encodings</a>. <br +class="newline" /> + </p></dd><dt class="description"> + <!--l. 590--><p class="noindent" > <a id="glo:xindy"></a><span class="cmtt-10">xindy</span><a - id="dx1-3069"></a> </dt><dd -class="description"><br + id="dx1-3070"></a> </p></dt><dd +class="description"> + <!--l. 590--><p class="noindent" ><br class="newline" />A flexible <a href="#glo:indexingapp">indexing application</a> with multilingual support written in Perl. See <a href="#option3">Option 3</a>. <br -class="newline" /></dd></dl> +class="newline" /></p></dd></dl> -<!--l. 853--><p class="indent" > <div class="chapter"><h2 class="chapterHead">1. <a +<!--l. 857--><p class="indent" > <div class="chapter"><h2 class="chapterHead">1. <a id="sec:intro"></a>Introduction</h2> -</p><!--l. 856--><p class="indent" > The <span +</p><!--l. 860--><p class="indent" > The <span class="cmss-10">glossaries </span>package is provided to assist generating lists of terms, symbols or abbreviations. (For convenience, these lists are all referred to as glossaries in this manual. The terms, symbols and abbreviations are collectively referred to as entries.) The package has a certain amount of flexibility, allowing the user to customize the format of the glossary and define multiple glossaries. It also supports glossary styles that include an associated symbol (in addition to a name and description) for each glossary entry. -</p><!--l. 866--><p class="indent" > There is provision for loading a database of glossary entries. Only those entries +</p><!--l. 870--><p class="indent" > There is provision for loading a database of glossary entries. Only those entries indexed<span class="footnote-mark"><a href="#fn1x1" id="fn1x1-bk"><sup class="textsuperscript">1.1</sup></a></span><a id="x1-4001f1"></a> in the document will be displayed in the glossary. (Unless you use <a href="#option5">Option 5</a>, which doesn’t use any indexing but will instead list all defined entries in order of definition.) -</p><!--l. 875--><p class="indent" > It’s not necessary to actually have a glossary in the document. You may be interested in using this package +</p><!--l. 879--><p class="indent" > It’s not necessary to actually have a glossary in the document. You may be interested in using this package just as means to consistently format certain types of terms, such as abbreviations, or you may prefer to have descriptions scattered about the document and be able to easily link to the relevant description (<a href="#option6">Option 6</a>). -</p><!--l. 881--><p class="indent" > The simplest document is one without a glossary: +</p><!--l. 885--><p class="indent" > The simplest document is one without a glossary: </p> - <div class="verbatim" id="verbatim-1"> + <pre class="verbatim" id="verbatim-1"> \documentclass{article} - <br />\usepackage[ - <br />  sort=none % no sorting or indexing required - <br />] - <br />{glossaries} - <br />\newglossaryentry - <br /> {cafe}% label - <br /> {% definition: - <br />   name={caf\'e}, - <br />   description={small restaurant selling refreshments} - <br /> } - <br />\setacronymstyle{long-short} - <br />\newacronym - <br /> {html}% label - <br /> {HTML}% short form - <br /> {hypertext markup language}% long form - <br />\newglossaryentry - <br /> {pi}% label - <br /> {% definition: - <br />   name={\ensuremath{\pi}}, - <br />   description={Archimedes' Constant} - <br /> } - <br />\newglossaryentry - <br /> {distance}% label - <br /> {% definition: - <br />   name={distance}, - <br />   description={the length between two points}, - <br />   symbol={m} - <br /> } - <br />\begin{document} - <br />First use: \gls{cafe}, \gls{html}, \gls{pi}. - <br />Next use: \gls{cafe}, \gls{html}, \gls{pi}. - <br />\Gls{distance} (\glsentrydesc{distance}) is measured in - <br />\glssymbol{distance}. - <br />\end{document} -</div> -<!--l. 925--><p class="nopar" > (This is a trivial example. For a real document I recommend you use <span +\usepackage[ +  sort=none % no sorting or indexing required +] +{glossaries} +\newglossaryentry + {cafe}% label + {% definition: +   name={caf\'e}, +   description={small restaurant selling refreshments} + } +\setacronymstyle{long-short} +\newacronym + {html}% label + {HTML}% short form + {hypertext markup language}% long form +\newglossaryentry + {pi}% label + {% definition: +   name={\ensuremath{\pi}}, +   description={Archimedes' Constant} + } +\newglossaryentry + {distance}% label + {% definition: +   name={distance}, +   description={the length between two points}, +   symbol={m} + } +\begin{document} +First use: \gls{cafe}, \gls{html}, \gls{pi}. +Next use: \gls{cafe}, \gls{html}, \gls{pi}. +\Gls{distance} (\glsentrydesc{distance}) is measured in +\glssymbol{distance}. +\end{document} +</pre> +<!--l. 929--><p class="nopar" > (This is a trivial example. For a real document I recommend you use <span class="cmss-10">siunitx</span><a id="dx1-4006"></a> for units.) -</p><!--l. 929--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 933--><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 @@ -2379,10 +2495,10 @@ class="cmss-10">glossaries </span>package): </p> - <div class="verbatim" id="verbatim-2"> + <pre class="verbatim" id="verbatim-2"> \documentclass{article} -</div> -<!--l. 937--><p class="nopar" > </p><div class="alltt"> +</pre> +<!--l. 941--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[</span> @@ -2435,15 +2551,15 @@ class="cmtt-10">]{glossaries-extra}</span> </div> - <div class="verbatim" id="verbatim-3"> + <pre class="verbatim" id="verbatim-3"> \newglossaryentry % provided by glossaries.sty - <br /> {cafe}% label - <br /> {% definition: - <br />   name={caf\'e}, - <br />   description={small restaurant selling refreshments} - <br /> } -</div> -<!--l. 954--><p class="nopar" > </p><div class="alltt"> + {cafe}% label + {% definition: +   name={caf\'e}, +   description={small restaurant selling refreshments} + } +</pre> +<!--l. 958--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">%</span><span @@ -2500,20 +2616,20 @@ class="cmtt-10"> symbol</span> </div> - <div class="verbatim" id="verbatim-4"> + <pre class="verbatim" id="verbatim-4"> \newglossaryentry % provided by glossaries.sty - <br /> {distance}% label - <br /> {% definition: - <br />   name={distance}, - <br />   description={the length between two points}, - <br />   symbol={m} - <br /> } - <br />\begin{document} - <br />First use: \gls{cafe}, \gls{html}, \gls{pi}. - <br />Next use: \gls{cafe}, \gls{html}, \gls{pi}. - <br />\Gls{distance} is measured in \glssymbol{distance}. -</div> -<!--l. 984--><p class="nopar" > </p><div class="alltt"> + {distance}% label + {% definition: +   name={distance}, +   description={the length between two points}, +   symbol={m} + } +\begin{document} +First use: \gls{cafe}, \gls{html}, \gls{pi}. +Next use: \gls{cafe}, \gls{html}, \gls{pi}. +\Gls{distance} is measured in \glssymbol{distance}. +</pre> +<!--l. 988--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor10"><span class="cmtt-10">\printunsrtglossaries</span></span><a @@ -2539,7 +2655,7 @@ href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. Other options are passed to the base <span class="cmss-10">glossaries </span>package. -<!--l. 995--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> In this document, commands and options displayed in teal, such as <span id="textcolor14"><span +<!--l. 999--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> In this user manual, commands and options displayed in teal, such as <span id="textcolor14"><span class="cmtt-10">\newabbreviation</span></span> and <span id="textcolor15"><span class="cmss-10">stylemods</span></span><a id="dx1-4014"></a>, are @@ -2557,13 +2673,13 @@ class="cmss-10">glossaries-extra</span></a> package. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details of those commands. </div> -</p><!--l. 1003--><p class="noindent" > -</p><!--l. 1005--><p class="indent" > One of the strengths of the <span +</p><!--l. 1007--><p class="noindent" > +</p><!--l. 1009--><p class="indent" > One of the strengths of the <span class="cmss-10">glossaries </span>package is its flexibility, however the drawback of this is the necessity of having a large manual that covers all the various settings. If you are daunted by the size of the manual, try starting off with the much shorter <a href="glossariesbegin.html" >guide for beginners</a>. -</p><!--l. 1011--><p class="indent" > <div class="important" title="Important Note"> There’s a common misconception that you have to have Perl installed in order to use the <span +</p><!--l. 1015--><p class="indent" > <div class="important" title="Important Note"> There’s a common misconception that you have to have Perl installed in order to use the <span class="cmss-10">glossaries</span> package. Perl is <span class="cmti-10">not </span>a requirement (as demonstrated by the above examples) but it does increase the @@ -2571,8 +2687,8 @@ available options, particularly if you use an <a href="#glo:exlatinalph">extended Latin alphabet</a> or a <a href="#glo:nonlatinalph">non-Latin alphabet</a>. </div> -</p><!--l. 1017--><p class="noindent" > -</p><!--l. 1019--><p class="indent" > This document uses the <span +</p><!--l. 1021--><p class="noindent" > +</p><!--l. 1023--><p class="indent" > This document uses the <span class="cmss-10">glossaries </span>package. For example, when viewing the PDF version of this document in a hyperlinked-enabled PDF viewer (such as Adobe Reader or Okular) if you click on the word “<a href="#glo:xindy"><span @@ -2583,7 +2699,7 @@ class="cmtt-10">xindy</span><a id="dx1-4017"></a>”. This is the way the <span class="cmss-10">glossaries </span>mechanism works. An <a -href="#glo:indexingapp">indexing application</a> is used to generated the sorted list of terms. The <a +href="#glo:indexingapp">indexing application</a> is used to generate the sorted list of terms. The <a href="#glo:indexingapp">indexing applications</a> are <a href="#glo:cli">command line interface (CLI)</a> tools, which means they can be run directly from a command @@ -2593,43 +2709,54 @@ prompt or terminal, or can be integrated into some text editors, or you can use class="cmtt-10">arara</span><a id="dx1-4018"></a> to run them. -</p><!--l. 1031--><p class="indent" > Neither of the above two examples require an <a +</p><!--l. 1035--><p class="indent" > Neither of the above two examples require an <a href="#glo:indexingapp">indexing application</a>. The first is just using the <span class="cmss-10">glossaries</span> package for consistent formatting, and there is no list. The second has lists but they are unsorted (see <a href="#option5">Option 5</a>). -</p><!--l. 1036--><p class="indent" > The remainder of this introductory section covers the following: </p> +</p><!--l. 1040--><p class="indent" > The remainder of this introductory section covers the following: </p> <ul class="itemize1"> - <li class="itemize"><a -href="#sec:indexingoptions">§1.1 </a><a + <li class="itemize"> + <!--l. 1042--><p class="noindent" ><a +href="#sec:indexingoptions">§<span +class="cmbx-10">??</span>sec:indexingoptions </a><a href="#sec:indexingoptions">Indexing Options<!--tex4ht:ref: sec:indexingoptions --></a> lists the available indexing options. - </li> - <li class="itemize"><a -href="#sec:samples">§19 </a><a -href="#sec:samples">Sample Documents<!--tex4ht:ref: sec:samples --></a> lists the sample documents provided with this package. - </li> - <li class="itemize"><a -href="#sec:lipsum">§1.2 </a><a + </p></li> + <li class="itemize"> + <!--l. 1045--><p class="noindent" ><a +href="#sec:lipsum">§<span +class="cmbx-10">??</span>sec:lipsum </a><a href="#sec:lipsum">Dummy Entries for Testing<!--tex4ht:ref: sec:lipsum --></a> lists the dummy glossary files that may be used for testing. - </li> - <li class="itemize"><a -href="#sec:languages">§1.3 </a><a -href="#sec:languages">Multi-Lingual Support<!--tex4ht:ref: sec:languages --></a> provides information for users who wish to write in a language other - than English. - </li> - <li class="itemize"><a -href="#sec:makeglossaries">§1.4 </a><a + </p></li> + <li class="itemize"> + <!--l. 1048--><p class="noindent" ><a +href="#sec:languages">§<span +class="cmbx-10">??</span>sec:languages </a><a +href="#sec:languages">Multi-Lingual Support<!--tex4ht:ref: sec:languages --></a> provides information for users who wish to write in a + language other than English. + </p></li> + <li class="itemize"> + <!--l. 1051--><p class="noindent" ><a +href="#sec:makeglossaries">§<span +class="cmbx-10">??</span>sec:makeglossaries </a><a href="#sec:makeglossaries">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a> describes how to use an <a -href="#glo:indexingapp">indexing application</a> to create - the sorted glossaries for your document (Options <a +href="#glo:indexingapp">indexing + application</a> to create the sorted glossaries for your document (Options <a href="#option2">2</a> or <a href="#option3">3</a>). +</p> </li></ul> -<!--l. 1056--><p class="noindent" ><a +<!--l. 1057--><p class="indent" > There are some sample documents provided with this package. They are described in <a +href="#sec:samples">§<span +class="cmbx-10">??</span>sec:samples </a><a +href="#sec:samples">Sample +Documents<!--tex4ht:ref: sec:samples --></a>. +</p> +<!--l. 1060--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.1 </span> <a id="sec:indexingoptions"></a>Indexing Options</h3> -<!--l. 1059--><p class="noindent" >The basic idea behind the <span +<!--l. 1063--><p class="noindent" >The basic idea behind the <span class="cmss-10">glossaries </span>package is that you first define your entries (terms, symbols or abbreviations). Then you can reference these within your document (like <span class="cmtt-10">\cite </span>or <span @@ -2647,16 +2774,17 @@ href="#option4">4</a> and <a href="#option5">5</a>) as well as an option for standalone descriptions within the document body (<a href="#option6">Option 6</a>). -</p><!--l. 1070--><p class="indent" > An overview of Options <a +</p><!--l. 1074--><p class="indent" > An overview of Options <a href="#option1">1</a>–<a href="#option5">5</a> is given in <a -href="#tab:options">table 1.1</a>. <a +href="#tab:options">table <span +class="cmbx-10">??</span>tab:options</a>. <a href="#option6">Option 6</a> is omitted from the table as it doesn’t produce a list. For a more detailed comparison of the various methods, see the <a href="https://www.dickimaw-books.com/gallery/glossaries-performance.shtml" ><span class="cmss-10">glossaries </span>performance page</a>. -</p><!--l. 1076--><p class="indent" > <div class="important" title="Important Note"> If you are developing a class or package that loads <span +</p><!--l. 1080--><p class="indent" > <div class="important" title="Important Note"> If you are developing a class or package that loads <span class="cmss-10">glossaries</span>, I recommend that you don’t force the user into a particular indexing method by adding an unconditional <span class="cmtt-10">\makeglossaries</span> @@ -2665,24 +2793,24 @@ means that they’re unable to use any commands that must come before <span class="cmtt-10">\makeglossaries </span>(such as <span class="cmtt-10">\newglossary</span>) and they can’t switch off the indexing whilst working on a draft document. + + </div> -</p><!--l. 1085--><p class="noindent" > -</p><!--l. 1087--><p class="indent" > Strictly speaking, Options <a +</p><!--l. 1089--><p class="noindent" > +</p><!--l. 1091--><p class="indent" > Strictly speaking, Options <a href="#option5">5</a> and <a href="#option6">6</a> aren’t actually indexing options as no indexing is performed. In the case of <a href="#option5">Option 5</a>, all defined entries are listed in order of definition. In the case of <a href="#option6">Option 6</a>, the entry hypertargets and descriptions are manually inserted at appropriate points in the document. - - These two options are included here for completeness and for comparison with the actual indexing options. </p> <div class="table"> -<!--l. 1094--><p class="indent" > <a +<!--l. 1098--><p class="indent" > <a id="tab:options"></a></p><hr class="float" /><div class="float" > @@ -2693,7 +2821,7 @@ class="content">Glossary Options: Pros and Cons</span></div><!--tex4ht:label?: x <div class="tabular"> <table id="TBL-2" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-2-1g"><col id="TBL-2-1" /><col id="TBL-2-2" /><col @@ -2702,7 +2830,7 @@ id="TBL-2-4" /><col id="TBL-2-5" /><col id="TBL-2-6" /></colgroup><tr style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:normal; text-align:left;" id="TBL-2-1-1" -class="td01"><!--l. 1102--><p class="noindent" > </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-1-2" +class="td01"><!--l. 1106--><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 @@ -2725,7 +2853,7 @@ class="cmbx-10">Option</span><span class="cmbx-10"> 5</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="td01"><!--l. 1104--><p class="noindent" ><span +class="td01"><!--l. 1108--><p class="noindent" ><span class="cmr-9">Requires</span> <a href="#glo:glossaries-extra"><span @@ -2743,7 +2871,7 @@ class="td10"> <span id="textcolor20"><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="td01"><!--l. 1106--><p class="noindent" ><span +class="td01"><!--l. 1110--><p class="noindent" ><span class="cmr-9">Requires</span> <span class="cmr-9">an</span> @@ -2763,7 +2891,7 @@ class="td10"> <span id="textcolor25"><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="td01"><!--l. 1108--><p class="noindent" ><span +class="td01"><!--l. 1112--><p class="noindent" ><span class="cmr-9">Requires</span> <span class="cmr-9">Perl?</span> </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-4-2" @@ -2779,7 +2907,7 @@ class="td10"> <span id="textcolor30"><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="td01"><!--l. 1110--><p class="noindent" ><span +class="td01"><!--l. 1114--><p class="noindent" ><span class="cmr-9">Requires</span> <span class="cmr-9">Java?</span> </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-5-2" @@ -2795,7 +2923,7 @@ class="td10"> <span id="textcolor35"><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="td01"><!--l. 1112--><p class="noindent" ><span +class="td01"><!--l. 1116--><p class="noindent" ><span class="cmr-9">Can</span> <span class="cmr-9">sort</span> @@ -2826,7 +2954,7 @@ class="pzdr-">✔</span></span> </td><td style="white-space:nowrap; class="td10"> N/A </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="td01"><!--l. 1115--><p class="noindent" ><span +class="td01"><!--l. 1119--><p class="noindent" ><span class="cmr-9">Efficient</span> <span class="cmr-9">sort</span> @@ -2843,7 +2971,7 @@ class="pzdr-">✔</span></span> </td><td style="white-space:nowrap; class="td10"> N/A </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="td01"><!--l. 1117--><p class="noindent" ><span +class="td01"><!--l. 1121--><p class="noindent" ><span class="cmr-9">Can</span> <span class="cmr-9">use</span> @@ -2874,7 +3002,7 @@ class="pzdr-">✔</span></span> </td><td style="white-space:nowrap; class="td10"> N/A </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="td01"><!--l. 1121--><p class="noindent" ><span +class="td01"><!--l. 1125--><p class="noindent" ><span class="cmr-9">Any</span> <span class="cmr-9">problematic</span> @@ -2895,7 +3023,7 @@ class="pzdr-">✘</span></span><sup class="textsuperscript"><span class="tcrm-0900">‡</span></sup> </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="td01"><!--l. 1123--><p class="noindent" ><span +class="td01"><!--l. 1127--><p class="noindent" ><span class="cmr-9">Are</span> <span class="cmr-9">entries</span> @@ -2930,7 +3058,7 @@ class="td10"> <span id="textcolor57"><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="td01"><!--l. 1126--><p class="noindent" ><span +class="td01"><!--l. 1130--><p class="noindent" ><span class="cmr-9">Can</span> <span class="cmr-9">automatically</span> @@ -2958,7 +3086,7 @@ class="td10"> <span id="textcolor62"><span class="pzdr-">✘</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-12-"><td style="white-space:normal; text-align:left;" id="TBL-2-12-1" -class="td01"><!--l. 1128--><p class="noindent" ><span +class="td01"><!--l. 1132--><p class="noindent" ><span class="cmr-9">Can</span> <span class="cmr-9">have</span> @@ -2988,7 +3116,7 @@ class="pzdr-">✔</span></span><sup class="textsuperscript"><span class="tcrm-0900">¶</span></sup> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-13-"><td style="white-space:normal; text-align:left;" id="TBL-2-13-1" -class="td01"><!--l. 1133--><p class="noindent" ><span +class="td01"><!--l. 1137--><p class="noindent" ><span class="cmr-9">Maximum</span> <span class="cmr-9">hierarchical</span> @@ -3008,7 +3136,7 @@ class="td10"> <span class="cmsy-10">∞ </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-2-14-"><td style="white-space:normal; text-align:left;" id="TBL-2-14-1" -class="td01"><!--l. 1135--><p class="noindent" ><span +class="td01"><!--l. 1139--><p class="noindent" ><span class="cmtt-9">\glsdisplaynumberlist</span><a id="dx1-5002"></a> <span @@ -3025,7 +3153,7 @@ class="td10"> <span id="textcolor72"><span class="pzdr-">✘</span></span> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-15-"><td style="white-space:normal; text-align:left;" id="TBL-2-15-1" -class="td01"><!--l. 1137--><p class="noindent" ><span +class="td01"><!--l. 1141--><p class="noindent" ><span class="cmtt-9">\newglossaryentry</span><a id="dx1-5003"></a> <span @@ -3055,7 +3183,7 @@ class="td10"> <span class="pzdr-">✔</span><sup class="textsuperscript">⁑</sup> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-16-"><td style="white-space:normal; text-align:left;" id="TBL-2-16-1" -class="td01"><!--l. 1140--><p class="noindent" ><span +class="td01"><!--l. 1144--><p class="noindent" ><span class="cmr-9">Requires</span> <span class="cmr-9">additional</span> @@ -3076,7 +3204,7 @@ class="pzdr-">✘</span></span><sup class="textsuperscript"><span class="cmmi-9">⋆</span></sup> </td> </tr><tr style="vertical-align:baseline;" id="TBL-2-17-"><td style="white-space:normal; text-align:left;" id="TBL-2-17-1" -class="td01"><!--l. 1142--><p class="noindent" ><span +class="td01"><!--l. 1146--><p class="noindent" ><span class="cmr-9">Default</span> <span class="cmr-9">value</span> @@ -3104,8 +3232,8 @@ class="pzdr-x-x-90">✾</span></sup> </td> </tr></table> </div> -<!--l. 1150--><p class="noindent" >______________________________________________________________________________________ -</p><!--l. 1152--><p class="noindent" ><sup class="textsuperscript"><span +<!--l. 1154--><p class="noindent" >______________________________________________________________________________________ +</p><!--l. 1156--><p class="noindent" ><sup class="textsuperscript"><span class="tcrm-0900">*</span></sup> <span class="cmr-8">Strips standard LaTeX</span><span class="cmr-8"> accents (that is, accents generated by core LaTeX</span><span @@ -3115,13 +3243,13 @@ class="cmtt-8">\AA</span><a class="cmr-8">is treated the</span> <span class="cmr-8">same as A.</span> -</p><!--l. 1155--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1159--><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 href="#glo:glossaries-extra"><span class="cmss-8">glossaries-extra</span></a><span class="cmr-8">.</span> -</p><!--l. 1156--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1160--><p class="noindent" ><sup class="textsuperscript"><span class="tcrm-0900">‡</span></sup> <span class="cmr-8">Provided </span><span class="cmss-8">sort</span><span @@ -3129,13 +3257,13 @@ class="cmtt-8">=</span><span class="cmss-8">none</span><a id="dx1-5008"></a> <span class="cmr-8">is used.</span> -</p><!--l. 1157--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1161--><p class="noindent" ><sup class="textsuperscript"><span class="tcrm-0900">§</span></sup> <span class="cmr-8">Entries with the same sort value are merged.</span> -</p><!--l. 1158--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1162--><p class="noindent" ><sup class="textsuperscript"><span class="msam-10x-x-90">♢</span></sup> <span class="cmr-8">Requires some setting up.</span> -</p><!--l. 1159--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1163--><p class="noindent" ><sup class="textsuperscript"><span class="tcrm-0900">¶</span></sup> <span class="cmr-8">The locations must be set explicitly through the custom </span><span id="textcolor78"><span class="cmtt-8">location</span></span><a @@ -3143,10 +3271,10 @@ class="cmtt-8">location</span></span><a class="cmr-8">field provided by </span><span class="cmss-8">glossaries-extra</span><span class="cmr-8">.</span> -</p><!--l. 1162--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1166--><p class="noindent" ><sup class="textsuperscript"><span class="cmr-9">#</span></sup> <span class="cmr-8">Unlimited but unreliable.</span> -</p><!--l. 1163--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1167--><p class="noindent" ><sup class="textsuperscript"><span class="tcrm-0900">※</span></sup> <span class="cmr-8">Entries are defined in </span><span class="cmtt-8">bib</span><a @@ -3154,7 +3282,7 @@ class="cmtt-8">bib</span><a class="cmr-8">format. </span><span class="cmtt-8">\newglossaryentry </span><span class="cmr-8">should not be used explicitly.</span> -</p><!--l. 1165--><p class="noindent" ><sup class="textsuperscript">⁑</sup> <span +</p><!--l. 1169--><p class="noindent" ><sup class="textsuperscript">⁑</sup> <span class="cmr-8">Provided </span><span id="textcolor79"><span class="cmss-8">docdef</span><span class="cmtt-8">=</span><span @@ -3166,7 +3294,7 @@ class="cmtt-8">=</span><span class="cmss-8">restricted</span></span><a id="dx1-5012"></a> <span class="cmr-8">but not recommended.</span> -</p><!--l. 1167--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1171--><p class="noindent" ><sup class="textsuperscript"><span class="cmmi-9">⋆</span></sup> <span class="cmr-8">Provided </span><span id="textcolor81"><span class="cmss-8">docdef</span><span @@ -3179,7 +3307,7 @@ class="cmtt-8">=</span><span class="cmss-8">restricted</span></span><a id="dx1-5014"></a><span class="cmr-8">.</span> -</p><!--l. 1169--><p class="noindent" ><sup class="textsuperscript"><span +</p><!--l. 1173--><p class="noindent" ><sup class="textsuperscript"><span class="pzdr-x-x-90">✾</span></sup> <span class="cmr-8">Irrelevant with </span><span class="cmss-8">sort</span><span @@ -3202,15 +3330,15 @@ class="cmr-8">option automatically switches this on.)</span> <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 (TeX)</h4> -<!--l. 1176--><p class="noindent" >Example Document: +<!--l. 1180--><p class="noindent" >This option isn’t generally recommended for reasons given below. Example Document: </p> - <div class="verbatim" id="verbatim-5"> + <pre class="verbatim" id="verbatim-5"> \documentclass{article} - <br />\usepackage{glossaries} -</div> -<!--l. 1180--><p class="nopar" > </p><div class="alltt"> +\usepackage{glossaries} +</pre> +<!--l. 1185--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <strong><span class="cmtt-10">\makenoidxglossaries</span><a @@ -3224,13 +3352,13 @@ class="cmtt-10"> sort</span> </div> - <div class="verbatim" id="verbatim-6"> + <pre class="verbatim" id="verbatim-6"> \newglossaryentry{sample}{name={sample}, - <br />  description={an example}} - <br />\begin{document} - <br />\gls{sample}. -</div> -<!--l. 1189--><p class="nopar" > </p><div class="alltt"> +  description={an example}} +\begin{document} +\gls{sample}. +</pre> +<!--l. 1194--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <strong><span class="cmtt-10">\printnoidxglossary</span><a @@ -3245,20 +3373,22 @@ class="cmtt-10">\loadglsentries</span><a class="cmti-10">after </span><span class="cmtt-10">\makenoidxglossaries</span><a id="dx1-6004"></a>). -<!--l. 1198--><p class="indent" > This option doesn’t require an external <a +<!--l. 1203--><p class="indent" > This option doesn’t require an external <a href="#glo:indexingapp">indexing application</a> but, with the default alphabetic sorting, it’s very slow with severe limitations. If you want a sorted list, it doesn’t work well for <a href="#glo:exlatinalph">extended Latin alphabets</a> or <a -href="#glo:nonlatinalph">non-Latin alphabets</a>. However, if you use the <span +href="#glo:nonlatinalph">non-Latin alphabets</a> and there’s no guarantee that it will work with <a +href="#glo:UTF-8">UTF-8</a>. However, if you use +the <span class="cmss-10">sanitizesort</span><span 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 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 + id="dx1-6005"></a> package option (the default for Option 1) then the <a +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 class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span @@ -3268,8 +3398,8 @@ class="cmtt-10">\’elite</span></span></span> if <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-6007"></a> is used. If -you have any other kinds of commands that don’t expand to ASCII characters, such as <span + id="dx1-6007"></a> is used. If you +have any other kinds of commands that don’t expand to ASCII characters, such as <span class="cmtt-10">\alpha </span>or <span class="cmtt-10">\si</span>, then you must use <span @@ -3300,7 +3430,7 @@ class="cmtt-10">sort={alpha}</span></strong><span class="cmtt-10">,description={...}}</span> </div> </div> -<!--l. 1218--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +<!--l. 1224--><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 a modified <span class="cmss-10">symbols</span><a @@ -3312,8 +3442,8 @@ class="cmtt-10">sort</span><a id="dx1-6015"></a> key to the entry label (instead of the <span class="cmtt-10">name</span><a id="dx1-6016"></a>). </div> -</p><!--l. 1222--><p class="noindent" > -</p><!--l. 1224--><p class="indent" > This option works best with the <span +</p><!--l. 1228--><p class="noindent" > +</p><!--l. 1230--><p class="indent" > This option works best with the <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a @@ -3331,59 +3461,68 @@ href="#glo:numberlist">number list<a href="#glo:indexingapp">indexing application</a> consider using <a href="#option5">Option 5</a> instead. -</p><!--l. 1235--><p class="indent" > +</p><!--l. 1241--><p class="indent" > Summary: + + </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-6021x1">Add +<li + class="enumerate" id="x1-6021x1"> + <!--l. 1243--><p class="noindent" >Add - <div class="verbatim" id="verbatim-7"> +</p> + <pre class="verbatim" id="verbatim-7"> \makenoidxglossaries -</div> - <!--l. 1239--><p class="nopar" > to your preamble (before you start defining your entries, as described in <a -href="#sec:newglosentry">§4 </a><a -href="#sec:newglosentry">Defining Glossary - Entries<!--tex4ht:ref: sec:newglosentry --></a>). +</pre> + <!--l. 1246--><p class="nopar" > to your preamble (before you start defining your entries, as described in <a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry </a><a +href="#sec:newglosentry">Defining + Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>). </p></li> - <li - class="enumerate" id="x1-6023x2">Put +<li + class="enumerate" id="x1-6023x2"> + <!--l. 1250--><p class="noindent" >Put - <div class="verbatim" id="verbatim-8"> +</p> + <pre class="verbatim" id="verbatim-8"> \printnoidxglossary -</div> - <!--l. 1246--><p class="nopar" > where you want your list of entries to appear (described in <a -href="#sec:printglossary">§10 </a><a -href="#sec:printglossary">Displaying a glossary<!--tex4ht:ref: sec:printglossary --></a>). Alternatively, to - display all glossaries use the iterative command: +</pre> + <!--l. 1253--><p class="nopar" > where you want your list of entries to appear (described in <a +href="#sec:printglossary">§<span +class="cmbx-10">??</span>sec:printglossary </a><a +href="#sec:printglossary">Displaying a Glossary<!--tex4ht:ref: sec:printglossary --></a>). + Alternatively, to display all glossaries use the iterative command: </p> - <div class="verbatim" id="verbatim-9"> + <pre class="verbatim" id="verbatim-9"> \printnoidxglossaries -</div> - <!--l. 1252--><p class="nopar" > +</pre> + <!--l. 1259--><p class="nopar" > </p></li> - <li - 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> +<li + class="enumerate" id="x1-6025x3"> + <!--l. 1261--><p class="noindent" >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.</p></li></ol> <a id="x1-6026r2"></a> -<!--l. 1259--><p class="noindent" > +<!--l. 1266--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-70002"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option2">🔗</a><a id="option2"></a>Option 2 (<span class="cmtt-10">makeindex</span>)</h4> -<!--l. 1261--><p class="noindent" >Example document: +<!--l. 1268--><p class="noindent" >Example document: </p> - <div class="verbatim" id="verbatim-10"> + <pre class="verbatim" id="verbatim-10"> \documentclass{article} - <br />\usepackage{glossaries} -</div> -<!--l. 1265--><p class="nopar" > </p><div class="alltt"> +\usepackage{glossaries} +</pre> +<!--l. 1272--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <strong><span class="cmtt-10">\makeglossaries</span><a @@ -3396,13 +3535,13 @@ class="cmtt-10"> files</span> </div> - <div class="verbatim" id="verbatim-11"> + <pre class="verbatim" id="verbatim-11"> \newglossaryentry{sample}{name={sample}, - <br /> description={an example}} - <br />\begin{document} - <br />\gls{sample}. -</div> -<!--l. 1274--><p class="nopar" > </p><div class="alltt"> + description={an example}} +\begin{document} +\gls{sample}. +</pre> +<!--l. 1281--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <strong><span class="cmtt-10">\printglossary</span><a @@ -3417,7 +3556,7 @@ class="cmtt-10">\loadglsentries</span><a class="cmti-10">after </span><span class="cmtt-10">\makeglossaries</span><a id="dx1-7004"></a>). -<!--l. 1283--><p class="indent" > This option uses a <a +<!--l. 1290--><p class="indent" > This option uses a <a href="#glo:cli">CLI</a> application called <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a @@ -3427,8 +3566,10 @@ 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 +class="cmtt-10">\c</span>) and fails with <a +href="#glo:UTF-8">UTF-8</a> characters, especially for any sort values that start +with a <a +href="#glo:UTF-8">UTF-8</a> character (as it separates the octets resulting in an invalid file encoding). This process involves making LaTeX write the glossary information to a temporary file which <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a @@ -3439,7 +3580,7 @@ class="cmtt-10">makeindex</span><a writes a new file containing the code to typeset the glossary. Then <span class="cmtt-10">\printglossary </span>reads this file in on the next run. -</p><!--l. 1295--><p class="indent" > This option works best if you want to sort entries according to the English alphabet and you don’t want to +</p><!--l. 1302--><p class="indent" > This option works best if you want to sort entries according to the English alphabet and you don’t want to install Perl or Java. This method can also work with the restricted shell escape since <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a @@ -3448,7 +3589,7 @@ trusted application. (So you should be able to use the <span class="cmss-10">automake</span><a id="dx1-7010"></a> package option provided the shell escape hasn’t been completely disabled.) -</p><!--l. 1302--><p class="indent" > This method can form ranges in the <a +</p><!--l. 1309--><p class="indent" > This method can form ranges in the <a href="#glo:numberlist">number list<a id="dx1-7011"></a></a> but only accepts limited number formats: <span class="cmtt-10">\arabic</span>, <span @@ -3457,36 +3598,38 @@ class="cmtt-10">\roman</span>, class="cmtt-10">\Roman</span>, <span class="cmtt-10">\alph </span>and <span class="cmtt-10">\Alph</span>. -</p><!--l. 1306--><p class="indent" > This option does not allow a mixture of sort methods. All glossaries must be sorted according to the same +</p><!--l. 1313--><p class="indent" > This option does not allow a mixture of sort methods. All glossaries must be sorted according to the same method: word/letter ordering or order of use or order of definition. If you need word ordering for one glossary and letter ordering for another you’ll have to explicitly call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7012"></a></a> for each glossary type. -</p><!--l. 1313--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 1320--><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 allows a hybrid mix of Options <a href="#option1">1</a> and <a -href="#option2">2</a> to provide word/letter ordering -with <a +href="#option2">2</a> to provide word/letter ordering with +<a href="#option2">Option 2</a> and order of use/definition with <a href="#option1">Option 1</a>. See the <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> documentation -for further details. See also the <a +class="cmss-10">glossaries-extra</span></a> documentation for further +details. See also the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> alternative to <a href="#ex:sampleSort"><span class="cmtt-10">sampleSort.tex</span></a> in <a -href="#sec:samplessort">§19.5 </a><a +href="#sec:samplessort">§<span +class="cmbx-10">??</span>sec:samplessort </a><a href="#sec:samplessort">Sorting<!--tex4ht:ref: sec:samplessort --></a>. </div> -</p><!--l. 1320--><p class="noindent" > -</p><!--l. 1322--><p class="indent" > +</p><!--l. 1327--><p class="noindent" > +</p><!--l. 1329--><p class="indent" > Summary: </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-7014x1">If you want to use <a +<li + class="enumerate" id="x1-7014x1"> + <!--l. 1331--><p class="noindent" >If you want to use <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7015"></a>’s</a> <span @@ -3497,49 +3640,57 @@ class="cmtt-10">\GlsSetQuote</span><a example: - <div class="verbatim" id="verbatim-12"> +</p> + <pre class="verbatim" id="verbatim-12"> \GlsSetQuote{+} -</div> - <!--l. 1327--><p class="nopar" > This must be used before <span +</pre> + <!--l. 1335--><p class="nopar" > This must be used before <span class="cmtt-10">\makeglossaries</span>. Note that if you are using <span class="cmss-10">babel</span><a id="dx1-7018"></a>, the shorthands aren’t enabled until the start of the document, so you won’t be able to use the shorthands in definitions made in the preamble. </p></li> - <li - class="enumerate" id="x1-7020x2">Add +<li + class="enumerate" id="x1-7020x2"> + <!--l. 1341--><p class="noindent" >Add - <div class="verbatim" id="verbatim-13"> +</p> + <pre class="verbatim" id="verbatim-13"> \makeglossaries -</div> - <!--l. 1336--><p class="nopar" > to your preamble (before you start defining your entries, as described in <a -href="#sec:newglosentry">§4 </a><a -href="#sec:newglosentry">Defining Glossary - Entries<!--tex4ht:ref: sec:newglosentry --></a>). +</pre> + <!--l. 1344--><p class="nopar" > to your preamble (before you start defining your entries, as described in <a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry </a><a +href="#sec:newglosentry">Defining + Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>). </p></li> - <li - class="enumerate" id="x1-7022x3">Put +<li + class="enumerate" id="x1-7022x3"> + <!--l. 1349--><p class="noindent" >Put - <div class="verbatim" id="verbatim-14"> +</p> + <pre class="verbatim" id="verbatim-14"> \printglossary -</div> - <!--l. 1344--><p class="nopar" > where you want your list of entries to appear (described in <a -href="#sec:printglossary">§10 </a><a -href="#sec:printglossary">Displaying a glossary<!--tex4ht:ref: sec:printglossary --></a>). Alternatively, to - display all glossaries use the iterative command: +</pre> + <!--l. 1352--><p class="nopar" > where you want your list of entries to appear (described in <a +href="#sec:printglossary">§<span +class="cmbx-10">??</span>sec:printglossary </a><a +href="#sec:printglossary">Displaying a Glossary<!--tex4ht:ref: sec:printglossary --></a>). + Alternatively, to display all glossaries use the iterative command: </p> - <div class="verbatim" id="verbatim-15"> + <pre class="verbatim" id="verbatim-15"> \printglossaries -</div> - <!--l. 1350--><p class="nopar" > +</pre> + <!--l. 1358--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-7024x4">Run LaTeX on your document. This creates files with the extensions <span +<li + class="enumerate" id="x1-7024x4"> + <!--l. 1360--><p class="noindent" >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 @@ -3553,13 +3704,14 @@ class="cmtt-10">myDoc.ist</span>). If you look at your document at this point, y href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> you’ll see the section heading and some boilerplate text.) - <!--l. 1361--><p class="noindent" >If you have used package options such as <span + </p><!--l. 1369--><p class="noindent" >If you have used package options such as <span class="cmss-10">symbols</span><a id="dx1-7027"></a> there will also be other sets of files corresponding to the extra glossaries that were created by those options. </p></li> - <li - class="enumerate" id="x1-7029x5"><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#makeindex.run">🔗</a><a +<li + class="enumerate" id="x1-7029x5"> + <!--l. 1373--><p class="noindent" ><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#makeindex.run">🔗</a><a id="makeindex.run"></a> Run <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a @@ -3570,7 +3722,7 @@ class="cmtt-10">.ist </span>file as the style so that it creates an class="cmtt-10">.gls</span>. If you have access to a terminal or a command prompt (for example, the MSDOS command prompt for Windows users or the bash console for Unix-like users) then you need to run the command: - <!--l. 1371--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 1379--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s myDoc.ist -o myDoc.gls myDoc.glo <br /></pre><spacer type=vertical size=10> <br /></span> @@ -3578,38 +3730,39 @@ class="cmtt-10">.gls</span>. If you have access to a terminal or a command promp 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 + </p><!--l. 1386--><p class="noindent" ><div class="important" title="Important Note"> The file extensions vary according to the glossary <span class="cmtt-10">type</span><a id="dx1-7031"></a>. See <a -href="#sec:makeindexapp">§1.4.4 </a><a +href="#sec:makeindexapp">§<span +class="cmbx-10">??</span>sec:makeindexapp </a><a href="#sec:makeindexapp">Using <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-7032"></a></a> explicitly (Option 2)<!--tex4ht:ref: sec:makeindexapp --></a> - for further details. <a + id="dx1-7032"></a></a> + explicitly (Option 2)<!--tex4ht:ref: sec:makeindexapp --></a> for further details. <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7033"></a></a> must be called for each set of files. </div> - </p><!--l. 1382--><p class="noindent" > - </p><!--l. 1384--><p class="noindent" >If you don’t know how to use the command prompt, then you can probably access <a + </p><!--l. 1390--><p class="noindent" > + </p><!--l. 1392--><p class="noindent" >If you don’t know how to use the command prompt, then you can probably access <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7034"></a></a> via your text editor, but each editor has a different method of doing this. See <a href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a> for some examples. - </p><!--l. 1390--><p class="noindent" >Alternatively, run <a + </p><!--l. 1398--><p class="noindent" >Alternatively, run <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7035"></a></a> indirectly via the <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-7036"></a></a> script: - </p><!--l. 1392--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> - <br />makeglossaries myDoc - <br /></pre><spacer type=vertical size=10> + </p><!--l. 1400--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <br />makeglossaries myDoc + <br /></pre><spacer type=vertical size=10> <br /></span> Note that the file extension isn’t supplied in this case. (Replace <a href="#glo:makeglossaries"><span @@ -3626,7 +3779,7 @@ href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7040"></a></a> the appropriate number of times with all the necessary switches. - </p><!--l. 1402--><p class="noindent" >The simplest approach is to use <span + </p><!--l. 1410--><p class="noindent" >The simplest approach is to use <span class="cmtt-10">arara</span><a id="dx1-7041"></a> and add the following comment lines to the start of your document: </p><div class="alltt"> @@ -3648,23 +3801,24 @@ class="cmtt-10"> pdflatex</span> class="cmtt-10">makeglossaries </span>with <span class="cmtt-10">makeglossarieslite </span>in the second line above if you don’t have Perl installed. Note that there’s no hyphen in this case.) - <!--l. 1413--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you want letter ordering you need to + <!--l. 1421--><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">-l</span><a id="dx1-7042"></a> switch: - </p><!--l. 1416--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 1424--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -l -s myDoc.ist -o myDoc.gls myDoc.glo <br /></pre><spacer type=vertical size=10> <br /></span> (See <a -href="#sec:makeindexapp">§1.4.4 </a><a +href="#sec:makeindexapp">§<span +class="cmbx-10">??</span>sec:makeindexapp </a><a href="#sec:makeindexapp">Using <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-7043"></a></a> explicitly (Option 2)<!--tex4ht:ref: sec:makeindexapp --></a> for further details on using <span class="cmtt-10">makeindex</span><a - id="dx1-7044"></a> explicitly.) If you - use <a + id="dx1-7044"></a> + explicitly.) If you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-7045"></a></a> or <a @@ -3674,16 +3828,17 @@ class="cmtt-10">makeglossaries-lite</span><a class="cmss-10">order</span><span class="cmtt-10">=</span><span class="cmss-10">letter</span><a - id="dx1-7047"></a> package option and the <span + id="dx1-7047"></a> package option + and the <span class="cmtt-10">-l</span><a - id="dx1-7048"></a> option - will be added automatically. + id="dx1-7048"></a> option will be added automatically. </p></li> - <li - class="enumerate" id="x1-7050x6"><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#makeindex.relatex">🔗</a><a +<li + class="enumerate" id="x1-7050x6"> + <!--l. 1433--><p class="noindent" ><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 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 + again.</p></li></ol> +<!--l. 1436--><p class="noindent" >You’ll need to repeat the last step if you have used the <span class="cmss-10">toc</span><a id="dx1-7051"></a> option (unless you’re using <a href="#glo:glossaries-extra"><span @@ -3694,15 +3849,15 @@ href="#makeindex.relatex">6<!--tex4ht:ref: makeindex.relatex --></a> if you have cross-references which can’t be indexed until the glossary file has been created. <a id="x1-7052r3"></a> -</p><!--l. 1435--><p class="noindent" > + + +</p><!--l. 1443--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-80003"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option3">🔗</a><a id="option3"></a>Option 3 (<span class="cmtt-10">xindy</span>)</h4> -<!--l. 1437--><p class="noindent" >Example document: </p><div class="alltt"> - - +<!--l. 1445--><p class="noindent" >Example document: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\documentclass{article}</span> @@ -3721,13 +3876,13 @@ class="cmtt-10"> files</span> </div> - <div class="verbatim" id="verbatim-16"> + <pre class="verbatim" id="verbatim-16"> \newglossaryentry{sample}{name={sample}, - <br /> description={an example}} - <br />\begin{document} - <br />\gls{sample}. -</div> -<!--l. 1448--><p class="nopar" > </p><div class="alltt"> + description={an example}} +\begin{document} +\gls{sample}. +</pre> +<!--l. 1456--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <strong><span class="cmtt-10">\printglossary</span><a @@ -3742,7 +3897,7 @@ class="cmtt-10">\loadglsentries</span><a class="cmti-10">after </span><span class="cmtt-10">\makeglossaries</span><a id="dx1-8004"></a>). -<!--l. 1457--><p class="indent" > This option uses a <a +<!--l. 1465--><p class="indent" > This option uses a <a href="#glo:cli">CLI</a> application called <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a @@ -3752,7 +3907,7 @@ class="cmtt-10">makeindex </span>and is able to sort <a href="#glo:exlatinalph">extended Latin alphabets</a> or <a href="#glo:nonlatinalph">non-Latin alphabets</a>, however it does still have some limitations. -</p><!--l. 1462--><p class="indent" > The <a +</p><!--l. 1470--><p class="indent" > The <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8006"></a></a> application comes with both TeX Live and MiKTeX, but since <a @@ -3771,23 +3926,28 @@ class="cmtt-10">xindy</span><a containing the code to typeset the glossary. Then <span class="cmtt-10">\printglossary </span>reads this file in on the next run. -</p><!--l. 1470--><p class="indent" > This is the best option with just the base <span -class="cmss-10">glossaries </span>package if you want to sort according to a language -other than English or if you want non-standard location lists, but it can require some setting up (see <a -href="#sec:xindy">§11 </a><a -href="#sec:xindy">Xindy -(Option 3)<!--tex4ht:ref: sec:xindy --></a>). There are some problems with certain sort values: </p> +</p><!--l. 1478--><p class="indent" > This is the best option with just the base <span +class="cmss-10">glossaries </span>package if you want to sort according to +a language other than English or if you want non-standard location lists, but it can require some +setting up (see <a +href="#sec:xindy">§<span +class="cmbx-10">??</span>sec:xindy </a><a +href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a>). There are some problems with certain sort values: +</p> <ul class="itemize1"> - <li class="itemize">entries with the same sort value are merged by <span + <li class="itemize"> + <!--l. 1484--><p class="noindent" >entries with the same sort value are merged by <span class="cmtt-10">xindy</span><a id="dx1-8010"></a> into a single glossary line so you must make sure that each entry has a unique sort value; - </li> - <li class="itemize"><span + </p></li> + <li class="itemize"> + <!--l. 1487--><p class="noindent" ><span class="cmtt-10">xindy</span><a id="dx1-8011"></a> forbids empty sort values; - </li> - <li class="itemize"><span + </p></li> + <li class="itemize"> + <!--l. 1488--><p class="noindent" ><span class="cmtt-10">xindy</span><a id="dx1-8012"></a> automatically strips control sequences, the math-shift character <span class="obeylines-h"><span class="verb"><span class="cmtt-10">$</span></span></span> and braces <span class="obeylines-h"><span class="verb"><span @@ -3795,10 +3955,12 @@ class="cmtt-10">{}</span></span></span> from the sort value, which is usually desired but this can cause the sort value to collapse to an empty string which <span class="cmtt-10">xindy</span><a - id="dx1-8013"></a> forbids.</li></ul> -<!--l. 1485--><p class="noindent" >In these problematic cases, you must set the <span + id="dx1-8013"></a> forbids.</p></li></ul> +<!--l. 1493--><p class="noindent" >In these problematic cases, you must set the <span class="cmtt-10">sort</span><a id="dx1-8014"></a> field explicitly. For example: </p><div class="alltt"> + + <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{alpha}{name={\ensuremath{\alpha}},</span> @@ -3806,11 +3968,9 @@ class="cmtt-10">\newglossaryentry{alpha}{name={\ensuremath{\alpha}},</span> class="cmtt-10"> </span><strong><span class="cmtt-10">sort={alpha},</span></strong><span class="cmtt-10">description={...}}</span> - - </div> </div> -<!--l. 1491--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +<!--l. 1499--><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 a modified <span class="cmss-10">symbols</span><a @@ -3822,10 +3982,10 @@ class="cmtt-10">sort</span><a id="dx1-8017"></a> key to the entry label (instead of the <span class="cmtt-10">name</span><a id="dx1-8018"></a>). </div> -</p><!--l. 1495--><p class="noindent" > -</p><!--l. 1497--><p class="indent" > All glossaries must be sorted according to the same method (word/letter ordering, order of use, or order of +</p><!--l. 1503--><p class="noindent" > +</p><!--l. 1505--><p class="indent" > All glossaries must be sorted according to the same method (word/letter ordering, order of use, or order of definition). -</p><!--l. 1500--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 1508--><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 allows a hybrid mix of Options <a href="#option1">1</a> and <a @@ -3836,28 +3996,30 @@ href="#option1">Option 1</a>. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> documentation for further details. </div> -</p><!--l. 1505--><p class="noindent" > -</p><!--l. 1507--><p class="indent" > +</p><!--l. 1513--><p class="noindent" > +</p><!--l. 1515--><p class="indent" > Summary: </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-8020x1">Add the <span +<li + class="enumerate" id="x1-8020x1"> + <!--l. 1517--><p class="noindent" >Add the <span class="cmss-10">xindy</span><a id="dx1-8021"></a> option to the <span class="cmss-10">glossaries </span>package option list: - <div class="verbatim" id="verbatim-17"> +</p> + <pre class="verbatim" id="verbatim-17"> \usepackage[xindy]{glossaries} -</div> - <!--l. 1512--><p class="nopar" > If you are using a non-Latin script you’ll also need to either switch off the creation of the number +</pre> + <!--l. 1521--><p class="nopar" > If you are using a non-Latin script you’ll also need to either switch off the creation of the number group: </p> - <div class="verbatim" id="verbatim-18"> + <pre class="verbatim" id="verbatim-18"> \usepackage[xindy={glsnumbers=false}]{glossaries} -</div> - <!--l. 1517--><p class="nopar" > or use either <span +</pre> + <!--l. 1526--><p class="nopar" > or use either <span class="cmtt-10">\GlsSetXdyFirstLetterAfterDigits{</span>⟨<span class="cmti-10">letter</span>⟩<span class="cmtt-10">} </span>(to indicate the first letter group to follow the @@ -3866,18 +4028,22 @@ class="cmtt-10">\GlsSetXdyNumberGroupOrder{</span>⟨<span class="cmti-10">spec</span>⟩<span class="cmtt-10">} </span>to indicate where the number group should be placed (see <a -href="#sec:xindy">§11 </a><a +href="#sec:xindy">§<span +class="cmbx-10">??</span>sec:xindy </a><a href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a>). </p></li> - <li - class="enumerate" id="x1-8023x2">Add <span -class="cmtt-10">\makeglossaries </span>to your preamble (before you start defining your entries, as described in <a -href="#sec:newglosentry">§4 </a><a -href="#sec:newglosentry">Defining - Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>). - </li> - <li - class="enumerate" id="x1-8025x3">Run LaTeX on your document. This creates files with the extensions <span +<li + class="enumerate" id="x1-8023x2"> + <!--l. 1532--><p class="noindent" >Add <span +class="cmtt-10">\makeglossaries </span>to your preamble (before you start defining your entries, as described in + <a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry </a><a +href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>). + </p></li> +<li + class="enumerate" id="x1-8025x3"> + <!--l. 1535--><p class="noindent" >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 @@ -3891,13 +4057,14 @@ class="cmtt-10">myDoc.xdy</span>). href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> extension package, you’ll see the section header and some boilerplate text.) - <!--l. 1535--><p class="noindent" >If you have used package options such as <span + </p><!--l. 1544--><p class="noindent" >If you have used package options such as <span class="cmss-10">symbols</span><a id="dx1-8028"></a> there will also be other sets of files corresponding to the extra glossaries that were created by those options. </p></li> - <li - class="enumerate" id="x1-8030x4">Run <a +<li + class="enumerate" id="x1-8030x4"> + <!--l. 1548--><p class="noindent" >Run <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8031"></a></a> with the <span @@ -3908,7 +4075,7 @@ class="cmtt-10">.gls</span>. You also need to set the language name and input en access to a terminal or a command prompt (for example, the MSDOS command prompt for Windows users or the bash console for Unix-like users) then you need to run the command (all on one line): - <!--l. 1547--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 1556--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.glg -o myDoc.gls myDoc.glo <br /></pre><spacer type=vertical size=10> <br /></span> @@ -3923,27 +4090,28 @@ class="cmtt-10">-L</span><a class="cmtt-10">german -C</span><a id="dx1-8033"></a> <span class="cmtt-10">din5007-utf8</span>.) - </p><!--l. 1556--><p class="noindent" ><div class="important" title="Important Note"> The file extensions vary according to the glossary <span + + + </p><!--l. 1565--><p class="noindent" ><div class="important" title="Important Note"> The file extensions vary according to the glossary <span class="cmtt-10">type</span><a id="dx1-8034"></a>. See <a -href="#sec:xindyapp">§1.4.3 </a><a +href="#sec:xindyapp">§<span +class="cmbx-10">??</span>sec:xindyapp </a><a href="#sec:xindyapp">Using <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-8035"></a></a> explicitly (Option 3)<!--tex4ht:ref: sec:xindyapp --></a> for - further details. <a + id="dx1-8035"></a></a> explicitly + (Option 3)<!--tex4ht:ref: sec:xindyapp --></a> for further details. <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8036"></a></a> must be called for each set of files. </div> - </p><!--l. 1560--><p class="noindent" > - </p><!--l. 1562--><p class="noindent" >It’s much simpler to use <a + </p><!--l. 1569--><p class="noindent" > + </p><!--l. 1571--><p class="noindent" >It’s much simpler to use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-8037"></a></a> instead: - </p><!--l. 1563--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 1572--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries myDoc - - <br /></pre><spacer type=vertical size=10> <br /></span> Note that the file extension isn’t supplied in this case. This will pick up all the file extensions from the <span @@ -3953,7 +4121,7 @@ class="cmtt-10">aux</span><a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8039"></a></a> the appropriate number of times with all the necessary switches. - </p><!--l. 1571--><p class="noindent" >There’s no benefit in using <a + </p><!--l. 1580--><p class="noindent" >There’s no benefit in using <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-8040"></a></a> with <a @@ -3978,7 +4146,7 @@ href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8046"></a></a> either.) - </p><!--l. 1577--><p class="noindent" >If you don’t know how to use the command prompt, then you can probably access <a + </p><!--l. 1586--><p class="noindent" >If you don’t know how to use the command prompt, then you can probably access <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8047"></a></a> or @@ -3989,7 +4157,7 @@ class="cmtt-10">makeglossaries</span><a <a href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a> for some examples. - </p><!--l. 1583--><p class="noindent" >Again, a convenient method is to use <span + </p><!--l. 1592--><p class="noindent" >Again, a convenient method is to use <span class="cmtt-10">arara </span>and add the follow comment lines to the start of your document: </p><div class="alltt"> <div class="obeylines-v"> @@ -4007,7 +4175,7 @@ class="cmtt-10"> arara:</span><span class="cmtt-10"> pdflatex</span> </div> </div> - <!--l. 1591--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you want letter ordering you need to + <!--l. 1600--><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 @@ -4016,10 +4184,10 @@ class="cmss-10">letter</span><a </p> - <div class="verbatim" id="verbatim-19"> + <pre class="verbatim" id="verbatim-19"> \usepackage[xindy,order=letter]{glossaries} -</div> - <!--l. 1596--><p class="nopar" > (and return to the previous step). This option is picked up by <a +</pre> + <!--l. 1605--><p class="nopar" > (and return to the previous step). This option is picked up by <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-8050"></a></a>. If you are explicitly using @@ -4028,33 +4196,36 @@ href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-8051"></a></a> then you’ll need to add <span class="cmtt-10">-M ord/letorder </span>to the options list. See <a -href="#sec:xindyapp">§1.4.3 </a><a +href="#sec:xindyapp">§<span +class="cmbx-10">??</span>sec:xindyapp </a><a href="#sec:xindyapp">Using <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-8052"></a></a> explicitly - (Option 3)<!--tex4ht:ref: sec:xindyapp --></a> for further details on using <span + id="dx1-8052"></a></a> + explicitly (Option 3)<!--tex4ht:ref: sec:xindyapp --></a> for further details on using <span 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 LaTeX on your document +<li + class="enumerate" id="x1-8055x5"> + <!--l. 1612--><p class="noindent" >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 id="dx1-8056"></a></a> (<a href="#option2">Option 2</a>), you may need to repeat the previous step and this step to ensure the table of contents and cross-references are resolved. +</p> </li></ol> <a id="x1-8057r4"></a> -<!--l. 1610--><p class="noindent" > +<!--l. 1619--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-90004"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option4">🔗</a><a id="option4"></a>Option 4 (<span class="cmtt-10">bib2gls</span>)</h4> -<!--l. 1612--><p class="noindent" ><br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 1621--><p class="noindent" ><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 option is only available with the <a href="#glo:glossaries-extra"><span @@ -4065,7 +4236,7 @@ class="cmtt-10">bib2gls</span><a id="dx1-9001"></a></a> to both fetch entry definitions from <span class="cmtt-10">bib</span><a id="dx1-9002"></a> files and to hierarchically sort and collate. -</p><!--l. 1617--><p class="indent" > Example document: </p><div class="alltt"> +</p><!--l. 1626--><p class="indent" > Example document: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\documentclass{article}</span> @@ -4094,6 +4265,8 @@ class="cmtt-10">\end{document}</span> </div> </div> where the file <span class="cmtt-10">entries.bib </span>contains: <div class="alltt"> + + <div class="obeylines-v"> <span id="textcolor90"><span class="cmtt-10">@entry</span></span><a @@ -4108,8 +4281,6 @@ class="cmtt-10"> description={an</span><span class="cmtt-10"> example}</span> <br /><span class="cmtt-10">}</span> - - <br /><span id="textcolor91"><span class="cmtt-10">@symbol</span></span><a id="dx1-9007"></a><span @@ -4138,14 +4309,14 @@ class="cmtt-10"> language}</span> class="cmtt-10">}</span> </div> </div> -<!--l. 1643--><p class="indent" > All entries must be provided in one or more <span +<!--l. 1652--><p class="indent" > All entries must be provided in one or more <span class="cmtt-10">bib</span><a id="dx1-9009"></a> files. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-9010"></a></a> user manual for the required format. -</p><!--l. 1646--><p class="indent" > <div class="important" title="Important Note"> Note that the <span +</p><!--l. 1655--><p class="indent" > <div class="important" title="Important Note"> Note that the <span class="cmtt-10">sort</span><a id="dx1-9011"></a> key should not be used. Each entry type (<span id="textcolor93"><span class="cmtt-10">@entry</span></span><a @@ -4165,8 +4336,8 @@ class="cmtt-10">sort</span><a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a> for examples. </div> -</p><!--l. 1653--><p class="noindent" > -</p><!--l. 1655--><p class="indent" > The <a +</p><!--l. 1662--><p class="noindent" > +</p><!--l. 1664--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package needs to be loaded with the <span id="textcolor96"><span class="cmss-10">record</span></span><a @@ -4201,20 +4372,22 @@ class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a id="dx1-9020"></a> option is the best method. -<!--l. 1670--><p class="indent" > (It’s possible to use a hybrid of this method and Options <a +<!--l. 1679--><p class="indent" > (It’s possible to use a hybrid of this method and Options <a href="#option2">2</a> or <a href="#option3">3</a> with <span id="textcolor101"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span -class="cmss-10">alsoindex</span></span><a +class="cmss-10">hybrid</span></span><a id="dx1-9021"></a> but in general there is little need for this and it complicates the build process.) -</p><!--l. 1674--><p class="indent" > Each resource set is loaded with <span id="textcolor102"><span +</p><!--l. 1683--><p class="indent" > Each resource set is loaded with <span id="textcolor102"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a id="dx1-9022"></a><span class="cmtt-10">[</span>⟨<span class="cmti-10">options</span>⟩<span class="cmtt-10">]</span>. For example: </p><div class="alltt"> + + <div class="obeylines-v"> <span id="textcolor103"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a @@ -4226,8 +4399,6 @@ class="cmtt-10"> in</span><span class="cmtt-10"> entries1.bib</span><span class="cmtt-10"> and</span><span class="cmtt-10"> entries2.bib:</span> - - <br /><span class="cmtt-10"> </span><span id="textcolor104"><span class="cmtt-10">src</span></span><a @@ -4256,7 +4427,7 @@ class="cmtt-10">sort</span></span><a sorting method. This may be a locale identifier for alphabetic sorting, but there are other sort methods available, such as character code or numeric. One resource set may cover multiple glossaries or one glossary may be split across multiple resource sets, forming logical sub-blocks. -<!--l. 1691--><p class="indent" > If you want to ensure that all entries are selected, even if they haven’t been referenced in the document, then +<!--l. 1700--><p class="indent" > If you want to ensure that all entries are selected, even if they haven’t been referenced in the document, then add the option <span id="textcolor108"><span class="cmtt-10">selection</span></span><span class="cmtt-10">=all</span><a @@ -4266,7 +4437,7 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-9030"></a></a> user manual for further details.) -</p><!--l. 1697--><p class="indent" > The glossary is displayed using: </p><div class="alltt"> +</p><!--l. 1706--><p class="indent" > The glossary is displayed using: </p><div class="alltt"> <div class="obeylines-v"> <span id="textcolor109"><span class="cmtt-10">\printunsrtglossary</span></span><a @@ -4279,7 +4450,7 @@ class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-9032"></a> </div> </div> The document is built using: -<!--l. 1707--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 1716--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br />bib2gls myDoc <br />pdflatex myDoc @@ -4288,7 +4459,7 @@ class="cmtt-10">\printunsrtglossaries</span></span><a If letter groups are required, you need the <span id="textcolor111"><span class="cmtt-10">--group</span></span><a id="dx1-9033"></a> switch: -</p><!--l. 1713--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 1722--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />bib2gls --group myDoc <br /></pre><spacer type=vertical size=10> <br /></span> @@ -4304,20 +4475,20 @@ class="cmtt-10"> {</span><span class="cmtt-10"> group:</span><span class="cmtt-10"> on</span><span class="cmtt-10"> }</span> + + </div> </div> (You will also need an appropriate glossary style.) -<!--l. 1722--><p class="indent" > Unlike Options <a +<!--l. 1731--><p class="indent" > Unlike Options <a href="#option2">2</a> and <a href="#option3">3</a>, this method doesn’t create a file containing the typeset glossary but simply determines which entries are needed for the document, their associated locations and (if required) their associated letter group. This option allows a mixture of sort methods. For example, sorting by word order for - - one glossary and order of use for another or even sorting one block of the glossary differently to another block in the same glossary. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a>. -</p><!--l. 1731--><p class="indent" > This method supports Unicode and uses the Common Locale Data Repository, which provides more extensive language support +</p><!--l. 1740--><p class="indent" > This method supports Unicode and uses the Common Locale Data Repository, which provides more extensive language support than <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a @@ -4331,54 +4502,123 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-9039"></a></a> can deduce a numerical value it will attempt to form ranges otherwise it will simply list the locations. -</p><!--l. 1739--><p class="indent" > See <a +</p><!--l. 1748--><p class="indent" > Summary: + </p><ol class="enumerate1" > +<li + class="enumerate" id="x1-9041x1"> + <!--l. 1750--><p class="noindent" >Use <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> with the <span id="textcolor112"><span +class="cmss-10">p</span><span +class="cmtt-10">=</span><span +class="cmss-10">record</span></span><a + id="dx1-9042"></a>ackage option: + + +</p> + <pre class="verbatim" id="verbatim-20"> + \usepackage[record]{glossaries-extra} +</pre> + <!--l. 1754--><p class="nopar" > + </p></li> +<li + class="enumerate" id="x1-9044x2"> + <!--l. 1756--><p class="noindent" >Use <span +class="cmtt-10">\*</span>GlsXtrLoadResources to identify the <span +class="cmtt-10">bib</span><a + id="dx1-9045"></a> file(s) and <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-9046"></a></a> options: + + +</p> + <pre class="verbatim" id="verbatim-21"> + \GlsXtrLoadResources[src={terms.bib,abbreviations.bib},sort=en] +</pre> + <!--l. 1760--><p class="nopar" > + </p></li> +<li + class="enumerate" id="x1-9048x3"> + <!--l. 1762--><p class="noindent" >Put </p><div class="alltt"> + <div class="obeylines-v"> + <span +class="cmtt-10">\*printunsrtglossary</span> +</div> + </div> where you want your list of entries to appear. Alternatively to display all glossaries use the iterative + command: <div class="alltt"> + <div class="obeylines-v"> + <span +class="cmtt-10">\*printunsrtglossaries</span> +</div> + </div> + </li> +<li + class="enumerate" id="x1-9050x4"> + <!--l. 1772--><p class="noindent" >Run LaTeX on your document. + </p></li> +<li + class="enumerate" id="x1-9052x5"> + <!--l. 1774--><p class="noindent" >Run <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-9053"></a></a> with just the document base name. + </p></li> +<li + class="enumerate" id="x1-9055x6"> + <!--l. 1776--><p class="noindent" >Run LaTeX on your document. +</p> + </li></ol> + + +<!--l. 1780--><p class="indent" > See <a 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> or the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-9040"></a></a> user manual for further details of + id="dx1-9056"></a></a> user manual for further details of this method, and also <a href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a>. <a - id="x1-9041r5"></a> -</p><!--l. 1745--><p class="noindent" > + id="x1-9057r5"></a> +</p><!--l. 1786--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-100005"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option5">🔗</a><a id="option5"></a>Option 5 (no sorting)</h4> -<!--l. 1747--><p class="noindent" ><br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 1788--><p class="noindent" ><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 option is only available with the extension package <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. No <a href="#glo:indexingapp">indexing application</a> is required. -</p><!--l. 1751--><p class="indent" > Example document: +</p><!--l. 1792--><p class="indent" > Example document: </p> - <div class="verbatim" id="verbatim-20"> + <pre class="verbatim" id="verbatim-22"> \documentclass{article} - <br />\usepackage[sort=none]{glossaries-extra} - <br />\newglossaryentry{sample}{name={sample}, - <br /> description={an example}} - <br />\newglossaryentry{alpha}{name={\ensuremath{\alpha}}, - <br /> description={...}} - <br />\begin{document} - <br />\gls{sample}. -</div> -<!--l. 1761--><p class="nopar" > </p><div class="alltt"> +\usepackage[sort=none]{glossaries-extra} +\newglossaryentry{sample}{name={sample}, + description={an example}} +\newglossaryentry{alpha}{name={\ensuremath{\alpha}}, + description={...}} +\begin{document} +\gls{sample}. +</pre> +<!--l. 1802--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor112"><span +<span id="textcolor113"><span class="cmtt-10">\printunsrtglossary</span></span><a id="dx1-10001"></a> <br /><span class="cmtt-10">\end{document}</span> </div> </div> -<!--l. 1767--><p class="indent" > This method is best used with the package option <span +<!--l. 1808--><p class="indent" > This method is best used with the package option <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">none</span><a @@ -4386,8 +4626,12 @@ class="cmss-10">none</span><a command (such as <span class="cmtt-10">\makeglossaries </span>for Options <a href="#option2">2</a> and <a -href="#option3">3</a>). -</p><!--l. 1771--><p class="indent" > All entries must be defined before the glossary is displayed (preferably in the preamble) in the +href="#option3">3</a>). In general it’s best to use a style that doesn’t show +letter group headings. If you do want letter headings then you must ensure that you have defined +your entries in alphabetical order, and use XeLaTeX or LuaLaTeX if you require <a +href="#glo:UTF-8">UTF-8</a> letter +groups. +</p><!--l. 1816--><p class="indent" > All entries must be defined before the glossary is displayed (preferably in the preamble) in the required order, and child entries must be defined immediately after their parent entry if they must be kept together in the glossary. (Some glossary styles indent entries that have a parent but it’s the <a @@ -4397,17 +4641,19 @@ order.) You can place all your entry definitions in a separate file and load it <span class="cmtt-10">\loadglsentries</span><a id="dx1-10003"></a>. -</p><!--l. 1782--><p class="indent" > The glossary is displayed using: </p><div class="alltt"> +</p><!--l. 1827--><p class="indent" > The glossary is displayed using: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor113"><span +<span id="textcolor114"><span class="cmtt-10">\printunsrtglossary</span></span><a id="dx1-10004"></a> </div> </div> Alternatively all glossaries can be displayed using the iterative command: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor114"><span +<span id="textcolor115"><span class="cmtt-10">\printunsrtglossaries</span></span><a id="dx1-10005"></a> + + </div> </div> This will display <span class="cmti-10">all </span>defined entries, regardless of whether or not they have been used in the document. The @@ -4421,37 +4667,35 @@ class="cmtt-10">bib2gls</span><a id="dx1-10007"></a></a> takes advantage of this method by defining the wanted entries in the required order and setting the locations (and letter group information, if required). - - -<!--l. 1799--><p class="indent" > Therefore, the above example document has a glossary containing the entries: sample and <span +<!--l. 1844--><p class="indent" > Therefore, the above example document has a glossary containing the entries: sample and <span 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 LaTeX call: -</p><!--l. 1805--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 1849--><p class="indent" > This just requires a single LaTeX call: +</p><!--l. 1850--><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> <br /></span> unless the glossary needs to appear in the table of contents, in which case a second run is required: -</p><!--l. 1810--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 1855--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br />pdflatex myDoc <br /></pre><spacer type=vertical size=10> <br /></span> (Naturally if the document also contains citations, and so on, then additional steps are required. Similarly for all the other options above.) -</p><!--l. 1818--><p class="indent" > See the <a +</p><!--l. 1863--><p class="indent" > See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> documentation for further details of this method. <a id="x1-10008r6"></a> -</p><!--l. 1820--><p class="noindent" > +</p><!--l. 1865--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-110006"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option6">🔗</a><a id="option6"></a>Option 6 (standalone)</h4> -<!--l. 1822--><p class="noindent" ><br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 1867--><p class="noindent" ><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 option is only available with the <a href="#glo:glossaries-extra"><span @@ -4461,7 +4705,7 @@ href="#fn3x1" id="fn3x1-bk"><sup class="textsuperscript">1.3</sup></a></span><a id="x1-11001f3"></a> Instead of creating a list, this has standalone definitions throughout the document. The entry name may or may not be in a section heading. -</p><!--l. 1832--><p class="indent" > You can either define entries in the document preamble (or in an external file loaded with <span +</p><!--l. 1877--><p class="indent" > You can either define entries in the document preamble (or in an external file loaded with <span class="cmtt-10">\loadglsentries</span><a id="dx1-11004"></a>), as with <a @@ -4469,29 +4713,29 @@ href="#option5">Option 5</a>, for example: </p> - <div class="verbatim" id="verbatim-21"> + <pre class="verbatim" id="verbatim-23"> \documentclass{article} - <br />\usepackage[colorlinks]{hyperref} - <br />\usepackage[sort=none, - <br />   nostyles% <- no glossary styles are required - <br /> ]{glossaries-extra} - <br />\newglossaryentry{set}{name={set}, - <br />  description={a collection of any kind of objects}, - <br />  symbol={\ensuremath{\mathcal{S}}} - <br />} - <br />\newglossaryentry{function}{name={function}, - <br />  description={a rule that assigns every element in the - <br />  domain \gls{set} to an element in the range \gls{set}}, - <br />  symbol={\ensuremath{f(x)}} - <br />} -</div> -<!--l. 1852--><p class="nopar" > </p><div class="alltt"> +\usepackage[colorlinks]{hyperref} +\usepackage[sort=none, +   nostyles% <- no glossary styles are required + ]{glossaries-extra} +\newglossaryentry{set}{name={set}, +  description={a collection of any kind of objects}, +  symbol={\ensuremath{\mathcal{S}}} +} +\newglossaryentry{function}{name={function}, +  description={a rule that assigns every element in the +  domain \gls{set} to an element in the range \gls{set}}, +  symbol={\ensuremath{f(x)}} +} +</pre> +<!--l. 1897--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newcommand*{\termdef}[1]{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \section{</span><span id="textcolor115"><span +class="cmtt-10"> \section{</span><span id="textcolor116"><span class="cmtt-10">\glsxtrglossentry</span></span><a id="dx1-11005"></a><span class="cmtt-10">{#1}</span><span @@ -4509,18 +4753,18 @@ class="cmtt-10">}</span> </div> - <div class="verbatim" id="verbatim-22"> + <pre class="verbatim" id="verbatim-24"> \begin{document} - <br />\tableofcontents - <br />\section{Introduction} - <br />Sample document about \glspl{function} and \glspl{set}. - <br />\termdef{set} - <br />More detailed information about \glspl{set} with examples. - <br />\termdef{function} - <br />More detailed information about \glspl{function} with examples. - <br />\end{document} -</div> -<!--l. 1875--><p class="nopar" > Or you can use <a +\tableofcontents +\section{Introduction} +Sample document about \glspl{function} and \glspl{set}. +\termdef{set} +More detailed information about \glspl{set} with examples. +\termdef{function} +More detailed information about \glspl{function} with examples. +\end{document} +</pre> +<!--l. 1920--><p class="nopar" > Or you can use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11008"></a></a> if you want to manage a large database of terms. For example (requires <a @@ -4534,7 +4778,7 @@ class="cmtt-10">\documentclass{article}</span> <br /><span class="cmtt-10">\usepackage[colorlinks]{hyperref}</span> <br /><span -class="cmtt-10">\usepackage[</span><span id="textcolor116"><span +class="cmtt-10">\usepackage[</span><span id="textcolor117"><span class="cmtt-10">record</span></span><span class="cmtt-10">,</span> <br /><span @@ -4551,16 +4795,16 @@ class="cmtt-10"> required</span> class="cmtt-10"> </span><span class="cmtt-10"> ]{glossaries-extra}</span> <br /> -<br /><span id="textcolor117"><span +<br /><span id="textcolor118"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a id="dx1-11009"></a><span -class="cmtt-10">[</span><span id="textcolor118"><span +class="cmtt-10">[</span><span id="textcolor119"><span class="cmtt-10">src</span></span><a id="dx1-11010"></a><span -class="cmtt-10">=terms,</span><span id="textcolor119"><span +class="cmtt-10">=terms,</span><span id="textcolor120"><span class="cmtt-10">sort</span></span><a id="dx1-11011"></a><span -class="cmtt-10">=none,</span><span id="textcolor120"><span +class="cmtt-10">=none,</span><span id="textcolor121"><span class="cmtt-10">save-locations</span></span><a id="dx1-11012"></a><span class="cmtt-10">=false]</span> @@ -4569,7 +4813,7 @@ class="cmtt-10">=false]</span> class="cmtt-10">\newcommand*{\termdef}[1]{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \section{</span><span id="textcolor121"><span +class="cmtt-10"> \section{</span><span id="textcolor122"><span class="cmtt-10">\glsxtrglossentry</span></span><a id="dx1-11013"></a><span class="cmtt-10">{#1}</span><span @@ -4597,21 +4841,21 @@ class="cmtt-10">}</span> </div> - <div class="verbatim" id="verbatim-23"> + <pre class="verbatim" id="verbatim-25"> \begin{document} - <br />\tableofcontents - <br />\section{Introduction} - <br />Sample document about \glspl{function} and \glspl{set}. - <br />\termdef{set} - <br />More detailed information about \glspl{set} with examples. - <br />\termdef{function} - <br />More detailed information about \glspl{function} with examples. - <br />\end{document} -</div> -<!--l. 1910--><p class="nopar" > Where the file <span +\tableofcontents +\section{Introduction} +Sample document about \glspl{function} and \glspl{set}. +\termdef{set} +More detailed information about \glspl{set} with examples. +\termdef{function} +More detailed information about \glspl{function} with examples. +\end{document} +</pre> +<!--l. 1955--><p class="nopar" > Where the file <span class="cmtt-10">terms.bib </span>contains: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor122"><span +<span id="textcolor123"><span class="cmtt-10">@entry</span></span><a id="dx1-11017"></a><span class="cmtt-10">{set,</span> @@ -4632,7 +4876,7 @@ class="cmtt-10"> </span><span class="cmtt-10"> symbol={\ensuremath{\mathcal{S}}}</span> <br /><span class="cmtt-10">}</span> -<br /><span id="textcolor123"><span +<br /><span id="textcolor124"><span class="cmtt-10">@entry</span></span><a id="dx1-11018"></a><span class="cmtt-10">{function,</span> @@ -4673,11 +4917,11 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11020"></a></a>) is that you can use an existing database of entries shared across multiple documents, ensuring consistent notation for all of them. -<!--l. 1930--><p class="indent" > In both cases, there’s no need to load all the glossary styles packages, as they’re not required, so I’ve used +<!--l. 1975--><p class="indent" > In both cases, there’s no need to load all the glossary styles packages, as they’re not required, so I’ve used the <span class="cmss-10">nostyles</span><a id="dx1-11021"></a> package option to prevent them from being loaded. -</p><!--l. 1934--><p class="indent" > In the first case, you need the <span +</p><!--l. 1979--><p class="indent" > In the first case, you need the <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">none</span><a @@ -4685,14 +4929,14 @@ class="cmss-10">none</span><a href="#option5">Option 5</a>) and then define the terms in the 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"> +</p><!--l. 1983--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br />pdflatex myDoc <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 1943--><p class="indent" > In the second case, you need the <span id="textcolor124"><span +</p><!--l. 1988--><p class="indent" > In the second case, you need the <span id="textcolor125"><span class="cmss-10">record</span></span><a id="dx1-11023"></a> package option (as in <a href="#option4">Option 4</a>) since <a @@ -4701,13 +4945,13 @@ class="cmtt-10">bib2gls</span><a id="dx1-11024"></a></a> is needed to select the required entries, but you don’t need a sorted list: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor125"><span +<span id="textcolor126"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a id="dx1-11025"></a><span -class="cmtt-10">[</span><span id="textcolor126"><span +class="cmtt-10">[</span><span id="textcolor127"><span class="cmtt-10">src</span></span><a id="dx1-11026"></a><span -class="cmtt-10">={terms},</span><strong><span id="textcolor127"><span +class="cmtt-10">={terms},</span><strong><span id="textcolor128"><span class="cmtt-10">sort</span></span><span class="cmtt-10">=none</span></strong><span class="cmtt-10">]</span> @@ -4721,28 +4965,28 @@ selected by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11029"></a></a>, but it will skip the sorting step. (The chances are you probably also won’t need location -lists either. If so, you can add the option <span id="textcolor128"><span +lists either. If so, you can add the option <span id="textcolor129"><span class="cmtt-10">save-locations</span></span><span class="cmtt-10">=false</span><a id="dx1-11030"></a>.) -<!--l. 1955--><p class="indent" > Remember that for this second case you need to run <a +<!--l. 2000--><p class="indent" > Remember that for this second case you need to run <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11031"></a></a> as per <a href="#option4">Option 4</a>: -</p><!--l. 1956--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 2001--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br />bib2gls myDoc <br />pdflatex myDoc <br />pdflatex myDoc <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 1963--><p class="indent" > For both cases (with or without <a +</p><!--l. 2008--><p class="indent" > For both cases (with or without <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-11032"></a></a>), instead of listing all the entries using <span id="textcolor129"><span + id="dx1-11032"></a></a>), instead of listing all the entries using <span id="textcolor130"><span class="cmtt-10">\printunsrtglossary</span></span>, you -use <span id="textcolor130"><span +use <span id="textcolor131"><span class="cmtt-10">\glsxtrglossentry</span></span><a id="dx1-11033"></a><span class="cmtt-10">{</span>⟨<span @@ -4769,7 +5013,7 @@ examples. In both examples, I’ve defined a custom command <span class="cmtt-10">\termdef </span>to simplify the code and ensure consistency. Extra styling, such as placing the description in a coloured frame, can be added to this custom definition as required. -</p><!--l. 1976--><p class="indent" > (Instead of using <span +</p><!--l. 2021--><p class="indent" > (Instead of using <span class="cmtt-10">\glsentrydesc </span>or <span class="cmtt-10">\Glsentrydesc</span>, you can use <span class="cmtt-10">\glossentrydesc</span><a @@ -4777,15 +5021,15 @@ class="cmtt-10">\glossentrydesc</span><a class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>, which -will obey attributes such as <span id="textcolor131"><span +will obey attributes such as <span id="textcolor132"><span class="cmss-10">glossdesc</span></span><a - id="dx1-11039"></a> and <span id="textcolor132"><span + id="dx1-11039"></a> and <span id="textcolor133"><span class="cmss-10">glossdescfont</span></span><a id="dx1-11040"></a>. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details.) -</p><!--l. 1981--><p class="indent" > The symbol (if required) can be displayed with either <span +</p><!--l. 2026--><p class="indent" > The symbol (if required) can be displayed with either <span class="cmtt-10">\glsentrysymbol</span><a id="dx1-11041"></a><span class="cmtt-10">{</span>⟨<span @@ -4805,13 +5049,13 @@ 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 LaTeX run. -</p><!--l. 1988--><p class="indent" > In normal document text, <span +</p><!--l. 2033--><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 class="cmtt-10">aux</span><a id="dx1-11045"></a> file, which triggers an error. -</p><!--l. 1993--><p class="indent" > The <span +</p><!--l. 2038--><p class="indent" > The <span class="cmtt-10">\glossentrysymbol</span><a id="dx1-11046"></a> command performs an existence check, which triggers a warning if the entry is undefined. (All entries will be undefined before the first <a @@ -4831,7 +5075,7 @@ class="cmtt-10">\texorpdfstring</span><a (see the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details). -</p><!--l. 2004--><p class="indent" > If you want to test if the <span +</p><!--l. 2049--><p class="indent" > If you want to test if the <span class="cmtt-10">symbol</span><a id="dx1-11051"></a> field has been set, you need to use <span class="cmtt-10">\ifglshassymbol</span><a @@ -4843,69 +5087,69 @@ title. For example: </p><div class="alltt"> <span class="cmtt-10">\ifglshassymbol{#1}%</span> <br /><span -class="cmtt-10">{\section{</span><span id="textcolor133"><span +class="cmtt-10">{\section{</span><span id="textcolor134"><span class="cmtt-10">\glsxtrglossentry</span></span><span class="cmtt-10">{#1}</span><span class="cmtt-10"> \glossentrysymbol{#1}}}</span> <br /><span -class="cmtt-10">{\section{</span><span id="textcolor134"><span +class="cmtt-10">{\section{</span><span id="textcolor135"><span class="cmtt-10">\glsxtrglossentry</span></span><span class="cmtt-10">{#1}}}</span> </div> </div> -<!--l. 2013--><p class="indent" > In both of the above examples, the section titles start with a lowercase character (because the <span +<!--l. 2058--><p class="indent" > In both of the above examples, the section titles start with a lowercase character (because the <span class="cmtt-10">name</span><a id="dx1-11053"></a> value is -all lowercase in entry definitions). You can apply automatic case-change with the <span id="textcolor135"><span +all lowercase in entry definitions). You can apply automatic case-change with the <span id="textcolor136"><span class="cmss-10">glossname</span></span><a id="dx1-11054"></a> attribute. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor136"><span +<span id="textcolor137"><span class="cmtt-10">\glssetcategoryattribute</span></span><a id="dx1-11055"></a><span class="cmtt-10">{general}{glossname}{firstuc}</span> </div> </div> or (for title-case) <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor137"><span +<span id="textcolor138"><span class="cmtt-10">\glssetcategoryattribute</span></span><a id="dx1-11056"></a><span class="cmtt-10">{general}{glossname}{title}</span> </div> </div> However, this won’t apply the case-change in the table of contents or bookmarks. -<!--l. 2027--><p class="indent" > In the second example, you can instead use <a +<!--l. 2072--><p class="indent" > In the second example, you can instead use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11057"></a></a> to apply a case-change: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\GlsXtrLoadResources[</span><span id="textcolor138"><span +class="cmtt-10">\GlsXtrLoadResources[</span><span id="textcolor139"><span class="cmtt-10">src</span></span><a id="dx1-11058"></a><span class="cmtt-10">=terms,</span> <br /><span -class="cmtt-10"> </span><span id="textcolor139"><span +class="cmtt-10"> </span><span id="textcolor140"><span class="cmtt-10">sort</span></span><a id="dx1-11059"></a><span -class="cmtt-10">=none,</span><span id="textcolor140"><span +class="cmtt-10">=none,</span><span id="textcolor141"><span class="cmtt-10">save-locations</span></span><a id="dx1-11060"></a><span class="cmtt-10">=false</span><strong><span class="cmtt-10">,</span> <br /><span -class="cmtt-10"> </span><span id="textcolor141"><span +class="cmtt-10"> </span><span id="textcolor142"><span class="cmtt-10">replicate-fields</span></span><a id="dx1-11061"></a><span class="cmtt-10">={name=text},</span> <br /><span -class="cmtt-10"> </span><span id="textcolor142"><span +class="cmtt-10"> </span><span id="textcolor143"><span class="cmtt-10">name-case-change</span></span><span class="cmtt-10">=firstuc</span></strong> <br /><span class="cmtt-10">]</span> </div> -</div> (Or <span id="textcolor143"><span +</div> (Or <span id="textcolor144"><span class="cmtt-10">name-case-change</span></span><span class="cmtt-10">=title</span><a id="dx1-11062"></a> for title-case.) This copies the <span @@ -4924,7 +5168,7 @@ href="#glo:linktext">link text<a class="cmtt-10">\gls</span><a id="dx1-11068"></a> is still lowercase. -<!--l. 2043--><p class="indent" > In the first example (without <a +<!--l. 2088--><p class="indent" > In the first example (without <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11069"></a></a>) you need to do this manually. For example: </p><div class="alltt"> @@ -4953,7 +5197,7 @@ class="cmtt-10">}</span> </div> </div> -<!--l. 2052--><p class="indent" > Note that if you use the default <span id="textcolor144"><span +<!--l. 2097--><p class="indent" > Note that if you use the default <span id="textcolor145"><span class="cmtt-10">save-locations</span></span><span class="cmtt-10">=true</span><a id="dx1-11070"></a> with <a @@ -4963,7 +5207,7 @@ class="cmtt-10">bib2gls</span><a href="#option4">4</a> and <a href="#option6">6</a> to have both standalone definitions and an index. Now I do need a glossary style. In this case I’m going -to use <span id="textcolor145"><span +to use <span id="textcolor146"><span class="cmss-10">bookindex</span></span><a id="dx1-11072"></a>, which is provided in the <span class="cmss-10">glossary-bookindex</span><a @@ -4978,7 +5222,7 @@ class="cmss-10">glossary-bookindex</span><a </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><span id="textcolor146"><span +class="cmtt-10">\usepackage[</span><span id="textcolor147"><span class="cmtt-10">record=nameref</span></span><span class="cmtt-10">,%</span><span class="cmtt-10"> <-</span><span @@ -4993,14 +5237,14 @@ class="cmtt-10"> default</span><span class="cmtt-10"> style</span><span class="cmtt-10"> packages</span> <br /><span -class="cmtt-10"> </span><span id="textcolor147"><span +class="cmtt-10"> </span><span id="textcolor148"><span class="cmtt-10">stylemods=bookindex</span></span><span class="cmtt-10">,%</span><span class="cmtt-10"> <-</span><span class="cmtt-10"> load</span><span class="cmtt-10"> glossary-bookindex.sty</span> <br /><span -class="cmtt-10"> style=</span><span id="textcolor148"><span +class="cmtt-10"> style=</span><span id="textcolor149"><span class="cmtt-10">bookindex</span></span><span class="cmtt-10">%</span><span class="cmtt-10"> <-</span><span @@ -5015,10 +5259,10 @@ class="cmtt-10">]{glossaries-extra}</span> </div> </div> I also need to sort the entries, so the resource command is now: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor149"><span +<span id="textcolor150"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a id="dx1-11076"></a><span -class="cmtt-10">[</span><span id="textcolor150"><span +class="cmtt-10">[</span><span id="textcolor151"><span class="cmtt-10">src</span></span><a id="dx1-11077"></a><span class="cmtt-10">=terms,%</span><span @@ -5026,7 +5270,7 @@ class="cmtt-10"> definitions</span><span class="cmtt-10"> in</span><span class="cmtt-10"> terms.bib</span> <br /><span -class="cmtt-10"> </span><span id="textcolor151"><span +class="cmtt-10"> </span><span id="textcolor152"><span class="cmtt-10">sort</span></span><a id="dx1-11078"></a><span class="cmtt-10">=en-GB,%</span><span @@ -5035,12 +5279,12 @@ class="cmtt-10"> by</span><span class="cmtt-10"> this</span><span class="cmtt-10"> locale</span> <br /><span -class="cmtt-10"> </span><span id="textcolor152"><span +class="cmtt-10"> </span><span id="textcolor153"><span class="cmtt-10">replicate-fields</span></span><a id="dx1-11079"></a><span class="cmtt-10">={name=text},</span> <br /><span -class="cmtt-10"> </span><span id="textcolor153"><span +class="cmtt-10"> </span><span id="textcolor154"><span class="cmtt-10">name-case-change</span></span><span class="cmtt-10">={firstuc}</span> <br /><span @@ -5048,18 +5292,18 @@ class="cmtt-10">]</span> </div> </div> At the end of the document, I can add the glossary: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor154"><span +<span id="textcolor155"><span class="cmtt-10">\printunsrtglossary</span></span><a id="dx1-11080"></a><span class="cmtt-10">[title=Index,target=false]</span> </div> </div> Note that I’ve had to switch off the hypertargets with <a - id="dx1-11081"></a><span id="textcolor155"><span + id="dx1-11081"></a><span id="textcolor156"><span class="cmtt-10">target=false</span></span> (otherwise there would be duplicate -targets). If you want letter group headings you need to use the <span id="textcolor156"><span +targets). If you want letter group headings you need to use the <span id="textcolor157"><span class="cmtt-10">--group</span></span><a id="dx1-11082"></a> switch: -<!--l. 2083--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 2128--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />bib2gls --group myDoc <br /></pre><spacer type=vertical size=10> <br /></span> @@ -5079,11 +5323,11 @@ class="cmtt-10"> }</span> </div> -<!--l. 2091--><p class="indent" > The <span id="textcolor157"><span +<!--l. 2136--><p class="indent" > The <span id="textcolor158"><span class="cmss-10">bookindex</span></span><a id="dx1-11084"></a> style doesn’t show the description, so only the name and location is displayed. Remember that the name has had a case-conversion so it now starts with an initial capital. If you feel this is inappropriate -for the index, you can adjust the <span id="textcolor158"><span +for the index, you can adjust the <span id="textcolor159"><span class="cmss-10">bookindex</span></span><a id="dx1-11085"></a> style so that it uses the <span class="cmtt-10">text</span><a @@ -5091,13 +5335,13 @@ class="cmtt-10">text</span><a </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor159"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor160"><span class="cmtt-10">\glsxtrbookindexname</span></span><a id="dx1-11087"></a><span class="cmtt-10">}[1]{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor160"><span +class="cmtt-10"> </span><span id="textcolor161"><span class="cmtt-10">\glossentrynameother</span></span><a id="dx1-11088"></a><span class="cmtt-10">{#1}{text}}</span> @@ -5105,24 +5349,24 @@ 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 LaTeX run none of the entries will be defined. Once they are defined, the page +<!--l. 2149--><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 -them with <span id="textcolor161"><span +</p><!--l. 2154--><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 +them with <span id="textcolor162"><span class="cmtt-10">@index</span></span><a id="dx1-11089"></a> in the <span class="cmtt-10">bib</span><a id="dx1-11090"></a> file. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor162"><span +<span id="textcolor163"><span class="cmtt-10">@index</span></span><a id="dx1-11091"></a><span class="cmtt-10">{element}</span> -<br /><span id="textcolor163"><span +<br /><span id="textcolor164"><span class="cmtt-10">@index</span></span><a id="dx1-11092"></a><span -class="cmtt-10">{member,</span><span id="textcolor164"><span id="textcolor165"><span +class="cmtt-10">{member,</span><span id="textcolor165"><span id="textcolor166"><span class="cmtt-10">alias</span></span><a id="dx1-11093"></a></span><span class="cmtt-10">={element}}</span> @@ -5130,11 +5374,11 @@ class="cmtt-10">={element}}</span> </div> They can be used in the document as usual: - <div class="verbatim" id="verbatim-24"> + <pre class="verbatim" id="verbatim-26"> The objects that make up a set are the \glspl{element} - <br />or \glspl{member}. -</div> -<!--l. 2120--><p class="nopar" > See <a +or \glspl{member}. +</pre> +<!--l. 2165--><p class="nopar" > See <a 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> or the <a @@ -5142,17 +5386,18 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-11094"></a></a> user manual for further details. -</p><!--l. 2124--><p class="indent" > The <span +</p><!--l. 2169--><p class="indent" > The <span class="cmss-10">glossaries </span>package comes with a number of sample documents that illustrate the various functions. These are listed in <a -href="#sec:samples">§19 </a><a +href="#sec:samples">§<span +class="cmbx-10">??</span>sec:samples </a><a href="#sec:samples">Sample Documents<!--tex4ht:ref: sec:samples --></a>. -</p><!--l. 2128--><p class="noindent" > +</p><!--l. 2173--><p class="noindent" > </p> -<!--l. 2128--><p class="noindent" ><a +<!--l. 2173--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.2 </span> <a id="sec:lipsum"></a>Dummy Entries for Testing</h3> -<!--l. 2131--><p class="noindent" >In addition to the sample files described above, <span +<!--l. 2176--><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 TeX’s path (in @@ -5172,115 +5417,136 @@ class="cmtt-10">bib2gls</span><a id="dx1-12005"></a></a>. The files are as follows: </p><dl class="description"><dt class="description"> + <!--l. 2186--><p class="noindent" > <span -class="cmbx-10">example-glossaries-brief.tex</span> </dt><dd -class="description">These entries all have brief descriptions. For example: +class="cmbx-10">example-glossaries-brief.tex</span> </p></dt><dd +class="description"> + <!--l. 2186--><p class="noindent" >These entries all have brief descriptions. For example: - <div class="verbatim" id="verbatim-25"> +</p> + <pre class="verbatim" id="verbatim-27"> \newglossaryentry{lorem}{name={lorem},description={ipsum}} -</div> - <!--l. 2145--><p class="nopar" > +</pre> + <!--l. 2190--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2192--><p class="noindent" > <span -class="cmbx-10">example-glossaries-long.tex</span> </dt><dd -class="description">These entries all have long descriptions. For example: +class="cmbx-10">example-glossaries-long.tex</span> </p></dt><dd +class="description"> + <!--l. 2192--><p class="noindent" >These entries all have long descriptions. For example: - <div class="verbatim" id="verbatim-26"> +</p> + <pre class="verbatim" id="verbatim-28"> \newglossaryentry{loremipsum}{name={lorem ipsum}, -  <br />description={dolor sit amet, consectetuer adipiscing -  <br />elit. Ut purus elit, vestibulum ut, placerat ac, -  <br />adipiscing vitae, felis. Curabitur dictum gravida -  <br />mauris.}} -</div> - <!--l. 2155--><p class="nopar" > + description={dolor sit amet, consectetuer adipiscing + elit. Ut purus elit, vestibulum ut, placerat ac, + adipiscing vitae, felis. Curabitur dictum gravida + mauris.}} +</pre> + <!--l. 2200--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2202--><p class="noindent" > <span -class="cmbx-10">example-glossaries-multipar.tex</span> </dt><dd -class="description">These entries all have multi-paragraph descriptions. For example: +class="cmbx-10">example-glossaries-multipar.tex</span> </p></dt><dd +class="description"> + <!--l. 2202--><p class="noindent" >These entries all have multi-paragraph descriptions. For example: - <div class="verbatim" id="verbatim-27"> +</p> + <pre class="verbatim" id="verbatim-29"> \longnewglossaryentry{loremi-ii}{name={lorem 1--2}}% -  <br />{% -  <br />Lorem ipsum ... -  <br />Nam dui ligula... -  <br />} -</div> - <!--l. 2166--><p class="nopar" > + {% + Lorem ipsum ... + Nam dui ligula... + } +</pre> + <!--l. 2211--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2213--><p class="noindent" > <span -class="cmbx-10">example-glossaries-symbols.tex</span> </dt><dd -class="description">These entries all use the <span +class="cmbx-10">example-glossaries-symbols.tex</span> </p></dt><dd +class="description"> + <!--l. 2213--><p class="noindent" >These entries all use the <span class="cmtt-10">symbol</span><a id="dx1-12006"></a> key. For example: - <div class="verbatim" id="verbatim-28"> +</p> + <pre class="verbatim" id="verbatim-30"> \newglossaryentry{alpha}{name={alpha}, -  <br />symbol={\ensuremath{\alpha}}, -  <br />description={Quisque ullamcorper placerat ipsum.}} -</div> - <!--l. 2174--><p class="nopar" > + symbol={\ensuremath{\alpha}}, + description={Quisque ullamcorper placerat ipsum.}} +</pre> + <!--l. 2219--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2221--><p class="noindent" > <span -class="cmbx-10">example-glossaries-symbolnames.tex</span> </dt><dd -class="description">Similar to the previous file but the <span +class="cmbx-10">example-glossaries-symbolnames.tex</span> </p></dt><dd +class="description"> + <!--l. 2221--><p class="noindent" >Similar to the previous file but the <span class="cmtt-10">symbol</span><a - id="dx1-12007"></a> key isn’t used. Instead the - symbol is stored in the <span + id="dx1-12007"></a> key isn’t used. Instead the symbol is stored in the <span class="cmtt-10">name</span><a - id="dx1-12008"></a> key. For example: + id="dx1-12008"></a> key. + For example: - <div class="verbatim" id="verbatim-29"> +</p> + <pre class="verbatim" id="verbatim-31"> \newglossaryentry{sym.alpha}{sort={alpha}, -  <br />name={\ensuremath{\alpha}}, -  <br />description={Quisque ullamcorper placerat ipsum.}} -</div> - <!--l. 2183--><p class="nopar" > + name={\ensuremath{\alpha}}, + description={Quisque ullamcorper placerat ipsum.}} +</pre> + <!--l. 2228--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2230--><p class="noindent" > <span -class="cmbx-10">example-glossaries-images.tex</span> </dt><dd -class="description">These entries use the <span +class="cmbx-10">example-glossaries-images.tex</span> </p></dt><dd +class="description"> + <!--l. 2230--><p class="noindent" >These entries use the <span 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 + 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 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: + 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: - <div class="verbatim" id="verbatim-30"> +</p> + <pre class="verbatim" id="verbatim-32"> \longnewglossaryentry{sedfeugiat}{name={sed feugiat}, -  <br />user1={example-image}}% -  <br />{% -  <br />Cum sociis natoque... -  <br />Etiam... -  <br />} -</div> - <!--l. 2199--><p class="nopar" > + user1={example-image}}% + {% + Cum sociis natoque... + Etiam... + } +</pre> + <!--l. 2244--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2246--><p class="noindent" > <span -class="cmbx-10">example-glossaries-acronym.tex</span> </dt><dd -class="description">These entries are all abbreviations. For example: +class="cmbx-10">example-glossaries-acronym.tex</span> </p></dt><dd +class="description"> + <!--l. 2246--><p class="noindent" >These entries are all abbreviations. For example: - <div class="verbatim" id="verbatim-31"> +</p> + <pre class="verbatim" id="verbatim-33"> \newacronym[type=\glsdefaulttype]{lid}{LID}{lorem ipsum -  <br />dolor} -</div> - <!--l. 2206--><p class="nopar" > - </p><!--l. 2207--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use the <a + dolor} +</pre> + <!--l. 2251--><p class="nopar" > + </p><!--l. 2252--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> extension package, then <span class="cmtt-10">\newacronym</span><a - id="dx1-12011"></a> is redefined to use <span id="textcolor166"><span + id="dx1-12011"></a> is redefined to use <span id="textcolor167"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-12012"></a> - with the <span id="textcolor167"><span id="textcolor168"><span + with the <span id="textcolor168"><span id="textcolor169"><span class="cmtt-10">category</span></span><a id="dx1-12013"></a></span> key set to <span class="cmtt-10">acronym </span>(rather than the default <span @@ -5290,34 +5556,36 @@ class="cmtt-10">acronym </span>category. For example: </p> - <div class="verbatim" id="verbatim-32"> + <pre class="verbatim" id="verbatim-34"> \setabbreviationstyle[acronym]{long-short} -</div> - <!--l. 2216--><p class="nopar" > </div> - </p><!--l. 2217--><p class="noindent" > +</pre> + <!--l. 2261--><p class="nopar" > </div> + </p><!--l. 2262--><p class="noindent" > </p></dd><dt class="description"> + <!--l. 2264--><p class="noindent" > <span -class="cmbx-10">example-glossaries-acronym-desc.tex</span> </dt><dd -class="description">This file contains entries that are all abbreviations that use the - <span +class="cmbx-10">example-glossaries-acronym-desc.tex</span> </p></dt><dd +class="description"> + <!--l. 2264--><p class="noindent" >This file contains entries that are all abbreviations that use the <span class="cmtt-10">description</span><a id="dx1-12014"></a> key. For example: - <div class="verbatim" id="verbatim-33"> +</p> + <pre class="verbatim" id="verbatim-35"> \newacronym[type=\glsdefaulttype, -  <br />  description={fringilla a, euismod sodales, -  <br />  sollicitudin vel, wisi}]{ndl}{NDL}{nam dui ligula} -</div> - <!--l. 2227--><p class="nopar" > - </p><!--l. 2228--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use the <a +   description={fringilla a, euismod sodales, +   sollicitudin vel, wisi}]{ndl}{NDL}{nam dui ligula} +</pre> + <!--l. 2272--><p class="nopar" > + </p><!--l. 2273--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> extension package, then <span class="cmtt-10">\newacronym</span><a - id="dx1-12015"></a> is redefined to use <span id="textcolor169"><span + id="dx1-12015"></a> is redefined to use <span id="textcolor170"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-12016"></a> - with the <span id="textcolor170"><span id="textcolor171"><span + with the <span id="textcolor171"><span id="textcolor172"><span class="cmtt-10">category</span></span><a id="dx1-12017"></a></span> key set to <span class="cmtt-10">acronym </span>(rather than the default <span @@ -5327,33 +5595,36 @@ class="cmtt-10">acronym </span>category. For example: </p> - <div class="verbatim" id="verbatim-34"> + <pre class="verbatim" id="verbatim-36"> \setabbreviationstyle[acronym]{long-short-desc} -</div> - <!--l. 2237--><p class="nopar" > </div> - </p><!--l. 2238--><p class="noindent" > +</pre> + <!--l. 2282--><p class="nopar" > </div> + </p><!--l. 2283--><p class="noindent" > </p></dd><dt class="description"> + <!--l. 2285--><p class="noindent" > <span -class="cmbx-10">example-glossaries-acronyms-lang.tex</span> </dt><dd -class="description">These entries are all abbreviations, where some of them have - a translation supplied in the <span +class="cmbx-10">example-glossaries-acronyms-lang.tex</span> </p></dt><dd +class="description"> + <!--l. 2285--><p class="noindent" >These entries are all abbreviations, where some of them have a translation supplied in the <span class="cmtt-10">user1</span><a - id="dx1-12018"></a> key. For example: + id="dx1-12018"></a> key. For + example: - <div class="verbatim" id="verbatim-35"> +</p> + <pre class="verbatim" id="verbatim-37"> \newacronym[type=\glsdefaulttype,user1={love itself}] -  <br /> {li}{LI}{lorem ipsum} -</div> - <!--l. 2247--><p class="nopar" > - </p><!--l. 2248--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use the <a +  {li}{LI}{lorem ipsum} +</pre> + <!--l. 2292--><p class="nopar" > + </p><!--l. 2293--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> extension package, then <span class="cmtt-10">\newacronym</span><a - id="dx1-12019"></a> is redefined to use <span id="textcolor172"><span + id="dx1-12019"></a> is redefined to use <span id="textcolor173"><span class="cmtt-10">\newabbreviation</span></span><a id="dx1-12020"></a> - with the <span id="textcolor173"><span id="textcolor174"><span + with the <span id="textcolor174"><span id="textcolor175"><span class="cmtt-10">category</span></span><a id="dx1-12021"></a></span> key set to <span class="cmtt-10">acronym </span>(rather than the default <span @@ -5363,118 +5634,182 @@ class="cmtt-10">acronym </span>category. For example: </p> - <div class="verbatim" id="verbatim-36"> + <pre class="verbatim" id="verbatim-38"> \setabbreviationstyle[acronym]{long-short-user} -</div> - <!--l. 2257--><p class="nopar" > </div> - </p><!--l. 2258--><p class="noindent" > +</pre> + <!--l. 2302--><p class="nopar" > </div> + </p><!--l. 2303--><p class="noindent" > </p></dd><dt class="description"> + <!--l. 2305--><p class="noindent" > <span -class="cmbx-10">example-glossaries-parent.tex</span> </dt><dd -class="description">These are hierarchical entries where the child entries use the <span +class="cmbx-10">example-glossaries-parent.tex</span> </p></dt><dd +class="description"> + <!--l. 2305--><p class="noindent" >These are hierarchical entries where the child entries use the <span class="cmtt-10">name</span><a - id="dx1-12022"></a> key. For - example: + id="dx1-12022"></a> key. For example: - <div class="verbatim" id="verbatim-37"> +</p> + <pre class="verbatim" id="verbatim-39"> \newglossaryentry{sedmattis}{name={sed mattis}, -  <br />description={erat sit amet} -  <br />\newglossaryentry{gravida}{parent={sedmattis}, -  <br />  name={gravida},description={malesuada}} -</div> - <!--l. 2269--><p class="nopar" > + description={erat sit amet} + \newglossaryentry{gravida}{parent={sedmattis}, +   name={gravida},description={malesuada}} +</pre> + <!--l. 2314--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2316--><p class="noindent" > <span -class="cmbx-10">example-glossaries-childnoname.tex</span> </dt><dd -class="description">These are hierarchical entries where the child entries don’t use the - <span +class="cmbx-10">example-glossaries-childnoname.tex</span> </p></dt><dd +class="description"> + <!--l. 2316--><p class="noindent" >These are hierarchical entries where the child entries don’t use the <span class="cmtt-10">name</span><a id="dx1-12023"></a> key. For example: - <div class="verbatim" id="verbatim-38"> +</p> + <pre class="verbatim" id="verbatim-40"> \newglossaryentry{scelerisque}{name={scelerisque}, -  <br />  description={at}} -  <br />\newglossaryentry{vestibulum}{parent={scelerisque}, -  <br />  description={eu, nulla}} -</div> - <!--l. 2280--><p class="nopar" > +   description={at}} + \newglossaryentry{vestibulum}{parent={scelerisque}, +   description={eu, nulla}} +</pre> + <!--l. 2325--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2327--><p class="noindent" > <span -class="cmbx-10">example-glossaries-cite.tex</span> </dt><dd -class="description">These entries use the <span -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 - TeX distributions. One entry doesn’t have an associated citation to help test for a missing key. For +class="cmbx-10">example-glossaries-longchild.tex</span> </p></dt><dd +class="description"> + <!--l. 2327--><p class="noindent" >(New to v4.47.) These entries all have long descriptions and there are some child entries. For example: - <div class="verbatim" id="verbatim-39"> +</p> + <pre class="verbatim" id="verbatim-41"> + \newglossaryentry{longsedmattis}{name={sed mattis}, +  description={erat sit amet dolor sit amet, consectetuer adipiscing elit. +  Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. +  Curabitur dictum gravida mauris.}} + \newglossaryentry{longgravida}{parent={longsedmattis},name={gravida}, +  description={malesuada libero, nonummy eget, consectetuer id, vulputate a, +  magna. Donec vehicula augue eu neque. Pellentesque habitant morbi tristique + senectus et netus et malesuada fames ac turpis egestas. Mauris ut + leo.}} +</pre> + <!--l. 2340--><p class="nopar" > + </p></dd><dt class="description"> + <!--l. 2342--><p class="noindent" > +<span +class="cmbx-10">example-glossaries-childmultipar.tex</span> </p></dt><dd +class="description"> + <!--l. 2342--><p class="noindent" >(New to v4.47.) This consists of parent entries with single paragraph descriptions and child entries with + multi-paragraph descriptions. Some entries have the <span +class="cmtt-10">user1</span><a + id="dx1-12024"></a> key set to the name of an image file provided + by the <span +class="cmss-10">mwe</span><a + id="dx1-12025"></a> package. For example: + + +</p> + <pre class="verbatim" id="verbatim-42"> + \newglossaryentry{hiersedmattis}{name={sed mattis},user1={example-image}, +  description={Erat sit amet dolor sit amet, consectetuer adipiscing elit. +  Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur + dictum gravida mauris. Ut pellentesque augue sed urna. Vestibulum + diam eros, fringilla et, consectetuer eu, nonummy id, sapien. Nullam + at lectus. In sagittis ultrices mauris. Curabitur malesuada erat sit + amet massa. Fusce blandit. Aliquam erat volutpat.}} + \longnewglossaryentry{hierloremi-ii} + {name={lorem 1--2},parent={hiersedmattis}}% + {% + Lorem ipsum ... + Nam dui ligula... + } +</pre> + <!--l. 2363--><p class="nopar" > + </p></dd><dt class="description"> + <!--l. 2365--><p class="noindent" > +<span +class="cmbx-10">example-glossaries-cite.tex</span> </p></dt><dd +class="description"> + <!--l. 2365--><p class="noindent" >These entries use the <span +class="cmtt-10">user1</span><a + id="dx1-12026"></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 TeX distributions. One entry + doesn’t have an associated citation to help test for a missing key. For example: + + +</p> + <pre class="verbatim" id="verbatim-43"> \newglossaryentry{fusce}{name={fusce}, -  <br />description={suscipit cursus sem},user1={article-minimal}} -</div> - <!--l. 2292--><p class="nopar" > + description={suscipit cursus sem},user1={article-minimal}} +</pre> + <!--l. 2375--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 2377--><p class="noindent" > <span -class="cmbx-10">example-glossaries-url.tex</span> </dt><dd -class="description">These entries use the <span +class="cmbx-10">example-glossaries-url.tex</span> </p></dt><dd +class="description"> + <!--l. 2377--><p class="noindent" >These entries use the <span class="cmtt-10">user1</span><a - id="dx1-12025"></a> key to store an URL associated with the entry. For - example: + id="dx1-12027"></a> key to store an URL associated with the entry. For example: - <div class="verbatim" id="verbatim-40"> +</p> + <pre class="verbatim" id="verbatim-44"> \newglossaryentry{aenean-url}{name={aenean}, -  <br /> description={adipiscing auctor est}, -  <br /> user1={http://uk.tug.org/}} -</div> - <!--l. 2301--><p class="nopar" ></p></dd></dl> -<!--l. 2304--><p class="indent" > The sample file <a +  description={adipiscing auctor est}, +  user1={http://uk.tug.org/}} +</pre> + <!--l. 2384--><p class="nopar" ></p></dd></dl> +<!--l. 2387--><p class="indent" > The sample file <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/glossary-lipsum-examples.tex" ><span class="cmtt-10">glossary-lipsum-examples.tex</span></a> in the <span class="cmtt-10">doc/latex/glossaries/samples </span>directory uses all these files. See also <a href="https://www.dickimaw-books.com/gallery/#glossaries" ><span -class="cmtt-10">https://www.dickimaw-books.com/gallery/#glossaries</span></a>. -</p><!--l. 2308--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +class="cmss-10">glossaries </span>gallery</a>. +</p><!--l. 2391--><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 class="cmss-10">glossaries-extra</span></a> package provides the additional test file: </p><dl class="description"><dt class="description"> + <!--l. 2395--><p class="noindent" > <span -class="cmbx-10">example-glossaries-xr.tex</span> </dt><dd -class="description">These entries use the <span +class="cmbx-10">example-glossaries-xr.tex</span> </p></dt><dd +class="description"> + <!--l. 2395--><p class="noindent" >These entries use the <span class="cmtt-10">see</span><a - id="dx1-12026"></a> key provided by the base <span -class="cmss-10">glossaries </span>package and also the - <span id="textcolor175"><span id="textcolor176"><span + id="dx1-12028"></a> key provided by the base <span +class="cmss-10">glossaries </span>package and also the <span id="textcolor176"><span id="textcolor177"><span class="cmtt-10">alias</span></span><a - id="dx1-12027"></a></span> and <span id="textcolor177"><span id="textcolor178"><span + id="dx1-12029"></a></span> and <span id="textcolor178"><span id="textcolor179"><span class="cmtt-10">seealso</span></span><a - id="dx1-12028"></a></span> keys that require <a + id="dx1-12030"></a></span> + keys that require <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. For example: - <div class="verbatim" id="verbatim-41"> - \newglossaryentry{alias-lorem}{name={alias-lorem}, -  <br /> description={ipsum},alias={lorem}} -  <br />\newglossaryentry{amet}{name={amet},description={consectetuer}, -  <br /> see={dolor}} -  <br />\newglossaryentry{arcu}{name={arcu},description={libero}, -  <br /> seealso={placerat,vitae,curabitur}} -</div> - <!--l. 2325--><p class="nopar" ></p></dd></dl> -<!--l. 2328--><p class="noindent" > </p> -<!--l. 2328--><p class="noindent" ><a + <pre class="verbatim" id="verbatim-45"> + \newglossaryentry{alias-lorem}{name={alias-lorem}, +  description={ipsum},alias={lorem}} + \newglossaryentry{amet}{name={amet},description={consectetuer}, +  see={dolor}} + \newglossaryentry{arcu}{name={arcu},description={libero}, +  seealso={placerat,vitae,curabitur}} +</pre> + <!--l. 2408--><p class="nopar" ></p></dd></dl> +<!--l. 2411--><p class="noindent" > +</p> +<!--l. 2411--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.3 </span> <a id="sec:languages"></a>Multi-Lingual Support</h3> -<!--l. 2331--><p class="noindent" ><div class="important" title="Important Note"> The <span +<!--l. 2414--><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 LaTeX, <span @@ -5484,8 +5819,8 @@ provide a way of detecting the language. See <a href="https://www.dickimaw-books.com/latex/tracklang/" >Localisation with <span class="cmtt-10">tracklang.tex</span></a> for further details. </div> -</p><!--l. 2341--><p class="noindent" > -</p><!--l. 2343--><p class="noindent" >As from version 1.17, the <span +</p><!--l. 2424--><p class="noindent" > +</p><!--l. 2426--><p class="noindent" >As from version 1.17, the <span class="cmss-10">glossaries </span>package can be used with <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a @@ -5511,7 +5846,7 @@ href="#glo:latinalph">Latin alphabet<a id="dx1-13006"></a></a> and <a href="#option1">Option 1</a> can only perform limited ASCII comparisons. -</p><!--l. 2351--><p class="indent" > This means that with Options <a +</p><!--l. 2434--><p class="indent" > This means that with Options <a href="#option3">3</a> or <a href="#option4">4</a> you are not restricted to the A, …, Z letter groups. If you want to use <span @@ -5522,16 +5857,16 @@ class="cmss-10">xindy</span><a </p> - <div class="verbatim" id="verbatim-42"> -\documentclass[frenchb]{article} - <br />\usepackage[utf8]{inputenc} - <br />\usepackage[T1]{fontenc} - <br />\usepackage{babel} - <br />\usepackage[xindy]{glossaries} -</div> -<!--l. 2360--><p class="nopar" > If you want to use <span + <pre class="verbatim" id="verbatim-46"> +\documentclass[french]{article} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage{babel} +\usepackage[xindy]{glossaries} +</pre> +<!--l. 2443--><p class="nopar" > If you want to use <span class="cmtt-10">bib2gls</span><a - id="dx1-13009"></a>, you need to use the <span id="textcolor179"><span + id="dx1-13009"></a>, you need to use the <span id="textcolor180"><span class="cmss-10">record</span></span><a id="dx1-13010"></a> option with <a href="#glo:glossaries-extra"><span @@ -5542,7 +5877,7 @@ class="cmtt-10">bib</span><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-13012"></a></a> user manual for further details.) -</p><!--l. 2366--><p class="indent" > <div class="important" title="Important Note"> Note that although a <a +</p><!--l. 2449--><p class="indent" > <div class="important" title="Important Note"> Note that although a <a 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 @@ -5551,8 +5886,8 @@ standard LaTeX it’s actually a macro and can therefore cause 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 +</p><!--l. 2455--><p class="noindent" > +</p><!--l. 2457--><p class="indent" > With <span class="cmss-10">inputenc</span><a id="dx1-13015"></a>, if you use a <a href="#glo:nonlatinchar">non-Latin character<a @@ -5575,7 +5910,7 @@ class="cmtt-10"> class}}</span> </div> For further details, see the “UTF-8” section in the <span class="cmss-10">mfirstuc</span><a id="dx1-13018"></a> user manual. -<!--l. 2385--><p class="indent" > If you are using <a +<!--l. 2468--><p class="indent" > If you are using <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-13019"></a></a> or <a @@ -5604,7 +5939,7 @@ class="cmtt-10">-C</span><a <span class="cmtt-10">xindy</span><a id="dx1-13028"></a> manual for further details of this option. -</p><!--l. 2394--><p class="indent" > As from v4.24, if you are writing in German (for example, using the <span +</p><!--l. 2477--><p class="indent" > As from v4.24, if you are writing in German (for example, using the <span class="cmss-10">ngerman</span><a id="dx1-13029"></a> package<span class="footnote-mark"><a @@ -5623,12 +5958,12 @@ class="cmtt-10">-g</span><a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-13034"></a>’s</a> quote character using: -</p><!--l. 2399--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 2482--><p class="indent" > <hr><div title="Definition"><a id="dx1-13035"></a> <span class="cmtt-10">\GlsSetQuote{</span>⟨<span class="cmitt-10">character</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 2401--><p class="noindent" > +</p><!--l. 2484--><p class="noindent" > Note that ⟨<span class="cmti-10">character</span>⟩ may not be one of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">?</span></span></span> (question mark), <span class="obeylines-h"><span class="verb"><span @@ -5638,10 +5973,10 @@ example: </p> - <div class="verbatim" id="verbatim-43"> + <pre class="verbatim" id="verbatim-47"> \GlsSetQuote{+} -</div> -<!--l. 2407--><p class="nopar" > This must be done before <span +</pre> +<!--l. 2490--><p class="nopar" > This must be done before <span class="cmtt-10">\makeglossaries</span><a id="dx1-13036"></a> and any entry definitions. It’s only applicable for <span class="cmtt-10">makeindex</span><a @@ -5656,7 +5991,7 @@ class="cmtt-10">-g</span><a <span class="cmtt-10">makeindex</span><a id="dx1-13041"></a>. -</p><!--l. 2414--><p class="indent" > <div class="important" title="Important Note"> Be careful of <span +</p><!--l. 2497--><p class="indent" > <div class="important" title="Important Note"> Be careful of <span class="cmss-10">babel</span><a id="dx1-13042"></a>’s shorthands. These aren’t switched on until the start of the document, so any entries defined in the preamble won’t be able to use those shorthands. However, if you define the entries in the @@ -5671,29 +6006,29 @@ double-quote) then this will interfere with code that tries to escape any of tho <span class="cmtt-10">sort</span><a id="dx1-13045"></a> key. </div> -</p><!--l. 2423--><p class="noindent" > -</p><!--l. 2425--><p class="indent" > In general, it’s best not to use <span +</p><!--l. 2506--><p class="noindent" > +</p><!--l. 2508--><p class="indent" > In general, it’s best not to use <span class="cmss-10">babel</span><a id="dx1-13046"></a>’s shorthands in entry definitions. For example: </p> - <div class="verbatim" id="verbatim-44"> + <pre class="verbatim" id="verbatim-48"> \documentclass{article} - <br />\usepackage[ngerman]{babel} - <br />\usepackage{glossaries} - <br />\GlsSetQuote{+} - <br />\makeglossaries - <br />\newglossaryentry{rna}{name={ribonukleins\"aure}, - <br />  sort={ribonukleins"aure}, - <br />  description={eine Nukleins\"aure}} - <br />\begin{document} - <br />\gls{rna} - <br />\printglossaries - <br />\end{document} -</div> -<!--l. 2446--><p class="nopar" > -</p><!--l. 2448--><p class="indent" > The <span +\usepackage[ngerman]{babel} +\usepackage{glossaries} +\GlsSetQuote{+} +\makeglossaries +\newglossaryentry{rna}{name={ribonukleins\"aure}, +  sort={ribonukleins"aure}, +  description={eine Nukleins\"aure}} +\begin{document} +\gls{rna} +\printglossaries +\end{document} +</pre> +<!--l. 2529--><p class="nopar" > +</p><!--l. 2531--><p class="indent" > The <span class="cmss-10">ngerman</span><a id="dx1-13047"></a> package has the shorthands on in the preamble, so they can be used in definitions if <span @@ -5704,33 +6039,34 @@ class="cmtt-10">makeindex</span><a </p> - <div class="verbatim" id="verbatim-45"> + <pre class="verbatim" id="verbatim-49"> \documentclass{article} - <br />\usepackage[ngerman]{babel} - <br />\usepackage{glossaries} - <br />\GlsSetQuote{+} - <br />\makeglossaries - <br />\newglossaryentry{rna}{name={ribonukleins"aure}, - <br />  description={eine Nukleins"aure}} - <br />\begin{document} - <br />\gls{rna} - <br />\printglossaries - <br />\end{document} -</div> -<!--l. 2469--><p class="nopar" > -</p><!--l. 2471--><p class="noindent" > -</p> -<!--l. 2471--><p class="noindent" ><a +\usepackage[ngerman]{babel} +\usepackage{glossaries} +\GlsSetQuote{+} +\makeglossaries +\newglossaryentry{rna}{name={ribonukleins"aure}, +  description={eine Nukleins"aure}} +\begin{document} +\gls{rna} +\printglossaries +\end{document} +</pre> +<!--l. 2552--><p class="nopar" > +</p><!--l. 2554--><p class="noindent" > +</p> +<!--l. 2554--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.3.1 </span> <a id="sec:fixednames"></a>Changing the Fixed Names</h4> -<!--l. 2474--><p class="noindent" >The fixed names are produced using the commands listed in <a -href="#tab:predefinednames">table 1.2</a>. If you aren’t using a language package -such as <span +<!--l. 2557--><p class="noindent" >The fixed names are produced using the commands listed in <a +href="#tab:predefinednames">table <span +class="cmbx-10">??</span>tab:predefinednames</a>. If you aren’t using a +language package such as <span class="cmss-10">babel</span><a id="dx1-14001"></a> or <span class="cmss-10">polyglossia</span><a - id="dx1-14002"></a> that uses caption hooks, you can just redefine these commands as appropriate. If -you are using <span + id="dx1-14002"></a> that uses caption hooks, you can just redefine these commands as +appropriate. If you are using <span class="cmss-10">babel</span><a id="dx1-14003"></a> or <span class="cmss-10">polyglossia</span><a @@ -5779,12 +6115,12 @@ class="cmss-10">babel</span><a </p> - <div class="verbatim" id="verbatim-46"> + <pre class="verbatim" id="verbatim-50"> \documentclass[english,french]{article} - <br />\usepackage{babel} - <br />\usepackage[translate=babel]{glossaries} -</div> -<!--l. 2495--><p class="nopar" > and then use <span +\usepackage{babel} +\usepackage[translate=babel]{glossaries} +</pre> +<!--l. 2578--><p class="nopar" > and then use <span class="cmss-10">babel</span><a id="dx1-14018"></a>’s caption hook mechanism. Note that if you pass the language options directly to <span class="cmss-10">babel</span><a @@ -5802,7 +6138,7 @@ instead. <div class="table"> -<!--l. 2503--><p class="indent" > <a +<!--l. 2586--><p class="indent" > <a id="tab:predefinednames"></a></p><hr class="float" /><div class="float" > @@ -5813,7 +6149,7 @@ class="content">Customised Text</span></div><!--tex4ht:label?: x1-140232 --> <div class="tabular"> <table id="TBL-3" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-3-1g"><col id="TBL-3-1" /><col id="TBL-3-2" /><col @@ -5821,22 +6157,22 @@ id="TBL-3-3" /></colgroup><tr style="vertical-align:baseline;" id="TBL-3-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-1" class="td01"><span class="cmbx-10">Command Name </span></td><td style="white-space:normal; text-align:left;" id="TBL-3-1-2" -class="td11"> <!--l. 2509--><p class="noindent" ><span +class="td11"> <!--l. 2592--><p class="noindent" ><span class="cmbx-10">Translator</span> <span class="cmbx-10">Key</span> <span class="cmbx-10">Word</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-1-3" -class="td10"> <!--l. 2510--><p class="noindent" ><span +class="td10"> <!--l. 2593--><p class="noindent" ><span class="cmbx-10">Purpose</span> </p></td> </tr><tr style="vertical-align:baseline;" id="TBL-3-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-1" class="td01"><span class="cmtt-10">\glossaryname</span><a id="dx1-14024"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-2-2" -class="td11"> <!--l. 2511--><p class="noindent" ><span +class="td11"> <!--l. 2594--><p class="noindent" ><span class="cmtt-10">Glossary</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-2-3" -class="td10"> <!--l. 2511--><p class="noindent" >Title +class="td10"> <!--l. 2594--><p class="noindent" >Title of the main @@ -5846,9 +6182,9 @@ class="td10"> <!--l. 2511--><p class="noindent" >Title class="td01"><span class="cmtt-10">\acronymname</span><a id="dx1-14025"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-3-2" -class="td11"> <!--l. 2512--><p class="noindent" ><span +class="td11"> <!--l. 2595--><p class="noindent" ><span class="cmtt-10">Acronyms</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-3-3" -class="td10"> <!--l. 2512--><p class="noindent" >Title +class="td10"> <!--l. 2595--><p class="noindent" >Title of the list @@ -5867,11 +6203,11 @@ class="cmss-10">acronym</span><a class="td01"><span class="cmtt-10">\entryname</span><a id="dx1-14027"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-4-2" -class="td11"> <!--l. 2514--><p class="noindent" ><span +class="td11"> <!--l. 2597--><p class="noindent" ><span class="cmtt-10">Notation</span> <span class="cmtt-10">(glossaries)</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-4-3" -class="td10"> <!--l. 2515--><p class="noindent" >Header +class="td10"> <!--l. 2598--><p class="noindent" >Header for first column @@ -5893,11 +6229,11 @@ class="td10"> <!--l. 2515--><p class="noindent" >Header class="td01"><span class="cmtt-10">\descriptionname</span><a id="dx1-14028"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-5-2" -class="td11"> <!--l. 2517--><p class="noindent" ><span +class="td11"> <!--l. 2600--><p class="noindent" ><span class="cmtt-10">Description</span> <span class="cmtt-10">(glossaries)</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-5-3" -class="td10"> <!--l. 2518--><p class="noindent" >Header +class="td10"> <!--l. 2601--><p class="noindent" >Header for second column @@ -5919,11 +6255,11 @@ class="td10"> <!--l. 2518--><p class="noindent" >Header class="td01"><span class="cmtt-10">\symbolname</span><a id="dx1-14029"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-6-2" -class="td11"> <!--l. 2520--><p class="noindent" ><span +class="td11"> <!--l. 2603--><p class="noindent" ><span class="cmtt-10">Symbol</span> <span class="cmtt-10">(glossaries)</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-6-3" -class="td10"> <!--l. 2520--><p class="noindent" >Header +class="td10"> <!--l. 2603--><p class="noindent" >Header for symbol column @@ -5942,13 +6278,13 @@ class="td10"> <!--l. 2520--><p class="noindent" >Header class="td01"><span class="cmtt-10">\pagelistname</span><a id="dx1-14030"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-7-2" -class="td11"> <!--l. 2522--><p class="noindent" ><span +class="td11"> <!--l. 2605--><p class="noindent" ><span class="cmtt-10">Page</span> <span class="cmtt-10">List</span> <span class="cmtt-10">(glossaries)</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-7-3" -class="td10"> <!--l. 2523--><p class="noindent" >Header +class="td10"> <!--l. 2606--><p class="noindent" >Header for page list @@ -5967,11 +6303,11 @@ class="td10"> <!--l. 2523--><p class="noindent" >Header class="td01"><span class="cmtt-10">\glssymbolsgroupname</span><a id="dx1-14031"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-8-2" -class="td11"> <!--l. 2525--><p class="noindent" ><span +class="td11"> <!--l. 2608--><p class="noindent" ><span class="cmtt-10">Symbols</span> <span class="cmtt-10">(glossaries)</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-8-3" -class="td10"> <!--l. 2526--><p class="noindent" >Header +class="td10"> <!--l. 2609--><p class="noindent" >Header for symbols section @@ -5990,11 +6326,11 @@ class="td10"> <!--l. 2526--><p class="noindent" >Header class="td01"><span class="cmtt-10">\glsnumbersgroupname</span><a id="dx1-14032"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-9-2" -class="td11"> <!--l. 2528--><p class="noindent" ><span +class="td11"> <!--l. 2611--><p class="noindent" ><span class="cmtt-10">Numbers</span> <span class="cmtt-10">(glossaries)</span> </p></td><td style="white-space:normal; text-align:left;" id="TBL-3-9-3" -class="td10"> <!--l. 2528--><p class="noindent" >Header +class="td10"> <!--l. 2611--><p class="noindent" >Header for numbers section @@ -6015,7 +6351,7 @@ class="td10"> <!--l. 2528--><p class="noindent" >Header </div><hr class="endfloat" /> </div> -<!--l. 2534--><p class="indent" > As from version 4.12, multilingual support is provided by separate language modules that need to be +<!--l. 2617--><p class="indent" > As from version 4.12, multilingual support is provided by separate language modules that need to be installed in addition to installing the <span class="cmss-10">glossaries </span>package. You only need to install the modules for the languages that you require. If the language module has an unmaintained status, you can volunteer to take over the @@ -6028,35 +6364,39 @@ dictionary files for <span class="cmss-10">glossaries </span>are now provided by the appropriate language module. For further details about information specific to a given language, please see the documentation for that language module. -</p><!--l. 2546--><p class="indent" > Examples of use: </p> +</p><!--l. 2629--><p class="indent" > Examples of use: </p> <ul class="itemize1"> - <li class="itemize">Using <span + <li class="itemize"> + <!--l. 2631--><p class="noindent" >Using <span class="cmss-10">babel</span><a id="dx1-14034"></a> and <span class="cmss-10">translator</span><a id="dx1-14035"></a>: - <div class="verbatim" id="verbatim-47"> +</p> + <pre class="verbatim" id="verbatim-51"> \documentclass[english,french]{article} -  <br />\usepackage{babel} -  <br />\usepackage{glossaries} -</div> - <!--l. 2553--><p class="nopar" > (<span + \usepackage{babel} + \usepackage{glossaries} +</pre> + <!--l. 2636--><p class="nopar" > (<span class="cmss-10">translator</span><a id="dx1-14036"></a> is automatically loaded). </p></li> - <li class="itemize">Using <span + <li class="itemize"> + <!--l. 2639--><p class="noindent" >Using <span class="cmss-10">babel</span><a id="dx1-14037"></a>: - <div class="verbatim" id="verbatim-48"> +</p> + <pre class="verbatim" id="verbatim-52"> \documentclass[english,french]{article} -  <br />\usepackage{babel} -  <br />\usepackage[translate=babel]{glossaries} -</div> - <!--l. 2561--><p class="nopar" > (<span + \usepackage{babel} + \usepackage[translate=babel]{glossaries} +</pre> + <!--l. 2644--><p class="nopar" > (<span class="cmss-10">translator</span><a id="dx1-14038"></a> isn’t loaded). The <a href="#glo:glossaries-extra"><span @@ -6069,21 +6409,23 @@ class="cmss-10">babel</span><a id="dx1-14040"></a> has been loaded. </p></li> - <li class="itemize">Using <span + <li class="itemize"> + <!--l. 2649--><p class="noindent" >Using <span class="cmss-10">polyglossia</span><a id="dx1-14041"></a>: - <div class="verbatim" id="verbatim-49"> +</p> + <pre class="verbatim" id="verbatim-53"> \documentclass{article} -  <br />\usepackage{polyglossia} -  <br />\setmainlanguage{english} -  <br />\usepackage{glossaries} -</div> - <!--l. 2572--><p class="nopar" > + \usepackage{polyglossia} + \setmainlanguage{english} + \usepackage{glossaries} +</pre> + <!--l. 2655--><p class="nopar" > </p> </li></ul> -<!--l. 2576--><p class="indent" > Due to the varied nature of glossaries, it’s likely that the predefined translations may not be +<!--l. 2659--><p class="indent" > Due to the varied nature of glossaries, it’s likely that the predefined translations may not be appropriate. If you are using the <span class="cmss-10">babel</span><a id="dx1-14042"></a> package and the <span @@ -6106,7 +6448,7 @@ class="cmtt-10">title</span><a class="cmtt-10">\printglossary </span>(but not the iterative commands like <span class="cmtt-10">\printglossaries</span>). -</p><!--l. 2588--><p class="indent" > <div class="important" title="Important Note"> Note that the <span +</p><!--l. 2671--><p class="indent" > <div class="important" title="Important Note"> Note that the <span class="cmss-10">translator</span><a id="dx1-14046"></a> dictionaries are loaded at the beginning of the document, so it won’t have any effect if you put <span @@ -6117,38 +6459,38 @@ class="cmss-10">translator</span><a class="cmss-10">beamer</span><a id="dx1-14048"></a> documentation.) </div> -</p><!--l. 2595--><p class="noindent" > -</p><!--l. 2597--><p class="indent" > Your custom dictionary doesn’t have to be just a translation from English to another language. You may +</p><!--l. 2678--><p class="noindent" > +</p><!--l. 2680--><p class="indent" > Your custom dictionary doesn’t have to be just a translation from English to another language. You may prefer to have a dictionary for a particular type of document. For example, suppose your institution’s in-house reports have to have the glossary labelled as “Nomenclature” and the page list should be labelled “Location”, then you can create a file called, say, </p> - <div class="verbatim" id="verbatim-50"> + <pre class="verbatim" id="verbatim-54"> myinstitute-glossaries-dictionary-English.dict -</div> -<!--l. 2605--><p class="nopar" > that contains the following: +</pre> +<!--l. 2688--><p class="nopar" > that contains the following: </p> - <div class="verbatim" id="verbatim-51"> + <pre class="verbatim" id="verbatim-55"> \ProvidesDictionary{myinstitute-glossaries-dictionary}{English} - <br />\deftranslation{Glossary}{Nomenclature} - <br />\deftranslation{Page List (glossaries)}{Location} -</div> -<!--l. 2611--><p class="nopar" > You can now load it using: +\deftranslation{Glossary}{Nomenclature} +\deftranslation{Page List (glossaries)}{Location} +</pre> +<!--l. 2694--><p class="nopar" > You can now load it using: </p> - <div class="verbatim" id="verbatim-52"> + <pre class="verbatim" id="verbatim-56"> \usedictionary{myinstitute-glossaries-dictionary} -</div> -<!--l. 2615--><p class="nopar" > (Make sure that <span +</pre> +<!--l. 2698--><p class="nopar" > (Make sure that <span 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 +</p><!--l. 2703--><p class="indent" > If you are using <span class="cmss-10">babel</span><a id="dx1-14049"></a> and don’t want to use the <span class="cmss-10">translator</span><a @@ -6161,17 +6503,17 @@ class="cmss-10">babel</span><a </p> - <div class="verbatim" id="verbatim-53"> + <pre class="verbatim" id="verbatim-57"> \documentclass[british]{article} - <br />\usepackage{babel} - <br />\usepackage[translate=babel]{glossaries} - <br />\addto\captionsbritish{% - <br />    \renewcommand*{\glossaryname}{List of Terms}% - <br />    \renewcommand*{\acronymname}{List of Acronyms}% - <br />} -</div> -<!--l. 2633--><p class="nopar" > -</p><!--l. 2635--><p class="indent" > Note that <a +\usepackage{babel} +\usepackage[translate=babel]{glossaries} +\addto\captionsbritish{% +    \renewcommand*{\glossaryname}{List of Terms}% +    \renewcommand*{\acronymname}{List of Acronyms}% +} +</pre> +<!--l. 2716--><p class="nopar" > +</p><!--l. 2718--><p class="indent" > Note that <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-14052"></a></a> and <a @@ -6186,9 +6528,10 @@ href="#option3">3</a> or <a href="#option4">4</a> if you have glossary entries that contain <a href="#glo:nonlatinchar">non-Latin character<a id="dx1-14055"></a>s</a>. See <a -href="#sec:xindy">§11 </a><a -href="#sec:xindy">Xindy -(Option 3)<!--tex4ht:ref: sec:xindy --></a> for further details on <a +href="#sec:xindy">§<span +class="cmbx-10">??</span>sec:xindy +</a><a +href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a> for further details on <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-14056"></a></a>, and see the <a @@ -6197,9 +6540,10 @@ class="cmtt-10">bib2gls</span><a id="dx1-14057"></a></a> user manual for further details of that application. </p> - <h5 class="subsubsectionHead"><a - id="pluralsuffix"></a>Creating a New Language Module</h5> -<!--l. 2645--><p class="noindent" >The <span +<!--l. 2725--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.3.2 </span> <a + id="pluralsuffix"></a>Creating a New Language Module</h4> +<!--l. 2728--><p class="noindent" >The <span class="cmss-10">glossaries </span>package now uses the <span class="cmss-10">tracklang</span><a id="dx1-15001"></a> package to determine which language modules need @@ -6207,7 +6551,7 @@ to be loaded. If you want to create a new language module, you should first read class="cmss-10">tracklang</span><a id="dx1-15002"></a> documentation. -</p><!--l. 2650--><p class="indent" > To create a new language module, you need to at least create two files called: <span +</p><!--l. 2733--><p class="indent" > To create a new language module, you need to at least create two files called: <span class="cmtt-10">glossaries-</span>⟨<span class="cmti-10">lang</span>⟩<span class="cmtt-10">.ldf</span><a @@ -6224,23 +6568,23 @@ the language name used by <span class="cmss-10">translator</span><a id="dx1-15005"></a> (for example, <span class="cmtt-10">English</span>). -</p><!--l. 2657--><p class="indent" > Here’s an example of <span +</p><!--l. 2740--><p class="indent" > Here’s an example of <span class="cmtt-10">glossaries-dictionary-English.dict</span>: </p> - <div class="verbatim" id="verbatim-54"> + <pre class="verbatim" id="verbatim-58"> \ProvidesDictionary{glossaries-dictionary}{English} - <br />\providetranslation{Glossary}{Glossary} - <br />\providetranslation{Acronyms}{Acronyms} - <br />\providetranslation{Notation (glossaries)}{Notation} - <br />\providetranslation{Description (glossaries)}{Description} - <br />\providetranslation{Symbol (glossaries)}{Symbol} - <br />\providetranslation{Page List (glossaries)}{Page List} - <br />\providetranslation{Symbols (glossaries)}{Symbols} - <br />\providetranslation{Numbers (glossaries)}{Numbers} -</div> -<!--l. 2669--><p class="nopar" > You can use this as a template for your dictionary file. Change <span +\providetranslation{Glossary}{Glossary} +\providetranslation{Acronyms}{Acronyms} +\providetranslation{Notation (glossaries)}{Notation} +\providetranslation{Description (glossaries)}{Description} +\providetranslation{Symbol (glossaries)}{Symbol} +\providetranslation{Page List (glossaries)}{Page List} +\providetranslation{Symbols (glossaries)}{Symbols} +\providetranslation{Numbers (glossaries)}{Numbers} +</pre> +<!--l. 2752--><p class="nopar" > You can use this as a template for your dictionary file. Change <span class="cmtt-10">English </span>to the <span class="cmss-10">translator</span><a id="dx1-15006"></a> name for your @@ -6250,71 +6594,71 @@ class="cmti-10">Lang</span>⟩<span class="cmtt-10">.dict</span>) and, for each <span class="cmtt-10">\providetranslation</span>, change the second argument to the appropriate translation. -</p><!--l. 2677--><p class="indent" > Here’s an example of <span +</p><!--l. 2760--><p class="indent" > Here’s an example of <span class="cmtt-10">glossaries-english.ldf</span>: </p> - <div class="verbatim" id="verbatim-55"> + <pre class="verbatim" id="verbatim-59"> \ProvidesGlossariesLang{english} - <br />\glsifusedtranslatordict{English} - <br />{% - <br />  \addglossarytocaptions{\CurrentTrackedLanguage}% - <br />  \addglossarytocaptions{\CurrentTrackedDialect}% - <br />} - <br />{% - <br />  \@ifpackageloaded{polyglossia}% - <br />  {% - <br />    \newcommand*{\glossariescaptionsenglish}{% - <br />      \renewcommand*{\glossaryname}{\textenglish{Glossary}}% - <br />      \renewcommand*{\acronymname}{\textenglish{Acronyms}}% - <br />      \renewcommand*{\entryname}{\textenglish{Notation}}% - <br />      \renewcommand*{\descriptionname}{\textenglish{Description}}% - <br />      \renewcommand*{\symbolname}{\textenglish{Symbol}}% - <br />      \renewcommand*{\pagelistname}{\textenglish{Page List}}% - <br />      \renewcommand*{\glssymbolsgroupname}{\textenglish{Symbols}}% - <br />      \renewcommand*{\glsnumbersgroupname}{\textenglish{Numbers}}% - <br />    }% - <br />  }% - <br />  {% - <br />    \newcommand*{\glossariescaptionsenglish}{% - <br />      \renewcommand*{\glossaryname}{Glossary}% - <br />      \renewcommand*{\acronymname}{Acronyms}% - <br />      \renewcommand*{\entryname}{Notation}% - <br />      \renewcommand*{\descriptionname}{Description}% - <br />      \renewcommand*{\symbolname}{Symbol}% - <br />      \renewcommand*{\pagelistname}{Page List}% - <br />      \renewcommand*{\glssymbolsgroupname}{Symbols}% - <br />      \renewcommand*{\glsnumbersgroupname}{Numbers}% - <br />    }% - <br />  }% - <br />  \ifcsdef{captions\CurrentTrackedDialect} - <br />  {% - <br />    \csappto{captions\CurrentTrackedDialect}% - <br />    {% - <br />      \glossariescaptionsenglish - <br />    }% - <br />  }% - <br />  {% - <br />    \ifcsdef{captions\CurrentTrackedLanguage} - <br />    { - <br />      \csappto{captions\CurrentTrackedLanguage}% - <br />      {% - <br />        \glossariescaptionsenglish - - - <br />      }% - <br />    }% - <br />    {% - <br />    }% - <br />  }% - <br />  \glossariescaptionsenglish - <br />} - <br />\renewcommand*{\glspluralsuffix}{s} - <br />\renewcommand*{\glsacrpluralsuffix}{\glspluralsuffix} - <br />\renewcommand*{\glsupacrpluralsuffix}{\glstextup{\glspluralsuffix}} -</div> -<!--l. 2735--><p class="nopar" > This is a somewhat longer file, but again you can use it as a template. Replace <span +\glsifusedtranslatordict{English} +{% +  \addglossarytocaptions{\CurrentTrackedLanguage}% +  \addglossarytocaptions{\CurrentTrackedDialect}% +} +{% +  \@ifpackageloaded{polyglossia}% +  {% +    \newcommand*{\glossariescaptionsenglish}{% +      \renewcommand*{\glossaryname}{\textenglish{Glossary}}% +      \renewcommand*{\acronymname}{\textenglish{Acronyms}}% +      \renewcommand*{\entryname}{\textenglish{Notation}}% +      \renewcommand*{\descriptionname}{\textenglish{Description}}% +      \renewcommand*{\symbolname}{\textenglish{Symbol}}% +      \renewcommand*{\pagelistname}{\textenglish{Page List}}% +      \renewcommand*{\glssymbolsgroupname}{\textenglish{Symbols}}% +      \renewcommand*{\glsnumbersgroupname}{\textenglish{Numbers}}% +    }% +  }% +  {% +    \newcommand*{\glossariescaptionsenglish}{% +      \renewcommand*{\glossaryname}{Glossary}% +      \renewcommand*{\acronymname}{Acronyms}% +      \renewcommand*{\entryname}{Notation}% +      \renewcommand*{\descriptionname}{Description}% +      \renewcommand*{\symbolname}{Symbol}% +      \renewcommand*{\pagelistname}{Page List}% +      \renewcommand*{\glssymbolsgroupname}{Symbols}% +      \renewcommand*{\glsnumbersgroupname}{Numbers}% +    }% +  }% +  \ifcsdef{captions\CurrentTrackedDialect} +  {% +    \csappto{captions\CurrentTrackedDialect}% +    {% +      \glossariescaptionsenglish +    }% +  }% +  {% +    \ifcsdef{captions\CurrentTrackedLanguage} +    { +      \csappto{captions\CurrentTrackedLanguage}% +      {% +        \glossariescaptionsenglish + + +      }% +    }% +    {% +    }% +  }% +  \glossariescaptionsenglish +} +\renewcommand*{\glspluralsuffix}{s} +\renewcommand*{\glsacrpluralsuffix}{\glspluralsuffix} +\renewcommand*{\glsupacrpluralsuffix}{\glstextup{\glspluralsuffix}} +</pre> +<!--l. 2818--><p class="nopar" > This is a somewhat longer file, but again you can use it as a template. Replace <span class="cmtt-10">English </span>with the <span class="cmss-10">translator</span><a id="dx1-15007"></a> @@ -6326,7 +6670,7 @@ the definition of <span class="cmtt-10">\glossariescaptions</span>⟨<span class="cmti-10">lang</span>⟩, replace the English text (such as “Glossaries”) with the appropriate translation. -</p><!--l. 2745--><p class="indent" > <span class="warningsymbol">⚠</span> The suffixes used to generate the plural forms when the plural hasn’t been specified are given by +</p><!--l. 2828--><p class="indent" > <span class="warningsymbol">⚠</span> The suffixes used to generate the plural forms when the plural hasn’t been specified are given by <span class="cmtt-10">\glspluralsuffix </span>(for general entries). For abbreviations defined with <span class="cmtt-10">\newacronym</span>, <span @@ -6339,7 +6683,7 @@ class="cmtt-10">\glsacrpluralsuffix </span>for other acronym styles. There’ They may be expanded on definition or they may be expanded on use, depending on the <span class="cmss-10">glossaries</span> configuration. -</p><!--l. 2756--><p class="indent" > <div class="important" title="Important Note"> Therefore these plural suffix command definitions aren’t included in the caption mechanism as that’s +</p><!--l. 2839--><p class="indent" > <div class="important" title="Important Note"> Therefore these plural suffix command definitions aren’t included in the caption mechanism as that’s typically not switched on until the start of the document. <strong>This means that the suffix in effect will be for the last loaded language that redefined these commands.</strong> It’s best to initialise these commands to the most common suffix required in your document and use the <span @@ -6350,8 +6694,8 @@ class="cmtt-10">longplural</span><a class="cmtt-10">shortplural</span><a id="dx1-15010"></a> etc keys to override exceptions. </div> -</p><!--l. 2765--><p class="noindent" > -</p><!--l. 2767--><p class="indent" > If you want to add a regional variation, create a file called <span +</p><!--l. 2848--><p class="noindent" > +</p><!--l. 2850--><p class="indent" > If you want to add a regional variation, create a file called <span class="cmtt-10">glossaries-</span>⟨<span class="cmti-10">iso lang</span>⟩<span class="cmtt-10">-</span>⟨<span @@ -6366,125 +6710,129 @@ example: </p> - <div class="verbatim" id="verbatim-56"> + <pre class="verbatim" id="verbatim-60">  \ProvidesGlossariesLang{en-GB} - <br /> \RequireGlossariesLang{english} - <br /> \glsifusedtranslatordict{British} - <br /> {% - <br />   \addglossarytocaptions{\CurrentTrackedLanguage}% - <br />   \addglossarytocaptions{\CurrentTrackedDialect}% - <br /> } - <br /> {% - <br />   \@ifpackageloaded{polyglossia}% - <br />   {% - <br />     % Modify \glossariescaptionsenglish as appropriate for - <br />     % polyglossia - <br />   }% - <br />   {% - <br />     % Modify \glossariescaptionsenglish as appropriate for - <br />     % non-polyglossia - <br />   }% - <br /> } -</div> -<!--l. 2792--><p class="nopar" > -</p><!--l. 2794--><p class="indent" > If the translations includes <a + \RequireGlossariesLang{english} + \glsifusedtranslatordict{British} + {% +   \addglossarytocaptions{\CurrentTrackedLanguage}% +   \addglossarytocaptions{\CurrentTrackedDialect}% + } + {% +   \@ifpackageloaded{polyglossia}% +   {% +     % Modify \glossariescaptionsenglish as appropriate for +     % polyglossia +   }% +   {% +     % Modify \glossariescaptionsenglish as appropriate for +     % non-polyglossia +   }% + } +</pre> +<!--l. 2875--><p class="nopar" > +</p><!--l. 2877--><p class="indent" > If the translations includes <a href="#glo:nonlatinchar">non-Latin character<a id="dx1-15011"></a>s</a>, it’s necessary to provide code that’s independent of the -input encoding. Remember that while some users may use UTF-8, others may use Latin-1 or any other +input encoding. Remember that while some users may use <a +href="#glo:UTF-8">UTF-8</a>, others may use Latin-1 or any other supported encoding, but while users won’t appreciate you enforcing your preference on them, it’s useful to -provide a UTF-8 version for XeLaTeX users. -</p><!--l. 2801--><p class="indent" > The <span +provide a <a +href="#glo:UTF-8">UTF-8</a> version for XeLaTeX and LuaLaTeX users. +</p><!--l. 2884--><p class="indent" > The <span class="cmtt-10">glossaries-irish.ldf </span>file provides this as follows: </p> - <div class="verbatim" id="verbatim-57"> + <pre class="verbatim" id="verbatim-61"> \ProvidesGlossariesLang{irish} - <br />\glsifusedtranslatordict{Irish} - <br />{% - <br />  \addglossarytocaptions{\CurrentTrackedLanguage}% - <br />  \addglossarytocaptions{\CurrentTrackedDialect}% - <br />} - <br />{% - <br />  \ifdefstring{\inputencodingname}{utf8} - <br />  {\input{glossaries-irish-utf8.ldf}}% - <br />  {% - <br />    \ifdef{\XeTeXinputencoding}% XeTeX defaults to UTF-8 - <br />    {\input{glossaries-irish-utf8.ldf}}% - <br />    {\input{glossaries-irish-noenc.ldf}} - <br />  } - <br />  \ifcsdef{captions\CurrentTrackedDialect} - <br />  {% - <br />    \csappto{captions\CurrentTrackedDialect}% - <br />    {% - <br />      \glossariescaptionsirish - <br />    }% - <br />  }% - <br />  {% - <br />    \ifcsdef{captions\CurrentTrackedLanguage} - <br />    { - <br />      \csappto{captions\CurrentTrackedLanguage}% - <br />      {% - <br />        \glossariescaptionsirish - <br />      }% - <br />    }% - <br />    {% - <br />    }% - <br />  }% - <br />  \glossariescaptionsirish - <br />} -</div> -<!--l. 2838--><p class="nopar" > (Again you can use this as a template. Replace <span +\glsifusedtranslatordict{Irish} +{% +  \addglossarytocaptions{\CurrentTrackedLanguage}% +  \addglossarytocaptions{\CurrentTrackedDialect}% +} +{% +  \ifdefstring{\inputencodingname}{utf8} +  {\input{glossaries-irish-utf8.ldf}}% +  {% +    \ifdef{\XeTeXinputencoding}% XeTeX defaults to UTF-8 +    {\input{glossaries-irish-utf8.ldf}}% +    {\input{glossaries-irish-noenc.ldf}} +  } +  \ifcsdef{captions\CurrentTrackedDialect} +  {% +    \csappto{captions\CurrentTrackedDialect}% +    {% +      \glossariescaptionsirish +    }% +  }% +  {% +    \ifcsdef{captions\CurrentTrackedLanguage} +    { +      \csappto{captions\CurrentTrackedLanguage}% +      {% +        \glossariescaptionsirish +      }% +    }% +    {% +    }% +  }% +  \glossariescaptionsirish +} +</pre> +<!--l. 2921--><p class="nopar" > (Again you can use this as a template. Replace <span class="cmtt-10">irish </span>with your root language label and <span class="cmtt-10">Irish </span>with the <span class="cmss-10">translator</span><a id="dx1-15012"></a> dictionary label.) -</p><!--l. 2843--><p class="indent" > There are now two extra files: <span +</p><!--l. 2926--><p class="indent" > There are now two extra files: <span class="cmtt-10">glossaries-irish-noenc.ldf </span>(no encoding information) and <span -class="cmtt-10">glossaries-irish-utf8.ldf </span>(UTF-8). -</p><!--l. 2847--><p class="indent" > These both define <span +class="cmtt-10">glossaries-irish-utf8.ldf </span>(<a +href="#glo:UTF-8">UTF-8</a>). +</p><!--l. 2930--><p class="indent" > These both define <span class="cmtt-10">\glossariescaptionsirish </span>but the <span class="cmtt-10">*-noenc.ldf </span>uses LaTeX accent commands: </p> - <div class="verbatim" id="verbatim-58"> + <pre class="verbatim" id="verbatim-62"> \@ifpackageloaded{polyglossia}% - <br />{% - <br />  \newcommand*{\glossariescaptionsirish}{% - <br />    \renewcommand*{\glossaryname}{\textirish{Gluais}}% - <br />    \renewcommand*{\acronymname}{\textirish{Acrainmneacha}}% - <br />    \renewcommand*{\entryname}{\textirish{Ciall}}% - <br />    \renewcommand*{\descriptionname}{\textirish{Tuairisc}}% - <br />    \renewcommand*{\symbolname}{\textirish{Comhartha}}% - <br />    \renewcommand*{\glssymbolsgroupname}{\textirish{Comhartha\'{\i}}}% - <br />    \renewcommand*{\pagelistname}{\textirish{Leathanaigh}}% - <br />    \renewcommand*{\glsnumbersgroupname}{\textirish{Uimhreacha}}% - <br />  }% - <br />}% - <br />{% - <br />  \newcommand*{\glossariescaptionsirish}{% - <br />    \renewcommand*{\glossaryname}{Gluais}% - <br />    \renewcommand*{\acronymname}{Acrainmneacha}% - <br />    \renewcommand*{\entryname}{Ciall}% - <br />    \renewcommand*{\descriptionname}{Tuairisc}% - <br />    \renewcommand*{\symbolname}{Comhartha}% - <br />    \renewcommand*{\glssymbolsgroupname}{Comhartha\'{\i}}% - <br />    \renewcommand*{\pagelistname}{Leathanaigh}% - <br />    \renewcommand*{\glsnumbersgroupname}{Uimhreacha}% - <br />  }% - <br />} -</div> -<!--l. 2875--><p class="nopar" > whereas the <span -class="cmtt-10">*-utf8.ldf </span>replaces the accent commands with the appropriate UTF-8 characters. -</p><!--l. 2880--><p class="noindent" > -</p> -<!--l. 2880--><p class="noindent" ><a +{% +  \newcommand*{\glossariescaptionsirish}{% +    \renewcommand*{\glossaryname}{\textirish{Gluais}}% +    \renewcommand*{\acronymname}{\textirish{Acrainmneacha}}% +    \renewcommand*{\entryname}{\textirish{Ciall}}% +    \renewcommand*{\descriptionname}{\textirish{Tuairisc}}% +    \renewcommand*{\symbolname}{\textirish{Comhartha}}% +    \renewcommand*{\glssymbolsgroupname}{\textirish{Comhartha\'{\i}}}% +    \renewcommand*{\pagelistname}{\textirish{Leathanaigh}}% +    \renewcommand*{\glsnumbersgroupname}{\textirish{Uimhreacha}}% +  }% +}% +{% +  \newcommand*{\glossariescaptionsirish}{% +    \renewcommand*{\glossaryname}{Gluais}% +    \renewcommand*{\acronymname}{Acrainmneacha}% +    \renewcommand*{\entryname}{Ciall}% +    \renewcommand*{\descriptionname}{Tuairisc}% +    \renewcommand*{\symbolname}{Comhartha}% +    \renewcommand*{\glssymbolsgroupname}{Comhartha\'{\i}}% +    \renewcommand*{\pagelistname}{Leathanaigh}% +    \renewcommand*{\glsnumbersgroupname}{Uimhreacha}% +  }% +} +</pre> +<!--l. 2958--><p class="nopar" > whereas the <span +class="cmtt-10">*-utf8.ldf </span>replaces the accent commands with the appropriate <a +href="#glo:UTF-8">UTF-8</a> characters. +</p><!--l. 2963--><p class="noindent" > +</p> +<!--l. 2963--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.4 </span> <a id="sec:makeglossaries"></a>Generating the Associated Glossary Files</h3> -<!--l. 2883--><p class="noindent" ><div class="important" title="Important Note"> This section is only applicable if you have chosen Options <a +<!--l. 2966--><p class="noindent" ><div class="important" title="Important Note"> This section is only applicable if you have chosen Options <a href="#option2">2</a> or <a href="#option3">3</a>. You can ignore this section if you have chosen any of the other options. If you want to alphabetically sort your entries always remember to @@ -6497,8 +6845,8 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-16003"></a></a>). </div> -</p><!--l. 2889--><p class="noindent" > -</p><!--l. 2891--><p class="noindent" >If this section seriously confuses you, and you can’t work out how to run external tools like <a +</p><!--l. 2972--><p class="noindent" > +</p><!--l. 2974--><p class="noindent" >If this section seriously confuses you, and you can’t work out how to run external tools like <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-16004"></a></a> or @@ -6508,64 +6856,66 @@ class="cmtt-10">makeindex</span><a id="dx1-16005"></a></a>, you can try using the <span 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 -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 +href="#sec:pkgopts-sort">§<span +class="cmbx-10">??</span>sec:pkgopts-sort </a><a +href="#sec:pkgopts-sort">Sorting Options<!--tex4ht:ref: sec:pkgopts-sort --></a>, +but you will need 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. 2983--><p class="indent" > In order to generate a sorted glossary with compact <a href="#glo:numberlist">number list<a id="dx1-16007"></a>s</a>, it is necessary to use an external <a href="#glo:indexingapp">indexing application</a> as an intermediate step (unless you have chosen <a -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 -LaTeX are <a +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 LaTeX are +<a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-16008"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-16009"></a></a>. As from version 1.17, the <span -class="cmss-10">glossaries </span>package can be used with either of -these applications. Previous versions were designed to be used with <span +class="cmss-10">glossaries </span>package can be used with either of these +applications. Previous versions were designed to be used with <span class="cmtt-10">makeindex</span><a - id="dx1-16010"></a> only. With the -<a + id="dx1-16010"></a> only. With the <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package, you can also use <a +class="cmss-10">glossaries-extra</span></a> +package, you can also use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-16011"></a></a> as the indexing application. (See the <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> -and <a +class="cmss-10">glossaries-extra</span></a> and <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-16012"></a></a> user manuals for further details.) Note that <span + id="dx1-16012"></a></a> +user manuals for further details.) Note that <span class="cmtt-10">xindy</span><a id="dx1-16013"></a> and <span class="cmtt-10">bib2gls</span><a - id="dx1-16014"></a> have much better -multi-lingual support than <span + id="dx1-16014"></a> have much better multi-lingual +support than <span class="cmtt-10">makeindex</span><a id="dx1-16015"></a>, so <span class="cmtt-10">xindy</span><a id="dx1-16016"></a> or <span class="cmtt-10">bib2gls</span><a - id="dx1-16017"></a> are recommended if you’re not writing in -English. Commands that only have an effect when <span + id="dx1-16017"></a> are recommended if you’re not writing in English. +Commands that only have an effect when <span class="cmtt-10">xindy</span><a id="dx1-16018"></a> is used are described in <a -href="#sec:xindy">§11 </a><a +href="#sec:xindy">§<span +class="cmbx-10">??</span>sec:xindy </a><a href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a>. -</p><!--l. 2920--><p class="indent" > <div class="important" title="Important Note"> This is a multi-stage process, but there are methods of automating document compilation using applications +</p><!--l. 3003--><p class="indent" > <div class="important" title="Important Note"> This is a multi-stage process, but there are methods of automating document compilation using applications such as <span class="cmtt-10">latexmk</span><a id="dx1-16019"></a> and <span @@ -6591,8 +6941,8 @@ class="cmtt-10"> pdflatex</span> </div> With <span class="cmtt-10">latexmk</span><a id="dx1-16022"></a> you need to set up the required dependencies. </div> -<!--l. 2931--><p class="noindent" > -</p><!--l. 2933--><p class="indent" > The <span +<!--l. 3014--><p class="noindent" > +</p><!--l. 3016--><p class="indent" > The <span class="cmss-10">glossaries </span>package comes with the Perl script <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a @@ -6602,14 +6952,15 @@ class="cmtt-10">makeindex</span><a id="dx1-16024"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-16025"></a></a> on all -the glossary files using a customized style file (which is created by <span + id="dx1-16025"></a></a> +on all the glossary files using a customized style file (which is created by <span class="cmtt-10">\makeglossaries</span><a - id="dx1-16026"></a>). See <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 TeX-related applications (including <span + id="dx1-16026"></a>). See +<a +href="#sec:makeglossariesapp">§<span +class="cmbx-10">??</span>sec:makeglossariesapp </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 TeX-related applications (including <span class="cmtt-10">xindy</span><a id="dx1-16027"></a> and <span class="cmtt-10">latexmk</span><a @@ -6628,26 +6979,31 @@ href="http://www.perl.org/about.html" class="url" ><span class="cmtt-10">http://www.perl.org/about.html</span></a> and <a href="http://tex.stackexchange.com/questions/158796/miktex-and-perl-scripts-and-one-python-script" >MiKTeX and Perl scripts (and one Python script)</a>. -</p><!--l. 2949--><p class="indent" > The advantages of using <span +</p><!--l. 3032--><p class="indent" > The advantages of using <span class="cmtt-10">makeglossaries</span><a id="dx1-16031"></a>: </p> <ul class="itemize1"> - <li class="itemize">It automatically detects whether to use <span + <li class="itemize"> + <!--l. 3034--><p class="noindent" >It automatically detects whether to use <span class="cmtt-10">makeindex</span><a id="dx1-16032"></a> or <span class="cmtt-10">xindy</span><a id="dx1-16033"></a> and sets the relevant application switches. - </li> - <li class="itemize">One call of <span + </p></li> + <li class="itemize"> + <!--l. 3037--><p class="noindent" >One call of <span class="cmtt-10">makeglossaries</span><a id="dx1-16034"></a> will run <span class="cmtt-10">makeindex</span><a id="dx1-16035"></a>/<span class="cmtt-10">xindy</span><a id="dx1-16036"></a> for each glossary type. - </li> - <li class="itemize">If things go wrong, <a + </p></li> + <li class="itemize"> + + + <!--l. 3040--><p class="noindent" >If things go wrong, <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-16037"></a></a> will scan the messages from <a @@ -6665,10 +7021,9 @@ class="cmtt-10">makeindex</span><a id="dx1-16040"></a> or <span class="cmtt-10">xindy</span><a id="dx1-16041"></a> messages. - - - </li> - <li class="itemize">If <a + </p></li> + <li class="itemize"> + <!--l. 3048--><p class="noindent" >If <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-16042"></a></a> warns about multiple encap values, <a @@ -6690,11 +7045,13 @@ class="cmtt-10">xindy</span><a id="dx1-16048"></a></a> uses the order of the <a id="dx1-16049"></a>attributes list to determine which format should take precedence. (see <a -href="#sec:xindyloc">§11.2 </a><a -href="#sec:xindyloc">Locations - and Number lists<!--tex4ht:ref: sec:xindyloc --></a>.) +href="#sec:xindyloc">§<span +class="cmbx-10">??</span>sec:xindyloc + </a><a +href="#sec:xindyloc">Locations and Number lists<!--tex4ht:ref: sec:xindyloc --></a>.) +</p> </li></ul> -<!--l. 2975--><p class="indent" > As from version 4.16, the <span +<!--l. 3058--><p class="indent" > As from version 4.16, the <span class="cmss-10">glossaries </span>package also comes with a Lua script called <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a @@ -6718,7 +7075,7 @@ href="#option2">Option 2</a> href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-16054"></a></a>). -</p><!--l. 2985--><p class="indent" > If things go wrong and you can’t work out why your glossaries aren’t being generated correctly, you can use +</p><!--l. 3068--><p class="indent" > If things go wrong and you can’t work out why your glossaries aren’t being generated correctly, you can use <a href="#glo:makeglossariesgui"><span class="cmtt-10">makeglossariesgui</span><a @@ -6730,7 +7087,7 @@ class="cmtt-10">makeglossaries</span><a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-16057"></a></a>. -</p><!--l. 2991--><p class="indent" > Whilst I strongly recommended that you use the <a +</p><!--l. 3074--><p class="indent" > Whilst I strongly recommended that you use the <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-16058"></a></a> Perl script or the <a @@ -6747,8 +7104,9 @@ href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-16061"></a></a>. These are listed in <a -href="#tab:makeglossariesCmds">table 1.3</a>. -</p><!--l. 2998--><p class="indent" > <div class="important" title="Important Note"> If you are choosing not to use <span +href="#tab:makeglossariesCmds">table <span +class="cmbx-10">??</span>tab:makeglossariesCmds</a>. +</p><!--l. 3081--><p class="indent" > <div class="important" title="Important Note"> If you are choosing not to use <span class="cmtt-10">makeglossaries</span><a id="dx1-16062"></a> because you don’t want to install Perl, you will only be able to use <span @@ -6759,8 +7117,8 @@ class="cmtt-10">xindy</span><a class="cmtt-10">epstopdf </span>and <span class="cmtt-10">latexmk</span>, so it’s well-worth the effort to install Perl.) </div> -</p><!--l. 3004--><p class="noindent" > -</p><!--l. 3006--><p class="indent" > Note that if any of your entries use an entry that is not referenced outside the glossary, you will need to do an +</p><!--l. 3087--><p class="noindent" > +</p><!--l. 3089--><p class="indent" > Note that if any of your entries use an entry that is not referenced outside the glossary, you will need to do an additional <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a @@ -6777,14 +7135,14 @@ href="#fn7x1" id="fn7x1-bk"><sup class="textsuperscript">1.7</sup></a></span><a </p> - <div class="verbatim" id="verbatim-59"> + <pre class="verbatim" id="verbatim-63"> \newglossaryentry{citrusfruit}{name={citrus fruit}, - <br />description={fruit of any citrus tree. (See also - <br />\gls{orange})}} - <br />\newglossaryentry{orange}{name={orange}, - <br />description={an orange coloured fruit.}} -</div> -<!--l. 3019--><p class="nopar" > and suppose you have <span class="obeylines-h"><span class="verb"><span +description={fruit of any citrus tree. (See also +\gls{orange})}} +\newglossaryentry{orange}{name={orange}, +description={an orange coloured fruit.}} +</pre> +<!--l. 3102--><p class="nopar" > and suppose you have <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{citrusfruit}</span></span></span> in your document but don’t reference the <span class="cmtt-10">orange </span>entry, then the <span @@ -6801,7 +7159,7 @@ class="cmtt-10">xindy</span><a id="dx1-16072"></a></a>. For example, if the document is called <span class="cmtt-10">myDoc.tex</span>, then you must do: -</p><!--l. 3027--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3110--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br />makeglossaries myDoc <br />pdflatex myDoc @@ -6823,7 +7181,7 @@ required. See the and <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-16075"></a></a> manual for further details.) -</p><!--l. 3040--><p class="indent" > Likewise, an additional <a +</p><!--l. 3123--><p class="indent" > Likewise, an additional <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-16076"></a></a> and LaTeX run may be required if the document pages shift with @@ -6832,7 +7190,7 @@ contents on the second LaTeX run may push glossary entries across page bo <a href="#glo:numberlist">number list<a id="dx1-16077"></a>s</a> in the glossary may need updating. -</p><!--l. 3048--><p class="indent" > The examples in this document assume that you are accessing <a +</p><!--l. 3131--><p class="indent" > The examples in this document assume that you are accessing <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-16078"></a></a>, <a @@ -6852,11 +7210,11 @@ class="cmmi-10">></span><span class="cmss-10">All Programs-</span><span class="cmmi-10">></span><span class="cmss-10">Accessories </span>menu. -</p><!--l. 3054--><p class="indent" > Alternatively, your text editor may have the facility to create a function that will call the required +</p><!--l. 3137--><p class="indent" > Alternatively, your text editor may have the facility to create a function that will call the required application. See <a href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a>. -</p><!--l. 3060--><p class="indent" > If any problems occur, remember to check the transcript files (e.g. <span +</p><!--l. 3143--><p class="indent" > If any problems occur, remember to check the transcript files (e.g. <span class="cmtt-10">glg</span><a id="dx1-16081"></a> or <span class="cmtt-10">alg</span><a @@ -6865,7 +7223,7 @@ class="cmtt-10">alg</span><a <div class="table"> -<!--l. 3063--><p class="indent" > <a +<!--l. 3146--><p class="indent" > <a id="tab:makeglossariesCmds"></a></p><hr class="float" /><div class="float" > @@ -6880,7 +7238,7 @@ href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-16085"></a></a> explicitly</span></div><!--tex4ht:label?: x1-160833 --> <div class="tabular"> <table id="TBL-4" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-4-1g"><col id="TBL-4-1" /><col id="TBL-4-2" /><col @@ -6969,10 +7327,10 @@ class="cmti-10">code</span>⟩ </td></tr></table> </div><hr class="endfloat" /> </div> -<!--l. 3086--><p class="noindent" ><a +<!--l. 3169--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.4.1 </span> <a id="sec:makeglossariesapp"></a>Using the makeglossaries Perl Script</h4> -<!--l. 3089--><p class="noindent" >The <a +<!--l. 3172--><p class="noindent" >The <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-17001"></a></a> script picks up the relevant information from the auxiliary (<span @@ -6990,7 +7348,7 @@ class="cmtt-10">makeglossaries</span><a id="dx1-17005"></a>. For example, if your document is called <span class="cmtt-10">myDoc.tex</span>, type the following in your terminal: -</p><!--l. 3096--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3179--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex myDoc <br />makeglossaries myDoc <br />pdflatex myDoc @@ -7000,11 +7358,11 @@ You may need to explicitly load <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-17006"></a></a> into Perl: -</p><!--l. 3102--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3185--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />perl makeglossaries myDoc <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 3106--><p class="indent" > Windows users: TeX Live on Windows has its own internal Perl interpreter and provides +</p><!--l. 3189--><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 @@ -7021,7 +7379,7 @@ There’s more information about this at <a href="http://tex.stackexchange.com/q/158796/19862" class="url" ><span class="cmtt-10">http://tex.stackexchange.com/q/158796/19862</span></a> on the TeX.SX site. -</p><!--l. 3118--><p class="indent" > The <a +</p><!--l. 3201--><p class="indent" > The <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-17009"></a></a> script attempts to fork the <a @@ -7055,14 +7413,14 @@ fallback method without attempting the redirection. Without this redirection, th class="cmtt-10">-q</span><a id="dx1-17017"></a> (quiet) switch doesn’t work as well. -</p><!--l. 3130--><p class="indent" > You can specify in which directory the <span +</p><!--l. 3213--><p class="indent" > You can specify in which directory the <span class="cmtt-10">aux</span><a id="dx1-17018"></a>, <span class="cmtt-10">glo</span><a id="dx1-17019"></a> etc files are located using the <span class="cmtt-10">-d </span>switch. For example: -</p><!--l. 3133--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3216--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex -output-directory myTmpDir myDoc <br />makeglossaries -d myTmpDir myDoc <br /></pre><spacer type=vertical size=10> @@ -7088,7 +7446,7 @@ class="cmtt-10">xindy</span><a id="dx1-17026"></a>. -</p><!--l. 3143--><p class="indent" > As from <a +</p><!--l. 3226--><p class="indent" > As from <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-17027"></a></a> v2.18, if you are using <a @@ -7102,17 +7460,17 @@ entry. For example: </p> - <div class="verbatim" id="verbatim-60"> + <pre class="verbatim" id="verbatim-64"> \documentclass{article} - <br />\usepackage{glossaries} - <br />\makeglossaries - <br />\newglossaryentry{sample}{name={sample},description={an example}} - <br />\begin{document} - <br />\gls{sample}, \gls[format=textbf]{sample}. - <br />\printglossaries - <br />\end{document} -</div> -<!--l. 3159--><p class="nopar" > If you explicitly use <a +\usepackage{glossaries} +\makeglossaries +\newglossaryentry{sample}{name={sample},description={an example}} +\begin{document} +\gls{sample}, \gls[format=textbf]{sample}. +\printglossaries +\end{document} +</pre> +<!--l. 3242--><p class="nopar" > If you explicitly use <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-17030"></a></a>, this will cause a warning and the location list will be “1, <span @@ -7129,21 +7487,21 @@ class="cmtt-10">xindy</span><a class="cmtt-10">xindy</span><a id="dx1-17033"></a> won’t produce any warning and will simply discard duplicates. -</p><!--l. 3168--><p class="indent" > For a complete list of options do <span +</p><!--l. 3251--><p class="indent" > For a complete list of options do <span class="cmtt-10">makeglossaries --help</span>. -</p><!--l. 3170--><p class="indent" > <div class="important" title="Important Note"> When upgrading the <span +</p><!--l. 3253--><p class="indent" > <div class="important" title="Important Note"> When upgrading the <span class="cmss-10">glossaries </span>package, make sure you also upgrade your version of <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-17034"></a></a>. The -current version is 4.45. </div> -</p><!--l. 3174--><p class="noindent" > -</p><!--l. 3176--><p class="noindent" > +current version is 4.47. </div> +</p><!--l. 3257--><p class="noindent" > +</p><!--l. 3259--><p class="noindent" > </p> -<!--l. 3176--><p class="noindent" ><a +<!--l. 3259--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.4.2 </span> <a id="sec:makeglossarieslua"></a>Using the makeglossaries-lite Lua Script</h4> -<!--l. 3179--><p class="noindent" >The Lua alternative to the <a +<!--l. 3262--><p class="noindent" >The Lua alternative to the <a 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 @@ -7160,15 +7518,15 @@ 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 TeX Live on Unix-like systems creates a symbolic link called <span +</p><!--l. 3272--><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> -</p><!--l. 3195--><p class="noindent" > -</p><!--l. 3197--><p class="indent" > The <a +</p><!--l. 3278--><p class="noindent" > +</p><!--l. 3280--><p class="indent" > The <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-18006"></a></a> script can be invoked in the same way as <a @@ -7177,18 +7535,18 @@ class="cmtt-10">makeglossaries</span><a id="dx1-18007"></a></a>. For example, if your document is called <span class="cmtt-10">myDoc.tex</span>, then do -</p><!--l. 3200--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3283--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries-lite.lua myDoc <br /></pre><spacer type=vertical size=10> <br /></span> or -</p><!--l. 3204--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3287--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries-lite myDoc <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 3208--><p class="indent" > <span +</p><!--l. 3291--><p class="indent" > <span class="cmti-10">Some </span>of the options available with the Perl <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a @@ -7197,25 +7555,25 @@ class="cmtt-10">makeglossaries</span><a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a id="dx1-18009"></a></a> script. For a complete list of available options, do -</p><!--l. 3211--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3294--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries-lite.lua --help <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 3217--><p class="noindent" > +</p><!--l. 3300--><p class="noindent" > </p> -<!--l. 3217--><p class="noindent" ><a +<!--l. 3300--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.4.3 </span> <a id="sec:xindyapp"></a>Using <a href="#glo:xindy"><span class="cmtt-10">xindy</span></a> explicitly (Option 3)</h4> -<!--l. 3220--><p class="noindent" ><a +<!--l. 3303--><p class="noindent" ><a href="#glo:xindy"><span class="cmtt-10">Xindy</span><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/" >TeX on StackExchange</a>. -</p><!--l. 3226--><p class="indent" > If you want to use <a +</p><!--l. 3309--><p class="indent" > If you want to use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-19002"></a></a> to process the glossary files, you must make sure you have used the <span @@ -7225,10 +7583,10 @@ option: </p> - <div class="verbatim" id="verbatim-61"> + <pre class="verbatim" id="verbatim-65"> \usepackage[xindy]{glossaries} -</div> -<!--l. 3231--><p class="nopar" > This is required regardless of whether you use <a +</pre> +<!--l. 3314--><p class="nopar" > This is required regardless of whether you use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-19004"></a></a> explicitly or whether it’s called implicitly via applications @@ -7246,11 +7604,11 @@ class="cmti-10">not </span><span class="cmtt-10">-I</span><a id="dx1-19008"></a> <span class="cmtt-10">tex</span>. -</p><!--l. 3238--><p class="indent" > To run <a +</p><!--l. 3321--><p class="indent" > To run <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-19009"></a></a> type the following in your terminal (all on one line): -</p><!--l. 3240--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3323--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L ⟨<span class="cmti-10">language</span>⟩ -C ⟨<span class="cmti-10">encoding</span>⟩ -I xindy -M ⟨<span @@ -7284,14 +7642,14 @@ class="cmti-10">style</span>⟩<span class="cmtt-10">}</span>. You may need to specify the full path name depending on the current working directory. If any of the file names contain spaces, you must delimit them using double-quotes. -</p><!--l. 3253--><p class="indent" > For example, if your document is called <span +</p><!--l. 3336--><p class="indent" > For example, if your document is called <span class="cmtt-10">myDoc.tex </span>and you are using UTF8 encoding in English, then type the following in your terminal: -</p><!--l. 3256--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3339--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.glg -o myDoc.gls myDoc.glo <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 3260--><p class="indent" > Note that this just creates the main glossary. You need to do the same for each of the other glossaries +</p><!--l. 3343--><p class="indent" > Note that this just creates the main glossary. You need to do the same for each of the other glossaries (including the list of acronyms if you have used the <span class="cmss-10">acronym</span><a id="dx1-19015"></a> package option), substituting <span @@ -7305,7 +7663,7 @@ with the relevant extensions. For example, if you have used the <span class="cmss-10">acronym</span><a id="dx1-19019"></a> package option, then you would need to do: -</p><!--l. 3267--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3350--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.alg -o myDoc.acr myDoc.acn <br /></pre><spacer type=vertical size=10> <br /></span> @@ -7313,7 +7671,7 @@ For additional glossaries, the extensions are those supplied when you created th <span class="cmtt-10">\newglossary</span><a id="dx1-19020"></a>. -</p><!--l. 3273--><p class="indent" > Note that if you use <a +</p><!--l. 3356--><p class="indent" > Note that if you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-19021"></a></a> instead, you can replace all those calls to <a @@ -7323,7 +7681,7 @@ class="cmtt-10">xindy</span><a <span class="cmtt-10">makeglossaries</span><a id="dx1-19023"></a>: -</p><!--l. 3276--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3359--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries myDoc <br /></pre><spacer type=vertical size=10> <br /></span> @@ -7334,17 +7692,18 @@ class="cmtt-10">xindy</span><a <span class="cmtt-10">makeglossaries</span><a id="dx1-19025"></a>. These are listed in <a -href="#tab:makeglossariesCmds">table 1.3</a>. +href="#tab:makeglossariesCmds">table <span +class="cmbx-10">??</span>tab:makeglossariesCmds</a>. -</p><!--l. 3286--><p class="noindent" > +</p><!--l. 3369--><p class="noindent" > </p> -<!--l. 3286--><p class="noindent" ><a +<!--l. 3369--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.4.4 </span> <a id="sec:makeindexapp"></a>Using <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span></a> explicitly (Option 2)</h4> -<!--l. 3289--><p class="noindent" >If you want to use <a +<!--l. 3372--><p class="noindent" >If you want to use <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-20001"></a></a> explicitly, you must make sure that you haven’t used the <span @@ -7354,7 +7713,7 @@ the glossary entries will be written in the wrong format. To run <span class="cmtt-10">makeindex</span><a id="dx1-20003"></a>, type the following in your terminal: -</p><!--l. 3294--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3377--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s ⟨<span class="cmti-10">style</span>⟩.ist -t ⟨<span class="cmti-10">base</span>⟩.glg -o ⟨<span @@ -7387,9 +7746,9 @@ class="cmtt-10">-l</span><a class="cmtt-10">makeindex</span><a id="dx1-20010"></a> manual for further details. -</p><!--l. 3305--><p class="indent" > For example, if your document is called <span +</p><!--l. 3388--><p class="indent" > For example, if your document is called <span class="cmtt-10">myDoc.tex</span>, then type the following at the terminal: -</p><!--l. 3307--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3390--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s myDoc.ist -t myDoc.glg -o myDoc.gls myDoc.glo <br /></pre><spacer type=vertical size=10> <br /></span> @@ -7410,7 +7769,7 @@ the relevant extensions. For example, if you have used the <span class="cmss-10">acronym</span><a id="dx1-20016"></a> package option, then you need to type the following in your terminal: -</p><!--l. 3318--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3401--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeindex -s myDoc.ist -t myDoc.alg -o myDoc.acr myDoc.acn <br /></pre><spacer type=vertical size=10> <br /></span> @@ -7418,7 +7777,7 @@ For additional glossaries, the extensions are those supplied when you created th <span class="cmtt-10">\newglossary</span><a id="dx1-20017"></a>. -</p><!--l. 3324--><p class="indent" > Note that if you use <a +</p><!--l. 3407--><p class="indent" > Note that if you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-20018"></a></a> instead, you can replace all those calls to <a @@ -7428,7 +7787,7 @@ class="cmtt-10">makeindex</span><a to <span class="cmtt-10">makeglossaries</span><a id="dx1-20020"></a>: -</p><!--l. 3327--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 3410--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />makeglossaries myDoc <br /></pre><spacer type=vertical size=10> <br /></span> @@ -7439,13 +7798,14 @@ using <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-20022"></a></a>. These are listed in <a -href="#tab:makeglossariesCmds">table 1.3</a>. -</p><!--l. 3335--><p class="noindent" > +href="#tab:makeglossariesCmds">table <span +class="cmbx-10">??</span>tab:makeglossariesCmds</a>. +</p><!--l. 3418--><p class="noindent" > </p> -<!--l. 3335--><p class="noindent" ><a +<!--l. 3418--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.5 </span> <a id="sec:notedev"></a>Note to Front-End and Script Developers</h3> -<!--l. 3338--><p class="noindent" >The information needed to determine whether to use <a +<!--l. 3421--><p class="noindent" >The information needed to determine whether to use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-21001"></a></a>, <a @@ -7461,13 +7821,13 @@ This information can be gathered by a front-end, editor or script to make the gl section describes how the information is stored in the auxiliary file. -</p><!--l. 3344--><p class="noindent" > +</p><!--l. 3427--><p class="noindent" > </p> -<!--l. 3344--><p class="noindent" ><a +<!--l. 3427--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.5.1 </span> <a id="sec:notedev.makeindex.xindy"></a>MakeIndex and Xindy</h4> -<!--l. 3347--><p class="noindent" >The file extensions used by each defined (but not ignored) glossary are given by -</p><!--l. 3348--><p class="indent" > <hr><div title="Definition"><a +<!--l. 3430--><p class="noindent" >The file extensions used by each defined (but not ignored) glossary are given by +</p><!--l. 3431--><p class="indent" > <hr><div title="Definition"><a id="dx1-22001"></a> <span class="cmtt-10">\@newglossary{</span>⟨<span class="cmitt-10">label</span>⟩<span @@ -7478,7 +7838,7 @@ class="cmitt-10">out-ext</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">in-ext</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3350--><p class="noindent" > +</p><!--l. 3433--><p class="noindent" > where ⟨<span class="cmti-10">in-ext</span>⟩ is the extension of the <a href="#glo:indexingapp"><span @@ -7502,10 +7862,10 @@ as: </p> - <div class="verbatim" id="verbatim-62"> + <pre class="verbatim" id="verbatim-66"> \@newglossary{main}{glg}{gls}{glo} -</div> -<!--l. 3364--><p class="nopar" > If <a +</pre> +<!--l. 3447--><p class="nopar" > If <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span>’s</a> hybrid method has been used (with <span class="cmtt-10">\makeglossaries[</span>⟨<span @@ -7513,7 +7873,7 @@ class="cmti-10">sub-list</span>⟩<span class="cmtt-10">]</span>), then the sub-list of glossaries that need to be processed will be identified with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor180"><span +<span id="textcolor181"><span class="cmtt-10">\glsxtr@makeglossaries</span></span><a id="dx1-22004"></a><span class="cmtt-10">{</span>⟨<span @@ -7521,14 +7881,14 @@ class="cmitt-10">list</span>⟩<span class="cmtt-10">}</span> </div> </div> -<!--l. 3372--><p class="indent" > The <a +<!--l. 3455--><p class="indent" > The <a href="#glo:indexingapp">indexing application’s</a> style file is specified by -</p><!--l. 3373--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3456--><p class="indent" > <hr><div title="Definition"><a id="dx1-22005"></a> <span class="cmtt-10">\@istfilename{</span>⟨<span class="cmitt-10">filename</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3375--><p class="noindent" > +</p><!--l. 3458--><p class="noindent" > The file extension indicates whether to use <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a @@ -7542,7 +7902,7 @@ class="cmtt-10">xdy</span><a id="dx1-22009"></a>). Note that the glossary information is formatted differently depending on which indexing application is supposed to be used, so it’s important to call the correct one. -</p><!--l. 3382--><p class="indent" > For example, with <span +</p><!--l. 3465--><p class="indent" > For example, with <span class="cmtt-10">arara</span><a id="dx1-22010"></a> you can easily determine whether to run <a href="#glo:makeglossaries"><span @@ -7564,7 +7924,7 @@ class="cmtt-10">makeindex</span><a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-22013"></a></a> -<!--l. 3389--><p class="indent" > <div class="important" title="Important Note"> Note that if you choose to explicitly call <a +<!--l. 3472--><p class="indent" > <div class="important" title="Important Note"> Note that if you choose to explicitly call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-22014"></a></a> or <a @@ -7575,23 +7935,23 @@ information and the encap-clash fix that <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a id="dx1-22016"></a></a> also provides. </div> -</p><!--l. 3394--><p class="noindent" > -</p><!--l. 3396--><p class="indent" > Word or letter ordering is specified by: -</p><!--l. 3397--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3477--><p class="noindent" > +</p><!--l. 3479--><p class="indent" > Word or letter ordering is specified by: +</p><!--l. 3480--><p class="indent" > <hr><div title="Definition"><a id="dx1-22017"></a> <span class="cmtt-10">\@glsorder{</span>⟨<span class="cmitt-10">order</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3399--><p class="noindent" > +</p><!--l. 3482--><p class="noindent" > where ⟨<span class="cmti-10">order</span>⟩ can be either <span class="cmtt-10">word </span>or <span class="cmtt-10">letter</span>. -</p><!--l. 3402--><p class="indent" > If <a +</p><!--l. 3485--><p class="indent" > If <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a id="dx1-22018"></a></a> should be used, the language and code page for each glossary is specified by -</p><!--l. 3404--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3487--><p class="indent" > <hr><div title="Definition"><a id="dx1-22019"></a><a id="dx1-22020"></a> <span class="cmtt-10">\@xdylanguage{</span>⟨<span @@ -7605,7 +7965,7 @@ 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. 3407--><p class="noindent" > +</p><!--l. 3490--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ identifies the glossary, ⟨<span class="cmti-10">language</span>⟩ is the root language (e.g. <span @@ -7616,11 +7976,11 @@ class="cmtt-10">utf8</span>). These commands are omitted if <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a id="dx1-22021"></a></a> should be used. -</p><!--l. 3413--><p class="indent" > If <a +</p><!--l. 3496--><p class="indent" > If <a href="#option1">Option 1</a> has been used, the <span class="cmtt-10">aux</span><a id="dx1-22022"></a> file will contain -</p><!--l. 3414--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3497--><p class="indent" > <hr><div title="Definition"><a id="dx1-22023"></a> <span class="cmtt-10">\@gls@reference{</span>⟨<span class="cmitt-10">type</span>⟩<span @@ -7629,39 +7989,44 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">location</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3416--><p class="noindent" > +</p><!--l. 3499--><p class="noindent" > for every time an entry has been referenced. -</p><!--l. 3419--><p class="noindent" > +</p><!--l. 3502--><p class="noindent" > </p> -<!--l. 3419--><p class="noindent" ><a +<!--l. 3502--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.5.2 </span> <a id="sec:notedev.labels"></a>Entry Labels</h4> -<!--l. 3422--><p class="noindent" >If you need to gather labels for auto-completion, the <span +<!--l. 3505--><p class="noindent" >If you need to gather labels for auto-completion, the <span class="cmss-10">writeglslabels</span><a id="dx1-23001"></a> package option will create a file containing the -labels of all defined entries (regardless of whether or not the entry has been used in the document). The -<a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package also provides <span id="textcolor181"><span +labels of all defined entries (regardless of whether or not the entry has been used in the document). As from +v4.47, there is a similar option <span +class="cmss-10">writeglslabelnames</span><a + id="dx1-23002"></a> that writes both the label and name (separated by a +tab). +</p><!--l. 3512--><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 also provides <span id="textcolor182"><span class="cmss-10">docdef</span><span class="cmtt-10">=</span><span class="cmss-10">atom</span></span><a - id="dx1-23002"></a>, which will create the <span + id="dx1-23003"></a>, which will create the <span class="cmtt-10">glsdefs</span><a - id="dx1-23003"></a> file but will act like -<span id="textcolor182"><span + id="dx1-23004"></a> file but will act like +<span id="textcolor183"><span class="cmss-10">docdef</span><span class="cmtt-10">=</span><span class="cmss-10">restricted</span></span><a - id="dx1-23004"></a>. -</p><!--l. 3429--><p class="noindent" > + id="dx1-23005"></a>. </div> +</p><!--l. 3516--><p class="noindent" > +</p><!--l. 3518--><p class="noindent" > </p> -<!--l. 3429--><p class="noindent" ><a +<!--l. 3518--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.5.3 </span> <a id="sec:notedev.bib2gls"></a>Bib2Gls</h4> -<!--l. 3432--><p class="noindent" ><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 3521--><p class="noindent" ><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-24001"></a></a></span>If <a @@ -7669,7 +8034,7 @@ href="#option4">Option 4</a> has been used, the <span class="cmtt-10">aux</span><a id="dx1-24002"></a> file will contain one or more instances of </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor183"><span +<span id="textcolor184"><span class="cmtt-10">\glsxtr@resource</span></span><a id="dx1-24003"></a><span class="cmtt-10">{</span>⟨<span @@ -7695,7 +8060,7 @@ class="cmti-10">basename</span>⟩ also indicates the name of the associate class="cmtt-10">bib</span><a id="dx1-24006"></a> file. -<!--l. 3442--><p class="indent" > For example, with <span +<!--l. 3531--><p class="indent" > For example, with <span class="cmtt-10">arara</span><a id="dx1-24007"></a> you can easily determine whether or not to run <a href="#glo:bib2gls"><span @@ -7710,16 +8075,16 @@ class="cmtt-10"> if</span><span class="cmtt-10"> found("aux",</span><span class="cmtt-10"> "glsxtr@resource")</span> </div> -</div> (It gets more complicated if both <span id="textcolor184"><span +</div> (It gets more complicated if both <span id="textcolor185"><span class="cmtt-10">\glsxtr@resource</span></span><a id="dx1-24009"></a> and <span class="cmtt-10">\@istfilename </span>are present as that indicates the -hybrid <span id="textcolor185"><span +hybrid <span id="textcolor186"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span -class="cmss-10">alsoindex</span></span><a +class="cmss-10">hybrid</span></span><a id="dx1-24010"></a> option.) -<!--l. 3451--><p class="indent" > Remember that with <a +<!--l. 3540--><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 LaTeX call (because their @@ -7733,7 +8098,7 @@ class="cmtt-10">bib2gls</span><a class="cmtt-10">aux</span><a id="dx1-24014"></a> file, which will be in the form: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor186"><span +<span id="textcolor187"><span class="cmtt-10">\glsxtr@record</span></span><a id="dx1-24015"></a><span class="cmtt-10">{</span>⟨<span @@ -7748,13 +8113,15 @@ class="cmtt-10">}{</span>⟨<span class="cmitt-10">loc</span>⟩<span class="cmtt-10">}</span> </div> -</div> or (with <span id="textcolor187"><span +</div> or (with <span id="textcolor188"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a id="dx1-24016"></a>) <div class="alltt"> + + <div class="obeylines-v"> -<span id="textcolor188"><span +<span id="textcolor189"><span class="cmtt-10">\glsxtr@record@nameref</span></span><a id="dx1-24017"></a><span class="cmtt-10">{</span>⟨<span @@ -7782,10 +8149,8 @@ class="cmtt-10">}</span> </div> </div> or (with <span class="cmtt-10">\glssee</span>) <div class="alltt"> - - <div class="obeylines-v"> -<span id="textcolor189"><span +<span id="textcolor190"><span class="cmtt-10">\glsxtr@recordsee</span></span><a id="dx1-24018"></a><span class="cmtt-10">{</span>⟨<span @@ -7795,7 +8160,7 @@ class="cmitt-10">xr</span><span class="cmitt-10"> list</span>⟩<span class="cmtt-10">}</span> </div> -</div> You can also pick up the commands defined with <span id="textcolor190"><span +</div> You can also pick up the commands defined with <span id="textcolor191"><span class="cmtt-10">\glsxtrnewglslike</span></span><a id="dx1-24019"></a>, which are added to the <span class="cmtt-10">aux</span><a @@ -7805,7 +8170,7 @@ href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a id="dx1-24021"></a>’s</a> benefit: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor191"><span +<span id="textcolor192"><span class="cmtt-10">\@glsxtr@newglslike</span></span><a id="dx1-24022"></a><span class="cmtt-10">{</span>⟨<span @@ -7814,22 +8179,22 @@ class="cmtt-10">}{</span>⟨<span class="cmitt-10">cs</span>⟩<span class="cmtt-10">}</span> </div> -</div> If <span id="textcolor192"><span +</div> If <span id="textcolor193"><span class="cmtt-10">\GlsXtrSetAltModifier</span></span><a id="dx1-24023"></a> is used, then the modifier is identified with: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor193"><span +<span id="textcolor194"><span class="cmtt-10">\@glsxtr@altmodifier</span></span><a id="dx1-24024"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">character</span>⟩<span class="cmtt-10">}</span> </div> -</div> Label prefixes (for the <span id="textcolor194"><span +</div> Label prefixes (for the <span id="textcolor195"><span class="cmtt-10">\dgls</span></span><a id="dx1-24025"></a> set of commands) are identified with: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor195"><span +<span id="textcolor196"><span class="cmtt-10">\@glsxtr@prefixlabellist</span></span><a id="dx1-24026"></a><span class="cmtt-10">{</span>⟨<span @@ -7839,11 +8204,11 @@ class="cmtt-10">}</span> </div> -<!--l. 3484--><p class="indent" > </div> -</p><!--l. 3484--><p class="noindent" ><a +<!--l. 3573--><p class="indent" > </div> +</p><!--l. 3573--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">2. <a id="sec:pkgopts"></a>Package Options</h2> -</p><!--l. 3487--><p class="indent" > This section describes the available <span +</p><!--l. 3576--><p class="indent" > This section describes the available <span class="cmss-10">glossaries </span>package options. You may omit the <span class="cmtt-10">=true </span>for boolean options. (For example, <span @@ -7853,7 +8218,7 @@ class="cmss-10">acronym</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a id="dx1-25002"></a>). -</p><!--l. 3491--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 3580--><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 additional options described in the <span class="cmss-10">glossaries-extra </span>manual. The extension @@ -7862,8 +8227,8 @@ writing are included here. Future versions of <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> may have additional package options or new values for existing settings that aren’t listed here. </div> -</p><!--l. 3498--><p class="noindent" > -</p><!--l. 3500--><p class="indent" > <div class="important" title="Important Note"> Note that ⟨<span +</p><!--l. 3587--><p class="noindent" > +</p><!--l. 3589--><p class="indent" > <div class="important" title="Important Note"> Note that ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ package options can’t be passed via the document class options. (This includes options where the ⟨<span @@ -7877,18 +8242,18 @@ class="cmti-10">value</span>⟩ (such as <span class="cmss-10">makeindex</span><a id="dx1-25004"></a>) may be passed via the document class options. </div> -</p><!--l. 3507--><p class="noindent" > +</p><!--l. 3596--><p class="noindent" > </p> -<!--l. 3509--><p class="noindent" ><a +<!--l. 3598--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.1 </span> <a id="sec:pkgopts-general"></a>General Options</h3> -<!--l. 3512--><p class="noindent" > +<!--l. 3601--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-270002.1"></a><a id="pkgopt:nowarn"></a><span class="cmss-10">nowarn</span></h4> -<!--l. 3512--><p class="noindent" >This suppresses all warnings generated by the <span +<!--l. 3601--><p class="noindent" >This suppresses all warnings generated by the <span class="cmss-10">glossaries </span>package. Don’t use this option if you’re new to using <span class="cmss-10">glossaries </span>as the warnings are designed to help detect common mistakes (such as forgetting to use @@ -7899,20 +8264,20 @@ class="cmss-10">debug</span><a id="dx1-27002"></a> with any value other than <span class="cmss-10">false </span>it will override this option. -</p><!--l. 3519--><p class="noindent" > +</p><!--l. 3608--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-280002.1"></a><a id="pkgopt:nolangwarn"></a><span class="cmss-10">nolangwarn</span></h4> -<!--l. 3519--><p class="noindent" >This suppresses the warning generated by a missing language module. -</p><!--l. 3522--><p class="noindent" > +<!--l. 3608--><p class="noindent" >This suppresses the warning generated by a missing language module. +</p><!--l. 3611--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-290002.1"></a><a id="pkgopt:noredefwarn"></a><span class="cmss-10">noredefwarn</span></h4> -<!--l. 3522--><p class="noindent" >If you load <span +<!--l. 3611--><p class="noindent" >If you load <span class="cmss-10">glossaries </span>with a class or another package that already defines glossary related commands, by default <span class="cmss-10">glossaries </span>will warn you that it’s redefining those commands. If you are aware of the consequences of using @@ -7926,7 +8291,7 @@ href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>.) -</p><!--l. 3532--><p class="noindent" > +</p><!--l. 3621--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-300002.1"></a><a @@ -7935,7 +8300,7 @@ class="cmss-10">debug=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3532--><p class="noindent" >Introduced in version 4.24. The default setting is <span +<!--l. 3621--><p class="noindent" >Introduced in version 4.24. The default setting is <span class="cmss-10">debug</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a @@ -7949,19 +8314,19 @@ class="cmss-10">debug</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a id="dx1-30002"></a> is assumed. -</p><!--l. 3538--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 3627--><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 provides extra values <span id="textcolor196"><span +class="cmss-10">glossaries-extra</span></a> package provides extra values <span id="textcolor197"><span class="cmss-10">showwrgloss</span></span><a id="dx1-30003"></a>, that may be used to show where the indexing -is occurring, and <span id="textcolor197"><span +is occurring, and <span id="textcolor198"><span class="cmss-10">all</span></span><a id="dx1-30004"></a>, which switches on all debugging options. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. </div> -</p><!--l. 3544--><p class="noindent" > -</p><!--l. 3546--><p class="indent" > All values other than <span +</p><!--l. 3633--><p class="noindent" > +</p><!--l. 3635--><p class="indent" > All values other than <span class="cmss-10">debug</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a @@ -7973,12 +8338,12 @@ class="cmss-10">debug</span><span class="cmtt-10">=</span><span class="cmss-10">showtargets</span><a id="dx1-30007"></a> option will additionally use: -</p><!--l. 3549--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3638--><p class="indent" > <hr><div title="Definition"><a id="dx1-30008"></a> <span class="cmtt-10">\glsshowtarget{</span>⟨<span class="cmitt-10">target name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3551--><p class="noindent" > +</p><!--l. 3640--><p class="noindent" > to show the hypertarget or hyperlink name when <span class="cmtt-10">\glsdohypertarget </span>is used by commands like <span @@ -7987,17 +8352,17 @@ class="cmtt-10">\glsdohyperlink </span>is used by commands like <span class="cmtt-10">\gls</span>. In math mode or inner mode, this puts the target name in square brackets just before the link or anchor. In outer mode it uses: -</p><!--l. 3557--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3646--><p class="indent" > <hr><div title="Definition"><a id="dx1-30009"></a> <span class="cmtt-10">\glsshowtargetouter{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3559--><p class="noindent" > +</p><!--l. 3648--><p class="noindent" > which by default places the target name in the margin. The font is given by: -</p><!--l. 3562--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3651--><p class="indent" > <hr><div title="Definition"><a id="dx1-30010"></a> <span class="cmtt-10">\glsshowtargetfont </span></div><hr> -</p><!--l. 3564--><p class="noindent" > +</p><!--l. 3653--><p class="noindent" > The default definition is <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ttfamily\small</span></span></span>. This command is included in the definition of <span @@ -8006,17 +8371,17 @@ example: </p> - <div class="verbatim" id="verbatim-63"> + <pre class="verbatim" id="verbatim-67"> \renewcommand*{\glsshowtargetouter}[1]{% - <br /> {\glsshowtargetfont [#1]}} -</div> -<!--l. 3572--><p class="nopar" > -</p><!--l. 3574--><p class="indent" > Similarly, the <span + {\glsshowtargetfont [#1]}} +</pre> +<!--l. 3661--><p class="nopar" > +</p><!--l. 3663--><p class="indent" > Similarly, the <span class="cmss-10">debug</span><span class="cmtt-10">=</span><span class="cmss-10">showaccsupp</span><a id="dx1-30011"></a> will add the accessibility support information using: -</p><!--l. 3576--><p class="indent" > <hr><div title="Definition"><a +</p><!--l. 3665--><p class="indent" > <hr><div title="Definition"><a id="dx1-30012"></a> <span class="cmtt-10">\glsshowaccsupp{</span>⟨<span class="cmitt-10">options</span>⟩<span @@ -8025,13 +8390,13 @@ class="cmitt-10">tag</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">replacement text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3578--><p class="noindent" > +</p><!--l. 3667--><p class="noindent" > This internally uses <span class="cmtt-10">\glsshowtarget</span><a id="dx1-30013"></a>. This option is provided for use with <span class="cmss-10">glossaries-accsupp</span><a id="dx1-30014"></a>. -</p><!--l. 3582--><p class="indent" > The purpose of the debug mode can be demonstrated with the following example document: +</p><!--l. 3671--><p class="indent" > The purpose of the debug mode can be demonstrated with the following example document: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -8072,13 +8437,13 @@ class="cmtt-10">\makeglossaries</span><a id="dx1-30017"></a>. Since the file isn’t open yet, the information can’t be written to it, which is why the <span class="cmtt-10">sample2</span> entry doesn’t appear in the glossary. -<!--l. 3603--><p class="indent" > Without <span +<!--l. 3692--><p class="indent" > Without <span class="cmtt-10">\makeglossaries </span>the indexing is suppressed with Options <a href="#option2">2</a> and <a href="#option3">3</a> but, other than that, commands like <span class="cmtt-10">\gls </span>behave as usual. -</p><!--l. 3606--><p class="indent" > This situation doesn’t cause any errors or warnings as it’s perfectly legitimate for a user to want to use +</p><!--l. 3695--><p class="indent" > This situation doesn’t cause any errors or warnings as it’s perfectly legitimate for a user to want to use <span class="cmss-10">glossaries </span>to format the entries (e.g. abbreviation expansion) but not display any lists of terms, abbreviations, symbols etc (or the user may prefer to use the unsorted Options <a @@ -8091,7 +8456,7 @@ href="#option1">1</a> or <a href="#option4">4</a> for indexing, which don’t use <span class="cmtt-10">\makeglossaries</span>. -</p><!--l. 3616--><p class="indent" > Therefore <span +</p><!--l. 3705--><p class="indent" > Therefore <span class="cmtt-10">\makeglossaries </span>can’t be used to enable <span class="cmtt-10">\newglossaryentry </span>and commands like <span class="cmtt-10">\gls </span>and @@ -8100,23 +8465,23 @@ class="cmtt-10">\glsadd</span>. These commands must be enabled by default. (It d class="cmtt-10">see</span><a id="dx1-30018"></a> key as that’s a more common problem. See below.) -</p><!--l. 3621--><p class="indent" > The debug mode, enabled with the <span +</p><!--l. 3710--><p class="indent" > The debug mode, enabled with the <span class="cmss-10">debug</span><a id="dx1-30019"></a> option, </p> - <div class="verbatim" id="verbatim-64"> + <pre class="verbatim" id="verbatim-68"> \usepackage[debug]{glossaries} -</div> -<!--l. 3624--><p class="nopar" > will write information to the log file when the indexing can’t occur because the associated file isn’t open. The +</pre> +<!--l. 3713--><p class="nopar" > will write information to the log file when the indexing can’t occur because the associated file isn’t open. The message is written in the form - </p><div class="quote"> - <!--l. 3629--><p class="noindent" >Package glossaries Info: wrglossary(⟨<span + </p><blockquote class="quote"> + <!--l. 3718--><p class="noindent" >Package glossaries Info: wrglossary(⟨<span class="cmti-10">type</span>⟩)(⟨<span class="cmti-10">text</span>⟩) on input line ⟨<span -class="cmti-10">line number</span>⟩.</p></div> -<!--l. 3632--><p class="noindent" >where ⟨<span +class="cmti-10">line number</span>⟩.</p></blockquote> +<!--l. 3721--><p class="noindent" >where ⟨<span class="cmti-10">type</span>⟩ is the glossary label and ⟨<span class="cmti-10">text</span>⟩ is the line of text that would’ve been written to the associated file if it had been open. So if any entries haven’t appeared in the glossary but you’re sure you used commands like <span @@ -8126,7 +8491,7 @@ class="cmtt-10">\glsaddall</span>, try switching on the <span class="cmss-10">debug</span><a id="dx1-30020"></a> option and see if any information has been written to the log file. -</p><!--l. 3639--><p class="noindent" > +</p><!--l. 3728--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-310002.1"></a><a @@ -8135,7 +8500,7 @@ class="cmss-10">savewrites=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3639--><p class="noindent" >This is a boolean option to minimise the number of write registers used by the <span +<!--l. 3728--><p class="noindent" >This is a boolean option to minimise the number of write registers used by the <span class="cmss-10">glossaries </span>package. The default is <span class="cmss-10">savewrites</span><span @@ -8145,7 +8510,7 @@ class="cmss-10">false</span><a href="#option2">2</a> and <a href="#option3">3</a>, one write register is required per (non-ignored) glossary and one for the style file. -</p><!--l. 3645--><p class="indent" > With all options except Options <a +</p><!--l. 3734--><p class="indent" > With all options except Options <a href="#option1">1</a> and <a href="#option4">4</a>, another write register is required if the <span class="cmtt-10">docdefs</span><a @@ -8156,7 +8521,7 @@ href="#option4">4</a>, no write registers are required (document definitions aren’t permitted and indexing information is written to the <span class="cmtt-10">aux</span><a id="dx1-31003"></a> file). If you really need document definitions -but you want to minimise the number of write registers then consider using <span id="textcolor198"><span +but you want to minimise the number of write registers then consider using <span id="textcolor199"><span class="cmss-10">docdef</span><span class="cmtt-10">=</span><span class="cmss-10">restricted</span></span><a @@ -8164,14 +8529,14 @@ class="cmss-10">restricted</span></span><a <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. -</p><!--l. 3654--><p class="indent" > There are only a limited number of write registers, and if you have a large number of glossaries +</p><!--l. 3743--><p class="indent" > There are only a limited number of write registers, and if you have a large number of glossaries or if you are using a class or other packages that create a lot of external files, you may exceed the maximum number of available registers. If <span class="cmss-10">savewrites</span><a id="dx1-31005"></a> is set, the glossary information will be stored in token registers until the end of the document when they will be written to the external 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 +</p><!--l. 3751--><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 TeX’s asynchronous output routine. As an @@ -8179,8 +8544,8 @@ 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. </div> -</p><!--l. 3668--><p class="noindent" > -</p><!--l. 3670--><p class="indent" > By way of comparison, <span +</p><!--l. 3757--><p class="noindent" > +</p><!--l. 3759--><p class="indent" > By way of comparison, <span class="cmtt-10">sample-multi2.tex </span>provided with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a @@ -8198,7 +8563,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 TeX’s <span +</p><!--l. 3769--><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 @@ -8222,15 +8587,15 @@ example: </p> - <div class="verbatim" id="verbatim-65"> + <pre class="verbatim" id="verbatim-69"> \glswritefiles - <br />\write18{makeindex -s \istfilename\space - <br />-t \jobname.glg -o \jobname.gls \jobname} - <br />\let\glswritefiles\relax -</div> -<!--l. 3692--><p class="nopar" > -</p><!--l. 3694--><p class="noindent" >In general, this package option is best avoided. -</p><!--l. 3697--><p class="noindent" > +\write18{makeindex -s \istfilename\space +-t \jobname.glg -o \jobname.gls \jobname} +\let\glswritefiles\relax +</pre> +<!--l. 3781--><p class="nopar" > +</p><!--l. 3783--><p class="noindent" >In general, this package option is best avoided. +</p><!--l. 3786--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-320002.1"></a><a @@ -8239,12 +8604,14 @@ class="cmss-10">translate=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3697--><p class="noindent" >This can take the following values: +<!--l. 3786--><p class="noindent" >This can take the following values: </p><dl class="description"><dt class="description"> + <!--l. 3789--><p class="noindent" > <span class="cmssbx-10">true</span><a - id="dx1-32001"></a> </dt><dd -class="description">If <span + id="dx1-32001"></a> </p></dt><dd +class="description"> + <!--l. 3789--><p class="noindent" >If <span class="cmss-10">babel</span><a id="dx1-32002"></a> has been loaded and the <span class="cmss-10">translator</span><a @@ -8271,11 +8638,13 @@ class="cmss-10">polyglossia</span><a class="cmss-10">glossaries-polyglossia</span><a id="dx1-32010"></a> will be loaded. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 3801--><p class="noindent" > <span class="cmssbx-10">false</span><a - id="dx1-32011"></a> </dt><dd -class="description">Don’t provide translations, even if <span + id="dx1-32011"></a> </p></dt><dd +class="description"> + <!--l. 3801--><p class="noindent" >Don’t provide translations, even if <span class="cmss-10">babel</span><a id="dx1-32012"></a> or <span class="cmss-10">polyglossia</span><a @@ -8287,16 +8656,18 @@ class="cmtt-10">\glossaryname</span><a id="dx1-32015"></a> so that will still be translated if you have loaded <span class="cmss-10">babel</span><a id="dx1-32016"></a>.) - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 3806--><p class="noindent" > <span class="cmssbx-10">babel</span><a - id="dx1-32017"></a> </dt><dd -class="description">Don’t load the <span + id="dx1-32017"></a> </p></dt><dd +class="description"> + <!--l. 3806--><p class="noindent" >Don’t load the <span class="cmss-10">translator</span><a id="dx1-32018"></a> package. Instead load <span class="cmss-10">glossaries-babel</span><a id="dx1-32019"></a>. - <!--l. 3720--><p class="noindent" ><div class="important" title="Important Note"> I recommend you use <span + </p><!--l. 3809--><p class="noindent" ><div class="important" title="Important Note"> I recommend you use <span class="cmss-10">translate</span><span class="cmtt-10">=</span><span class="cmss-10">babel</span><a @@ -8309,10 +8680,12 @@ class="cmtt-10">=</span><span class="cmss-10">true</span><a id="dx1-32022"></a>. </div> - </p><!--l. 3725--><p class="noindent" > + </p><!--l. 3814--><p class="noindent" > + + </p> </dd></dl> -<!--l. 3729--><p class="indent" > If <span +<!--l. 3818--><p class="indent" > If <span class="cmss-10">translate</span><a id="dx1-32023"></a> is specified without a value, <span class="cmss-10">translate</span><span @@ -8337,7 +8710,7 @@ class="cmtt-10">=</span><span class="cmss-10">false</span><a id="dx1-32030"></a> is assumed. -</p><!--l. 3735--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a +</p><!--l. 3824--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, if <span class="cmss-10">babel</span><a @@ -8349,24 +8722,23 @@ class="cmss-10">babel</span><a class="cmss-10">glossaries</span><a id="dx1-32033"></a> package. </div> - - -</p><!--l. 3739--><p class="noindent" > -</p><!--l. 3741--><p class="indent" > See <a -href="#sec:fixednames">§1.3.1 </a><a +</p><!--l. 3828--><p class="noindent" > +</p><!--l. 3830--><p class="indent" > See <a +href="#sec:fixednames">§<span +class="cmbx-10">??</span>sec:fixednames </a><a href="#sec:fixednames">Changing the Fixed Names<!--tex4ht:ref: sec:fixednames --></a> for further details. -</p><!--l. 3743--><p class="noindent" > +</p><!--l. 3832--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-330002.1"></a><a id="pkgopt:notranslate"></a><span class="cmss-10">notranslate</span></h4> -<!--l. 3743--><p class="noindent" >This is equivalent to <span +<!--l. 3832--><p class="noindent" >This is equivalent to <span class="cmss-10">translate</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a id="dx1-33001"></a> and may be passed via the document class options. -</p><!--l. 3747--><p class="noindent" > +</p><!--l. 3836--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-340002.1"></a><a @@ -8375,7 +8747,7 @@ class="cmss-10">hyperfirst=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3747--><p class="noindent" >This is a boolean option that specifies whether each term has a hyperlink on <a +<!--l. 3836--><p class="noindent" >This is a boolean option that specifies whether each term has a hyperlink on <a href="#glo:firstuse">first use</a>. The default is <span class="cmss-10">hyperfirst</span><span @@ -8410,7 +8782,7 @@ class="cmtt-10">\glslink</span><a id="dx1-34008"></a> or <span class="cmtt-10">\glstext</span><a id="dx1-34009"></a>). -</p><!--l. 3759--><p class="indent" > The <span +</p><!--l. 3848--><p class="indent" > The <span class="cmss-10">hyperfirst</span><a id="dx1-34010"></a> setting applies to all glossary types (unless identified by <span class="cmss-10">nohypertypes</span><a @@ -8422,7 +8794,7 @@ class="cmtt-10">\newignoredglossary</span><a class="cmtt-10">hyper</span><a id="dx1-34013"></a> key when referencing an entry (or by using the plus or starred version of the referencing command). -</p><!--l. 3766--><p class="indent" > It may be that you only want to apply this to just the acronyms (where the first use explains the meaning of +</p><!--l. 3855--><p class="indent" > It may be that you only want to apply this to just the acronyms (where the first use explains the meaning of the acronym) but not for ordinary glossary entries (where the first use is identical to subsequent uses). In this case, you can use <span class="cmss-10">hyperfirst</span><span @@ -8434,18 +8806,18 @@ example: </p> - <div class="verbatim" id="verbatim-66"> + <pre class="verbatim" id="verbatim-70">  \usepackage[acronym,hyperfirst=false]{glossaries} - <br /> % acronym and glossary entry definitions - <br /> % at the end of the preamble - <br /> \glsunsetall[main] -</div> -<!--l. 3778--><p class="nopar" > -</p><!--l. 3780--><p class="indent" > Alternatively you can redefine the hook -</p><!--l. 3781--><p class="indent" > <hr><div title="Definition"><a + % acronym and glossary entry definitions + % at the end of the preamble + \glsunsetall[main] +</pre> +<!--l. 3867--><p class="nopar" > +</p><!--l. 3869--><p class="indent" > Alternatively you can redefine the hook +</p><!--l. 3870--><p class="indent" > <hr><div title="Definition"><a id="dx1-34015"></a> <span class="cmtt-10">\glslinkcheckfirsthyperhook </span></div><hr> -</p><!--l. 3783--><p class="noindent" > +</p><!--l. 3872--><p class="noindent" > which is used by the commands that check the <a href="#glo:firstuseflag">first use flag</a>, such as <span class="cmtt-10">\gls</span><a @@ -8467,16 +8839,16 @@ just for acronyms: </p> - <div class="verbatim" id="verbatim-67"> + <pre class="verbatim" id="verbatim-71"> \renewcommand*{\glslinkcheckfirsthyperhook}{% - <br /> \ifglsused{\glslabel}{}% - <br /> {% - <br />   \ifglshaslong{\glslabel}{\setkeys{glslink}{hyper=false}}{}% - <br /> }% - <br />} -</div> -<!--l. 3799--><p class="nopar" > -</p><!--l. 3801--><p class="indent" > Note that this hook isn’t used by the commands that don’t check the <a + \ifglsused{\glslabel}{}% + {% +   \ifglshaslong{\glslabel}{\setkeys{glslink}{hyper=false}}{}% + }% +} +</pre> +<!--l. 3888--><p class="nopar" > +</p><!--l. 3890--><p class="indent" > Note that this hook isn’t used by the commands that don’t check the <a href="#glo:firstuseflag">first use flag</a>, such as <span class="cmtt-10">\glstext</span><a @@ -8488,13 +8860,13 @@ class="cmtt-10">\gls</span>-like</a> and <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands.) -</p><!--l. 3806--><p class="indent" > The <a +</p><!--l. 3895--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides a method of disabling the <a href="#glo:firstuse">first use</a> hyperlink according to the entry’s associated category. For example, if you only to switch off the <a href="#glo:firstuse">first use</a> hyperlink for abbreviations and -acronyms then you simply need to set the <span id="textcolor199"><span +acronyms then you simply need to set the <span id="textcolor200"><span class="cmss-10">nohyperfirst</span></span><a id="dx1-34024"></a> attribute for the <span class="cmtt-10">abbreviation </span>and <span @@ -8505,389 +8877,413 @@ class="cmss-10">nohyperfirst</span><a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. -</p><!--l. 3815--><p class="noindent" > +</p><!--l. 3904--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a id="x1-350002.1"></a><a id="pkgopt:writeglslabels"></a><span class="cmss-10">writeglslabels</span></h4> -<!--l. 3815--><p class="noindent" >This is a valueless option that will create a file called <span +<!--l. 3904--><p class="noindent" >This is a valueless option that will create a file called <span class="cmtt-10">\jobname.glslabels</span><a id="dx1-35001"></a> at the end of the document. This file simply contains a list of all defined entry labels (including those in any ignored glossaries). It’s provided for the benefit of text editors that need to know labels for auto-completion<a - id="dx1-35002"></a>. (See also <a + id="dx1-35002"></a>. If you also want the name, use +<span +class="cmss-10">writeglslabelnames</span><a + id="dx1-35003"></a>. (See also <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span>’s</a> <span id="textcolor200"><span +class="cmss-10">glossaries-extra</span>’s</a> <span id="textcolor201"><span class="cmss-10">docdef</span><span class="cmtt-10">=</span><span class="cmss-10">atom</span></span><a - id="dx1-35003"></a> -package option.) -</p><!--l. 3823--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> Note that with <a + id="dx1-35004"></a> package option.) +</p><!--l. 3913--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> Note that with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-35004"></a></a> the file will only contain the entries that <a + id="dx1-35005"></a></a> the file will only contain the entries that <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-35005"></a></a> has selected from the <span + id="dx1-35006"></a></a> has selected from the <span class="cmtt-10">bib</span><a - id="dx1-35006"></a> files. + id="dx1-35007"></a> files. </div> -</p><!--l. 3826--><p class="noindent" > -</p><!--l. 3828--><p class="noindent" > +</p><!--l. 3916--><p class="noindent" > +</p><!--l. 3918--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-360002.1"></a><span id="textcolor201"><a - id="pkgopt:undefaction"></a><span id="textcolor202"><span + id="x1-360002.1"></a><a + id="pkgopt:writeglslabelnames"></a><span +class="cmss-10">writeglslabelnames</span></h4> +<!--l. 3918--><p class="noindent" >Similar to the above but writes both the label and name (separated by a tab). +</p><!--l. 3921--><p class="noindent" > +</p> + <h4 class="likesubsectionHead"><a + id="x1-370002.1"></a><span id="textcolor202"><a + id="pkgopt:undefaction"></a><span id="textcolor203"><span class="cmss-10">undefaction</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 3830--><p class="noindent" >The value may be one of: +<!--l. 3923--><p class="noindent" >The value may be one of: + + </p><dl class="description"><dt class="description"> + <!--l. 3925--><p class="noindent" > <span -class="cmssbx-10">error</span> </dt><dd -class="description">generate an error if a referenced entry is undefined (default, and only available setting with just - <span +class="cmssbx-10">error</span> </p></dt><dd +class="description"> + <!--l. 3925--><p class="noindent" >generate an error if a referenced entry is undefined (default, and the only available setting with + just <span class="cmss-10">glossaries</span>); - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 3928--><p class="noindent" > <span -class="cmssbx-10">warn</span> </dt><dd -class="description">only warn if a referenced entry is undefined (automatically activated with <a -href="#option4">Option 4</a>).</dd></dl> - - -<!--l. 3839--><p class="noindent" > +class="cmssbx-10">warn</span> </p></dt><dd +class="description"> + <!--l. 3928--><p class="noindent" >only warn if a referenced entry is undefined (automatically activated with <a +href="#option4">Option 4</a>).</p></dd></dl> +<!--l. 3932--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-370002.1"></a><span id="textcolor203"><a - id="pkgopt:docdef"></a><span id="textcolor204"><span + id="x1-380002.1"></a><span id="textcolor204"><a + id="pkgopt:docdef"></a><span id="textcolor205"><span class="cmss-10">docdef</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 3841--><p class="noindent" >This option governs the use of <span +<!--l. 3934--><p class="noindent" >This option governs the use of <span class="cmtt-10">\newglossaryentry</span>. Available values: </p><dl class="description"><dt class="description"> + <!--l. 3937--><p class="noindent" > <span -class="cmssbx-10">false</span> </dt><dd -class="description"><span +class="cmssbx-10">false</span> </p></dt><dd +class="description"> + <!--l. 3937--><p class="noindent" ><span class="cmtt-10">\newglossaryentry </span>is not permitted in the <span class="cmss-10">document</span><a - id="dx1-37001"></a><a - id="dx1-37002"></a> environment (default with <a + id="dx1-38001"></a><a + id="dx1-38002"></a> environment (default with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> and for <a href="#option1">Option 1</a> with just the base <span class="cmss-10">glossaries </span>package); - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 3941--><p class="noindent" > <span -class="cmssbx-10">restricted</span> </dt><dd -class="description"><span +class="cmssbx-10">restricted</span> </p></dt><dd +class="description"> + <!--l. 3941--><p class="noindent" ><span class="cmtt-10">\newglossaryentry </span>is only permitted in the <span class="cmss-10">document</span><a - id="dx1-37003"></a><a - id="dx1-37004"></a> environment if it occurs before + id="dx1-38003"></a><a + id="dx1-38004"></a> environment if it occurs before <span class="cmtt-10">\printglossary </span>(not available for some indexing options); - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 3945--><p class="noindent" > <span -class="cmssbx-10">atom</span> </dt><dd -class="description">as <span +class="cmssbx-10">atom</span> </p></dt><dd +class="description"> + <!--l. 3945--><p class="noindent" >as <span class="cmss-10">restricted </span>but creates the <span class="cmtt-10">docdefs</span><a - id="dx1-37005"></a> file for use by <span + id="dx1-38005"></a> file for use by <span class="cmtt-10">atom</span><a - id="dx1-37006"></a> (without the limitations of <span id="textcolor205"><span + id="dx1-38006"></a> (without the limitations of <span id="textcolor206"><span class="cmss-10">docdef</span><span class="cmtt-10">=</span><span class="cmss-10">true</span></span><a - id="dx1-37007"></a>); - </dd><dt class="description"> + id="dx1-38007"></a>); + </p></dd><dt class="description"> + <!--l. 3949--><p class="noindent" > <span -class="cmssbx-10">true</span> </dt><dd -class="description"><span +class="cmssbx-10">true</span> </p></dt><dd +class="description"> + <!--l. 3949--><p class="noindent" ><span class="cmtt-10">\newglossaryentry </span>is permitted in the <span class="cmss-10">document</span><a - id="dx1-37008"></a><a - id="dx1-37009"></a> environment where it would normally be + id="dx1-38008"></a><a + id="dx1-38009"></a> environment where it would normally be permitted by the base <span class="cmss-10">glossaries </span>package. This will create the <span class="cmtt-10">docdefs</span><a - id="dx1-37010"></a> file if <span + id="dx1-38010"></a> file if <span class="cmtt-10">\newglossaryentry</span> is found in the <span class="cmss-10">document</span><a - id="dx1-37011"></a><a - id="dx1-37012"></a> environment.</dd></dl> -<!--l. 3863--><p class="noindent" > + id="dx1-38011"></a><a + id="dx1-38012"></a> environment.</p></dd></dl> + + +<!--l. 3956--><p class="noindent" > </p> -<!--l. 3863--><p class="noindent" ><a +<!--l. 3956--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.2 </span> <a id="sec:pkgopts-sec"></a>Sectioning, Headings and TOC Options</h3> -<!--l. 3866--><p class="noindent" > +<!--l. 3959--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-390002.2"></a><a + id="x1-400002.2"></a><a id="pkgopt:toc"></a><span 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 LaTeX run is required with this option. +<!--l. 3959--><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 +</p><!--l. 3962--><p class="indent" > <hr><div title="Definition"><a + id="dx1-40001"></a> <span class="cmtt-10">\glstoctrue </span></div><hr> -</p><!--l. 3871--><p class="noindent" > +</p><!--l. 3964--><p class="noindent" > and -</p><!--l. 3873--><p class="indent" > <hr><div title="Definition"><a - id="dx1-39002"></a> <span +</p><!--l. 3966--><p class="indent" > <hr><div title="Definition"><a + id="dx1-40002"></a> <span class="cmtt-10">\glstocfalse </span></div><hr> -</p><!--l. 3875--><p class="noindent" > +</p><!--l. 3968--><p class="noindent" > The default value is <span class="cmss-10">toc</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-39003"></a> for the base <span + id="dx1-40003"></a> for the base <span class="cmss-10">glossaries </span>package and <span class="cmss-10">toc</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-39004"></a> for <a + id="dx1-40004"></a> for <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. -</p><!--l. 3880--><p class="noindent" > +</p><!--l. 3973--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-400002.2"></a><a + id="x1-410002.2"></a><a id="pkgopt:numberline"></a><span class="cmss-10">numberline=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> - - -<!--l. 3880--><p class="noindent" >When used with the above <span +<!--l. 3973--><p class="noindent" >When used with the above <span class="cmss-10">toc</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-40001"></a> option, this will add <span + id="dx1-41001"></a> option, this will add <span class="cmtt-10">\numberline</span><a - id="dx1-40002"></a><span class="obeylines-h"><span class="verb"><span + id="dx1-41002"></a><span class="obeylines-h"><span class="verb"><span class="cmtt-10">{}</span></span></span> in the final argument of <span class="cmtt-10">\addcontentsline</span><a - id="dx1-40003"></a>. This will align the table of contents entry with the numbered section titles. Note that this + id="dx1-41003"></a>. This will align the table of contents entry with the numbered section titles. Note that this option has no effect if the <span class="cmss-10">toc</span><a - id="dx1-40004"></a> option is omitted. If <span + id="dx1-41004"></a> option is omitted. If <span class="cmss-10">toc</span><a - id="dx1-40005"></a> is used without <span + id="dx1-41005"></a> is used without <span class="cmss-10">numberline</span><a - id="dx1-40006"></a>, the title will be aligned with + id="dx1-41006"></a>, the title will be aligned with the section numbers rather than the section titles. -</p><!--l. 3889--><p class="noindent" > +</p><!--l. 3982--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-410002.2"></a><a + id="x1-420002.2"></a><a id="pkgopt:section"></a><span class="cmss-10">section=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3891--><p class="noindent" >This option indicates the sectional unit to use for the glossary. The value should be the control +<!--l. 3984--><p class="noindent" >This option indicates the sectional unit to use for the glossary. The value should be the control sequence <span class="cmti-10">name </span>without the leading backslash or following star (e.g. just <span class="cmtt-10">chapter </span>not <span class="cmtt-10">\chapter </span>or <span class="cmtt-10">chapter*</span>). -</p><!--l. 3896--><p class="indent" > The default behaviour is for the glossary heading to use <span +</p><!--l. 3989--><p class="indent" > The default behaviour is for the glossary heading to use <span class="cmtt-10">\chapter</span>, if that command exists, or <span class="cmtt-10">\section</span> otherwise. The starred or unstarred form is determined by the <span class="cmss-10">numberedsection</span><a - id="dx1-41001"></a> option. -</p><!--l. 3900--><p class="indent" > Example: + id="dx1-42001"></a> option. +</p><!--l. 3993--><p class="indent" > Example: </p> - <div class="verbatim" id="verbatim-68"> + <pre class="verbatim" id="verbatim-72"> \usepackage[section=subsection]{glossaries} -</div> -<!--l. 3903--><p class="nopar" > You can omit the value if you want to use <span +</pre> +<!--l. 3996--><p class="nopar" > You can omit the value if you want to use <span class="cmtt-10">\section</span>, i.e.  </p> - <div class="verbatim" id="verbatim-69"> + <pre class="verbatim" id="verbatim-73"> \usepackage[section]{glossaries} -</div> -<!--l. 3907--><p class="nopar" > is equivalent to +</pre> +<!--l. 4000--><p class="nopar" > is equivalent to </p> - <div class="verbatim" id="verbatim-70"> + <pre class="verbatim" id="verbatim-74"> \usepackage[section=section]{glossaries} -</div> -<!--l. 3911--><p class="nopar" > You can change this value later in the document using -</p><!--l. 3913--><p class="indent" > <hr><div title="Definition"><a - id="dx1-41002"></a> <span +</pre> +<!--l. 4004--><p class="nopar" > You can change this value later in the document using +</p><!--l. 4006--><p class="indent" > <hr><div title="Definition"><a + id="dx1-42002"></a> <span class="cmtt-10">\setglossarysection{</span>⟨<span class="cmitt-10">name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3915--><p class="noindent" > +</p><!--l. 4008--><p class="noindent" > where ⟨<span class="cmti-10">name</span>⟩ is the sectional unit. -</p><!--l. 3918--><p class="indent" > The start of each glossary adds information to the page header via -</p><!--l. 3919--><p class="indent" > <hr><div title="Definition"><a - id="dx1-41003"></a> <span +</p><!--l. 4011--><p class="indent" > The start of each glossary adds information to the page header via +</p><!--l. 4012--><p class="indent" > <hr><div title="Definition"><a + id="dx1-42003"></a> <span class="cmtt-10">\glsglossarymark{</span>⟨<span class="cmitt-10">glossary title</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 3921--><p class="noindent" > +</p><!--l. 4014--><p class="noindent" > By default this uses <span class="cmtt-10">\@mkboth</span><span class="footnote-mark"><a href="#fn2x2" id="fn2x2-bk"><sup class="textsuperscript">2.2</sup></a></span><a - id="x1-41004f2"></a> + id="x1-42004f2"></a> but you may need to redefine it. For example, to only change the right header: </p> - <div class="verbatim" id="verbatim-71"> + <pre class="verbatim" id="verbatim-75"> \renewcommand{\glsglossarymark}[1]{\markright{#1}} -</div> -<!--l. 3928--><p class="nopar" > or to prevent it from changing the headers: +</pre> +<!--l. 4021--><p class="nopar" > or to prevent it from changing the headers: </p> - <div class="verbatim" id="verbatim-72"> + <pre class="verbatim" id="verbatim-76"> \renewcommand{\glsglossarymark}[1]{} -</div> -<!--l. 3932--><p class="nopar" > If you want <span +</pre> +<!--l. 4025--><p class="nopar" > If you want <span class="cmtt-10">\glsglossarymark </span>to use <span class="cmtt-10">\MakeUppercase </span>in the header, use the <span class="cmss-10">ucmark</span><a - id="dx1-41007"></a> option described + id="dx1-42007"></a> option described below. -</p><!--l. 3936--><p class="indent" > Occasionally you may find that another package defines <span +</p><!--l. 4029--><p class="indent" > Occasionally you may find that another package defines <span class="cmtt-10">\cleardoublepage </span>when it is not required. This may cause an unwanted blank page to appear before each glossary. This can be fixed by redefining <a - id="dx1-41008"></a><span + id="dx1-42008"></a><span class="cmtt-10">\glsclearpage</span>: </p> - <div class="verbatim" id="verbatim-73"> + <pre class="verbatim" id="verbatim-77"> \renewcommand*{\glsclearpage}{\clearpage} -</div> -<!--l. 3942--><p class="nopar" > -</p><!--l. 3944--><p class="noindent" > +</pre> +<!--l. 4035--><p class="nopar" > +</p><!--l. 4037--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-420002.2"></a><a + id="x1-430002.2"></a><a id="pkgopt:ucmark"></a><span class="cmss-10">ucmark=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3944--><p class="noindent" >This is a boolean option. The default is <span +<!--l. 4037--><p class="noindent" >This is a boolean option. The default is <span class="cmss-10">ucmark</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-42001"></a>, unless <span + id="dx1-43001"></a>, unless <span class="cmss-10">memoir</span><a - id="dx1-42002"></a> has been loaded, in which case the default + id="dx1-43002"></a> has been loaded, in which case the default is <span class="cmss-10">ucmark</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-42003"></a>. -</p><!--l. 3948--><p class="indent" > If set, <span + id="dx1-43003"></a>. +</p><!--l. 4041--><p class="indent" > If set, <span class="cmtt-10">\glsglossarymark</span><a - id="dx1-42004"></a> uses + id="dx1-43004"></a> uses <span class="cmtt-10">\MakeTextUppercase</span><a - id="dx1-42005"></a><span class="footnote-mark"><a + id="dx1-43005"></a><span class="footnote-mark"><a href="#fn3x2" id="fn3x2-bk"><sup class="textsuperscript">2.3</sup></a></span><a - id="x1-42006f3"></a>. + id="x1-43006f3"></a>. You can test whether this option has been set or not using -</p><!--l. 3957--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 4050--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\ifglsucmark</span><a - id="dx1-42011"></a> ⟨<span + id="dx1-43011"></a> ⟨<span class="cmitt-10">true part</span>⟩<span class="cmtt-10">\else </span>⟨<span class="cmitt-10">false part</span>⟩<span class="cmtt-10">\fi </span></div><hr> -</p><!--l. 3958--><p class="noindent" > +</p><!--l. 4051--><p class="noindent" > For example: </p> - <div class="verbatim" id="verbatim-74"> + <pre class="verbatim" id="verbatim-78"> \renewcommand{\glsglossarymark}[1]{% - <br />  \ifglsucmark - <br />    \markright{\MakeTextUppercase{#1}}% - <br />  \else - <br />    \markright{#1}% - <br />  \fi} -</div> -<!--l. 3967--><p class="nopar" > If <span +  \ifglsucmark +    \markright{\MakeTextUppercase{#1}}% +  \else +    \markright{#1}% +  \fi} +</pre> +<!--l. 4060--><p class="nopar" > If <span class="cmss-10">memoir</span><a - id="dx1-42012"></a> has been loaded and <span + id="dx1-43012"></a> has been loaded and <span class="cmss-10">ucmark</span><a - id="dx1-42013"></a> is set, then <span + id="dx1-43013"></a> is set, then <span class="cmss-10">memoir</span><a - id="dx1-42014"></a>’s <span + id="dx1-43014"></a>’s <span class="cmtt-10">\memUChead</span><a - id="dx1-42015"></a> is used. -</p><!--l. 3971--><p class="noindent" > + id="dx1-43015"></a> is used. +</p><!--l. 4064--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-430002.2"></a><a + id="x1-440002.2"></a><a id="pkgopt:numberedsection"></a><span class="cmss-10">numberedsection=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 3972--><p class="noindent" >The glossaries are placed in unnumbered sectional units by default, but this can be changed using +<!--l. 4065--><p class="noindent" >The glossaries are placed in unnumbered sectional units by default, but this can be changed using <span class="cmss-10">numberedsection</span><a - id="dx1-43001"></a>. This option can take one of the following values: </p> + id="dx1-44001"></a>. This option can take one of the following values: </p> <ul class="itemize1"> - <li class="itemize"><span + <li class="itemize"> + <!--l. 4069--><p class="noindent" ><span class="cmss-10">false</span><a - id="dx1-43002"></a>: no number, i.e. use starred form of sectioning command (e.g. <span + id="dx1-44002"></a>: no number, i.e. use starred form of sectioning command (e.g. <span class="cmtt-10">\chapter* </span>or <span class="cmtt-10">\section*</span>); - </li> - <li class="itemize"><span + </p></li> + <li class="itemize"> + <!--l. 4072--><p class="noindent" ><span class="cmss-10">nolabel</span><a - id="dx1-43003"></a>: use a numbered section, i.e. the unstarred form of sectioning command (e.g. <span + id="dx1-44003"></a>: use a numbered section, i.e. the unstarred form of sectioning command (e.g. <span class="cmtt-10">\chapter </span>or <span class="cmtt-10">\section</span>), but the section not labelled; - </li> - <li class="itemize"><span + </p></li> + <li class="itemize"> + <!--l. 4077--><p class="noindent" ><span class="cmss-10">autolabel</span><a - id="dx1-43004"></a>: numbered with automatic labelling. Each glossary uses the unstarred form of a sectioning + id="dx1-44004"></a>: numbered with automatic labelling. Each glossary uses the unstarred form of a sectioning command (e.g. <span class="cmtt-10">\chapter </span>or <span class="cmtt-10">\section</span>) and is assigned a label (via <span class="cmtt-10">\label</span><a - id="dx1-43005"></a>). The label is formed + id="dx1-44005"></a>). The label is formed from - <!--l. 3988--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-43006"></a> <span + </p><!--l. 4081--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-44006"></a> <span class="cmtt-10">\glsautoprefix </span>⟨<span class="cmitt-10">type</span>⟩ </div><hr> - </p><!--l. 3990--><p class="noindent" > + </p><!--l. 4083--><p class="noindent" > where ⟨<span class="cmti-10">type</span>⟩ is the label identifying that glossary. The default value of <span class="cmtt-10">\glsautoprefix </span>is empty. For @@ -8896,167 +9292,170 @@ class="cmss-10">glossaries </span>using: </p> - <div class="verbatim" id="verbatim-75"> + <pre class="verbatim" id="verbatim-79"> \usepackage[section,numberedsection=autolabel] -  <br />  {glossaries} -</div> - <!--l. 3998--><p class="nopar" > then each glossary will appear in a numbered section, and can be referenced using something +   {glossaries} +</pre> + <!--l. 4091--><p class="nopar" > then each glossary will appear in a numbered section, and can be referenced using something like: </p> - <div class="verbatim" id="verbatim-76"> + <pre class="verbatim" id="verbatim-80"> The main glossary is in section~\ref{main} and -  <br />the list of acronyms is in section~\ref{acronym}. -</div> - <!--l. 4004--><p class="nopar" > If you can’t decide whether to have the acronyms in the main glossary or a separate list of acronyms, you + the list of acronyms is in section~\ref{acronym}. +</pre> + <!--l. 4097--><p class="nopar" > If you can’t decide whether to have the acronyms in the main glossary or a separate list of acronyms, you can use <span class="cmtt-10">\acronymtype</span><a - id="dx1-43007"></a> which is set to <span + id="dx1-44007"></a> which is set to <span class="cmtt-10">main </span>if the <span class="cmss-10">acronym</span><a - id="dx1-43008"></a> option is not used and is set to <span + id="dx1-44008"></a> option is not used and is set to <span class="cmtt-10">acronym </span>if the <span class="cmss-10">acronym</span><a - id="dx1-43009"></a> option is used. For example: + id="dx1-44009"></a> option is used. For example: </p> - <div class="verbatim" id="verbatim-77"> + <pre class="verbatim" id="verbatim-81"> The list of acronyms is in section~\ref{\acronymtype}. -</div> - <!--l. 4012--><p class="nopar" > You can redefine the prefix if the default label clashes with another label in your document. For +</pre> + <!--l. 4105--><p class="nopar" > You can redefine the prefix if the default label clashes with another label in your document. For example: </p> - <div class="verbatim" id="verbatim-78"> + <pre class="verbatim" id="verbatim-82"> \renewcommand*{\glsautoprefix}{glo:} -</div> - <!--l. 4018--><p class="nopar" > will add <span +</pre> + <!--l. 4111--><p class="nopar" > will add <span class="cmtt-10">glo: </span>to the automatically generated label, so you can then, for example, refer to the list of acronyms as follows: </p> - <div class="verbatim" id="verbatim-79"> + <pre class="verbatim" id="verbatim-83"> The list of acronyms is in -  <br />section~\ref{glo:\acronymtype}. -</div> - <!--l. 4024--><p class="nopar" > Or, if you are undecided on a prefix: + section~\ref{glo:\acronymtype}. +</pre> + <!--l. 4117--><p class="nopar" > Or, if you are undecided on a prefix: </p> - <div class="verbatim" id="verbatim-80"> + <pre class="verbatim" id="verbatim-84"> The list of acronyms is in -  <br />section~\ref{\glsautoprefix\acronymtype}. -</div> - <!--l. 4029--><p class="nopar" > + section~\ref{\glsautoprefix\acronymtype}. +</pre> + <!--l. 4122--><p class="nopar" > </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 4124--><p class="noindent" ><span class="cmss-10">nameref</span><a - id="dx1-43010"></a>: this is like <span + id="dx1-44010"></a>: this is like <span class="cmss-10">autolabel</span><a - id="dx1-43011"></a> but uses an unnumbered sectioning command (e.g. <span + id="dx1-44011"></a> but uses an unnumbered sectioning command (e.g. <span class="cmtt-10">\chapter*</span><a - id="dx1-43012"></a> or + id="dx1-44012"></a> or <span class="cmtt-10">\section*</span><a - id="dx1-43013"></a>). It’s designed for use with the <span + id="dx1-44013"></a>). It’s designed for use with the <span class="cmss-10">nameref</span><a - id="dx1-43014"></a> package. For example: + id="dx1-44014"></a> package. For example: - <div class="verbatim" id="verbatim-81"> +</p> + <pre class="verbatim" id="verbatim-85"> \usepackage{nameref} -  <br />\usepackage[numberedsection=nameref]{glossaries} -</div> - <!--l. 4038--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span + \usepackage[numberedsection=nameref]{glossaries} +</pre> + <!--l. 4131--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\nameref{main}</span></span></span> will display the (TOC) section title associated with the <span class="cmtt-10">main </span>glossary. As above, you can redefine <span class="cmtt-10">\glsautoprefix </span>to provide a prefix for the label.</p></li></ul> -<!--l. 4044--><p class="noindent" > +<!--l. 4137--><p class="noindent" > </p> -<!--l. 4044--><p class="noindent" ><a +<!--l. 4137--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.3 </span> <a id="sec:pkgopts-printglos"></a>Glossary Appearance Options</h3> -<!--l. 4047--><p class="noindent" > +<!--l. 4140--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-450002.3"></a><a + id="x1-460002.3"></a><a id="pkgopt:savenumberlist"></a><span class="cmss-10">savenumberlist=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4047--><p class="noindent" >This is a boolean option that specifies whether or not to gather and store the <a +<!--l. 4140--><p class="noindent" >This is a boolean option that specifies whether or not to gather and store the <a href="#glo:numberlist">number list<a - id="dx1-45001"></a></a> for each entry. The + id="dx1-46001"></a></a> for each entry. The default is <span class="cmss-10">savenumberlist</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-45002"></a>. (See <span + id="dx1-46002"></a>. (See <span class="cmtt-10">\glsentrynumberlist</span><a - id="dx1-45003"></a> and <span + id="dx1-46003"></a> and <span class="cmtt-10">\glsdisplaynumberlist</span><a - id="dx1-45004"></a> in <a -href="#sec:glsnolink">§9 </a><a -href="#sec:glsnolink">Using Glossary -Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>.) This is always true if you use <a + id="dx1-46004"></a> in <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink +</a><a +href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>.) This is always true if you use <a href="#option1">Option 1</a>. -</p><!--l. 4054--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you use the <span id="textcolor206"><span +</p><!--l. 4147--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you use the <span id="textcolor207"><span class="cmss-10">record</span></span><a - id="dx1-45005"></a> option (with either no value or <span id="textcolor207"><span + id="dx1-46005"></a> option (with either no value or <span id="textcolor208"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">only</span></span><a - id="dx1-45006"></a> or <span id="textcolor208"><span + id="dx1-46006"></a> or <span id="textcolor209"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-45007"></a>) then this package option + id="dx1-46007"></a>) then this package option has no effect. With <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-45008"></a></a>, the <a + id="dx1-46008"></a></a>, the <a href="#glo:numberlist">number list<a - id="dx1-45009"></a>s</a> are automatically saved with the default <span id="textcolor209"><span + id="dx1-46009"></a>s</a> are automatically saved with the default <span id="textcolor210"><span class="cmtt-10">save-locations</span></span><span class="cmtt-10">=true</span><a - id="dx1-45010"></a> -and <span id="textcolor210"><span + id="dx1-46010"></a> +and <span id="textcolor211"><span class="cmtt-10">save-loclist</span></span><span class="cmtt-10">=true</span><a - id="dx1-45011"></a> resource settings. </div> -</p><!--l. 4061--><p class="noindent" > -</p><!--l. 4063--><p class="noindent" > + id="dx1-46011"></a> resource settings. </div> +</p><!--l. 4154--><p class="noindent" > +</p><!--l. 4156--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-460002.3"></a><a + id="x1-470002.3"></a><a id="pkgopt:entrycounter"></a><span class="cmss-10">entrycounter=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4063--><p class="noindent" >This is a boolean option. (Default is <span +<!--l. 4156--><p class="noindent" >This is a boolean option. (Default is <span class="cmss-10">entrycounter</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-46001"></a>.) If set, each main (level 0) glossary entry will be + id="dx1-47001"></a>.) If set, each main (level 0) glossary entry will be numbered when using the standard glossary styles. This option creates the counter <a - id="dx1-46002"></a><a - id="dx1-46003"></a><span + id="dx1-47002"></a><a + id="dx1-47003"></a><span class="cmss-10">glossaryentry</span>. -</p><!--l. 4069--><p class="indent" > If you use this option, you can reference the entry number within the document using -</p><!--l. 4071--><p class="indent" > <hr><div title="Definition"><a - id="dx1-46004"></a> <span +</p><!--l. 4162--><p class="indent" > If you use this option, you can reference the entry number within the document using +</p><!--l. 4164--><p class="indent" > <hr><div title="Definition"><a + id="dx1-47004"></a> <span class="cmtt-10">\glsrefentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 4073--><p class="noindent" > +</p><!--l. 4166--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the label associated with that glossary entry. The labelling systems uses ⟨<span class="cmti-10">prefix</span>⟩⟨<span @@ -9064,37 +9463,37 @@ class="cmti-10">label</span>⟩, where ⟨<span class="cmti-10">label</span>⟩ is the entry’s label and ⟨<span class="cmti-10">prefix</span>⟩ is given by -</p><!--l. 4077--><p class="indent" > <hr><div title="Definition"><a - id="dx1-46005"></a> <span +</p><!--l. 4170--><p class="indent" > <hr><div title="Definition"><a + id="dx1-47005"></a> <span class="cmtt-10">\GlsEntryCounterLabelPrefix </span></div><hr> -</p><!--l. 4079--><p class="noindent" > +</p><!--l. 4172--><p class="noindent" > (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 + + +</p><!--l. 4175--><p class="indent" > <div class="important" title="Important Note"> If you use <span 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 - id="dx1-46006"></a></a>, <a + id="dx1-47006"></a></a>, <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-46007"></a></a> or <a + id="dx1-47007"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-46008"></a></a> to ensure the cross-references are up-to-date. </div> - - -</p><!--l. 4087--><p class="noindent" > -</p><!--l. 4089--><p class="noindent" > + id="dx1-47008"></a></a> to ensure the cross-references are up-to-date. </div> +</p><!--l. 4180--><p class="noindent" > +</p><!--l. 4182--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-470002.3"></a><a + id="x1-480002.3"></a><a id="pkgopt:counterwithin"></a><span class="cmss-10">counterwithin=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4089--><p class="noindent" >This is a ⟨<span +<!--l. 4182--><p class="noindent" >This is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ option where ⟨<span class="cmti-10">value</span>⟩ is the name of a counter. If used, this option will automatically set @@ -9102,379 +9501,384 @@ class="cmti-10">value</span>⟩ is the name of a counter. If used, this opt class="cmss-10">entrycounter</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-47001"></a> and the <span + id="dx1-48001"></a> and the <span class="cmss-10">glossaryentry</span><a - id="dx1-47002"></a> counter will be reset every time ⟨<span + id="dx1-48002"></a> counter will be reset every time ⟨<span class="cmti-10">value</span>⟩ is incremented. -</p><!--l. 4096--><p class="indent" > <div class="important" title="Important Note"> The <span +</p><!--l. 4189--><p class="indent" > <div class="important" title="Important Note"> The <span class="cmss-10">glossaryentry</span><a - id="dx1-47003"></a> counter isn’t automatically reset at the start of each glossary, except when glossary section + id="dx1-48003"></a> counter isn’t automatically reset at the start of each glossary, except when glossary section numbering is on and the counter used by <span class="cmss-10">counterwithin</span><a - id="dx1-47004"></a> is the same as the counter used in the glossary’s + id="dx1-48004"></a> is the same as the counter used in the glossary’s sectioning command. </div> -</p><!--l. 4101--><p class="noindent" > -</p><!--l. 4103--><p class="indent" > If you want the counter reset at the start of each glossary, you can modify the glossary preamble +</p><!--l. 4194--><p class="noindent" > +</p><!--l. 4196--><p class="indent" > If you want the counter reset at the start of each glossary, you can modify the glossary preamble (<span class="cmtt-10">\glossarypreamble</span><a - id="dx1-47005"></a>) to use -</p><!--l. 4105--><p class="indent" > <hr><div title="Definition"><a - id="dx1-47006"></a> <span + id="dx1-48005"></a>) to use +</p><!--l. 4198--><p class="indent" > <hr><div title="Definition"><a + id="dx1-48006"></a> <span class="cmtt-10">\glsresetentrycounter </span></div><hr> -</p><!--l. 4107--><p class="noindent" > +</p><!--l. 4200--><p class="noindent" > which sets <span class="cmss-10">glossaryentry</span><a - id="dx1-47007"></a> to zero: + id="dx1-48007"></a> to zero: </p> - <div class="verbatim" id="verbatim-82"> + <pre class="verbatim" id="verbatim-86"> \renewcommand{\glossarypreamble}{% - <br />  \glsresetentrycounter - <br />} -</div> -<!--l. 4113--><p class="nopar" > or if you are using <span +  \glsresetentrycounter +} +</pre> +<!--l. 4206--><p class="nopar" > or if you are using <span class="cmtt-10">\setglossarypreamble</span><a - id="dx1-47008"></a>, add it to each glossary preamble, as required. For + id="dx1-48008"></a>, add it to each glossary preamble, as required. For example: </p> - <div class="verbatim" id="verbatim-83"> + <pre class="verbatim" id="verbatim-87"> \setglossarypreamble[acronym]{% - <br />  \glsresetentrycounter - <br />  The preamble text here for the list of acronyms. - <br />} - <br />\setglossarypreamble{% - <br />  \glsresetentrycounter - <br />  The preamble text here for the main glossary. - <br />} -</div> -<!--l. 4125--><p class="nopar" > -</p><!--l. 4127--><p class="noindent" > +  \glsresetentrycounter +  The preamble text here for the list of acronyms. +} +\setglossarypreamble{% +  \glsresetentrycounter +  The preamble text here for the main glossary. +} +</pre> +<!--l. 4218--><p class="nopar" > +</p><!--l. 4220--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-480002.3"></a><a + id="x1-490002.3"></a><a id="pkgopt:subentrycounter"></a><span class="cmss-10">subentrycounter=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4127--><p class="noindent" >This is a boolean option. (Default is <span +<!--l. 4220--><p class="noindent" >This is a boolean option. (Default is <span class="cmss-10">subentrycounter</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-48001"></a>.) If set, each level 1 glossary entry will be numbered + id="dx1-49001"></a>.) If set, each level 1 glossary entry will be numbered when using the standard glossary styles. This option creates the counter <a - id="dx1-48002"></a><a - id="dx1-48003"></a><span + id="dx1-49002"></a><a + id="dx1-49003"></a><span class="cmss-10">glossarysubentry</span>. The counter is reset with each main (level 0) entry. Note that this package option is independent of <span class="cmss-10">entrycounter</span><a - id="dx1-48004"></a>. You can reference + id="dx1-49004"></a>. You can reference the number within the document using <span class="cmtt-10">\glsrefentry</span><a - id="dx1-48005"></a><span + id="dx1-49005"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">} </span>where ⟨<span class="cmti-10">label</span>⟩ is the label associated with the sub-entry. -</p><!--l. 4138--><p class="noindent" > +</p><!--l. 4231--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-490002.3"></a><a + id="x1-500002.3"></a><a id="pkgopt:style"></a><span class="cmss-10">style=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4138--><p class="noindent" >This is a ⟨<span +<!--l. 4231--><p class="noindent" >This is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ option. (Default is <span class="cmss-10">style</span><span class="cmtt-10">=</span><span class="cmss-10">list</span><a - id="dx1-49001"></a>, unless <span + id="dx1-50001"></a>, unless <span class="cmss-10">classicthesis</span><a - id="dx1-49002"></a> has been loaded, in which case the default is + id="dx1-50002"></a> has been loaded, in which case the default is <span class="cmss-10">style</span><span class="cmtt-10">=</span><span class="cmss-10">index</span><a - id="dx1-49003"></a>.) Its value should be the name of the glossary style to use. This key may only be used for styles + id="dx1-50003"></a>.) Its value should be the name of the glossary style to use. This key may only be used for styles defined in <span class="cmss-10">glossary-list</span><a - id="dx1-49004"></a>, <span + id="dx1-50004"></a>, <span class="cmss-10">glossary-long</span><a - id="dx1-49005"></a>, <span + id="dx1-50005"></a>, <span class="cmss-10">glossary-super</span><a - id="dx1-49006"></a> or <span + id="dx1-50006"></a> or <span class="cmss-10">glossary-tree</span><a - id="dx1-49007"></a>. Alternatively, you can set the style + id="dx1-50007"></a>. Alternatively, you can set the style using -</p><!--l. 4146--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 4239--><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. 4147--><p class="noindent" > +</p><!--l. 4240--><p class="noindent" > (See <a -href="#sec:styles">§15 </a><a +href="#sec:styles">§<span +class="cmbx-10">??</span>sec:styles </a><a href="#sec:styles">Glossary Styles<!--tex4ht:ref: sec:styles --></a> for further details.) -</p><!--l. 4150--><p class="noindent" > +</p><!--l. 4243--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-500002.3"></a><a + id="x1-510002.3"></a><a id="pkgopt:nolong"></a><span class="cmss-10">nolong</span></h4> -<!--l. 4150--><p class="noindent" >This prevents the <span +<!--l. 4243--><p class="noindent" >This prevents the <span class="cmss-10">glossaries </span>package from automatically loading <span class="cmss-10">glossary-long</span><a - id="dx1-50001"></a> (which means that the <span + id="dx1-51001"></a> (which means that the <span class="cmss-10">longtable</span><a - id="dx1-50002"></a> + id="dx1-51002"></a> package also won’t be loaded). This reduces overhead by not defining unwanted styles and commands. Note that if you use this option, you won’t be able to use any of the glossary styles defined in the <span class="cmss-10">glossary-long </span>package (unless you explicitly load <span class="cmss-10">glossary-long</span><a - id="dx1-50003"></a>). + id="dx1-51003"></a>). -</p><!--l. 4158--><p class="noindent" > +</p><!--l. 4251--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-510002.3"></a><a + id="x1-520002.3"></a><a id="pkgopt:nosuper"></a><span class="cmss-10">nosuper</span></h4> -<!--l. 4158--><p class="noindent" >This prevents the <span +<!--l. 4251--><p class="noindent" >This prevents the <span class="cmss-10">glossaries </span>package from automatically loading <span class="cmss-10">glossary-super</span><a - id="dx1-51001"></a> (which means that the + id="dx1-52001"></a> (which means that the <span class="cmss-10">supertabular</span><a - id="dx1-51002"></a> package also won’t be loaded). This reduces overhead by not defining unwanted styles and + id="dx1-52002"></a> package also won’t be loaded). This reduces overhead by not defining unwanted styles and commands. Note that if you use this option, you won’t be able to use any of the glossary styles defined in the <span class="cmss-10">glossary-super </span>package (unless you explicitly load <span class="cmss-10">glossary-super</span><a - id="dx1-51003"></a>). -</p><!--l. 4166--><p class="noindent" > + id="dx1-52003"></a>). +</p><!--l. 4259--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-520002.3"></a><a + id="x1-530002.3"></a><a id="pkgopt:nolist"></a><span class="cmss-10">nolist</span></h4> -<!--l. 4166--><p class="noindent" >This prevents the <span +<!--l. 4259--><p class="noindent" >This prevents the <span class="cmss-10">glossaries </span>package from automatically loading <span class="cmss-10">glossary-list</span><a - id="dx1-52001"></a>. This reduces overhead by not + id="dx1-53001"></a>. This reduces overhead by not defining unwanted styles. Note that if you use this option, you won’t be able to use any of the glossary styles defined in the <span class="cmss-10">glossary-list </span>package (unless you explicitly load <span class="cmss-10">glossary-list</span><a - id="dx1-52002"></a>). Note that since the default style is <span + id="dx1-53002"></a>). Note that since the default style is <span class="cmss-10">list</span><a - id="dx1-52003"></a> + id="dx1-53003"></a> (unless <span class="cmss-10">classicthesis</span><a - id="dx1-52004"></a> has been loaded), you will also need to use the <span + id="dx1-53004"></a> has been loaded), you will also need to use the <span class="cmss-10">style</span><a - id="dx1-52005"></a> option to set the style to something + id="dx1-53005"></a> option to set the style to something else. -</p><!--l. 4177--><p class="noindent" > +</p><!--l. 4270--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-530002.3"></a><a + id="x1-540002.3"></a><a id="pkgopt:notree"></a><span class="cmss-10">notree</span></h4> -<!--l. 4177--><p class="noindent" >This prevents the <span +<!--l. 4270--><p class="noindent" >This prevents the <span class="cmss-10">glossaries </span>package from automatically loading <span class="cmss-10">glossary-tree</span><a - id="dx1-53001"></a>. This reduces overhead by not + id="dx1-54001"></a>. This reduces overhead by not defining unwanted styles. Note that if you use this option, you won’t be able to use any of the glossary styles defined in the <span class="cmss-10">glossary-tree </span>package (unless you explicitly load <span class="cmss-10">glossary-tree</span><a - id="dx1-53002"></a>). Note that if <span + id="dx1-54002"></a>). Note that if <span class="cmss-10">classicthesis</span><a - id="dx1-53003"></a> has been + id="dx1-54003"></a> has been loaded, the default style is <span class="cmss-10">index</span><a - id="dx1-53004"></a>, which is provided by <span + id="dx1-54004"></a>, which is provided by <span class="cmss-10">glossary-tree</span><a - id="dx1-53005"></a>. -</p><!--l. 4186--><p class="noindent" > + id="dx1-54005"></a>. +</p><!--l. 4279--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-540002.3"></a><a + id="x1-550002.3"></a><a id="pkgopt:nostyles"></a><span class="cmss-10">nostyles</span></h4> -<!--l. 4186--><p class="noindent" >This prevents all the predefined styles from being loaded. If you use this option, you need to load a glossary +<!--l. 4279--><p class="noindent" >This prevents all the predefined styles from being loaded. If you use this option, you need to load a glossary style package (such as <span class="cmss-10">glossary-mcols</span><a - id="dx1-54001"></a>). Also if you use this option, you can’t use the <span + id="dx1-55001"></a>). Also if you use this option, you can’t use the <span class="cmss-10">style</span><a - id="dx1-54002"></a> package option. Instead + id="dx1-55002"></a> package option. Instead you must either use <span class="cmtt-10">\setglossarystyle</span><a - id="dx1-54003"></a><span + id="dx1-55003"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">style</span>⟩<span class="cmtt-10">} </span>or the <span class="cmtt-10">style</span><a - id="dx1-54004"></a> key in the optional argument to <span + id="dx1-55004"></a> key in the optional argument to <span class="cmtt-10">\printglossary</span><a - id="dx1-54005"></a>. + id="dx1-55005"></a>. Example: </p> - <div class="verbatim" id="verbatim-84"> + <pre class="verbatim" id="verbatim-88"> \usepackage[nostyles]{glossaries} - <br />\usepackage{glossary-mcols} - <br />\setglossarystyle{mcoltree} -</div> -<!--l. 4197--><p class="nopar" > -</p><!--l. 4199--><p class="noindent" > +\usepackage{glossary-mcols} +\setglossarystyle{mcoltree} +</pre> +<!--l. 4290--><p class="nopar" > +</p><!--l. 4292--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-550002.3"></a><a + id="x1-560002.3"></a><a id="pkgopt:nonumberlist"></a><span class="cmss-10">nonumberlist</span></h4> -<!--l. 4199--><p class="noindent" >This option will suppress the associated <a +<!--l. 4292--><p class="noindent" >This option will suppress the associated <a href="#glo:numberlist">number list<a - id="dx1-55001"></a>s</a> in the glossaries (see also <a -href="#sec:numberlists">§5 </a><a -href="#sec:numberlists">Number lists<!--tex4ht:ref: sec:numberlists --></a>). Note -that if you use Options <a + id="dx1-56001"></a>s</a> in the glossaries (see also <a +href="#sec:numberlists">§<span +class="cmbx-10">??</span>sec:numberlists </a><a +href="#sec:numberlists">Number Lists<!--tex4ht:ref: sec:numberlists --></a>). +Note that if you use Options <a href="#option2">2</a> or <a href="#option3">3</a> (<a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-55002"></a></a> or <a + id="dx1-56002"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-55003"></a></a>) then the locations must still be valid. This + id="dx1-56003"></a></a>) then the locations must still be valid. This package option merely prevents the <a href="#glo:numberlist">number list<a - id="dx1-55004"></a></a> from being displayed, but both <a + id="dx1-56004"></a></a> from being displayed, but both <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-55005"></a></a> and <a + id="dx1-56005"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-55006"></a></a> + id="dx1-56006"></a></a> still require a location or cross-reference for each term that’s indexed. Remember that <a href="#glo:numberlist">number list<a - id="dx1-55007"></a></a> + id="dx1-56007"></a></a> includes any cross-references, so suppressing the <a href="#glo:numberlist">number list<a - id="dx1-55008"></a></a> will also hide the cross-references (see + id="dx1-56008"></a></a> will also hide the cross-references (see below). -</p><!--l. 4210--><p class="noindent" > +</p><!--l. 4303--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-560002.3"></a><a + id="x1-570002.3"></a><a id="pkgopt:seeautonumberlist"></a><span class="cmss-10">seeautonumberlist</span></h4> -<!--l. 4210--><p class="noindent" >If you suppress the <a +<!--l. 4303--><p class="noindent" >If you suppress the <a href="#glo:numberlist">number list<a - id="dx1-56001"></a>s</a> with <span + id="dx1-57001"></a>s</a> with <span class="cmss-10">nonumberlist</span><a - id="dx1-56002"></a>, described above, this will also suppress any cross-referencing -information supplied by the <span + id="dx1-57002"></a>, described above, this will also suppress any +cross-referencing information supplied by the <span class="cmtt-10">see</span><a - id="dx1-56003"></a> key in <span + id="dx1-57003"></a> key in <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-56004"></a> or <span + id="dx1-57004"></a> or <span class="cmtt-10">\glssee</span><a - id="dx1-56005"></a>. If you use <span + id="dx1-57005"></a>. If you +use <span class="cmss-10">seeautonumberlist</span><a - id="dx1-56006"></a>, the <span + id="dx1-57006"></a>, the <span class="cmtt-10">see</span><a - id="dx1-56007"></a> -key will automatically implement <span + id="dx1-57007"></a> key will automatically implement <span class="cmtt-10">nonumberlist=false</span><a - id="dx1-56008"></a> for that entry. (Note this doesn’t affect <span -class="cmtt-10">\glssee</span>.) For -further details see <a -href="#sec:crossref">§8 </a><a -href="#sec:crossref">Cross-Referencing Entries<!--tex4ht:ref: sec:crossref --></a>. -</p><!--l. 4219--><p class="noindent" > + id="dx1-57008"></a> for that +entry. (Note this doesn’t affect <span +class="cmtt-10">\glssee</span>.) For further details see <a +href="#sec:crossref">§<span +class="cmbx-10">??</span>sec:crossref </a><a +href="#sec:crossref">Cross-Referencing +Entries<!--tex4ht:ref: sec:crossref --></a>. +</p><!--l. 4312--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-570002.3"></a><a + id="x1-580002.3"></a><a id="pkgopt:counter"></a><span class="cmss-10">counter=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4219--><p class="noindent" >This is a ⟨<span +<!--l. 4312--><p class="noindent" >This is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ option. (Default is <span class="cmss-10">counter</span><span class="cmtt-10">=</span><span class="cmss-10">page</span><a - id="dx1-57001"></a>.) The value should be the name of the default counter to + id="dx1-58001"></a>.) The value should be the name of the default counter to use in the <a href="#glo:numberlist">number list<a - id="dx1-57002"></a>s</a> (see <a -href="#sec:numberlists">§5 </a><a -href="#sec:numberlists">Number lists<!--tex4ht:ref: sec:numberlists --></a>). -</p><!--l. 4224--><p class="noindent" > + id="dx1-58002"></a>s</a> (see <a +href="#sec:numberlists">§<span +class="cmbx-10">??</span>sec:numberlists </a><a +href="#sec:numberlists">Number Lists<!--tex4ht:ref: sec:numberlists --></a>). +</p><!--l. 4317--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-580002.3"></a><a + id="x1-590002.3"></a><a id="pkgopt:nopostdot"></a><span class="cmss-10">nopostdot=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4224--><p class="noindent" >This is a boolean option. If no value is specified, <span +<!--l. 4317--><p class="noindent" >This is a boolean option. If no value is specified, <span class="cmss-10">true</span><a - id="dx1-58001"></a> is assumed. When set to <span + id="dx1-59001"></a> is assumed. When set to <span class="cmss-10">true</span><a - id="dx1-58002"></a>, this option suppresses the + id="dx1-59002"></a>, this option suppresses the default post description dot used by some of the predefined styles. -</p><!--l. 4229--><p class="indent" > The default setting is <span + + +</p><!--l. 4322--><p class="indent" > The default setting is <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-58003"></a> for the base <span + id="dx1-59003"></a> for the base <span class="cmss-10">glossaries </span>package and <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-58004"></a> for + id="dx1-59004"></a> for <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. - - -</p><!--l. 4233--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 4326--><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 provides <span id="textcolor211"><span +class="cmss-10">glossaries-extra</span></a> package provides <span id="textcolor212"><span class="cmss-10">postdot</span></span><a - id="dx1-58005"></a>, which is equivalent to <span + id="dx1-59005"></a>, which is equivalent to <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-58006"></a>, and also <span id="textcolor212"><span + id="dx1-59006"></a>, and also <span id="textcolor213"><span class="cmss-10">postpunc</span></span><a - id="dx1-58007"></a>, + id="dx1-59007"></a>, which allows you to choose a different punctuation character. </div> -</p><!--l. 4238--><p class="noindent" > -</p><!--l. 4240--><p class="noindent" > +</p><!--l. 4331--><p class="noindent" > +</p><!--l. 4333--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-590002.3"></a><a + id="x1-600002.3"></a><a id="pkgopt:nogroupskip"></a><span class="cmss-10">nogroupskip=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4240--><p class="noindent" >This is a boolean option. If no value is specified, <span +<!--l. 4333--><p class="noindent" >This is a boolean option. If no value is specified, <span class="cmss-10">true </span>is assumed. When set to <span class="cmss-10">true</span>, this option suppresses the default vertical gap between letter groups used by some of the predefined styles. The default setting is @@ -9482,31 +9886,31 @@ default vertical gap between letter groups used by some of the predefined styles class="cmss-10">nogroupskip</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-59001"></a>. -</p><!--l. 4246--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you are using <a + id="dx1-60001"></a>. +</p><!--l. 4339--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you are using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-59002"></a></a> without the <span + id="dx1-60002"></a></a> without the <span class="cmtt-10">--group </span>(or <span class="cmtt-10">-g</span>) switch then you don’t need to use <span class="cmss-10">nogroupskip</span><span class="cmtt-10">=</span><span class="cmss-10">true </span>as there won’t be any letter groups. </div> -</p><!--l. 4251--><p class="noindent" > -</p><!--l. 4253--><p class="noindent" > +</p><!--l. 4344--><p class="noindent" > +</p><!--l. 4346--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-600002.3"></a><span id="textcolor213"><a - id="pkgopt:stylemods"></a><span id="textcolor214"><span + id="x1-610002.3"></a><span id="textcolor214"><a + id="pkgopt:stylemods"></a><span id="textcolor215"><span class="cmss-10">stylemods</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">list</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 4255--><p class="noindent" >Load the <span +<!--l. 4348--><p class="noindent" >Load the <span class="cmss-10">glossaries-extra-stylemods</span><a - id="dx1-60001"></a> package and patch the predefined styles. The ⟨<span + id="dx1-61001"></a> package, which patches the predefined styles. The ⟨<span class="cmti-10">list</span>⟩ argument is optional. If present, this will also load <span class="cmss-10">glossary-</span>⟨<span @@ -9515,157 +9919,158 @@ class="cmss-10">.sty </span>for each ⟨<span class="cmti-10">element</span>⟩ in the comma-separated ⟨<span class="cmti-10">list</span>⟩. -</p><!--l. 4260--><p class="noindent" > +</p><!--l. 4353--><p class="noindent" > </p> -<!--l. 4260--><p class="noindent" ><a +<!--l. 4353--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.4 </span> <a id="sec:pkgopts-indexing"></a>Indexing Options</h3> -<!--l. 4263--><p class="noindent" > +<!--l. 4356--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-620002.4"></a><a + id="x1-630002.4"></a><a id="pkgopt:seenoindex"></a><span class="cmss-10">seenoindex=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4263--><p class="noindent" >Introduced in version 4.24, this option may take one of three values: <span +<!--l. 4356--><p class="noindent" >Introduced in version 4.24, this option may take one of three values: <span class="cmss-10">error</span>, <span class="cmss-10">warn </span>or <span class="cmss-10">ignore</span>. The <span class="cmtt-10">see</span><a - id="dx1-62001"></a> key + id="dx1-63001"></a> key automatically indexes the cross-referenced entry using <span -class="cmtt-10">\glsadd</span>. This means that if this key is +class="cmtt-10">\glssee</span><a + id="dx1-63002"></a>. This means that if this key is used in an entry definition before the relevant glossary file has been opened, the indexing can’t be performed. Since this is easy to miss, the <span class="cmss-10">glossaries </span>package by default issues an error message if the <span class="cmtt-10">see</span><a - id="dx1-62002"></a> key is used before <span + id="dx1-63003"></a> key is used before <span class="cmtt-10">\makeglossaries</span><a - id="dx1-62003"></a>. This option allows you to change the error into just a + id="dx1-63004"></a>. This option allows you to change the error into just a warning (<span class="cmss-10">seenoindex</span><span class="cmtt-10">=</span><span class="cmss-10">warn</span><a - id="dx1-62004"></a>) or ignore it (<span + id="dx1-63005"></a>) or ignore it (<span class="cmss-10">seenoindex</span><span class="cmtt-10">=</span><span class="cmss-10">ignore</span><a - id="dx1-62005"></a>) if, for example, you want to temporarily + id="dx1-63006"></a>) if, for example, you want to temporarily comment out <span class="cmtt-10">\makeglossaries </span>to speed up the compilation of a draft document by omitting the indexing. -</p><!--l. 4277--><p class="noindent" > +</p><!--l. 4370--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-630002.4"></a><a + id="x1-640002.4"></a><a id="pkgopt:esclocations"></a><span class="cmss-10">esclocations=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4277--><p class="noindent" >This is a boolean option. The default is <span +<!--l. 4370--><p class="noindent" >This is a boolean option. The default is <span class="cmss-10">esclocations</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-63001"></a>, which is needed for Options <a + id="dx1-64001"></a>, which is needed for Options <a href="#option2">2</a> and <a href="#option3">3</a>. With <a href="#option1">Option 1</a> <span class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-63002"></a> changes it to <span + id="dx1-64002"></a> changes it to <span class="cmss-10">esclocations</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-63003"></a>. With <a + id="dx1-64003"></a>. With <a href="#option4">Option 4</a> (<a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-63004"></a></a>), this setting is + id="dx1-64004"></a></a>), this setting is ignored. -</p><!--l. 4283--><p class="indent" > Both <a +</p><!--l. 4376--><p class="indent" > Both <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-63005"></a></a> and <a + id="dx1-64005"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-63006"></a></a> are fussy about the location formats (<a + id="dx1-64006"></a></a> are fussy about the location formats (<a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-63007"></a></a> more so than <a + id="dx1-64007"></a></a> more so than <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-63008"></a></a>) so the + id="dx1-64008"></a></a>) so the <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 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 +</p><!--l. 4385--><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 class="cmss-10">esclocations</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-63009"></a> to + id="dx1-64009"></a> to avoid the complex escaping of location values. (See “Writing information to associated files” in the documented code for further details.) -</p><!--l. 4300--><p class="indent" > This isn’t an issue for Options <a +</p><!--l. 4393--><p class="indent" > This isn’t an issue for Options <a href="#option1">1</a> or <a href="#option4">4</a> as the locations are written to the <span class="cmtt-10">aux</span><a - id="dx1-63010"></a> file so no syntax conversion is + id="dx1-64010"></a> file so no syntax conversion is required. -</p><!--l. 4303--><p class="noindent" > +</p><!--l. 4396--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-640002.4"></a><a + id="x1-650002.4"></a><a id="pkgopt:indexonlyfirst"></a><span class="cmss-10">indexonlyfirst=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4303--><p class="noindent" >This is a boolean option that specifies whether to only add information to the external glossary file on <a +<!--l. 4396--><p class="noindent" >This is a boolean option that specifies whether to only add information to the external glossary file on <a href="#glo:firstuse">first use</a>. The default is <span class="cmss-10">indexonlyfirst</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-64001"></a>, which will add a line to the file every time one of the <a + id="dx1-65001"></a>, which will add a line to the file every time one of the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> or <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands are used. Note that <span class="cmtt-10">\glsadd</span><a - id="dx1-64002"></a> will always add information to the external glossary + id="dx1-65002"></a> will always add information to the external glossary file<span class="footnote-mark"><a href="#fn4x2" id="fn4x2-bk"><sup class="textsuperscript">2.4</sup></a></span><a - id="x1-64003f4"></a> (since + id="x1-65003f4"></a> (since that’s the purpose of that command). -</p><!--l. 4312--><p class="indent" > <div class="important" title="Important Note"> Resetting the <a +</p><!--l. 4405--><p class="indent" > <div class="important" title="Important Note"> Resetting the <a href="#glo:firstuseflag">first use flag</a> with commands like <span class="cmtt-10">\glsreset</span><a - id="dx1-64004"></a> after an entry has been indexed will cause that + id="dx1-65004"></a> after an entry has been indexed will cause that entry to be indexed multiple times if it’s used again after the reset. Likewise unsetting the <a href="#glo:firstuseflag">first use flag</a> before an entry has been indexed will prevent it from being indexed (unless specifically indexed with <span class="cmtt-10">\glsadd</span>). </div> -</p><!--l. 4319--><p class="noindent" > -</p><!--l. 4321--><p class="indent" > You can customise this by redefining -</p><!--l. 4322--><p class="indent" > <hr><div title="Definition"><a - id="dx1-64005"></a> <span +</p><!--l. 4412--><p class="noindent" > +</p><!--l. 4414--><p class="indent" > You can customise this by redefining +</p><!--l. 4415--><p class="indent" > <hr><div title="Definition"><a + id="dx1-65005"></a> <span class="cmtt-10">\glswriteentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">wr-code</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 4324--><p class="noindent" > +</p><!--l. 4417--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the entry’s label and ⟨<span class="cmti-10">wr-code</span>⟩ is the code that writes the entry’s information to the external file. @@ -9674,391 +10079,427 @@ class="cmtt-10">\glswriteentry </span>is: </p> - <div class="verbatim" id="verbatim-85"> + <pre class="verbatim" id="verbatim-89"> \newcommand*{\glswriteentry}[2]{% - <br />  \ifglsindexonlyfirst - <br />    \ifglsused{#1}{}{#2}% - <br />  \else - <br />    #2% - <br />  \fi - <br />} -</div> -<!--l. 4336--><p class="nopar" > This checks the <span +  \ifglsindexonlyfirst +    \ifglsused{#1}{}{#2}% +  \else +    #2% +  \fi +} +</pre> +<!--l. 4429--><p class="nopar" > This checks the <span class="cmss-10">indexonlyfirst</span><a - id="dx1-64006"></a> package option (using <span + id="dx1-65006"></a> package option (using <span class="cmtt-10">\ifglsindexonlyfirst</span>) and does ⟨<span class="cmti-10">wr-code</span>⟩ if this is <span class="cmss-10">false</span> otherwise it only does ⟨<span class="cmti-10">wr-code</span>⟩ of the entry hasn’t been used. -</p><!--l. 4342--><p class="indent" > For example, suppose you only want to index the first use for entries in the <span +</p><!--l. 4435--><p class="indent" > For example, suppose you only want to index the first use for entries in the <span class="cmtt-10">acronym </span>glossary and not in the <span class="cmtt-10">main </span>(or any other) glossary: </p> - <div class="verbatim" id="verbatim-86"> + <pre class="verbatim" id="verbatim-90"> \renewcommand*{\glswriteentry}[2]{% - <br /> \ifthenelse{\equal{\glsentrytype{#1}}{acronym}} - <br /> {\ifglsused{#1}{}{#2}}% - <br /> {#2}% - <br />} -</div> -<!--l. 4351--><p class="nopar" > Here I’ve used <span + \ifthenelse{\equal{\glsentrytype{#1}}{acronym}} + {\ifglsused{#1}{}{#2}}% + {#2}% +} +</pre> +<!--l. 4444--><p class="nopar" > Here I’ve used <span class="cmtt-10">\ifthenelse </span>to ensure the arguments of <span class="cmtt-10">\equal </span>are fully expanded before the comparison is made. -</p><!--l. 4355--><p class="indent" > With the <a +</p><!--l. 4448--><p class="indent" > With the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package it’s possible to only index <a href="#glo:firstuse">first use</a> for particular categories. For example, if -you only want this enabled for abbreviations and acronyms then you can set the <span id="textcolor215"><span +you only want this enabled for abbreviations and acronyms then you can set the <span id="textcolor216"><span class="cmss-10">indexonlyfirst</span></span><a - id="dx1-64007"></a> attribute for the + id="dx1-65007"></a> attribute for the <span class="cmtt-10">abbreviation </span>and <span class="cmtt-10">acronym </span>categories. (Instead of using the <span class="cmss-10">indexonlyfirst</span><a - id="dx1-64008"></a> package option.) See the + id="dx1-65008"></a> package option.) See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. -</p><!--l. 4363--><p class="noindent" > +</p><!--l. 4456--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-650002.4"></a><span id="textcolor216"><a - id="pkgopt:indexcrossrefs"></a><span id="textcolor217"><span + id="x1-660002.4"></a><span id="textcolor217"><a + id="pkgopt:indexcrossrefs"></a><span id="textcolor218"><span class="cmss-10">indexcrossrefs</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 4365--><p class="noindent" >If <span -class="cmss-10">true</span>, this will automatically index any cross-referenced entries that haven’t been marked as used at +<!--l. 4458--><p class="noindent" >If <span +class="cmss-10">true</span>, this will automatically index (<span +class="cmtt-10">\glsadd</span><a + id="dx1-66001"></a>) any cross-referenced entries that haven’t been marked as used at the end of the document. Increases document build time. See <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. -</p><!--l. 4370--><p class="noindent" > +</p><!--l. 4463--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> Note that <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-66002"></a></a> can automatically find dependent entries when it parses the <span +class="cmtt-10">bib</span><a + id="dx1-66003"></a> file. Use the <span id="textcolor219">selection</span> +option to <span id="textcolor220"><span +class="cmtt-10">\GlsXtrLoadResources</span></span><a + id="dx1-66004"></a> to determine the selection of dependencies. </div> +</p><!--l. 4468--><p class="noindent" > +</p><!--l. 4470--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-660002.4"></a><span id="textcolor218"><a - id="pkgopt:autoseeindex"></a><span id="textcolor219"><span + id="x1-670002.4"></a><span id="textcolor221"><a + id="pkgopt:autoseeindex"></a><span id="textcolor222"><span class="cmss-10">autoseeindex</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 4372--><p class="noindent" >If <span +<!--l. 4472--><p class="noindent" >If <span class="cmss-10">true</span>, makes the <span class="cmtt-10">see</span><a - id="dx1-66001"></a> and <span id="textcolor220"><span id="textcolor221"><span + id="dx1-67001"></a> and <span id="textcolor223"><span id="textcolor224"><span class="cmtt-10">seealso</span></span><a - id="dx1-66002"></a></span> keys automatically index the cross-reference when the entry is defined -(default, and the only option with just the base <span + id="dx1-67002"></a></span> keys automatically index the cross-reference (with <span +class="cmtt-10">\glssee</span><a + id="dx1-67003"></a>) when the entry +is defined (default, and the only option with just the base <span class="cmss-10">glossaries </span>package). -</p><!--l. 4377--><p class="noindent" > +</p><!--l. 4477--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-67004"></a></a>, use the <span id="textcolor225">selection</span> option to <span id="textcolor226"><span +class="cmtt-10">\GlsXtrLoadResources</span></span><a + id="dx1-67005"></a> to determine the selection of +dependencies. </div> +</p><!--l. 4481--><p class="noindent" > +</p><!--l. 4483--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-670002.4"></a><span id="textcolor222"><a - id="pkgopt:record"></a><span id="textcolor223"><span + id="x1-680002.4"></a><span id="textcolor227"><a + id="pkgopt:record"></a><span id="textcolor228"><span class="cmss-10">record</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 4379--><p class="noindent" >If not <span +<!--l. 4485--><p class="noindent" >If not <span class="cmss-10">off</span>, this option indicates that <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-67001"></a></a> is required. If the value is omitted, <span + id="dx1-68001"></a></a> is required. If the value is omitted, <span class="cmss-10">only </span>is assumed. Permitted values: + + </p><dl class="description"><dt class="description"> + <!--l. 4488--><p class="noindent" > <span -class="cmssbx-10">off</span> </dt><dd -class="description"><a +class="cmssbx-10">off</span> </p></dt><dd +class="description"> + <!--l. 4488--><p class="noindent" ><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-67002"></a></a> isn’t being used; - </dd><dt class="description"> + id="dx1-68002"></a></a> isn’t being used; + </p></dd><dt class="description"> + <!--l. 4490--><p class="noindent" > <span -class="cmssbx-10">only</span> </dt><dd -class="description"><a +class="cmssbx-10">only</span> </p></dt><dd +class="description"> + <!--l. 4490--><p class="noindent" ><a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-67003"></a></a> is being used to fetch entries from a <span + id="dx1-68003"></a></a> is being used to fetch entries from a <span class="cmtt-10">bib</span><a - id="dx1-67004"></a> file, to sort the entries and collate the <a + id="dx1-68004"></a> file, to sort the entries and collate the <a href="#glo:numberlist">number list<a - id="dx1-67005"></a>s</a>, where the location information is the same as for Options <a + id="dx1-68005"></a>s</a>, where the location information is the same as for Options <a href="#option1">1</a>–<a href="#option3">3</a>; - - - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 4495--><p class="noindent" > <span -class="cmssbx-10">nameref</span> </dt><dd -class="description">like <span -class="cmss-10">only </span>but provides extra information that allows the associated title to be used instead of - the location number; - </dd><dt class="description"> +class="cmssbx-10">nameref</span> </p></dt><dd +class="description"> + <!--l. 4495--><p class="noindent" >like <span +class="cmss-10">only </span>but provides extra information that allows the associated title to be used instead of the + location number and provides better support for hyperlinked locations; + </p></dd><dt class="description"> + <!--l. 4500--><p class="noindent" > <span -class="cmssbx-10">alsoindex</span> </dt><dd -class="description">a hybrid approach where <a +class="cmssbx-10">hybrid</span> </p></dt><dd +class="description"> + <!--l. 4500--><p class="noindent" >a hybrid approach where <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-67006"></a></a> is begin used to fetch entries from a <span + id="dx1-68006"></a></a> is used to fetch entries from a <span class="cmtt-10">bib</span><a - id="dx1-67007"></a> file but <a + id="dx1-68007"></a> file but <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-67008"></a></a> - or <a + id="dx1-68008"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-67009"></a></a> are used for the indexing. This requires a more complicated document build and isn’t - recommended.</dd></dl> -<!--l. 4398--><p class="noindent" >See <a + id="dx1-68009"></a></a> + are used for the indexing. This requires a more complicated document build and isn’t recommended.</p></dd></dl> +<!--l. 4505--><p class="noindent" >See <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. -</p><!--l. 4400--><p class="noindent" > +</p><!--l. 4507--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-680002.4"></a><span id="textcolor224"><a - id="pkgopt:equations"></a><span id="textcolor225"><span + id="x1-690002.4"></a><span id="textcolor229"><a + id="pkgopt:equations"></a><span id="textcolor230"><span class="cmss-10">equations</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 4402--><p class="noindent" >If <span +<!--l. 4509--><p class="noindent" >If <span class="cmss-10">true</span>, this option will cause the default location counter to automatically switch to <span class="cmtt-10">equation </span>when inside a numbered equation environment. -</p><!--l. 4406--><p class="noindent" > +</p><!--l. 4513--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-690002.4"></a><span id="textcolor226"><a - id="pkgopt:floats"></a><span id="textcolor227"><span + id="x1-700002.4"></a><span id="textcolor231"><a + id="pkgopt:floats"></a><span id="textcolor232"><span class="cmss-10">floats</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 4408--><p class="noindent" >If <span +<!--l. 4515--><p class="noindent" >If <span class="cmss-10">true</span>, this option will cause the default location counter to automatically switch to the corresponding counter when inside a float. (Remember that with floats it’s the <span class="cmtt-10">\caption </span>command that increments the counter so the location will be incorrect if an entry is indexed within the float before the caption.) -</p><!--l. 4414--><p class="noindent" > + + +</p><!--l. 4521--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-700002.4"></a><span id="textcolor228"><a - id="pkgopt:indexcounter"></a><span id="textcolor229"><span + id="x1-710002.4"></a><span id="textcolor233"><a + id="pkgopt:indexcounter"></a><span id="textcolor234"><span class="cmss-10">indexcounter</span></span> (glossaries-extra.sty)</span></h4> -<!--l. 4416--><p class="noindent" >This valueless option is primarily intended for use with <a +<!--l. 4523--><p class="noindent" >This valueless option is primarily intended for use with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-70001"></a></a> and <span + id="dx1-71001"></a></a> and <span class="cmss-10">hyperref</span><a - id="dx1-70002"></a> allowing the page location -hyperlink to the relevant point in the page (rather than the top of the page). Unexpected results will occur with -other indexing methods. See <a + id="dx1-71002"></a> allowing the page location +hyperlink target to be set to the relevant point within the page (rather than the top of the page). +Unexpected results will occur with other indexing methods. See <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> manual for further details. -</p><!--l. 4422--><p class="noindent" > +class="cmss-10">glossaries-extra</span></a> manual for further +details. +</p><!--l. 4530--><p class="noindent" > </p> -<!--l. 4422--><p class="noindent" ><a +<!--l. 4530--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.5 </span> <a id="sec:pkgopts-sort"></a>Sorting Options</h3> -<!--l. 4425--><p class="noindent" >This section is mostly for Options <a +<!--l. 4533--><p class="noindent" >This section is mostly for Options <a href="#option2">2</a> and <a href="#option3">3</a>. Only the <span class="cmss-10">sort</span><a - id="dx1-71001"></a> and <span + id="dx1-72001"></a> and <span class="cmss-10">order</span><a - id="dx1-71002"></a> options are applicable for + id="dx1-72002"></a> options are applicable for <a href="#option1">Option 1</a>. -</p><!--l. 4428--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With Options <a +</p><!--l. 4536--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With Options <a href="#option4">4</a>–<a href="#option6">6</a>, only <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">none</span><a - id="dx1-71003"></a> is applicable (and this is automatically implemented by -<span id="textcolor230"><span + id="dx1-72003"></a> is applicable (and this is automatically implemented by +<span id="textcolor235"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">only</span></span><a - id="dx1-71004"></a> and <span id="textcolor231"><span + id="dx1-72004"></a> and <span id="textcolor236"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-71005"></a>). With <a + id="dx1-72005"></a>). With <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-71006"></a></a>, the sort method is provided in the optional argument of -<span id="textcolor232"><span + id="dx1-72006"></a></a>, the sort method is provided in the optional argument of +<span id="textcolor237"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-71007"></a> not with the <span + id="dx1-72007"></a> not with the <span class="cmss-10">sort </span>package option. There’s no sorting with Options <a href="#option5">5</a> and <a href="#option6">6</a>. </div> - - -</p><!--l. 4435--><p class="noindent" > -</p><!--l. 4437--><p class="noindent" > +</p><!--l. 4543--><p class="noindent" > +</p><!--l. 4545--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-720002.5"></a><a + id="x1-730002.5"></a><a id="pkgopt:sanitizesort"></a><span class="cmss-10">sanitizesort=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4437--><p class="noindent" >This is a boolean option that determines whether or not to <a +<!--l. 4545--><p class="noindent" >This is a boolean option that determines whether or not to <a href="#glo:sanitize">sanitize<a - id="dx1-72001"></a></a> the sort value when writing to the external + id="dx1-73001"></a></a> the sort value when writing to the external glossary file. For example, suppose you define an entry as follows: </p> - <div class="verbatim" id="verbatim-87"> + <pre class="verbatim" id="verbatim-91"> \newglossaryentry{hash}{name={\#},sort={#}, - <br /> description={hash symbol}} -</div> -<!--l. 4444--><p class="nopar" > The sort value (<span class="obeylines-h"><span class="verb"><span + description={hash symbol}} +</pre> +<!--l. 4552--><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 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> - <div class="verbatim" id="verbatim-88"> + <pre class="verbatim" id="verbatim-92"> \newcommand{\mysortvalue}{AAA} - <br />\newglossaryentry{sample}{% - <br />  name={sample}, - <br />  sort={\mysortvalue}, - <br />  description={an example}} -</div> -<!--l. 4456--><p class="nopar" > and you actually want <span +\newglossaryentry{sample}{% +  name={sample}, +  sort={\mysortvalue}, +  description={an example}} +</pre> +<!--l. 4564--><p class="nopar" > and you actually want <span class="cmtt-10">\mysortvalue </span>expanded, so that the entry is sorted according to <span class="cmtt-10">AAA</span>, then use the package option <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-72002"></a>. -</p><!--l. 4461--><p class="indent" > The default for Options <a + id="dx1-73002"></a>. +</p><!--l. 4569--><p class="indent" > The default for Options <a href="#option2">2</a> and <a href="#option3">3</a> is <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-72003"></a>, and the default for <a + id="dx1-73003"></a>, and the default for <a href="#option1">Option 1</a> is <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-72004"></a>. -</p><!--l. 4464--><p class="noindent" > + id="dx1-73004"></a>. +</p><!--l. 4572--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-730002.5"></a><a + id="x1-740002.5"></a><a id="pkgopt:sort"></a><span class="cmss-10">sort=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4464--><p class="noindent" >If you use Options <a +<!--l. 4572--><p class="noindent" >If you use Options <a href="#option2">2</a> or <a href="#option3">3</a>, this package option is the only way of specifying how to sort the glossaries. Only <a href="#option1">Option 1</a> allows you to specify sort methods for individual glossaries via the <span class="cmtt-10">sort</span><a - id="dx1-73001"></a> key in the optional argument + id="dx1-74001"></a> key in the optional argument of <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-73002"></a>. If you have multiple glossaries in your document and you are using <a + id="dx1-74002"></a>. If you have multiple glossaries in your document and you are using <a href="#option1">Option 1</a>, only use the package options <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-73003"></a> or <span + id="dx1-74003"></a> or <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-73004"></a> if you want to set this sort method for <span + id="dx1-74004"></a> if you want to set this sort method for <span class="cmti-10">all </span>your glossaries. -</p><!--l. 4474--><p class="indent" > This is a ⟨<span +</p><!--l. 4582--><p class="indent" > This is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ option where ⟨<span class="cmti-10">value</span>⟩ may be one of the following: </p> <ul class="itemize1"> - <li class="itemize"><span + <li class="itemize"> + <!--l. 4585--><p class="noindent" ><span class="cmss-10">standard</span><a - id="dx1-73005"></a> : entries are sorted according to the value of the <span + id="dx1-74005"></a> : entries are sorted according to the value of the <span class="cmtt-10">sort</span><a - id="dx1-73006"></a> key used in <span + id="dx1-74006"></a> key used in <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-73007"></a> (if + id="dx1-74007"></a> (if present) or the <span class="cmtt-10">name</span><a - id="dx1-73008"></a> key (if <span + id="dx1-74008"></a> key (if <span class="cmtt-10">sort</span><a - id="dx1-73009"></a> key is missing); - </li> - <li class="itemize"><span + id="dx1-74009"></a> key is missing); + </p></li> + <li class="itemize"> + <!--l. 4590--><p class="noindent" ><span class="cmss-10">def</span><a - id="dx1-73010"></a> : entries are sorted in the order in which they were defined (the <span + id="dx1-74010"></a> : entries are sorted in the order in which they were defined (the <span class="cmtt-10">sort</span><a - id="dx1-73011"></a> key in <span + id="dx1-74011"></a> key in <span class="cmtt-10">\newglossaryentry</span> is ignored); - </li> - <li class="itemize"><span + </p></li> + <li class="itemize"> + <!--l. 4594--><p class="noindent" ><span class="cmss-10">use</span><a - id="dx1-73012"></a> : entries are sorted according to the order in which they are used in the document (the <span + id="dx1-74012"></a> : entries are sorted according to the order in which they are used in the document (the <span class="cmtt-10">sort</span><a - id="dx1-73013"></a> + id="dx1-74013"></a> key in <span class="cmtt-10">\newglossaryentry </span>is ignored). - <!--l. 4490--><p class="noindent" >Both <span + </p><!--l. 4598--><p class="noindent" >Both <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-73014"></a> and <span + id="dx1-74014"></a> and <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-73015"></a> set the sort key to a six digit number via - </p><!--l. 4492--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-73016"></a> <span + id="dx1-74015"></a> set the sort key to a six digit number via + </p><!--l. 4600--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-74016"></a> <span class="cmtt-10">\glssortnumberfmt{</span>⟨<span class="cmitt-10">number</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 4494--><p class="noindent" > + </p><!--l. 4602--><p class="noindent" > (padded with leading zeros, where necessary). This can be redefined, if required, before the entries are defined (in the case of <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-73017"></a>) or before the entries are used (in the case of <span + id="dx1-74017"></a>) or before the entries are used (in the case of <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-73018"></a>). + id="dx1-74018"></a>). + + </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 4608--><p class="noindent" ><span class="cmss-10">none</span><a - id="dx1-73019"></a> : this setting is new to version 4.30 and is only for documents that don’t use <span + id="dx1-74019"></a> : this setting is new to version 4.30 and is only for documents that don’t use <span class="cmtt-10">\makeglossaries</span> (Options <a href="#option2">2</a> or <a @@ -10067,9 +10508,7 @@ class="cmtt-10">\makenoidxglossaries </span>(<a href="#option1">Option 1</a>). It omits the code used to sanitize or escape the sort value, since it’s not required. This can help to improve the document build speed, especially if there are a large number of entries. - - - <!--l. 4507--><p class="noindent" >This option can’t be used with <span + </p><!--l. 4615--><p class="noindent" >This option can’t be used with <span class="cmtt-10">\printglossary </span>or <span class="cmtt-10">\printnoidxglossary </span>(or the iterative versions <span @@ -10080,25 +10519,25 @@ class="cmss-10">glossaries-extra</span></a>’s <span class="cmtt-10">\printunsrtglossary </span>(<a href="#option5">Option 5</a>).</p></li></ul> -<!--l. 4513--><p class="noindent" >Note that the group styles (such as <span +<!--l. 4621--><p class="noindent" >Note that the group styles (such as <span class="cmss-10">listgroup</span><a - id="dx1-73020"></a>) are incompatible with the <span + id="dx1-74020"></a>) are incompatible with the <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-73021"></a> and <span + id="dx1-74021"></a> and <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-73022"></a> options. -</p><!--l. 4517--><p class="indent" > The default is <span + id="dx1-74022"></a> options. +</p><!--l. 4625--><p class="indent" > The default is <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">standard</span><a - id="dx1-73023"></a>. When the standard sort option is in use, you can hook into the sort mechanism + id="dx1-74023"></a>. When the standard sort option is in use, you can hook into the sort mechanism by redefining: -</p><!--l. 4520--><p class="indent" > <hr><div title="Definition"><a - id="dx1-73024"></a> <span +</p><!--l. 4628--><p class="indent" > <hr><div title="Definition"><a + id="dx1-74024"></a> <span class="cmtt-10">\glsprestandardsort{</span>⟨<span class="cmitt-10">sort cs</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -10106,38 +10545,38 @@ class="cmitt-10">type</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 4522--><p class="noindent" > +</p><!--l. 4630--><p class="noindent" > where ⟨<span class="cmti-10">sort cs</span>⟩ is a temporary control sequence that stores the sort value (which was either explicitly set via the <span class="cmtt-10">sort</span><a - id="dx1-73025"></a> key or implicitly set via the <span + id="dx1-74025"></a> key or implicitly set via the <span class="cmtt-10">name</span><a - id="dx1-73026"></a> key) before any escaping of the <a + id="dx1-74026"></a> key) before any escaping of the <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-73027"></a></a>/<a + id="dx1-74027"></a></a>/<a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-73028"></a></a> special characters is + id="dx1-74028"></a></a> special characters is performed. By default <span class="cmtt-10">\glsprestandardsort </span>just does: -</p><!--l. 4528--><p class="indent" > <hr><div title="Definition"><a - id="dx1-73029"></a> <span +</p><!--l. 4636--><p class="indent" > <hr><div title="Definition"><a + id="dx1-74029"></a> <span class="cmtt-10">\glsdosanitizesort </span></div><hr> -</p><!--l. 4530--><p class="noindent" > +</p><!--l. 4638--><p class="noindent" > which <a href="#glo:sanitize">sanitize<a - id="dx1-73030"></a>s</a> ⟨<span + id="dx1-74030"></a>s</a> ⟨<span class="cmti-10">sort cs</span>⟩ if the <span class="cmss-10">sanitizesort</span><a - id="dx1-73031"></a> package option is set (or does nothing if the package option + id="dx1-74031"></a> package option is set (or does nothing if the package option <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-73032"></a> is used). -</p><!--l. 4535--><p class="indent" > The other arguments, ⟨<span + id="dx1-74032"></a> is used). +</p><!--l. 4643--><p class="indent" > The other arguments, ⟨<span class="cmti-10">type</span>⟩ and ⟨<span class="cmti-10">label</span>⟩, are the glossary type and the entry label for the current entry. Note that ⟨<span @@ -10145,26 +10584,26 @@ class="cmti-10">type</span>⟩ will always be a control sequence, but ' class="cmti-10">label</span>⟩ will be in the form used in the first argument of <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-73033"></a>. -</p><!--l. 4540--><p class="indent" > <div class="important" title="Important Note"> Redefining <span + id="dx1-74033"></a>. +</p><!--l. 4648--><p class="indent" > <div class="important" title="Important Note"> Redefining <span class="cmtt-10">\glsprestandardsort </span>won’t affect any entries that have already been defined and will have no effect at all if you are using <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-73034"></a> or <span + id="dx1-74034"></a> or <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-73035"></a>. </div> -</p><!--l. 4544--><p class="noindent" > + id="dx1-74035"></a>. </div> +</p><!--l. 4652--><p class="noindent" > <a id="ex:diffsorts"></a> -</p><!--l. 4546--><p class="noindent" ><span +</p><!--l. 4654--><p class="noindent" ><span class="cmbx-12">Example 1</span><span class="cmbx-12"> (Mixing Alphabetical and Order of Definition Sorting)</span><a - id="x1-73037"></a> -</p><!--l. 4547--><p class="indent" > Suppose I have three glossaries: <span + id="x1-74037"></a> +</p><!--l. 4655--><p class="indent" > Suppose I have three glossaries: <span class="cmtt-10">main</span>, <span class="cmtt-10">acronym </span>and <span class="cmtt-10">notation</span>, and let’s suppose I want the <span @@ -10173,22 +10612,22 @@ class="cmtt-10">main </span>and class="cmtt-10">acronym </span>glossaries to be sorted alphabetically, but the <span class="cmtt-10">notation </span>type should be sorted in order of definition. -</p><!--l. 4553--><p class="indent" > For <a +</p><!--l. 4661--><p class="indent" > For <a href="#option1">Option 1</a>, the <span class="cmtt-10">sort</span><a - id="dx1-73038"></a> option can be used in <span + id="dx1-74038"></a> option can be used in <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-73039"></a>: + id="dx1-74039"></a>: </p> - <div class="verbatim" id="verbatim-89"> + <pre class="verbatim" id="verbatim-93"> \printnoidxglossary[sort=word] - <br />\printnoidxglossary[type=acronym,sort=word] - <br />\printnoidxglossary[type=notation,sort=def] -</div> -<!--l. 4559--><p class="nopar" > -</p><!--l. 4561--><p class="indent" > For Options <a +\printnoidxglossary[type=acronym,sort=word] +\printnoidxglossary[type=notation,sort=def] +</pre> +<!--l. 4667--><p class="nopar" > +</p><!--l. 4669--><p class="indent" > For Options <a href="#option2">2</a> or <a href="#option3">3</a>, I can set the sort to <span class="cmtt-10">standard </span>(which is the default, but can be explicitly set via the @@ -10196,7 +10635,7 @@ package option <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">standard</span><a - id="dx1-73040"></a>), and I can either define all my <span + id="dx1-74040"></a>), and I can either define all my <span class="cmtt-10">main </span>and <span class="cmtt-10">acronym </span>entries, then redefine <span @@ -10209,52 +10648,52 @@ class="cmti-10">sort cs</span>⟩ if ⟨<span class="cmti-10">type</span>⟩ is <span class="cmtt-10">notation</span>. -</p><!--l. 4571--><p class="indent" > The first option can be achieved as follows: +</p><!--l. 4679--><p class="indent" > The first option can be achieved as follows: </p> - <div class="verbatim" id="verbatim-90"> + <pre class="verbatim" id="verbatim-94"> \newcounter{sortcount} - <br />\renewcommand{\glsprestandardsort}[3]{% - <br />  \stepcounter{sortcount}% - <br />  \edef#1{\glssortnumberfmt{\arabic{sortcount}}}% - <br />} -</div> -<!--l. 4579--><p class="nopar" > The second option can be achieved as follows: +\renewcommand{\glsprestandardsort}[3]{% +  \stepcounter{sortcount}% +  \edef#1{\glssortnumberfmt{\arabic{sortcount}}}% +} +</pre> +<!--l. 4687--><p class="nopar" > The second option can be achieved as follows: </p> - <div class="verbatim" id="verbatim-91"> + <pre class="verbatim" id="verbatim-95"> \newcounter{sortcount} - <br />\renewcommand{\glsprestandardsort}[3]{% - <br />  \ifdefstring{#2}{notation}% - <br />  {% - <br />     \stepcounter{sortcount}% - <br />     \edef#1{\glssortnumberfmt{\arabic{sortcount}}}% - <br />  }% - <br />  {% - <br />     \glsdosanitizesort - <br />  }% - <br />} -</div> -<!--l. 4594--><p class="nopar" > (<span +\renewcommand{\glsprestandardsort}[3]{% +  \ifdefstring{#2}{notation}% +  {% +     \stepcounter{sortcount}% +     \edef#1{\glssortnumberfmt{\arabic{sortcount}}}% +  }% +  {% +     \glsdosanitizesort +  }% +} +</pre> +<!--l. 4702--><p class="nopar" > (<span class="cmtt-10">\ifdefstring </span>is defined by the <span class="cmss-10">etoolbox</span><a - id="dx1-73041"></a> package.) For a complete document, see the sample file + id="dx1-74041"></a> package.) For a complete document, see the sample file <a href="#ex:sampleSort"><span class="cmtt-10">sampleSort.tex</span></a>. </p> <div class="center" > -<!--l. 4597--><p class="noindent" > -</p><!--l. 4597--><p class="noindent" >____________________________</p></div> +<!--l. 4705--><p class="noindent" > +</p><!--l. 4705--><p class="noindent" >____________________________</p></div> <a id="ex:customsort"></a> -<!--l. 4599--><p class="noindent" ><span +<!--l. 4707--><p class="noindent" ><span class="cmbx-12">Example 2</span><span class="cmbx-12"> (Customizing Standard Sort (Options 2 or 3))</span><a - id="x1-73043"></a> -</p><!--l. 4600--><p class="indent" > Suppose you want a glossary of people and you want the names listed as ⟨<span + id="x1-74043"></a> +</p><!--l. 4708--><p class="indent" > Suppose you want a glossary of people and you want the names listed as ⟨<span class="cmti-10">first-name</span>⟩ ⟨<span class="cmti-10">surname</span>⟩ in the glossary, but you want the names sorted by ⟨<span @@ -10267,28 +10706,28 @@ class="cmtt-10">}{</span>⟨<span class="cmti-10">surname</span>⟩<span class="cmtt-10">} </span>that you can use in the <span class="cmtt-10">name</span><a - id="dx1-73044"></a> key when you define the entry, but + id="dx1-74044"></a> key when you define the entry, but hook into the standard sort mechanism to temporarily redefine <span class="cmtt-10">\name </span>while the sort value is being set. -</p><!--l. 4609--><p class="indent" > First, define two commands to set the person’s name: +</p><!--l. 4717--><p class="indent" > First, define two commands to set the person’s name: </p> - <div class="verbatim" id="verbatim-92"> + <pre class="verbatim" id="verbatim-96"> \newcommand{\sortname}[2]{#2, #1} - <br />\newcommand{\textname}[2]{#1 #2} -</div> -<!--l. 4613--><p class="nopar" > and <span +\newcommand{\textname}[2]{#1 #2} +</pre> +<!--l. 4721--><p class="nopar" > and <span class="cmtt-10">\name </span>needs to be initialised to <span class="cmtt-10">\textname</span>: </p> - <div class="verbatim" id="verbatim-93"> + <pre class="verbatim" id="verbatim-97"> \let\name\textname -</div> -<!--l. 4617--><p class="nopar" > Now redefine <span +</pre> +<!--l. 4725--><p class="nopar" > Now redefine <span class="cmtt-10">\glsprestandardsort </span>so that it temporarily sets <span class="cmtt-10">\name </span>to <span class="cmtt-10">\sortname </span>and expands the sort @@ -10301,221 +10740,223 @@ text: </p> - <div class="verbatim" id="verbatim-94"> + <pre class="verbatim" id="verbatim-98"> \renewcommand{\glsprestandardsort}[3]{% - <br /> \let\name\sortname - <br /> \edef#1{\expandafter\expandonce\expandafter{#1}}% - <br /> \let\name\textname - <br /> \glsdosanitizesort - <br />} -</div> -<!--l. 4629--><p class="nopar" > (The somewhat complicate use of <span + \let\name\sortname + \edef#1{\expandafter\expandonce\expandafter{#1}}% + \let\name\textname + \glsdosanitizesort +} +</pre> +<!--l. 4737--><p class="nopar" > (The somewhat complicate use of <span class="cmtt-10">\expandafter </span>etc helps to protect fragile commands, but care is still needed.) -</p><!--l. 4633--><p class="indent" > Now the entries can be defined: +</p><!--l. 4741--><p class="indent" > Now the entries can be defined: </p> - <div class="verbatim" id="verbatim-95"> + <pre class="verbatim" id="verbatim-99"> \newglossaryentry{joebloggs}{name={\name{Joe}{Bloggs}}, - <br />  description={some information about Joe Bloggs}} - <br />\newglossaryentry{johnsmith}{name={\name{John}{Smith}}, - <br />  description={some information about John Smith}} -</div> -<!--l. 4640--><p class="nopar" > For a complete document, see the sample file <a +  description={some information about Joe Bloggs}} +\newglossaryentry{johnsmith}{name={\name{John}{Smith}}, +  description={some information about John Smith}} +</pre> +<!--l. 4748--><p class="nopar" > For a complete document, see the sample file <a href="#ex:samplePeople"><span class="cmtt-10">samplePeople.tex</span></a>. </p> <div class="center" > -<!--l. 4642--><p class="noindent" > -</p><!--l. 4642--><p class="noindent" >____________________________</p></div> -<!--l. 4644--><p class="noindent" > +<!--l. 4750--><p class="noindent" > +</p><!--l. 4750--><p class="noindent" >____________________________</p></div> +<!--l. 4752--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-740002.5"></a><a + id="x1-750002.5"></a><a id="pkgopt:order"></a><span class="cmss-10">order=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4644--><p class="noindent" >This may take two values: <span +<!--l. 4752--><p class="noindent" >This may take two values: <span class="cmss-10">word</span><a - id="dx1-74001"></a> or <span + id="dx1-75001"></a> or <span class="cmss-10">letter</span><a - id="dx1-74002"></a>. The default is word ordering. -</p><!--l. 4648--><p class="indent" > <div class="important" title="Important Note"> Note that with Options <a + id="dx1-75002"></a>. The default is word ordering. +</p><!--l. 4756--><p class="indent" > <div class="important" title="Important Note"> Note that with Options <a href="#option2">2</a> and <a href="#option3">3</a>, the <span class="cmss-10">order</span><a - id="dx1-74003"></a> option has no effect if you don’t use <a + id="dx1-75003"></a> option has no effect if you don’t use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-74004"></a></a>. + id="dx1-75004"></a></a>. </div> -</p><!--l. 4651--><p class="noindent" > -</p><!--l. 4653--><p class="indent" > If you use <a +</p><!--l. 4759--><p class="noindent" > +</p><!--l. 4761--><p class="indent" > If you use <a href="#option1">Option 1</a>, this setting will be used if you use <span class="cmtt-10">sort</span><a - id="dx1-74005"></a><span + id="dx1-75005"></a><span class="cmtt-10">=standard </span>in the optional argument of <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-74006"></a>: + id="dx1-75006"></a>: </p> - <div class="verbatim" id="verbatim-96"> + <pre class="verbatim" id="verbatim-100"> \printnoidxglossary[sort=standard] -</div> -<!--l. 4658--><p class="nopar" > Alternatively, you can specify the order for individual glossaries: +</pre> +<!--l. 4766--><p class="nopar" > Alternatively, you can specify the order for individual glossaries: </p> - <div class="verbatim" id="verbatim-97"> + <pre class="verbatim" id="verbatim-101"> \printnoidxglossary[sort=word] - <br />\printnoidxglossary[type=acronym,sort=letter] -</div> -<!--l. 4663--><p class="nopar" > -</p><!--l. 4665--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a +\printnoidxglossary[type=acronym,sort=letter] +</pre> +<!--l. 4771--><p class="nopar" > +</p><!--l. 4773--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-74007"></a></a>, use the <span id="textcolor233"><span + id="dx1-75007"></a></a>, use the <span id="textcolor238"><span class="cmtt-10">break-at</span></span><a - id="dx1-74008"></a> option in <span id="textcolor234"><span + id="dx1-75008"></a> option in <span id="textcolor239"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-74009"></a> instead of <span + id="dx1-75009"></a> instead of <span class="cmss-10">order</span>. </div> -</p><!--l. 4668--><p class="noindent" > -</p><!--l. 4670--><p class="noindent" > +</p><!--l. 4776--><p class="noindent" > +</p><!--l. 4778--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-750002.5"></a><a + id="x1-760002.5"></a><a id="pkgopt:makeindex"></a><span class="cmss-10">makeindex</span></h4> -<!--l. 4670--><p class="noindent" >(<a +<!--l. 4778--><p class="noindent" >(<a href="#option2">Option 2</a>) The glossary information and indexing style file will be written in <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-75001"></a></a> format. If you use + id="dx1-76001"></a></a> format. If you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-75002"></a></a>, it will automatically detect that it needs to call <span + id="dx1-76002"></a></a>, it will automatically detect that it needs to call <span class="cmtt-10">makeindex</span><a - id="dx1-75003"></a>. If you don’t use <span + id="dx1-76003"></a>. If you don’t use <span class="cmtt-10">makeglossaries</span><a - id="dx1-75004"></a>, + id="dx1-76004"></a>, you need to remember to use <span class="cmtt-10">makeindex</span><a - id="dx1-75005"></a> not <a + id="dx1-76005"></a> not <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-75006"></a></a>. The indexing style file will been given a <span + id="dx1-76006"></a></a>. The indexing style file will been given a <span class="cmtt-10">ist</span><a - id="dx1-75007"></a> + id="dx1-76007"></a> extension. -</p><!--l. 4678--><p class="indent" > You may omit this package option if you are using <a +</p><!--l. 4786--><p class="indent" > You may omit this package option if you are using <a href="#option2">Option 2</a> as this is the default. It’s available in case you need to override the effect of an earlier occurrence of <span class="cmss-10">xindy</span><a - id="dx1-75008"></a> in the package option list. -</p><!--l. 4682--><p class="noindent" > + id="dx1-76008"></a> in the package option list. +</p><!--l. 4790--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-760002.5"></a><a + id="x1-770002.5"></a><a id="pkgopt:xindy"></a><span class="cmss-10">xindy</span></h4> -<!--l. 4682--><p class="noindent" >(<a +<!--l. 4790--><p class="noindent" >(<a href="#option3">Option 3</a>) The glossary information and indexing style file will be written in <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-76001"></a></a> format. If you use + id="dx1-77001"></a></a> format. If you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-76002"></a></a>, it will automatically detect that it needs to call <span + id="dx1-77002"></a></a>, it will automatically detect that it needs to call <span class="cmtt-10">xindy</span><a - id="dx1-76003"></a>. If you don’t use <span + id="dx1-77003"></a>. If you don’t use <span class="cmtt-10">makeglossaries</span><a - id="dx1-76004"></a>, + id="dx1-77004"></a>, you need to remember to use <span class="cmtt-10">xindy</span><a - id="dx1-76005"></a> not <a + id="dx1-77005"></a> not <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-76006"></a></a>. The indexing style file will been given a <span + id="dx1-77006"></a></a>. The indexing style file will been given a <span class="cmtt-10">xdy</span><a - id="dx1-76007"></a> + id="dx1-77007"></a> extension. -</p><!--l. 4689--><p class="indent" > This package option may additionally have a value that is a ⟨<span +</p><!--l. 4797--><p class="indent" > This package option may additionally have a value that is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ comma-separated list to override the language and codepage. For example: </p> - <div class="verbatim" id="verbatim-98"> + <pre class="verbatim" id="verbatim-102"> \usepackage[xindy={language=english,codepage=utf8}] - <br />  {glossaries} -</div> -<!--l. 4695--><p class="nopar" > You can also specify whether you want a number group in the glossary. This defaults to true, but can be +  {glossaries} +</pre> +<!--l. 4803--><p class="nopar" > You can also specify whether you want a number group in the glossary. This defaults to true, but can be suppressed. For example: </p> - <div class="verbatim" id="verbatim-99"> + <pre class="verbatim" id="verbatim-103"> \usepackage[xindy={glsnumbers=false}]{glossaries} -</div> -<!--l. 4700--><p class="nopar" > If no value is supplied to this package option (either simply writing <span +</pre> +<!--l. 4808--><p class="nopar" > If no value is supplied to this package option (either simply writing <span class="cmtt-10">xindy </span>or writing <span class="obeylines-h"><span class="verb"><span class="cmtt-10">xindy={}</span></span></span>) then the language, codepage and number group settings are unchanged. See <a -href="#sec:xindy">§11 </a><a -href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a> for further details on -using <a +href="#sec:xindy">§<span +class="cmbx-10">??</span>sec:xindy </a><a +href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a> for further +details on using <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-76008"></a></a> with the <span + id="dx1-77008"></a></a> with the <span class="cmss-10">glossaries </span>package. -</p><!--l. 4707--><p class="noindent" > +</p><!--l. 4815--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-770002.5"></a><a + id="x1-780002.5"></a><a id="pkgopt:xindygloss"></a><span class="cmss-10">xindygloss</span></h4> -<!--l. 4707--><p class="noindent" >(<a +<!--l. 4815--><p class="noindent" >(<a href="#option3">Option 3</a>) This is equivalent to <span class="obeylines-h"><span class="verb"><span class="cmtt-10">xindy={}</span></span></span> (that is, the <span class="cmss-10">xindy</span><a - id="dx1-77001"></a> option without any value supplied) and may be + id="dx1-78001"></a> option without any value supplied) and may be used as a document class option. The language and code page can be set via <span class="cmtt-10">\GlsSetXdyLanguage</span><a - id="dx1-77002"></a> and + id="dx1-78002"></a> and <span class="cmtt-10">\GlsSetXdyCodePage</span><a - id="dx1-77003"></a> (see <a -href="#sec:langenc">§11.1 </a><a + id="dx1-78003"></a> (see <a +href="#sec:langenc">§<span +class="cmbx-10">??</span>sec:langenc </a><a href="#sec:langenc">Language and Encodings<!--tex4ht:ref: sec:langenc --></a>.) -</p><!--l. 4713--><p class="noindent" > +</p><!--l. 4821--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-780002.5"></a><a + id="x1-790002.5"></a><a id="pkgopt:xindynoglsnumbers"></a><span class="cmss-10">xindynoglsnumbers</span></h4> -<!--l. 4713--><p class="noindent" >(<a +<!--l. 4821--><p class="noindent" >(<a href="#option3">Option 3</a>) This is equivalent to <span class="obeylines-h"><span class="verb"><span class="cmtt-10">xindy={glsnumbers=false}</span></span></span> and may be used as a document class option. -</p><!--l. 4717--><p class="noindent" > +</p><!--l. 4825--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-790002.5"></a><a + id="x1-800002.5"></a><a id="pkgopt:automake"></a><span class="cmss-10">automake=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4717--><p class="noindent" >This is option was introduced to version 4.08 as a boolean option. As from version 4.42 it may now take three +<!--l. 4825--><p class="noindent" >This is option was introduced to version 4.08 as a boolean option. As from version 4.42 it may now take three values: <span class="cmtt-10">false </span>(default), <span class="cmtt-10">true </span>or <span @@ -10525,36 +10966,36 @@ option <span class="cmss-10">automake</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-79001"></a> will attempt to run <a + id="dx1-80001"></a> will attempt to run <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-79002"></a></a> or <a + id="dx1-80002"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-79003"></a></a> using TeX’s <span + id="dx1-80003"></a></a> using TeX’s <span class="cmtt-10">\write18</span><a - id="dx1-79004"></a> mechanism + id="dx1-80004"></a> mechanism at the end of the document. The option <span class="cmss-10">automake</span><span class="cmtt-10">=</span><span class="cmss-10">immediate</span><a - id="dx1-79005"></a> will attempt to run <a + id="dx1-80005"></a> will attempt to run <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-79006"></a></a> or + id="dx1-80006"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-79007"></a></a> at the start of <span + id="dx1-80007"></a></a> at the start of <span class="cmtt-10">\makeglossaries</span><a - id="dx1-79008"></a> using <span + id="dx1-80008"></a> using <span class="cmtt-10">\immediate </span>(before the glossary files have been opened). -</p><!--l. 4728--><p class="indent" > In the case of <span +</p><!--l. 4836--><p class="indent" > In the case of <span 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 + id="dx1-80009"></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 @@ -10566,103 +11007,104 @@ class="cmtt-10">\write18 </span>fails. In such cases, you will need to use <span class="cmss-10">automake</span><span class="cmtt-10">=</span><span class="cmss-10">immediate</span><a - id="dx1-79010"></a> + id="dx1-80010"></a> instead. -</p><!--l. 4738--><p class="indent" > With <span +</p><!--l. 4846--><p class="indent" > With <span 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 LaTeX run as the associated glossary files + id="dx1-80011"></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 TeX distributions disable it completely, in which case this +</p><!--l. 4850--><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 +</p><!--l. 4856--><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 href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-79012"></a></a> but may not include <a + id="dx1-80012"></a></a> but may not include <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-79013"></a></a>. So if you have the restricted mode + id="dx1-80013"></a></a>. So if you have the restricted mode on, <span class="cmss-10">automake</span><a - id="dx1-79014"></a> should work with <span + id="dx1-80014"></a> should work with <span class="cmtt-10">makeindex</span><a - id="dx1-79015"></a> but may not work with <a + id="dx1-80015"></a> but may not work with <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-79016"></a></a>. -</p><!--l. 4754--><p class="indent" > However even in unrestricted mode this option may not work with <span + id="dx1-80016"></a></a>. +</p><!--l. 4862--><p class="indent" > However even in unrestricted mode this option may not work with <span class="cmtt-10">xindy</span><a - id="dx1-79017"></a> as <span + id="dx1-80017"></a> as <span class="cmtt-10">xindy</span><a - id="dx1-79018"></a> uses language names that + id="dx1-80018"></a> uses language names that don’t always correspond with <span -class="cmtt-10">\babel</span><a - id="dx1-79019"></a>’s language names. (The <a +class="cmss-10">babel</span><a + id="dx1-80019"></a>’s language names. (The <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-79020"></a></a> script applies mappings to assist + id="dx1-80020"></a></a> script applies mappings to assist 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 +</p><!--l. 4869--><p class="indent" > Since this package option attempts to run the <a 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 class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-79021"></a>. -</p><!--l. 4767--><p class="noindent" > + id="dx1-80021"></a>. +</p><!--l. 4875--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-800002.5"></a><a + id="x1-810002.5"></a><a id="pkgopt:disablemakegloss"></a><span class="cmss-10">disablemakegloss</span></h4> -<!--l. 4767--><p class="noindent" >This valueless option indicates that <span +<!--l. 4875--><p class="noindent" >This valueless option indicates that <span class="cmtt-10">\makeglossaries</span><a - id="dx1-80001"></a> and <span + id="dx1-81001"></a> and <span class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-80002"></a> should be disabled. This -option is provided in the event that you have to use a class or package that disregards the advice in <a -href="#sec:indexingoptions">§1.1 </a><a -href="#sec:indexingoptions">Indexing -Options<!--tex4ht:ref: sec:indexingoptions --></a> and automatically performs <span + id="dx1-81002"></a> should be disabled. +This option is provided in the event that you have to use a class or package that disregards the +advice in <a +href="#sec:indexingoptions">§<span +class="cmbx-10">??</span>sec:indexingoptions </a><a +href="#sec:indexingoptions">Indexing Options<!--tex4ht:ref: sec:indexingoptions --></a> and automatically performs <span class="cmtt-10">\makeglossaries</span><a - id="dx1-80003"></a> or <span + id="dx1-81003"></a> or +<span class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-80004"></a> but you don’t want this. (For -example, you want to use a different indexing method or you want to disable indexing while working on a draft -document.) -</p><!--l. 4777--><p class="indent" > This option may be passed in the standard document class option list or passed using <span + id="dx1-81004"></a> but you don’t want this. (For example, you want to use a different indexing method or +you want to disable indexing while working on a draft document.) +</p><!--l. 4885--><p class="indent" > This option may be passed in the standard document class option list or passed using <span class="cmtt-10">\PassOptionsToPackage</span> before <span class="cmss-10">glossaries</span><a - id="dx1-80005"></a> is loaded. Note that this does nothing if <span + id="dx1-81005"></a> is loaded. Note that this does nothing if <span class="cmtt-10">\makeglossaries</span><a - id="dx1-80006"></a> or <span + id="dx1-81006"></a> or <span class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-80007"></a> has + id="dx1-81007"></a> has already been used whilst enabled. -</p><!--l. 4783--><p class="noindent" > +</p><!--l. 4891--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-810002.5"></a><a + id="x1-820002.5"></a><a id="pkgopt:restoremakegloss"></a><span class="cmss-10">restoremakegloss</span></h4> -<!--l. 4783--><p class="noindent" >Cancels the effect of <span +<!--l. 4891--><p class="noindent" >Cancels the effect of <span class="cmss-10">disablemakegloss</span><a - id="dx1-81001"></a>. This option may be used in <span + id="dx1-82001"></a>. This option may be used in <span class="cmtt-10">\setupglossaries</span>. It issues a warning if <span class="cmtt-10">\makeglossaries</span><a - id="dx1-81002"></a> or <span + id="dx1-82002"></a> or <span class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-81003"></a> has already been used whilst enabled. For + id="dx1-82003"></a> has already been used whilst enabled. For example, suppose the class <span class="cmss-10">customclass.cls </span>automatically loads <span class="cmss-10">glossaries </span>and does <span @@ -10673,34 +11115,34 @@ do: </p> - <div class="verbatim" id="verbatim-100"> + <pre class="verbatim" id="verbatim-104"> \documentclass[disablemakegloss]{customclass} - <br />\newglossary*{functions}{Functions} - <br />\setupglossaries{restoremakegloss} - <br />\makeglossaries -</div> -<!--l. 4796--><p class="nopar" > or +\newglossary*{functions}{Functions} +\setupglossaries{restoremakegloss} +\makeglossaries +</pre> +<!--l. 4904--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-101"> + <pre class="verbatim" id="verbatim-105"> \PassOptionsToPackage{disablemakegloss}{glossaries} - <br />\documentclass{customclass} - <br />\newglossary*{functions}{Functions} - <br />\setupglossaries{restoremakegloss} - <br />\makeglossaries -</div> -<!--l. 4804--><p class="nopar" > -</p><!--l. 4806--><p class="indent" > Note that restoring these commands doesn’t necessarily mean that they can be used. It just means that their -normal behaviour given the current settings will apply. For example, if you use the <span id="textcolor235"><span +\documentclass{customclass} +\newglossary*{functions}{Functions} +\setupglossaries{restoremakegloss} +\makeglossaries +</pre> +<!--l. 4912--><p class="nopar" > +</p><!--l. 4914--><p class="indent" > Note that restoring these commands doesn’t necessarily mean that they can be used. It just means that their +normal behaviour given the current settings will apply. For example, if you use the <span id="textcolor240"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">only</span></span><a - id="dx1-81004"></a> or <span id="textcolor236"><span + id="dx1-82004"></a> or <span id="textcolor241"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-81005"></a> + id="dx1-82005"></a> options with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> then you can’t use <span @@ -10708,86 +11150,90 @@ class="cmtt-10">\makeglossaries </span>or <span class="cmtt-10">\makenoidxglossaries </span>regardless of <span class="cmss-10">restoremakegloss</span><a - id="dx1-81006"></a>. -</p><!--l. 4813--><p class="noindent" > + id="dx1-82006"></a>. +</p><!--l. 4921--><p class="noindent" > </p> -<!--l. 4813--><p class="noindent" ><a +<!--l. 4921--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.6 </span> <a id="sec:pkgopts-type"></a>Glossary Type Options</h3> -<!--l. 4816--><p class="noindent" > +<!--l. 4924--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-830002.6"></a><a + id="x1-840002.6"></a><a id="pkgopt:nohypertypes"></a><span class="cmss-10">nohypertypes=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">list</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4816--><p class="noindent" >Use this option if you have multiple glossaries and you want to suppress the entry hyperlinks for a particular +<!--l. 4924--><p class="noindent" >Use this option if you have multiple glossaries and you want to suppress the entry hyperlinks for a particular glossary or glossaries. The value of this option should be a comma-separated list of glossary types where <span class="cmtt-10">\gls</span><a - id="dx1-83001"></a> + id="dx1-84001"></a> etc shouldn’t have hyperlinks by default. Make sure you enclose the value in braces if it contains any commas. Example: </p> - <div class="verbatim" id="verbatim-102"> + <pre class="verbatim" id="verbatim-106"> \usepackage[acronym,nohypertypes={acronym,notation}] - <br />  {glossaries} - <br />\newglossary[nlg]{notation}{not}{ntn}{Notation} -</div> -<!--l. 4826--><p class="nopar" > The values must be fully expanded, so <strong>don’t</strong> try <span +  {glossaries} +\newglossary[nlg]{notation}{not}{ntn}{Notation} +</pre> +<!--l. 4934--><p class="nopar" > The values must be fully expanded, so <strong>don’t</strong> try <span class="cmtt-10">nohypertypes=\acronymtype</span><a - id="dx1-83002"></a>. You may also + id="dx1-84002"></a>. You may also use -</p><!--l. 4830--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 4938--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\GlsDeclareNoHyperList</span><a - id="dx1-83003"></a><span + id="dx1-84003"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 4831--><p class="noindent" > +</p><!--l. 4939--><p class="noindent" > instead or additionally. See <a -href="#sec:glslink">§6 </a><a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink </a><a href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> for further details. -</p><!--l. 4835--><p class="noindent" > +</p><!--l. 4943--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-840002.6"></a><a + id="x1-850002.6"></a><a id="pkgopt:nomain"></a><span class="cmss-10">nomain</span></h4> -<!--l. 4835--><p class="noindent" >This suppresses the creation of the main glossary and associated <span +<!--l. 4943--><p class="noindent" >This suppresses the creation of the main glossary and associated <span class="cmtt-10">glo</span><a - id="dx1-84001"></a> file, if unrequired. Note that if you use this + id="dx1-85001"></a> file, if unrequired. Note that if you use this option, you must create another glossary in which to put all your entries (either via the <span class="cmss-10">acronym</span><a - id="dx1-84002"></a> (or <span + id="dx1-85002"></a> (or <span class="cmss-10">acronyms</span><a - id="dx1-84003"></a>) + id="dx1-85003"></a>) package option described in <a -href="#sec:pkgopts-acronym">§2.7 </a><a +href="#sec:pkgopts-acronym">§<span +class="cmbx-10">??</span>sec:pkgopts-acronym </a><a href="#sec:pkgopts-acronym">Acronym and Abbreviation Options<!--tex4ht:ref: sec:pkgopts-acronym --></a> or via the <span class="cmss-10">symbols</span><a - id="dx1-84004"></a>, <span -class="cmss-10">numbers</span><a - id="dx1-84005"></a> or + id="dx1-85004"></a>, <span +class="cmss-10">numbers</span><a + id="dx1-85005"></a> or <span class="cmss-10">index</span><a - id="dx1-84006"></a> options described in <a -href="#sec:pkgopts-other">§2.8 </a><a + id="dx1-85006"></a> options described in <a +href="#sec:pkgopts-other">§<span +class="cmbx-10">??</span>sec:pkgopts-other </a><a href="#sec:pkgopts-other">Other Options<!--tex4ht:ref: sec:pkgopts-other --></a> or via <span class="cmtt-10">\newglossary</span><a - id="dx1-84007"></a> described in <a -href="#sec:newglossary">§12 </a><a -href="#sec:newglossary">Defining New -Glossaries<!--tex4ht:ref: sec:newglossary --></a>). -</p><!--l. 4845--><p class="indent" > <div class="important" title="Important Note"> If you don’t use the main glossary and you don’t use this option, <a + id="dx1-85007"></a> described in +<a +href="#sec:newglossary">§<span +class="cmbx-10">??</span>sec:newglossary </a><a +href="#sec:newglossary">Defining New Glossaries<!--tex4ht:ref: sec:newglossary --></a>). +</p><!--l. 4953--><p class="indent" > <div class="important" title="Important Note"> If you don’t use the main glossary and you don’t use this option, <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-84008"></a></a> will produce a warning. + id="dx1-85008"></a></a> will produce a warning. </div> -</p><!--l. 4848--><p class="noindent" > +</p><!--l. 4956--><p class="noindent" > </p><div class="alltt"> <div class="obeylines-v"> <span @@ -10830,153 +11276,153 @@ class="cmtt-10"> glossary.</span> </div> If you did actually want to use the main glossary and you see this warning, check that you have referenced the entries in that glossary via commands such as <span class="cmtt-10">\gls</span><a - id="dx1-84009"></a>. -<!--l. 4860--><p class="noindent" > + id="dx1-85009"></a>. +<!--l. 4968--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-850002.6"></a><a + id="x1-860002.6"></a><a id="pkgopt:symbols"></a><span class="cmss-10">symbols</span></h4> -<!--l. 4860--><p class="noindent" >This valueless option defines a new glossary type with the label <span +<!--l. 4968--><p class="noindent" >This valueless option defines a new glossary type with the label <span class="cmtt-10">symbols </span>via </p> - <div class="verbatim" id="verbatim-103"> + <pre class="verbatim" id="verbatim-107"> \newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname} -</div> -<!--l. 4864--><p class="nopar" > It also defines -</p><!--l. 4866--><p class="indent" > <hr><div title="Definition"><a - id="dx1-85001"></a> <span +</pre> +<!--l. 4972--><p class="nopar" > It also defines +</p><!--l. 4974--><p class="indent" > <hr><div title="Definition"><a + id="dx1-86001"></a> <span class="cmtt-10">\printsymbols[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 4868--><p class="noindent" > +</p><!--l. 4976--><p class="noindent" > which is a synonym for </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printglossary</span><a - id="dx1-85002"></a><span + id="dx1-86002"></a><span class="cmtt-10">[type=symbols,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> -<!--l. 4874--><p class="indent" > If you use <a +<!--l. 4982--><p class="indent" > If you use <a href="#option1">Option 1</a>, you need to use: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-85003"></a><span + id="dx1-86003"></a><span class="cmtt-10">[type=symbols,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> to display the list of symbols. -<!--l. 4880--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span +<!--l. 4988--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span class="cmss-10">nomain</span><a - id="dx1-85004"></a> package option if you’re only interested in using this <span + id="dx1-86004"></a> package option if you’re only interested in using this <span class="cmtt-10">symbols </span>glossary and don’t intend to use the <span class="cmtt-10">main </span>glossary. </div> -</p><!--l. 4884--><p class="noindent" > -</p><!--l. 4886--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 4992--><p class="noindent" > +</p><!--l. 4994--><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 a slightly modified version of this option which additionally provides -<span id="textcolor237"><span +<span id="textcolor242"><span class="cmtt-10">\glsxtrnewsymbol</span></span><a - id="dx1-85005"></a> as a convenient shortcut method for defining symbols. See the <a + id="dx1-86005"></a> as a convenient shortcut method for defining symbols. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. </div> -</p><!--l. 4891--><p class="noindent" > -</p><!--l. 4893--><p class="noindent" > +</p><!--l. 4999--><p class="noindent" > +</p><!--l. 5001--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-860002.6"></a><a + id="x1-870002.6"></a><a id="pkgopt:numbers"></a><span class="cmss-10">numbers</span></h4> -<!--l. 4893--><p class="noindent" >This valueless option defines a new glossary type with the label <span +<!--l. 5001--><p class="noindent" >This valueless option defines a new glossary type with the label <span class="cmtt-10">numbers </span>via </p> - <div class="verbatim" id="verbatim-104"> + <pre class="verbatim" id="verbatim-108"> \newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname} -</div> -<!--l. 4897--><p class="nopar" > It also defines -</p><!--l. 4899--><p class="indent" > <hr><div title="Definition"><a - id="dx1-86001"></a> <span +</pre> +<!--l. 5005--><p class="nopar" > It also defines +</p><!--l. 5007--><p class="indent" > <hr><div title="Definition"><a + id="dx1-87001"></a> <span class="cmtt-10">\printnumbers[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 4901--><p class="noindent" > +</p><!--l. 5009--><p class="noindent" > which is a synonym for </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printglossary</span><a - id="dx1-86002"></a><span + id="dx1-87002"></a><span class="cmtt-10">[type=numbers,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> -<!--l. 4907--><p class="indent" > If you use <a +<!--l. 5015--><p class="indent" > If you use <a href="#option1">Option 1</a>, you need to use: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-86003"></a><span + id="dx1-87003"></a><span class="cmtt-10">[type=numbers,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> to display the list of numbers. -<!--l. 4913--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span +<!--l. 5021--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span class="cmss-10">nomain</span><a - id="dx1-86004"></a> package option if you’re only interested in using this <span + id="dx1-87004"></a> package option if you’re only interested in using this <span class="cmtt-10">numbers </span>glossary and don’t intend to use the <span class="cmtt-10">main </span>glossary. </div> -</p><!--l. 4917--><p class="noindent" > -</p><!--l. 4919--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 5025--><p class="noindent" > +</p><!--l. 5027--><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 a slightly modified version of this option which additionally provides -<span id="textcolor238"><span +<span id="textcolor243"><span class="cmtt-10">\glsxtrnewnumber</span></span><a - id="dx1-86005"></a> as a convenient shortcut method for defining numbers. See the <a + id="dx1-87005"></a> as a convenient shortcut method for defining numbers. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. </div> -</p><!--l. 4924--><p class="noindent" > -</p><!--l. 4926--><p class="noindent" > +</p><!--l. 5032--><p class="noindent" > +</p><!--l. 5034--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-870002.6"></a><a + id="x1-880002.6"></a><a id="pkgopt:index"></a><span class="cmss-10">index</span></h4> -<!--l. 4926--><p class="noindent" >This valueless option defines a new glossary type with the label <span +<!--l. 5034--><p class="noindent" >This valueless option defines a new glossary type with the label <span class="cmtt-10">index </span>via </p> - <div class="verbatim" id="verbatim-105"> + <pre class="verbatim" id="verbatim-109"> \newglossary[ilg]{index}{ind}{idx}{\indexname}% -</div> -<!--l. 4930--><p class="nopar" > It also defines -</p><!--l. 4932--><p class="indent" > <hr><div title="Definition"><a - id="dx1-87001"></a> <span +</pre> +<!--l. 5038--><p class="nopar" > It also defines +</p><!--l. 5040--><p class="indent" > <hr><div title="Definition"><a + id="dx1-88001"></a> <span class="cmtt-10">\newterm[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span class="cmitt-10">term</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 4934--><p class="noindent" > +</p><!--l. 5042--><p class="noindent" > which is a synonym for </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-87002"></a><span + id="dx1-88002"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">term</span>⟩<span class="cmtt-10">}[type=index,name={</span>⟨<span @@ -10984,126 +11430,126 @@ class="cmitt-10">term</span>⟩<span class="cmtt-10">},%</span> <br /><span class="cmtt-10">description=\nopostdesc</span><a - id="dx1-87003"></a><span + id="dx1-88003"></a><span class="cmtt-10">,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> and -<!--l. 4941--><p class="indent" > <hr><div title="Definition"><a - id="dx1-87004"></a> <span +<!--l. 5049--><p class="indent" > <hr><div title="Definition"><a + id="dx1-88004"></a> <span class="cmtt-10">\printindex[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 4943--><p class="noindent" > +</p><!--l. 5051--><p class="noindent" > which is a synonym for </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printglossary</span><a - id="dx1-87005"></a><span + id="dx1-88005"></a><span class="cmtt-10">[type=index,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> -<!--l. 4949--><p class="indent" > If you use <a +<!--l. 5057--><p class="indent" > If you use <a href="#option1">Option 1</a>, you need to use: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-87006"></a><span + id="dx1-88006"></a><span class="cmtt-10">[type=index,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> to display this glossary. -<!--l. 4955--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span +<!--l. 5063--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span class="cmss-10">nomain</span><a - id="dx1-87007"></a> package option if you’re only interested in using this <span + id="dx1-88007"></a> package option if you’re only interested in using this <span class="cmtt-10">index </span>glossary and don’t intend to use the <span class="cmtt-10">main </span>glossary. Note that you can’t mix this option with <span class="cmtt-10">\index</span><a - id="dx1-87008"></a>. Either use + id="dx1-88008"></a>. Either use <span class="cmss-10">glossaries </span>for the indexing or use a custom indexing package, such as <span class="cmss-10">makeidx</span><a - id="dx1-87009"></a>, <span + id="dx1-88009"></a>, <span class="cmss-10">index</span><a - id="dx1-87010"></a> or <span + id="dx1-88010"></a> or <span class="cmss-10">imakeidx</span><a - id="dx1-87011"></a>. (You + id="dx1-88011"></a>. (You can, of course, load one of those packages and load <span class="cmss-10">glossaries </span>without the <span class="cmss-10">index</span><a - id="dx1-87012"></a> package option.) + id="dx1-88012"></a> package option.) </div> -</p><!--l. 4964--><p class="noindent" > -</p><!--l. 4966--><p class="indent" > Since the index isn’t designed for terms with descriptions, you might also want to disable the hyperlinks for +</p><!--l. 5072--><p class="noindent" > +</p><!--l. 5074--><p class="indent" > Since the index isn’t designed for terms with descriptions, you might also want to disable the hyperlinks for this glossary using the package option <span class="cmss-10">nohypertypes</span><span class="cmtt-10">=</span><span class="cmss-10">index</span><a - id="dx1-87013"></a> or the command <spacer type=vertical size=10><span class="obeylines-h"> + id="dx1-88013"></a> or the command <spacer type=vertical size=10><span class="obeylines-h"> <br /><span class="cmtt-10">\GlsDeclareNoHyperList</span><a - id="dx1-87014"></a><span class="verb"><span + id="dx1-88014"></a><span class="verb"><span class="cmtt-10">{index}</span></span> <br /><spacer type=vertical size=10></span> -</p><!--l. 4973--><p class="indent" > The example file <a +</p><!--l. 5081--><p class="indent" > The example file <a href="#ex:sample-index"><span class="cmtt-10">sample-index.tex</span></a> illustrates the use of the <span class="cmss-10">index</span><a - id="dx1-87015"></a> package option. + id="dx1-88015"></a> package option. -</p><!--l. 4976--><p class="noindent" > +</p><!--l. 5084--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-880002.6"></a><a + id="x1-890002.6"></a><a id="pkgopt:noglossaryindex"></a><span class="cmss-10">noglossaryindex</span></h4> -<!--l. 4976--><p class="noindent" >This valueless option switches off <span +<!--l. 5084--><p class="noindent" >This valueless option switches off <span class="cmss-10">index</span><a - id="dx1-88001"></a> if <span + id="dx1-89001"></a> if <span class="cmss-10">index</span><a - id="dx1-88002"></a> has been passed implicitly (for example, through global + id="dx1-89002"></a> has been passed implicitly (for example, through global document options). This option can’t be used in <span class="cmtt-10">\setupglossaries</span>. -</p><!--l. 4982--><p class="noindent" > +</p><!--l. 5090--><p class="noindent" > </p> -<!--l. 4982--><p class="noindent" ><a +<!--l. 5090--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.7 </span> <a id="sec:pkgopts-acronym"></a>Acronym and Abbreviation Options</h3> -<!--l. 4985--><p class="noindent" > +<!--l. 5093--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-900002.7"></a><a + id="x1-910002.7"></a><a id="pkgopt:acronym"></a><span class="cmss-10">acronym=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 4985--><p class="noindent" >If true, this creates a new glossary with the label <span +<!--l. 5093--><p class="noindent" >If true, this creates a new glossary with the label <span class="cmtt-10">acronym</span>. This is equivalent to: </p> - <div class="verbatim" id="verbatim-106"> + <pre class="verbatim" id="verbatim-110"> \newglossary[alg]{acronym}{acr}{acn}{\acronymname} -</div> -<!--l. 4989--><p class="nopar" > It will also define -</p><!--l. 4991--><p class="indent" > <hr><div title="Definition"><a - id="dx1-90001"></a> <span +</pre> +<!--l. 5097--><p class="nopar" > It will also define +</p><!--l. 5099--><p class="indent" > <hr><div title="Definition"><a + id="dx1-91001"></a> <span class="cmtt-10">\printacronyms[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 4993--><p class="noindent" > +</p><!--l. 5101--><p class="noindent" > that’s equivalent to </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printglossary</span><a - id="dx1-90002"></a><span + id="dx1-91002"></a><span class="cmtt-10">[type=acronym,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> @@ -11111,162 +11557,162 @@ class="cmtt-10">]</span> </div> (unless that command is already defined before the beginning of the document or the package option <span class="cmss-10">compatible-3.07</span><a - id="dx1-90003"></a> is used). -<!--l. 5001--><p class="indent" > If you are using <a + id="dx1-91003"></a> is used). +<!--l. 5109--><p class="indent" > If you are using <a href="#option1">Option 1</a>, you need to use </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-90004"></a><span + id="dx1-91004"></a><span class="cmtt-10">[type=acronym,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> to display the list of acronyms. -<!--l. 5007--><p class="indent" > If the <span +<!--l. 5115--><p class="indent" > If the <span class="cmss-10">acronym</span><a - id="dx1-90005"></a> package option is used, <span + id="dx1-91005"></a> package option is used, <span class="cmtt-10">\acronymtype</span><a - id="dx1-90006"></a> is set to <span + id="dx1-91006"></a> is set to <span class="cmtt-10">acronym </span>otherwise it is set to <span class="cmtt-10">main</span>.<span class="footnote-mark"><a href="#fn5x2" id="fn5x2-bk"><sup class="textsuperscript">2.5</sup></a></span><a - id="x1-90007f5"></a> + id="x1-91007f5"></a> Entries that are defined using <span class="cmtt-10">\newacronym</span><a - id="dx1-90013"></a> are placed in the glossary whose label is given by <span + id="dx1-91013"></a> are placed in the glossary whose label is given by <span class="cmtt-10">\acronymtype</span><a - id="dx1-90014"></a>, + id="dx1-91014"></a>, unless another glossary is explicitly specified. -</p><!--l. 5017--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span +</p><!--l. 5125--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span class="cmss-10">nomain</span><a - id="dx1-90015"></a> package option if you’re only interested in using this <span + id="dx1-91015"></a> package option if you’re only interested in using this <span class="cmtt-10">acronym </span>glossary. (That is, you don’t intend to use the <span class="cmtt-10">main </span>glossary.) </div> -</p><!--l. 5021--><p class="noindent" > -</p><!--l. 5023--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 5129--><p class="noindent" > +</p><!--l. 5131--><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> extension package comes with an analogous <span id="textcolor239"><span +class="cmss-10">glossaries-extra</span></a> extension package comes with an analogous <span id="textcolor244"><span class="cmss-10">abbreviations</span></span><a - id="dx1-90016"></a> option, which creates a new + id="dx1-91016"></a> option, which creates a new glossary with the label <span -class="cmtt-10">abbreviations </span>and sets the command <span id="textcolor240"><span +class="cmtt-10">abbreviations </span>and sets the command <span id="textcolor245"><span class="cmtt-10">\glsxtrabbrvtype</span></span><a - id="dx1-90017"></a> to this. If the <span + id="dx1-91017"></a> to this. If the <span class="cmss-10">acronym</span><a - id="dx1-90018"></a> option + id="dx1-91018"></a> option hasn’t also been used, then <span class="cmtt-10">\acronymtype</span><a - id="dx1-90019"></a> will be set to <span id="textcolor241"><span + id="dx1-91019"></a> will be set to <span id="textcolor246"><span class="cmtt-10">\glsxtrabbrvtype</span></span><a - id="dx1-90020"></a>. This enables both <span + id="dx1-91020"></a>. This enables both <span class="cmtt-10">\newacronym</span><a - id="dx1-90021"></a> -and <span id="textcolor242"><span + id="dx1-91021"></a> +and <span id="textcolor247"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-90022"></a> to use the same glossary. -</p><!--l. 5032--><p class="indent" > Make sure you have at least v1.42 of <a + id="dx1-91022"></a> to use the same glossary. +</p><!--l. 5140--><p class="indent" > Make sure you have at least v1.42 of <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> if you use the <span class="cmss-10">acronym</span><a - id="dx1-90023"></a> (or <span + id="dx1-91023"></a> (or <span class="cmss-10">acronyms</span><a - id="dx1-90024"></a>) package option + id="dx1-91024"></a>) package option with the extension package to avoid a bug that interferes with the abbreviation style. </div> -</p><!--l. 5036--><p class="noindent" > -</p><!--l. 5038--><p class="noindent" > +</p><!--l. 5144--><p class="noindent" > +</p><!--l. 5146--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-910002.7"></a><a + id="x1-920002.7"></a><a id="pkgopt:acronyms"></a><span class="cmss-10">acronyms</span></h4> -<!--l. 5038--><p class="noindent" >This is equivalent to <span +<!--l. 5146--><p class="noindent" >This is equivalent to <span class="cmss-10">acronym</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-91001"></a> and may be used in the document class option list. + id="dx1-92001"></a> and may be used in the document class option list. -</p><!--l. 5042--><p class="noindent" > +</p><!--l. 5150--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-920002.7"></a><span id="textcolor243"><a - id="pkgopt:abbreviations"></a><span id="textcolor244"><span + id="x1-930002.7"></a><span id="textcolor248"><a + id="pkgopt:abbreviations"></a><span id="textcolor249"><span class="cmss-10">abbreviations</span></span> (glossaries-extra.sty)</span></h4> -<!--l. 5044--><p class="noindent" >This valueless option creates a new glossary type using: +<!--l. 5152--><p class="noindent" >This valueless option creates a new glossary type using: </p> - <div class="verbatim" id="verbatim-107"> + <pre class="verbatim" id="verbatim-111"> \newglossary[glg-abr]{abbreviations}{gls-abr}{glo-abr}{\abbreviationsname} -</div> -<!--l. 5047--><p class="nopar" > The label can be accessed with <span id="textcolor245"><span +</pre> +<!--l. 5155--><p class="nopar" > The label can be accessed with <span id="textcolor250"><span class="cmtt-10">\glsxtrabbrvtype</span></span><a - id="dx1-92001"></a>, which is analogous to <span + id="dx1-93001"></a>, which is analogous to <span class="cmtt-10">\acronymtype</span>. See <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. -</p><!--l. 5052--><p class="noindent" > +</p><!--l. 5160--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-930002.7"></a><a + id="x1-940002.7"></a><a id="pkgopt:acronymlists"></a><span class="cmss-10">acronymlists=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 5052--><p class="noindent" >By default, only the <span +<!--l. 5160--><p class="noindent" >By default, only the <span class="cmtt-10">\acronymtype </span>glossary is considered to be a list of acronyms. If you have other lists of acronyms, you can specify them as a comma-separated list in the value of <span class="cmss-10">acronymlists</span><a - id="dx1-93001"></a>. For example, if you use + id="dx1-94001"></a>. For example, if you use the <span class="cmss-10">acronym</span><a - id="dx1-93002"></a> package option but you also want the <span + id="dx1-94002"></a> package option but you also want the <span class="cmtt-10">main </span>glossary to also contain a list of acronyms, you can do: </p> - <div class="verbatim" id="verbatim-108"> + <pre class="verbatim" id="verbatim-112"> \usepackage[acronym,acronymlists={main}]{glossaries} -</div> -<!--l. 5060--><p class="nopar" > No check is performed to determine if the listed glossaries exist, so you can add glossaries you haven’t defined +</pre> +<!--l. 5168--><p class="nopar" > No check is performed to determine if the listed glossaries exist, so you can add glossaries you haven’t defined yet. For example: </p> - <div class="verbatim" id="verbatim-109"> + <pre class="verbatim" id="verbatim-113"> \usepackage[acronym,acronymlists={main,acronym2}] - <br />  {glossaries} - <br />\newglossary[alg2]{acronym2}{acr2}{acn2}% - <br />  {Statistical Acronyms} -</div> -<!--l. 5068--><p class="nopar" > You can use -</p><!--l. 5070--><p class="indent" > <hr><div title="Definition"><a - id="dx1-93003"></a> <span +  {glossaries} +\newglossary[alg2]{acronym2}{acr2}{acn2}% +  {Statistical Acronyms} +</pre> +<!--l. 5176--><p class="nopar" > You can use +</p><!--l. 5178--><p class="indent" > <hr><div title="Definition"><a + id="dx1-94003"></a> <span class="cmtt-10">\DeclareAcronymList{</span>⟨<span class="cmitt-10">list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5072--><p class="noindent" > +</p><!--l. 5180--><p class="noindent" > instead of or in addition to the <span class="cmss-10">acronymlists</span><a - id="dx1-93004"></a> option. This will add the glossaries given in ⟨<span + id="dx1-94004"></a> option. This will add the glossaries given in ⟨<span class="cmti-10">list</span>⟩ to the list of glossaries that are identified as lists of acronyms. To replace the list of acronym lists with a new list use: -</p><!--l. 5077--><p class="indent" > <hr><div title="Definition"><a - id="dx1-93005"></a> <span +</p><!--l. 5185--><p class="indent" > <hr><div title="Definition"><a + id="dx1-94005"></a> <span class="cmtt-10">\SetAcronymLists{</span>⟨<span class="cmitt-10">list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5079--><p class="noindent" > -</p><!--l. 5081--><p class="indent" > You can determine if a glossary has been identified as being a list of acronyms using: -</p><!--l. 5083--><p class="indent" > <hr><div title="Definition"><a - id="dx1-93006"></a> <span +</p><!--l. 5187--><p class="noindent" > +</p><!--l. 5189--><p class="indent" > You can determine if a glossary has been identified as being a list of acronyms using: +</p><!--l. 5191--><p class="indent" > <hr><div title="Definition"><a + id="dx1-94006"></a> <span class="cmtt-10">\glsIfListOfAcronyms{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -11274,363 +11720,367 @@ 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. 5085--><p class="noindent" > -</p><!--l. 5087--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> This option is incompatible with <a +</p><!--l. 5193--><p class="noindent" > +</p><!--l. 5195--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> This option and associated commands are incompatible with <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span>’s</a> abbreviation mechanism. </div> -</p><!--l. 5090--><p class="noindent" > -</p><!--l. 5092--><p class="noindent" > +class="cmss-10">glossaries-extra</span>’s</a> abbreviation mechanism. +</div> +</p><!--l. 5198--><p class="noindent" > +</p><!--l. 5200--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-940002.7"></a><a + id="x1-950002.7"></a><a id="pkgopt:shortcuts"></a><span class="cmss-10">shortcuts</span></h4> -<!--l. 5092--><p class="noindent" >This option provides shortcut commands for acronyms. See <a -href="#sec:acronyms">§13 </a><a -href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> for further -details. Alternatively you can use: -</p><!--l. 5095--><p class="indent" > <hr><div title="Definition"><a - id="dx1-94001"></a> <span +<!--l. 5200--><p class="noindent" >This option provides shortcut commands for acronyms. See <a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> +for further details. Alternatively you can use: +</p><!--l. 5203--><p class="indent" > <hr><div title="Definition"><a + id="dx1-95001"></a> <span class="cmtt-10">\DefineAcronymSynonyms </span></div><hr> -</p><!--l. 5097--><p class="noindent" > -</p><!--l. 5099--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 5205--><p class="noindent" > +</p><!--l. 5207--><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 provides additional shortcuts. </div> -</p><!--l. 5101--><p class="noindent" > -</p><!--l. 5103--><p class="noindent" > +</p><!--l. 5209--><p class="noindent" > +</p><!--l. 5211--><p class="noindent" > </p> -<!--l. 5103--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">2.7.1 </span> <a - id="sec:pkgopts-old-acronym"></a>Deprecated Acronym Style Options</h4> -<!--l. 5106--><p class="noindent" >The package options listed in this section are now deprecated but are kept for backward-compatibility. Use -<span -class="cmtt-10">\setacronymstyle</span><a - id="dx1-95001"></a> instead. See <a -href="#sec:acronyms">§13 </a><a -href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> for further details. +<!--l. 5211--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.8 </span> <a + id="sec:pkgopts-old-acronym"></a>Deprecated Acronym Style Options</h3> +<!--l. 5214--><p class="noindent" >The package options listed in this section are now deprecated but are kept for backward-compatibility. Use -</p><!--l. 5110--><p class="noindent" > +<span +class="cmtt-10">\setacronymstyle</span><a + id="dx1-96001"></a> instead. See <a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> for further +details. +</p><!--l. 5218--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-960002.7.1"></a><a + id="x1-970002.8"></a><a id="pkgopt:description"></a><span class="cmss-10">description</span></h4> -<!--l. 5110--><p class="noindent" >This option changes the definition of <span +<!--l. 5218--><p class="noindent" >This option changes the definition of <span class="cmtt-10">\newacronym</span><a - id="dx1-96001"></a> to allow a description. This option may be replaced + id="dx1-97001"></a> to allow a description. This option may be replaced by </p> - <div class="verbatim" id="verbatim-110"> + <pre class="verbatim" id="verbatim-114"> \setacronymstyle{long-short-desc} -</div> -<!--l. 5115--><p class="nopar" > or (with <span +</pre> +<!--l. 5223--><p class="nopar" > or (with <span class="cmss-10">smallcaps</span><a - id="dx1-96002"></a>) + id="dx1-97002"></a>) </p> - <div class="verbatim" id="verbatim-111"> + <pre class="verbatim" id="verbatim-115"> \setacronymstyle{long-sc-short-desc} -</div> -<!--l. 5119--><p class="nopar" > or (with <span +</pre> +<!--l. 5227--><p class="nopar" > or (with <span class="cmss-10">smaller</span><a - id="dx1-96003"></a>) + id="dx1-97003"></a>) </p> - <div class="verbatim" id="verbatim-112"> + <pre class="verbatim" id="verbatim-116"> \setacronymstyle{long-sm-short-desc} -</div> -<!--l. 5123--><p class="nopar" > or (with <span +</pre> +<!--l. 5231--><p class="nopar" > or (with <span class="cmss-10">footnote</span><a - id="dx1-96004"></a>) + id="dx1-97004"></a>) </p> - <div class="verbatim" id="verbatim-113"> + <pre class="verbatim" id="verbatim-117"> \setacronymstyle{footnote-desc} -</div> -<!--l. 5127--><p class="nopar" > or (with <span +</pre> +<!--l. 5235--><p class="nopar" > or (with <span class="cmss-10">footnote</span><a - id="dx1-96005"></a> and <span + id="dx1-97005"></a> and <span class="cmss-10">smallcaps</span><a - id="dx1-96006"></a>) + id="dx1-97006"></a>) </p> - <div class="verbatim" id="verbatim-114"> + <pre class="verbatim" id="verbatim-118"> \setacronymstyle{footnote-sc-desc} -</div> -<!--l. 5131--><p class="nopar" > or (with <span +</pre> +<!--l. 5239--><p class="nopar" > or (with <span class="cmss-10">footnote</span><a - id="dx1-96007"></a> and <span + id="dx1-97007"></a> and <span class="cmss-10">smaller</span><a - id="dx1-96008"></a>) + id="dx1-97008"></a>) </p> - <div class="verbatim" id="verbatim-115"> + <pre class="verbatim" id="verbatim-119"> \setacronymstyle{footnote-sm-desc} -</div> -<!--l. 5135--><p class="nopar" > or (with <span +</pre> +<!--l. 5243--><p class="nopar" > or (with <span class="cmss-10">dua</span><a - id="dx1-96009"></a>) + id="dx1-97009"></a>) </p> - <div class="verbatim" id="verbatim-116"> + <pre class="verbatim" id="verbatim-120"> \setacronymstyle{dua-desc} -</div> -<!--l. 5139--><p class="nopar" > -</p><!--l. 5141--><p class="noindent" > +</pre> +<!--l. 5247--><p class="nopar" > +</p><!--l. 5249--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-970002.7.1"></a><a + id="x1-980002.8"></a><a id="pkgopt:smallcaps"></a><span class="cmss-10">smallcaps</span></h4> -<!--l. 5141--><p class="noindent" >This option changes the definition of <span +<!--l. 5249--><p class="noindent" >This option changes the definition of <span class="cmtt-10">\newacronym</span><a - id="dx1-97001"></a> and the way that acronyms are displayed. This option may + id="dx1-98001"></a> and the way that acronyms are displayed. This option may be replaced by: </p> - <div class="verbatim" id="verbatim-117"> + <pre class="verbatim" id="verbatim-121"> \setacronymstyle{long-sc-short} -</div> -<!--l. 5146--><p class="nopar" > or (with <span +</pre> +<!--l. 5254--><p class="nopar" > or (with <span class="cmss-10">description</span><a - id="dx1-97002"></a>) + id="dx1-98002"></a>) </p> - <div class="verbatim" id="verbatim-118"> + <pre class="verbatim" id="verbatim-122"> \setacronymstyle{long-sc-short-desc} -</div> -<!--l. 5150--><p class="nopar" > or (with <span +</pre> +<!--l. 5258--><p class="nopar" > or (with <span class="cmss-10">description</span><a - id="dx1-97003"></a> and <span + id="dx1-98003"></a> and <span class="cmss-10">footnote</span><a - id="dx1-97004"></a>) + id="dx1-98004"></a>) </p> - <div class="verbatim" id="verbatim-119"> + <pre class="verbatim" id="verbatim-123"> \setacronymstyle{footnote-sc-desc} -</div> -<!--l. 5154--><p class="nopar" > -</p><!--l. 5156--><p class="noindent" > +</pre> +<!--l. 5262--><p class="nopar" > +</p><!--l. 5264--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-980002.7.1"></a><a + id="x1-990002.8"></a><a id="pkgopt:smaller"></a><span class="cmss-10">smaller</span></h4> -<!--l. 5156--><p class="noindent" >This option changes the definition of <span +<!--l. 5264--><p class="noindent" >This option changes the definition of <span class="cmtt-10">\newacronym</span><a - id="dx1-98001"></a> and the way that acronyms are displayed. -</p><!--l. 5158--><p class="indent" > <div class="important" title="Important Note"> If you use this option, you will need to include the <span + id="dx1-99001"></a> and the way that acronyms are displayed. +</p><!--l. 5266--><p class="indent" > <div class="important" title="Important Note"> If you use this option, you will need to include the <span class="cmss-10">relsize</span><a - id="dx1-98002"></a> package or otherwise define <span + id="dx1-99002"></a> package or otherwise define <span class="cmtt-10">\textsmaller</span><a - id="dx1-98003"></a> or + id="dx1-99003"></a> or redefine <span class="cmtt-10">\acronymfont</span><a - id="dx1-98004"></a>. </div> -</p><!--l. 5162--><p class="noindent" > + id="dx1-99004"></a>. </div> +</p><!--l. 5270--><p class="noindent" > This option may be replaced by: </p> - <div class="verbatim" id="verbatim-120"> + <pre class="verbatim" id="verbatim-124"> \setacronymstyle{long-sm-short} -</div> -<!--l. 5166--><p class="nopar" > or (with <span +</pre> +<!--l. 5274--><p class="nopar" > or (with <span class="cmss-10">description</span><a - id="dx1-98005"></a>) + id="dx1-99005"></a>) </p> - <div class="verbatim" id="verbatim-121"> + <pre class="verbatim" id="verbatim-125"> \setacronymstyle{long-sm-short-desc} -</div> -<!--l. 5170--><p class="nopar" > or (with <span +</pre> +<!--l. 5278--><p class="nopar" > or (with <span class="cmss-10">description</span><a - id="dx1-98006"></a> and <span + id="dx1-99006"></a> and <span class="cmss-10">footnote</span><a - id="dx1-98007"></a>) + id="dx1-99007"></a>) </p> - <div class="verbatim" id="verbatim-122"> + <pre class="verbatim" id="verbatim-126"> \setacronymstyle{footnote-sm-desc} -</div> -<!--l. 5174--><p class="nopar" > -</p><!--l. 5176--><p class="noindent" > +</pre> +<!--l. 5282--><p class="nopar" > +</p><!--l. 5284--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-990002.7.1"></a><a + id="x1-1000002.8"></a><a id="pkgopt:footnote"></a><span class="cmss-10">footnote</span></h4> -<!--l. 5176--><p class="noindent" >This option changes the definition of <span +<!--l. 5284--><p class="noindent" >This option changes the definition of <span class="cmtt-10">\newacronym</span><a - id="dx1-99001"></a> and the way that acronyms are displayed. This option may + id="dx1-100001"></a> and the way that acronyms are displayed. This option may be replaced by: </p> - <div class="verbatim" id="verbatim-123"> + <pre class="verbatim" id="verbatim-127"> \setacronymstyle{footnote} -</div> -<!--l. 5181--><p class="nopar" > or (with <span +</pre> +<!--l. 5289--><p class="nopar" > or (with <span class="cmss-10">smallcaps</span><a - id="dx1-99002"></a>) + id="dx1-100002"></a>) </p> - <div class="verbatim" id="verbatim-124"> + <pre class="verbatim" id="verbatim-128"> \setacronymstyle{footnote-sc} -</div> -<!--l. 5185--><p class="nopar" > or (with <span +</pre> +<!--l. 5293--><p class="nopar" > or (with <span class="cmss-10">smaller</span><a - id="dx1-99003"></a>) + id="dx1-100003"></a>) </p> - <div class="verbatim" id="verbatim-125"> + <pre class="verbatim" id="verbatim-129"> \setacronymstyle{footnote-sm} -</div> -<!--l. 5189--><p class="nopar" > or (with <span +</pre> +<!--l. 5297--><p class="nopar" > or (with <span class="cmss-10">description</span><a - id="dx1-99004"></a>) + id="dx1-100004"></a>) </p> - <div class="verbatim" id="verbatim-126"> + <pre class="verbatim" id="verbatim-130"> \setacronymstyle{footnote-desc} -</div> -<!--l. 5193--><p class="nopar" > or (with <span +</pre> +<!--l. 5301--><p class="nopar" > or (with <span class="cmss-10">smallcaps</span><a - id="dx1-99005"></a> and <span + id="dx1-100005"></a> and <span class="cmss-10">description</span><a - id="dx1-99006"></a>) + id="dx1-100006"></a>) </p> - <div class="verbatim" id="verbatim-127"> + <pre class="verbatim" id="verbatim-131"> \setacronymstyle{footnote-sc-desc} -</div> -<!--l. 5197--><p class="nopar" > or (with <span +</pre> +<!--l. 5305--><p class="nopar" > or (with <span class="cmss-10">smaller</span><a - id="dx1-99007"></a> and <span + id="dx1-100007"></a> and <span class="cmss-10">description</span><a - id="dx1-99008"></a>) + id="dx1-100008"></a>) </p> - <div class="verbatim" id="verbatim-128"> + <pre class="verbatim" id="verbatim-132"> \setacronymstyle{footnote-sm-desc} -</div> -<!--l. 5201--><p class="nopar" > -</p><!--l. 5203--><p class="noindent" > +</pre> +<!--l. 5309--><p class="nopar" > +</p><!--l. 5311--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-1000002.7.1"></a><a + id="x1-1010002.8"></a><a id="pkgopt:dua"></a><span class="cmss-10">dua</span></h4> -<!--l. 5203--><p class="noindent" >This option changes the definition of <span +<!--l. 5311--><p class="noindent" >This option changes the definition of <span class="cmtt-10">\newacronym</span><a - id="dx1-100001"></a> so that acronyms are always expanded. This option may be + id="dx1-101001"></a> so that acronyms are always expanded. This option may be replaced by: </p> - <div class="verbatim" id="verbatim-129"> + <pre class="verbatim" id="verbatim-133"> \setacronymstyle{dua} -</div> -<!--l. 5208--><p class="nopar" > or (with <span +</pre> +<!--l. 5316--><p class="nopar" > or (with <span class="cmss-10">description</span><a - id="dx1-100002"></a>) + id="dx1-101002"></a>) </p> - <div class="verbatim" id="verbatim-130"> + <pre class="verbatim" id="verbatim-134"> \setacronymstyle{dua-desc} -</div> -<!--l. 5212--><p class="nopar" > -</p><!--l. 5214--><p class="noindent" > +</pre> +<!--l. 5320--><p class="nopar" > +</p><!--l. 5322--><p class="noindent" > </p> -<!--l. 5214--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.8 </span> <a +<!--l. 5322--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.9 </span> <a id="sec:pkgopts-other"></a>Other Options</h3> -<!--l. 5217--><p class="noindent" >Other available options that don’t fit any of the above categories are described below. -</p><!--l. 5220--><p class="noindent" > +<!--l. 5325--><p class="noindent" >Other available options that don’t fit any of the above categories are described below. +</p><!--l. 5328--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-1020002.8"></a><span id="textcolor246"><a - id="pkgopt:accsupp"></a><span id="textcolor247"><span + id="x1-1030002.9"></a><span id="textcolor251"><a + id="pkgopt:accsupp"></a><span id="textcolor252"><span class="cmss-10">accsupp</span></span> (glossaries-extra.sty)</span></h4> -<!--l. 5222--><p class="noindent" >Load the <span +<!--l. 5330--><p class="noindent" >Load the <span class="cmss-10">glossaries-accsupp</span><a - id="dx1-102001"></a> package. -</p><!--l. 5224--><p class="noindent" > + id="dx1-103001"></a> package. +</p><!--l. 5332--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-1030002.8"></a><span id="textcolor248"><a - id="pkgopt:prefix"></a><span id="textcolor249"><span + id="x1-1040002.9"></a><span id="textcolor253"><a + id="pkgopt:prefix"></a><span id="textcolor254"><span class="cmss-10">prefix</span></span> (glossaries-extra.sty)</span></h4> -<!--l. 5226--><p class="noindent" >Load the <span +<!--l. 5334--><p class="noindent" >Load the <span class="cmss-10">glossaries-prefix</span><a - id="dx1-103001"></a> package. -</p><!--l. 5228--><p class="noindent" > + id="dx1-104001"></a> package. +</p><!--l. 5336--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-1040002.8"></a><span id="textcolor250"><a - id="pkgopt:nomissingglstext"></a><span id="textcolor251"><span + id="x1-1050002.9"></a><span id="textcolor255"><a + id="pkgopt:nomissingglstext"></a><span id="textcolor256"><span class="cmss-10">nomissingglstext</span></span><span class="cmss-10">=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4> -<!--l. 5230--><p class="noindent" >This option may be used to suppress the boilerplate text generated by <span +<!--l. 5338--><p class="noindent" >This option may be used to suppress the boilerplate text generated by <span class="cmtt-10">\printglossary </span>if the glossary file is missing. -</p><!--l. 5233--><p class="noindent" > +</p><!--l. 5341--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-1050002.8"></a><a + id="x1-1060002.9"></a><a id="pkgopt:compatible-2.07"></a><span class="cmss-10">compatible-2.07=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 5233--><p class="noindent" >Compatibility mode for old documents created using version 2.07 or below. +<!--l. 5341--><p class="noindent" >Compatibility mode for old documents created using version 2.07 or below. -</p><!--l. 5236--><p class="noindent" > +</p><!--l. 5344--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-1060002.8"></a><a + id="x1-1070002.9"></a><a id="pkgopt:compatible-3.07"></a><span class="cmss-10">compatible-3.07=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">boolean</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 5236--><p class="noindent" >Compatibility mode for old documents created using version 3.07 or below. -</p><!--l. 5239--><p class="noindent" > +<!--l. 5344--><p class="noindent" >Compatibility mode for old documents created using version 3.07 or below. +</p><!--l. 5347--><p class="noindent" > </p> <h4 class="likesubsectionHead"><a - id="x1-1070002.8"></a><a + id="x1-1080002.9"></a><a id="pkgopt:kernelglossredefs"></a><span class="cmss-10">kernelglossredefs=</span><span class="cmtt-10">{</span>⟨<span class="cmssi-10">value</span>⟩<span class="cmtt-10">}</span></h4> -<!--l. 5239--><p class="noindent" >As a legacy from the precursor <span +<!--l. 5347--><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 LaTeX kernel + id="dx1-108001"></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 @@ -11638,9 +12088,9 @@ 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 +</p><!--l. 5356--><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 +</p><!--l. 5360--><p class="indent" > In the event that you require the original form of these kernel commands, for example, if you need to use the <span class="cmss-10">glossaries </span>package with another class or package that also performs glossary-style indexing, then you can restore these commands to their previous definition (that is, their definitions prior to loading the <span @@ -11649,19 +12099,19 @@ with the package option <span class="cmss-10">kernelglossredefs</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-107002"></a>. You may also need to use the <span + id="dx1-108002"></a>. You may also need to use the <span class="cmss-10">nomain</span><a - id="dx1-107003"></a> option in the event of file + id="dx1-108003"></a> option in the event of file extension conflicts. (In which case, you must provide a new default glossary for use with the <span class="cmss-10">glossaries</span><a - id="dx1-107004"></a> + id="dx1-108004"></a> package.) -</p><!--l. 5263--><p class="indent" > This option may take one of three values: <span +</p><!--l. 5371--><p class="indent" > This option may take one of three values: <span 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 LaTeX kernel are <span +</p><!--l. 5376--><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 @@ -11669,149 +12119,166 @@ Other packages or classes may provide additional glossary-related commands or en class="cmss-10">glossaries </span>(such as <span class="cmtt-10">\printglossary </span>and <span class="cmss-10">theglossary</span><a - id="dx1-107005"></a><a - id="dx1-107006"></a>). These non-kernel commands aren’t affected by this + id="dx1-108005"></a><a + id="dx1-108006"></a>). These non-kernel commands aren’t affected by this package option, and you will have to find some way to resolve the conflict if you require both glossary mechanisms. (The <span class="cmss-10">glossaries</span><a - id="dx1-107007"></a> package will override the existing definitions of <span + id="dx1-108007"></a> package will override the existing definitions of <span class="cmtt-10">\printglossary </span>and <span class="cmss-10">theglossary</span><a - id="dx1-107008"></a><a - id="dx1-107009"></a>.) -</p><!--l. 5278--><p class="indent" > In general, if possible, it’s best to stick with just one package that provides a glossary mechanism. (The + id="dx1-108008"></a><a + id="dx1-108009"></a>.) +</p><!--l. 5386--><p class="indent" > In general, if possible, it’s best to stick with just one package that provides a glossary mechanism. (The <span class="cmss-10">glossaries </span>package does check for the <span class="cmss-10">doc</span><a - id="dx1-107010"></a> package and patches <span + id="dx1-108010"></a> package and patches <span class="cmtt-10">\PrintChanges</span>.) -</p><!--l. 5282--><p class="noindent" > +</p><!--l. 5390--><p class="noindent" > </p> -<!--l. 5282--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.9 </span> <a +<!--l. 5390--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2.10 </span> <a id="sec:setupglossaries"></a>Setting Options After the Package is Loaded</h3> -<!--l. 5285--><p class="noindent" >Some of the options described above may also be set after the <span +<!--l. 5393--><p class="noindent" >Some of the options described above may also be set after the <span class="cmss-10">glossaries </span>package has been loaded using -</p><!--l. 5287--><p class="indent" > <hr><div title="Definition"><a - id="dx1-108001"></a> <span +</p><!--l. 5395--><p class="indent" > <hr><div title="Definition"><a + id="dx1-109001"></a> <span class="cmtt-10">\setupglossaries{</span>⟨<span class="cmitt-10">key-val list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5289--><p class="noindent" > +</p><!--l. 5397--><p class="noindent" > The following package options <strong>can’t</strong> be used in <span class="cmtt-10">\setupglossaries</span>: <span class="cmss-10">xindy</span><a - id="dx1-108002"></a>, <span + id="dx1-109002"></a>, <span class="cmss-10">xindygloss</span><a - id="dx1-108003"></a>, <span + id="dx1-109003"></a>, <span class="cmss-10">xindynoglsnumbers</span><a - id="dx1-108004"></a>, + id="dx1-109004"></a>, <span class="cmss-10">makeindex</span><a - id="dx1-108005"></a>, <span + id="dx1-109005"></a>, <span class="cmss-10">nolong</span><a - id="dx1-108006"></a>, <span + id="dx1-109006"></a>, <span class="cmss-10">nosuper</span><a - id="dx1-108007"></a>, <span + id="dx1-109007"></a>, <span class="cmss-10">nolist</span><a - id="dx1-108008"></a>, <span + id="dx1-109008"></a>, <span class="cmss-10">notree</span><a - id="dx1-108009"></a>, <span + id="dx1-109009"></a>, <span class="cmss-10">nostyles</span><a - id="dx1-108010"></a>, <span + id="dx1-109010"></a>, <span class="cmss-10">nomain</span><a - id="dx1-108011"></a>, <span + id="dx1-109011"></a>, <span class="cmss-10">compatible-2.07</span><a - id="dx1-108012"></a>, <span + id="dx1-109012"></a>, <span class="cmss-10">translate</span><a - id="dx1-108013"></a>, <span + id="dx1-109013"></a>, <span class="cmss-10">notranslate</span><a - id="dx1-108014"></a>, -<span + id="dx1-109014"></a>, <span class="cmss-10">acronym</span><a - id="dx1-108015"></a>. These options have to be set while the package is loading, except for the <span + id="dx1-109015"></a>. These +options have to be set while the package is loading, except for the <span class="cmss-10">xindy</span><a - id="dx1-108016"></a> sub-options -which can be set using commands like <span + id="dx1-109016"></a> sub-options which can +be set using commands like <span class="cmtt-10">\GlsSetXdyLanguage</span><a - id="dx1-108017"></a> (see <a -href="#sec:xindy">§11 </a><a + id="dx1-109017"></a> (see <a +href="#sec:xindy">§<span +class="cmbx-10">??</span>sec:xindy </a><a href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a> for further details). -</p><!--l. 5301--><p class="indent" > <div class="important" title="Important Note"> If you need to use this command, use it as soon as possible after loading <span +</p><!--l. 5409--><p class="indent" > <div class="important" title="Important Note"> If you need to use this command, use it as soon as possible after loading <span class="cmss-10">glossaries </span>otherwise you might end up using it too late for the change to take effect. For example, if you try changing the acronym styles (such as <span class="cmss-10">smallcaps</span><a - id="dx1-108018"></a>) after you have started defining your acronyms, you are likely to get unexpected results. If you try + id="dx1-109018"></a>) after you have started defining your acronyms, you are likely to get unexpected results. If you try changing the sort option after you have started to define entries, you may get unexpected results. </div> -</p><!--l. 5309--><p class="noindent" > +</p><!--l. 5417--><p class="noindent" > +</p><!--l. 5419--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>, use <span id="textcolor257"><span +class="cmtt-10">\glossariesextrasetup</span></span><a + id="dx1-109019"></a> instead. </div> +</p><!--l. 5422--><p class="noindent" > </p> -<!--l. 5311--><p class="indent" > </div> -</p><!--l. 5311--><p class="noindent" ><a +<!--l. 5424--><p class="indent" > </div> +</p><!--l. 5424--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">3. <a id="sec:setup"></a>Setting Up</h2> -</p><!--l. 5314--><p class="indent" > In the preamble you need to indicate whether you want to use <a -href="#option1">Option 1</a>, <a -href="#option2">Option 2</a> or <a -href="#option3">Option 3</a>. It’s not -possible to mix these options within a document, although some combinations are possible with <span -class="cmss-10">glossaries-extra</span>. -(For Options <a -href="#option4">4</a> and <a -href="#option5">5</a> see the <a +</p><!--l. 5427--><p class="indent" > In the preamble you need to indicate which method you want to use to generate the glossary +(or glossaries). The available options with both <span +class="cmss-10">glossaries </span>and <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> are summarized in +<a +href="#sec:indexingoptions">§<span +class="cmbx-10">??</span>sec:indexingoptions </a><a +href="#sec:indexingoptions">Indexing Options<!--tex4ht:ref: sec:indexingoptions --></a>. This chapter documents Options <a +href="#option1">1</a>–<a +href="#option3">3</a>, which are provided by the +base package. See the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> and <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-109001"></a></a> and <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> manuals.) -</p> -<!--l. 5320--><p class="noindent" ><a + id="dx1-110001"></a></a> manuals for the full documentation of the other +options. +</p><!--l. 5435--><p class="indent" > If you don’t need to display any glossaries, for example, if you are just using the <span +class="cmss-10">glossaries </span>package to enable +consistent formatting, then skip ahead to <a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry </a><a +href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>. +</p> +<!--l. 5439--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">3.1 </span> <a id="sec:setupopt1"></a>Option 1</h3> -<!--l. 5323--><p class="noindent" >The command -</p><!--l. 5324--><p class="indent" > <hr><div title="Definition"><a - id="dx1-110001"></a> <span +<!--l. 5442--><p class="noindent" >The command +</p><!--l. 5443--><p class="indent" > <hr><div title="Definition"><a + id="dx1-111001"></a> <span class="cmtt-10">\makenoidxglossaries </span></div><hr> -</p><!--l. 5326--><p class="noindent" > +</p><!--l. 5445--><p class="noindent" > must be placed in the preamble. This sets up the internal commands required to make <a href="#option1">Option 1</a> work. <strong>If you omit <span class="cmtt-10">\makenoidxglossaries </span>none of the glossaries will be displayed.</strong> -</p><!--l. 5332--><p class="noindent" > +</p><!--l. 5451--><p class="noindent" > </p> -<!--l. 5332--><p class="noindent" ><a +<!--l. 5451--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">3.2 </span> <a id="sec:setupopt23"></a>Options 2 and 3</h3> -<!--l. 5335--><p class="noindent" >The command -</p><!--l. 5336--><p class="indent" > <hr><div title="Definition"><a - id="dx1-111001"></a> <span +<!--l. 5454--><p class="noindent" >The command +</p><!--l. 5455--><p class="indent" > <hr><div title="Definition"><a + id="dx1-112001"></a> <span class="cmtt-10">\makeglossaries </span></div><hr> -</p><!--l. 5338--><p class="noindent" > +</p><!--l. 5457--><p class="noindent" > must be placed in the preamble in order to create the customised <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-111002"></a></a> (<span + id="dx1-112002"></a></a> (<span class="cmtt-10">ist</span><a - id="dx1-111003"></a>) or <a + id="dx1-112003"></a>) or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-111004"></a></a> (<span + id="dx1-112004"></a></a> (<span class="cmtt-10">xdy</span><a - id="dx1-111005"></a>) style file (for + id="dx1-112005"></a>) style file (for Options <a href="#option2">2</a> or <a href="#option3">3</a>, respectively) and to ensure that glossary entries are written to the appropriate output files. <strong>If you omit <span class="cmtt-10">\makeglossaries </span>none of the glossary files will be created.</strong> -</p><!--l. 5346--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you are using <a +</p><!--l. 5465--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you are using <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, <span class="cmtt-10">\makeglossaries </span>has an optional argument that allows you to @@ -11823,8 +12290,8 @@ href="#option3">3</a>. See <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. </div> -</p><!--l. 5350--><p class="noindent" > -</p><!--l. 5353--><p class="indent" > <span class="warningsymbol">⚠</span> Note that some of the commands provided by the <span +</p><!--l. 5469--><p class="noindent" > +</p><!--l. 5472--><p class="indent" > <span class="warningsymbol">⚠</span> Note that some of the commands provided by the <span class="cmss-10">glossaries </span>package must not be used after <span class="cmtt-10">\makeglossaries </span>as they are required when creating the customised style file. If you attempt to use those @@ -11832,165 +12299,196 @@ commands after <span class="cmtt-10">\makeglossaries </span>you will generate an error. Similarly, there are some commands that must not be used before <span class="cmtt-10">\makeglossaries</span>. -</p><!--l. 5361--><p class="indent" > You can suppress the creation of the customised <a +</p><!--l. 5480--><p class="indent" > You can suppress the creation of the customised <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-111006"></a></a> or <a + id="dx1-112006"></a></a> or <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-111007"></a></a> style file using -</p><!--l. 5363--><p class="indent" > <hr><div title="Definition"><a - id="dx1-111008"></a> <span + id="dx1-112007"></a></a> style file using +</p><!--l. 5482--><p class="indent" > <hr><div title="Definition"><a + id="dx1-112008"></a> <span class="cmtt-10">\noist </span></div><hr> -</p><!--l. 5365--><p class="noindent" > +</p><!--l. 5484--><p class="noindent" > That this command must not be used after <span class="cmtt-10">\makeglossaries</span>. -</p><!--l. 5367--><p class="indent" > <div class="important" title="Important Note"> Note that if you have a custom <span +</p><!--l. 5486--><p class="indent" > <div class="important" title="Important Note"> Note that if you have a custom <span class="cmtt-10">xdy</span><a - id="dx1-111009"></a> file created when using <span + id="dx1-112009"></a> file created when using <span class="cmss-10">glossaries </span>version 2.07 or below, you will need to use the <span class="cmss-10">compatible-2.07</span><a - id="dx1-111010"></a> package option with it. </div> -</p><!--l. 5371--><p class="noindent" > -</p><!--l. 5373--><p class="indent" > The default name for the customised style file is given by <span + id="dx1-112010"></a> package option with it. </div> + + +</p><!--l. 5490--><p class="noindent" > +</p><!--l. 5492--><p class="indent" > The default name for the customised style file is given by <span class="cmtt-10">\jobname</span><a - id="dx1-111011"></a><span -class="cmtt-10">ist</span><a - id="dx1-111012"></a> (<a + id="dx1-112011"></a><span +class="cmtt-10">.ist</span><a + id="dx1-112012"></a> (<a href="#option2">Option 2</a>) or <span class="cmtt-10">\jobname</span><a - id="dx1-111013"></a><span -class="cmtt-10">xdy</span><a - id="dx1-111014"></a> + id="dx1-112013"></a><span +class="cmtt-10">.xdy</span><a + id="dx1-112014"></a> (<a href="#option3">Option 3</a>). This name may be changed using: -</p><!--l. 5377--><p class="indent" > <hr><div title="Definition"><a - id="dx1-111015"></a> <span +</p><!--l. 5496--><p class="indent" > <hr><div title="Definition"><a + id="dx1-112015"></a> <span class="cmtt-10">\setStyleFile{</span>⟨<span class="cmitt-10">name</span>⟩<span class="cmtt-10">} </span></div><hr> - - -</p><!--l. 5379--><p class="noindent" > +</p><!--l. 5498--><p class="noindent" > where ⟨<span class="cmti-10">name</span>⟩ is the name of the style file without the extension. Note that this command must not be used after <span class="cmtt-10">\makeglossaries</span>. -</p><!--l. 5384--><p class="indent" > Each glossary entry is assigned a <a +</p><!--l. 5503--><p class="indent" > Each glossary entry is assigned a <a href="#glo:numberlist">number list<a - id="dx1-111016"></a></a> that lists all the locations in the document where that entry + id="dx1-112016"></a></a> that lists all the locations in the document where that entry was used. By default, the location refers to the page number but this may be overridden using the <span class="cmss-10">counter</span><a - id="dx1-111017"></a> package option. The default form of the location number assumes a full stop compositor + id="dx1-112017"></a> package option. The default form of the location number assumes a full stop compositor (e.g. 1.2), but if your location numbers use a different compositor (e.g. 1-2) you need to set this using -</p><!--l. 5391--><p class="indent" > <hr><div title="Definition"><a - id="dx1-111018"></a> <span +</p><!--l. 5510--><p class="indent" > <hr><div title="Definition"><a + id="dx1-112018"></a> <span class="cmtt-10">\glsSetCompositor{</span>⟨<span class="cmitt-10">symbol</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5393--><p class="noindent" > +</p><!--l. 5512--><p class="noindent" > For example: </p> - <div class="verbatim" id="verbatim-131"> + <pre class="verbatim" id="verbatim-135"> \glsSetCompositor{-} -</div> -<!--l. 5397--><p class="nopar" > This command must not be used after <span +</pre> +<!--l. 5516--><p class="nopar" > This command must not be used after <span class="cmtt-10">\makeglossaries</span>. -</p><!--l. 5400--><p class="indent" > If you use <a +</p><!--l. 5519--><p class="indent" > If you use <a href="#option3">Option 3</a>, you can have a different compositor for page numbers starting with an upper case alphabetical character using: -</p><!--l. 5402--><p class="indent" > <hr><div title="Definition"><a - id="dx1-111019"></a> <span +</p><!--l. 5521--><p class="indent" > <hr><div title="Definition"><a + id="dx1-112019"></a> <span class="cmtt-10">\glsSetAlphaCompositor{</span>⟨<span class="cmitt-10">symbol</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5404--><p class="noindent" > +</p><!--l. 5523--><p class="noindent" > This command has no effect if you use <a href="#option2">Option 2</a>. For example, if you want <a href="#glo:numberlist">number list<a - id="dx1-111020"></a>s</a> containing a mixture of + id="dx1-112020"></a>s</a> containing a mixture of A-1 and 2.3 style formats, then do: </p> - <div class="verbatim" id="verbatim-132"> + <pre class="verbatim" id="verbatim-136"> \glsSetCompositor{.}\glsSetAlphaCompositor{-} -</div> -<!--l. 5410--><p class="nopar" > See <a -href="#sec:numberlists">§5 </a><a -href="#sec:numberlists">Number lists<!--tex4ht:ref: sec:numberlists --></a> for further information about <a +</pre> +<!--l. 5529--><p class="nopar" > See <a +href="#sec:numberlists">§<span +class="cmbx-10">??</span>sec:numberlists </a><a +href="#sec:numberlists">Number Lists<!--tex4ht:ref: sec:numberlists --></a> for further information about <a href="#glo:numberlist">number list<a - id="dx1-111021"></a>s</a>. + id="dx1-112021"></a>s</a>. </p> -<!--l. 5414--><p class="indent" > </div> -</p><!--l. 5414--><p class="noindent" ><a +<!--l. 5533--><p class="indent" > </div> +</p><!--l. 5533--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">4. <a id="sec:newglosentry"></a>Defining Glossary Entries</h2> -</p><!--l. 5417--><p class="indent" > All glossary entries must be defined before they are used, so it is better to define them in the -preamble to ensure this. In fact, some commands such as <span -class="cmtt-10">\longnewglossaryentry </span>may only be used -in the preamble. See <a -href="#sec:docdefs">§4.8 </a><a +</p><!--l. 5536--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you want to use <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-113001"></a></a>, entries must be defined in <span +class="cmtt-10">bib</span><a + id="dx1-113002"></a> files using the syntax described in the <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-113003"></a></a> +user manual. </div> +</p><!--l. 5540--><p class="noindent" > +</p><!--l. 5542--><p class="indent" > Acronyms are covered in <a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> but they use the same +underlying mechanism as all the other entries, so it’s a good idea to read this chapter first. The keys provided +for <span +class="cmtt-10">\newglossaryentry </span>can also be used in the optional argument of <span +class="cmtt-10">\newacronym</span>, although some of them, +such as <span +class="cmtt-10">first</span><a + id="dx1-113004"></a> and <span +class="cmtt-10">plural</span><a + id="dx1-113005"></a>, interfere with the acronym styles. +</p><!--l. 5549--><p class="indent" > All glossary entries must be defined before they are used, so it is better to define them in the preamble to +ensure this. In fact, some commands such as <span +class="cmtt-10">\longnewglossaryentry </span>may only be used in the +preamble. See <a +href="#sec:docdefs">§<span +class="cmbx-10">??</span>sec:docdefs </a><a href="#sec:docdefs">Drawbacks With Defining Entries in the Document Environment<!--tex4ht:ref: sec:docdefs --></a> for a -discussion of the problems with defining entries within the document instead of in the preamble. -(The <a +discussion of the problems with defining entries within the document instead of in the preamble. (The +<a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package has an option that provides a restricted form of document definitions -that avoids some of the issues discussed in <a -href="#sec:docdefs">§4.8 </a><a +class="cmss-10">glossaries-extra</span></a> package has an option that provides a restricted form of document definitions that avoids +some of the issues discussed in <a +href="#sec:docdefs">§<span +class="cmbx-10">??</span>sec:docdefs </a><a href="#sec:docdefs">Drawbacks With Defining Entries in the Document Environment<!--tex4ht:ref: sec:docdefs --></a>.) -</p><!--l. 5426--><p class="indent" > <div class="important" title="Important Note"> <a +</p><!--l. 5558--><p class="indent" > <div class="important" title="Important Note"> <a href="#option1">Option 1</a> enforces the preamble-only restriction on <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-112001"></a>. <a + id="dx1-113006"></a>. <a href="#option4">Option 4</a> requires that definitions are provided in <span class="cmtt-10">bib</span><a - id="dx1-112002"></a> format. <a + id="dx1-113007"></a> format. <a href="#option5">Option 5</a> requires either preamble-only definitions or the use of the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package option <span class="cmss-10">docdef=restricted</span>. </div> -</p><!--l. 5432--><p class="noindent" > -</p><!--l. 5434--><p class="indent" > Only those entries that are indexed in the document (using any of the commands described in <a -href="#sec:glslink">§6 </a><a -href="#sec:glslink">Links to -Glossary Entries<!--tex4ht:ref: sec:glslink --></a>, <a -href="#sec:glsadd">§7 </a><a -href="#sec:glsadd">Adding an Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a> or <a -href="#sec:crossref">§8 </a><a -href="#sec:crossref">Cross-Referencing -Entries<!--tex4ht:ref: sec:crossref --></a>) will appear in the glossary. See <a -href="#sec:printglossary">§10 </a><a -href="#sec:printglossary">Displaying a glossary<!--tex4ht:ref: sec:printglossary --></a> to find out how to display the -glossary. -</p><!--l. 5442--><p class="indent" > New glossary entries are defined using the command: -</p><!--l. 5443--><p class="indent" > <hr><div title="Definition"><a - id="dx1-112003"></a> <span +</p><!--l. 5564--><p class="noindent" > +</p><!--l. 5566--><p class="indent" > Only those entries that are indexed in the document (using any of the commands described in <a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink +</a><a +href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a>, <a +href="#sec:glsadd">§<span +class="cmbx-10">??</span>sec:glsadd </a><a +href="#sec:glsadd">Adding an Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a> or +<a +href="#sec:crossref">§<span +class="cmbx-10">??</span>sec:crossref </a><a +href="#sec:crossref">Cross-Referencing Entries<!--tex4ht:ref: sec:crossref --></a>) will appear in the glossary. See <a +href="#sec:printglossary">§<span +class="cmbx-10">??</span>sec:printglossary </a><a +href="#sec:printglossary">Displaying a +Glossary<!--tex4ht:ref: sec:printglossary --></a> to find out how to display the glossary. +</p><!--l. 5574--><p class="indent" > New glossary entries are defined using the command: +</p><!--l. 5575--><p class="indent" > <hr><div title="Definition"><a + id="dx1-113008"></a> <span class="cmtt-10">\newglossaryentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">key=value list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5445--><p class="noindent" > +</p><!--l. 5577--><p class="noindent" > This is a short command, so values in ⟨<span class="cmti-10">key-val list</span>⟩ can’t contain any paragraph breaks. Take care to enclose values containing any commas (<span class="cmtt-10">,</span>) or equal signs (<span class="cmtt-10">=</span>) with braces to hide them from the key=value list parser. -</p><!--l. 5451--><p class="indent" > If you have a long description that needs to span multiple paragraphs, use -</p><!--l. 5453--><p class="indent" > <hr><div title="Definition"><a - id="dx1-112004"></a> <span +</p><!--l. 5583--><p class="indent" > If you have a long description that needs to span multiple paragraphs, use +</p><!--l. 5585--><p class="indent" > <hr><div title="Definition"><a + id="dx1-113009"></a> <span class="cmtt-10">\longnewglossaryentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -11998,7 +12496,7 @@ class="cmitt-10">key=value list</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">long description</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5456--><p class="noindent" > +</p><!--l. 5588--><p class="noindent" > instead. Note that this command may only be used in the preamble. Be careful of unwanted spaces. <span class="cmtt-10">\longnewglossaryentry </span>will remove trailing spaces in the description (via <span @@ -12012,18 +12510,18 @@ class="cmtt-10">\longnewglossaryentry </span>that doesn’t append either <span class="cmtt-10">\unskip </span>or <span class="cmtt-10">\nopostdesc</span>. -</p><!--l. 5466--><p class="indent" > There are also commands that will only define the entry if it hasn’t already been defined: -</p><!--l. 5468--><p class="indent" > <hr><div title="Definition"><a - id="dx1-112005"></a> <span +</p><!--l. 5598--><p class="indent" > There are also commands that will only define the entry if it hasn’t already been defined: +</p><!--l. 5600--><p class="indent" > <hr><div title="Definition"><a + id="dx1-113010"></a> <span class="cmtt-10">\provideglossaryentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">key=value list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5470--><p class="noindent" > +</p><!--l. 5602--><p class="noindent" > and -</p><!--l. 5472--><p class="indent" > <hr><div title="Definition"><a - id="dx1-112006"></a> <span +</p><!--l. 5604--><p class="indent" > <hr><div title="Definition"><a + id="dx1-113011"></a> <span class="cmtt-10">\longprovideglossaryentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -12031,353 +12529,430 @@ class="cmitt-10">key=value list</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">long description</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5475--><p class="noindent" > + + +</p><!--l. 5607--><p class="noindent" > (These are both preamble-only commands.) -</p><!--l. 5478--><p class="indent" > For all the above commands, the first argument, ⟨<span +</p><!--l. 5610--><p class="indent" > For all the above commands, the first argument, ⟨<span class="cmti-10">label</span>⟩, must be a unique label with which to identify this entry. <strong>This can’t contain any non-expandable commands or active characters.</strong> The reason for this restriction is that the label is used to construct internal commands that store the associated information (similarly to commands like <span class="cmtt-10">\label</span>) and therefore must be able to expand to a valid control sequence name. -</p><!--l. 5486--><p class="indent" > <div class="important" title="Important Note"> Note that although an <a +</p><!--l. 5618--><p class="indent" > <div class="important" title="Important Note"> Note that although an <a href="#glo:exlatinchar">extended Latin character<a - id="dx1-112007"></a></a> or other <a + id="dx1-113012"></a></a> or other <a href="#glo:nonlatinchar">non-Latin character<a - id="dx1-112008"></a></a>, such as é or - - + id="dx1-113013"></a></a>, such as é or ß, 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 + id="dx1-113014"></a>’s options that change certain punctuation characters (such as <span class="cmtt-10">: </span>or <span class="cmtt-10">-</span>) to active characters. </div> -</p><!--l. 5494--><p class="noindent" > -</p><!--l. 5496--><p class="indent" > The second argument, ⟨<span +</p><!--l. 5626--><p class="noindent" > +</p><!--l. 5628--><p class="indent" > The second argument, ⟨<span class="cmti-10">key=value list</span>⟩, is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ list that supplies the relevant information about this entry. There are two required fields: <span class="cmtt-10">description</span><a - id="dx1-112010"></a> and either <span + id="dx1-113015"></a> and either <span class="cmtt-10">name</span><a - id="dx1-112011"></a> or <span + id="dx1-113016"></a> or <span class="cmtt-10">parent</span><a - id="dx1-112012"></a>. The description is set in the third + id="dx1-113017"></a>. The description is set in the third argument of <span class="cmtt-10">\longnewglossaryentry </span>and <span class="cmtt-10">\longprovideglossaryentry</span>. With the other commands it’s set via the <span class="cmtt-10">description</span><a - id="dx1-112013"></a> key. As is typical with ⟨<span + id="dx1-113018"></a> key. As is typical with ⟨<span class="cmti-10">key</span>⟩=⟨<span -class="cmti-10">value</span>⟩ lists, values that contain a comma or equal sign -must be enclosed in braces. Available fields are listed below. Additional fields are provided by the -supplementary packages <span +class="cmti-10">value</span>⟩ lists, values that contain a comma or equal sign must be +enclosed in braces. Available fields are listed below. Additional fields are provided by the supplementary +packages <span class="cmss-10">glossaries-prefix</span><a - id="dx1-112014"></a> (<a -href="#sec:prefix">§17 </a><a + id="dx1-113019"></a> (<a +href="#sec:prefix">§<span +class="cmbx-10">??</span>sec:prefix </a><a href="#sec:prefix">Prefixes or Determiners<!--tex4ht:ref: sec:prefix --></a>) and <span class="cmss-10">glossaries-accsupp</span><a - id="dx1-112015"></a> (<a -href="#sec:accsupp">§18 </a><a -href="#sec:accsupp">Accessibility -Support<!--tex4ht:ref: sec:accsupp --></a>) and also by <a + id="dx1-113020"></a> (<a +href="#sec:accsupp">§<span +class="cmbx-10">??</span>sec:accsupp +</a><a +href="#sec:accsupp">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a>) and also by <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. You can also define your own custom keys (see <a -href="#sec:addkey">§4.3 </a><a -href="#sec:addkey">Additional -Keys<!--tex4ht:ref: sec:addkey --></a>). +href="#sec:addkey">§<span +class="cmbx-10">??</span>sec:addkey +</a><a +href="#sec:addkey">Additional Keys<!--tex4ht:ref: sec:addkey --></a>). </p><dl class="description"><dt class="description"> + <!--l. 5645--><p class="noindent" > <span class="cmtt-10">name</span><a - id="dx1-112016"></a> </dt><dd -class="description">The name of the entry (as it will appear in the glossary). If this key is omitted and the <span + id="dx1-113021"></a> </p></dt><dd +class="description"> + <!--l. 5645--><p class="noindent" >The name of the entry (as it will appear in the glossary). If this key is omitted and the <span class="cmtt-10">parent</span><a - id="dx1-112017"></a> - key is supplied, this value will be the same as the parent’s name. - <!--l. 5517--><p class="noindent" ><div class="important" title="Important Note"> If the <span + id="dx1-113022"></a> key + is supplied, this value will be the same as the parent’s name. + </p><!--l. 5649--><p class="noindent" ><div class="important" title="Important Note"> If the <span class="cmtt-10">name</span><a - id="dx1-112018"></a> key contains any commands, you must also use the <span + id="dx1-113023"></a> key contains any commands, you must also use the <span class="cmtt-10">sort</span><a - id="dx1-112019"></a> key (described below) if + id="dx1-113024"></a> key (described below) if you intend sorting the entries alphabetically, otherwise the entries can’t be sorted correctly. </div> - </p><!--l. 5521--><p class="noindent" > + </p><!--l. 5653--><p class="noindent" > </p></dd><dt class="description"> + <!--l. 5655--><p class="noindent" > <span class="cmtt-10">description</span><a - id="dx1-112020"></a> </dt><dd -class="description">A brief description of this term (to appear in the glossary). Within this value, you can - use: - <!--l. 5525--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-112021"></a> <span + id="dx1-113025"></a> </p></dt><dd +class="description"> + <!--l. 5655--><p class="noindent" >A brief description of this term (to appear in the glossary). Within this value, you can use: + </p><!--l. 5657--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-113026"></a> <span class="cmtt-10">\nopostdesc </span></div><hr> - </p><!--l. 5527--><p class="noindent" > + </p><!--l. 5659--><p class="noindent" > to suppress the description terminator for this entry. For example, if this entry is a parent entry that doesn’t require a description, you can do <span class="cmtt-10">description={\nopostdesc}</span>. If you want a paragraph break in the description use: - </p><!--l. 5533--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-112022"></a> <span + </p><!--l. 5665--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-113027"></a> <span class="cmtt-10">\glspar </span></div><hr> - </p><!--l. 5535--><p class="noindent" > + + + </p><!--l. 5667--><p class="noindent" > or, better, use <span class="cmtt-10">\longnewglossaryentry</span>. However, note that not all glossary styles support multi-line descriptions. If you are using one of the tabular-like glossary styles that permit multi-line descriptions, use <span class="cmtt-10">\newline</span><a - id="dx1-112023"></a> not <span class="obeylines-h"><span class="verb"><span + id="dx1-113028"></a> not <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\\</span></span></span> if you want to force a line break. - </p><!--l. 5542--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a + </p><!--l. 5674--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, use <span id="textcolor252"><span +class="cmss-10">glossaries-extra</span></a>, use <span id="textcolor258"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-112024"></a> instead of <span + id="dx1-113029"></a> instead of <span class="cmtt-10">\nopostdesc </span>to suppress the post-description punctuation. </div> - </p><!--l. 5545--><p class="noindent" > + </p><!--l. 5677--><p class="noindent" > </p></dd><dt class="description"> + <!--l. 5679--><p class="noindent" > <span class="cmtt-10">parent</span><a - id="dx1-112025"></a> </dt><dd -class="description">The label of the parent entry. Note that the parent entry must be defined before its sub-entries. See <a -href="#sec:subentries">§4.5 - </a><a + id="dx1-113030"></a> </p></dt><dd +class="description"> + <!--l. 5679--><p class="noindent" >The label of the parent entry. Note that the parent entry must be defined before its sub-entries. See + <a +href="#sec:subentries">§<span +class="cmbx-10">??</span>sec:subentries </a><a href="#sec:subentries">Sub-Entries<!--tex4ht:ref: sec:subentries --></a> for further details. - - - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 5683--><p class="noindent" > <span class="cmtt-10">descriptionplural</span><a - id="dx1-112026"></a> </dt><dd -class="description">The plural form of the description, if required. If omitted, the value is set to the same as - the <span + id="dx1-113031"></a> </p></dt><dd +class="description"> + <!--l. 5683--><p class="noindent" >The plural form of the description, if required. If omitted, the value is set to the same as the <span class="cmtt-10">description</span><a - id="dx1-112027"></a> key. - </dd><dt class="description"> + id="dx1-113032"></a> + key. + </p></dd><dt class="description"> + <!--l. 5687--><p class="noindent" > <span class="cmtt-10">text</span><a - id="dx1-112028"></a> </dt><dd -class="description">How this entry will appear in the document text when using <span + id="dx1-113033"></a> </p></dt><dd +class="description"> + <!--l. 5687--><p class="noindent" >How this entry will appear in the document text when using <span class="cmtt-10">\gls</span><a - id="dx1-112029"></a> (or one of its upper case variants). If + id="dx1-113034"></a> (or one of its upper case variants). If this field is omitted, the value of the <span class="cmtt-10">name</span><a - id="dx1-112030"></a> key is used. - </dd><dt class="description"> + id="dx1-113035"></a> key is used. + </p><!--l. 5691--><p class="noindent" >This key is automatically set by <span +class="cmtt-10">\newacronym</span>. Although it is possible to override it by using <span +class="cmtt-10">text</span><a + id="dx1-113036"></a> in the + optional argument of <span +class="cmtt-10">\newacronym</span>, it will interfere with the acronym style and cause unexpected + results. + </p></dd><dt class="description"> + <!--l. 5696--><p class="noindent" > <span class="cmtt-10">first</span><a - id="dx1-112031"></a> </dt><dd -class="description">How the entry will appear in the document text on <a + id="dx1-113037"></a> </p></dt><dd +class="description"> + <!--l. 5696--><p class="noindent" >How the entry will appear in the document text on <a href="#glo:firstuse">first use</a> with <span class="cmtt-10">\gls</span><a - id="dx1-112032"></a> (or one of its upper case - variants). If this field is omitted, the value of the <span + id="dx1-113038"></a> (or one of its upper + case variants). If this field is omitted, the value of the <span class="cmtt-10">text</span><a - id="dx1-112033"></a> key is used. Note that if you use <span -class="cmtt-10">\glspl</span><a - id="dx1-112034"></a>, + id="dx1-113039"></a> key is used. Note that if you use <span +class="cmtt-10">\glspl</span><a + id="dx1-113040"></a>, <span class="cmtt-10">\Glspl</span><a - id="dx1-112035"></a>, <span + id="dx1-113041"></a>, <span class="cmtt-10">\GLSpl</span><a - id="dx1-112036"></a>, <span + id="dx1-113042"></a>, <span class="cmtt-10">\glsdisp</span><a - id="dx1-112037"></a> before using <span + id="dx1-113043"></a> before using <span class="cmtt-10">\gls</span><a - id="dx1-112038"></a>, the <span -class="cmtt-10">firstplural</span><a - id="dx1-112039"></a> value won’t be used with + id="dx1-113044"></a>, the <span +class="cmtt-10">first</span><a + id="dx1-113045"></a> value won’t be used with <span class="cmtt-10">\gls</span><a - id="dx1-112040"></a>. - </dd><dt class="description"> + id="dx1-113046"></a>. + </p><!--l. 5703--><p class="noindent" >You may prefer to use abbreviations (<a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>) or the + category post-link hook (<span id="textcolor259"><span +class="cmtt-10">\glsdefpostlink</span></span><a + id="dx1-113047"></a>) provided by <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> if you would like to + automatically append content on <a +href="#glo:firstuse">first use</a> in a consistent manner. See, for example, <a +href="https://www.dickimaw-books.com/gallery/index.php?label=sample-units" >Gallery: Units + (<span +class="cmss-10">glossaries-extra.sty</span>)</a>. + </p><!--l. 5710--><p class="noindent" >Although it is possible to use <span +class="cmtt-10">first</span><a + id="dx1-113048"></a> in the optional argument of <span +class="cmtt-10">\newacronym</span>, it can interfere with the + acronym style and cause unexpected results. + + + </p></dd><dt class="description"> + <!--l. 5714--><p class="noindent" > <span class="cmtt-10">plural</span><a - id="dx1-112041"></a> </dt><dd -class="description">How the entry will appear in the document text when using <span + id="dx1-113049"></a> </p></dt><dd +class="description"> + <!--l. 5714--><p class="noindent" >How the entry will appear in the document text when using <span class="cmtt-10">\glspl</span><a - id="dx1-112042"></a> (or one of its upper case variants). - If this field is omitted, the value is obtained by appending <span + id="dx1-113050"></a> (or one of its upper case variants). If + this field is omitted, the value is obtained by appending <span class="cmtt-10">\glspluralsuffix</span><a - id="dx1-112043"></a> to the value of the <span + id="dx1-113051"></a> to the value of the <span class="cmtt-10">text</span><a - id="dx1-112044"></a> - field. The default value of <span + id="dx1-113052"></a> field. + The default value of <span class="cmtt-10">\glspluralsuffix</span><a - id="dx1-112045"></a> is the letter “s”. - </dd><dt class="description"> + id="dx1-113053"></a> is the letter “s”. + </p><!--l. 5720--><p class="noindent" >Although it is possible to use <span +class="cmtt-10">plural</span><a + id="dx1-113054"></a> in the optional argument of <span +class="cmtt-10">\newacronym</span>, it can interfere with the + acronym style and cause unexpected results. Use <span +class="cmtt-10">shortplural</span><a + id="dx1-113055"></a> instead, if the default value is + inappropriate. + </p></dd><dt class="description"> + <!--l. 5725--><p class="noindent" > <span class="cmtt-10">firstplural</span><a - id="dx1-112046"></a> </dt><dd -class="description">How the entry will appear in the document text on <a + id="dx1-113056"></a> </p></dt><dd +class="description"> + <!--l. 5725--><p class="noindent" >How the entry will appear in the document text on <a href="#glo:firstuse">first use</a> with <span class="cmtt-10">\glspl</span><a - id="dx1-112047"></a> (or one of its upper case + id="dx1-113057"></a> (or one of its upper case variants). If this field is omitted, the value is obtained from the <span class="cmtt-10">plural</span><a - id="dx1-112048"></a> key, if the <span + id="dx1-113058"></a> key, if the <span class="cmtt-10">first</span><a - id="dx1-112049"></a> key is omitted, or + id="dx1-113059"></a> key is omitted, or by appending <span class="cmtt-10">\glspluralsuffix</span><a - id="dx1-112050"></a> to the value of the <span + id="dx1-113060"></a> to the value of the <span class="cmtt-10">first</span><a - id="dx1-112051"></a> field, if the <span + id="dx1-113061"></a> field, if the <span class="cmtt-10">first</span><a - id="dx1-112052"></a> field is present. Note that if + id="dx1-113062"></a> field is present. Note that if you use <span class="cmtt-10">\gls</span><a - id="dx1-112053"></a>, <span + id="dx1-113063"></a>, <span class="cmtt-10">\Gls</span><a - id="dx1-112054"></a>, <span + id="dx1-113064"></a>, <span class="cmtt-10">\GLS</span><a - id="dx1-112055"></a>, <span + id="dx1-113065"></a>, <span class="cmtt-10">\glsdisp </span>before using <span class="cmtt-10">\glspl</span><a - id="dx1-112056"></a>, the <span + id="dx1-113066"></a>, the <span class="cmtt-10">firstplural</span><a - id="dx1-112057"></a> value won’t be used with + id="dx1-113067"></a> value won’t be used with <span class="cmtt-10">\glspl</span><a - id="dx1-112058"></a>. - <!--l. 5583--><p class="noindent" ><span class="warningsymbol">⚠</span> Note: prior to version 1.13, the default value of <span + id="dx1-113068"></a>. + </p><!--l. 5735--><p class="noindent" >Although it is possible to use <span +class="cmtt-10">firstplural</span><a + id="dx1-113069"></a> in the optional argument of <span +class="cmtt-10">\newacronym</span>, it can interfere with + the acronym style and cause unexpected results. Use <span +class="cmtt-10">shortplural</span><a + id="dx1-113070"></a> and <span +class="cmtt-10">longplural</span><a + id="dx1-113071"></a> instead, if the default + value is inappropriate. + </p><!--l. 5741--><p class="noindent" ><span class="warningsymbol">⚠</span> Note: prior to version 1.13, the default value of <span class="cmtt-10">firstplural</span><a - id="dx1-112059"></a> was always taken by appending “s” to the + id="dx1-113072"></a> was always taken by appending “s” to the <span class="cmtt-10">first</span><a - id="dx1-112060"></a> key, which meant that you had to specify both <span + id="dx1-113073"></a> key, which meant that you had to specify both <span class="cmtt-10">plural</span><a - id="dx1-112061"></a> and <span + id="dx1-113074"></a> and <span class="cmtt-10">firstplural</span><a - id="dx1-112062"></a>, even if you hadn’t used + id="dx1-113075"></a>, even if you hadn’t used the <span class="cmtt-10">first</span><a - id="dx1-112063"></a> key. + id="dx1-113076"></a> key. </p></dd><dt class="description"> + <!--l. 5747--><p class="noindent" > <span class="cmtt-10">symbol</span><a - id="dx1-112064"></a> </dt><dd -class="description">This field is provided to allow the user to specify an associated symbol. If omitted, the value is set to + id="dx1-113077"></a> </p></dt><dd +class="description"> + <!--l. 5747--><p class="noindent" >This field is provided to allow the user to specify an associated symbol. If omitted, the value is set to <span class="cmtt-10">\relax</span>. Note that not all glossary styles display the symbol. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 5751--><p class="noindent" > <span class="cmtt-10">symbolplural</span><a - id="dx1-112065"></a> </dt><dd -class="description">This is the plural form of the symbol (as passed to <span + id="dx1-113078"></a> </p></dt><dd +class="description"> + <!--l. 5751--><p class="noindent" >This is the plural form of the symbol (as passed to <span class="cmtt-10">\glsdisplay</span><a - id="dx1-112066"></a> and <span + id="dx1-113079"></a> and <span class="cmtt-10">\glsdisplayfirst</span><a - id="dx1-112067"></a> by - <span + id="dx1-113080"></a> by <span class="cmtt-10">\glspl</span><a - id="dx1-112068"></a>, <span + id="dx1-113081"></a>, + <span class="cmtt-10">\Glspl</span><a - id="dx1-112069"></a> and <span + id="dx1-113082"></a> and <span class="cmtt-10">\GLSpl</span><a - id="dx1-112070"></a>). If omitted, the value is set to the same as the <span + id="dx1-113083"></a>). If omitted, the value is set to the same as the <span class="cmtt-10">symbol</span><a - id="dx1-112071"></a> key. - </dd><dt class="description"> + id="dx1-113084"></a> key. + </p></dd><dt class="description"> + <!--l. 5756--><p class="noindent" > <span class="cmtt-10">sort</span><a - id="dx1-112072"></a> </dt><dd -class="description">This value indicates how this entry should be sorted. If omitted, the value is given by the - <span + id="dx1-113085"></a> </p></dt><dd +class="description"> + <!--l. 5756--><p class="noindent" >This value indicates the text to be used by the sort comparator when ordering all the entries. If omitted, + the value is given by the <span class="cmtt-10">name</span><a - id="dx1-112073"></a> field unless one of the package options <span + id="dx1-113086"></a> field unless one of the package options <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-112074"></a> and <span + id="dx1-113087"></a> and <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-112075"></a> have been used. In general, - it’s best to use the <span + id="dx1-113088"></a> have been used. + With <a +href="#option2">Option 2</a> it’s best to use the <span class="cmtt-10">sort</span><a - id="dx1-112076"></a> key if the <span + id="dx1-113089"></a> key if the <span class="cmtt-10">name</span><a - id="dx1-112077"></a> contains commands (e.g. <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\ensuremath{\alpha}</span></span></span>). - You can also override the <span + id="dx1-113090"></a> contains commands (e.g. <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\ensuremath{\alpha}</span></span></span>) + + + and with Options <a +href="#option1">1</a> and <a +href="#option3">3</a>, it’s strongly recommended as the indexing may fail if you don’t (see + below). + </p><!--l. 5765--><p class="noindent" >You can also override the <span class="cmtt-10">sort</span><a - id="dx1-112078"></a> key by redefining <span + id="dx1-113091"></a> key by redefining <span class="cmtt-10">\glsprestandardsort</span><a - id="dx1-112079"></a> (see <a -href="#sec:pkgopts-sort">§2.5 </a><a + id="dx1-113092"></a> (see <a +href="#sec:pkgopts-sort">§<span +class="cmbx-10">??</span>sec:pkgopts-sort </a><a href="#sec:pkgopts-sort">Sorting Options<!--tex4ht:ref: sec:pkgopts-sort --></a>). - <!--l. 5607--><p class="noindent" ><div title="bib2gls" style="border: solid 2pt green;"> The <span + </p><!--l. 5768--><p class="noindent" ><div title="bib2gls" style="border: solid 2pt green;"> The <span class="cmtt-10">sort</span><a - id="dx1-112080"></a> key shouldn’t be used with <a + id="dx1-113093"></a> key shouldn’t be used with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-112081"></a></a>. It has a system of fallbacks that allow different types of + id="dx1-113094"></a></a>. It has a system of fallbacks that allow different types of entries to obtain the sort value from the most relevant field. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-112082"></a></a> manual for further details + id="dx1-113095"></a></a> manual for further details and see also <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a>. </div> - </p><!--l. 5613--><p class="noindent" > - - - </p><!--l. 5615--><p class="noindent" ><a + </p><!--l. 5774--><p class="noindent" > + </p><!--l. 5776--><p class="noindent" ><a href="#option1">Option 1</a> by default strips the <a 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 + id="dx1-113096"></a> key when it sets the <span class="cmtt-10">sort</span><a - id="dx1-112084"></a> key. So with <a + id="dx1-113097"></a> key. So with <a href="#option1">Option 1</a>: </p> - <div class="verbatim" id="verbatim-133"> + <pre class="verbatim" id="verbatim-137"> \newglossaryentry{elite}{% -  <br />  name={{\'e}lite}, -  <br />  description={select group of people} -  <br />} -</div> - <!--l. 5624--><p class="nopar" > This is equivalent to: +   name={{\'e}lite}, +   description={select group of people} + } +</pre> + <!--l. 5785--><p class="nopar" > This is equivalent to: </p> - <div class="verbatim" id="verbatim-134"> + <pre class="verbatim" id="verbatim-138"> \newglossaryentry{elite}{% -  <br />  name={{\'e}lite}, -  <br />  description={select group of people}, -  <br />  sort={elite} -  <br />} -</div> - <!--l. 5632--><p class="nopar" > Unless you use the package option <span +   name={{\'e}lite}, +   description={select group of people}, +   sort={elite} + } +</pre> + <!--l. 5793--><p class="nopar" > Unless you use the package option <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-112085"></a>, in which case it’s equivalent to: + id="dx1-113098"></a>, in which case it’s equivalent to: </p> - <div class="verbatim" id="verbatim-135"> + <pre class="verbatim" id="verbatim-139"> \newglossaryentry{elite}{% -  <br />  name={{\'e}lite}, -  <br />  description={select group of people}, -  <br />  sort={\'elite} -  <br />} -</div> - <!--l. 5641--><p class="nopar" > This will place the entry before the “A” letter group since the sort value starts with a symbol. - </p><!--l. 5645--><p class="noindent" >Similarly if you use the <span +   name={{\'e}lite}, +   description={select group of people}, +   sort={\'elite} + } +</pre> + <!--l. 5802--><p class="nopar" > This will place the entry before the “A” letter group since the sort value starts with a symbol. + </p><!--l. 5806--><p class="noindent" >Similarly if you use the <span class="cmss-10">inputenc</span><a - id="dx1-112086"></a> package: </p><div class="alltt"> + id="dx1-113099"></a> package: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{elite}{%</span> @@ -12401,7 +12976,7 @@ class="cmtt-10">}</span> class="cmtt-10">\newglossaryentry{elite}{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> name=i{{</span><span +class="cmtt-10"> name={{</span><span class="cmtt-10">é</span><span class="cmtt-10">}lite},</span> <br /><span @@ -12420,7 +12995,7 @@ class="cmtt-10">}</span> class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-112087"></a>, in which case it’s equivalent to: <div class="alltt"> + id="dx1-113100"></a>, in which case it’s equivalent to: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{elite}{%</span> @@ -12444,139 +13019,129 @@ class="cmtt-10">lite</span> class="cmtt-10">}</span> </div> </div> Again, this will place the entry before the “A” group. - <!--l. 5671--><p class="noindent" >With Options <a + <!--l. 5832--><p class="noindent" >With Options <a href="#option2">2</a> and <a href="#option3">3</a>, the default value of <span class="cmtt-10">sort</span><a - id="dx1-112088"></a> will either be set to the <span + id="dx1-113101"></a> will either be set to the <span class="cmtt-10">name</span><a - id="dx1-112089"></a> key (if <span + id="dx1-113102"></a> key (if <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-112090"></a>) or + id="dx1-113103"></a>) or it will set it to the expansion of the <span class="cmtt-10">name</span><a - id="dx1-112091"></a> key (if <span + id="dx1-113104"></a> key (if <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-112092"></a>). + id="dx1-113105"></a>). - </p><!--l. 5676--><p class="noindent" ><div class="important" title="Important Note"> Take care with <a + </p><!--l. 5837--><p class="noindent" ><div class="important" title="Important Note"> Take care with <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-112093"></a></a> (<a + id="dx1-113106"></a></a> (<a href="#option3">Option 3</a>): if you have entries with the same <span class="cmtt-10">sort</span><a - id="dx1-112094"></a> value they will be treated as + id="dx1-113107"></a> value they will be treated as the same entry. If you use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-112095"></a></a> and aren’t using the <span + id="dx1-113108"></a></a> and aren’t using the <span class="cmtt-10">def </span>or <span class="cmtt-10">use </span>sort methods, <strong>always</strong> use the <span class="cmtt-10">sort</span><a - id="dx1-112096"></a> key for entries where the name just consists of a control sequence (for example + id="dx1-113109"></a> key for entries where the name just consists of a control sequence (for example <span class="cmtt-10">name=</span><span class="cmsy-10">{</span><span class="cmtt-10">\alpha</span><span class="cmsy-10">}</span>). - </p><!--l. 5684--><p class="noindent" >Take care if you use <a + </p><!--l. 5845--><p class="noindent" >Take care if you use <a href="#option1">Option 1</a> and the <span class="cmtt-10">name</span><a - id="dx1-112097"></a> contains fragile commands. You will either need to explicitly + id="dx1-113110"></a> contains fragile commands. You will either need to explicitly set the <span class="cmtt-10">sort</span><a - id="dx1-112098"></a> key or use the <span + id="dx1-113111"></a> key or use the <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-112099"></a> package option (unless you use the <span + id="dx1-113112"></a> package option (unless you use the <span class="cmtt-10">def </span>or <span class="cmtt-10">use </span>sort methods). </div> - </p><!--l. 5688--><p class="noindent" > + </p><!--l. 5849--><p class="noindent" > </p></dd><dt class="description"> + <!--l. 5851--><p class="noindent" > <span class="cmtt-10">type</span><a - id="dx1-112100"></a> </dt><dd -class="description">This specifies the label of the glossary in which this entry belongs. If omitted, the default glossary is - assumed unless <span + id="dx1-113113"></a> </p></dt><dd +class="description"> + <!--l. 5851--><p class="noindent" >This specifies the label of the glossary in which this entry belongs. If omitted, the default + glossary is assumed unless <span class="cmtt-10">\newacronym</span><a - id="dx1-112101"></a> is used (see <a -href="#sec:acronyms">§13 </a><a -href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>). - </dd><dt class="description"> + id="dx1-113114"></a> is used (see <a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other + Abbreviations<!--tex4ht:ref: sec:acronyms --></a>). + </p></dd><dt class="description"> + <!--l. 5857--><p class="noindent" > <span class="cmtt-10">user1</span><a - id="dx1-112102"></a><span + id="dx1-113115"></a><span class="cmbx-10">, </span><span class="cmbx-10">…, </span><span class="cmtt-10">user6</span><a - id="dx1-112103"></a><a - id="dx1-112104"></a><a - id="dx1-112105"></a><a - id="dx1-112106"></a><a - id="dx1-112107"></a> </dt><dd -class="description">Six keys provided for any additional information the user may want to specify. (For - example, an associated dimension or an alternative plural or some other grammatical construct.) - Alternatively, you can add new keys using <span + id="dx1-113116"></a><a + id="dx1-113117"></a><a + id="dx1-113118"></a><a + id="dx1-113119"></a><a + id="dx1-113120"></a> </p></dt><dd +class="description"> + <!--l. 5857--><p class="noindent" >Six keys provided for any additional information the user may want to specify. (For example, an associated + dimension or an alternative plural or some other grammatical construct.) Alternatively, you + can add new keys using <span class="cmtt-10">\glsaddkey</span><a - id="dx1-112108"></a> or <span + id="dx1-113121"></a> or <span class="cmtt-10">\glsaddstoragekey</span><a - id="dx1-112109"></a> (see <a -href="#sec:addkey">§4.3 </a><a + id="dx1-113122"></a> (see <a +href="#sec:addkey">§<span +class="cmbx-10">??</span>sec:addkey </a><a href="#sec:addkey">Additional Keys<!--tex4ht:ref: sec:addkey --></a>). - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 5863--><p class="noindent" > <span class="cmtt-10">nonumberlist</span><a - id="dx1-112110"></a> </dt><dd -class="description">A boolean key. If the value is missing or is <span + id="dx1-113123"></a> </p></dt><dd +class="description"> + <!--l. 5863--><p class="noindent" >A boolean key. If the value is missing or is <span class="cmtt-10">true</span>, this will suppress the <a -href="#glo:numberlist">number - list<a - id="dx1-112111"></a></a> just for this entry. Conversely, if you have used the package option <span +href="#glo:numberlist">number list<a + id="dx1-113124"></a></a> just for this + entry. Conversely, if you have used the package option <span class="cmss-10">nonumberlist</span><a - id="dx1-112112"></a>, you - can activate the number list<a - id="dx1-112113"></a> just for this entry with <span + id="dx1-113125"></a>, you can activate the + number list<a + id="dx1-113126"></a> just for this entry with <span class="cmtt-10">nonumberlist=false</span><a - id="dx1-112114"></a>. (See <a -href="#sec:numberlists">§5 </a><a + id="dx1-113127"></a>. (See <a +href="#sec:numberlists">§<span +class="cmbx-10">??</span>sec:numberlists </a><a href="#sec:numberlists">Number - lists<!--tex4ht:ref: sec:numberlists --></a>.) - </dd><dt class="description"> + Lists<!--tex4ht:ref: sec:numberlists --></a>.) + </p></dd><dt class="description"> + <!--l. 5870--><p class="noindent" > <span class="cmtt-10">see</span><a - id="dx1-112115"></a> </dt><dd -class="description">Cross-reference another entry. Using the <span -class="cmtt-10">see</span><a - id="dx1-112116"></a> key will <span -class="cmti-10">automatically add this entry to the glossary</span>, but will - not automatically add the cross-referenced entry. The referenced entry should be supplied as the value to - this key. If you want to override the “see” tag, you can supply the new tag in square brackets before the - label. For example <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">see=[see</span><span -class="cmtt-10"> also]{anotherlabel}</span></span></span>. <strong>Note that if you have suppressed the <a -href="#glo:numberlist">number list<a - id="dx1-112117"></a></a>, - the cross-referencing information won’t appear in the glossary, as it forms part of the number list<a - id="dx1-112118"></a>.</strong> You can - override this for individual glossary entries using <span -class="cmtt-10">nonumberlist=false</span><a - id="dx1-112119"></a> (see above). Alternatively, you - can use the <span -class="cmss-10">seeautonumberlist</span><a - id="dx1-112120"></a> package option. For further details, see <a -href="#sec:crossref">§8 </a><a -href="#sec:crossref">Cross-Referencing - Entries<!--tex4ht:ref: sec:crossref --></a>. - <!--l. 5723--><p class="noindent" >This key essentially provides a convenient shortcut that performs </p><div class="alltt"> + id="dx1-113128"></a> </p></dt><dd +class="description"> + <!--l. 5870--><p class="noindent" >This key essentially provides a convenient shortcut that performs </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glssee[</span>⟨<span @@ -12588,74 +13153,159 @@ class="cmitt-10">xr-label</span><span class="cmitt-10"> list</span>⟩<span class="cmtt-10">}</span> </div> - </div> after the entry has been defined. - <!--l. 5729--><p class="noindent" ><div class="important" title="Important Note"> For Options <a + + + </div> after the entry has been defined. (See <a +href="#sec:crossref">§<span +class="cmbx-10">??</span>sec:crossref </a><a +href="#sec:crossref">Cross-Referencing Entries<!--tex4ht:ref: sec:crossref --></a>.) It was originally designed + for synonyms that may not occur in the document text but needed to be included in the glossary in order + to redirect the reader. Note that it doesn’t index the cross-referenced entry (or entries) as that would + interfere with their <a +href="#glo:numberlist">number list<a + id="dx1-113129"></a>s</a>. + <!--l. 5881--><p class="noindent" ><div class="important" title="Important Note"> Using the <span +class="cmtt-10">see</span><a + id="dx1-113130"></a> key will <span +class="cmti-10">automatically add this entry to the glossary</span>, but will not automatically add the + cross-referenced entry. </div> + </p><!--l. 5885--><p class="noindent" > + </p><!--l. 5887--><p class="noindent" >For example: + + +</p> + <pre class="verbatim" id="verbatim-140"> + \newglossaryentry{courgette}{name={courgette}, +   description={variety of small marrow}} + \newglossaryentry{zucchini}{name={zucchini}, +   description={(North American)}, +   see={courgette}} +</pre> + <!--l. 5894--><p class="nopar" > This defines two entries (courgette and zucchini) and automatically adds a cross-reference from zucchini + to courgette. (That is, it adds “<span +class="cmti-10">see </span>courgette” to zucchini’s <a +href="#glo:numberlist">number list<a + id="dx1-113131"></a></a>.) This doesn’t automatically index + courgette since this would create an unwanted location in courgette’s <a +href="#glo:numberlist">number list<a + id="dx1-113132"></a></a>. (Page 1, if the + definitions occur in the preamble.) + </p><!--l. 5902--><p class="noindent" >Note that while it’s possible to put the cross-reference in the description instead, for example: + + +</p> + <pre class="verbatim" id="verbatim-141"> + \newglossaryentry{zucchini}{name={zucchini}, +   description={(North American) see \gls{courgette}}} +</pre> + <!--l. 5907--><p class="nopar" > this won’t index the zucchini entry, so if zucchini isn’t indexed elsewhere (with commands like <span +class="cmtt-10">\gls </span>or + <span +class="cmtt-10">\glsadd</span>) then it won’t appear in the glossary even if courgette does. + </p><!--l. 5912--><p class="noindent" >The referenced entry should be supplied as the value to this key. If you want to override + the “see” tag, you can supply the new tag in square brackets before the label. For example + <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">see=[see</span><span +class="cmtt-10"> also]{anotherlabel}</span></span></span>. <strong>Note that if you have suppressed the <a +href="#glo:numberlist">number list<a + id="dx1-113133"></a></a>, the cross-referencing + information won’t appear in the glossary, as it forms part of the number list<a + id="dx1-113134"></a>.</strong> You can override this for + individual glossary entries using <span +class="cmtt-10">nonumberlist=false</span><a + id="dx1-113135"></a> (see above). Alternatively, you can use the + <span +class="cmss-10">seeautonumberlist</span><a + id="dx1-113136"></a> package option. For further details, see <a +href="#sec:crossref">§<span +class="cmbx-10">??</span>sec:crossref </a><a +href="#sec:crossref">Cross-Referencing + Entries<!--tex4ht:ref: sec:crossref --></a>. + </p><!--l. 5923--><p class="noindent" ><div class="important" title="Important Note"> For Options <a href="#option2">2</a> and <a href="#option3">3</a>, <span class="cmtt-10">\makeglossaries</span><a - id="dx1-112121"></a> must be used before any occurrence of <span + id="dx1-113137"></a> must be used before any occurrence of <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-112122"></a> that + id="dx1-113138"></a> that contains the <span class="cmtt-10">see</span><a - id="dx1-112123"></a> key. This key should not be used with entries defined in the <span + id="dx1-113139"></a> key. This key should not be used with entries defined in the <span class="cmss-10">document</span><a - id="dx1-112124"></a><a - id="dx1-112125"></a> environment. + id="dx1-113140"></a><a + id="dx1-113141"></a> environment. </div> - - - </p><!--l. 5733--><p class="noindent" > + </p><!--l. 5927--><p class="noindent" > Since it’s useful to suppress the indexing while working on a draft document, consider using the <span class="cmss-10">seenoindex</span><a - id="dx1-112126"></a> package option to warn or ignore the <span + id="dx1-113142"></a> package option to warn or ignore the <span class="cmtt-10">see</span><a - id="dx1-112127"></a> key while <span + id="dx1-113143"></a> key while <span class="cmtt-10">\makeglossaries </span>is commented out. - </p><!--l. 5739--><p class="noindent" >If you use the <span + </p><!--l. 5933--><p class="noindent" >If you use the <span class="cmtt-10">see</span><a - id="dx1-112128"></a> key, you may want to consider using the <a + id="dx1-113144"></a> key, you may want to consider using the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package which additionally provides a <span class="cmtt-10">seealso </span>and <span class="cmtt-10">alias </span>key. If you want to avoid the automatic indexing triggered by the <span class="cmtt-10">see</span><a - id="dx1-112129"></a> key, + id="dx1-113145"></a> key, consider using <a -href="#option4">Option 4</a>. +href="#option4">Option 4</a>. See also the FAQ item <a +href="https://www.dickimaw-books.com/faq.php?action=view&category=glossaries&itemlabel=whyseekeyautoindex" >Why does the see key automatically index the + entry?</a> + </p><!--l. 5940--><p class="noindent" ><div title="bib2gls" style="border: solid 2pt green;"> The analogous <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-113146"></a></a> <span +class="cmtt-10">see</span><a + id="dx1-113147"></a> field (and <span id="textcolor260"><span id="textcolor261"><span +class="cmtt-10">seealso</span></span><a + id="dx1-113148"></a></span>) have a slightly different meaning. The <span id="textcolor262"><span +class="cmtt-10">selection</span></span><a + id="dx1-113149"></a> + resource option determines the behaviour. </div> + </p><!--l. 5944--><p class="noindent" > </p></dd><dt class="description"> -<span id="textcolor253"><span id="textcolor254"><span + <!--l. 5946--><p class="noindent" > +<span id="textcolor263"><span id="textcolor264"><span class="cmtt-10">seealso</span></span><a - id="dx1-112130"></a></span> </dt><dd -class="description">This key is only available with <a + id="dx1-113150"></a></span> </p></dt><dd +class="description"> + <!--l. 5946--><p class="noindent" >This key is only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> and is similar to <span class="cmtt-10">see</span><a - id="dx1-112131"></a> but it doesn’t allow for the - optional tag. The <a + id="dx1-113151"></a> but it doesn’t allow for the optional + tag. The <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package provides <span id="textcolor255"><span +class="cmss-10">glossaries-extra</span></a> package provides <span id="textcolor265"><span class="cmtt-10">\seealsoname</span></span><a - id="dx1-112132"></a> and <span + id="dx1-113152"></a> and <span class="cmtt-10">seealso={</span>⟨<span class="cmitt-10">list</span>⟩<span class="cmtt-10">} </span>is essentially like <span -class="cmtt-10">see=[</span><span id="textcolor256"><span +class="cmtt-10">see=[</span><span id="textcolor266"><span class="cmtt-10">\seealsoname</span></span><a - id="dx1-112133"></a><span + id="dx1-113153"></a><span class="cmtt-10">]</span>⟨<span class="cmitt-10">list</span>⟩ (Options <a href="#option3">3</a> and <a href="#option4">4</a> may treat these differently). - </dd><dt class="description"> -<span id="textcolor257"><span id="textcolor258"><span + </p></dd><dt class="description"> + <!--l. 5954--><p class="noindent" > +<span id="textcolor267"><span id="textcolor268"><span class="cmtt-10">alias</span></span><a - id="dx1-112134"></a></span> </dt><dd -class="description">This key is only available with <a + id="dx1-113154"></a></span> </p></dt><dd +class="description"> + + + <!--l. 5954--><p class="noindent" >This key is only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> and is another form of cross-referencing. An entry can be aliased to another entry with <span @@ -12668,103 +13318,112 @@ class="cmtt-10">} </span>but also alters the behaviour of commands like <span class="cmtt-10">\gls </span>so that they index the entry given by ⟨<span class="cmti-10">label</span>⟩ instead of the original entry. - More variations with the key are available with <a + (See, for example, <a +href="https://www.dickimaw-books.com/gallery/index.php?label=aliases" >Gallery: Aliases</a>.) + </p><!--l. 5963--><p class="noindent" ><div title="bib2gls" style="border: solid 2pt green;"> More variations with the key are available with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-112135"></a></a>. - </dd><dt class="description"> -<span id="textcolor259"><span id="textcolor260"><span + id="dx1-113155"></a></a>. </div> + </p><!--l. 5965--><p class="noindent" > + </p></dd><dt class="description"> + <!--l. 5967--><p class="noindent" > +<span id="textcolor269"><span id="textcolor270"><span class="cmtt-10">category</span></span><a - id="dx1-112136"></a></span> </dt><dd -class="description">This key is only available with <a + id="dx1-113156"></a></span> </p></dt><dd +class="description"> + <!--l. 5967--><p class="noindent" >This key is only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> and is used to assign a category to the entry. The value should be a label that can be used to identify the category. See <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. +</p> </dd></dl> -<!--l. 5770--><p class="indent" > The following keys are reserved for <span +<!--l. 5975--><p class="indent" > The following keys are reserved for <span class="cmtt-10">\newacronym</span><a - id="dx1-112137"></a> (see <a -href="#sec:acronyms">§13 </a><a + id="dx1-113157"></a> (see <a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>) -and also for <span id="textcolor261"><span +and also for <span id="textcolor271"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-112138"></a> (see the <a + id="dx1-113158"></a> (see the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual): <span class="cmtt-10">long</span><a - id="dx1-112139"></a>, <span + id="dx1-113159"></a>, <span class="cmtt-10">longplural</span><a - id="dx1-112140"></a>, <span + id="dx1-113160"></a>, <span class="cmtt-10">short</span><a - id="dx1-112141"></a> and + id="dx1-113161"></a> and <span class="cmtt-10">shortplural</span><a - id="dx1-112142"></a>. -</p><!--l. 5775--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> There are also special internal field names used by <a + id="dx1-113162"></a>. +</p><!--l. 5980--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> There are also special internal field names used by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-112143"></a></a>. See the <a + id="dx1-113163"></a></a>. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-112144"></a></a> manual for further details. + id="dx1-113164"></a></a> manual for further details. </div> -</p><!--l. 5778--><p class="noindent" > -</p><!--l. 5780--><p class="indent" > The supplementary packages <span +</p><!--l. 5983--><p class="noindent" > +</p><!--l. 5985--><p class="indent" > The supplementary packages <span class="cmss-10">glossaries-prefix </span>(<a -href="#sec:prefix">§17 </a><a +href="#sec:prefix">§<span +class="cmbx-10">??</span>sec:prefix </a><a href="#sec:prefix">Prefixes or Determiners<!--tex4ht:ref: sec:prefix --></a>) and <span -class="cmss-10">glossaries-accsupp </span>(<a -href="#sec:accsupp">§18 -</a><a +class="cmss-10">glossaries-accsupp</span> +(<a +href="#sec:accsupp">§<span +class="cmbx-10">??</span>sec:accsupp </a><a href="#sec:accsupp">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a>) provide additional keys. -</p><!--l. 5783--><p class="indent" > <div class="important" title="Important Note"> Avoid using any of the <a +</p><!--l. 5988--><p class="indent" > <div class="important" title="Important Note"> Avoid using any of the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> or <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands within the <span class="cmtt-10">text</span><a - id="dx1-112145"></a>, <span + id="dx1-113165"></a>, <span class="cmtt-10">first</span><a - id="dx1-112146"></a>, <span + id="dx1-113166"></a>, <span class="cmtt-10">short</span><a - id="dx1-112147"></a> or <span + id="dx1-113167"></a> or <span class="cmtt-10">long</span><a - id="dx1-112148"></a> keys + id="dx1-113168"></a> keys (or their plural equivalent) or any other key that you plan to access through those commands. (For example, the <span class="cmtt-10">symbol</span><a - id="dx1-112149"></a> key if you intend to use <span + id="dx1-113169"></a> key if you intend to use <span class="cmtt-10">\glssymbol</span>.) Otherwise you end up with nested links, which can cause complications and they won’t work with the case-changing commands. You can use them within the value of keys that won’t be accessed through those commands. For example, the <span class="cmtt-10">description</span><a - id="dx1-112150"></a> key if you don’t + id="dx1-113170"></a> key if you don’t use <span class="cmtt-10">\glsdesc</span>. Additionally, they’ll confuse the entry formatting commands, such as <span class="cmtt-10">\glslabel</span>. </div> -</p><!--l. 5796--><p class="noindent" > -</p><!--l. 5798--><p class="indent" > Note that if the name starts with <a +</p><!--l. 6001--><p class="noindent" > +</p><!--l. 6003--><p class="indent" > Note that if the name starts with <a href="#glo:nonlatinchar">non-Latin character<a - id="dx1-112151"></a></a>, you must group the character, otherwise it will cause + id="dx1-113171"></a></a>, you must group the character, otherwise it will cause a problem for commands like <span class="cmtt-10">\Gls</span><a - id="dx1-112152"></a> and <span + id="dx1-113172"></a> and <span class="cmtt-10">\Glspl</span><a - id="dx1-112153"></a>. For example: + id="dx1-113173"></a>. For example: </p> - <div class="verbatim" id="verbatim-136"> + <pre class="verbatim" id="verbatim-142"> \newglossaryentry{elite}{name={{\'e}lite}, - <br />description={select group or class}} -</div> -<!--l. 5805--><p class="nopar" > Note that the same applies if you are using the <span +description={select group or class}} +</pre> +<!--l. 6010--><p class="nopar" > Note that the same applies if you are using the <span class="cmss-10">inputenc</span><a - id="dx1-112154"></a> package: </p><div class="alltt"> + id="dx1-113174"></a> package: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{elite}{name={{</span><span @@ -12776,169 +13435,171 @@ class="cmtt-10"> group</span><span class="cmtt-10"> or</span><span class="cmtt-10"> class}}</span> </div> -</div> (This doesn’t apply for XeLaTeX documents using the <span -class="cmss-10">fontspec</span><a - id="dx1-112155"></a> package. For further details, see the “UTF-8” -section in the <span +</div> (This doesn’t apply for XeLaTeX or LuaLaTeX documents. For further details, see the “UTF-8” section in the +<span class="cmss-10">mfirstuc</span><a - id="dx1-112156"></a> user manual.) -<!--l. 5816--><p class="indent" > Note that in both of the above examples, you will also need to supply the <span + id="dx1-113175"></a> user manual.) +<!--l. 6021--><p class="indent" > Note that in both of the above examples, you will also need to supply the <span class="cmtt-10">sort</span><a - id="dx1-112157"></a> key if you are + id="dx1-113176"></a> key if you are using <a href="#option2">Option 2</a> whereas <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-112158"></a></a> (<a + id="dx1-113177"></a></a> (<a href="#option3">Option 3</a>) is usually able to sort <a href="#glo:nonlatinchar">non-Latin character<a - id="dx1-112159"></a>s</a> correctly. + id="dx1-113178"></a>s</a> correctly. <a href="#option1">Option 1</a> discards accents from <a href="#glo:latexexlatinchar">standard LaTeX extended Latin character<a - id="dx1-112160"></a>s</a> unless you use the + id="dx1-113179"></a>s</a> unless you use the <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-112161"></a>. + id="dx1-113180"></a>. </p> -<!--l. 5824--><p class="noindent" ><a +<!--l. 6029--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.1 </span> <a id="sec:plurals"></a>Plurals</h3> -<!--l. 5827--><p class="noindent" >You may have noticed from above that you can specify the plural form when you define a term. If you omit this, +<!--l. 6032--><p class="noindent" >You may have noticed from above that you can specify the plural form when you define a term. If you omit this, the plural will be obtained by appending -</p><!--l. 5830--><p class="indent" > <hr><div title="Definition"><a - id="dx1-113001"></a> <span +</p><!--l. 6035--><p class="indent" > <hr><div title="Definition"><a + id="dx1-114001"></a> <span class="cmtt-10">\glspluralsuffix </span></div><hr> -</p><!--l. 5832--><p class="noindent" > +</p><!--l. 6037--><p class="noindent" > to the singular form. This command defaults to the letter “s”. For example: </p> - <div class="verbatim" id="verbatim-137"> + <pre class="verbatim" id="verbatim-143"> \newglossaryentry{cow}{name=cow,description={a fully grown - <br />female of any bovine animal}} -</div> -<!--l. 5838--><p class="nopar" > defines a new entry whose singular form is “cow” and plural form is “cows”. However, if you are writing in +female of any bovine animal}} +</pre> +<!--l. 6043--><p class="nopar" > defines a new entry whose singular form is “cow” and plural form is “cows”. However, if you are writing in archaic English, you may want to use “kine” as the plural form, in which case you would have to do: </p> - <div class="verbatim" id="verbatim-138"> + <pre class="verbatim" id="verbatim-144"> \newglossaryentry{cow}{name=cow,plural=kine, - <br />description={a fully grown female of any bovine animal}} -</div> -<!--l. 5846--><p class="nopar" > -</p><!--l. 5848--><p class="indent" > If you are writing in a language that supports multiple plurals (for a given term) then use the <span +description={a fully grown female of any bovine animal}} +</pre> +<!--l. 6051--><p class="nopar" > +</p><!--l. 6053--><p class="indent" > If you are writing in a language that supports multiple plurals (for a given term) then use the <span class="cmtt-10">plural</span><a - id="dx1-113002"></a> key for + id="dx1-114002"></a> key for one of them and one of the user keys to specify the other plural form. For example: </p> - <div class="verbatim" id="verbatim-139"> + <pre class="verbatim" id="verbatim-145"> \newglossaryentry{cow}{% - <br />  name=cow,% - <br />  description={a fully grown female of any bovine animal - <br />               (plural cows, archaic plural kine)},% - <br />  user1={kine}} -</div> -<!--l. 5858--><p class="nopar" > You can then use <span class="obeylines-h"><span class="verb"><span +  name=cow,% +  description={a fully grown female of any bovine animal +               (plural cows, archaic plural kine)},% +  user1={kine}} +</pre> +<!--l. 6063--><p class="nopar" > You can then use <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspl{cow}</span></span></span> to produce “cows” and <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuseri{cow}</span></span></span> to produce “kine”. You can, of course, define an easy to remember synonym. For example: </p> - <div class="verbatim" id="verbatim-140"> + <pre class="verbatim" id="verbatim-146"> \let\glsaltpl\glsuseri -</div> -<!--l. 5864--><p class="nopar" > Then you don’t have to remember which key you used to store the second plural. Alternatively, you can define +</pre> +<!--l. 6069--><p class="nopar" > Then you don’t have to remember which key you used to store the second plural. Alternatively, you can define your own keys using <span class="cmtt-10">\glsaddkey</span><a - id="dx1-113003"></a>, described in <a -href="#sec:addkey">§4.3 </a><a + id="dx1-114003"></a>, described in <a +href="#sec:addkey">§<span +class="cmbx-10">??</span>sec:addkey </a><a href="#sec:addkey">Additional Keys<!--tex4ht:ref: sec:addkey --></a>. -</p><!--l. 5869--><p class="indent" > If you are using a language that usually forms plurals by appending a different letter, or sequence of letters, +</p><!--l. 6074--><p class="indent" > If you are using a language that usually forms plurals by appending a different letter, or sequence of letters, you can redefine <span class="cmtt-10">\glspluralsuffix </span>as required. However, this must be done <span class="cmti-10">before </span>the entries are defined. For languages that don’t form plurals by simply appending a suffix, all the plural forms must be specified using the <span class="cmtt-10">plural</span><a - id="dx1-113004"></a> key (and the <span + id="dx1-114004"></a> key (and the <span class="cmtt-10">firstplural</span><a - id="dx1-113005"></a> key where necessary). -</p><!--l. 5877--><p class="noindent" > + id="dx1-114005"></a> key where necessary). +</p><!--l. 6082--><p class="noindent" > </p> -<!--l. 5877--><p class="noindent" ><a +<!--l. 6082--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.2 </span> <a id="sec:grammar"></a>Other Grammatical Constructs</h3> -<!--l. 5880--><p class="noindent" >You can use the six user keys to provide alternatives, such as participles. For example: +<!--l. 6085--><p class="noindent" >You can use the six user keys to provide alternatives, such as participles. For example: </p> - <div class="verbatim" id="verbatim-141"> + <pre class="verbatim" id="verbatim-147"> \let\glsing\glsuseri - <br />\let\glsd\glsuserii - <br />\newcommand*{\ingkey}{user1} - <br />\newcommand*{\edkey}{user2} - <br />\newcommand*{\newword}[3][]{% - <br />  \newglossaryentry{#2}{% - <br />   name={#2},% - <br />   description={#3},% - <br />   \edkey={#2ed},% - <br />   \ingkey={#2ing},#1% - <br />  }% - <br />} -</div> -<!--l. 5897--><p class="nopar" > With the above definitions, I can now define terms like this: - - -</p> - <div class="verbatim" id="verbatim-142"> +\let\glsd\glsuserii +\newcommand*{\ingkey}{user1} +\newcommand*{\edkey}{user2} +\newcommand*{\newword}[3][]{% +  \newglossaryentry{#2}{% +   name={#2},% +   description={#3},% +   \edkey={#2ed},% +   \ingkey={#2ing},#1% +  }% +} +</pre> +<!--l. 6102--><p class="nopar" > With the above definitions, I can now define terms like this: + + +</p> + <pre class="verbatim" id="verbatim-148"> \newword{play}{to take part in activities for enjoyment} - <br />\newword[\edkey={ran},\ingkey={running}]{run}{to move fast using - <br />the legs} -</div> -<!--l. 5903--><p class="nopar" > and use them in the text: +\newword[\edkey={ran},\ingkey={running}]{run}{to move fast using +the legs} +</pre> +<!--l. 6108--><p class="nopar" > and use them in the text: </p> - <div class="verbatim" id="verbatim-143"> + <pre class="verbatim" id="verbatim-149"> Peter is \glsing{play} in the park today. - <br />Jane \glsd{play} in the park yesterday. - <br />Peter and Jane \glsd{run} in the park last week. -</div> -<!--l. 5911--><p class="nopar" > -</p><!--l. 5913--><p class="indent" > Alternatively, you can define your own keys using <span +Jane \glsd{play} in the park yesterday. +Peter and Jane \glsd{run} in the park last week. +</pre> +<!--l. 6116--><p class="nopar" > +</p><!--l. 6118--><p class="indent" > Alternatively, you can define your own keys using <span class="cmtt-10">\glsaddkey</span><a - id="dx1-114001"></a>, described below in <a -href="#sec:addkey">§4.3 </a><a + id="dx1-115001"></a>, described below in <a +href="#sec:addkey">§<span +class="cmbx-10">??</span>sec:addkey </a><a href="#sec:addkey">Additional Keys<!--tex4ht:ref: sec:addkey --></a>. -</p><!--l. 5916--><p class="noindent" > +</p><!--l. 6121--><p class="noindent" > </p> -<!--l. 5916--><p class="noindent" ><a +<!--l. 6121--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.3 </span> <a id="sec:addkey"></a>Additional Keys</h3> -<!--l. 5919--><p class="noindent" >You can now also define your own custom keys using the commands described in this section. There are two +<!--l. 6124--><p class="noindent" >You can now also define your own custom keys using the commands described in this section. There are two types of keys: those for use within the document and those to store information used behind the scenes by other commands. -</p><!--l. 5924--><p class="indent" > For example, if you want to add a key that indicates the associated unit for a term, you might want to +</p><!--l. 6129--><p class="indent" > For example, if you want to add a key that indicates the associated unit for a term, you might want to reference this unit in your document. In this case use <span class="cmtt-10">\glsaddkey </span>described in <a -href="#sec:glsaddkey">§4.3.1 </a><a -href="#sec:glsaddkey">Document Keys<!--tex4ht:ref: sec:glsaddkey --></a>. If, on the -other hand, you want to add a key to indicate to a glossary style or acronym style that this entry should be -formatted differently to other entries, then you can use <span -class="cmtt-10">\glsaddstoragekey </span>described in <a -href="#sec:glsaddstoragekey">§4.3.2 </a><a -href="#sec:glsaddstoragekey">Storage -Keys<!--tex4ht:ref: sec:glsaddstoragekey --></a>. -</p><!--l. 5932--><p class="indent" > In both cases, a new command ⟨<span +href="#sec:glsaddkey">§<span +class="cmbx-10">??</span>sec:glsaddkey </a><a +href="#sec:glsaddkey">Document Keys<!--tex4ht:ref: sec:glsaddkey --></a>. +If, on the other hand, you want to add a key to indicate to a glossary style or acronym style that this entry +should be formatted differently to other entries, then you can use <span +class="cmtt-10">\glsaddstoragekey </span>described in +<a +href="#sec:glsaddstoragekey">§<span +class="cmbx-10">??</span>sec:glsaddstoragekey </a><a +href="#sec:glsaddstoragekey">Storage Keys<!--tex4ht:ref: sec:glsaddstoragekey --></a>. +</p><!--l. 6137--><p class="indent" > In both cases, a new command ⟨<span class="cmti-10">no link cs</span>⟩ will be defined that can be used to access the value of this key (analogous to commands such as <span class="cmtt-10">\glsentrytext</span>). This can be used in an expandable context (provided any @@ -12946,14 +13607,14 @@ fragile commands stored in the key have been protected). The new keys must be ad class="cmtt-10">\glsaddkey </span>or <span class="cmtt-10">\glsaddstoragekey </span>before glossary entries are defined. -</p><!--l. 5939--><p class="noindent" > +</p><!--l. 6144--><p class="noindent" > </p> -<!--l. 5939--><p class="noindent" ><a +<!--l. 6144--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.3.1 </span> <a id="sec:glsaddkey"></a>Document Keys</h4> -<!--l. 5942--><p class="noindent" >A custom key that can be used in the document is defined using: -</p><!--l. 5943--><p class="indent" > <hr><div title="Definition"><a - id="dx1-116001"></a> <span +<!--l. 6147--><p class="noindent" >A custom key that can be used in the document is defined using: +</p><!--l. 6148--><p class="indent" > <hr><div title="Definition"><a + id="dx1-117001"></a> <span class="cmtt-10">\glsaddkey{</span>⟨<span class="cmitt-10">key</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -12971,67 +13632,81 @@ class="cmitt-10">cs</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">link allcaps cs</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 5951--><p class="noindent" > +</p><!--l. 6156--><p class="noindent" > where: </p><dl class="description"><dt class="description"> + <!--l. 6159--><p class="noindent" > ⟨<span -class="cmbxti-10">key</span>⟩ </dt><dd -class="description">is the new key to use in <span +class="cmbxti-10">key</span>⟩ </p></dt><dd +class="description"> + <!--l. 6159--><p class="noindent" >is the new key to use in <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-116002"></a> (or similar commands such as + id="dx1-117002"></a> (or similar commands such as <span class="cmtt-10">\longnewglossaryentry</span><a - id="dx1-116003"></a>); + id="dx1-117003"></a>); - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 6161--><p class="noindent" > ⟨<span -class="cmbxti-10">default value</span>⟩ </dt><dd -class="description">is the default value to use if this key isn’t used in an entry definition (this may reference - the current entry label via <span -class="cmtt-10">\glslabel</span>, but you will have to switch on expansion via the starred - version of <span +class="cmbxti-10">default value</span>⟩ </p></dt><dd +class="description"> + <!--l. 6161--><p class="noindent" >is the default value to use if this key isn’t used in an entry definition (this may reference the current + entry label via <span +class="cmtt-10">\glslabel</span>, but you will have to switch on expansion via the starred version of + <span class="cmtt-10">\glsaddkey </span>and protect fragile commands); - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 6166--><p class="noindent" > ⟨<span -class="cmbxti-10">no link cs</span>⟩ </dt><dd -class="description">is the control sequence to use analogous to commands like <span +class="cmbxti-10">no link cs</span>⟩ </p></dt><dd +class="description"> + <!--l. 6166--><p class="noindent" >is the control sequence to use analogous to commands like <span class="cmtt-10">\glsentrytext</span><a - id="dx1-116004"></a>; - </dd><dt class="description"> + id="dx1-117004"></a>; + </p></dd><dt class="description"> + <!--l. 6168--><p class="noindent" > ⟨<span -class="cmbxti-10">no link ucfirst cs</span>⟩ </dt><dd -class="description">is the control sequence to use analogous to commands like <span +class="cmbxti-10">no link ucfirst cs</span>⟩ </p></dt><dd +class="description"> + <!--l. 6168--><p class="noindent" >is the control sequence to use analogous to commands like <span class="cmtt-10">\Glsentrytext</span><a - id="dx1-116005"></a>; - </dd><dt class="description"> + id="dx1-117005"></a>; + </p></dd><dt class="description"> + <!--l. 6170--><p class="noindent" > ⟨<span -class="cmbxti-10">link cs</span>⟩ </dt><dd -class="description">is the control sequence to use analogous to commands like <span +class="cmbxti-10">link cs</span>⟩ </p></dt><dd +class="description"> + <!--l. 6170--><p class="noindent" >is the control sequence to use analogous to commands like <span class="cmtt-10">\glstext</span><a - id="dx1-116006"></a>; - </dd><dt class="description"> + id="dx1-117006"></a>; + </p></dd><dt class="description"> + <!--l. 6172--><p class="noindent" > ⟨<span -class="cmbxti-10">link ucfirst cs</span>⟩ </dt><dd -class="description">is the control sequence to use analogous to commands like <span +class="cmbxti-10">link ucfirst cs</span>⟩ </p></dt><dd +class="description"> + <!--l. 6172--><p class="noindent" >is the control sequence to use analogous to commands like <span class="cmtt-10">\Glstext</span><a - id="dx1-116007"></a>; - </dd><dt class="description"> + id="dx1-117007"></a>; + </p></dd><dt class="description"> + <!--l. 6174--><p class="noindent" > ⟨<span -class="cmbxti-10">link allcaps cs</span>⟩ </dt><dd -class="description">is the control sequence to use analogous to commands like <span +class="cmbxti-10">link allcaps cs</span>⟩ </p></dt><dd +class="description"> + <!--l. 6174--><p class="noindent" >is the control sequence to use analogous to commands like <span class="cmtt-10">\GLStext</span><a - id="dx1-116008"></a>.</dd></dl> -<!--l. 5972--><p class="noindent" >The starred version of <span + id="dx1-117008"></a>.</p></dd></dl> +<!--l. 6177--><p class="noindent" >The starred version of <span class="cmtt-10">\glsaddkey </span>switches on expansion for this key. The unstarred version doesn’t override the current expansion setting. <a id="ex:addkey"></a> -</p><!--l. 5976--><p class="noindent" ><span +</p><!--l. 6181--><p class="noindent" ><span class="cmbx-12">Example 3</span><span class="cmbx-12"> (Defining Custom Keys)</span><a - id="x1-116010"></a> -</p><!--l. 5977--><p class="indent" > Suppose I want to define two new keys, <span + id="x1-117010"></a> +</p><!--l. 6182--><p class="indent" > Suppose I want to define two new keys, <span class="cmtt-10">ed </span>and <span class="cmtt-10">ing</span>, that default to the entry text followed by “ed” and “ing”, respectively. The default value will need expanding in both cases, so I need to use the starred @@ -13039,68 +13714,68 @@ form: </p> - <div class="verbatim" id="verbatim-144"> + <pre class="verbatim" id="verbatim-150">  % Define "ed" key: - <br /> \glsaddkey* - <br />  {ed}% key - <br />  {\glsentrytext{\glslabel}ed}% default value - <br />  {\glsentryed}% command analogous to \glsentrytext - <br />  {\Glsentryed}% command analogous to \Glsentrytext - <br />  {\glsed}% command analogous to \glstext - <br />  {\Glsed}% command analogous to \Glstext - <br />  {\GLSed}% command analogous to \GLStext - <br /> % Define "ing" key: - <br /> \glsaddkey* - <br />  {ing}% key - <br />  {\glsentrytext{\glslabel}ing}% default value - <br />  {\glsentrying}% command analogous to \glsentrytext - <br />  {\Glsentrying}% command analogous to \Glsentrytext - <br />  {\glsing}% command analogous to \glstext - <br />  {\Glsing}% command analogous to \Glstext - <br />  {\GLSing}% command analogous to \GLStext -</div> -<!--l. 6001--><p class="nopar" > Now I can define some entries: - - -</p> - <div class="verbatim" id="verbatim-145"> + \glsaddkey* +  {ed}% key +  {\glsentrytext{\glslabel}ed}% default value +  {\glsentryed}% command analogous to \glsentrytext +  {\Glsentryed}% command analogous to \Glsentrytext +  {\glsed}% command analogous to \glstext +  {\Glsed}% command analogous to \Glstext +  {\GLSed}% command analogous to \GLStext + % Define "ing" key: + \glsaddkey* +  {ing}% key +  {\glsentrytext{\glslabel}ing}% default value +  {\glsentrying}% command analogous to \glsentrytext +  {\Glsentrying}% command analogous to \Glsentrytext +  {\glsing}% command analogous to \glstext +  {\Glsing}% command analogous to \Glstext +  {\GLSing}% command analogous to \GLStext +</pre> +<!--l. 6206--><p class="nopar" > Now I can define some entries: + + +</p> + <pre class="verbatim" id="verbatim-151">  % No need to override defaults for this entry: - <br /> \newglossaryentry{jump}{name={jump},description={}} - <br /> % Need to override defaults on these entries: - <br /> \newglossaryentry{run}{name={run},% - <br />   ed={ran},% - <br />   ing={running},% - <br />   description={}} - <br /> \newglossaryentry{waddle}{name={waddle},% - <br />   ed={waddled},% - <br />   ing={waddling},% - <br />   description={}} -</div> -<!--l. 6019--><p class="nopar" > -</p><!--l. 6021--><p class="indent" > These entries can later be used in the document: - - -</p> - <div class="verbatim" id="verbatim-146"> + \newglossaryentry{jump}{name={jump},description={}} + % Need to override defaults on these entries: + \newglossaryentry{run}{name={run},% +   ed={ran},% +   ing={running},% +   description={}} + \newglossaryentry{waddle}{name={waddle},% +   ed={waddled},% +   ing={waddling},% +   description={}} +</pre> +<!--l. 6224--><p class="nopar" > +</p><!--l. 6226--><p class="indent" > These entries can later be used in the document: + + +</p> + <pre class="verbatim" id="verbatim-152"> The dog \glsed{jump} over the duck. - <br />The duck was \glsing{waddle} round the dog. - <br />The dog \glsed{run} away from the duck. -</div> -<!--l. 6028--><p class="nopar" > For a complete document, see the sample file <a +The duck was \glsing{waddle} round the dog. +The dog \glsed{run} away from the duck. +</pre> +<!--l. 6233--><p class="nopar" > For a complete document, see the sample file <a href="#ex:sample-newkeys"><span class="cmtt-10">sample-newkeys.tex</span></a>. </p> <div class="center" > -<!--l. 6030--><p class="noindent" > -</p><!--l. 6030--><p class="noindent" >____________________________</p></div> -<!--l. 6032--><p class="noindent" > +<!--l. 6235--><p class="noindent" > +</p><!--l. 6235--><p class="noindent" >____________________________</p></div> +<!--l. 6237--><p class="noindent" > </p> -<!--l. 6032--><p class="noindent" ><a +<!--l. 6237--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.3.2 </span> <a id="sec:glsaddstoragekey"></a>Storage Keys</h4> -<!--l. 6035--><p class="noindent" >A custom key that can be used for simply storing information is defined using: -</p><!--l. 6037--><p class="indent" > <hr><div title="Definition"><a - id="dx1-117001"></a> <span +<!--l. 6240--><p class="noindent" >A custom key that can be used for simply storing information is defined using: +</p><!--l. 6242--><p class="indent" > <hr><div title="Definition"><a + id="dx1-118001"></a> <span class="cmtt-10">\glsaddstoragekey{</span>⟨<span class="cmitt-10">key</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -13108,31 +13783,33 @@ class="cmitt-10">default value</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">no link cs</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 6039--><p class="noindent" > +</p><!--l. 6244--><p class="noindent" > where the arguments are as the first three arguments of <span class="cmtt-10">\glsaddkey</span>, described above in <a -href="#sec:glsaddkey">§4.3.1 </a><a -href="#sec:glsaddkey">Document -Keys<!--tex4ht:ref: sec:glsaddkey --></a>. -</p><!--l. 6043--><p class="indent" > This is essentially the same as <span +href="#sec:glsaddkey">§<span +class="cmbx-10">??</span>sec:glsaddkey +</a><a +href="#sec:glsaddkey">Document Keys<!--tex4ht:ref: sec:glsaddkey --></a>. +</p><!--l. 6248--><p class="indent" > This is essentially the same as <span class="cmtt-10">\glsaddkey </span>except that it doesn’t define the additional commands. You can access or update the value of your new field using the commands described in <a -href="#sec:fetchset">§16.3 </a><a -href="#sec:fetchset">Fetching and Updating the -Value of a Field<!--tex4ht:ref: sec:fetchset --></a>. +href="#sec:fetchset">§<span +class="cmbx-10">??</span>sec:fetchset </a><a +href="#sec:fetchset">Fetching and +Updating the Value of a Field<!--tex4ht:ref: sec:fetchset --></a>. <a id="ex:addstoragekey"></a> -</p><!--l. 6048--><p class="noindent" ><span +</p><!--l. 6253--><p class="noindent" ><span class="cmbx-12">Example 4</span><span class="cmbx-12"> (Defining Custom Storage Key (Acronyms and Initialisms))</span><a - id="x1-117003"></a> -</p><!--l. 6049--><p class="indent" > Suppose I want to define acronyms and other forms of abbreviations, such as initialisms, but I want them all + id="x1-118003"></a> +</p><!--l. 6254--><p class="indent" > Suppose I want to define acronyms and other forms of abbreviations, such as initialisms, but I want them all in the same glossary and I want the acronyms on first use to be displayed with the short form followed by the long form in parentheses, but the opposite way round for other forms of abbreviations. (The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides a simpler way of achieving this.) -</p><!--l. 6056--><p class="indent" > Here I can define a new key that determines whether the term is actually an acronym rather +</p><!--l. 6261--><p class="indent" > Here I can define a new key that determines whether the term is actually an acronym rather than some other form of abbreviation. I’m going to call this key <span class="cmtt-10">abbrtype </span>(since <span class="cmtt-10">type </span>already @@ -13140,138 +13817,138 @@ exists): </p> - <div class="verbatim" id="verbatim-147"> + <pre class="verbatim" id="verbatim-153"> \glsaddstoragekey - <br /> {abbrtype}% key/field name - <br /> {word}% default value if not explicitly set - <br /> {\abbrtype}% custom command to access the value if required -</div> -<!--l. 6065--><p class="nopar" > -</p><!--l. 6067--><p class="indent" > Now I can define a style that looks up the value of this new key to determine how to display the full + {abbrtype}% key/field name + {word}% default value if not explicitly set + {\abbrtype}% custom command to access the value if required +</pre> +<!--l. 6270--><p class="nopar" > +</p><!--l. 6272--><p class="indent" > Now I can define a style that looks up the value of this new key to determine how to display the full form: </p> - <div class="verbatim" id="verbatim-148"> + <pre class="verbatim" id="verbatim-154"> \newacronymstyle - <br /> {mystyle}% style name - <br /> {% Use the generic display - <br />   \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% - <br /> } - <br /> {% Put the long form in the description - <br />   \renewcommand*{\GenericAcronymFields}{% - <br />       description={\the\glslongtok}}% - <br />   % For the full format, test the value of the "abbrtype" key. - <br />   % If it's set to "word" put the short form first with - <br />   % the long form in brackets. - <br />   \renewcommand*{\genacrfullformat}[2]{% - <br />    \ifglsfieldeq{##1}{abbrtype}{word} - <br />    {% is a proper acronym - <br />      \protect\firstacronymfont{\glsentryshort{##1}}##2\space - <br />       (\glsentrylong{##1})% - <br />    } - <br />    {% is another form of abbreviation - <br />     \glsentrylong{##1}##2\space - <br />      (\protect\firstacronymfont{\glsentryshort{##1}})% - <br />    }% - <br />  }% - <br />  % first letter upper case version: - <br />   \renewcommand*{\Genacrfullformat}[2]{% - <br />    \ifglsfieldeq{##1}{abbrtype}{word} - <br />    {% is a proper acronym - <br />      \protect\firstacronymfont{\Glsentryshort{##1}}##2\space - <br />       (\glsentrylong{##1})% - <br />    } - <br />    {% is another form of abbreviation - <br />     \Glsentrylong{##1}##2\space - <br />      (\protect\firstacronymfont{\glsentryshort{##1}})% - <br />    }% - <br />  }% - <br />  % plural - <br />   \renewcommand*{\genplacrfullformat}[2]{% - <br />    \ifglsfieldeq{##1}{abbrtype}{word} - <br />    {% is a proper acronym - <br />      \protect\firstacronymfont{\glsentryshortpl{##1}}##2\space - <br />       (\glsentrylong{##1})% - <br />    } - <br />    {% is another form of abbreviation - <br />     \glsentrylongpl{##1}##2\space - <br />      (\protect\firstacronymfont{\glsentryshortpl{##1}})% - <br />    }% - <br />  }% - - - <br />  % plural and first letter upper case - <br />  \renewcommand*{\Genplacrfullformat}[2]{% - <br />    \ifglsfieldeq{##1}{abbrtype}{word} - <br />    {% is a proper acronym - <br />      \protect\firstacronymfont{\Glsentryshortpl{##1}}##2\space - <br />       (\glsentrylong{##1})% - <br />    } - <br />    {% is another form of abbreviation - <br />     \Glsentrylongpl{##1}##2\space - <br />      (\protect\firstacronymfont{\glsentryshortpl{##1}})% - <br />    }% - <br />  }% - <br />  % Just use the short form as the name part in the glossary: - <br />  \renewcommand*{\acronymentry}[1]{% - <br />     \acronymfont{\glsentryshort{##1}}}% - <br />  % Sort by the short form: - <br />  \renewcommand*{\acronymsort}[2]{##1}% - <br />  % Just use the surrounding font for the short form: - <br />  \renewcommand*{\acronymfont}[1]{##1}% - <br />  % Same for first use: - <br />  \renewcommand*{\firstacronymfont}[1]{\acronymfont{##1}}% - <br />  % Default plural suffix if the plural isn't explicitly set - <br />  \renewcommand*{\acrpluralsuffix}{\glspluralsuffix}% - <br /> } -</div> -<!--l. 6140--><p class="nopar" > Remember that the new style needs to be set before defining any terms: - - -</p> - <div class="verbatim" id="verbatim-149"> + {mystyle}% style name + {% Use the generic display +   \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% + } + {% Put the long form in the description +   \renewcommand*{\GenericAcronymFields}{% +       description={\the\glslongtok}}% +   % For the full format, test the value of the "abbrtype" key. +   % If it's set to "word" put the short form first with +   % the long form in brackets. +   \renewcommand*{\genacrfullformat}[2]{% +    \ifglsfieldeq{##1}{abbrtype}{word} +    {% is a proper acronym +      \protect\firstacronymfont{\glsentryshort{##1}}##2\space +       (\glsentrylong{##1})% +    } +    {% is another form of abbreviation +     \glsentrylong{##1}##2\space +      (\protect\firstacronymfont{\glsentryshort{##1}})% +    }% +  }% +  % first letter upper case version: +   \renewcommand*{\Genacrfullformat}[2]{% +    \ifglsfieldeq{##1}{abbrtype}{word} +    {% is a proper acronym +      \protect\firstacronymfont{\Glsentryshort{##1}}##2\space +       (\glsentrylong{##1})% +    } +    {% is another form of abbreviation +     \Glsentrylong{##1}##2\space +      (\protect\firstacronymfont{\glsentryshort{##1}})% +    }% +  }% +  % plural +   \renewcommand*{\genplacrfullformat}[2]{% +    \ifglsfieldeq{##1}{abbrtype}{word} +    {% is a proper acronym +      \protect\firstacronymfont{\glsentryshortpl{##1}}##2\space +       (\glsentrylong{##1})% +    } +    {% is another form of abbreviation +     \glsentrylongpl{##1}##2\space +      (\protect\firstacronymfont{\glsentryshortpl{##1}})% +    }% +  }% + + +  % plural and first letter upper case +  \renewcommand*{\Genplacrfullformat}[2]{% +    \ifglsfieldeq{##1}{abbrtype}{word} +    {% is a proper acronym +      \protect\firstacronymfont{\Glsentryshortpl{##1}}##2\space +       (\glsentrylong{##1})% +    } +    {% is another form of abbreviation +     \Glsentrylongpl{##1}##2\space +      (\protect\firstacronymfont{\glsentryshortpl{##1}})% +    }% +  }% +  % Just use the short form as the name part in the glossary: +  \renewcommand*{\acronymentry}[1]{% +     \acronymfont{\glsentryshort{##1}}}% +  % Sort by the short form: +  \renewcommand*{\acronymsort}[2]{##1}% +  % Just use the surrounding font for the short form: +  \renewcommand*{\acronymfont}[1]{##1}% +  % Same for first use: +  \renewcommand*{\firstacronymfont}[1]{\acronymfont{##1}}% +  % Default plural suffix if the plural isn't explicitly set +  \renewcommand*{\acrpluralsuffix}{\glspluralsuffix}% + } +</pre> +<!--l. 6345--><p class="nopar" > Remember that the new style needs to be set before defining any terms: + + +</p> + <pre class="verbatim" id="verbatim-155"> \setacronymstyle{mystyle} -</div> -<!--l. 6145--><p class="nopar" > -</p><!--l. 6147--><p class="indent" > Since it’s a bit confusing to use <span +</pre> +<!--l. 6350--><p class="nopar" > +</p><!--l. 6352--><p class="indent" > Since it’s a bit confusing to use <span class="cmtt-10">\newacronym</span><a - id="dx1-117004"></a> for something that’s not technically an acronym, let’s define a + id="dx1-118004"></a> for something that’s not technically an acronym, let’s define a new command for initialisms: </p> - <div class="verbatim" id="verbatim-150"> + <pre class="verbatim" id="verbatim-156"> \newcommand*{\newinitialism}[4][]{% - <br />  \newacronym[abbrtype=initialism,#1]{#2}{#3}{#4}% - <br />} -</div> -<!--l. 6154--><p class="nopar" > Now the entries can all be defined: +  \newacronym[abbrtype=initialism,#1]{#2}{#3}{#4}% +} +</pre> +<!--l. 6359--><p class="nopar" > Now the entries can all be defined: </p> - <div class="verbatim" id="verbatim-151"> + <pre class="verbatim" id="verbatim-157"> \newacronym{radar}{radar}{radio detecting and ranging} - <br />\newacronym{laser}{laser}{light amplification by stimulated - <br />emission of radiation} - <br />\newacronym{scuba}{scuba}{self-contained underwater breathing - <br />apparatus} - <br />\newinitialism{dsp}{DSP}{digital signal processing} - <br />\newinitialism{atm}{ATM}{automated teller machine} -</div> -<!--l. 6164--><p class="nopar" > On <a +\newacronym{laser}{laser}{light amplification by stimulated +emission of radiation} +\newacronym{scuba}{scuba}{self-contained underwater breathing +apparatus} +\newinitialism{dsp}{DSP}{digital signal processing} +\newinitialism{atm}{ATM}{automated teller machine} +</pre> +<!--l. 6369--><p class="nopar" > On <a href="#glo:firstuse">first use</a>, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{radar}</span></span></span> will produce “radar (radio detecting and ranging)” but <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{dsp}</span></span></span> will produce “DSP (digital signal processing)”. -</p><!--l. 6169--><p class="indent" > For a complete document, see the sample file <a +</p><!--l. 6374--><p class="indent" > For a complete document, see the sample file <a href="#ex:sample-storage-abbr"><span class="cmtt-10">sample-storage-abbr.tex</span></a>. </p> <div class="center" > -<!--l. 6171--><p class="noindent" > -</p><!--l. 6171--><p class="noindent" >____________________________</p></div> -<!--l. 6173--><p class="indent" > In the above example, if <span +<!--l. 6376--><p class="noindent" > +</p><!--l. 6376--><p class="noindent" >____________________________</p></div> +<!--l. 6378--><p class="indent" > In the above example, if <span class="cmtt-10">\newglossaryentry </span>is explicitly used (instead of through <span class="cmtt-10">\newacronym</span>) the <span @@ -13279,235 +13956,244 @@ class="cmtt-10">abbrtype </span>key will be set to its default value of “w class="cmtt-10">\ifglshaslong </span>test in the custom acronym style will be false (since the <span class="cmtt-10">long</span><a - id="dx1-117005"></a> key hasn’t been set) so the display style will switch to that given by + id="dx1-118005"></a> key hasn’t been set) so the display style will switch to that given by <span class="cmtt-10">\glsgenentryfmt </span>and they’ll be no test performed on the <span class="cmtt-10">abbrtype </span>field. <a id="ex:addstoragekey2"></a> -</p><!--l. 6182--><p class="noindent" ><span +</p><!--l. 6387--><p class="noindent" ><span class="cmbx-12">Example 5</span><span class="cmbx-12"> (Defining Custom Storage Key (Acronyms and Non-Acronyms with</span> <span class="cmbx-12">Descriptions))</span><a - id="x1-117007"></a> -</p><!--l. 6183--><p class="indent" > The previous example can be modified if the <span + id="x1-118007"></a> +</p><!--l. 6388--><p class="indent" > The previous example can be modified if the <span class="cmtt-10">description</span><a - id="dx1-117008"></a> also needs to be provided. Here I’ve changed + id="dx1-118008"></a> also needs to be provided. Here I’ve changed “word” to “acronym”: </p> - <div class="verbatim" id="verbatim-152"> + <pre class="verbatim" id="verbatim-158"> \glsaddstoragekey - <br /> {abbrtype}% key/field name - <br /> {acronym}% default value if not explicitly set - <br /> {\abbrtype}% custom command to access the value if required -</div> -<!--l. 6191--><p class="nopar" > This may seem a little odd for non-abbreviated entries defined using <span + {abbrtype}% key/field name + {acronym}% default value if not explicitly set + {\abbrtype}% custom command to access the value if required +</pre> +<!--l. 6396--><p class="nopar" > This may seem a little odd for non-abbreviated entries defined using <span class="cmtt-10">\newglossaryentry </span>directly, but <span class="cmtt-10">\ifglshaslong</span><a - id="dx1-117009"></a> can be used to determine whether or not to reference the value of this new <span + id="dx1-118009"></a> can be used to determine whether or not to reference the value of this new <span class="cmtt-10">abbrtype</span> field. -</p><!--l. 6197--><p class="indent" > The new acronym style has a minor modification that forces the user to specify a description. In the +</p><!--l. 6402--><p class="indent" > The new acronym style has a minor modification that forces the user to specify a description. In the previous example, the line: </p> - <div class="verbatim" id="verbatim-153"> + <pre class="verbatim" id="verbatim-159">    \renewcommand*{\GenericAcronymFields}{% - <br />     description={\the\glslongtok}}% -</div> -<!--l. 6202--><p class="nopar" > needs to be changed to: +     description={\the\glslongtok}}% +</pre> +<!--l. 6407--><p class="nopar" > needs to be changed to: </p> - <div class="verbatim" id="verbatim-154"> + <pre class="verbatim" id="verbatim-160">    \renewcommand*{\GenericAcronymFields}{}% -</div> -<!--l. 6206--><p class="nopar" > Additionally, to accommodate the change in the default value of the <span +</pre> +<!--l. 6411--><p class="nopar" > Additionally, to accommodate the change in the default value of the <span class="cmtt-10">abbrtype </span>key, all instances of </p> - <div class="verbatim" id="verbatim-155"> + <pre class="verbatim" id="verbatim-161">     \ifglsfieldeq{##1}{abbrtype}{word} -</div> -<!--l. 6211--><p class="nopar" > need to be changed to: +</pre> +<!--l. 6416--><p class="nopar" > need to be changed to: </p> - <div class="verbatim" id="verbatim-156"> + <pre class="verbatim" id="verbatim-162">     \ifglsfieldeq{##1}{abbrtype}{acronym} -</div> -<!--l. 6215--><p class="nopar" > -</p><!--l. 6217--><p class="indent" > Once this new style has been set, the new acronyms can be defined using the optional argument to set the +</pre> +<!--l. 6420--><p class="nopar" > +</p><!--l. 6422--><p class="indent" > Once this new style has been set, the new acronyms can be defined using the optional argument to set the description: </p> - <div class="verbatim" id="verbatim-157"> + <pre class="verbatim" id="verbatim-163"> \newacronym[description={system for detecting the position and - <br />speed of aircraft, ships, etc}]{radar}{radar}{radio detecting - <br />and ranging} -</div> -<!--l. 6223--><p class="nopar" > -</p><!--l. 6225--><p class="indent" > No change is required for the definition of <span +speed of aircraft, ships, etc}]{radar}{radar}{radio detecting +and ranging} +</pre> +<!--l. 6428--><p class="nopar" > +</p><!--l. 6430--><p class="indent" > No change is required for the definition of <span class="cmtt-10">\newinitialism </span>but again the optional argument is required to set the description: </p> - <div class="verbatim" id="verbatim-158"> + <pre class="verbatim" id="verbatim-164"> \newinitialism[description={mathematical manipulation of an - <br />information signal}]{dsp}{DSP}{digital signal processing} -</div> -<!--l. 6230--><p class="nopar" > -</p><!--l. 6232--><p class="indent" > We can also accommodate contractions in a similar manner to the initialisms: +information signal}]{dsp}{DSP}{digital signal processing} +</pre> +<!--l. 6435--><p class="nopar" > +</p><!--l. 6437--><p class="indent" > We can also accommodate contractions in a similar manner to the initialisms: </p> - <div class="verbatim" id="verbatim-159"> + <pre class="verbatim" id="verbatim-165"> \newcommand*{\newcontraction}[4][]{% - <br />  \newacronym[abbrtype=contraction,#1]{#2}{#3}{#4}% - <br />} -</div> -<!--l. 6238--><p class="nopar" > The contractions can similarly been defined using this new command: +  \newacronym[abbrtype=contraction,#1]{#2}{#3}{#4}% +} +</pre> +<!--l. 6443--><p class="nopar" > The contractions can similarly been defined using this new command: </p> - <div class="verbatim" id="verbatim-160"> + <pre class="verbatim" id="verbatim-166"> \newcontraction[description={front part of a ship below the - <br />deck}]{focsle}{fo'c's'le}{forecastle} -</div> -<!--l. 6243--><p class="nopar" > -</p><!--l. 6245--><p class="indent" > Since the custom acronym style just checks if <span +deck}]{focsle}{fo'c's'le}{forecastle} +</pre> +<!--l. 6448--><p class="nopar" > +</p><!--l. 6450--><p class="indent" > Since the custom acronym style just checks if <span class="cmtt-10">abbrtype </span>is <span class="cmtt-10">acronym</span>, the contractions will be treated the same as the initialisms, but the style could be modified by a further test of the <span class="cmtt-10">abbrtype </span>value if required. -</p><!--l. 6250--><p class="indent" > To test regular non-abbreviated entries, I’ve also defined a simple word: +</p><!--l. 6455--><p class="indent" > To test regular non-abbreviated entries, I’ve also defined a simple word: </p> - <div class="verbatim" id="verbatim-161"> + <pre class="verbatim" id="verbatim-167"> \newglossaryentry{apple}{name={apple},description={a fruit}} -</div> -<!--l. 6254--><p class="nopar" > -</p><!--l. 6256--><p class="indent" > Now for a new glossary style that provides information about the abbreviation (in addition to the +</pre> +<!--l. 6459--><p class="nopar" > +</p><!--l. 6461--><p class="indent" > Now for a new glossary style that provides information about the abbreviation (in addition to the description): </p> - <div class="verbatim" id="verbatim-162"> + <pre class="verbatim" id="verbatim-168"> \newglossarystyle - <br /> {mystyle}% style name - <br /> {% base it on the "list" style - <br />   \setglossarystyle{list}% - <br />   \renewcommand*{\glossentry}[2]{% - <br />     \item[\glsentryitem{##1}% - <br />          \glstarget{##1}{\glossentryname{##1}}] - <br />       \ifglshaslong{##1}% - <br />       { (\abbrtype{##1}: \glsentrylong{##1})\space}{}% - <br />       \glossentrydesc{##1}\glspostdescription\space ##2}% - <br /> } -</div> -<!--l. 6270--><p class="nopar" > This uses <span + {mystyle}% style name + {% base it on the "list" style +   \setglossarystyle{list}% +   \renewcommand*{\glossentry}[2]{% +     \item[\glsentryitem{##1}% +          \glstarget{##1}{\glossentryname{##1}}] +       \ifglshaslong{##1}% +       { (\abbrtype{##1}: \glsentrylong{##1})\space}{}% +       \glossentrydesc{##1}\glspostdescription\space ##2}% + } +</pre> +<!--l. 6475--><p class="nopar" > This uses <span class="cmtt-10">\ifglshaslong</span><a - id="dx1-117010"></a> to determine whether or not the term is an abbreviation. If it has an abbreviation, + id="dx1-118010"></a> to determine whether or not the term is an abbreviation. If it has an abbreviation, the full form is supplied in parentheses and <span class="cmtt-10">\abbrtype </span>(defined by <span class="cmtt-10">\glsaddstoragekey </span>earlier) is used to indicate the type of abbreviation. -</p><!--l. 6277--><p class="indent" > With this style set, the <span +</p><!--l. 6482--><p class="indent" > With this style set, the <span class="cmtt-10">apple </span>entry is simply displayed in the glossary as </p><dl class="description"><dt class="description"> + <!--l. 6485--><p class="noindent" > <span -class="cmbx-10">apple</span> </dt><dd -class="description">a fruit.</dd></dl> -<!--l. 6282--><p class="noindent" >but the abbreviations are displayed in the form +class="cmbx-10">apple</span> </p></dt><dd +class="description"> + <!--l. 6485--><p class="noindent" >a fruit.</p></dd></dl> +<!--l. 6487--><p class="noindent" >but the abbreviations are displayed in the form </p><dl class="description"><dt class="description"> + <!--l. 6489--><p class="noindent" > <span -class="cmbx-10">laser</span> </dt><dd -class="description">(acronym: light amplification by stimulated emission of radiation) device that creates a narrow - beam of intense light.</dd></dl> -<!--l. 6288--><p class="noindent" >(for acronyms) or +class="cmbx-10">laser</span> </p></dt><dd +class="description"> + <!--l. 6489--><p class="noindent" >(acronym: light amplification by stimulated emission of radiation) device that creates a narrow + beam of intense light.</p></dd></dl> +<!--l. 6493--><p class="noindent" >(for acronyms) or </p><dl class="description"><dt class="description"> + <!--l. 6495--><p class="noindent" > <span -class="cmbx-10">DSP</span> </dt><dd -class="description">(initialism: digital signal processing) mathematical manipulation of an information signal.</dd></dl> -<!--l. 6293--><p class="noindent" >(for initalisms) or +class="cmbx-10">DSP</span> </p></dt><dd +class="description"> + <!--l. 6495--><p class="noindent" >(initialism: digital signal processing) mathematical manipulation of an information signal.</p></dd></dl> +<!--l. 6498--><p class="noindent" >(for initalisms) or </p><dl class="description"><dt class="description"> + <!--l. 6500--><p class="noindent" > <span -class="cmbx-10">fo’c’s’le</span> </dt><dd -class="description">(contraction: forecastle) front part of a ship below the deck.</dd></dl> -<!--l. 6298--><p class="noindent" >(for contractions). -</p><!--l. 6300--><p class="indent" > For a complete document, see <a +class="cmbx-10">fo’c’s’le</span> </p></dt><dd +class="description"> + <!--l. 6500--><p class="noindent" >(contraction: forecastle) front part of a ship below the deck.</p></dd></dl> + + +<!--l. 6503--><p class="noindent" >(for contractions). +</p><!--l. 6505--><p class="indent" > For a complete document, see <a href="#ex:sample-storage-abbr-desc"><span class="cmtt-10">sample-storage-abbr-desc.tex</span></a>. </p> <div class="center" > -<!--l. 6301--><p class="noindent" > -</p><!--l. 6301--><p class="noindent" >____________________________</p></div> - - -<!--l. 6303--><p class="noindent" > +<!--l. 6506--><p class="noindent" > +</p><!--l. 6506--><p class="noindent" >____________________________</p></div> +<!--l. 6508--><p class="noindent" > </p> -<!--l. 6303--><p class="noindent" ><a +<!--l. 6508--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.4 </span> <a id="sec:expansion"></a>Expansion</h3> -<!--l. 6306--><p class="noindent" >When you define new glossary entries expansion is performed by default, except for the <span +<!--l. 6511--><p class="noindent" >When you define new glossary entries expansion is performed by default, except for the <span class="cmtt-10">name</span><a - id="dx1-118001"></a>, <span + id="dx1-119001"></a>, <span class="cmtt-10">description</span><a - id="dx1-118002"></a>, + id="dx1-119002"></a>, <span class="cmtt-10">descriptionplural</span><a - id="dx1-118003"></a>, <span + id="dx1-119003"></a>, <span class="cmtt-10">symbol</span><a - id="dx1-118004"></a>, <span + id="dx1-119004"></a>, <span class="cmtt-10">symbolplural</span><a - id="dx1-118005"></a> and <span + id="dx1-119005"></a> and <span class="cmtt-10">sort</span><a - id="dx1-118006"></a> keys (these keys all have expansion suppressed via + id="dx1-119006"></a> keys (these keys all have expansion suppressed via <span class="cmtt-10">\glssetnoexpandfield</span>). -</p><!--l. 6312--><p class="indent" > You can switch expansion on or off for individual keys using -</p><!--l. 6313--><p class="indent" > <hr><div title="Definition"><a - id="dx1-118007"></a> <span +</p><!--l. 6517--><p class="indent" > You can switch expansion on or off for individual keys using +</p><!--l. 6518--><p class="indent" > <hr><div title="Definition"><a + id="dx1-119007"></a> <span class="cmtt-10">\glssetexpandfield{</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 6315--><p class="noindent" > +</p><!--l. 6520--><p class="noindent" > or -</p><!--l. 6317--><p class="indent" > <hr><div title="Definition"><a - id="dx1-118008"></a> <span +</p><!--l. 6522--><p class="indent" > <hr><div title="Definition"><a + id="dx1-119008"></a> <span class="cmtt-10">\glssetnoexpandfield{</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 6319--><p class="noindent" > +</p><!--l. 6524--><p class="noindent" > respectively, where ⟨<span class="cmti-10">field</span>⟩ is the field tag corresponding to the key. In most cases, this is the same as the name of the key except for those listed in <a -href="#tab:fieldmap">table 4.1</a>. +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>. </p> <div class="table"> -<!--l. 6324--><p class="indent" > <a +<!--l. 6529--><p class="indent" > <a id="tab:fieldmap"></a></p><hr class="float" /><div class="float" > <div class="caption" ><span class="id">Table 4.1: </span><span -class="content">Key to Field Mappings</span></div><!--tex4ht:label?: x1-1180091 --> +class="content">Key to Field Mappings</span></div><!--tex4ht:label?: x1-1190091 --> <div class="tabular"> <table id="TBL-5" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-5-1g"><col id="TBL-5-1" /><col id="TBL-5-2" /></colgroup><tr @@ -13520,83 +14206,83 @@ class="cmbx-10">Field </span></td> style="vertical-align:baseline;" id="TBL-5-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-1" class="td11"> <span class="cmtt-10">sort</span><a - id="dx1-118010"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-2" + id="dx1-119010"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-2" class="td11"> <span class="cmtt-10">sortvalue </span></td></tr><tr style="vertical-align:baseline;" id="TBL-5-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-1" class="td11"> <span class="cmtt-10">firstplural</span><a - id="dx1-118011"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-2" + id="dx1-119011"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-2" class="td11"> <span class="cmtt-10">firstpl</span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-1" class="td11"> <span class="cmtt-10">description</span><a - id="dx1-118012"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-2" + id="dx1-119012"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-2" class="td11"> <span class="cmtt-10">desc </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-1" class="td11"> <span class="cmtt-10">descriptionplural</span><a - id="dx1-118013"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-2" + id="dx1-119013"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-2" class="td11"> <span class="cmtt-10">descplural </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-1" class="td11"> <span class="cmtt-10">user1</span><a - id="dx1-118014"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-2" + id="dx1-119014"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-2" class="td11"> <span class="cmtt-10">useri </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-1" class="td11"> <span class="cmtt-10">user2</span><a - id="dx1-118015"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-2" + id="dx1-119015"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-2" class="td11"> <span class="cmtt-10">userii </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-1" class="td11"> <span class="cmtt-10">user3</span><a - id="dx1-118016"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-2" + id="dx1-119016"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-2" class="td11"> <span class="cmtt-10">useriii </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-1" class="td11"> <span class="cmtt-10">user4</span><a - id="dx1-118017"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-2" + id="dx1-119017"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-2" class="td11"> <span class="cmtt-10">useriv </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-1" class="td11"> <span class="cmtt-10">user5</span><a - id="dx1-118018"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-2" + id="dx1-119018"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-2" class="td11"> <span class="cmtt-10">userv </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-1" class="td11"> <span class="cmtt-10">user6</span><a - id="dx1-118019"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-2" + id="dx1-119019"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-2" class="td11"> <span class="cmtt-10">uservi </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-1" class="td11"> <span class="cmtt-10">longplural</span><a - id="dx1-118020"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-2" + id="dx1-119020"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-2" class="td11"> <span class="cmtt-10">longpl </span></td> </tr><tr style="vertical-align:baseline;" id="TBL-5-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-1" class="td11"> <span class="cmtt-10">shortplural</span><a - id="dx1-118021"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-2" + id="dx1-119021"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-2" class="td11"> <span class="cmtt-10">shortpl </span></td></tr></table> </div> @@ -13604,279 +14290,284 @@ class="cmtt-10">shortpl </span></td></tr></table> </div><hr class="endfloat" /> </div> -<!--l. 6345--><p class="indent" > Any keys that haven’t had the expansion explicitly set using <span +<!--l. 6550--><p class="indent" > Any keys that haven’t had the expansion explicitly set using <span class="cmtt-10">\glssetexpandfield </span>or <span class="cmtt-10">\glssetnoexpandfield</span> are governed by -</p><!--l. 6347--><p class="indent" > <hr><div title="Definition"><a - id="dx1-118022"></a> <span +</p><!--l. 6552--><p class="indent" > <hr><div title="Definition"><a + id="dx1-119022"></a> <span class="cmtt-10">\glsexpandfields </span></div><hr> -</p><!--l. 6349--><p class="noindent" > +</p><!--l. 6554--><p class="noindent" > and -</p><!--l. 6351--><p class="indent" > <hr><div title="Definition"><a - id="dx1-118023"></a> <span +</p><!--l. 6556--><p class="indent" > <hr><div title="Definition"><a + id="dx1-119023"></a> <span class="cmtt-10">\glsnoexpandfields </span></div><hr> -</p><!--l. 6353--><p class="noindent" > -</p><!--l. 6355--><p class="indent" > If your entries contain any fragile commands, I recommend you switch off expansion via <span +</p><!--l. 6558--><p class="noindent" > +</p><!--l. 6560--><p class="indent" > If your entries contain any fragile commands, I recommend you switch off expansion via <span class="cmtt-10">\glsnoexpandfields</span>. (This should be used before you define the entries.) </p> -<!--l. 6359--><p class="noindent" ><a +<!--l. 6564--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.5 </span> <a id="sec:subentries"></a>Sub-Entries</h3> -<!--l. 6362--><p class="noindent" >As from version 1.17, it is possible to specify sub-entries. These may be used to order the glossary into +<!--l. 6567--><p class="noindent" >As from version 1.17, it is possible to specify sub-entries. These may be used to order the glossary into categories, in which case the sub-entry will have a different name to its parent entry, or it may be used to distinguish different definitions for the same word, in which case the sub-entries will have the same name as the parent entry. Note that not all glossary styles support hierarchical entries and may display all the entries in a flat format. Of the styles that support sub-entries, some display the sub-entry’s name whilst others don’t. Therefore you need to ensure that you use a suitable style. (See <a -href="#sec:styles">§15 </a><a -href="#sec:styles">Glossary Styles<!--tex4ht:ref: sec:styles --></a> for a list of predefined -styles.) As from version 3.0, level 1 sub-entries are automatically numbered in the predefined styles -if you use the <span +href="#sec:styles">§<span +class="cmbx-10">??</span>sec:styles </a><a +href="#sec:styles">Glossary Styles<!--tex4ht:ref: sec:styles --></a> for a list of +predefined styles.) As from version 3.0, level 1 sub-entries are automatically numbered in the predefined styles if +you use the <span class="cmss-10">subentrycounter</span><a - id="dx1-119001"></a> package option (see <a -href="#sec:pkgopts-printglos">§2.3 </a><a -href="#sec:pkgopts-printglos">Glossary Appearance Options<!--tex4ht:ref: sec:pkgopts-printglos --></a> for further -details). -</p><!--l. 6377--><p class="indent" > Note that the parent entry will automatically be added to the glossary if any of its child entries are used in + id="dx1-120001"></a> package option (see <a +href="#sec:pkgopts-printglos">§<span +class="cmbx-10">??</span>sec:pkgopts-printglos </a><a +href="#sec:pkgopts-printglos">Glossary Appearance Options<!--tex4ht:ref: sec:pkgopts-printglos --></a> for +further details). +</p><!--l. 6582--><p class="indent" > Note that the parent entry will automatically be added to the glossary if any of its child entries are used in the document. If the parent entry is not referenced in the document, it will not have a <a href="#glo:numberlist">number list<a - id="dx1-119002"></a></a>. Note also + id="dx1-120002"></a></a>. Note also that <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-119003"></a></a> has a restriction on the maximum sub-entry depth. -</p><!--l. 6383--><p class="noindent" > + id="dx1-120003"></a></a> has a restriction on the maximum sub-entry depth. +</p><!--l. 6588--><p class="noindent" > </p> -<!--l. 6383--><p class="noindent" ><a +<!--l. 6588--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.5.1 </span> <a id="sec:hierarchical"></a>Hierarchical Categories</h4> -<!--l. 6386--><p class="noindent" >To arrange a glossary with hierarchical categories, you need to first define the category and then define the +<!--l. 6591--><p class="noindent" >To arrange a glossary with hierarchical categories, you need to first define the category and then define the sub-entries using the relevant category entry as the value of the <span class="cmtt-10">parent</span><a - id="dx1-120001"></a> key. + id="dx1-121001"></a> key. <a id="ex:hierarchical"></a> -</p><!--l. 6391--><p class="noindent" ><span +</p><!--l. 6596--><p class="noindent" ><span class="cmbx-12">Example 6</span><span class="cmbx-12"> (Hierarchical Categories—Greek and Roman Mathematical</span> <span class="cmbx-12">Symbols)</span><a - id="x1-120003"></a> -</p><!--l. 6393--><p class="indent" > Suppose I want a glossary of mathematical symbols that are divided into Greek letters and Roman letters. + id="x1-121003"></a> +</p><!--l. 6598--><p class="indent" > Suppose I want a glossary of mathematical symbols that are divided into Greek letters and Roman letters. Then I can define the categories as follows: </p> - <div class="verbatim" id="verbatim-163"> + <pre class="verbatim" id="verbatim-169"> \newglossaryentry{greekletter}{name={Greek letters}, - <br />description={\nopostdesc}} - <br />\newglossaryentry{romanletter}{name={Roman letters}, - <br />description={\nopostdesc}} -</div> -<!--l. 6402--><p class="nopar" > -</p><!--l. 6404--><p class="indent" > Note that in this example, the category entries don’t need a description so I have set the descriptions to +description={\nopostdesc}} +\newglossaryentry{romanletter}{name={Roman letters}, +description={\nopostdesc}} +</pre> +<!--l. 6607--><p class="nopar" > +</p><!--l. 6609--><p class="indent" > Note that in this example, the category entries don’t need a description so I have set the descriptions to <span class="cmtt-10">\nopostdesc</span><a - id="dx1-120004"></a>. This gives a blank description and suppresses the description terminator. -</p><!--l. 6409--><p class="indent" > I can now define my sub-entries as follows: + id="dx1-121004"></a>. This gives a blank description and suppresses the description terminator. +</p><!--l. 6614--><p class="indent" > I can now define my sub-entries as follows: </p> - <div class="verbatim" id="verbatim-164"> + <pre class="verbatim" id="verbatim-170"> \newglossaryentry{pi}{name={\ensuremath{\pi}},sort={pi}, - <br />description={ratio of the circumference of a circle to - <br />the diameter}, - <br />parent=greekletter} - <br />\newglossaryentry{C}{name={\ensuremath{C}},sort={C}, - <br />description={Euler's constant}, - <br />parent=romanletter} -</div> -<!--l. 6419--><p class="nopar" > For a complete document, see the sample file <a +description={ratio of the circumference of a circle to +the diameter}, +parent=greekletter} +\newglossaryentry{C}{name={\ensuremath{C}},sort={C}, +description={Euler's constant}, +parent=romanletter} +</pre> +<!--l. 6624--><p class="nopar" > For a complete document, see the sample file <a href="#ex:sampletree"><span class="cmtt-10">sampletree.tex</span></a>. </p> <div class="center" > -<!--l. 6421--><p class="noindent" > -</p><!--l. 6421--><p class="noindent" >____________________________</p></div> -<!--l. 6423--><p class="noindent" > +<!--l. 6626--><p class="noindent" > +</p><!--l. 6626--><p class="noindent" >____________________________</p></div> +<!--l. 6628--><p class="noindent" > </p> -<!--l. 6423--><p class="noindent" ><a +<!--l. 6628--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.5.2 </span> <a id="sec:homographs"></a>Homographs</h4> -<!--l. 6426--><p class="noindent" >Sub-entries that have the same name as the parent entry, don’t need to have the <span +<!--l. 6631--><p class="noindent" >Sub-entries that have the same name as the parent entry, don’t need to have the <span class="cmtt-10">name</span><a - id="dx1-121001"></a> key. For example, the + id="dx1-122001"></a> key. For example, the word “glossary” can mean a list of technical words or a collection of glosses. In both cases the plural is “glossaries”. So first define the parent entry: </p> - <div class="verbatim" id="verbatim-165"> + <pre class="verbatim" id="verbatim-171"> \newglossaryentry{glossary}{name=glossary, - <br />description={\nopostdesc}, - <br />plural={glossaries}} -</div> -<!--l. 6435--><p class="nopar" > Again, the parent entry has no description, so the description terminator needs to be suppressed using +description={\nopostdesc}, +plural={glossaries}} +</pre> +<!--l. 6640--><p class="nopar" > Again, the parent entry has no description, so the description terminator needs to be suppressed using <span class="cmtt-10">\nopostdesc</span><a - id="dx1-121002"></a>. -</p><!--l. 6439--><p class="indent" > Now define the two different meanings of the word: + id="dx1-122002"></a>. +</p><!--l. 6644--><p class="indent" > Now define the two different meanings of the word: </p> - <div class="verbatim" id="verbatim-166"> + <pre class="verbatim" id="verbatim-172"> \newglossaryentry{glossarylist}{ - <br />description={list of technical words}, - <br />sort={1}, - <br />parent={glossary}} - <br />\newglossaryentry{glossarycol}{ - <br />description={collection of glosses}, - <br />sort={2}, - <br />parent={glossary}} -</div> -<!--l. 6450--><p class="nopar" > Note that if I reference the parent entry, the location will be added to the parent’s <a +description={list of technical words}, +sort={1}, +parent={glossary}} +\newglossaryentry{glossarycol}{ +description={collection of glosses}, +sort={2}, +parent={glossary}} +</pre> +<!--l. 6655--><p class="nopar" > Note that if I reference the parent entry, the location will be added to the parent’s <a href="#glo:numberlist">number list<a - id="dx1-121003"></a></a>, whereas if I + id="dx1-122003"></a></a>, whereas if I reference any of the child entries, the location will be added to the child entry’s number list. Note also that since the sub-entries have the same name, the <span class="cmtt-10">sort</span><a - id="dx1-121004"></a> key is required unless you are using the <span + id="dx1-122004"></a> key is required unless you are using the <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-121005"></a> or -<span + id="dx1-122005"></a> or <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-121006"></a> package options (see <a -href="#sec:pkgopts-sort">§2.5 </a><a + id="dx1-122006"></a> +package options (see <a +href="#sec:pkgopts-sort">§<span +class="cmbx-10">??</span>sec:pkgopts-sort </a><a href="#sec:pkgopts-sort">Sorting Options<!--tex4ht:ref: sec:pkgopts-sort --></a>). You can use the <span class="cmss-10">subentrycounter</span><a - id="dx1-121007"></a> package option to + id="dx1-122007"></a> package option to automatically number the first-level child entries. See <a -href="#sec:pkgopts-printglos">§2.3 </a><a -href="#sec:pkgopts-printglos">Glossary Appearance Options<!--tex4ht:ref: sec:pkgopts-printglos --></a> for further -details. -</p><!--l. 6462--><p class="indent" > In the above example, the plural form for both of the child entries is the same as the parent entry, so the +href="#sec:pkgopts-printglos">§<span +class="cmbx-10">??</span>sec:pkgopts-printglos </a><a +href="#sec:pkgopts-printglos">Glossary Appearance Options<!--tex4ht:ref: sec:pkgopts-printglos --></a> for +further details. +</p><!--l. 6667--><p class="indent" > In the above example, the plural form for both of the child entries is the same as the parent entry, so the <span class="cmtt-10">plural</span><a - id="dx1-121008"></a> key was not required for the child entries. However, if the sub-entries have different plurals, they will + id="dx1-122008"></a> key was not required for the child entries. However, if the sub-entries have different plurals, they will need to be specified. For example: </p> - <div class="verbatim" id="verbatim-167"> + <pre class="verbatim" id="verbatim-173"> \newglossaryentry{bravo}{name={bravo}, - <br />description={\nopostdesc}} - <br />\newglossaryentry{bravocry}{description={cry of approval - <br />(pl.\ bravos)}, - <br />sort={1}, - <br />plural={bravos}, - <br />parent=bravo} - <br />\newglossaryentry{bravoruffian}{description={hired - <br />ruffian or killer (pl.\ bravoes)}, - <br />sort={2}, - <br />plural={bravoes}, - <br />parent=bravo} -</div> -<!--l. 6481--><p class="nopar" > -</p><!--l. 6484--><p class="noindent" > -</p> -<!--l. 6484--><p class="noindent" ><a +description={\nopostdesc}} +\newglossaryentry{bravocry}{description={cry of approval +(pl.\ bravos)}, +sort={1}, +plural={bravos}, +parent=bravo} +\newglossaryentry{bravoruffian}{description={hired +ruffian or killer (pl.\ bravoes)}, +sort={2}, +plural={bravoes}, +parent=bravo} +</pre> +<!--l. 6686--><p class="nopar" > +</p><!--l. 6689--><p class="noindent" > +</p> +<!--l. 6689--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.6 </span> <a id="sec:loadglsentries"></a>Loading Entries From a File</h3> -<!--l. 6487--><p class="noindent" >You can store all your glossary entry definitions in another file and use: -</p><!--l. 6489--><p class="indent" > <hr><div title="Definition"><a - id="dx1-122001"></a> <span +<!--l. 6692--><p class="noindent" >You can store all your glossary entry definitions in another file and use: +</p><!--l. 6694--><p class="indent" > <hr><div title="Definition"><a + id="dx1-123001"></a> <span class="cmtt-10">\loadglsentries[</span>⟨<span class="cmitt-10">type</span>⟩<span class="cmtt-10">]{</span>⟨<span class="cmitt-10">filename</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 6491--><p class="noindent" > +</p><!--l. 6696--><p class="noindent" > where ⟨<span class="cmti-10">filename</span>⟩ is the name of the file containing all the <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-122002"></a> or <span + id="dx1-123002"></a> or <span class="cmtt-10">\longnewglossaryentry</span><a - id="dx1-122003"></a> + id="dx1-123003"></a> commands. The optional argument ⟨<span class="cmti-10">type</span>⟩ is the name of the glossary to which those entries should belong, for those entries where the <span class="cmtt-10">type</span><a - id="dx1-122004"></a> key has been omitted (or, more specifically, for those entries + id="dx1-123004"></a> key has been omitted (or, more specifically, for those entries whose type has been specified by <span class="cmtt-10">\glsdefaulttype</span><a - id="dx1-122005"></a>, which is what <span + id="dx1-123005"></a>, which is what <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-122006"></a> uses by + id="dx1-123006"></a> uses by default). -</p><!--l. 6501--><p class="indent" > This is a preamble-only command. You may also use <span +</p><!--l. 6706--><p class="indent" > This is a preamble-only command. You may also use <span class="cmtt-10">\input</span><a - id="dx1-122007"></a> to load the file but don’t use <span + id="dx1-123007"></a> to load the file but don’t use <span class="cmtt-10">\include</span><a - id="dx1-122008"></a>. If you + id="dx1-123008"></a>. If you find that your file is becoming unmanageably large, you may want to consider switching to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-122009"></a></a> and use an + id="dx1-123009"></a></a> and use an application such as JabRef to manage the entry definitions. -</p><!--l. 6507--><p class="indent" > <div class="important" title="Important Note"> If you want to use <span +</p><!--l. 6712--><p class="indent" > <div class="important" title="Important Note"> If you want to use <span class="cmtt-10">\AtBeginDocument</span><a - id="dx1-122010"></a> to <span + id="dx1-123010"></a> to <span class="cmtt-10">\input </span>all your entries automatically at the start of the document, add the <span class="cmtt-10">\AtBeginDocument </span>command <span class="cmti-10">before </span>you load the <span class="cmss-10">glossaries</span><a - id="dx1-122011"></a> package (and <span + id="dx1-123011"></a> package (and <span class="cmss-10">babel</span><a - id="dx1-122012"></a>, if you are also loading + id="dx1-123012"></a>, if you are also loading that) to avoid the creation of the <span class="cmtt-10">glsdefs</span><a - id="dx1-122013"></a> file and any associated problems that are caused by defining + id="dx1-123013"></a> file and any associated problems that are caused by defining commands in the <span class="cmss-10">document</span><a - id="dx1-122014"></a><a - id="dx1-122015"></a> environment. (See <a -href="#sec:docdefs">§4.8 </a><a + id="dx1-123014"></a><a + id="dx1-123015"></a> environment. (See <a +href="#sec:docdefs">§<span +class="cmbx-10">??</span>sec:docdefs </a><a href="#sec:docdefs">Drawbacks With Defining Entries in the Document Environment<!--tex4ht:ref: sec:docdefs --></a>.) </div> -</p><!--l. 6516--><p class="noindent" > +</p><!--l. 6721--><p class="noindent" > <a id="ex:loadgls"></a> -</p><!--l. 6518--><p class="noindent" ><span +</p><!--l. 6723--><p class="noindent" ><span class="cmbx-12">Example 7</span><span class="cmbx-12"> (Loading Entries from Another File)</span><a - id="x1-122017"></a> -</p><!--l. 6519--><p class="indent" > Suppose I have a file called <span + id="x1-123017"></a> +</p><!--l. 6724--><p class="indent" > Suppose I have a file called <span class="cmtt-10">myentries.tex </span>which contains: </p> - <div class="verbatim" id="verbatim-168"> + <pre class="verbatim" id="verbatim-174"> \newglossaryentry{perl}{type=main, - <br />name={Perl}, - <br />description={A scripting language}} - <br />\newglossaryentry{tex}{name={\TeX}, - <br />description={A typesetting language},sort={TeX}} - <br />\newglossaryentry{html}{type=\glsdefaulttype, - <br />name={html}, - <br />description={A mark up language}} -</div> -<!--l. 6531--><p class="nopar" > and suppose in my document preamble I use the command: +name={Perl}, +description={A scripting language}} +\newglossaryentry{tex}{name={\TeX}, +description={A typesetting language},sort={TeX}} +\newglossaryentry{html}{type=\glsdefaulttype, +name={html}, +description={A mark up language}} +</pre> +<!--l. 6736--><p class="nopar" > and suppose in my document preamble I use the command: </p> - <div class="verbatim" id="verbatim-169"> + <pre class="verbatim" id="verbatim-175"> \loadglsentries[languages]{myentries} -</div> -<!--l. 6535--><p class="nopar" > then this will add the entries <span +</pre> +<!--l. 6740--><p class="nopar" > then this will add the entries <span class="cmtt-10">tex </span>and <span class="cmtt-10">html </span>to the glossary whose type is given by <span class="cmtt-10">languages</span>, @@ -13886,12 +14577,13 @@ class="cmtt-10">main</span>. </p> <div class="center" > -<!--l. 6540--><p class="noindent" > -</p><!--l. 6540--><p class="noindent" >____________________________</p></div> -<!--l. 6543--><p class="indent" > <span class="warningsymbol">⚠</span> Note: if you use <span +<!--l. 6745--><p class="noindent" > +</p><!--l. 6745--><p class="noindent" >____________________________</p></div> +<!--l. 6748--><p class="indent" > <span class="warningsymbol">⚠</span> Note: if you use <span class="cmtt-10">\newacronym</span><a - id="dx1-122018"></a> (see <a -href="#sec:acronyms">§13 </a><a + id="dx1-123018"></a> (see <a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>) the type is set as <span class="obeylines-h"><span class="verb"><span class="cmtt-10">type=\acronymtype</span></span></span> unless you explicitly override it. For example, if my file <span @@ -13900,72 +14592,76 @@ contains: </p> - <div class="verbatim" id="verbatim-170"> + <pre class="verbatim" id="verbatim-176"> \newacronym{aca}{aca}{a contrived acronym} -</div> -<!--l. 6548--><p class="nopar" > then (supposing I have defined a new glossary type called <span +</pre> +<!--l. 6753--><p class="nopar" > then (supposing I have defined a new glossary type called <span class="cmtt-10">altacronym</span>) </p> - <div class="verbatim" id="verbatim-171"> + <pre class="verbatim" id="verbatim-177"> \loadglsentries[altacronym]{myacronyms} -</div> -<!--l. 6553--><p class="nopar" > will add <span +</pre> +<!--l. 6758--><p class="nopar" > will add <span class="cmtt-10">aca </span>to the glossary type <span class="cmtt-10">acronym</span>, if the package option <span class="cmss-10">acronym</span><a - id="dx1-122019"></a> has been specified, + id="dx1-123019"></a> has been specified, or will add <span class="cmtt-10">aca </span>to the glossary type <span class="cmtt-10">altacronym</span>, if the package option <span class="cmss-10">acronym</span><a - id="dx1-122020"></a> is not + id="dx1-123020"></a> is not specified.<span class="footnote-mark"><a href="#fn1x4" id="fn1x4-bk"><sup class="textsuperscript">4.1</sup></a></span><a - id="x1-122021f1"></a> -</p><!--l. 6561--><p class="indent" > If you have used the <span + id="x1-123021f1"></a> +</p><!--l. 6766--><p class="indent" > If you have used the <span class="cmss-10">acronym</span><a - id="dx1-122025"></a> package option, there are two possible solutions to this problem: + id="dx1-123025"></a> package option, there are two possible solutions to this problem: </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-122027x1">Change <span +<li + class="enumerate" id="x1-123027x1"> + <!--l. 6769--><p class="noindent" >Change <span class="cmtt-10">myacronyms.tex </span>so that entries are defined in the form: - <div class="verbatim" id="verbatim-172"> +</p> + <pre class="verbatim" id="verbatim-178"> \newacronym[type=\glsdefaulttype]{aca}{aca}{a -  <br />contrived acronym} -</div> - <!--l. 6569--><p class="nopar" > and do: + contrived acronym} +</pre> + <!--l. 6774--><p class="nopar" > and do: </p> - <div class="verbatim" id="verbatim-173"> + <pre class="verbatim" id="verbatim-179"> \loadglsentries[altacronym]{myacronyms} -</div> - <!--l. 6573--><p class="nopar" > +</pre> + <!--l. 6778--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-122029x2">Temporarily change <span +<li + class="enumerate" id="x1-123029x2"> + <!--l. 6780--><p class="noindent" >Temporarily change <span class="cmtt-10">\acronymtype </span>to the target glossary: - <div class="verbatim" id="verbatim-174"> +</p> + <pre class="verbatim" id="verbatim-180"> \let\orgacronymtype\acronymtype -  <br />\renewcommand{\acronymtype}{altacronym} -  <br />\loadglsentries{myacronyms} -  <br />\let\acronymtype\orgacronymtype -</div> - <!--l. 6581--><p class="nopar" ></p></li></ol> -<!--l. 6584--><p class="indent" > Note that only those entries that have been used in the text will appear in the relevant glossaries. Note also + \renewcommand{\acronymtype}{altacronym} + \loadglsentries{myacronyms} + \let\acronymtype\orgacronymtype +</pre> + <!--l. 6786--><p class="nopar" ></p></li></ol> +<!--l. 6789--><p class="indent" > Note that only those entries that have been used in the text will appear in the relevant glossaries. Note also that <span class="cmtt-10">\loadglsentries </span>may only be used in the preamble. -</p><!--l. 6589--><p class="indent" > Remember that you can use <span +</p><!--l. 6794--><p class="indent" > Remember that you can use <span class="cmtt-10">\provideglossaryentry</span><a - id="dx1-122030"></a> rather than <span + id="dx1-123030"></a> rather than <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-122031"></a>. Suppose you want + id="dx1-123031"></a>. Suppose you want to maintain a large database of acronyms or terms that you’re likely to use in your documents, but you may want to use a modified version of some of those entries. (Suppose, for example, one document may require a more detailed description.) Then if you define the entries using <span @@ -13977,103 +14673,115 @@ class="cmtt-10">terms.tex</span>) contains: </p> - <div class="verbatim" id="verbatim-175"> + <pre class="verbatim" id="verbatim-181"> \provideglossaryentry{mallard}{name=mallard, - <br /> description={a type of duck}} -</div> -<!--l. 6602--><p class="nopar" > but suppose your document requires a more detailed description, you can do: + description={a type of duck}} +</pre> +<!--l. 6807--><p class="nopar" > but suppose your document requires a more detailed description, you can do: </p> - <div class="verbatim" id="verbatim-176"> + <pre class="verbatim" id="verbatim-182"> \usepackage{glossaries} - <br />\makeglossaries - <br />\newglossaryentry{mallard}{name=mallard, - <br /> description={a dabbling duck where the male has a green head}} - <br />\loadglsentries{terms} -</div> -<!--l. 6613--><p class="nopar" > Now the <span +\makeglossaries +\newglossaryentry{mallard}{name=mallard, + description={a dabbling duck where the male has a green head}} +\loadglsentries{terms} +</pre> +<!--l. 6818--><p class="nopar" > Now the <span class="cmtt-10">mallard </span>definition in the <span class="cmtt-10">terms.tex </span>file will be ignored. -</p><!--l. 6617--><p class="noindent" > +</p><!--l. 6822--><p class="noindent" > </p> -<!--l. 6617--><p class="noindent" ><a +<!--l. 6822--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.7 </span> <a id="sec:moveentry"></a>Moving Entries to Another Glossary</h3> -<!--l. 6620--><p class="noindent" >As from version 3.02, you can move an entry from one glossary to another using: -</p><!--l. 6622--><p class="indent" > <hr><div title="Definition"><a - id="dx1-123001"></a> <span +<!--l. 6825--><p class="noindent" >As from version 3.02, you can move an entry from one glossary to another using: +</p><!--l. 6827--><p class="indent" > <hr><div title="Definition"><a + id="dx1-124001"></a> <span class="cmtt-10">\glsmoveentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">target glossary label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 6624--><p class="noindent" > +</p><!--l. 6829--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the unique label identifying the required entry and ⟨<span class="cmti-10">target glossary label</span>⟩ is the unique label identifying the glossary in which to put the entry. -</p><!--l. 6629--><p class="indent" > Note that no check is performed to determine the existence of the target glossary. If you want to move an +</p><!--l. 6834--><p class="indent" > Note that no check is performed to determine the existence of the target glossary. If you want to move an entry to a glossary that’s skipped by <span class="cmtt-10">\printglossaries</span><a - id="dx1-123002"></a>, then define an ignored glossary with + id="dx1-124002"></a>, then define an ignored glossary with <span class="cmtt-10">\newignoredglossary</span><a - id="dx1-123003"></a>. (See <a -href="#sec:newglossary">§12 </a><a + id="dx1-124003"></a>. (See <a +href="#sec:newglossary">§<span +class="cmbx-10">??</span>sec:newglossary </a><a href="#sec:newglossary">Defining New Glossaries<!--tex4ht:ref: sec:newglossary --></a>.) -</p><!--l. 6635--><p class="indent" > <div class="important" title="Important Note"> Unpredictable results may occur if you move an entry to a different glossary from its parent or children. +</p><!--l. 6840--><p class="indent" > <div class="important" title="Important Note"> Unpredictable results may occur if you move an entry to a different glossary from its parent or children. </div> -</p><!--l. 6638--><p class="noindent" > -</p><!--l. 6640--><p class="noindent" > +</p><!--l. 6843--><p class="noindent" > +</p><!--l. 6845--><p class="noindent" > </p> -<!--l. 6640--><p class="noindent" ><a +<!--l. 6845--><p class="noindent" ><a href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4.8 </span> <a id="sec:docdefs"></a>Drawbacks With Defining Entries in the Document Environment</h3> -<!--l. 6643--><p class="noindent" >Originally, <span +<!--l. 6848--><p class="noindent" >Originally, <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-124001"></a> (and <span + id="dx1-125001"></a> (and <span class="cmtt-10">\newacronym</span><a - id="dx1-124002"></a>) could only be used in the preamble. I reluctantly removed + id="dx1-125002"></a>) could only be used in the preamble. I reluctantly removed this restriction in version 1.13, but there are issues with defining commands in the <span class="cmss-10">document</span><a - id="dx1-124003"></a><a - id="dx1-124004"></a> environment + id="dx1-125003"></a><a + id="dx1-125004"></a> environment instead of the preamble, which is why the restriction is maintained for newer commands. This restriction is also reimposed for <span class="cmtt-10">\newglossaryentry </span>by the new <a href="#option1">Option 1</a>. (The <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package automatically -reimposes this restriction for Options <a +class="cmss-10">glossaries-extra</span></a> package automatically reimposes +this restriction for Options <a href="#option2">2</a> and <a -href="#option3">3</a> but provides a package option to allow document -definitions.) +href="#option3">3</a> but provides a package option to allow document definitions if +necessary.) -</p><!--l. 6653--><p class="noindent" > +</p><!--l. 6858--><p class="noindent" > </p> -<!--l. 6653--><p class="noindent" ><a +<!--l. 6858--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.8.1 </span> <a id="sec:techissues"></a>Technical Issues</h4> -<!--l. 6656--><p class="noindent" > +<!--l. 6861--><p class="noindent" > </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-125002x1">If you define an entry mid-way through your document, but subsequently shuffle sections around, +<li + class="enumerate" id="x1-126002x1"> + <!--l. 6862--><p class="noindent" >If you define an entry mid-way through your document, but subsequently shuffle sections around, you could end up using an entry before it has been defined. - </li> - <li - class="enumerate" id="x1-125004x2">Entry information is required when displaying the glossary. If this occurs at the start of the + </p></li> +<li + class="enumerate" id="x1-126004x2"> + <!--l. 6866--><p class="noindent" >Entry information is required when displaying the glossary. If this occurs at the start of the document, but the entries aren’t defined until later, then the entry details are being looked up - before the entry has been defined. - </li> - <li - class="enumerate" id="x1-125006x3">If you use a package, such as <span + before the entry has been defined. This means that it’s not possible to display the content of the + glossary unless the entry definitions are saved on the previous LaTeX run and can be picked up + at the start of the <span +class="cmss-10">document</span><a + id="dx1-126005"></a><a + id="dx1-126006"></a> environment on the next run (in a similar way that <span +class="cmtt-10">\label </span>and <span +class="cmtt-10">\ref</span> + work). + </p></li> +<li + class="enumerate" id="x1-126008x3"> + <!--l. 6875--><p class="noindent" >If you use a package, such as <span class="cmss-10">babel</span><a - id="dx1-125007"></a>, that makes certain characters active at the start of the <span + id="dx1-126009"></a>, that makes certain characters active at the start of the <span class="cmss-10">document</span><a - id="dx1-125008"></a><a - id="dx1-125009"></a> + id="dx1-126010"></a><a + id="dx1-126011"></a> environment, there will be a problem if those characters have a special significance when defining glossary entries. These characters include the double-quote <span class="obeylines-h"><span class="verb"><span class="cmtt-10">"</span></span></span> character, the exclamation mark <span @@ -14083,41 +14791,38 @@ class="cmtt-10">?</span></span></span> character, and the pipe <span class="obey class="cmtt-10">|</span></span></span> character. They must not be active when defining a glossary entry where they occur in the <span class="cmtt-10">sort</span><a - id="dx1-125010"></a> key (and they should be avoided in the label + id="dx1-126012"></a> key (and they should be avoided in the label if they may be active at any point in the document). Additionally, the comma <span class="cmtt-10">, </span>character and the equals <span class="cmtt-10">= </span>character should not be active when using commands that have ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ arguments. +</p> </li></ol> -<!--l. 6682--><p class="noindent" >To overcome the first two problems, as from version 4.0 the <span +<!--l. 6891--><p class="noindent" >To overcome the first two problems, as from version 4.0 the <span class="cmss-10">glossaries </span>package modifies the definition of <span class="cmtt-10">\newglossaryentry </span>at the beginning of the <span class="cmss-10">document</span><a - id="dx1-125011"></a><a - id="dx1-125012"></a> environment so that the definitions are written to an + id="dx1-126013"></a><a + id="dx1-126014"></a> environment so that the definitions are written to an external file (<span -class="cmtt-10">\jobnameglsdefs</span><a - id="dx1-125013"></a>) which is then read in at the start of the document on the next run. The entry -will then only be defined in the <span -class="cmss-10">document</span><a - id="dx1-125014"></a><a - id="dx1-125015"></a> environment if it doesn’t already exist. This means that the -entry can now be looked up in the glossary, even if the glossary occurs at the beginning of the +class="cmtt-10">\jobname.glsdefs</span><a + id="dx1-126015"></a>) which is then read in at the start of the document on the next run. This +means that the entry can now be looked up in the glossary, even if the glossary occurs at the beginning of the 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 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 -the <span -class="cmtt-10">glsdefs</span><a - id="dx1-125017"></a> file when it’s created at the end of the document (and therefore won’t be present on subsequent -runs). -</p><!--l. 6700--><p class="indent" > The <a +</p><!--l. 6900--><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 in <span +class="cmtt-10">\printglossary </span>(if it occurs at the start of the document); this method requires +an extra <span +class="cmtt-10">\newwrite</span>, which may exceed TeX’s maximum allocation; unexpected expansion issues could +occur. +</p><!--l. 6907--><p class="indent" > Version 4.47 has introduced changes that have removed some of the issues involved, and there are now +warning messages if there is an attempt to multiple define the same entry label. + + +</p><!--l. 6911--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides a setting (but only for Options <a href="#option2">2</a> and <a @@ -14125,27 +14830,25 @@ href="#option3">3</a>) that allows <span class="cmtt-10">\newglossaryentry</span> to occur in the document environment but doesn’t create the <span class="cmtt-10">glsdefs</span><a - id="dx1-125018"></a> file. This circumvents some problems but + id="dx1-126016"></a> file. This circumvents some problems but it means that you can’t display any of the glossaries before all the entries have been defined (so it’s all right if all the glossaries are at the end of the document but not if any occur in the front matter). -</p><!--l. 6708--><p class="noindent" > +</p><!--l. 6919--><p class="noindent" > </p> -<!--l. 6708--><p class="noindent" ><a +<!--l. 6919--><p class="noindent" ><a href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">4.8.2 </span> <a id="sec:goodpractice"></a>Good Practice Issues</h4> -<!--l. 6711--><p class="noindent" >The above section covers technical issues that can cause your document to have compilation errors or produce +<!--l. 6922--><p class="noindent" >The above section covers technical issues that can cause your document to have compilation errors or produce incorrect output. This section focuses on good writing practice. The main reason cited by users wanting to - - define entries within the <span class="cmss-10">document</span><a - id="dx1-126001"></a><a - id="dx1-126002"></a> environment rather than in the preamble is that they want to + id="dx1-127001"></a><a + id="dx1-127002"></a> environment rather than in the preamble is that they want to write the definition as they type in their document text. This suggests a “stream of consciousness” style of writing that may be acceptable in certain literary genres but is inappropriate for factual documents. -</p><!--l. 6720--><p class="indent" > When you write technical documents, regardless of whether it’s a PhD thesis or an article for a journal or +</p><!--l. 6931--><p class="indent" > When you write technical documents, regardless of whether it’s a PhD thesis or an article for a journal or proceedings, you must plan what you write in advance. If you plan in advance, you should have a fairly good idea of the type of terminology that your document will contain, so while you are planning, create a new file with all your entry definitions. If, while you’re writing your document, you remember another term you need, @@ -14156,984 +14859,192 @@ definition. </p> -<!--l. 6733--><p class="indent" > </div> -</p><!--l. 6733--><p class="noindent" ><a +<!--l. 6944--><p class="indent" > </div> +</p><!--l. 6944--><p class="noindent" ><a href="#top">Top</a><div class="chapter"><h2 class="chapterHead">5. <a - id="sec:numberlists"></a>Number lists</h2> -</p><!--l. 6736--><p class="indent" > Each entry in the glossary has an associated <a -href="#glo:numberlist">number list<a - id="dx1-127001"></a></a>. By default, these numbers refer to the -pages on which that entry has been indexed (using any of the commands described in <a -href="#sec:glslink">§6 </a><a -href="#sec:glslink">Links to -Glossary Entries<!--tex4ht:ref: sec:glslink --></a> and <a -href="#sec:glsadd">§7 </a><a -href="#sec:glsadd">Adding an Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a>). The number list -can be suppressed using the <span -class="cmss-10">nonumberlist</span><a - id="dx1-127002"></a> package option, or an alternative counter can be set as -the default using the <span -class="cmss-10">counter</span><a - id="dx1-127003"></a> package option. The number list is also referred to as the location -list<a - id="dx1-127004"></a>. -</p><!--l. 6745--><p class="indent" > <a -href="#glo:numberlist">Number list<a - id="dx1-127005"></a>s</a> are more common with indexes rather than glossaries (although you can use the <span -class="cmss-10">glossaries</span> -package for indexes as well). However, the <span -class="cmss-10">glossaries </span>package makes use of <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-127006"></a></a> or <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 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 - id="dx1-127008"></a>, the locations must still be provided and acceptable to the <a -href="#glo:indexingapp">indexing -application</a> or they will cause an error during the indexing stage, which will interrupt the document build. -However, if you’re not interested in the locations, each entry only needs to be indexed once, so consider using -<span -class="cmss-10">indexonlyfirst</span><a - id="dx1-127009"></a>, which can improve the document build time by only indexing the <a -href="#glo:firstuse">first use</a> of each -term. -</p><!--l. 6760--><p class="indent" > The <span -class="cmtt-10">\glsaddall</span><a - id="dx1-127010"></a> command (see <a -href="#sec:glsadd">§7 </a><a -href="#sec:glsadd">Adding an Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a>), which is used -to automatically index all entries, iterates over all defined entries and does <span -class="cmtt-10">\glsadd{</span>⟨<span -class="cmti-10">label</span>⟩<span -class="cmtt-10">} </span>for -each entry (where ⟨<span -class="cmti-10">label</span>⟩ is that entry’s label). This means that <span -class="cmtt-10">\glsaddall </span>automatically adds -the same location to every entry’s <a -href="#glo:numberlist">number list<a - id="dx1-127011"></a></a>, which looks weird if the number list<a - id="dx1-127012"></a> hasn’t been -suppressed. -</p><!--l. 6767--><p class="indent" > With <a -href="#option4">Option 4</a>, the indexing is performed by <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-127013"></a></a>, which was specifically designed for the <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> -package. So it will allow any location format, and its <span -class="cmtt-10">selection=all </span>option will select all entries without -adding an unwanted location to the <a -href="#glo:numberlist">number list<a - id="dx1-127014"></a></a>. If <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-127015"></a></a> can deduce a numerical value for a location, it will -attempt to form a range over consecutive locations, otherwise it won’t try to form a range and the location will -just form an individual item in the list. <a -href="#option1">Option 1</a> also allows any location but it doesn’t form -ranges. -</p> -<!--l. 6777--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.1 </span> <a - id="sec:encap"></a>Encap Values</h3> -<!--l. 6780--><p class="noindent" >Each location in the <a -href="#glo:numberlist">number list<a - id="dx1-128001"></a></a> is encapsulated with a command formed from the <span -class="cmti-10">encap</span><a - id="dx1-128002"></a> value. By default this -is the <span -class="cmtt-10">\glsnumberformat</span><a - id="dx1-128003"></a> command, which corresponds to the encap <span -class="cmtt-10">glsnumberformat</span>, but this may be -overridden using the <span -class="cmtt-10">format</span><a - id="dx1-128004"></a> key in the optional argument to commands like <span -class="cmtt-10">\gls</span>. (See <a -href="#sec:glslink">§6 </a><a -href="#sec:glslink">Links to Glossary -Entries<!--tex4ht:ref: sec:glslink --></a>.) For example, you may want the location to appear in bold to indicate the principle use of a term or -symbol. If the encap starts with an open parenthesis <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">(</span></span></span> this signifies the start of a range and if the encap starts -with close parenthesis <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">)</span></span></span> this signifies the end of a range. These must always occur in matching -pairs. -</p><!--l. 6792--><p class="indent" > The <span -class="cmss-10">glossaries </span>package provides the command <span -class="cmtt-10">\glsignore</span><a - id="dx1-128005"></a> which ignores its argument. This is the format -used by <span -class="cmtt-10">\glsaddallunused </span>to suppress the location, which works fine as long as no other locations are added to -the <a -href="#glo:numberlist">number list<a - id="dx1-128006"></a></a>. For example, if you use <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\gls{sample}</span></span></span> on page 2 then reset the <a -href="#glo:firstuseflag">first use flag</a> and then use -<span -class="cmtt-10">\glsaddallunused </span>on page 10, the <a -href="#glo:numberlist">number list<a - id="dx1-128007"></a></a> for <span -class="cmtt-10">sample </span>will be <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">2,</span><span -class="cmtt-10"> \glsignore{10}</span></span></span> which will result in -“2, ” which has a spurious comma. -</p><!--l. 6801--><p class="indent" > This isn’t a problem with <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-128008"></a></a> because you’d use <span -class="cmtt-10">selection=all </span>instead of <span -class="cmtt-10">\glsaddallunused</span>, but -even if you explicitly had, for example, <span -class="cmtt-10">\gls[format=glsignore]{</span>⟨<span -class="cmti-10">label</span>⟩<span -class="cmtt-10">} </span>for some reason, <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-128009"></a></a> will - - -recognise <span -class="cmtt-10">glsignore </span>as a special encap indicating an ignored location, so it will select the entry but not add -that location to the <a -href="#glo:numberlist">number list<a - id="dx1-128010"></a></a>. It’s a problem for all the other options (except <a -href="#option5">Option 5</a>, which doesn’t -perform any indexing). -</p><!--l. 6811--><p class="indent" > Complications can arise if you use different encap values for the same location. For example, suppose on -page 10 you have both the default <span -class="cmtt-10">glsnumberformat </span>and <span -class="cmtt-10">textbf </span>encaps. While it may seem apparent that -<span -class="cmtt-10">textbf </span>should override <span -class="cmtt-10">glsnumberformat </span>in this situation, the <a -href="#glo:indexingapp">indexing application</a> may not know it. This is -therefore something you need to be careful about if you use the <span -class="cmtt-10">format</span><a - id="dx1-128011"></a> key or if you use a command that -implicitly sets it. -</p><!--l. 6820--><p class="indent" > In the case of <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-128012"></a></a>, it only accepts one encap (according to the order of precedence given in the <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-128013"></a></a> -module) and discards the others for identical locations (for the same entry). This can cause a problem if a -discarded location forms the start or end of a range. -</p><!--l. 6825--><p class="indent" > In the case of <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-128014"></a></a>, it accepts different encaps for the same location, but warns about it. This leads to -a <a -href="#glo:numberlist">number list<a - id="dx1-128015"></a></a> with the same location repeated in different formats. If you use the <a -href="#glo:makeglossaries"><span -class="cmtt-10">makeglossaries</span><a - id="dx1-128016"></a></a> Perl script -with <a -href="#option2">Option 2</a> it will detect <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-128017"></a></a>’s warning and attempt to fix the problem, ensuring that the -<span -class="cmtt-10">glsnumberformat </span>encap always has the least precedence unless it includes a range identifier. Other conflicting -encaps will have the last one override earlier ones for the same location with range identifiers taking -priority. -</p><!--l. 6835--><p class="indent" > No discard occurs with <a -href="#option1">Option 1</a> so again you get the same location repeated in different formats. With -<a -href="#option4">Option 4</a>, <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-128018"></a></a> will discard according to order of precedence, giving priority to start and end range encaps. -(See the <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-128019"></a></a> manual for further details.) -</p><!--l. 6840--><p class="noindent" > -</p> -<!--l. 6840--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.2 </span> <a - 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 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 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 -href="#option2">2</a> and <a -href="#option3">3</a> are far more problematic and need some complex code to deal with awkward -locations. -</p><!--l. 6854--><p class="indent" > If you know that your locations will always expand to a format acceptable to your chosen <a -href="#glo:indexingapp">indexing -application</a> then use the package option <span -class="cmss-10">esclocations</span><span -class="cmtt-10">=</span><span -class="cmss-10">false</span><a - id="dx1-129002"></a> to bypass this operation. This setting only affects -Options <a -href="#option2">2</a> and <a -href="#option3">3</a> as the problem doesn’t arise with the other indexing options. -</p><!--l. 6860--><p class="indent" > Both <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-129003"></a></a> and <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-129004"></a></a> are fussy about the syntax of the locations. In the case of <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-129005"></a></a>, only the -numbering system obtained with <span -class="cmtt-10">\arabic</span>, <span -class="cmtt-10">\roman</span>, <span -class="cmtt-10">\Roman</span>, <span -class="cmtt-10">\alph </span>and <span -class="cmtt-10">\Alph </span>or composites formed from them -with the same separator (set with <span -class="cmtt-10">\glsSetCompositor{</span>⟨<span -class="cmti-10">char</span>⟩<span -class="cmtt-10">}</span>) are accepted. (<a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-129006"></a></a> won’t accept an empty -location.) In the case of <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-129007"></a></a>, you can define your own location classes, but if the location contains a robust -command then the leading backslash must be escaped. The <span -class="cmss-10">glossaries</span><a - id="dx1-129008"></a> package tries to do this, but it’s caught -between two conflicting requirements: + id="sec:usingentries"></a>Referencing Entries in the Document</h2> +</p><!--l. 6947--><p class="indent" > Once you have defined a glossary entry using a command like <span +class="cmtt-10">\newglossaryentry</span><a + id="dx1-128001"></a> (<a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry +</a><a +href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>) or <span +class="cmtt-10">\newacronym</span><a + id="dx1-128002"></a> (<a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>), you can refer +to that entry in the document with one of the provided commands that are describe in this manual. (There are +some additional commands provided by <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>.) The text produced at that point in the document is +determined by the command and can also be governed by whether or not the entry has been <a +href="#glo:firstuseflag">marked as +used</a>. +</p><!--l. 6957--><p class="indent" > Some of these commands are more complicated than others. Many of them are robust and can’t be used in +fully expandable contexts, such as in PDF bookmarks. +</p><!--l. 6961--><p class="indent" > The commands are broadly divided into: </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-129010x1">The location must be fully expanded before <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\</span></span></span> can be converted to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\\</span></span></span> (there’s no point converting - <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\thepage</span></span></span> to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\\thepage</span></span></span>); - </li> - - - <li - class="enumerate" id="x1-129012x2">The page number can’t be expanded until the deferred write operation (so <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\c@page</span></span></span> mustn’t - expand in the previous step but <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\the\c@page</span></span></span> mustn’t be converted to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\\the\\c@page</span></span></span> and - <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\number\c@page</span></span></span> mustn’t be converted to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\\number\\c@page</span></span></span> etc).</li></ol> -<!--l. 6880--><p class="noindent" >There’s a certain amount of trickery needed to deal with this conflict and the code requires the location to be in a -form that doesn’t embed the counter’s internal register in commands like <span -class="cmtt-10">\value</span>. For example, -suppose you have a robust command called <span -class="cmtt-10">\tallynum </span>that takes a number as the argument and an -expandable command called <span -class="cmtt-10">\tally </span>that converts a counter name into the associated register or -number to pass to <span -class="cmtt-10">\tallynum</span>. Let’s suppose that this command is used to represent the page -number: - - -</p> - <div class="verbatim" id="verbatim-177"> -\renewcommand{\thepage}{\tally{page}} -</div> -<!--l. 6890--><p class="nopar" > Now let’s suppose that a term is indexed at the beginning of page 2 at the end of a paragraph that started on -page 1. With <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-129013"></a></a>, the location <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\tally{page}</span></span></span> needs to be written to the file as <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\\tallynum{2}</span></span></span>. If it’s written -as <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\tallynum{2}</span></span></span> then <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-129014"></a></a> will interpret <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\t</span></span></span> as the character “t” (which means the location would appear as -“tallynum2”). So <span -class="cmss-10">glossaries</span><a - id="dx1-129015"></a> tries to expand <span -class="cmtt-10">\thepage </span>without expanding <span -class="cmtt-10">\c@page </span>and then escapes all the -backslashes, except for the page counter’s internal command. The following definitions of <span -class="cmtt-10">\tally </span>will work: -</p> - <ul class="itemize1"> - <li class="itemize">In the following, <span -class="cmtt-10">\arabic </span>works as its internal command <span -class="cmtt-10">\c@arabic </span>is temporarily redefined to check for - <span -class="cmtt-10">\c@page</span>: - - - <div class="verbatim" id="verbatim-178"> - \newcommand{\tally}[1]{\tallynum{\arabic{#1}}} -</div> - <!--l. 6906--><p class="nopar" > - </p></li> - <li class="itemize">The form <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\expandafter\the\csname</span><span -class="cmtt-10"> c@</span></span></span>⟨<span -class="cmti-10">counter</span>⟩<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\endcsname</span></span></span> also works (provided <span -class="cmtt-10">\the </span>is allowed to be - temporarily redefined, see below): - - - <div class="verbatim" id="verbatim-179"> - \newcommand{\tally}[1]{% -  <br /> \tallynum{\expandafter\the\csname c@#1\endcsname}} -</div> - <!--l. 6914--><p class="nopar" > - </p></li> - <li class="itemize"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\expandafter\the\value</span></span></span><span -class="cmtt-10">{</span>⟨<span -class="cmti-10">counter</span>⟩<span -class="cmtt-10">} </span>now also works (with the same condition as above): - - - <div class="verbatim" id="verbatim-180"> - \newcommand{\tally}[1]{\tallynum{\expandafter\the\value{#1}}} -</div> - <!--l. 6920--><p class="nopar" > - </p></li> - <li class="itemize">Another variation that will work: - - - <div class="verbatim" id="verbatim-181"> - \newcommand{\tally}[1]{% -  <br />  \expandafter\tallynum\expandafter{\the\csname c@#1\endcsname}} -</div> - <!--l. 6926--><p class="nopar" > - </p></li> - <li class="itemize">and also: - - - <div class="verbatim" id="verbatim-182"> - \newcommand{\tally}[1]{\tallynum{\the\csname c@#1\endcsname}} -</div> - <!--l. 6931--><p class="nopar" ></p></li></ul> -<!--l. 6933--><p class="noindent" >The following <span -class="cmti-10">don’t work</span>: </p> - <ul class="itemize1"> - <li class="itemize">This definition leads to the premature expansion of <span -class="cmtt-10">\c@page </span>to “1” when, in this case, it should be - “2”: - - - <div class="verbatim" id="verbatim-183"> - \newcommand{\tally}[1]{\tallynum{\the\value{#1}}} -</div> - <!--l. 6939--><p class="nopar" > +<li + class="enumerate" id="x1-128004x1"> + <!--l. 6963--><p class="noindent" >Those that display text in the document (where the formatting can be adjusted by a style or + hook) and also index the entry (so that it’s added to the document) are described in <a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink + </a><a +href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a>. This set of commands can be further sub-divided into those that mark + the entry as having been used (the <span +class="cmtt-10">\gls</span>-like commands, <a +href="#sec:gls-like">§<span +class="cmbx-10">??</span>sec:gls-like </a><a +href="#sec:gls-like">The <span +class="cmtt-10">\gls</span>-Like Commands + (First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a>) and those that don’t (the <span +class="cmtt-10">\glstext</span>-like commands, <a +href="#sec:glstext-like">§<span +class="cmbx-10">??</span>sec:glstext-like + </a><a +href="#sec:glstext-like">The <span +class="cmtt-10">\glstext</span>-Like Commands (First Use Flag Not Queried)<!--tex4ht:ref: sec:glstext-like --></a>). </p></li> - <li class="itemize">This definition leads to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\\c@page</span></span></span> in the glossary file: - - - <div class="verbatim" id="verbatim-184"> - \newcommand{\tally}[1]{\tallynum{\csname c@#1\endcsname}} -</div> - <!--l. 6943--><p class="nopar" ></p></li></ul> -<!--l. 6945--><p class="noindent" >If you have a numbering system where <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\</span></span></span>⟨<span -class="cmti-10">cs name</span>⟩<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">{page}</span></span></span> expands to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\</span></span></span>⟨<span -class="cmti-10">internal cs name</span>⟩<span -class="cmtt-10">\c@page </span>(for example, if -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\tally{page}</span></span></span> expands to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\tallynum\c@page</span></span></span>) then you need to use: -</p><!--l. 6950--><p class="indent" > <hr><div title="Definition"><a - id="dx1-129016"></a> <span -class="cmtt-10">\glsaddprotectedpagefmt{</span>⟨<span -class="cmitt-10">internal cs name</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 6952--><p class="noindent" > -Note that the backslash must be omitted from ⟨<span -class="cmti-10">internal cs name</span>⟩ and the corresponding command must be able -to process a count register as the (sole) argument. -</p><!--l. 6957--><p class="indent" > For example, suppose you have a style <span -class="cmtt-10">samplenum </span>that is implemented as follows: - - -</p> - <div class="verbatim" id="verbatim-185"> - \newcommand*{\samplenum}[1]{% - <br />   \expandafter\@samplenum\csname c@#1\endcsname} - <br /> \newcommand*{\@samplenum}[1]{\two@digits{#1}} -</div> -<!--l. 6964--><p class="nopar" > (That is, it displays the value of the counter as a two-digit number.) Then to ensure the location is correct for -entries in page-spanning paragraphs, you need to do: - - -</p> - <div class="verbatim" id="verbatim-186"> -\glsaddprotectedpagefmt{@samplenum} -</div> -<!--l. 6970--><p class="nopar" > (If you are using a different counter for the location, such as <span -class="cmtt-10">section </span>or <span -class="cmtt-10">equation</span>, you don’t need to worry -about this provided the inner command is expandable.) -</p><!--l. 6975--><p class="indent" > If the inner macro (as given by <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\</span></span></span>⟨<span -class="cmti-10">internal cs name</span>⟩) contains non-expandable commands then you may need -to redefine <span -class="cmtt-10">\gls</span>⟨<span -class="cmti-10">internal cs name</span>⟩<span -class="cmtt-10">page </span>after using </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">\glsaddprotectedpagefmt{</span>⟨<span -class="cmitt-10">internal</span><span -class="cmitt-10"> cs</span><span -class="cmitt-10"> name</span>⟩<span -class="cmtt-10">}</span> -</div> -</div> This command doesn’t take any arguments as <span -class="cmti-10">the location is assumed to be given by </span><span -class="cmitt-10">\c@page </span>because that’s -the only occasion this command should be used. For example, suppose now my page counter format uses small -caps Roman numerals: - - - <div class="verbatim" id="verbatim-187"> - \newcommand*{\samplenum}[1]{% - <br />  \expandafter\@samplenum\csname c@#1\endcsname} - <br /> \newcommand*{\@samplenum}[1]{\textsc{\romannumeral#1}} -</div> -<!--l. 6989--><p class="nopar" > Again, the inner macro needs to be identified using: - - -</p> - <div class="verbatim" id="verbatim-188"> -\glsaddprotectedpagefmt{@samplenum} -</div> -<!--l. 6993--><p class="nopar" > However, since <span -class="cmtt-10">\textsc </span>isn’t fully expandable, the location is written to the file as <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\textsc</span><span -class="cmtt-10"> </span><span -class="cmtt-10"> {i}</span></span></span> (for page 1), -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\textsc</span><span -class="cmtt-10"> </span><span -class="cmtt-10"> {ii}</span></span></span> (for page 2), etc. This format may cause a problem for the <a -href="#glo:indexingapp">indexing application</a> -(particularly for <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-129017"></a></a>). To compensate for this, the <span -class="cmtt-10">\gls</span>⟨<span -class="cmti-10">internal cs name</span>⟩<span -class="cmtt-10">page </span>command -may be redefined so that it expands to a format that’s acceptable to the indexing application. For -example: - - -</p> - <div class="verbatim" id="verbatim-189"> -\renewcommand*{\gls@samplenumpage}{\romannumeral\c@page} -</div> -<!--l. 7003--><p class="nopar" > While this modification means that the <a -href="#glo:numberlist">number list<a - id="dx1-129018"></a></a> in the glossary won’t exactly match the format of the page -numbers (displaying lower case Roman numbers instead of small cap Roman numerals) this method -will at least work correctly for both <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-129019"></a></a> and <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-129020"></a></a>. If you are using <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-129021"></a></a>, the following -definition: - - -</p> - <div class="verbatim" id="verbatim-190"> - \renewcommand*{\gls@samplenumpage}{% - <br />   \glsbackslash\string\textsc{\romannumeral\c@page}} -</div> -<!--l. 7013--><p class="nopar" > combined with - - -</p> - <div class="verbatim" id="verbatim-191"> -\GlsAddXdyLocation{romansc}{:sep "\string\textsc\glsopenbrace" - <br /> "roman-numbers-lowercase" :sep "\glsclosebrace"} -</div> -<!--l. 7018--><p class="nopar" > will now have lowercase Roman numerals in the location list (see <a -href="#sec:xindyloc">§11.2 </a><a -href="#sec:xindyloc">Locations and Number lists<!--tex4ht:ref: sec:xindyloc --></a> for -further details on that command). Take care of the backslashes. The location (which ends up in the -<span -class="cmtt-10">:locref</span><a - id="dx1-129022"></a> attribute) needs <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\\</span></span></span> but the location class (identified with <span -class="cmtt-10">\GlsAddXdyLocation</span>) just -has a single backslash. Note that this example will cause problems if your locations should be -hyperlinks. -</p><!--l. 7027--><p class="indent" > Another possibility that may work with both <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-129023"></a></a> and <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-129024"></a></a> is to redefine <span -class="cmtt-10">\gls</span>⟨<span -class="cmti-10">internal cs name</span>⟩<span -class="cmtt-10">page</span> -(<span -class="cmtt-10">\gls@samplenumpage </span>in this example) to just expand to the decimal page number (<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\number\c@page</span></span></span>) and -redefine <span -class="cmtt-10">\glsnumberformat</span><a - id="dx1-129025"></a> to change the displayed format: - - -</p> - <div class="verbatim" id="verbatim-192"> -\renewcommand*{\gls@samplenumpage}{\number\c@page} - <br />\renewcommand*{\glsnumberformat}[1]{\textsc{\romannumeral#1}} -</div> -<!--l. 7035--><p class="nopar" > -</p><!--l. 7037--><p class="indent" > <div class="important" title="Important Note"> If you redefine <span -class="cmtt-10">\gls</span>⟨<span -class="cmti-10">internal cs name</span>⟩<span -class="cmtt-10">page</span>, you must make sure that <span -class="cmtt-10">\c@page </span>is expanded when it’s written -to the file. (So don’t, for example, hide <span -class="cmtt-10">\c@page </span>inside a robust command.) </div> -</p><!--l. 7042--><p class="noindent" > -</p><!--l. 7044--><p class="indent" > The mechanism that allows this to work temporarily redefines <span -class="cmtt-10">\the</span><a - id="dx1-129026"></a> and <span -class="cmtt-10">\number</span><a - id="dx1-129027"></a> while it processes the -location. If this causes a problem you can disallow it using -</p><!--l. 7047--><p class="indent" > <hr><div title="Definition"><a - id="dx1-129028"></a> <span -class="cmtt-10">\glswrallowprimitivemodsfalse </span></div><hr> -</p><!--l. 7049--><p class="noindent" > -but you will need to find some other way to ensure the location expands correctly. -</p><!--l. 7053--><p class="noindent" > -</p> -<!--l. 7053--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.3 </span> <a - id="sec:ranges"></a>Range Formations</h3> -<!--l. 7056--><p class="noindent" >Both <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-130001"></a></a> and <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-130002"></a></a> (Options <a -href="#option2">2</a> and <a -href="#option3">3</a>) concatenate a sequence of 3 or more consecutive pages into a -range. With <span -class="cmtt-10">xindy</span><a - id="dx1-130003"></a> (<a -href="#option3">Option 3</a>) you can vary the minimum sequence length using <span -class="cmtt-10">\GlsSetXdyMinRangeLength</span><a - id="dx1-130004"></a> -<span -class="cmtt-10">{</span>⟨<span -class="cmti-10">n</span>⟩<span -class="cmtt-10">} </span>where ⟨<span -class="cmti-10">n</span>⟩ is either an integer or the keyword <span -class="cmtt-10">none </span>which indicates that there should be no range formation -(see <a -href="#sec:xindyloc">§11.2 </a><a -href="#sec:xindyloc">Locations and Number lists<!--tex4ht:ref: sec:xindyloc --></a> for further details). -</p><!--l. 7064--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\GlsSetXdyMinRangeLength </span>must be used before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-130005"></a> and has no effect if <span -class="cmtt-10">\noist</span><a - id="dx1-130006"></a> -is used. </div> -</p><!--l. 7067--><p class="noindent" > -</p><!--l. 7069--><p class="indent" > With both <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-130007"></a></a> and <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-130008"></a></a> (Options <a -href="#option2">2</a> and <a -href="#option3">3</a>), you can replace the separator and the closing number -in the range using: -</p><!--l. 7071--><p class="indent" > <hr><div title="Definition"><a - id="dx1-130009"></a> <span -class="cmtt-10">\glsSetSuffixF{</span>⟨<span -class="cmitt-10">suffix</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7073--><p class="noindent" > -</p><!--l. 7074--><p class="indent" > <hr><div title="Definition"><a - id="dx1-130010"></a> <span -class="cmtt-10">\glsSetSuffixFF{</span>⟨<span -class="cmitt-10">suffix</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7076--><p class="noindent" > -where the former command specifies the suffix to use for a 2 page list and the latter specifies the suffix to use for -longer lists. For example: - - -</p> - <div class="verbatim" id="verbatim-193"> -\glsSetSuffixF{f.} - <br />\glsSetSuffixFF{ff.} -</div> -<!--l. 7083--><p class="nopar" > Note that if you use <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-130011"></a></a> (<a -href="#option3">Option 3</a>), you will also need to set the minimum range length to 1 if you want to -change these suffixes: - - -</p> - <div class="verbatim" id="verbatim-194"> -\GlsSetXdyMinRangeLength{1} -</div> -<!--l. 7089--><p class="nopar" > Note that if you use the <span -class="cmss-10">hyperref</span><a - id="dx1-130012"></a> package, you will need to use <span -class="cmtt-10">\nohyperpage</span><a - id="dx1-130013"></a> in the suffix to ensure that the -hyperlinks work correctly. For example: - - -</p> - <div class="verbatim" id="verbatim-195"> -\glsSetSuffixF{\nohyperpage{f.}} - <br />\glsSetSuffixFF{\nohyperpage{ff.}} -</div> -<!--l. 7096--><p class="nopar" > -</p><!--l. 7098--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\glsSetSuffixF </span>and <span -class="cmtt-10">\glsSetSuffixFF </span>must be used before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-130014"></a> and have no -effect if <span -class="cmtt-10">\noist</span><a - id="dx1-130015"></a> is used. </div> -</p><!--l. 7102--><p class="noindent" > -</p><!--l. 7104--><p class="indent" > It’s also possible to concatenate a sequence of consecutive locations into a range or have suffixes with +<li + class="enumerate" id="x1-128006x2"> + <!--l. 6971--><p class="noindent" >Those that display text in the document without indexing or applying any additional formatting + (<a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a +href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>).</p></li></ol> +<!--l. 6974--><p class="noindent" >There are additional commands specific to entries defined with <span +class="cmtt-10">\newacronym </span>that are described in <a -href="#option4">Option 4</a>, but with <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-130016"></a></a> these implicit ranges can’t be merged with explicit ranges (created with the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">(</span></span></span> and -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">)</span></span></span> encaps). See the <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-130017"></a></a> manual for further details. -</p><!--l. 7110--><p class="indent" > <a -href="#option1">Option 1</a> doesn’t form ranges. However, with this option you can iterate over an entry’s <a -href="#glo:numberlist">number list<a - id="dx1-130018"></a></a> -using: -</p><!--l. 7112--><p class="indent" > <hr><div title="Definition"><a - id="dx1-130019"></a> <span -class="cmtt-10">\glsnumberlistloop{</span>⟨<span -class="cmitt-10">label</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">handler cs</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">xr handler cs</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7115--><p class="noindent" > -where ⟨<span -class="cmti-10">label</span>⟩ is the entry’s label and ⟨<span -class="cmti-10">handler cs</span>⟩ is a handler control sequence of the form: -</p><!--l. 7119--><p class="indent" > <hr><div title="Definition">⟨<span -class="cmitt-10">handler cs</span>⟩<span -class="cmtt-10">{</span>⟨<span -class="cmitt-10">prefix</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">format</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">location</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7120--><p class="noindent" > -where ⟨<span -class="cmti-10">prefix</span>⟩ is the <span -class="cmss-10">hyperref</span><a - id="dx1-130020"></a> prefix, ⟨<span -class="cmti-10">counter</span>⟩ is the name of the counter used for the location, ⟨<span -class="cmti-10">format</span>⟩ is the -format used to display the location (e.g. <span -class="cmtt-10">textbf</span>) and ⟨<span -class="cmti-10">location</span>⟩ is the location. The third argument -is the control sequence to use for any cross-references in the list. This handler should have the -syntax: -</p><!--l. 7128--><p class="indent" > <hr><div title="Definition">⟨<span -class="cmitt-10">xr handler cs</span>⟩<span -class="cmtt-10">[</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">xr list</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7129--><p class="noindent" > -where ⟨<span -class="cmti-10">tag</span>⟩ is the cross-referenced text (e.g. “see”) and ⟨<span -class="cmti-10">xr list</span>⟩ is a comma-separated list of labels. (This actually -has a third argument but it’s always empty when used with <a -href="#option1">Option 1</a>.) -</p><!--l. 7134--><p class="indent" > For example, if on page 12 I have used - - -</p> - <div class="verbatim" id="verbatim-196"> -\gls[format=textbf]{apple} -</div> -<!--l. 7138--><p class="nopar" > and on page 18 I have used - - -</p> - <div class="verbatim" id="verbatim-197"> -\gls[format=emph]{apple} -</div> -<!--l. 7142--><p class="nopar" > then - - -</p> - <div class="verbatim" id="verbatim-198"> -\glsnumberlistloop{apple}{\myhandler} -</div> -<!--l. 7146--><p class="nopar" > will be equivalent to: - - -</p> - <div class="verbatim" id="verbatim-199"> -\myhandler{}{page}{textbf}{12}% - <br />\myhandler{}{page}{emph}{18}% -</div> -<!--l. 7151--><p class="nopar" > There is a predefined handler that’s used to display the <a -href="#glo:numberlist">number list<a - id="dx1-130021"></a></a> in the glossary: -</p><!--l. 7154--><p class="indent" > <hr><div title="Definition"><a - id="dx1-130022"></a> <span -class="cmtt-10">\glsnoidxdisplayloc{</span>⟨<span -class="cmitt-10">prefix</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">format</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">location</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7156--><p class="noindent" > -The predefined handler used for the cross-references in the glossary is: -</p><!--l. 7159--><p class="indent" > <hr><div title="Definition"><span -class="cmtt-10">\glsseeformat[</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">xr list</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">location</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7160--><p class="noindent" > -which is described in <a -href="#sec:customxr">§8.1 </a><a -href="#sec:customxr">Customising Cross-reference Text<!--tex4ht:ref: sec:customxr --></a>. -</p><!--l. 7163--><p class="indent" > <div class="important" title="Important Note"> <span -class="cmtt-10">\glsnumberlistloop </span>is not available for Options <a -href="#option2">2</a> and <a -href="#option3">3</a>. </div> -</p><!--l. 7165--><p class="noindent" > -</p><!--l. 7167--><p class="noindent" > -</p> -<!--l. 7167--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.4 </span> <a - id="sec:isthook"></a>Style Hook</h3> -<!--l. 7170--><p class="noindent" >As from version 4.24, there’s a hook that’s used near the end of <span -class="cmtt-10">\writeist</span><a - id="dx1-131001"></a> before the file is closed. You can set -the code to be performed then using: -</p><!--l. 7173--><p class="indent" > <hr><div title="Definition"><a - id="dx1-131002"></a> <span -class="cmtt-10">\GlsSetWriteIstHook{</span>⟨<span -class="cmitt-10">code</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7175--><p class="noindent" > -If you want the ⟨<span -class="cmti-10">code</span>⟩ to write any information to the file, you need to use -</p><!--l. 7178--><p class="indent" > <hr><div title="Definition"><a - id="dx1-131003"></a> <span -class="cmtt-10">\write\glswrite{</span>⟨<span -class="cmitt-10">style information</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 7180--><p class="noindent" > -Make sure you use the correct format within ⟨<span -class="cmti-10">style information</span>⟩. For example, if you are using <span -class="cmtt-10">makeindex</span><a - id="dx1-131004"></a>: - - -</p> - <div class="verbatim" id="verbatim-200"> -\GlsSetWriteIstHook{% - <br /> \write\glswrite{page_precedence "arnAR"}% - <br /> \write\glswrite{line_max 80}% - <br />} -</div> -<!--l. 7188--><p class="nopar" > This changes the page type precedence<a - id="dx1-131005"></a> and the maximum line length used by <span -class="cmtt-10">makeindex</span><a - id="dx1-131006"></a>. -</p><!--l. 7192--><p class="indent" > Remember that if you switch to <span -class="cmtt-10">xindy</span><a - id="dx1-131007"></a>, this will no longer be valid code. - - +href="#sec:longshortfull">§<span +class="cmbx-10">??</span>sec:longshortfull </a><a +href="#sec:longshortfull">Displaying the Long, Short and Full Forms (Independent of First Use)<!--tex4ht:ref: sec:longshortfull --></a>. </p> -<!--l. 7195--><p class="indent" > </div> -</p><!--l. 7195--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">6. <a - id="sec:glslink"></a>Links to Glossary Entries</h2> -</p><!--l. 7198--><p class="indent" > Once you have defined a glossary entry using <span -class="cmtt-10">\newglossaryentry</span><a - id="dx1-132001"></a> (<a -href="#sec:newglosentry">§4 </a><a -href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>) or -<span -class="cmtt-10">\newacronym</span><a - id="dx1-132002"></a> (see <a -href="#sec:acronyms">§13 </a><a -href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>), you can refer to that entry in the document using -one of the commands listed in <a -href="#sec:gls-like">§6.1 </a><a +<!--l. 6977--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.1 </span> <a + id="sec:glslink"></a>Links to Glossary Entries</h3> +<!--l. 6980--><p class="noindent" >The text which appears at the point in the document when using any of the commands described in +<a +href="#sec:gls-like">§<span +class="cmbx-10">??</span>sec:gls-like </a><a href="#sec:gls-like">The <span class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a> or <a -href="#sec:glstext-like">§6.2 </a><a +href="#sec:glstext-like">§<span +class="cmbx-10">??</span>sec:glstext-like </a><a href="#sec:glstext-like">The <span class="cmtt-10">\glstext</span>-Like -Commands (First Use Flag Not Queried)<!--tex4ht:ref: sec:glstext-like --></a>. The text which appears at that point in the document when using -one of these commands is referred to as the <a +Commands (First Use Flag Not Queried)<!--tex4ht:ref: sec:glstext-like --></a> is referred to as the <a href="#glo:linktext">link text<a - id="dx1-132003"></a></a> (even if there are no hyperlinks). These commands also -add a line to an external file that is used to generate the relevant entry in the glossary. This information -includes an associated location that is added to the <a + id="dx1-129001"></a></a> (even if there are no hyperlinks). These +commands also add a line to an external file that is used to generate the relevant entry in the glossary. This +information includes an associated location that is added to the <a href="#glo:numberlist">number list<a - id="dx1-132004"></a></a> for that entry. By default, the location refers to -the page number. For further information on number lists, see <a -href="#sec:numberlists">§5 </a><a -href="#sec:numberlists">Number lists<!--tex4ht:ref: sec:numberlists --></a>. These external files need to be -post-processed by <a + id="dx1-129002"></a></a> for that entry. By default, the +location refers to the page number. For further information on number lists, see <a +href="#sec:numberlists">§<span +class="cmbx-10">??</span>sec:numberlists </a><a +href="#sec:numberlists">Number +Lists<!--tex4ht:ref: sec:numberlists --></a>. These external files need to be post-processed by <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-132005"></a></a> or <a + id="dx1-129003"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-132006"></a></a> unless you have chosen Options <a -href="#option1">1</a> or <a -href="#option4">4</a>. If you don’t use -<span + id="dx1-129004"></a></a> unless you have chosen Options <a +href="#option1">1</a> +or <a +href="#option4">4</a>. If you don’t use <span class="cmtt-10">\makeglossaries</span><a - id="dx1-132007"></a> these external files won’t be created. (Options <a + id="dx1-129005"></a> these external files won’t be created. (Options <a href="#option1">1</a> and <a -href="#option4">4</a> write the information to the <span +href="#option4">4</a> write the +information to the <span class="cmtt-10">aux</span><a - id="dx1-132008"></a> -file.) -</p><!--l. 7216--><p class="indent" > Note that repeated use of these commands for the same entry can cause the <a + id="dx1-129006"></a> file.) +</p><!--l. 6994--><p class="indent" > Note that repeated use of these commands for the same entry can cause the <a href="#glo:numberlist">number list<a - id="dx1-132009"></a></a> to become quite + id="dx1-129007"></a></a> to become quite long, which may not be particular helpful to the reader. In this case, you can use the non-indexing commands described in <a -href="#sec:glsnolink">§9 </a><a -href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a> or you can use the supplemental <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a +href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a> or you can use the supplemental +<a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> -package, which provides a means to suppress the automated indexing of the commands listed in this -chapter. -</p><!--l. 7224--><p class="indent" > <div class="important" title="Important Note"> I strongly recommend that you don’t use the commands defined in this chapter in the arguments of +class="cmss-10">glossaries-extra</span></a> package, which provides a means to suppress the automated indexing of the commands listed in + + +this chapter. +</p><!--l. 7002--><p class="indent" > <div class="important" title="Important Note"> I strongly recommend that you don’t use the commands defined in this chapter in the arguments of sectioning or caption commands or any other command that has a moving argument. -</p><!--l. 7229--><p class="indent" > Aside from problems with expansion issues, PDF bookmarks and possible nested hyperlinks in the table of +</p><!--l. 7007--><p class="indent" > Aside from problems with expansion issues, PDF bookmarks and possible nested hyperlinks in the table of contents (or list of whatever) any use of the commands described in <a -href="#sec:gls-like">§6.1 </a><a +href="#sec:gls-like">§<span +class="cmbx-10">??</span>sec:gls-like </a><a href="#sec:gls-like">The <span -class="cmtt-10">\gls</span>-Like Commands (First Use -Flag Queried)<!--tex4ht:ref: sec:gls-like --></a> will have their <a -href="#glo:firstuseflag">first use flag</a> unset when they appear in the table of contents (or list of whatever). -</div> -</p><!--l. 7234--><p class="noindent" > -</p><!--l. 7236--><p class="indent" > The above warning is particularly important if you are using the <span +class="cmtt-10">\gls</span>-Like Commands +(First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a> will have their <a +href="#glo:firstuseflag">first use flag</a> unset when they appear in the table of contents (or list of +whatever). </div> +</p><!--l. 7012--><p class="noindent" > +</p><!--l. 7014--><p class="indent" > The above warning is particularly important if you are using the <span class="cmss-10">glossaries </span>package in conjunction with the <span class="cmss-10">hyperref</span><a - id="dx1-132010"></a> package. Instead, use one of the <span + id="dx1-129008"></a> package. Instead, use one of the <span class="cmti-10">expandable </span>commands listed in <a -href="#sec:glsnolink">§9 </a><a -href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a> -(such as <span +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a +href="#sec:glsnolink">Using Glossary Terms +Without Links<!--tex4ht:ref: sec:glsnolink --></a> (such as <span class="cmtt-10">\glsentrytext</span><a - id="dx1-132011"></a> <span -class="cmti-10">but not </span>the non-expandable case changing versions like <span + id="dx1-129009"></a> <span +class="cmti-10">but not </span>the non-expandable case changing versions like +<span class="cmtt-10">\Glsentrytext</span><a - id="dx1-132012"></a>). Alternatively, -provide an alternative via the optional argument to the sectioning/caption command or use <span + id="dx1-129010"></a>). Alternatively, provide an alternative via the optional argument to the sectioning/caption +command or use <span class="cmss-10">hyperref</span><a - id="dx1-132013"></a>’s -<span + id="dx1-129011"></a>’s <span class="cmtt-10">\texorpdfstring</span><a - id="dx1-132014"></a>. Examples: + id="dx1-129012"></a>. Examples: </p> - <div class="verbatim" id="verbatim-201"> + <pre class="verbatim" id="verbatim-183"> \chapter{An overview of \glsentrytext{perl}} - <br />\chapter[An overview of Perl]{An overview of \gls{perl}} - <br />\chapter{An overview of \texorpdfstring{\gls{perl}}{Perl}} -</div> -<!--l. 7248--><p class="nopar" > If you want to retain the formatting that’s available through commands like <span -class="cmtt-10">\acrshort </span>(for example, if you are -using one of the small caps styles), then you might want to consider the <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package which provides -commands for this purpose. -</p><!--l. 7255--><p class="indent" > If you want the <a +\chapter[An overview of Perl]{An overview of \gls{perl}} +\chapter{An overview of \texorpdfstring{\gls{perl}}{Perl}} +</pre> +<!--l. 7026--><p class="nopar" > +</p><!--l. 7027--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you want to retain the formatting that’s available through commands like <span +class="cmtt-10">\acrshort </span>(for example, if you +are using one of the small caps styles), then you might want to consider the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> package which +provides commands for this purpose. </div> +</p><!--l. 7033--><p class="noindent" > +</p><!--l. 7035--><p class="indent" > If you want the <a href="#glo:linktext">link text<a - id="dx1-132015"></a></a> to produce a hyperlink to the corresponding entry details in the glossary, you + id="dx1-129013"></a></a> to produce a hyperlink to the corresponding entry details in the glossary, you should load the <span class="cmss-10">hyperref</span><a - id="dx1-132016"></a> package <span + id="dx1-129014"></a> package <span class="cmti-10">before </span>the <span class="cmss-10">glossaries </span>package. That’s what I’ve done in this document, so if you see a hyperlinked term, such as <a href="#glo:linktext">link text<a - id="dx1-132017"></a></a>, you can click on the word or phrase and it will take you to a brief + id="dx1-129015"></a></a>, you can click on the word or phrase and it will take you to a brief description in this document’s glossary. -</p><!--l. 7263--><p class="indent" > <div class="important" title="Important Note"> If you use the <span +</p><!--l. 7043--><p class="indent" > <div class="important" title="Important Note"> If you use the <span class="cmss-10">hyperref</span><a - id="dx1-132018"></a> package, I strongly recommend you use <span + id="dx1-129016"></a> package, I strongly recommend you use <span class="cmtt-10">pdflatex</span><a - id="dx1-132019"></a> rather than <span + id="dx1-129017"></a> rather than <span class="cmtt-10">latex</span><a - id="dx1-132020"></a> to compile your + id="dx1-129018"></a> to compile your 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 @@ -15142,52 +15053,56 @@ acronym) won’t be able to break across a line with the DVI format. Secondl 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 size. -</p><!--l. 7277--><p class="indent" > These are limitations of the DVI format not of the <span +</p><!--l. 7057--><p class="indent" > These are limitations of the DVI format not of the <span class="cmss-10">glossaries</span><a - id="dx1-132021"></a> package. </div> -</p><!--l. 7279--><p class="noindent" > -</p><!--l. 7281--><p class="indent" > It may be that you only want terms in certain glossaries to have hyperlinks, but not for other glossaries. In -this case, you can use the package option <span + id="dx1-129019"></a> package. </div> +</p><!--l. 7059--><p class="noindent" > +</p><!--l. 7061--><p class="indent" > It may be that you only want terms in certain glossaries to have hyperlinks, but not for other +glossaries. In this case, you can use the package option <span class="cmss-10">nohypertypes</span><a - id="dx1-132022"></a> to identify the glossary lists that shouldn’t have -hyperlinked <a + id="dx1-129020"></a> to identify the glossary lists +that shouldn’t have hyperlinked <a href="#glo:linktext">link text<a - id="dx1-132023"></a></a>. See <a -href="#sec:pkgopts-general">§2.1 </a><a -href="#sec:pkgopts-general">General Options<!--tex4ht:ref: sec:pkgopts-general --></a> for further details. -</p><!--l. 7287--><p class="indent" > The way the <a + id="dx1-129021"></a></a>. See <a +href="#sec:pkgopts-general">§<span +class="cmbx-10">??</span>sec:pkgopts-general </a><a +href="#sec:pkgopts-general">General Options<!--tex4ht:ref: sec:pkgopts-general --></a> for further +details. +</p><!--l. 7067--><p class="indent" > The way the <a href="#glo:linktext">link text<a - id="dx1-132024"></a></a> is displayed depends on -</p><!--l. 7288--><p class="indent" > <hr><div title="Definition"><a - id="dx1-132025"></a> <span + id="dx1-129022"></a></a> is displayed depends on +</p><!--l. 7068--><p class="indent" > <hr><div title="Definition"><a + id="dx1-129023"></a> <span class="cmtt-10">\glstextformat{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 7290--><p class="noindent" > +</p><!--l. 7070--><p class="noindent" > For example, to make all <a href="#glo:linktext">link text<a - id="dx1-132026"></a></a> appear in a sans-serif font, do: + id="dx1-129024"></a></a> appear in a sans-serif font, do: </p> - <div class="verbatim" id="verbatim-202"> + <pre class="verbatim" id="verbatim-184"> \renewcommand*{\glstextformat}[1]{\textsf{#1}} -</div> -<!--l. 7295--><p class="nopar" > Further customisation can be done via <span +</pre> +<!--l. 7075--><p class="nopar" > Further customisation can be done via <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-132027"></a> or by redefining <span + id="dx1-129025"></a> or by redefining <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-132028"></a>. See <a -href="#sec:glsdisplay">§6.3 </a><a -href="#sec:glsdisplay">Changing the -format of the link text<!--tex4ht:ref: sec:glsdisplay --></a> for further details. -</p><!--l. 7300--><p class="indent" > Each entry has an associated conditional referred to as the <a + id="dx1-129026"></a>. See <a +href="#sec:glsdisplay">§<span +class="cmbx-10">??</span>sec:glsdisplay +</a><a +href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a> for further details. +</p><!--l. 7080--><p class="indent" > Each entry has an associated conditional referred to as the <a href="#glo:firstuseflag">first use flag</a>. Some of the commands described in -this chapter automatically unset this flag and can also use it to determine what text should be displayed. -These types of commands are the <a +this chapter automatically unset this flag and can also use it to determine what text should be displayed. These +types of commands are the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands and are described in <a -href="#sec:gls-like">§6.1 </a><a +href="#sec:gls-like">§<span +class="cmbx-10">??</span>sec:gls-like </a><a href="#sec:gls-like">The <span class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a>. The commands that don’t reference or change the <a @@ -15195,16 +15110,18 @@ href="#glo:firstuseflag">first use flag</a> are <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands and are described in <a -href="#sec:glstext-like">§6.2 </a><a +href="#sec:glstext-like">§<span +class="cmbx-10">??</span>sec:glstext-like </a><a href="#sec:glstext-like">The <span -class="cmtt-10">\glstext</span>-Like Commands (First Use Flag Not -Queried)<!--tex4ht:ref: sec:glstext-like --></a>. See <a -href="#sec:glsunset">§14 </a><a -href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a> for commands that unset (mark the entry as -having been used) or reset (mark the entry as not used) the <a +class="cmtt-10">\glstext</span>-Like Commands (First Use Flag +Not Queried)<!--tex4ht:ref: sec:glstext-like --></a>. See <a +href="#sec:glsunset">§<span +class="cmbx-10">??</span>sec:glsunset </a><a +href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a> for commands that unset (mark the +entry as having been used) or reset (mark the entry as not used) the <a href="#glo:firstuseflag">first use flag</a> without referencing the entries. -</p><!--l. 7312--><p class="indent" > The <a +</p><!--l. 7092--><p class="indent" > The <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> and <a href="#sec:glstext-like"><span @@ -15225,15 +15142,15 @@ class="cmtt-10">\gls{sample}</span></span></span> will use the default hyperlink on a number of factors (such as whether the entry is in a glossary that has been identified in the <span class="cmss-10">nohypertypes</span><a - id="dx1-132029"></a> list). You can override the <span + id="dx1-129027"></a> list). You can override the <span class="cmtt-10">hyper</span><a - id="dx1-132030"></a> key in the variant’s optional argument, for example, + id="dx1-129028"></a> key in the variant’s optional argument, for example, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls*[hyper=true]{sample}</span></span></span> but this creates redundancy and is best avoided. The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides the option to add a third custom variant. -</p><!--l. 7329--><p class="indent" > <div class="important" title="Important Note"> Avoid nesting these commands. For example don’t do <span +</p><!--l. 7109--><p class="indent" > <div class="important" title="Important Note"> Avoid nesting these commands. For example don’t do <span class="cmtt-10">\glslink{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span><span @@ -15245,29 +15162,31 @@ class="cmsy-10">} </span>as this is likely to cause problems. By implication, this means that you should avoid using any of these commands within the <span class="cmtt-10">text</span><a - id="dx1-132031"></a>, <span + id="dx1-129029"></a>, <span class="cmtt-10">first</span><a - id="dx1-132032"></a>, <span + id="dx1-129030"></a>, <span class="cmtt-10">short</span><a - id="dx1-132033"></a> or <span + id="dx1-129031"></a> or <span class="cmtt-10">long</span><a - id="dx1-132034"></a> keys (or their plural equivalent) or any other key that you plan to + id="dx1-129032"></a> keys (or their plural equivalent) or any other key that you plan to access through these commands. (For example, the <span class="cmtt-10">symbol</span><a - id="dx1-132035"></a> key if you intend to use <span + id="dx1-129033"></a> key if you intend to use <span class="cmtt-10">\glssymbol</span>.) </div> -</p><!--l. 7339--><p class="noindent" > -</p><!--l. 7341--><p class="indent" > The keys listed below are available for the optional argument. The <a +</p><!--l. 7119--><p class="noindent" > +</p><!--l. 7121--><p class="indent" > The keys listed below are available for the optional first argument. The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides additional keys. (See the <span class="cmss-10">glossaries-extra </span>manual for further details.) </p><dl class="description"><dt class="description"> + <!--l. 7125--><p class="noindent" > <span class="cmtt-10">hyper</span><a - id="dx1-132036"></a> </dt><dd -class="description">This is a boolean key which can be used to enable/disable the hyperlink to the relevant entry in + id="dx1-129034"></a> </p></dt><dd +class="description"> + <!--l. 7125--><p class="noindent" >This is a boolean key which can be used to enable/disable the hyperlink to the relevant entry in the glossary. If this key is omitted, the value is determined by current settings, as indicated above. For example, when used with a <a href="#sec:gls-like"><span @@ -15275,44 +15194,46 @@ class="cmtt-10">\gls</span>-like</a> command, if this is the first use an class="cmss-10">hyperfirst</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-132037"></a> + id="dx1-129035"></a> package option has been used, then the default value is <span class="cmtt-10">hyper=false</span>. The hyperlink can be forced on using <span class="cmtt-10">hyper=true </span>unless the hyperlinks have been suppressed using <span class="cmtt-10">\glsdisablehyper</span><a - id="dx1-132038"></a>. You + id="dx1-129036"></a>. You must load the <span class="cmss-10">hyperref</span><a - id="dx1-132039"></a> package before the <span + id="dx1-129037"></a> package before the <span class="cmss-10">glossaries</span><a - id="dx1-132040"></a> package to ensure the hyperlinks work. - </dd><dt class="description"> + id="dx1-129038"></a> package to ensure the hyperlinks work. + </p></dd><dt class="description"> + + + <!--l. 7136--><p class="noindent" > <span class="cmtt-10">format</span><a - id="dx1-132041"></a> </dt><dd -class="description">This specifies how to format the associated location number for this entry in the glossary. This value is + id="dx1-129039"></a> </p></dt><dd +class="description"> + <!--l. 7136--><p class="noindent" >This specifies how to format the associated location number for this entry in the glossary. This value is equivalent to the <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-132042"></a></a> encap value, and (as with <span + id="dx1-129040"></a></a> encap value, and (as with <span class="cmtt-10">\index</span><a - id="dx1-132043"></a>) the value needs to be the name of a + id="dx1-129041"></a>) the value needs to be the name of a command <span class="cmti-10">without </span>the initial backslash. As with <span class="cmtt-10">\index</span><a - id="dx1-132044"></a>, the characters <span class="obeylines-h"><span class="verb"><span + id="dx1-129042"></a>, the characters <span class="obeylines-h"><span class="verb"><span class="cmtt-10">(</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="cmtt-10">)</span></span></span> can also be used to specify the beginning and ending of a number range and they must be in matching pairs. (For example, - - <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls[format={(}]{sample}</span></span></span> on one page to start the range and later <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls[format={)}]{sample}</span></span></span> to close the range.) Again as with <span class="cmtt-10">\index</span><a - id="dx1-132045"></a>, the command should be the name of a command + id="dx1-129043"></a>, the command should be the name of a command which takes an argument (which will be the associated location). Be careful not to use a declaration (such as <span class="cmtt-10">bfseries</span>) instead of a text block command (such as <span @@ -15324,149 +15245,153 @@ class="cmti-10">italic</span>) you will need to create a command that applies bo e.g.  - <div class="verbatim" id="verbatim-203"> +</p> + <pre class="verbatim" id="verbatim-185"> \newcommand*{\textbfem}[1]{\textbf{\emph{#1}}} -</div> - <!--l. 7375--><p class="nopar" > and use that command. - </p><!--l. 7378--><p class="noindent" >In this document, the standard formats refer to the standard text block commands such as <span +</pre> + <!--l. 7155--><p class="nopar" > and use that command. + </p><!--l. 7158--><p class="noindent" >In this document, the standard formats refer to the standard text block commands such as <span class="cmtt-10">\textbf</span><a - id="dx1-132046"></a> or + id="dx1-129044"></a> or <span class="cmtt-10">\emph</span><a - id="dx1-132047"></a> or any of the commands listed in <a -href="#tab:hyperxx">table 6.1</a>. You can combine a range and format using <span class="obeylines-h"><span class="verb"><span + id="dx1-129045"></a> or any of the commands listed in <a +href="#tab:hyperxx">table <span +class="cmbx-10">??</span>tab:hyperxx</a>. You can combine a range and format using + <span class="obeylines-h"><span class="verb"><span class="cmtt-10">(</span></span></span>⟨<span -class="cmti-10">format</span>⟩ to - start the range and <span class="obeylines-h"><span class="verb"><span +class="cmti-10">format</span>⟩ to start the range and <span class="obeylines-h"><span class="verb"><span class="cmtt-10">)</span></span></span>⟨<span class="cmti-10">format</span>⟩ to end the range. The ⟨<span class="cmti-10">format</span>⟩ part must match. For example, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">format={(emph}</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="cmtt-10">format={)emph}</span></span></span>. - </p><!--l. 7385--><p class="noindent" ><div class="important" title="Important Note"> If you use <a + </p><!--l. 7165--><p class="noindent" ><div class="important" title="Important Note"> If you use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-132048"></a></a> instead of <a + id="dx1-129046"></a></a> instead of <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-132049"></a></a>, you must specify any non-standard formats that you want to use + id="dx1-129047"></a></a>, you must specify any non-standard formats that you want to use with the <span class="cmtt-10">format</span><a - id="dx1-132050"></a> key using <span + id="dx1-129048"></a> key using <span class="cmtt-10">\GlsAddXdyAttribute</span><a - id="dx1-132051"></a><span + id="dx1-129049"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">name</span>⟩<span class="cmtt-10">}</span>. So if you use <span class="cmtt-10">xindy</span><a - id="dx1-132052"></a> with the above example, + id="dx1-129050"></a> with the above example, you would need to add: </p> - <div class="verbatim" id="verbatim-204"> + <pre class="verbatim" id="verbatim-186"> \GlsAddXdyAttribute{textbfem} -</div> - <!--l. 7393--><p class="nopar" > See <a -href="#sec:xindy">§11 </a><a +</pre> + <!--l. 7173--><p class="nopar" > See <a +href="#sec:xindy">§<span +class="cmbx-10">??</span>sec:xindy </a><a href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a> for further details. </div> - </p><!--l. 7395--><p class="noindent" > - </p><!--l. 7397--><p class="noindent" >If you are using hyperlinks and you want to change the font of the hyperlinked location, don’t use + </p><!--l. 7175--><p class="noindent" > + </p><!--l. 7177--><p class="noindent" >If you are using hyperlinks and you want to change the font of the hyperlinked location, don’t use <span class="cmtt-10">\hyperpage</span><a - id="dx1-132053"></a> (provided by the <span + id="dx1-129051"></a> (provided by the <span class="cmss-10">hyperref</span><a - id="dx1-132054"></a> package) as the locations may not refer to a page number. Instead, + id="dx1-129052"></a> package) as the locations may not refer to a page number. Instead, the <span class="cmss-10">glossaries </span>package provides number formats listed in <a -href="#tab:hyperxx">table 6.1</a>. These commands are designed to work - with the particular location formats created by <a +href="#tab:hyperxx">table <span +class="cmbx-10">??</span>tab:hyperxx</a>. These commands are + designed to work with the particular location formats created by <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-132055"></a></a> and <a + id="dx1-129053"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-132056"></a></a> and shouldn’t be used in other - contexts. + id="dx1-129054"></a></a> and shouldn’t be + used in other contexts. </p> <div class="table"> - <!--l. 7406--><p class="noindent" ><a + <!--l. 7186--><p class="noindent" ><a id="tab:hyperxx"></a></p><hr class="float" /><div class="float" > <div class="caption" -><span class="id">Table 6.1: </span><span -class="content">Predefined Hyperlinked Location Formats</span></div><!--tex4ht:label?: x1-1320571 --> +><span class="id">Table 5.1: </span><span +class="content">Predefined Hyperlinked Location Formats</span></div><!--tex4ht:label?: x1-1290551 --> <div class="tabular"> <table id="TBL-6" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-6-1g"><col id="TBL-6-1" /><col id="TBL-6-2" /></colgroup><tr style="vertical-align:baseline;" id="TBL-6-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-1" class="td11"> <span class="cmtt-10">hyperrm</span><a - id="dx1-132058"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-2" + id="dx1-129056"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-2" class="td11"> serif hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-1" class="td11"> <span class="cmtt-10">hypersf</span><a - id="dx1-132059"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-2" + id="dx1-129057"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-2" class="td11"> sans-serif hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-1" class="td11"> <span class="cmtt-10">hypertt</span><a - id="dx1-132060"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-2" + id="dx1-129058"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-2" class="td11"> monospaced hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-1" class="td11"> <span class="cmtt-10">hyperbf</span><a - id="dx1-132061"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-2" + id="dx1-129059"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-2" class="td11"> bold hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-1" class="td11"> <span class="cmtt-10">hypermd</span><a - id="dx1-132062"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-2" + id="dx1-129060"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-2" class="td11"> medium weight hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-1" class="td11"> <span class="cmtt-10">hyperit</span><a - id="dx1-132063"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-2" + id="dx1-129061"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-2" class="td11"> italic hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-1" class="td11"> <span class="cmtt-10">hypersl</span><a - id="dx1-132064"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-2" + id="dx1-129062"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-2" class="td11"> slanted hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-1" class="td11"> <span class="cmtt-10">hyperup</span><a - id="dx1-132065"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-2" + id="dx1-129063"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-2" class="td11"> upright hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-1" class="td11"> <span class="cmtt-10">hypersc</span><a - id="dx1-132066"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-2" + id="dx1-129064"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-2" class="td11"> small caps hyperlink </td> </tr><tr style="vertical-align:baseline;" id="TBL-6-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-1" class="td11"> <span class="cmtt-10">hyperemph</span><a - id="dx1-132067"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-2" + id="dx1-129065"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-2" class="td11"> emphasized hyperlink </td></tr></table> </div> </div><hr class="endfloat" /> </div> - <!--l. 7426--><p class="noindent" >Note that if the <span + <!--l. 7206--><p class="noindent" >Note that if the <span class="cmtt-10">\hyperlink</span><a - id="dx1-132068"></a> command hasn’t been defined, the <span + id="dx1-129066"></a> command hasn’t been defined, the <span class="cmtt-10">hyper</span>⟨<span class="cmti-10">xx</span>⟩ formats are equivalent to the analogous <span @@ -15478,59 +15403,64 @@ class="cmtt-10">emph</span>). If you want to make a new want the location number to be in a bold sans-serif font, you can define a command called, say, <span class="cmtt-10">\hyperbsf</span><a - id="dx1-132069"></a>: + id="dx1-129067"></a>: </p> - <div class="verbatim" id="verbatim-205"> + <pre class="verbatim" id="verbatim-187"> \newcommand{\hyperbsf}[1]{\textbf{\hypersf{#1}}} -</div> - <!--l. 7436--><p class="nopar" > and then use <span +</pre> + <!--l. 7216--><p class="nopar" > and then use <span class="cmtt-10">hyperbsf </span>as the value for the <span class="cmtt-10">format</span><a - id="dx1-132070"></a> + id="dx1-129068"></a> key.<span class="footnote-mark"><a -href="#fn1x6" id="fn1x6-bk"><sup class="textsuperscript">6.1</sup></a></span><a - id="x1-132071f1"></a> - </p><!--l. 7442--><p class="noindent" ><div class="important" title="Important Note"> When defining a custom location format command that uses one of the <span +href="#fn1x5" id="fn1x5-bk"><sup class="textsuperscript">5.1</sup></a></span><a + id="x1-129069f1"></a> + </p><!--l. 7222--><p class="noindent" ><div class="important" title="Important Note"> When defining a custom location format command that uses one of the <span class="cmtt-10">\hyper</span>⟨<span class="cmitt-10">xx</span>⟩<a - id="dx1-132072"></a> commands, make sure + id="dx1-129070"></a> commands, make sure that the argument of <span class="cmtt-10">\hyper</span>⟨<span class="cmitt-10">xx</span>⟩<a - id="dx1-132073"></a> is just the location. Any formatting must be outside of <span + id="dx1-129071"></a> is just the location. Any formatting must be outside of <span class="cmtt-10">\hyper</span>⟨<span class="cmitt-10">xx</span>⟩<a - id="dx1-132074"></a> (as in + id="dx1-129072"></a> (as in the above <span class="cmtt-10">\hyperbfsf </span>example). </div> - </p><!--l. 7448--><p class="noindent" > - </p><!--l. 7450--><p class="noindent" >Remember that if you use <a + </p><!--l. 7228--><p class="noindent" > + </p><!--l. 7230--><p class="noindent" >Remember that if you use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-132075"></a></a>, you will need to add this to the list of location <a - id="dx1-132076"></a>attributes: + id="dx1-129073"></a></a>, you will need to add this to the list of location <a + id="dx1-129074"></a>attributes: </p> - <div class="verbatim" id="verbatim-206"> + <pre class="verbatim" id="verbatim-188"> \GlsAddXdyAttribute{hyperbsf} -</div> - <!--l. 7454--><p class="nopar" > +</pre> + <!--l. 7234--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 7236--><p class="noindent" > <span class="cmtt-10">counter</span><a - id="dx1-132077"></a> </dt><dd -class="description">This specifies which counter to use for this location. This overrides the default counter used by this - entry. (See also <a -href="#sec:numberlists">§5 </a><a -href="#sec:numberlists">Number lists<!--tex4ht:ref: sec:numberlists --></a>.) - </dd><dt class="description"> + id="dx1-129075"></a> </p></dt><dd +class="description"> + <!--l. 7236--><p class="noindent" >This specifies which counter to use for this location. This overrides the default counter used by this entry. + (See also <a +href="#sec:numberlists">§<span +class="cmbx-10">??</span>sec:numberlists </a><a +href="#sec:numberlists">Number Lists<!--tex4ht:ref: sec:numberlists --></a>.) + </p></dd><dt class="description"> + <!--l. 7240--><p class="noindent" > <span class="cmtt-10">local</span><a - id="dx1-132078"></a> </dt><dd -class="description">This is a boolean key that only makes a difference when used with <a + id="dx1-129076"></a> </p></dt><dd +class="description"> + <!--l. 7240--><p class="noindent" >This is a boolean key that only makes a difference when used with <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands that change the entry’s <a @@ -15538,87 +15468,103 @@ href="#glo:firstuseflag">first use flag</a>. If <span class="cmtt-10">local=true</span>, the change to the first use flag will be localised to the current scope. The default is <span class="cmtt-10">local=false</span>. - </dd><dt class="description"> -<span id="textcolor262"><span id="textcolor263"><span + </p></dd><dt class="description"> + <!--l. 7246--><p class="noindent" > +<span id="textcolor272"><span id="textcolor273"><span class="cmtt-10">noindex</span></span><a - id="dx1-132079"></a></span> </dt><dd -class="description">This is a boolean key that suppresses the indexing. Only available with <a + id="dx1-129077"></a></span> </p></dt><dd +class="description"> + <!--l. 7246--><p class="noindent" >This is a boolean key that suppresses the indexing. Only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. - </dd><dt class="description"> -<span id="textcolor264"><span id="textcolor265"><span + </p></dd><dt class="description"> + <!--l. 7249--><p class="noindent" > +<span id="textcolor274"><span id="textcolor275"><span class="cmtt-10">hyperoutside</span></span><a - id="dx1-132080"></a></span> </dt><dd -class="description">This is a boolean key that determines whether to put the hyperlink outside of <span + id="dx1-129078"></a></span> </p></dt><dd +class="description"> + <!--l. 7249--><p class="noindent" >This is a boolean key that determines whether to put the hyperlink outside of <span class="cmtt-10">\glstextformat</span><a - id="dx1-132081"></a>. - Only available with <a + id="dx1-129079"></a>. Only + available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. - </dd><dt class="description"> -<span id="textcolor266"><span id="textcolor267"><span + </p></dd><dt class="description"> + <!--l. 7253--><p class="noindent" > +<span id="textcolor276"><span id="textcolor277"><span class="cmtt-10">wrgloss</span></span><a - id="dx1-132082"></a></span> </dt><dd -class="description">This key determines whether to index before (<span + id="dx1-129080"></a></span> </p></dt><dd +class="description"> + <!--l. 7253--><p class="noindent" >This key determines whether to index before (<span class="cmtt-10">wrgloss=before</span>) or after (<span class="cmtt-10">wrgloss=after</span>) the <a -href="#glo:linktext">link - text<a - id="dx1-132083"></a></a>. Only available with <a +href="#glo:linktext">link text<a + id="dx1-129081"></a></a>. + Only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. - </dd><dt class="description"> -<span id="textcolor268"><span id="textcolor269"><span + </p></dd><dt class="description"> + <!--l. 7258--><p class="noindent" > +<span id="textcolor278"><span id="textcolor279"><span class="cmtt-10">textformat</span></span><a - id="dx1-132084"></a></span> </dt><dd -class="description">This key identifies the name of the control sequence to encapsulate the <a + id="dx1-129082"></a></span> </p></dt><dd +class="description"> + <!--l. 7258--><p class="noindent" >This key identifies the name of the control sequence to encapsulate the <a href="#glo:linktext">link text<a - id="dx1-132085"></a></a> instead of the - default <span + id="dx1-129083"></a></a> instead of the default + <span class="cmtt-10">\glstextformat</span><a - id="dx1-132086"></a>. Only available with <a + id="dx1-129084"></a>. Only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. - </dd><dt class="description"> -<span id="textcolor270"><span id="textcolor271"><span + + + </p></dd><dt class="description"> + <!--l. 7263--><p class="noindent" > +<span id="textcolor280"><span id="textcolor281"><span class="cmtt-10">prefix</span></span><a - id="dx1-132087"></a></span> </dt><dd -class="description">This key locally redefines <span + id="dx1-129085"></a></span> </p></dt><dd +class="description"> + <!--l. 7263--><p class="noindent" >This key locally redefines <span class="cmtt-10">\glolinkprefix</span><a - id="dx1-132088"></a> to the given value. Only available with <a + id="dx1-129086"></a> to the given value. Only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. - </dd><dt class="description"> -<span id="textcolor272"><span id="textcolor273"><span + </p></dd><dt class="description"> + <!--l. 7267--><p class="noindent" > +<span id="textcolor282"><span id="textcolor283"><span class="cmtt-10">thevalue</span></span><a - id="dx1-132089"></a></span> </dt><dd -class="description">This key explicitly sets the location. Only available with <a + id="dx1-129087"></a></span> </p></dt><dd +class="description"> + <!--l. 7267--><p class="noindent" >This key explicitly sets the location. Only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. - </dd><dt class="description"> -<span id="textcolor274"><span id="textcolor275"><span + </p></dd><dt class="description"> + <!--l. 7271--><p class="noindent" > +<span id="textcolor284"><span id="textcolor285"><span class="cmtt-10">theHvalue</span></span><a - id="dx1-132090"></a></span> </dt><dd -class="description">This key explicitly sets the hyperlink location. Only available with <a + id="dx1-129088"></a></span> </p></dt><dd +class="description"> + <!--l. 7271--><p class="noindent" >This key explicitly sets the hyperlink location. Only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. +</p> </dd></dl> -<!--l. 7497--><p class="indent" > <div class="important" title="Important Note"> The <a +<!--l. 7277--><p class="indent" > <div class="important" title="Important Note"> The <a href="#glo:linktext">link text<a - id="dx1-132091"></a></a> isn’t scoped by default with just the base <span + id="dx1-129089"></a></a> isn’t scoped by default with just the base <span class="cmss-10">glossaries </span>package. Any unscoped declarations in the <a href="#glo:linktext">link text<a - id="dx1-132092"></a></a> may affect subsequent text. </div> -</p><!--l. 7501--><p class="noindent" > + id="dx1-129090"></a></a> may affect subsequent text. </div> +</p><!--l. 7281--><p class="noindent" > +</p><!--l. 7283--><p class="noindent" > </p> - - -<!--l. 7503--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.1 </span> <a +<!--l. 7283--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">5.1.1 </span> <a id="sec:gls-like"></a>The <span -class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)</h3> -<!--l. 7506--><p class="noindent" >This section describes the commands that unset (mark as used) the <a +class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)</h4> +<!--l. 7286--><p class="noindent" >This section describes the commands that unset (mark as used) the <a href="#glo:firstuseflag">first use flag</a> on completion, and in most cases they use the current state of the flag to determine the text to be displayed. As described above, these commands all have a star-variant (<span @@ -15628,20 +15574,21 @@ argument that is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ list. These commands use <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-133001"></a> or the equivalent definition provided by + id="dx1-130001"></a> or the equivalent definition provided by <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-133002"></a> to determine the automatically generated text and its format (see <a -href="#sec:glsdisplay">§6.3 </a><a -href="#sec:glsdisplay">Changing the format of -the link text<!--tex4ht:ref: sec:glsdisplay --></a>). -</p><!--l. 7516--><p class="indent" > Apart from <span + id="dx1-130002"></a> to determine the automatically generated text and its format (see <a +href="#sec:glsdisplay">§<span +class="cmbx-10">??</span>sec:glsdisplay </a><a +href="#sec:glsdisplay">Changing +the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>). +</p><!--l. 7296--><p class="indent" > Apart from <span class="cmtt-10">\glsdisp</span><a - id="dx1-133003"></a>, the commands described in this section also have a <span + id="dx1-130003"></a>, the commands described in this section also have a <span class="cmti-10">final </span>optional argument ⟨<span class="cmti-10">insert</span>⟩ which may be used to insert material into the automatically generated text. -</p><!--l. 7520--><p class="indent" > <div class="important" title="Important Note"> Since the commands have a final optional argument, take care if you actually want to display an open +</p><!--l. 7300--><p class="indent" > <div class="important" title="Important Note"> Since the commands have a final optional argument, take care if you actually want to display an open square bracket after the command when the final optional argument is absent. Insert an empty set of braces <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{}</span></span></span> immediately before the opening square bracket to prevent it from being interpreted as the final argument. For @@ -15649,47 +15596,48 @@ example: </p> - <div class="verbatim" id="verbatim-207"> + <pre class="verbatim" id="verbatim-189"> \gls{sample} {}[Editor's comment] -</div> -<!--l. 7529--><p class="nopar" > -</p><!--l. 7531--><p class="indent" > Don’t use any of the <a +</pre> +<!--l. 7309--><p class="nopar" > +</p><!--l. 7311--><p class="indent" > Don’t use any of the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> or <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands in the ⟨<span class="cmti-10">insert</span>⟩ argument. </div> -</p><!--l. 7533--><p class="noindent" > -</p><!--l. 7535--><p class="indent" > Take care using these commands within commands or environments that are processed multiple times as this +</p><!--l. 7313--><p class="noindent" > +</p><!--l. 7315--><p class="indent" > Take care using these commands within commands or environments that are processed multiple times as this can confuse the first use flag query and state change. This includes frames with overlays in <span class="cmss-10">beamer</span><a - id="dx1-133004"></a> and the + id="dx1-130004"></a> and the <span class="cmss-10">tabularx </span>environment provided by <span class="cmss-10">tabularx</span><a - id="dx1-133005"></a>. The <span + id="dx1-130005"></a>. The <span class="cmss-10">glossaries </span>package automatically deals with this issue in <span class="cmss-10">amsmath</span><a - id="dx1-133006"></a>’s <span + id="dx1-130006"></a>’s <span class="cmss-10">align </span>environment. You can apply a patch to <span class="cmss-10">tabularx</span><a - id="dx1-133007"></a> by placing the following command (new to + id="dx1-130007"></a> by placing the following command (new to v4.28) in the preamble: -</p><!--l. 7543--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133008"></a> <span +</p><!--l. 7323--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130008"></a> <span class="cmtt-10">\glspatchtabularx </span></div><hr> -</p><!--l. 7545--><p class="noindent" > +</p><!--l. 7325--><p class="noindent" > This does nothing if <span class="cmss-10">tabularx</span><a - id="dx1-133009"></a> hasn’t been loaded. There’s no patch available for <span + id="dx1-130009"></a> hasn’t been loaded. There’s no patch available for <span class="cmss-10">beamer</span><a - id="dx1-133010"></a>. See <a -href="#sec:glsunset">§14 </a><a -href="#sec:glsunset">Unsetting and -Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a> for more details. -</p><!--l. 7550--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133011"></a> <span + id="dx1-130010"></a>. See <a +href="#sec:glsunset">§<span +class="cmbx-10">??</span>sec:glsunset +</a><a +href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a> for more details. +</p><!--l. 7330--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130011"></a> <span class="cmtt-10">\gls[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -15697,31 +15645,31 @@ 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. 7552--><p class="noindent" > +</p><!--l. 7332--><p class="noindent" > This command typically determines the <a href="#glo:linktext">link text<a - id="dx1-133012"></a></a> from the values of the <span + id="dx1-130012"></a></a> from the values of the <span class="cmtt-10">text</span><a - id="dx1-133013"></a> or <span + id="dx1-130013"></a> or <span class="cmtt-10">first</span><a - id="dx1-133014"></a> keys supplied when the + id="dx1-130014"></a> keys supplied when the entry was defined using <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-133015"></a>. However, if the entry was defined using <span + id="dx1-130015"></a>. However, if the entry was defined using <span class="cmtt-10">\newacronym</span><a - id="dx1-133016"></a> and + id="dx1-130016"></a> and <span class="cmtt-10">\setacronymstyle</span><a - id="dx1-133017"></a> was used, then the link text<a - id="dx1-133018"></a> will usually be determined from the <span + id="dx1-130017"></a> was used, then the link text<a + id="dx1-130018"></a> will usually be determined from the <span class="cmtt-10">long</span><a - id="dx1-133019"></a> or <span + id="dx1-130019"></a> or <span class="cmtt-10">short</span><a - id="dx1-133020"></a> + id="dx1-130020"></a> keys. -</p><!--l. 7560--><p class="indent" > There are two upper case variants: -</p><!--l. 7561--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133021"></a> <span +</p><!--l. 7340--><p class="indent" > There are two upper case variants: +</p><!--l. 7341--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130021"></a> <span class="cmtt-10">\Gls[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -15729,10 +15677,10 @@ 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. 7563--><p class="noindent" > +</p><!--l. 7343--><p class="noindent" > and -</p><!--l. 7565--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133022"></a> <span +</p><!--l. 7345--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130022"></a> <span class="cmtt-10">\GLS[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -15740,120 +15688,126 @@ 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. 7567--><p class="noindent" > +</p><!--l. 7347--><p class="noindent" > which make the first letter of the link text or all the link text upper case, respectively. For the former, the uppercasing of the first letter is performed by <span class="cmtt-10">\makefirstuc</span><a - id="dx1-133023"></a>. -</p><!--l. 7572--><p class="indent" > <div class="important" title="Important Note"> The first letter uppercasing command <span + id="dx1-130023"></a>. +</p><!--l. 7352--><p class="indent" > <div class="important" title="Important Note"> The first letter uppercasing command <span class="cmtt-10">\makefirstuc </span>has limitations which must be taken into account if you use <span class="cmtt-10">\Gls </span>or any of the other commands that convert the first letter to uppercase. </div> -</p><!--l. 7577--><p class="noindent" > +</p><!--l. 7357--><p class="noindent" > The upper casing is performed as follows: </p> <ul class="itemize1"> - <li class="itemize">If the first thing in the <a + <li class="itemize"> + <!--l. 7360--><p class="noindent" >If the first thing in the <a href="#glo:linktext">link text<a - id="dx1-133024"></a></a> is a command follow by a group, the upper casing is performed on the + id="dx1-130024"></a></a> is a command follow by a group, the upper casing is performed on the first object of the group. For example, if an entry has been defined as - <div class="verbatim" id="verbatim-208"> +</p> + <pre class="verbatim" id="verbatim-190"> \newglossaryentry{sample}{ -  <br /> name={\emph{sample} phrase}, -  <br /> sort={sample phrase}, -  <br /> description={an example}} -</div> - <!--l. 7588--><p class="nopar" > Then <span +  name={\emph{sample} phrase}, +  sort={sample phrase}, +  description={an example}} +</pre> + <!--l. 7368--><p class="nopar" > Then <span class="cmtt-10">\Gls</span><span class="obeylines-h"><span class="verb"><span class="cmtt-10">{sample}</span></span></span> will set the <a href="#glo:linktext">link text<a - id="dx1-133025"></a></a> to<span class="footnote-mark"><a -href="#fn2x6" id="fn2x6-bk"><sup class="textsuperscript">6.2</sup></a></span><a - id="x1-133026f2"></a> + id="dx1-130025"></a></a> to<span class="footnote-mark"><a +href="#fn2x5" id="fn2x5-bk"><sup class="textsuperscript">5.2</sup></a></span><a + id="x1-130026f2"></a> </p> - <div class="verbatim" id="verbatim-209"> + <pre class="verbatim" id="verbatim-191"> \emph{\MakeUppercase sample} phrase -</div> - <!--l. 7594--><p class="nopar" > which will appear as <span +</pre> + <!--l. 7374--><p class="nopar" > which will appear as <span class="cmti-10">Sample </span>phrase. </p></li> - <li class="itemize">If the first thing in the <a + <li class="itemize"> + <!--l. 7377--><p class="noindent" >If the first thing in the <a href="#glo:linktext">link text<a - id="dx1-133027"></a></a> isn’t a command or is a command but isn’t followed by a group, then the + id="dx1-130027"></a></a> isn’t a command or is a command but isn’t followed by a group, then the upper casing will be performed on that first thing. For example, if an entry has been defined as: - <div class="verbatim" id="verbatim-210"> +</p> + <pre class="verbatim" id="verbatim-192"> \newglossaryentry{sample}{ -  <br />  name={\oe-ligature}, -  <br />  sort={oe-ligature}, -  <br />  description={an example} -  <br />} -</div> - <!--l. 7607--><p class="nopar" > Then <span +   name={\oe-ligature}, +   sort={oe-ligature}, +   description={an example} + } +</pre> + <!--l. 7387--><p class="nopar" > Then <span class="cmtt-10">\Gls</span><span class="obeylines-h"><span class="verb"><span class="cmtt-10">{sample}</span></span></span> will set the <a href="#glo:linktext">link text<a - id="dx1-133028"></a></a> to + id="dx1-130028"></a></a> to </p> - <div class="verbatim" id="verbatim-211"> + <pre class="verbatim" id="verbatim-193"> \MakeUppercase \oe-ligature -</div> - <!--l. 7611--><p class="nopar" > which will appear as Œ-ligature. +</pre> + <!--l. 7391--><p class="nopar" > which will appear as Œ-ligature. </p></li> - <li class="itemize">If you have <span + <li class="itemize"> + <!--l. 7394--><p class="noindent" >If you have <span class="cmss-10">mfirstuc</span><a - id="dx1-133029"></a> v2.01 or above, an extra case is added. If the first thing is <span + id="dx1-130029"></a> v2.01 or above, an extra case is added. If the first thing is <span class="cmtt-10">\protect </span>it will be discarded and the above rules will then be tried. +</p> </li></ul> -<!--l. 7619--><p class="noindent" >(Note the use of the <span +<!--l. 7399--><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 LaTeX packages that altogether define thousands of commands with + id="dx1-130030"></a> key in the above examples.) +</p><!--l. 7401--><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 + id="dx1-130031"></a> to take them all into account. The above rules are quite simplistic and are designed for <a href="#glo:linktext">link text<a - id="dx1-133032"></a></a> that starts with a text-block command (such as + id="dx1-130032"></a></a> that starts with a text-block command (such as <span class="cmtt-10">\emph</span>) or a command that produces a character (such as <span class="cmtt-10">\oe</span>). This means that if your <a href="#glo:linktext">link text<a - id="dx1-133033"></a></a> + id="dx1-130033"></a></a> starts with something that doesn’t adhere to <span class="cmss-10">mfirstuc</span><a - id="dx1-133034"></a>’s assumptions then things are likely to go + id="dx1-130034"></a>’s assumptions then things are likely to go wrong. -</p><!--l. 7630--><p class="indent" > For example, starting with a math-shift symbol: +</p><!--l. 7410--><p class="indent" > For example, starting with a math-shift symbol: </p> - <div class="verbatim" id="verbatim-212"> + <pre class="verbatim" id="verbatim-194"> \newglossaryentry{sample}{ - <br />  name={$a$}, - <br />  sort={a}, - <br />  description={an example} - <br />} -</div> -<!--l. 7637--><p class="nopar" > This falls into case 2 above, so the <a +  name={$a$}, +  sort={a}, +  description={an example} +} +</pre> +<!--l. 7417--><p class="nopar" > This falls into case 2 above, so the <a href="#glo:linktext">link text<a - id="dx1-133035"></a></a> will be set to + id="dx1-130035"></a></a> will be set to </p> - <div class="verbatim" id="verbatim-213"> + <pre class="verbatim" id="verbatim-195"> \MakeUppercase $a$ -</div> -<!--l. 7641--><p class="nopar" > This attempts to uppercase the math-shift <span class="obeylines-h"><span class="verb"><span +</pre> +<!--l. 7421--><p class="nopar" > This attempts to uppercase the math-shift <span class="obeylines-h"><span class="verb"><span class="cmtt-10">$</span></span></span>, which will go wrong. In this case it’s not appropriate to perform any case-changing, but it may be that you want to use <span class="cmtt-10">\Gls </span>programmatically without checking if @@ -15862,139 +15816,140 @@ start: </p> - <div class="verbatim" id="verbatim-214"> + <pre class="verbatim" id="verbatim-196"> \newglossaryentry{sample}{ - <br />  name={{}$a$}, - <br />  sort={a}, - <br />  description={an example} - <br />} -</div> -<!--l. 7654--><p class="nopar" > Now the <a +  name={{}$a$}, +  sort={a}, +  description={an example} +} +</pre> +<!--l. 7434--><p class="nopar" > Now the <a href="#glo:linktext">link text<a - id="dx1-133036"></a></a> will be set to + id="dx1-130036"></a></a> will be set to </p> - <div class="verbatim" id="verbatim-215"> + <pre class="verbatim" id="verbatim-197"> \MakeUppercase{}$a$ -</div> -<!--l. 7658--><p class="nopar" > and the <span +</pre> +<!--l. 7438--><p class="nopar" > and the <span class="cmtt-10">\uppercase </span>becomes harmless. -</p><!--l. 7661--><p class="indent" > Another issue occurs when the <a +</p><!--l. 7441--><p class="indent" > Another issue occurs when the <a href="#glo:linktext">link text<a - id="dx1-133037"></a></a> starts with a command followed by an argument (case 1) but the + id="dx1-130037"></a></a> starts with a command followed by an argument (case 1) but the argument is a label, identifier or something else that shouldn’t have a case-change. A common example is when the <a href="#glo:linktext">link text<a - id="dx1-133038"></a></a> starts with one of the commands described in this chapter. (But you haven’t done that, have you? + id="dx1-130038"></a></a> starts with one of the commands described in this chapter. (But you haven’t done that, have you? What with the warning not to do it at the beginning of the chapter.) Or when the <a href="#glo:linktext">link text<a - id="dx1-133039"></a></a> starts -with one of the non-linking commands described in <a -href="#sec:glsnolink">§9 </a><a + id="dx1-130039"></a></a> starts with one of +the non-linking commands described in <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>. For example: </p> - <div class="verbatim" id="verbatim-216"> + <pre class="verbatim" id="verbatim-198"> \newglossaryentry{sample}{name={sample},description={an example}} - <br />\newglossaryentry{sample2}{ - <br />   name={\glsentrytext{sample} two}, - <br />   sort={sample two}, - <br />   description={another example} - <br /> } -</div> -<!--l. 7676--><p class="nopar" > Now the <a +\newglossaryentry{sample2}{ +   name={\glsentrytext{sample} two}, +   sort={sample two}, +   description={another example} + } +</pre> +<!--l. 7456--><p class="nopar" > Now the <a href="#glo:linktext">link text<a - id="dx1-133040"></a></a> will be set to: + id="dx1-130040"></a></a> will be set to: </p> - <div class="verbatim" id="verbatim-217"> + <pre class="verbatim" id="verbatim-199"> \glsentrytext{\MakeUppercase sample} two -</div> -<!--l. 7680--><p class="nopar" > This will generate an error because there’s no entry with the label “<span +</pre> +<!--l. 7460--><p class="nopar" > This will generate an error because there’s no entry with the label “<span class="cmtt-10">\MakeUppercase sample</span>”. The best solution here is to write the term out in the <span class="cmtt-10">text</span><a - id="dx1-133041"></a> field and use the command in the <span + id="dx1-130041"></a> field and use the command in the <span class="cmtt-10">name</span><a - id="dx1-133042"></a> field. If you don’t use + id="dx1-130042"></a> field. If you don’t use <span class="cmtt-10">\glsname </span>anywhere in your document, you can use <span class="cmtt-10">\gls </span>in the <span class="cmtt-10">name</span><a - id="dx1-133043"></a> field: + id="dx1-130043"></a> field: </p> - <div class="verbatim" id="verbatim-218"> + <pre class="verbatim" id="verbatim-200"> \newglossaryentry{sample}{name={sample},description={an example}} - <br />\newglossaryentry{sample2}{ - <br />   name={\gls{sample} two}, - <br />   sort={sample two}, - <br />   text={sample two}, - <br />   description={another example} - <br /> } -</div> -<!--l. 7694--><p class="nopar" > -</p><!--l. 7696--><p class="indent" > If the <a +\newglossaryentry{sample2}{ +   name={\gls{sample} two}, +   sort={sample two}, +   text={sample two}, +   description={another example} + } +</pre> +<!--l. 7474--><p class="nopar" > +</p><!--l. 7476--><p class="indent" > If the <a href="#glo:linktext">link text<a - id="dx1-133044"></a></a> starts with a command that has an optional argument or with multiple arguments where the + id="dx1-130044"></a></a> starts with a command that has an optional argument or with multiple arguments where the actual text isn’t in the first argument, then <span class="cmtt-10">\makefirstuc </span>will also fail. For example: </p> - <div class="verbatim" id="verbatim-219"> + <pre class="verbatim" id="verbatim-201"> \newglossaryentry{sample}{ - <br /> name={\textcolor{blue}{sample} phrase}, - <br /> sort={sample phrase}, - <br /> description={an example}} -</div> -<!--l. 7705--><p class="nopar" > Now the <a + name={\textcolor{blue}{sample} phrase}, + sort={sample phrase}, + description={an example}} +</pre> +<!--l. 7485--><p class="nopar" > Now the <a href="#glo:linktext">link text<a - id="dx1-133045"></a></a> will be set to: + id="dx1-130045"></a></a> will be set to: </p> - <div class="verbatim" id="verbatim-220"> + <pre class="verbatim" id="verbatim-202"> \textcolor{\MakeUppercase blue}{sample} phrase -</div> -<!--l. 7709--><p class="nopar" > This won’t work because <span class="obeylines-h"><span class="verb"><span +</pre> +<!--l. 7489--><p class="nopar" > This won’t work because <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\MakeUppercase</span><span class="cmtt-10"> blue</span></span></span> isn’t a recognised colour name. In this case you will have to define a helper command where the first argument is the text. For example: </p> - <div class="verbatim" id="verbatim-221"> + <pre class="verbatim" id="verbatim-203"> \newglossaryentry{sample}{ - <br />\newcommand*{\blue}[1]{\textcolor{blue}{#1}} - <br /> name={\blue{sample} phrase}, - <br /> sort={sample phrase}, - <br /> description={an example}} -</div> -<!--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 +\newcommand*{\blue}[1]{\textcolor{blue}{#1}} + name={\blue{sample} phrase}, + sort={sample phrase}, + description={an example}} +</pre> +<!--l. 7499--><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: </p> - <div class="verbatim" id="verbatim-222"> + <pre class="verbatim" id="verbatim-204"> \newglossaryentry{sample}{ - <br />\newcommand*{\keyword}[1]{\textcolor{blue}{#1}} - <br /> name={\keyword{sample} phrase}, - <br /> sort={sample phrase}, - <br /> description={an example}} -</div> -<!--l. 7729--><p class="nopar" > For further details see the <span +\newcommand*{\keyword}[1]{\textcolor{blue}{#1}} + name={\keyword{sample} phrase}, + sort={sample phrase}, + description={an example}} +</pre> +<!--l. 7509--><p class="nopar" > For further details see the <span class="cmss-10">mfirstuc</span><a - id="dx1-133046"></a> user manual. -</p><!--l. 7732--><p class="indent" > There are plural forms that are analogous to <span + id="dx1-130046"></a> user manual. +</p><!--l. 7512--><p class="indent" > There are plural forms that are analogous to <span class="cmtt-10">\gls</span>: -</p><!--l. 7733--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133047"></a> <span +</p><!--l. 7513--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130047"></a> <span class="cmtt-10">\glspl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16002,9 +15957,9 @@ 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. 7735--><p class="noindent" > -</p><!--l. 7736--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133048"></a> <span +</p><!--l. 7515--><p class="noindent" > +</p><!--l. 7516--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130048"></a> <span class="cmtt-10">\Glspl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16012,9 +15967,9 @@ 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. 7738--><p class="noindent" > -</p><!--l. 7739--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133049"></a> <span +</p><!--l. 7518--><p class="noindent" > +</p><!--l. 7519--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130049"></a> <span class="cmtt-10">\GLSpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16022,41 +15977,41 @@ 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. 7741--><p class="noindent" > +</p><!--l. 7521--><p class="noindent" > These typically determine the link text from the <span class="cmtt-10">plural</span><a - id="dx1-133050"></a> or <span + id="dx1-130050"></a> or <span class="cmtt-10">firstplural</span><a - id="dx1-133051"></a> keys supplied when the entry was + id="dx1-130051"></a> keys supplied when the entry was defined using <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-133052"></a> or, if the entry is an abbreviation and <span + id="dx1-130052"></a> or, if the entry is an abbreviation and <span class="cmtt-10">\setacronymstyle </span>was used, from the <span class="cmtt-10">longplural</span><a - id="dx1-133053"></a> or <span + id="dx1-130053"></a> or <span class="cmtt-10">shortplural</span><a - id="dx1-133054"></a> keys. -</p><!--l. 7748--><p class="indent" > <div class="important" title="Important Note"> Be careful when you use glossary entries in math mode especially if you are using <span + id="dx1-130054"></a> keys. +</p><!--l. 7528--><p class="indent" > <div class="important" title="Important Note"> Be careful when you use glossary entries in math mode especially if you are using <span class="cmss-10">hyperref</span><a - id="dx1-133055"></a> as it can affect + id="dx1-130055"></a> as it can affect the spacing of subscripts and superscripts. For example, suppose you have defined the following entry: </p> - <div class="verbatim" id="verbatim-223"> + <pre class="verbatim" id="verbatim-205"> \newglossaryentry{Falpha}{name={F_\alpha}, - <br />description=sample} -</div> -<!--l. 7756--><p class="nopar" > and later you use it in math mode: +description=sample} +</pre> +<!--l. 7536--><p class="nopar" > and later you use it in math mode: </p> - <div class="verbatim" id="verbatim-224"> + <pre class="verbatim" id="verbatim-206"> $\gls{Falpha}^2$ -</div> -<!--l. 7760--><p class="nopar" > This will result in <span +</pre> +<!--l. 7540--><p class="nopar" > This will result in <span class="cmmi-10">F</span><sub><span class="cmmi-7">α</span></sub><sup><span class="cmr-7">2</span></sup> instead of <span @@ -16068,13 +16023,13 @@ class="cmti-10">insert</span>⟩ optional argument: </p> - <div class="verbatim" id="verbatim-225"> + <pre class="verbatim" id="verbatim-207"> $\gls{Falpha}[^2]$ -</div> -<!--l. 7766--><p class="nopar" > </div> -</p><!--l. 7767--><p class="noindent" > -</p><!--l. 7769--><p class="indent" > <hr><div title="Definition"><a - id="dx1-133056"></a> <span +</pre> +<!--l. 7546--><p class="nopar" > </div> +</p><!--l. 7547--><p class="noindent" > +</p><!--l. 7549--><p class="indent" > <hr><div title="Definition"><a + id="dx1-130056"></a> <span class="cmtt-10">\glsdisp[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16082,12 +16037,12 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">link text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 7771--><p class="noindent" > +</p><!--l. 7551--><p class="noindent" > This behaves in the same way as the above commands, except that the ⟨<span class="cmti-10">link text</span>⟩ is explicitly set. There’s no final optional argument as any inserted material can be added to the ⟨<span class="cmti-10">link text</span>⟩ argument. -</p><!--l. 7777--><p class="indent" > <div class="important" title="Important Note"> Don’t use any of the <a +</p><!--l. 7557--><p class="indent" > <div class="important" title="Important Note"> Don’t use any of the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> or <a href="#sec:glstext-like"><span @@ -16095,14 +16050,14 @@ class="cmtt-10">\glstext</span>-like</a> commands in the ⟨<span class="cmti-10">link text</span>⟩ argument of <span class="cmtt-10">\glsdisp</span>. </div> -</p><!--l. 7780--><p class="noindent" > -</p><!--l. 7782--><p class="noindent" > +</p><!--l. 7560--><p class="noindent" > +</p><!--l. 7562--><p class="noindent" > </p> -<!--l. 7782--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.2 </span> <a +<!--l. 7562--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">5.1.2 </span> <a id="sec:glstext-like"></a>The <span -class="cmtt-10">\glstext</span>-Like Commands (First Use Flag Not Queried)</h3> -<!--l. 7785--><p class="noindent" >This section describes the commands that don’t change or reference the <a +class="cmtt-10">\glstext</span>-Like Commands (First Use Flag Not Queried)</h4> +<!--l. 7565--><p class="noindent" >This section describes the commands that don’t change or reference the <a href="#glo:firstuseflag">first use flag</a>. As described above, these commands all have a star-variant (<span class="cmtt-10">hyper=false</span>) and a plus-variant (<span @@ -16111,27 +16066,31 @@ argument that is a ⟨<span class="cmti-10">key</span>⟩=⟨<span class="cmti-10">value</span>⟩ list. These commands also don’t use <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-134001"></a> or the equivalent definition -provided by <span + id="dx1-131001"></a> or the equivalent +definition provided by <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-134002"></a> (see <a -href="#sec:glsdisplay">§6.3 </a><a -href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>). Additional commands for -abbreviations are described in <a -href="#sec:acronyms">§13 </a><a -href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>. -</p><!--l. 7795--><p class="indent" > Apart from <span + id="dx1-131002"></a> (see <a +href="#sec:glsdisplay">§<span +class="cmbx-10">??</span>sec:glsdisplay </a><a +href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>). +Additional commands for abbreviations are described in <a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other +Abbreviations<!--tex4ht:ref: sec:acronyms --></a>. +</p><!--l. 7575--><p class="indent" > Apart from <span class="cmtt-10">\glslink</span><a - id="dx1-134003"></a>, the commands described in this section also have a <span + id="dx1-131003"></a>, the commands described in this section also have a <span class="cmti-10">final </span>optional argument ⟨<span class="cmti-10">insert</span>⟩ -which may be used to insert material into the automatically generated text. See the caveat above in <a -href="#sec:gls-like">§6.1 </a><a -href="#sec:gls-like">The -<span +which may be used to insert material into the automatically generated text. See the caveat above in +<a +href="#sec:gls-like">§<span +class="cmbx-10">??</span>sec:gls-like </a><a +href="#sec:gls-like">The <span class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a>. -</p><!--l. 7800--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134004"></a> <span +</p><!--l. 7580--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131004"></a> <span class="cmtt-10">\glslink[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16139,11 +16098,11 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">link text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 7802--><p class="noindent" > +</p><!--l. 7582--><p class="noindent" > This command explicitly sets the <a href="#glo:linktext">link text<a - id="dx1-134005"></a></a> as given in the final argument. -</p><!--l. 7806--><p class="indent" > <div class="important" title="Important Note"> Don’t use any of the <a + id="dx1-131005"></a></a> as given in the final argument. +</p><!--l. 7586--><p class="indent" > <div class="important" title="Important Note"> Don’t use any of the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> or <a href="#sec:glstext-like"><span @@ -16151,11 +16110,11 @@ class="cmtt-10">\glstext</span>-like</a> commands in the argument of <spa class="cmtt-10">\glslink</span>. By extension, this means that you can’t use them in the value of fields that are used to form <a href="#glo:linktext">link text<a - id="dx1-134006"></a></a>. + id="dx1-131006"></a></a>. </div> -</p><!--l. 7811--><p class="noindent" > -</p><!--l. 7813--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134007"></a> <span +</p><!--l. 7591--><p class="noindent" > +</p><!--l. 7593--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131007"></a> <span class="cmtt-10">\glstext[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16163,15 +16122,15 @@ 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. 7815--><p class="noindent" > +</p><!--l. 7595--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">text</span><a - id="dx1-134008"></a> key as the <a + id="dx1-131008"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134009"></a></a>. -</p><!--l. 7819--><p class="indent" > There are also analogous commands: -</p><!--l. 7820--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134010"></a> <span + id="dx1-131009"></a></a>. +</p><!--l. 7599--><p class="indent" > There are also analogous commands: +</p><!--l. 7600--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131010"></a> <span class="cmtt-10">\Glstext[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16179,11 +16138,11 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7822--><p class="noindent" > +</p><!--l. 7602--><p class="noindent" > -</p><!--l. 7823--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134011"></a> <span +</p><!--l. 7603--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131011"></a> <span class="cmtt-10">\GLStext[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16191,26 +16150,27 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7825--><p class="noindent" > +</p><!--l. 7605--><p class="noindent" > These convert the first character or all the characters to uppercase, respectively. See the note on <span class="cmtt-10">\Gls </span>above for details on the limitations of converting the first letter to upper case. -</p><!--l. 7830--><p class="indent" > There’s no equivalent command for title-casing, but you can use the more generic command +</p><!--l. 7610--><p class="indent" > There’s no equivalent command for title-casing, but you can use the more generic command <span class="cmtt-10">\glsentrytitlecase</span><a - id="dx1-134012"></a> in combination with <span + id="dx1-131012"></a> in combination with <span class="cmtt-10">\glslink</span>. For example: </p> - <div class="verbatim" id="verbatim-226"> + <pre class="verbatim" id="verbatim-208"> \glslink{sample}{\glsentrytitlecase{sample}{text}} -</div> -<!--l. 7835--><p class="nopar" > (See <a -href="#sec:glsnolink">§9 </a><a +</pre> +<!--l. 7615--><p class="nopar" > (See <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>.) -</p><!--l. 7838--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134013"></a> <span +</p><!--l. 7618--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131013"></a> <span class="cmtt-10">\glsfirst[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16218,15 +16178,15 @@ 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. 7840--><p class="noindent" > +</p><!--l. 7620--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">first</span><a - id="dx1-134014"></a> key as the <a + id="dx1-131014"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134015"></a></a>. -</p><!--l. 7844--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7845--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134016"></a> <span + id="dx1-131015"></a></a>. +</p><!--l. 7624--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7625--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131016"></a> <span class="cmtt-10">\Glsfirst[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16234,9 +16194,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7847--><p class="noindent" > -</p><!--l. 7848--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134017"></a> <span +</p><!--l. 7627--><p class="noindent" > +</p><!--l. 7628--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131017"></a> <span class="cmtt-10">\GLSfirst[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16244,36 +16204,36 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7850--><p class="noindent" > -</p><!--l. 7852--><p class="indent" > <div class="important" title="Important Note"> The value of the <span +</p><!--l. 7630--><p class="noindent" > +</p><!--l. 7632--><p class="indent" > <div class="important" title="Important Note"> The value of the <span class="cmtt-10">first</span><a - id="dx1-134018"></a> key (and <span + id="dx1-131018"></a> key (and <span class="cmtt-10">firstplural</span><a - id="dx1-134019"></a> key) doesn’t necessarily match the text produced by <span + id="dx1-131019"></a> key) doesn’t necessarily match the text produced by <span class="cmtt-10">\gls</span><a - id="dx1-134020"></a> (or + id="dx1-131020"></a> (or <span class="cmtt-10">\glspl</span><a - id="dx1-134021"></a>) on <a + id="dx1-131021"></a>) on <a href="#glo:firstuse">first use</a> as the <a href="#glo:linktext">link text<a - id="dx1-134022"></a></a> used by <span + id="dx1-131022"></a></a> used by <span class="cmtt-10">\gls</span><a - id="dx1-134023"></a> may be modified through commands like <span + id="dx1-131023"></a> may be modified through commands like <span class="cmtt-10">\defglsentry</span><a - id="dx1-134024"></a>. + id="dx1-131024"></a>. (Similarly, the value of the <span class="cmtt-10">text</span><a - id="dx1-134025"></a> and <span + id="dx1-131025"></a> and <span class="cmtt-10">plural</span><a - id="dx1-134026"></a> keys don’t necessarily match the link text<a - id="dx1-134027"></a> used by <span + id="dx1-131026"></a> keys don’t necessarily match the link text<a + id="dx1-131027"></a> used by <span class="cmtt-10">\gls </span>or <span class="cmtt-10">\glspl</span> on subsequent use.) </div> -</p><!--l. 7860--><p class="noindent" > -</p><!--l. 7862--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134028"></a> <span +</p><!--l. 7640--><p class="noindent" > +</p><!--l. 7642--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131028"></a> <span class="cmtt-10">\glsplural[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16281,15 +16241,15 @@ 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. 7864--><p class="noindent" > +</p><!--l. 7644--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">plural</span><a - id="dx1-134029"></a> key as the <a + id="dx1-131029"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134030"></a></a>. -</p><!--l. 7868--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7869--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134031"></a> <span + id="dx1-131030"></a></a>. +</p><!--l. 7648--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7649--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131031"></a> <span class="cmtt-10">\Glsplural[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16297,9 +16257,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7871--><p class="noindent" > -</p><!--l. 7872--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134032"></a> <span +</p><!--l. 7651--><p class="noindent" > +</p><!--l. 7652--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131032"></a> <span class="cmtt-10">\GLSplural[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16307,9 +16267,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7874--><p class="noindent" > -</p><!--l. 7876--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134033"></a> <span +</p><!--l. 7654--><p class="noindent" > +</p><!--l. 7656--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131033"></a> <span class="cmtt-10">\glsfirstplural[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16317,15 +16277,15 @@ 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. 7878--><p class="noindent" > +</p><!--l. 7658--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">firstplural</span><a - id="dx1-134034"></a> key as the <a + id="dx1-131034"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134035"></a></a>. -</p><!--l. 7882--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7883--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134036"></a> <span + id="dx1-131035"></a></a>. +</p><!--l. 7662--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7663--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131036"></a> <span class="cmtt-10">\Glsfirstplural[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16333,9 +16293,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7885--><p class="noindent" > -</p><!--l. 7886--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134037"></a> <span +</p><!--l. 7665--><p class="noindent" > +</p><!--l. 7666--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131037"></a> <span class="cmtt-10">\GLSfirstplural[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16343,9 +16303,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7888--><p class="noindent" > -</p><!--l. 7890--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134038"></a> <span +</p><!--l. 7668--><p class="noindent" > +</p><!--l. 7670--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131038"></a> <span class="cmtt-10">\glsname[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16353,26 +16313,26 @@ 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. 7892--><p class="noindent" > +</p><!--l. 7672--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">name</span><a - id="dx1-134039"></a> key as the <a + id="dx1-131039"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134040"></a></a>. Note that this may be different from the + id="dx1-131040"></a></a>. Note that this may be different from the values of the <span class="cmtt-10">text</span><a - id="dx1-134041"></a> or <span + id="dx1-131041"></a> or <span class="cmtt-10">first</span><a - id="dx1-134042"></a> keys. In general it’s better to use <span + id="dx1-131042"></a> keys. In general it’s better to use <span class="cmtt-10">\glstext </span>or <span class="cmtt-10">\glsfirst </span>instead of <span class="cmtt-10">\glsname</span>. -</p><!--l. 7898--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7899--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134043"></a> <span +</p><!--l. 7678--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7679--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131043"></a> <span class="cmtt-10">\Glsname[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16380,9 +16340,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7901--><p class="noindent" > -</p><!--l. 7902--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134044"></a> <span +</p><!--l. 7681--><p class="noindent" > +</p><!--l. 7682--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131044"></a> <span class="cmtt-10">\GLSname[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16390,16 +16350,16 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7904--><p class="noindent" > -</p><!--l. 7906--><p class="indent" > <div class="important" title="Important Note"> In general it’s best to avoid <span +</p><!--l. 7684--><p class="noindent" > +</p><!--l. 7686--><p class="indent" > <div class="important" title="Important Note"> In general it’s best to avoid <span class="cmtt-10">\Glsname </span>with acronyms. Instead, consider using <span class="cmtt-10">\Acrlong</span>, <span class="cmtt-10">\Acrshort </span>or <span class="cmtt-10">\Acrfull</span>. </div> -</p><!--l. 7909--><p class="noindent" > -</p><!--l. 7911--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134045"></a> <span +</p><!--l. 7689--><p class="noindent" > +</p><!--l. 7691--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131045"></a> <span class="cmtt-10">\glssymbol[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16407,15 +16367,15 @@ 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. 7913--><p class="noindent" > +</p><!--l. 7693--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">symbol</span><a - id="dx1-134046"></a> key as the <a + id="dx1-131046"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134047"></a></a>. -</p><!--l. 7917--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7918--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134048"></a> <span + id="dx1-131047"></a></a>. +</p><!--l. 7697--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7698--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131048"></a> <span class="cmtt-10">\Glssymbol[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16423,9 +16383,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7920--><p class="noindent" > -</p><!--l. 7921--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134049"></a> <span +</p><!--l. 7700--><p class="noindent" > +</p><!--l. 7701--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131049"></a> <span class="cmtt-10">\GLSsymbol[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16433,9 +16393,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7923--><p class="noindent" > -</p><!--l. 7925--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134050"></a> <span +</p><!--l. 7703--><p class="noindent" > +</p><!--l. 7705--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131050"></a> <span class="cmtt-10">\glsdesc[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16443,15 +16403,15 @@ 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. 7927--><p class="noindent" > +</p><!--l. 7707--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">description</span><a - id="dx1-134051"></a> key as the <a + id="dx1-131051"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134052"></a></a>. -</p><!--l. 7931--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7932--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134053"></a> <span + id="dx1-131052"></a></a>. +</p><!--l. 7711--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7712--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131053"></a> <span class="cmtt-10">\Glsdesc[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16459,9 +16419,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7934--><p class="noindent" > -</p><!--l. 7935--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134054"></a> <span +</p><!--l. 7714--><p class="noindent" > +</p><!--l. 7715--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131054"></a> <span class="cmtt-10">\GLSdesc[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16469,17 +16429,17 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7937--><p class="noindent" > -</p><!--l. 7939--><p class="indent" > If you want the title case version you can use +</p><!--l. 7717--><p class="noindent" > +</p><!--l. 7719--><p class="indent" > If you want the title case version you can use </p> - <div class="verbatim" id="verbatim-227"> + <pre class="verbatim" id="verbatim-209"> \glslink{sample}{\glsentrytitlecase{sample}{desc}} -</div> -<!--l. 7942--><p class="nopar" > -</p><!--l. 7944--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134055"></a> <span +</pre> +<!--l. 7722--><p class="nopar" > +</p><!--l. 7724--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131055"></a> <span class="cmtt-10">\glsuseri[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16487,15 +16447,15 @@ 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. 7946--><p class="noindent" > +</p><!--l. 7726--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">user1</span><a - id="dx1-134056"></a> key as the <a + id="dx1-131056"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134057"></a></a>. -</p><!--l. 7950--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7951--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134058"></a> <span + id="dx1-131057"></a></a>. +</p><!--l. 7730--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7731--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131058"></a> <span class="cmtt-10">\Glsuseri[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16503,9 +16463,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7953--><p class="noindent" > -</p><!--l. 7954--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134059"></a> <span +</p><!--l. 7733--><p class="noindent" > +</p><!--l. 7734--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131059"></a> <span class="cmtt-10">\GLSuseri[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16513,9 +16473,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7956--><p class="noindent" > -</p><!--l. 7958--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134060"></a> <span +</p><!--l. 7736--><p class="noindent" > +</p><!--l. 7738--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131060"></a> <span class="cmtt-10">\glsuserii[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16523,15 +16483,15 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7960--><p class="noindent" > +</p><!--l. 7740--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">user2</span><a - id="dx1-134061"></a> key as the <a + id="dx1-131061"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134062"></a></a>. -</p><!--l. 7964--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7965--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134063"></a> <span + id="dx1-131062"></a></a>. +</p><!--l. 7744--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7745--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131063"></a> <span class="cmtt-10">\Glsuserii[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16539,9 +16499,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7967--><p class="noindent" > -</p><!--l. 7968--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134064"></a> <span +</p><!--l. 7747--><p class="noindent" > +</p><!--l. 7748--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131064"></a> <span class="cmtt-10">\GLSuserii[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16549,9 +16509,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7970--><p class="noindent" > -</p><!--l. 7972--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134065"></a> <span +</p><!--l. 7750--><p class="noindent" > +</p><!--l. 7752--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131065"></a> <span class="cmtt-10">\glsuseriii[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16559,15 +16519,15 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7974--><p class="noindent" > +</p><!--l. 7754--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">user3</span><a - id="dx1-134066"></a> key as the <a + id="dx1-131066"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134067"></a></a>. -</p><!--l. 7978--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7979--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134068"></a> <span + id="dx1-131067"></a></a>. +</p><!--l. 7758--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7759--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131068"></a> <span class="cmtt-10">\Glsuseriii[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16575,9 +16535,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7981--><p class="noindent" > -</p><!--l. 7982--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134069"></a> <span +</p><!--l. 7761--><p class="noindent" > +</p><!--l. 7762--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131069"></a> <span class="cmtt-10">\GLSuseriii[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16585,9 +16545,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7984--><p class="noindent" > -</p><!--l. 7986--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134070"></a> <span +</p><!--l. 7764--><p class="noindent" > +</p><!--l. 7766--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131070"></a> <span class="cmtt-10">\glsuseriv[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16595,15 +16555,15 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7988--><p class="noindent" > +</p><!--l. 7768--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">user4</span><a - id="dx1-134071"></a> key as the <a + id="dx1-131071"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134072"></a></a>. -</p><!--l. 7992--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 7993--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134073"></a> <span + id="dx1-131072"></a></a>. +</p><!--l. 7772--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7773--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131073"></a> <span class="cmtt-10">\Glsuseriv[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16611,9 +16571,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7995--><p class="noindent" > -</p><!--l. 7996--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134074"></a> <span +</p><!--l. 7775--><p class="noindent" > +</p><!--l. 7776--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131074"></a> <span class="cmtt-10">\GLSuseriv[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16623,9 +16583,9 @@ class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 7998--><p class="noindent" > -</p><!--l. 8000--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134075"></a> <span +</p><!--l. 7778--><p class="noindent" > +</p><!--l. 7780--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131075"></a> <span class="cmtt-10">\glsuserv[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16633,15 +16593,15 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 8002--><p class="noindent" > +</p><!--l. 7782--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">user5</span><a - id="dx1-134076"></a> key as the <a + id="dx1-131076"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134077"></a></a>. -</p><!--l. 8006--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 8007--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134078"></a> <span + id="dx1-131077"></a></a>. +</p><!--l. 7786--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7787--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131078"></a> <span class="cmtt-10">\Glsuserv[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16649,9 +16609,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 8009--><p class="noindent" > -</p><!--l. 8010--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134079"></a> <span +</p><!--l. 7789--><p class="noindent" > +</p><!--l. 7790--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131079"></a> <span class="cmtt-10">\GLSuserv[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16659,9 +16619,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 8012--><p class="noindent" > -</p><!--l. 8014--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134080"></a> <span +</p><!--l. 7792--><p class="noindent" > +</p><!--l. 7794--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131080"></a> <span class="cmtt-10">\glsuservi[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16669,15 +16629,15 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 8016--><p class="noindent" > +</p><!--l. 7796--><p class="noindent" > This command always uses the value of the <span class="cmtt-10">user6</span><a - id="dx1-134081"></a> key as the <a + id="dx1-131081"></a> key as the <a href="#glo:linktext">link text<a - id="dx1-134082"></a></a>. -</p><!--l. 8020--><p class="indent" > There are also analogous uppercasing commands: -</p><!--l. 8021--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134083"></a> <span + id="dx1-131082"></a></a>. +</p><!--l. 7800--><p class="indent" > There are also analogous uppercasing commands: +</p><!--l. 7801--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131083"></a> <span class="cmtt-10">\Glsuservi[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16685,9 +16645,9 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 8023--><p class="noindent" > -</p><!--l. 8024--><p class="indent" > <hr><div title="Definition"><a - id="dx1-134084"></a> <span +</p><!--l. 7803--><p class="noindent" > +</p><!--l. 7804--><p class="indent" > <hr><div title="Definition"><a + id="dx1-131084"></a> <span class="cmtt-10">\GLSuservi[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -16695,127 +16655,128 @@ class="cmitt-10">text</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmitt-10">insert</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 8026--><p class="noindent" > -</p><!--l. 8028--><p class="noindent" > +</p><!--l. 7806--><p class="noindent" > +</p><!--l. 7808--><p class="noindent" > </p> -<!--l. 8028--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.3 </span> <a - id="sec:glsdisplay"></a>Changing the format of the link text</h3> -<!--l. 8031--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +<!--l. 7808--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">5.1.3 </span> <a + id="sec:glsdisplay"></a>Changing the format of the link text</h4> +<!--l. 7811--><p class="noindent" ><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 provides ways of altering the format according to the category. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual for further details. </div> -</p><!--l. 8035--><p class="noindent" > -</p><!--l. 8037--><p class="noindent" >The default format of the <a +</p><!--l. 7815--><p class="noindent" > +</p><!--l. 7817--><p class="noindent" >The default format of the <a href="#glo:linktext">link text<a - id="dx1-135001"></a></a> for the <a + id="dx1-132001"></a></a> for the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands is governed by<span class="footnote-mark"><a -href="#fn3x6" id="fn3x6-bk"><sup class="textsuperscript">6.3</sup></a></span><a - id="x1-135002f3"></a>: -</p><!--l. 8041--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135006"></a> <span +href="#fn3x5" id="fn3x5-bk"><sup class="textsuperscript">5.3</sup></a></span><a + id="x1-132002f3"></a>: +</p><!--l. 7821--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132006"></a> <span class="cmtt-10">\glsentryfmt </span></div><hr> -</p><!--l. 8043--><p class="noindent" > +</p><!--l. 7823--><p class="noindent" > This may be redefined but if you only want the change the display style for a given glossary, then you need to use -</p><!--l. 8046--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135007"></a> <span +</p><!--l. 7826--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132007"></a> <span class="cmtt-10">\defglsentryfmt[</span>⟨<span class="cmitt-10">type</span>⟩<span class="cmtt-10">]{</span>⟨<span class="cmitt-10">definition</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8048--><p class="noindent" > +</p><!--l. 7828--><p class="noindent" > instead of redefining <span class="cmtt-10">\glsentryfmt</span>. The optional first argument ⟨<span class="cmti-10">type</span>⟩ is the glossary type. This defaults to <span class="cmtt-10">\glsdefaulttype</span><a - id="dx1-135008"></a> if omitted. The second argument is the entry format definition. -</p><!--l. 8054--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\glsentryfmt </span>is the default display format for entries. Once the display format has been -changed for an individual glossary using <span + id="dx1-132008"></a> if omitted. The second argument is the entry format definition. +</p><!--l. 7834--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\glsentryfmt </span>is the default display format for entries. Once the display format has been changed +for an individual glossary using <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-135009"></a>, redefining <span -class="cmtt-10">\glsentryfmt </span>won’t have an -effect on that glossary, you must instead use <span -class="cmtt-10">\defglsentryfmt </span>again. Note that glossaries that -have been identified as lists of acronyms (via the package option <span + id="dx1-132009"></a>, redefining <span +class="cmtt-10">\glsentryfmt </span>won’t have an effect on that +glossary, you must instead use <span +class="cmtt-10">\defglsentryfmt </span>again. Note that glossaries that have been identified as +lists of acronyms (via the package option <span class="cmss-10">acronymlists</span><a - id="dx1-135010"></a> or the command - - -<span + id="dx1-132010"></a> or the command <span class="cmtt-10">\DeclareAcronymList</span><a - id="dx1-135011"></a>, see <a -href="#sec:pkgopts-acronym">§2.7 </a><a + id="dx1-132011"></a>, see +<a +href="#sec:pkgopts-acronym">§<span +class="cmbx-10">??</span>sec:pkgopts-acronym </a><a href="#sec:pkgopts-acronym">Acronym and Abbreviation Options<!--tex4ht:ref: sec:pkgopts-acronym --></a>) use <span -class="cmtt-10">\defglsentryfmt </span>to set their display -style. </div> -</p><!--l. 8064--><p class="noindent" > -</p><!--l. 8066--><p class="indent" > Within the ⟨<span +class="cmtt-10">\defglsentryfmt </span>to set their display style. + + +</div> +</p><!--l. 7844--><p class="noindent" > +</p><!--l. 7846--><p class="indent" > Within the ⟨<span class="cmti-10">definition</span>⟩ argument of <span class="cmtt-10">\defglsentryfmt</span>, or if you want to redefine <span class="cmtt-10">\glsentryfmt</span>, you may use the following commands: -</p><!--l. 8070--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135012"></a> <span +</p><!--l. 7850--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132012"></a> <span class="cmtt-10">\glslabel </span></div><hr> -</p><!--l. 8072--><p class="noindent" > +</p><!--l. 7852--><p class="noindent" > This is the label of the entry being referenced. As from version 4.08, you can also access the glossary entry type using: -</p><!--l. 8075--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135013"></a> <span +</p><!--l. 7855--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132013"></a> <span class="cmtt-10">\glstype </span></div><hr> -</p><!--l. 8077--><p class="noindent" > +</p><!--l. 7857--><p class="noindent" > This is defined using <span class="cmtt-10">\edef</span><a - id="dx1-135014"></a> so the replacement text is the actual glossary type rather than + id="dx1-132014"></a> so the replacement text is the actual glossary type rather than <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrytype{\glslabel}</span></span></span>. -</p><!--l. 8081--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135015"></a> <span +</p><!--l. 7861--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132015"></a> <span class="cmtt-10">\glscustomtext </span></div><hr> -</p><!--l. 8083--><p class="noindent" > +</p><!--l. 7863--><p class="noindent" > This is the custom text supplied in <span class="cmtt-10">\glsdisp</span>. It’s always empty for <span class="cmtt-10">\gls</span><a - id="dx1-135016"></a>, <span + id="dx1-132016"></a>, <span class="cmtt-10">\glspl</span><a - id="dx1-135017"></a> and their upper case variants. + id="dx1-132017"></a> and their upper case variants. (You can use <span class="cmss-10">etoolbox</span><a - id="dx1-135018"></a>’s <span + id="dx1-132018"></a>’s <span class="cmtt-10">\ifdefempty </span>to determine if <span class="cmtt-10">\glscustomtext </span>is empty.) -</p><!--l. 8089--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135019"></a> <span +</p><!--l. 7869--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132019"></a> <span class="cmtt-10">\glsinsert </span></div><hr> -</p><!--l. 8091--><p class="noindent" > +</p><!--l. 7871--><p class="noindent" > The custom text supplied in the final optional argument to <span class="cmtt-10">\gls</span>, <span class="cmtt-10">\glspl </span>and their upper case variants. -</p><!--l. 8095--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135020"></a> <span +</p><!--l. 7875--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132020"></a> <span class="cmtt-10">\glsifplural{</span>⟨<span class="cmitt-10">true text</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">false text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8097--><p class="noindent" > +</p><!--l. 7877--><p class="noindent" > If <span class="cmtt-10">\glspl</span>, <span class="cmtt-10">\Glspl </span>or <span class="cmtt-10">\GLSpl </span>was used, this command does ⟨<span class="cmti-10">true text</span>⟩ otherwise it does ⟨<span class="cmti-10">false text</span>⟩. -</p><!--l. 8101--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135021"></a> <span +</p><!--l. 7881--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132021"></a> <span class="cmtt-10">\glscapscase{</span>⟨<span class="cmitt-10">no case</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -16823,7 +16784,7 @@ class="cmitt-10">first uc</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">all caps</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8103--><p class="noindent" > +</p><!--l. 7883--><p class="noindent" > If <span class="cmtt-10">\gls</span>, <span class="cmtt-10">\glspl </span>or <span @@ -16836,41 +16797,41 @@ class="cmti-10">first uc</span>⟩. If class="cmtt-10">\GLS </span>or <span class="cmtt-10">\GLSpl </span>were used, this does ⟨<span class="cmti-10">all caps</span>⟩. -</p><!--l. 8108--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135022"></a> <span +</p><!--l. 7888--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132022"></a> <span class="cmtt-10">\glsifhyperon{</span>⟨<span class="cmitt-10">hyper true</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">hyper false</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8110--><p class="noindent" > +</p><!--l. 7890--><p class="noindent" > This will do ⟨<span class="cmti-10">hyper true</span>⟩ if the hyperlinks are on for the current reference, otherwise it will do ⟨<span class="cmti-10">hyper false</span>⟩. The hyperlink may be off even if it wasn’t explicitly switched off with the <span class="cmtt-10">hyper</span><a - id="dx1-135023"></a> key or the use of a starred + id="dx1-132023"></a> key or the use of a starred command. It may be off because the <span class="cmss-10">hyperref</span><a - id="dx1-135024"></a> package hasn’t been loaded or because <span + id="dx1-132024"></a> package hasn’t been loaded or because <span class="cmtt-10">\glsdisablehyper</span><a - id="dx1-135025"></a> + id="dx1-132025"></a> has been used or because the entry is in a glossary type that’s had the hyperlinks switched off (using <span class="cmss-10">nohypertypes</span><a - id="dx1-135026"></a>) or because it’s the <a + id="dx1-132026"></a>) or because it’s the <a href="#glo:firstuse">first use</a> and the hyperlinks have been suppressed on first use. -</p><!--l. 8121--><p class="indent" > <div class="important" title="Important Note"> The <span +</p><!--l. 7901--><p class="indent" > <div class="important" title="Important Note"> The <span class="cmtt-10">\glsifhyperon </span>command should be used instead of <span class="cmtt-10">\glsifhyper</span><a - id="dx1-135027"></a>, which is now deprecated (and no + id="dx1-132027"></a>, which is now deprecated (and no longer documented). </div> -</p><!--l. 8124--><p class="noindent" > -</p><!--l. 8126--><p class="indent" > If you want to know if the command used to reference this entry was used with the star or plus variant, you +</p><!--l. 7904--><p class="noindent" > +</p><!--l. 7906--><p class="indent" > If you want to know if the command used to reference this entry was used with the star or plus variant, you can use: -</p><!--l. 8128--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135028"></a> <span +</p><!--l. 7908--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132028"></a> <span class="cmtt-10">\glslinkvar{</span>⟨<span class="cmitt-10">unmodified</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -16878,38 +16839,39 @@ class="cmitt-10">star</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">plus</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8130--><p class="noindent" > +</p><!--l. 7910--><p class="noindent" > This will do ⟨<span class="cmti-10">unmodified</span>⟩ if the unmodified version was used, or will do ⟨<span class="cmti-10">star</span>⟩ if the starred version was used, or - - will do ⟨<span class="cmti-10">plus</span>⟩ if the plus version was used. Note that this doesn’t take into account if the <span class="cmtt-10">hyper</span><a - id="dx1-135029"></a> key was used to + id="dx1-132029"></a> key was used to + + override the default setting, so this command shouldn’t be used to guess whether or not the hyperlink is on for this reference. -</p><!--l. 8139--><p class="indent" > Note that you can also use commands such as <span +</p><!--l. 7919--><p class="indent" > Note that you can also use commands such as <span class="cmtt-10">\ifglsused</span><a - id="dx1-135030"></a> within the definition of <span -class="cmtt-10">\glsentryfmt </span>(see <a -href="#sec:glsunset">§14 -</a><a + id="dx1-132030"></a> within the definition of <span +class="cmtt-10">\glsentryfmt </span>(see +<a +href="#sec:glsunset">§<span +class="cmbx-10">??</span>sec:glsunset </a><a href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>). -</p><!--l. 8142--><p class="indent" > The commands <span +</p><!--l. 7922--><p class="indent" > The commands <span class="cmtt-10">\glslabel</span><a - id="dx1-135031"></a>, <span + id="dx1-132031"></a>, <span class="cmtt-10">\glstype</span><a - id="dx1-135032"></a>, <span + id="dx1-132032"></a>, <span class="cmtt-10">\glsifplural</span><a - id="dx1-135033"></a>, <span + id="dx1-132033"></a>, <span class="cmtt-10">\glscapscase</span><a - id="dx1-135034"></a>, <span + id="dx1-132034"></a>, <span class="cmtt-10">\glsinsert</span><a - id="dx1-135035"></a> and <span + id="dx1-132035"></a> and <span class="cmtt-10">\glscustomtext</span><a - id="dx1-135036"></a> are + id="dx1-132036"></a> are typically updated at the start of the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> and <a @@ -16917,25 +16879,25 @@ href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands so they can usually be accessed in the hook user commands, such as <span class="cmtt-10">\glspostlinkhook</span><a - id="dx1-135037"></a> and <span + id="dx1-132037"></a> and <span class="cmtt-10">\glslinkpostsetkeys</span><a - id="dx1-135038"></a>. -</p><!--l. 8148--><p class="indent" > <div class="important" title="Important Note"> This means that using commands like <span + id="dx1-132038"></a>. +</p><!--l. 7928--><p class="indent" > <div class="important" title="Important Note"> This means that using commands like <span class="cmtt-10">\gls</span><a - id="dx1-135039"></a> within the fields that are accessed using the <a + id="dx1-132039"></a> within the fields that are accessed using the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> or <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands (such as the <span class="cmtt-10">first</span><a - id="dx1-135040"></a>, <span + id="dx1-132040"></a>, <span class="cmtt-10">text</span><a - id="dx1-135041"></a>, <span + id="dx1-132041"></a>, <span class="cmtt-10">long</span><a - id="dx1-135042"></a> or <span + id="dx1-132042"></a> or <span class="cmtt-10">short</span><a - id="dx1-135043"></a> keys) will cause a problem. The entry + id="dx1-132043"></a> keys) will cause a problem. The entry formatting performed by <span class="cmtt-10">\glsentryfmt </span>and related commands isn’t scoped (otherwise if would cause problems for <span @@ -16943,288 +16905,290 @@ class="cmtt-10">\glspostlinkhook </span>which may need to look ahead as well as means that any nested commands will, at the very least, change the label stored in <span class="cmtt-10">\glslabel</span>. </div> -</p><!--l. 8158--><p class="noindent" > -</p><!--l. 8160--><p class="indent" > If you only want to make minor modifications to <span +</p><!--l. 7938--><p class="noindent" > +</p><!--l. 7940--><p class="indent" > If you only want to make minor modifications to <span class="cmtt-10">\glsentryfmt</span>, you can use -</p><!--l. 8162--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135044"></a> <span +</p><!--l. 7942--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132044"></a> <span class="cmtt-10">\glsgenentryfmt </span></div><hr> -</p><!--l. 8164--><p class="noindent" > +</p><!--l. 7944--><p class="noindent" > This uses the above commands to display just the <span class="cmtt-10">first</span><a - id="dx1-135045"></a>, <span + id="dx1-132045"></a>, <span class="cmtt-10">text</span><a - id="dx1-135046"></a>, <span + id="dx1-132046"></a>, <span class="cmtt-10">plural</span><a - id="dx1-135047"></a> or <span + id="dx1-132047"></a> or <span class="cmtt-10">firstplural</span><a - id="dx1-135048"></a> keys (or the custom + id="dx1-132048"></a> keys (or the custom text) with the insert text appended. -</p><!--l. 8169--><p class="indent" > Alternatively, if you want to change the entry format for abbreviations (defined via <span +</p><!--l. 7949--><p class="indent" > Alternatively, if you want to change the entry format for abbreviations (defined via <span class="cmtt-10">\newacronym</span><a - id="dx1-135049"></a>) you can + id="dx1-132049"></a>) you can use: -</p><!--l. 8171--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135050"></a> <span +</p><!--l. 7951--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132050"></a> <span class="cmtt-10">\glsgenacfmt </span></div><hr> -</p><!--l. 8173--><p class="noindent" > +</p><!--l. 7953--><p class="noindent" > This uses the values from the <span class="cmtt-10">long</span><a - id="dx1-135051"></a>, <span + id="dx1-132051"></a>, <span class="cmtt-10">short</span><a - id="dx1-135052"></a>, <span + id="dx1-132052"></a>, <span class="cmtt-10">longplural</span><a - id="dx1-135053"></a> and <span + id="dx1-132053"></a> and <span class="cmtt-10">shortplural</span><a - id="dx1-135054"></a> keys, rather than using the <span + id="dx1-132054"></a> keys, rather than using the <span class="cmtt-10">text</span><a - id="dx1-135055"></a>, + id="dx1-132055"></a>, <span class="cmtt-10">plural</span><a - id="dx1-135056"></a>, <span + id="dx1-132056"></a>, <span class="cmtt-10">first</span><a - id="dx1-135057"></a> and <span + id="dx1-132057"></a> and <span class="cmtt-10">firstplural</span><a - id="dx1-135058"></a> keys. The first use singular text is obtained via: -</p><!--l. 8178--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135059"></a> <span + id="dx1-132058"></a> keys. The first use singular text is obtained via: +</p><!--l. 7958--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132059"></a> <span class="cmtt-10">\genacrfullformat{</span>⟨<span 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. 8180--><p class="noindent" > +</p><!--l. 7960--><p class="noindent" > instead of from the <span class="cmtt-10">first</span><a - id="dx1-135060"></a> key, and the first use plural text is obtained via: -</p><!--l. 8183--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135061"></a> <span + id="dx1-132060"></a> key, and the first use plural text is obtained via: +</p><!--l. 7963--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132061"></a> <span class="cmtt-10">\genplacrfullformat{</span>⟨<span 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. 8185--><p class="noindent" > +</p><!--l. 7965--><p class="noindent" > instead of from the <span class="cmtt-10">firstplural</span><a - id="dx1-135062"></a> key. In both cases, ⟨<span + id="dx1-132062"></a> key. In both cases, ⟨<span class="cmti-10">label</span>⟩ is the entry’s label and ⟨<span class="cmti-10">insert</span>⟩ is the insert text provided in the final optional argument of commands like <span class="cmtt-10">\gls</span><a - id="dx1-135063"></a>. The default behaviour is to do the long form (or + id="dx1-132063"></a>. The default behaviour is to do the long form (or plural long form) followed by ⟨<span class="cmti-10">insert</span>⟩ and a space and the short form (or plural short form) in parentheses, where the short form is in the argument of <span class="cmtt-10">\firstacronymfont</span><a - id="dx1-135064"></a>. There are also first letter upper case + id="dx1-132064"></a>. There are also first letter upper case versions: -</p><!--l. 8194--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135065"></a> <span +</p><!--l. 7974--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132065"></a> <span class="cmtt-10">\Genacrfullformat{</span>⟨<span 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. 8196--><p class="noindent" > +</p><!--l. 7976--><p class="noindent" > and -</p><!--l. 8198--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135066"></a> <span +</p><!--l. 7978--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132066"></a> <span class="cmtt-10">\Genplacrfullformat{</span>⟨<span 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. 8200--><p class="noindent" > -By default these perform a protected expansion on their no-case-change equivalents and then use <span +</p><!--l. 7980--><p class="noindent" > +By default these perform a protected expansion on their no-case-change equivalents and then use +<span class="cmtt-10">\makefirstuc</span><a - id="dx1-135067"></a> -to convert the first character to upper case. If there are issues caused by this expansion, you will need to -redefine those commands to explicitly use commands like <span + id="dx1-132067"></a> to convert the first character to upper case. If there are issues caused by this expansion, you +will need to redefine those commands to explicitly use commands like <span class="cmtt-10">\Glsentrylong</span><a - id="dx1-135068"></a> (which is what the predefined -acronym styles, such as <span + id="dx1-132068"></a> (which is +what the predefined acronym styles, such as <span class="cmss-10">long-short</span><a - id="dx1-135069"></a>, do). Otherwise, you only need to redefine <span -class="cmtt-10">\genacrfullformat</span><a - id="dx1-135070"></a> and - - + id="dx1-132069"></a>, do). Otherwise, you only need to redefine <span +class="cmtt-10">\genacrfullformat</span><a + id="dx1-132070"></a> and <span class="cmtt-10">\genplacrfullformat</span><a - id="dx1-135071"></a> to change the behaviour of <span + id="dx1-132071"></a> to change the behaviour of <span class="cmtt-10">\glsgenacfmt</span><a - id="dx1-135072"></a>. See <a -href="#sec:acronyms">§13 </a><a -href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> -for further details on changing the style of acronyms. -</p><!--l. 8212--><p class="indent" > <div class="important" title="Important Note"> Note that <span + id="dx1-132072"></a>. See + + +<a +href="#sec:acronyms">§<span +class="cmbx-10">??</span>sec:acronyms </a><a +href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> for further details on changing the style of +acronyms. +</p><!--l. 7992--><p class="indent" > <div class="important" title="Important Note"> Note that <span class="cmtt-10">\glsentryfmt </span>(or the formatting given by <span class="cmtt-10">\defglsentryfmt</span>) is not used by the <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands. </div> -</p><!--l. 8215--><p class="noindent" > -</p><!--l. 8217--><p class="indent" > As from version 4.16, both the <a +</p><!--l. 7995--><p class="noindent" > +</p><!--l. 7997--><p class="indent" > As from version 4.16, both the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> and <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands use -</p><!--l. 8219--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135073"></a> <span +</p><!--l. 7999--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132073"></a> <span class="cmtt-10">\glslinkpostsetkeys </span></div><hr> -</p><!--l. 8221--><p class="noindent" > +</p><!--l. 8001--><p class="noindent" > after the ⟨<span class="cmti-10">options</span>⟩ are set. This macro does nothing by default but can be redefined. (For example, to switch off the hyperlink under certain conditions.) This version also introduces -</p><!--l. 8225--><p class="indent" > <hr><div title="Definition"><a - id="dx1-135074"></a> <span +</p><!--l. 8005--><p class="indent" > <hr><div title="Definition"><a + id="dx1-132074"></a> <span class="cmtt-10">\glspostlinkhook </span></div><hr> -</p><!--l. 8227--><p class="noindent" > +</p><!--l. 8007--><p class="noindent" > which is done after the link text has been displayed and also <span class="cmti-10">after </span>the <a href="#glo:firstuseflag">first use flag</a> has been unset (see example <a -href="#ex:dotabbr">25<!--tex4ht:ref: ex:dotabbr --></a>). +href="#ex:dotabbr">18<!--tex4ht:ref: ex:dotabbr --></a>). <a id="ex:customfmt"></a> -</p><!--l. 8232--><p class="noindent" ><span +</p><!--l. 8012--><p class="noindent" ><span class="cmbx-12">Example 8</span><span class="cmbx-12"> (Custom Entry Display in Text)</span><a - id="x1-135076"></a> -</p><!--l. 8233--><p class="indent" > Suppose you want a glossary of measurements and units, you can use the <span + id="x1-132076"></a> +</p><!--l. 8013--><p class="indent" > Suppose you want a glossary of measurements and units, you can use the <span class="cmtt-10">symbol</span><a - id="dx1-135077"></a> key to store the + id="dx1-132077"></a> key to store the unit: </p> - <div class="verbatim" id="verbatim-228"> + <pre class="verbatim" id="verbatim-210"> \newglossaryentry{distance}{name=distance, - <br />description={The length between two points}, - <br />symbol={km}} -</div> -<!--l. 8239--><p class="nopar" > and now suppose you want <span class="obeylines-h"><span class="verb"><span +description={The length between two points}, +symbol={km}} +</pre> +<!--l. 8019--><p class="nopar" > and now suppose you want <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{distance}</span></span></span> to produce “distance (km)” on <a href="#glo:firstuse">first use</a>, then you can redefine <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-135078"></a> as follows: + id="dx1-132078"></a> as follows: </p> - <div class="verbatim" id="verbatim-229"> + <pre class="verbatim" id="verbatim-211"> \renewcommand*{\glsentryfmt}{% - <br />  \glsgenentryfmt - <br />  \ifglsused{\glslabel}{}{\space (\glsentrysymbol{\glslabel})}% - <br />} -</div> -<!--l. 8248--><p class="nopar" > -</p><!--l. 8250--><p class="indent" > (Note that I’ve used <span +  \glsgenentryfmt +  \ifglsused{\glslabel}{}{\space (\glsentrysymbol{\glslabel})}% +} +</pre> +<!--l. 8028--><p class="nopar" > +</p><!--l. 8030--><p class="indent" > (Note that I’ve used <span class="cmtt-10">\glsentrysymbol</span><a - id="dx1-135079"></a> rather than <span + id="dx1-132079"></a> rather than <span class="cmtt-10">\glssymbol</span><a - id="dx1-135080"></a> to avoid nested hyperlinks.) -</p><!--l. 8253--><p class="indent" > Note also that all of the <a + id="dx1-132080"></a> to avoid nested hyperlinks.) +</p><!--l. 8033--><p class="indent" > Note also that all of the <a href="#glo:linktext">link text<a - id="dx1-135081"></a></a> will be formatted according to <span + id="dx1-132081"></a></a> will be formatted according to <span class="cmtt-10">\glstextformat</span><a - id="dx1-135082"></a> (described earlier). So if + id="dx1-132082"></a> (described earlier). So if you do, say: </p> - <div class="verbatim" id="verbatim-230"> + <pre class="verbatim" id="verbatim-212"> \renewcommand{\glstextformat}[1]{\textbf{#1}} - <br />\renewcommand*{\glsentryfmt}{% - <br />  \glsgenentryfmt - <br />  \ifglsused{\glslabel}{}{\space(\glsentrysymbol{\glslabel})}% - <br />} -</div> -<!--l. 8261--><p class="nopar" > then <span class="obeylines-h"><span class="verb"><span +\renewcommand*{\glsentryfmt}{% +  \glsgenentryfmt +  \ifglsused{\glslabel}{}{\space(\glsentrysymbol{\glslabel})}% +} +</pre> +<!--l. 8041--><p class="nopar" > then <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{distance}</span></span></span> will produce “<span class="cmbx-10">distance (km)</span>”. -</p><!--l. 8264--><p class="indent" > For a complete document, see the sample file <a +</p><!--l. 8044--><p class="indent" > For a complete document, see the sample file <a href="#ex:sample-entryfmt"><span class="cmtt-10">sample-entryfmt.tex</span></a>. </p> <div class="center" > -<!--l. 8265--><p class="noindent" > -</p><!--l. 8265--><p class="noindent" >____________________________</p></div> +<!--l. 8045--><p class="noindent" > +</p><!--l. 8045--><p class="noindent" >____________________________</p></div> <a id="ex:defglsentryfmt"></a> -<!--l. 8267--><p class="noindent" ><span +<!--l. 8047--><p class="noindent" ><span class="cmbx-12">Example 9</span><span class="cmbx-12"> (Custom Format for Particular Glossary)</span><a - id="x1-135084"></a> -</p><!--l. 8268--><p class="indent" > Suppose you have created a new glossary called <span + id="x1-132084"></a> +</p><!--l. 8048--><p class="indent" > Suppose you have created a new glossary called <span class="cmtt-10">notation </span>and you want to change the way the entry is displayed on <a href="#glo:firstuse">first use</a> so that it includes the symbol, you can do: </p> - <div class="verbatim" id="verbatim-231"> + <pre class="verbatim" id="verbatim-213"> \defglsentryfmt[notation]{\glsgenentryfmt - <br /> \ifglsused{\glslabel}{}{\space - <br />   (denoted \glsentrysymbol{\glslabel})}} -</div> -<!--l. 8275--><p class="nopar" > Now suppose you have defined an entry as follows: + \ifglsused{\glslabel}{}{\space +   (denoted \glsentrysymbol{\glslabel})}} +</pre> +<!--l. 8055--><p class="nopar" > Now suppose you have defined an entry as follows: </p> - <div class="verbatim" id="verbatim-232"> + <pre class="verbatim" id="verbatim-214"> \newglossaryentry{set}{type=notation, - <br />  name=set, - <br />  description={A collection of objects}, - <br />  symbol={$S$} - <br />} -</div> -<!--l. 8283--><p class="nopar" > The <a +  name=set, +  description={A collection of objects}, +  symbol={$S$} +} +</pre> +<!--l. 8063--><p class="nopar" > The <a href="#glo:firstuse">first time</a> you reference this entry it will be displayed as: “set (denoted <span class="cmmi-10">S</span>)” (assuming <span class="cmtt-10">\gls</span><a - id="dx1-135085"></a> was + id="dx1-132085"></a> was used). -</p><!--l. 8287--><p class="indent" > Alternatively, if you expect all the symbols to be set in math mode, you can do: +</p><!--l. 8067--><p class="indent" > Alternatively, if you expect all the symbols to be set in math mode, you can do: </p> - <div class="verbatim" id="verbatim-233"> + <pre class="verbatim" id="verbatim-215"> \defglsentryfmt[notation]{\glsgenentryfmt - <br /> \ifglsused{\glslabel}{}{\space - <br />   (denoted $\glsentrysymbol{\glslabel}$)}} -</div> -<!--l. 8293--><p class="nopar" > and define entries like this: + \ifglsused{\glslabel}{}{\space +   (denoted $\glsentrysymbol{\glslabel}$)}} +</pre> +<!--l. 8073--><p class="nopar" > and define entries like this: </p> - <div class="verbatim" id="verbatim-234"> + <pre class="verbatim" id="verbatim-216"> \newglossaryentry{set}{type=notation, - <br />  name=set, - <br />  description={A collection of objects}, - <br />  symbol={S} - <br />} -</div> -<!--l. 8301--><p class="nopar" > </p> +  name=set, +  description={A collection of objects}, +  symbol={S} +} +</pre> +<!--l. 8081--><p class="nopar" > </p> <div class="center" > -<!--l. 8302--><p class="noindent" > -</p><!--l. 8302--><p class="noindent" >____________________________</p></div> -<!--l. 8304--><p class="indent" > Remember that if you use the <span +<!--l. 8082--><p class="noindent" > +</p><!--l. 8082--><p class="noindent" >____________________________</p></div> +<!--l. 8084--><p class="indent" > Remember that if you use the <span class="cmtt-10">symbol</span><a - id="dx1-135086"></a> key, you need to use a glossary style that displays the symbol, as many + id="dx1-132086"></a> key, you need to use a glossary style that displays the symbol, as many of the styles ignore it. -</p><!--l. 8308--><p class="noindent" > +</p><!--l. 8088--><p class="noindent" > </p> -<!--l. 8308--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.4 </span> <a - id="sec:disablehyperlinks"></a>Enabling and disabling hyperlinks to glossary entries</h3> -<!--l. 8311--><p class="noindent" >If you load the <span +<!--l. 8088--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">5.1.4 </span> <a + id="sec:disablehyperlinks"></a>Enabling and disabling hyperlinks to glossary entries</h4> +<!--l. 8091--><p class="noindent" >If you load the <span class="cmss-10">hyperref</span><a - id="dx1-136001"></a> or <span + id="dx1-133001"></a> or <span class="cmss-10">html</span><a - id="dx1-136002"></a> packages prior to loading the <span + id="dx1-133002"></a> packages prior to loading the <span class="cmss-10">glossaries </span>package, the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> and @@ -17232,223 +17196,231 @@ class="cmtt-10">\gls</span>-like</a> and href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands will automatically have hyperlinks to the relevant glossary entry, unless the <span class="cmtt-10">hyper</span><a - id="dx1-136003"></a> + id="dx1-133003"></a> option has been switched off (either explicitly or through implicit means, such as via the <span class="cmss-10">nohypertypes</span><a - id="dx1-136004"></a> package + id="dx1-133004"></a> package option). -</p><!--l. 8318--><p class="indent" > You can disable or enable links using: -</p><!--l. 8319--><p class="indent" > <hr><div title="Definition"><a - id="dx1-136005"></a> <span +</p><!--l. 8098--><p class="indent" > You can disable or enable links using: +</p><!--l. 8099--><p class="indent" > <hr><div title="Definition"><a + id="dx1-133005"></a> <span class="cmtt-10">\glsdisablehyper </span></div><hr> -</p><!--l. 8321--><p class="noindent" > +</p><!--l. 8101--><p class="noindent" > and -</p><!--l. 8323--><p class="indent" > <hr><div title="Definition"><a - id="dx1-136006"></a> <span +</p><!--l. 8103--><p class="indent" > <hr><div title="Definition"><a + id="dx1-133006"></a> <span class="cmtt-10">\glsenablehyper </span></div><hr> -</p><!--l. 8325--><p class="noindent" > +</p><!--l. 8105--><p class="noindent" > respectively. The effect can be localised by placing the commands within a group. Note that you should only use <span class="cmtt-10">\glsenablehyper </span>if the commands <span class="cmtt-10">\hyperlink</span><a - id="dx1-136007"></a> and <span + id="dx1-133007"></a> and <span class="cmtt-10">\hypertarget</span><a - id="dx1-136008"></a> have been defined (for example, by the + id="dx1-133008"></a> have been defined (for example, by the <span class="cmss-10">hyperref</span><a - id="dx1-136009"></a> package). -</p><!--l. 8331--><p class="indent" > You can disable just the <a + id="dx1-133009"></a> package). +</p><!--l. 8111--><p class="indent" > You can disable just the <a href="#glo:firstuse">first use</a> links using the package option <span class="cmss-10">hyperfirst</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-136010"></a>. Note that this option only + id="dx1-133010"></a>. Note that this option only affects the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands that recognise the <a href="#glo:firstuseflag">first use flag</a>. <a id="ex:hyperdesc"></a> -</p><!--l. 8335--><p class="noindent" ><span +</p><!--l. 8115--><p class="noindent" ><span class="cmbx-12">Example 10</span><span class="cmbx-12"> (First Use With Hyperlinked Footnote Description)</span><a - id="x1-136012"></a> -</p><!--l. 8336--><p class="indent" > Suppose I want the first use to have a hyperlink to the description in a footnote instead of hyperlinking to + id="x1-133012"></a> +</p><!--l. 8116--><p class="indent" > Suppose I want the first use to have a hyperlink to the description in a footnote instead of hyperlinking to the relevant place in the glossary. First I need to disable the hyperlinks on first use via the package option <span class="cmss-10">hyperfirst</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-136013"></a>: + id="dx1-133013"></a>: </p> - <div class="verbatim" id="verbatim-235"> + <pre class="verbatim" id="verbatim-217"> \usepackage[hyperfirst=false]{glossaries} -</div> -<!--l. 8342--><p class="nopar" > Now I need to redefine <span +</pre> +<!--l. 8122--><p class="nopar" > Now I need to redefine <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-136014"></a> (see <a -href="#sec:glsdisplay">§6.3 </a><a + id="dx1-133014"></a> (see <a +href="#sec:glsdisplay">§<span +class="cmbx-10">??</span>sec:glsdisplay </a><a href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>): </p> - <div class="verbatim" id="verbatim-236"> + <pre class="verbatim" id="verbatim-218"> \renewcommand*{\glsentryfmt}{% - <br />  \glsgenentryfmt - <br />  \ifglsused{\glslabel}{}{\footnote{\glsentrydesc{\glslabel}}}% - <br />} -</div> -<!--l. 8350--><p class="nopar" > -</p><!--l. 8352--><p class="indent" > Now the first use won’t have hyperlinked text, but will be followed by a footnote. See the sample file +  \glsgenentryfmt +  \ifglsused{\glslabel}{}{\footnote{\glsentrydesc{\glslabel}}}% +} +</pre> +<!--l. 8130--><p class="nopar" > +</p><!--l. 8132--><p class="indent" > Now the first use won’t have hyperlinked text, but will be followed by a footnote. See the sample file <a href="#ex:sample-FnDesc"><span class="cmtt-10">sample-FnDesc.tex</span></a> for a complete document. </p> <div class="center" > -<!--l. 8355--><p class="noindent" > -</p><!--l. 8355--><p class="noindent" >____________________________</p></div> -<!--l. 8357--><p class="indent" > Note that the <span +<!--l. 8135--><p class="noindent" > +</p><!--l. 8135--><p class="noindent" >____________________________</p></div> +<!--l. 8137--><p class="indent" > Note that the <span class="cmss-10">hyperfirst</span><a - id="dx1-136015"></a> option applies to all defined glossaries. It may be that you only want to disable the + id="dx1-133015"></a> option applies to all defined glossaries. It may be that you only want to disable the hyperlinks on <a href="#glo:firstuse">first use</a> for glossaries that have a different form on first use. This can be achieved by noting that since the entries that require hyperlinking for all instances have identical first and subsequent text, they can be unset via <span class="cmtt-10">\glsunsetall</span><a - id="dx1-136016"></a> (see <a -href="#sec:glsunset">§14 </a><a + id="dx1-133016"></a> (see <a +href="#sec:glsunset">§<span +class="cmbx-10">??</span>sec:glsunset </a><a href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>) so that the <span class="cmss-10">hyperfirst</span><a - id="dx1-136017"></a> option doesn’t get -applied. + id="dx1-133017"></a> option +doesn’t get applied. <a id="ex:hyperfirst"></a> -</p><!--l. 8367--><p class="noindent" ><span +</p><!--l. 8147--><p class="noindent" ><span class="cmbx-12">Example 11</span><span class="cmbx-12"> (Suppressing Hyperlinks on First Use Just For Acronyms)</span><a - id="x1-136019"></a> -</p><!--l. 8368--><p class="indent" > Suppose I want to suppress the hyperlink on <a + id="x1-133019"></a> +</p><!--l. 8148--><p class="indent" > Suppose I want to suppress the hyperlink on <a href="#glo:firstuse">first use</a> for acronyms but not for entries in the main glossary. I can load the <span class="cmss-10">glossaries </span>package using: </p> - <div class="verbatim" id="verbatim-237"> + <pre class="verbatim" id="verbatim-219"> \usepackage[hyperfirst=false,acronym]{glossaries} -</div> -<!--l. 8373--><p class="nopar" > Once all glossary entries have been defined I then do: +</pre> +<!--l. 8153--><p class="nopar" > Once all glossary entries have been defined I then do: </p> - <div class="verbatim" id="verbatim-238"> + <pre class="verbatim" id="verbatim-220"> \glsunsetall[main] -</div> -<!--l. 8377--><p class="nopar" > +</pre> +<!--l. 8157--><p class="nopar" > </p> <div class="center" > -<!--l. 8379--><p class="noindent" > -</p><!--l. 8379--><p class="noindent" >____________________________</p></div> -<!--l. 8381--><p class="indent" > For more complex requirements, you might find it easier to switch off all hyperlinks via <span +<!--l. 8159--><p class="noindent" > +</p><!--l. 8159--><p class="noindent" >____________________________</p></div> +<!--l. 8161--><p class="indent" > For more complex requirements, you might find it easier to switch off all hyperlinks via <span class="cmtt-10">\glsdisablehyper</span><a - id="dx1-136020"></a> + id="dx1-133020"></a> and put the hyperlinks (where required) within the definition of <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-136021"></a> (see <a -href="#sec:glsdisplay">§6.3 </a><a -href="#sec:glsdisplay">Changing the format of -the link text<!--tex4ht:ref: sec:glsdisplay --></a>) via <span + id="dx1-133021"></a> (see <a +href="#sec:glsdisplay">§<span +class="cmbx-10">??</span>sec:glsdisplay </a><a +href="#sec:glsdisplay">Changing +the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>) via <span class="cmtt-10">\glshyperlink</span><a - id="dx1-136022"></a> (see <a -href="#sec:glsnolink">§9 </a><a -href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>). + id="dx1-133022"></a> (see <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a +href="#sec:glsnolink">Using Glossary Terms Without +Links<!--tex4ht:ref: sec:glsnolink --></a>). <a id="ex:nomathhyper"></a> -</p><!--l. 8388--><p class="noindent" ><span +</p><!--l. 8168--><p class="noindent" ><span class="cmbx-12">Example 12</span><span class="cmbx-12"> (Only Hyperlink in Text Mode Not Math Mode)</span><a - id="x1-136024"></a> -</p><!--l. 8389--><p class="indent" > This is a bit of a contrived example, but suppose, for some reason, I only want the <a + id="x1-133024"></a> +</p><!--l. 8169--><p class="indent" > This is a bit of a contrived example, but suppose, for some reason, I only want the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands to have hyperlinks when used in text mode, but not in math mode. I can do this by adding the glossary to the list of nohypertypes and redefining <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-136025"></a>: + id="dx1-133025"></a>: </p> - <div class="verbatim" id="verbatim-239"> + <pre class="verbatim" id="verbatim-221"> \GlsDeclareNoHyperList{main} - <br />\renewcommand*{\glsentryfmt}{% - <br />  \ifmmode - <br />    \glsgenentryfmt - <br />  \else - <br />    \glsifhyperon - <br />    {\glsgenentryfmt}% hyperlink already on - <br />    {\glshyperlink[\glsgenentryfmt]{\glslabel}}% - <br />  \fi - <br />} -</div> -<!--l. 8406--><p class="nopar" > Note that this doesn’t affect the <a +\renewcommand*{\glsentryfmt}{% +  \ifmmode +    \glsgenentryfmt +  \else +    \glsifhyperon +    {\glsgenentryfmt}% hyperlink already on +    {\glshyperlink[\glsgenentryfmt]{\glslabel}}% +  \fi +} +</pre> +<!--l. 8186--><p class="nopar" > Note that this doesn’t affect the <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands, which will have the hyperlinks off unless they’re forced on using the plus variant. -</p><!--l. 8411--><p class="indent" > See the sample file <a +</p><!--l. 8191--><p class="indent" > See the sample file <a href="#ex:sample-nomathhyper"><span class="cmtt-10">sample-nomathhyper.tex</span></a> for a complete document. </p> <div class="center" > -<!--l. 8413--><p class="noindent" > -</p><!--l. 8413--><p class="noindent" >____________________________</p></div> +<!--l. 8193--><p class="noindent" > +</p><!--l. 8193--><p class="noindent" >____________________________</p></div> <a id="ex:chap-hyperfirst"></a> -<!--l. 8415--><p class="noindent" ><span +<!--l. 8195--><p class="noindent" ><span class="cmbx-12">Example 13</span><span class="cmbx-12"> (One Hyper Link Per Entry Per Chapter)</span><a - id="x1-136027"></a> -</p><!--l. 8416--><p class="indent" > Here’s a more complicated example that will only have the hyperlink on the first time an entry is -used per chapter. This doesn’t involve resetting the <a -href="#glo:firstuseflag">first use flag</a>. Instead it adds a new key using -<span + id="x1-133027"></a> +</p><!--l. 8196--><p class="indent" > Here’s a more complicated example that will only have the hyperlink on the first time an entry is used per +chapter. This doesn’t involve resetting the <a +href="#glo:firstuseflag">first use flag</a>. Instead it adds a new key using <span class="cmtt-10">\glsaddstoragekey</span><a - id="dx1-136028"></a> (see <a -href="#sec:glsaddstoragekey">§4.3.2 </a><a -href="#sec:glsaddstoragekey">Storage Keys<!--tex4ht:ref: sec:glsaddstoragekey --></a>) that keeps track of the chapter number that the entry was last -used in: + id="dx1-133028"></a> +(see <a +href="#sec:glsaddstoragekey">§<span +class="cmbx-10">??</span>sec:glsaddstoragekey </a><a +href="#sec:glsaddstoragekey">Storage Keys<!--tex4ht:ref: sec:glsaddstoragekey --></a>) that keeps track of the chapter number that the entry was last used +in: </p> - <div class="verbatim" id="verbatim-240"> + <pre class="verbatim" id="verbatim-222"> \glsaddstoragekey{chapter}{0}{\glschapnum} -</div> -<!--l. 8423--><p class="nopar" > This creates a new user command called <span +</pre> +<!--l. 8203--><p class="nopar" > This creates a new user command called <span class="cmtt-10">\glschapnum </span>that’s analogous to <span class="cmtt-10">\glsentrytext</span>. The default value for this key is 0. I then define my glossary entries as usual. -</p><!--l. 8428--><p class="indent" > Next I redefine the hook <span +</p><!--l. 8208--><p class="indent" > Next I redefine the hook <span class="cmtt-10">\glslinkpostsetkeys</span><a - id="dx1-136029"></a> (see <a -href="#sec:glsdisplay">§6.3 </a><a -href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>) so that it -determines the current chapter number (which is stored in <span + id="dx1-133029"></a> (see <a +href="#sec:glsdisplay">§<span +class="cmbx-10">??</span>sec:glsdisplay </a><a +href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>) +so that it determines the current chapter number (which is stored in <span class="cmtt-10">\currentchap </span>using <span -class="cmtt-10">\edef</span>). This value is then -compared with the value of the entry’s <span +class="cmtt-10">\edef</span>). This value is +then compared with the value of the entry’s <span class="cmtt-10">chapter </span>key that I defined earlier. If they’re the same, this entry has already been used in this chapter so the hyperlink is switched off using <span class="cmss-10">xkeyval</span><a - id="dx1-136030"></a>’s <span -class="cmtt-10">\setkeys</span> -command. If the chapter number isn’t the same, then this entry hasn’t been used in the current -chapter. The <span + id="dx1-133030"></a>’s <span +class="cmtt-10">\setkeys </span>command. +If the chapter number isn’t the same, then this entry hasn’t been used in the current chapter. +The <span class="cmtt-10">chapter </span>field is updated using <span class="cmtt-10">\glsfieldxdef</span><a - id="dx1-136031"></a> (<a -href="#sec:fetchset">§16.3 </a><a + id="dx1-133031"></a> (<a +href="#sec:fetchset">§<span +class="cmbx-10">??</span>sec:fetchset </a><a href="#sec:fetchset">Fetching and Updating the Value of a Field<!--tex4ht:ref: sec:fetchset --></a>) provided the user hasn’t switched off the hyperlink. (This test is performed using <span @@ -17456,628 +17428,104 @@ class="cmtt-10">\glsifhyperon</span>. </p> - <div class="verbatim" id="verbatim-241"> + <pre class="verbatim" id="verbatim-223"> \renewcommand*{\glslinkpostsetkeys}{% - <br /> \edef\currentchap{\arabic{chapter}}% - <br /> \ifnum\currentchap=\glschapnum{\glslabel}\relax - <br />  \setkeys{glslink}{hyper=false}% - <br /> \else - <br />  \glsifhyperon{\glsfieldxdef{\glslabel}{chapter}{\currentchap}}{}% - <br /> \fi - <br />} -</div> -<!--l. 8449--><p class="nopar" > Note that this will be confused if you use <span + \edef\currentchap{\arabic{chapter}}% + \ifnum\currentchap=\glschapnum{\glslabel}\relax +  \setkeys{glslink}{hyper=false}% + \else +  \glsifhyperon{\glsfieldxdef{\glslabel}{chapter}{\currentchap}}{}% + \fi +} +</pre> +<!--l. 8229--><p class="nopar" > Note that this will be confused if you use <span class="cmtt-10">\gls </span>etc when the chapter counter is 0. (That is, before the first <span class="cmtt-10">\chapter</span>.) -</p><!--l. 8453--><p class="indent" > See the sample file <a +</p><!--l. 8233--><p class="indent" > See the sample file <a href="#ex:sample-chap-hyperfirst"><span class="cmtt-10">sample-chap-hyperfirst.tex</span></a> for a complete document. </p> <div class="center" > -<!--l. 8455--><p class="noindent" > -</p><!--l. 8455--><p class="noindent" >____________________________</p></div> - - -<!--l. 8457--><p class="indent" > </div> -</p><!--l. 8457--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">7. <a - id="sec:glsadd"></a>Adding an Entry to the Glossary Without Generating Text</h2> -</p><!--l. 8460--><p class="indent" > It is possible to add a line to the glossary file without generating any text at that point in the document -using: -</p><!--l. 8462--><p class="indent" > <hr><div title="Definition"><a - id="dx1-137001"></a> <span -class="cmtt-10">\glsadd[</span>⟨<span -class="cmitt-10">options</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">label</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 8464--><p class="noindent" > -This is similar to the <a -href="#sec:glstext-like"><span -class="cmtt-10">\glstext</span>-like</a> commands, only it doesn’t produce any text (so therefore, there is no <span -class="cmtt-10">hyper</span><a - id="dx1-137002"></a> -key available in ⟨<span -class="cmti-10">options</span>⟩ but all the other options that can be used with <a -href="#sec:glstext-like"><span -class="cmtt-10">\glstext</span>-like</a> commands can be passed -to <span -class="cmtt-10">\glsadd</span>). For example, to add a page range to the glossary number list for the entry whose label is given by -<span -class="cmtt-10">set</span>: - - -</p> - <div class="verbatim" id="verbatim-242"> -\glsadd[format=(]{set} - <br />Lots of text about sets spanning many pages. - <br />\glsadd[format=)]{set} -</div> -<!--l. 8475--><p class="nopar" > -</p><!--l. 8477--><p class="indent" > To add all entries that have been defined, use: -</p><!--l. 8478--><p class="indent" > <hr><div title="Definition"><a - id="dx1-137003"></a> <span -class="cmtt-10">\glsaddall[</span>⟨<span -class="cmitt-10">options</span>⟩<span -class="cmtt-10">] </span></div><hr> -</p><!--l. 8480--><p class="noindent" > -The optional argument is the same as for <span -class="cmtt-10">\glsadd</span>, except there is also a key <span -class="cmtt-10">types</span><a - id="dx1-137004"></a> which can be -used to specify which glossaries to use. This should be a comma-separated list. For example, if -you only want to add all the entries belonging to the list of acronyms (specified by the glossary -type <span -class="cmtt-10">\acronymtype</span><a - id="dx1-137005"></a>) and a list of notation (specified by the glossary type <span -class="cmtt-10">notation</span>) then you can -do: - - -</p> - <div class="verbatim" id="verbatim-243"> -\glsaddall[types={\acronymtype,notation}] -</div> -<!--l. 8491--><p class="nopar" > If you are using <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-137006"></a></a> with <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, you can’t use <span -class="cmtt-10">\glsaddall</span>. Instead use the <span -class="cmss-10">selection=all </span>resource -option to select all entries in the given <span -class="cmtt-10">bib</span><a - id="dx1-137007"></a> files. -</p><!--l. 8496--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\glsadd </span>and <span -class="cmtt-10">\glsaddall </span>add the current location to the <a -href="#glo:numberlist">number list<a - id="dx1-137008"></a></a>. In the case of <span -class="cmtt-10">\glsaddall</span>, -all entries in the glossary will have the same location in the number list. If you want to use <span -class="cmtt-10">\glsaddall</span>, it’s -best to suppress the number list with the <span -class="cmss-10">nonumberlist</span><a - id="dx1-137009"></a> package option. (See sections <a -href="#sec:pkgopts-printglos">2.3<!--tex4ht:ref: sec:pkgopts-printglos --></a> and <a -href="#sec:numberlists">5<!--tex4ht:ref: sec:numberlists --></a>.) -</div> -</p><!--l. 8503--><p class="noindent" > -</p><!--l. 8505--><p class="indent" > There is now a variation of <span -class="cmtt-10">\glsaddall </span>that skips any entries that have already been used: -</p><!--l. 8507--><p class="indent" > <hr><div title="Definition"><a - id="dx1-137010"></a> <span -class="cmtt-10">\glsaddallunused[</span>⟨<span -class="cmitt-10">list</span>⟩<span -class="cmtt-10">] </span></div><hr> -</p><!--l. 8509--><p class="noindent" > -This command uses <span -class="cmtt-10">\glsadd[format=glsignore] </span>which will ignore this location in the number list. The -optional argument ⟨<span -class="cmti-10">list</span>⟩ is a comma-separated list of glossary types. If omitted, it defaults to the list of all defined -glossaries. -</p><!--l. 8515--><p class="indent" > <div class="important" title="Important Note"> If you want to use <span -class="cmtt-10">\glsaddallunused</span>, it’s best to place the command at the end of the document to ensure -that all the commands you intend to use have already been used. Otherwise you could end up with a spurious -comma or dash in the location list. </div> -</p><!--l. 8520--><p class="noindent" > -</p><!--l. 8522--><p class="indent" > With <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> and <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-137011"></a></a>, <span -class="cmtt-10">glsignore </span>indicates an “ignored location” which influences selection but -isn’t added to the location list. In this case, if you use <span -class="cmss-10">selection=all </span>then only those entries that have been -explicitly indexed in the document will have location lists. The other entries that were selected as a result of -<span -class="cmss-10">selection=all </span>won’t have location lists. -</p><!--l. 8530--><p class="indent" > Base <span -class="cmss-10">glossaries</span><a - id="dx1-137012"></a> package only: - - -</p> - <div class="verbatim" id="verbatim-244"> -\documentclass{article} - <br />\usepackage{glossaries} - <br />\makeglossaries - <br />\newglossaryentry{cat}{name={cat},description={feline}} - <br />\newglossaryentry{dog}{name={dog},description={canine}} - <br />\begin{document} - <br />\gls{cat}. - <br />\printglossaries - <br />\glsaddallunused % <- make sure dog is also listed - <br />\end{document} -</div> -<!--l. 8542--><p class="nopar" > Corresponding <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> and <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-137013"></a></a> document code: - - -</p> - <div class="verbatim" id="verbatim-245"> -\documentclass{article} - <br />\usepackage[record]{glossaries-extra} - <br />\GlsXtrLoadResources[src={entries},selection=all] - <br />\begin{document} - <br />\gls{cat}. - <br />\printunsrtglossaries - <br />\end{document} -</div> -<!--l. 8552--><p class="nopar" > With the file <span -class="cmtt-10">entries.bib</span>: - - -</p> - <div class="verbatim" id="verbatim-246"> -@entry{cat,name={cat},description={feline}} - <br />@entry{dog,name={dog},description={canine}} -</div> -<!--l. 8557--><p class="nopar" > -<a - id="ex:dual"></a> -</p><!--l. 8559--><p class="noindent" ><span -class="cmbx-12">Example 14</span><span -class="cmbx-12"> (Dual Entries)</span><a - id="x1-137015"></a> -</p><!--l. 8560--><p class="indent" > The example file <a -href="#ex:sample-dual"><span -class="cmtt-10">sample-dual.tex</span></a> makes use of <span -class="cmtt-10">\glsadd </span>to allow for an entry that should appear both in -the main glossary and in the list of acronyms. This example sets up the list of acronyms using the <span -class="cmss-10">acronym</span><a - id="dx1-137016"></a> -package option: - - -</p> - <div class="verbatim" id="verbatim-247"> -\usepackage[acronym]{glossaries} -</div> -<!--l. 8566--><p class="nopar" > A new command is then defined to make it easier to define dual entries: - - -</p> - <div class="verbatim" id="verbatim-248"> -\newcommand*{\newdualentry}[5][]{% - <br />  \newglossaryentry{main-#2}{name={#4},% - <br />  text={#3\glsadd{#2}},% - <br />  description={#5},% - <br />  #1 - <br />  }% - <br />  \newacronym{#2}{#3\glsadd{main-#2}}{#4}% - <br />} -</div> -<!--l. 8578--><p class="nopar" > This has the following syntax: </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">\newdualentry</span><a - id="dx1-137017"></a><span -class="cmtt-10">[</span>⟨<span -class="cmitt-10">options</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">label</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">abbrv</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">long</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">description</span>⟩<span -class="cmtt-10">}</span> -</div> -</div> You can then define a new dual entry: - - - <div class="verbatim" id="verbatim-249"> -\newdualentry{svm}% label - <br />  {SVM}% abbreviation - <br />  {support vector machine}% long form - <br />  {Statistical pattern recognition technique}% description -</div> -<!--l. 8589--><p class="nopar" > Now you can reference the acronym with <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\gls{svm}</span></span></span> or you can reference the entry in the main glossary with -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\gls{main-svm}</span></span></span>. -</p><!--l. 8593--><p class="indent" > Note that with <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-137018"></a></a>, there are special dual entry types that implement this behaviour. That is, if an -entry is referenced then its corresponding dual entry will automatically be selected as well. So there -is less need for <span -class="cmtt-10">\glsadd </span>with <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-137019"></a></a>. (Although it can still be useful, as shown in <a -href="#option6">Option 6</a>.) -</p> -<div class="center" -> -<!--l. 8598--><p class="noindent" > -</p><!--l. 8598--><p class="noindent" >____________________________</p></div> - - -<!--l. 8600--><p class="indent" > </div> -</p><!--l. 8600--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">8. <a - id="sec:crossref"></a>Cross-Referencing Entries</h2> -</p><!--l. 8603--><p class="indent" > <div class="important" title="Important Note"> You must use <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-138001"></a> (Options <a -href="#option2">2</a> or <a -href="#option3">3</a>) or <span -class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-138002"></a> (<a -href="#option1">Option 1</a>) <span -class="cmti-10">before</span> -defining any terms that cross-reference entries. If any of the terms that you have cross-referenced -don’t appear in the glossary, check that you have put <span -class="cmtt-10">\makeglossaries</span>/<span -class="cmtt-10">\makenoidxglossaries</span> -before all entry definitions. The <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package provides better cross-reference handling. -</div> -</p><!--l. 8611--><p class="noindent" > -</p><!--l. 8613--><p class="indent" > There are several ways of cross-referencing entries in the glossary: - </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-138004x1">You can use commands such as <span -class="cmtt-10">\gls</span><a - id="dx1-138005"></a> in the entries description. For example: - - - <div class="verbatim" id="verbatim-250"> - \newglossaryentry{apple}{name=apple, -  <br />description={firm, round fruit. See also \gls{pear}}} -</div> - <!--l. 8622--><p class="nopar" > Note that with this method, if you don’t use the cross-referenced term in the main part of the document, - you will need two runs of <a -href="#glo:makeglossaries"><span -class="cmtt-10">makeglossaries</span><a - id="dx1-138006"></a></a>: - </p><!--l. 8626--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> - <br />pdflatex filename - <br />makeglossaries filename - <br />pdflatex filename - <br />makeglossaries filename - <br />pdflatex filename - <br /></pre><spacer type=vertical size=10> - <br /></span> - </p></li> - <li - class="enumerate" id="x1-138008x2">As described in <a -href="#sec:newglosentry">§4 </a><a -href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>, you can use the <span -class="cmtt-10">see</span><a - id="dx1-138009"></a> key when you define the entry. For - example: - - - <div class="verbatim" id="verbatim-251"> - \newglossaryentry{MaclaurinSeries}{name={Maclaurin -  <br />series}, -  <br />description={Series expansion}, -  <br />see={TaylorsTheorem}} -</div> - <!--l. 8641--><p class="nopar" > Note that in this case, the entry with the <span -class="cmtt-10">see</span><a - id="dx1-138010"></a> key will automatically be added to the glossary, but the - cross-referenced entry won’t. You therefore need to ensure that you use the cross-referenced term with the - commands described in <a -href="#sec:glslink">§6 </a><a -href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> or <a -href="#sec:glsadd">§7 </a><a -href="#sec:glsadd">Adding an Entry to the Glossary Without - Generating Text<!--tex4ht:ref: sec:glsadd --></a>. - </p><!--l. 8648--><p class="noindent" >The “see” tag is produce using <span -class="cmtt-10">\seename</span><a - id="dx1-138011"></a>, but can be overridden in specific instances using square brackets - at the start of the <span -class="cmtt-10">see</span><a - id="dx1-138012"></a> value. For example: - - -</p> - <div class="verbatim" id="verbatim-252"> - \newglossaryentry{MaclaurinSeries}{name={Maclaurin -  <br />series}, -  <br />description={Series expansion}, -  <br />see=[see also]{TaylorsTheorem}} -</div> - <!--l. 8656--><p class="nopar" > Take care if you want to use the optional argument of commands such as <span -class="cmtt-10">\newacronym</span><a - id="dx1-138013"></a> or <span -class="cmtt-10">\newterm</span><a - id="dx1-138014"></a> as - the value will need to be grouped. For example: - - -</p> - <div class="verbatim" id="verbatim-253"> - \newterm{seal} -  <br />\newterm[see={[see also]seal}]{sea lion} -</div> - <!--l. 8663--><p class="nopar" > Similarly if the value contains a list. For example: - - -</p> - <div class="verbatim" id="verbatim-254"> - \glossaryentry{lemon}{ -  <br />  name={lemon}, -  <br />  description={Yellow citrus fruit} -  <br />} -  <br />\glossaryentry{lime} -  <br />{ -  <br />  name={lime}, -  <br />  description={Green citrus fruit} -  <br />} -  <br />\glossaryentry{citrus} -  <br />{ -  <br />  name={citrus}, -  <br />  description={Plant in the Rutaceae family}, -  <br />  see={lemon,lime} -  <br />} -</div> - <!--l. 8681--><p class="nopar" > - </p></li> - <li - class="enumerate" id="x1-138016x3">After you have defined the entry, use - <!--l. 8684--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-138017"></a> <span -class="cmtt-10">\glssee[</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">label</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">xr label list</span>⟩<span -class="cmtt-10">} </span></div><hr> - </p><!--l. 8686--><p class="noindent" > - where ⟨<span -class="cmti-10">xr label list</span>⟩ is a comma-separated list of entry labels to be cross-referenced, ⟨<span -class="cmti-10">label</span>⟩ is the label of the - entry doing the cross-referencing and ⟨<span -class="cmti-10">tag</span>⟩ is the “see” tag. (The default value of ⟨<span -class="cmti-10">tag</span>⟩ is <span -class="cmtt-10">\seename</span><a - id="dx1-138018"></a>.) For - example: - - -</p> - <div class="verbatim" id="verbatim-255"> - \glssee[see also]{series}{FourierSeries,TaylorsTheorem} -</div> - <!--l. 8694--><p class="nopar" > Note that this automatically adds the entry given by ⟨<span -class="cmti-10">label</span>⟩ to the glossary but doesn’t add the - cross-referenced entries (specified by ⟨<span -class="cmti-10">xr label list</span>⟩) to the glossary.</p></li></ol> -<!--l. 8700--><p class="indent" > In both cases 2 and 3 above, the cross-referenced information appears in the <a -href="#glo:numberlist">number list<a - id="dx1-138019"></a></a>, whereas in case 1, -the cross-referenced information appears in the description. (See the <a -href="#ex:sample-crossref"><span -class="cmtt-10">sample-crossref.tex</span></a> example file that -comes with this package.) This means that in cases 2 and 3, the cross-referencing information won’t appear if -you have suppressed the number list<a - id="dx1-138020"></a>. In this case, you will need to activate the number list<a - id="dx1-138021"></a> for -the given entries using <span -class="cmtt-10">nonumberlist=false</span><a - id="dx1-138022"></a>. Alternatively, if you just use the <span -class="cmtt-10">see</span><a - id="dx1-138023"></a> key instead -of <span -class="cmtt-10">\glssee</span><a - id="dx1-138024"></a>, you can automatically activate the number list<a - id="dx1-138025"></a> using the <span -class="cmss-10">seeautonumberlist</span><a - id="dx1-138026"></a> package -option. +<!--l. 8235--><p class="noindent" > +</p><!--l. 8235--><p class="noindent" >____________________________</p></div> +<!--l. 8237--><p class="noindent" > </p> -<!--l. 8712--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">8.1 </span> <a - id="sec:customxr"></a>Customising Cross-reference Text</h3> -<!--l. 8715--><p class="noindent" >When you use either the <span -class="cmtt-10">see</span><a - id="dx1-139001"></a> key or the command <span -class="cmtt-10">\glssee</span>, the cross-referencing information will be typeset in -the glossary according to: -</p><!--l. 8718--><p class="indent" > <hr><div title="Definition"><a - id="dx1-139002"></a> <span -class="cmtt-10">\glsseeformat[</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">label-list</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">location</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 8720--><p class="noindent" > -The default definition of <span -class="cmtt-10">\glsseeformat </span>is: <spacer type=vertical size=10><span class="obeylines-h"> - <br /><span -class="cmtt-10">\emph{</span>⟨<span -class="cmti-10">tag</span>⟩<span -class="cmtt-10">} \glsseelist{</span>⟨<span -class="cmti-10">label-list</span>⟩<span -class="cmtt-10">}</span> - <br /><spacer type=vertical size=10></span> -Note that the location is always ignored.<span class="footnote-mark"><a -href="#fn1x8" id="fn1x8-bk"><sup class="textsuperscript">8.1</sup></a></span><a - id="x1-139003f1"></a> -For example, if you want the tag to appear in bold, you can -do:<span class="footnote-mark"><a -href="#fn2x8" id="fn2x8-bk"><sup class="textsuperscript">8.2</sup></a></span><a - id="x1-139005f2"></a> - - -</p> - <div class="verbatim" id="verbatim-256"> -\renewcommand*{\glsseeformat}[3][\seename]{\textbf{#1} - <br /> \glsseelist{#2}} -</div> -<!--l. 8736--><p class="nopar" > -</p><!--l. 8739--><p class="indent" > The list of labels is dealt with by <span -class="cmtt-10">\glsseelist</span>, which iterates through the list and typesets each entry in -the label. The entries are separated by -</p><!--l. 8742--><p class="indent" > <hr><div title="Definition"><a - id="dx1-139008"></a> <span -class="cmtt-10">\glsseesep </span></div><hr> -</p><!--l. 8744--><p class="noindent" > -or (for the last pair) -</p><!--l. 8746--><p class="indent" > <hr><div title="Definition"><a - id="dx1-139009"></a> <span -class="cmtt-10">\glsseelastsep </span></div><hr> -</p><!--l. 8748--><p class="noindent" > -These default to “<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">,\space</span></span></span>” and “<span -class="cmtt-10">\space\andname</span><a - id="dx1-139010"></a><span -class="cmtt-10">\space</span>” respectively. The list entry text is displayed -using: -</p><!--l. 8752--><p class="indent" > <hr><div title="Definition"><a - id="dx1-139011"></a> <span -class="cmtt-10">\glsseeitemformat{</span>⟨<span -class="cmitt-10">label</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 8754--><p class="noindent" > -This defaults to <span -class="cmtt-10">\glsentrytext</span><a - id="dx1-139012"></a><span -class="cmtt-10">{</span>⟨<span -class="cmti-10">label</span>⟩<span -class="cmtt-10">}</span>.<span class="footnote-mark"><a -href="#fn3x8" id="fn3x8-bk"><sup class="textsuperscript">8.3</sup></a></span><a - id="x1-139013f3"></a> -For example, to make the cross-referenced list use small caps: - - -</p> - <div class="verbatim" id="verbatim-257"> -\renewcommand{\glsseeitemformat}[1]{% - <br />  \textsc{\glsentrytext{#1}}} -</div> -<!--l. 8762--><p class="nopar" > -</p><!--l. 8764--><p class="indent" > <div class="important" title="Important Note"> You can use <span -class="cmtt-10">\glsseeformat</span><a - id="dx1-139016"></a> and <span -class="cmtt-10">\glsseelist</span><a - id="dx1-139017"></a> in the main body of the text, but they won’t automatically -add the cross-referenced entries to the glossary. If you want them added with that location, you can -do: - - -</p> - <div class="verbatim" id="verbatim-258"> -Some information (see also - <br />\glsseelist{FourierSeries,TaylorsTheorem}% - <br />\glsadd{FourierSeries}\glsadd{TaylorsTheorem}). -</div> -<!--l. 8773--><p class="nopar" > </div> -</p><!--l. 8774--><p class="noindent" > - - -</p> -<!--l. 8776--><p class="indent" > </div> -</p><!--l. 8776--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">9. <a - id="sec:glsnolink"></a>Using Glossary Terms Without Links</h2> -</p><!--l. 8779--><p class="indent" > The commands described in this section display entry details without adding any information to the -glossary. They don’t use <span +<!--l. 8237--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5.2 </span> <a + id="sec:glsnolink"></a>Using Glossary Terms Without Links</h3> +<!--l. 8240--><p class="noindent" >The commands described in this section display entry details without adding any information to the glossary. +They don’t use <span class="cmtt-10">\glstextformat</span><a - id="dx1-140001"></a>, they don’t have any optional arguments, they don’t affect the <a -href="#glo:firstuseflag">first -use flag</a> and, apart from <span + id="dx1-134001"></a>, they don’t have any optional arguments, they don’t affect the <a +href="#glo:firstuseflag">first use +flag</a> and, apart from <span class="cmtt-10">\glshyperlink</span><a - id="dx1-140002"></a>, they don’t produce hyperlinks. -</p><!--l. 8785--><p class="indent" > <div class="important" title="Important Note"> Commands that aren’t expandable will be ignored by PDF bookmarks, so you will need to provide an + id="dx1-134002"></a>, they don’t produce hyperlinks. +</p><!--l. 8246--><p class="indent" > <div class="important" title="Important Note"> Commands that aren’t expandable will be ignored by PDF bookmarks, so you will need to provide an alternative via <span class="cmss-10">hyperref</span><a - id="dx1-140003"></a>’s <span + id="dx1-134003"></a>’s <span class="cmtt-10">\texorpdfstring </span>if you want to use them in sectioning commands. (This isn’t specific to the <span class="cmss-10">glossaries </span>package.) See the <span class="cmss-10">hyperref</span><a - id="dx1-140004"></a> documentation for further details. All the commands that convert the + id="dx1-134004"></a> documentation for further details. All the commands that convert the first letter to upper case aren’t expandable. The other commands depend on whether their corresponding keys were assigned non-expandable values. </div> -</p><!--l. 8794--><p class="noindent" > -</p><!--l. 8796--><p class="indent" > If you want to title case a field, you can use: -</p><!--l. 8797--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140005"></a> <span +</p><!--l. 8255--><p class="noindent" > +</p><!--l. 8257--><p class="indent" > If you want to title case a field, you can use: +</p><!--l. 8258--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134005"></a> <span class="cmtt-10">\glsentrytitlecase{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8799--><p class="noindent" > +</p><!--l. 8260--><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 -href="#tab:fieldmap">table 4.1</a>). For +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>). For example: </p> - <div class="verbatim" id="verbatim-259"> + <pre class="verbatim" id="verbatim-224"> \glsentrytitlecase{sample}{desc} -</div> -<!--l. 8805--><p class="nopar" > (If you want title-casing in your glossary style, you might want to investigate the <a +</pre> +<!--l. 8266--><p class="nopar" > (If you want title-casing in your glossary style, you might want to investigate the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package.) This command will trigger an error if the entry is undefined. -</p><!--l. 8810--><p class="indent" > Note that this command has the same limitations as <span +</p><!--l. 8271--><p class="indent" > Note that this command has the same limitations as <span class="cmtt-10">\makefirstuc </span>which is used by commands like <span class="cmtt-10">\Gls</span> and <span class="cmtt-10">\Glsentryname </span>to upper-case the first letter (see the notes about <span class="cmtt-10">\Gls </span>in <a -href="#sec:gls-like">§6.1 </a><a +href="#sec:gls-like">§<span +class="cmbx-10">??</span>sec:gls-like </a><a href="#sec:gls-like">The <span -class="cmtt-10">\gls</span>-Like Commands -(First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a>). -</p><!--l. 8814--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140006"></a> <span +class="cmtt-10">\gls</span>-Like +Commands (First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a>). +</p><!--l. 8275--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134006"></a> <span class="cmtt-10">\glsentryname{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8816--><p class="noindent" > -</p><!--l. 8817--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140007"></a> <span +</p><!--l. 8277--><p class="noindent" > +</p><!--l. 8278--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134007"></a> <span class="cmtt-10">\Glsentryname{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8819--><p class="noindent" > +</p><!--l. 8280--><p class="noindent" > These commands display the name of the glossary entry given by ⟨<span class="cmti-10">label</span>⟩, as specified by the <span class="cmtt-10">name</span><a - id="dx1-140008"></a> key. + id="dx1-134008"></a> key. <span class="cmtt-10">\Glsentryname </span>makes the first letter upper case. Neither of these commands check for the existence of ⟨<span class="cmti-10">label</span>⟩. @@ -18085,26 +17533,26 @@ The first form <span class="cmtt-10">\glsentryname </span>is expandable (unless the name contains unexpandable commands). Note that this may be different from the values of the <span class="cmtt-10">text</span><a - id="dx1-140009"></a> or <span + id="dx1-134009"></a> or <span class="cmtt-10">first</span><a - id="dx1-140010"></a> keys. In general it’s better to use <span + id="dx1-134010"></a> keys. In general it’s better to use <span class="cmtt-10">\glsentrytext </span>or <span class="cmtt-10">\glsentryfirst </span>instead of <span class="cmtt-10">\glsentryname</span>. -</p><!--l. 8830--><p class="indent" > <div class="important" title="Important Note"> In general it’s best to avoid <span +</p><!--l. 8291--><p class="indent" > <div class="important" title="Important Note"> In general it’s best to avoid <span class="cmtt-10">\Glsentryname </span>with abbreviations. Instead, consider using <span class="cmtt-10">\Glsentrylong</span>, <span class="cmtt-10">\Glsentryshort </span>or <span class="cmtt-10">\Glsentryfull</span>. </div> -</p><!--l. 8833--><p class="noindent" > -</p><!--l. 8835--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140011"></a> <span +</p><!--l. 8294--><p class="noindent" > +</p><!--l. 8296--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134011"></a> <span class="cmtt-10">\glossentryname{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8837--><p class="noindent" > +</p><!--l. 8298--><p class="noindent" > This is like <span class="cmtt-10">\glsnamefont</span><span class="cmsy-10">{</span><span @@ -18120,158 +17568,158 @@ example: </p> - <div class="verbatim" id="verbatim-260"> + <pre class="verbatim" id="verbatim-225"> \renewcommand*{\glsnamefont}[1]{\textmd{\sffamily #1}} -</div> -<!--l. 8846--><p class="nopar" > -</p><!--l. 8847--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140012"></a> <span +</pre> +<!--l. 8307--><p class="nopar" > +</p><!--l. 8308--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134012"></a> <span class="cmtt-10">\Glossentryname{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8849--><p class="noindent" > +</p><!--l. 8310--><p class="noindent" > This is like <span class="cmtt-10">\glossentryname </span>but makes the first letter of the name upper case. -</p><!--l. 8853--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140013"></a> <span +</p><!--l. 8314--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134013"></a> <span class="cmtt-10">\glsentrytext{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8855--><p class="noindent" > -</p><!--l. 8856--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140014"></a> <span +</p><!--l. 8316--><p class="noindent" > +</p><!--l. 8317--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134014"></a> <span class="cmtt-10">\Glsentrytext{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8858--><p class="noindent" > +</p><!--l. 8319--><p class="noindent" > These commands display the subsequent use text for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩, as specified by the <span class="cmtt-10">text</span><a - id="dx1-140015"></a> + id="dx1-134015"></a> key. <span class="cmtt-10">\Glsentrytext </span>makes the first letter upper case. The first form is expandable (unless the text contains unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8866--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140016"></a> <span +</p><!--l. 8327--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134016"></a> <span class="cmtt-10">\glsentryplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8868--><p class="noindent" > -</p><!--l. 8869--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140017"></a> <span +</p><!--l. 8329--><p class="noindent" > +</p><!--l. 8330--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134017"></a> <span class="cmtt-10">\Glsentryplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8871--><p class="noindent" > +</p><!--l. 8332--><p class="noindent" > These commands display the subsequent use plural text for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩, as specified by the <span class="cmtt-10">plural</span><a - id="dx1-140018"></a> key. <span + id="dx1-134018"></a> key. <span class="cmtt-10">\Glsentryplural </span>makes the first letter upper case. The first form is expandable (unless the value of that key contains unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8880--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140019"></a> <span +</p><!--l. 8341--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134019"></a> <span class="cmtt-10">\glsentryfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8882--><p class="noindent" > -</p><!--l. 8883--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140020"></a> <span +</p><!--l. 8343--><p class="noindent" > +</p><!--l. 8344--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134020"></a> <span class="cmtt-10">\Glsentryfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8885--><p class="noindent" > +</p><!--l. 8346--><p class="noindent" > These commands display the <a href="#glo:firstusetext">first use text</a> for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩, as specified by the <span class="cmtt-10">first</span><a - id="dx1-140021"></a> key. + id="dx1-134021"></a> key. <span class="cmtt-10">\Glsentryfirst </span>makes the first letter upper case. The first form is expandable (unless the value of that key contains unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8893--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140022"></a> <span +</p><!--l. 8354--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134022"></a> <span class="cmtt-10">\glsentryfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8895--><p class="noindent" > -</p><!--l. 8896--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140023"></a> <span +</p><!--l. 8356--><p class="noindent" > +</p><!--l. 8357--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134023"></a> <span class="cmtt-10">\Glsentryfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8898--><p class="noindent" > +</p><!--l. 8359--><p class="noindent" > These commands display the plural form of the <a href="#glo:firstusetext">first use text</a> for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩, as specified by the <span class="cmtt-10">firstplural</span><a - id="dx1-140024"></a> key. <span + id="dx1-134024"></a> key. <span class="cmtt-10">\Glsentryfirstplural </span>makes the first letter upper case. The first form is expandable (unless the value of that key contains unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8907--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140025"></a> <span + + +</p><!--l. 8368--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134025"></a> <span class="cmtt-10">\glsentrydesc{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> - - -</p><!--l. 8909--><p class="noindent" > -</p><!--l. 8910--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140026"></a> <span +</p><!--l. 8370--><p class="noindent" > +</p><!--l. 8371--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134026"></a> <span class="cmtt-10">\Glsentrydesc{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8912--><p class="noindent" > +</p><!--l. 8373--><p class="noindent" > These commands display the description for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8916--><p class="indent" > <span +</p><!--l. 8377--><p class="indent" > <span class="cmtt-10">\Glsentrydesc </span>makes the first letter upper case. The first form is expandable (unless the value of that key contains unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8921--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140027"></a> <span +</p><!--l. 8382--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134027"></a> <span class="cmtt-10">\glossentrydesc{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8923--><p class="noindent" > +</p><!--l. 8384--><p class="noindent" > This is like <span class="cmtt-10">\glsentrydesc{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">} </span>but also checks for the existence of ⟨<span class="cmti-10">label</span>⟩. This command is not expandable. It’s used in the predefined glossary styles to display the description. -</p><!--l. 8928--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140028"></a> <span +</p><!--l. 8389--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134028"></a> <span class="cmtt-10">\Glossentrydesc{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8930--><p class="noindent" > +</p><!--l. 8391--><p class="noindent" > This is like <span class="cmtt-10">\glossentrydesc </span>but converts the first letter to upper case. This command is not expandable. -</p><!--l. 8934--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140029"></a> <span +</p><!--l. 8395--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134029"></a> <span class="cmtt-10">\glsentrydescplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8936--><p class="noindent" > -</p><!--l. 8937--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140030"></a> <span +</p><!--l. 8397--><p class="noindent" > +</p><!--l. 8398--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134030"></a> <span class="cmtt-10">\Glsentrydescplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8939--><p class="noindent" > +</p><!--l. 8400--><p class="noindent" > These commands display the plural description for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩. <span class="cmtt-10">\Glsentrydescplural</span> @@ -18279,27 +17727,27 @@ makes the first letter upper case. The first form is expandable (unless the valu unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8948--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140031"></a> <span +</p><!--l. 8409--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134031"></a> <span class="cmtt-10">\glsentrysymbol{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8950--><p class="noindent" > -</p><!--l. 8951--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140032"></a> <span +</p><!--l. 8411--><p class="noindent" > +</p><!--l. 8412--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134032"></a> <span class="cmtt-10">\Glsentrysymbol{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8953--><p class="noindent" > +</p><!--l. 8414--><p class="noindent" > These commands display the symbol for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8957--><p class="indent" > <span +</p><!--l. 8418--><p class="indent" > <span class="cmtt-10">\Glsentrysymbol </span>makes the first letter upper case. The first form is expandable (unless the value of that key contains unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 8963--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140033"></a> <span +</p><!--l. 8424--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134033"></a> <span class="cmtt-10">\glsletentryfield{</span>⟨<span class="cmitt-10">cs</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -18307,10 +17755,11 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8965--><p class="noindent" > -This command doesn’t display anything. It merely fetches the value associated with the given field (where -the available field names are listed in <a -href="#tab:fieldmap">table 4.1</a>) and stores the result in the control sequence ⟨<span +</p><!--l. 8426--><p class="noindent" > +This command doesn’t display anything. It merely fetches the value associated with the given field (where the +available field names are listed in <a +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>) and stores the result in the control sequence ⟨<span class="cmti-10">cs</span>⟩. For example, to store the description for the entry whose label is “apple” in the control sequence <span class="obeylines-h"><span class="verb"><span @@ -18318,43 +17767,43 @@ class="cmtt-10">\tmp</span></span></span>: </p> - <div class="verbatim" id="verbatim-261"> + <pre class="verbatim" id="verbatim-226"> \glsletentryfield{\tmp}{apple}{desc} -</div> -<!--l. 8974--><p class="nopar" > -</p><!--l. 8976--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140034"></a> <span +</pre> +<!--l. 8435--><p class="nopar" > +</p><!--l. 8437--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134034"></a> <span class="cmtt-10">\glossentrysymbol{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8978--><p class="noindent" > +</p><!--l. 8439--><p class="noindent" > This is like <span class="cmtt-10">\glsentrysymbol{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">} </span>but also checks for the existence of ⟨<span class="cmti-10">label</span>⟩. This command is not expandable. It’s used in some of the predefined glossary styles to display the symbol. -</p><!--l. 8983--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140035"></a> <span +</p><!--l. 8444--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134035"></a> <span class="cmtt-10">\Glossentrysymbol{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8985--><p class="noindent" > +</p><!--l. 8446--><p class="noindent" > This is like <span class="cmtt-10">\glossentrysymbol </span>but converts the first letter to upper case. This command is not expandable. -</p><!--l. 8989--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140036"></a> <span +</p><!--l. 8450--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134036"></a> <span class="cmtt-10">\glsentrysymbolplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8991--><p class="noindent" > -</p><!--l. 8992--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140037"></a> <span +</p><!--l. 8452--><p class="noindent" > +</p><!--l. 8453--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134037"></a> <span class="cmtt-10">\Glsentrysymbolplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 8994--><p class="noindent" > +</p><!--l. 8455--><p class="noindent" > These commands display the plural symbol for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩. <span class="cmtt-10">\Glsentrysymbolplural</span> @@ -18362,140 +17811,143 @@ makes the first letter upper case. The first form is expandable (unless the valu unexpandable commands). The second form is not expandable. Neither checks for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 9002--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140038"></a> <span +</p><!--l. 8463--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134038"></a> <span class="cmtt-10">\glsentryuseri{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9004--><p class="noindent" > -</p><!--l. 9005--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140039"></a> <span +</p><!--l. 8465--><p class="noindent" > +</p><!--l. 8466--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134039"></a> <span class="cmtt-10">\Glsentryuseri{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9007--><p class="noindent" > -</p><!--l. 9008--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140040"></a> <span +</p><!--l. 8468--><p class="noindent" > +</p><!--l. 8469--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134040"></a> <span class="cmtt-10">\glsentryuserii{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9010--><p class="noindent" > -</p><!--l. 9011--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140041"></a> <span +</p><!--l. 8471--><p class="noindent" > +</p><!--l. 8472--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134041"></a> <span class="cmtt-10">\Glsentryuserii{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9013--><p class="noindent" > -</p><!--l. 9014--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140042"></a> <span +</p><!--l. 8474--><p class="noindent" > +</p><!--l. 8475--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134042"></a> <span class="cmtt-10">\glsentryuseriii{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9016--><p class="noindent" > -</p><!--l. 9017--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140043"></a> <span +</p><!--l. 8477--><p class="noindent" > +</p><!--l. 8478--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134043"></a> <span class="cmtt-10">\Glsentryuseriii{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9019--><p class="noindent" > -</p><!--l. 9020--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140044"></a> <span +</p><!--l. 8480--><p class="noindent" > +</p><!--l. 8481--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134044"></a> <span class="cmtt-10">\glsentryuseriv{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9022--><p class="noindent" > -</p><!--l. 9023--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140045"></a> <span +</p><!--l. 8483--><p class="noindent" > +</p><!--l. 8484--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134045"></a> <span class="cmtt-10">\Glsentryuseriv{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9025--><p class="noindent" > -</p><!--l. 9026--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140046"></a> <span +</p><!--l. 8486--><p class="noindent" > +</p><!--l. 8487--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134046"></a> <span class="cmtt-10">\glsentryuserv{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9028--><p class="noindent" > -</p><!--l. 9029--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140047"></a> <span +</p><!--l. 8489--><p class="noindent" > +</p><!--l. 8490--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134047"></a> <span class="cmtt-10">\Glsentryuserv{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9031--><p class="noindent" > -</p><!--l. 9032--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140048"></a> <span +</p><!--l. 8492--><p class="noindent" > +</p><!--l. 8493--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134048"></a> <span class="cmtt-10">\glsentryuservi{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9034--><p class="noindent" > -</p><!--l. 9035--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140049"></a> <span +</p><!--l. 8495--><p class="noindent" > +</p><!--l. 8496--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134049"></a> <span class="cmtt-10">\Glsentryuservi{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9037--><p class="noindent" > +</p><!--l. 8498--><p class="noindent" > These commands display the value of the user keys for the glossary entry given by ⟨<span class="cmti-10">label</span>⟩. The lower case forms are expandable (unless the value of the key contains unexpandable commands). The commands beginning with an upper case letter convert the first letter of the required value to upper case and are not expandable. None of these commands check for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 9046--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140050"></a> <span +</p><!--l. 8507--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134050"></a> <span class="cmtt-10">\glshyperlink[</span>⟨<span class="cmitt-10">link text</span>⟩<span class="cmtt-10">]{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9048--><p class="noindent" > +</p><!--l. 8509--><p class="noindent" > This command provides a hyperlink to the glossary entry given by ⟨<span class="cmti-10">label</span>⟩ <strong>but does not add any information to the glossary file</strong>. The link text is given by <span class="cmtt-10">\glsentrytext</span><a - id="dx1-140051"></a><span + id="dx1-134051"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">} </span>by default<span class="footnote-mark"><a -href="#fn1x9" id="fn1x9-bk"><sup class="textsuperscript">9.1</sup></a></span><a - id="x1-140052f1"></a>, +href="#fn4x5" id="fn4x5-bk"><sup class="textsuperscript">5.4</sup></a></span><a + id="x1-134052f4"></a>, but can be overridden using the optional argument. Note that the hyperlink will be suppressed if you have used <span class="cmtt-10">\glsdisablehyper</span><a - id="dx1-140056"></a> or if you haven’t loaded the <span + id="dx1-134056"></a> or if you haven’t loaded the <span class="cmss-10">hyperref</span><a - id="dx1-140057"></a> package. -</p><!--l. 9059--><p class="indent" > <div class="important" title="Important Note"> If you use <span + id="dx1-134057"></a> package. +</p><!--l. 8520--><p class="indent" > <div class="important" title="Important Note"> If you use <span class="cmtt-10">\glshyperlink</span>, you need to ensure that the relevant entry has been added to the glossary using any of the commands described in <a -href="#sec:glslink">§6 </a><a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink </a><a href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> or <a -href="#sec:glsadd">§7 </a><a -href="#sec:glsadd">Adding an Entry to the Glossary Without -Generating Text<!--tex4ht:ref: sec:glsadd --></a> otherwise you will end up with an undefined link. </div> -</p><!--l. 9064--><p class="noindent" > -</p><!--l. 9066--><p class="indent" > The next two commands are only available with <a +href="#sec:glsadd">§<span +class="cmbx-10">??</span>sec:glsadd </a><a +href="#sec:glsadd">Adding an +Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a> otherwise you will end up with an undefined link. +</div> +</p><!--l. 8525--><p class="noindent" > +</p><!--l. 8527--><p class="indent" > The next two commands are only available with <a href="#option1">Option 1</a> or with the <span class="cmss-10">savenumberlist</span><a - id="dx1-140058"></a> package + id="dx1-134058"></a> package option: -</p><!--l. 9068--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140059"></a> <span +</p><!--l. 8529--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134059"></a> <span class="cmtt-10">\glsentrynumberlist{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9070--><p class="noindent" > -</p><!--l. 9071--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140060"></a> <span +</p><!--l. 8531--><p class="noindent" > +</p><!--l. 8532--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134060"></a> <span class="cmtt-10">\glsdisplaynumberlist{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 9073--><p class="noindent" > +</p><!--l. 8534--><p class="noindent" > Both display the <a href="#glo:numberlist">number list<a - id="dx1-140061"></a></a> for the entry given by ⟨<span + id="dx1-134061"></a></a> for the entry given by ⟨<span class="cmti-10">label</span>⟩. When used with <a href="#option1">Option 1</a> a rerun is required to ensure this list is up-to-date, when used with Options <a @@ -18503,1944 +17955,128 @@ href="#option2">2</a> or <a href="#option3">3</a> a run of <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-140062"></a></a> (or <a + id="dx1-134062"></a></a> (or <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-140063"></a></a>/<a + id="dx1-134063"></a></a>/<a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-140064"></a></a>) + id="dx1-134064"></a></a>) followed by one or two runs of LaTeX is required. -</p><!--l. 9080--><p class="indent" > The first command, <span +</p><!--l. 8541--><p class="indent" > The first command, <span class="cmtt-10">\glsentrynumberlist</span>, simply displays the number list as is. The second command, <span class="cmtt-10">\glsdisplaynumberlist</span>, formats the list using: -</p><!--l. 9083--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140065"></a> <span +</p><!--l. 8544--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134065"></a> <span class="cmtt-10">\glsnumlistsep </span></div><hr> -</p><!--l. 9085--><p class="noindent" > +</p><!--l. 8546--><p class="noindent" > as the separator between all but the last two elements and -</p><!--l. 9087--><p class="indent" > <hr><div title="Definition"><a - id="dx1-140066"></a> <span +</p><!--l. 8548--><p class="indent" > <hr><div title="Definition"><a + id="dx1-134066"></a> <span class="cmtt-10">\glsnumlistlastsep </span></div><hr> -</p><!--l. 9089--><p class="noindent" > +</p><!--l. 8550--><p class="noindent" > between the final two elements. The defaults are <span class="obeylines-h"><span class="verb"><span class="cmtt-10">,␣</span></span></span> and <span class="obeylines-h"><span class="verb"><span class="cmtt-10">␣\&␣</span></span></span>, respectively. -</p><!--l. 9093--><p class="indent" > <div class="important" title="Important Note"> <span -class="cmtt-10">\glsdisplaynumberlist </span>is fairly experimental. It works with <a -href="#option1">Option 1</a>, but for Options <a +</p><!--l. 8554--><p class="indent" > <div class="important" title="Important Note"> <span +class="cmtt-10">\glsdisplaynumberlist </span>is fairly experimental. It works with Options <a +href="#option1">1</a> and <a +href="#option4">4</a>, but for Options <a href="#option2">2</a> or <a href="#option3">3</a> it only works when the default counter format is used (that is, when the <span class="cmtt-10">format</span><a - id="dx1-140067"></a> key is set to + id="dx1-134067"></a> key is set to <span class="cmtt-10">glsnumberformat</span>). This command will only work with <span class="cmss-10">hyperref</span><a - id="dx1-140068"></a> if you choose <a -href="#option1">Option 1</a>. If you try using + id="dx1-134068"></a> if you choose Options <a +href="#option1">1</a> or <a +href="#option4">4</a>. If you try using this command with Options <a href="#option2">2</a> or <a href="#option3">3</a> and <span class="cmss-10">hyperref</span><a - id="dx1-140069"></a>, <span + id="dx1-134069"></a>, <span class="cmtt-10">\glsentrynumberlist </span>will be used instead. </div> -</p><!--l. 9101--><p class="noindent" > -</p><!--l. 9103--><p class="indent" > For further information see “Displaying entry details without adding information to the glossary” in the +</p><!--l. 8562--><p class="noindent" > +</p><!--l. 8564--><p class="indent" > For further information see “Displaying entry details without adding information to the glossary” in the documented code (<span class="cmtt-10">glossaries-code.pdf</span>). </p> -<!--l. 9107--><p class="indent" > </div> -</p><!--l. 9107--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">10. <a - id="sec:printglossary"></a>Displaying a glossary</h2> -</p><!--l. 9110--><p class="indent" > All defined glossaries may be displayed using: - </p><dl class="description"><dt class="description"> -<a -href="#option1"><span -class="cmbx-10">Option</span><span -class="cmbx-10"> 1</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description">(Must be used with <span -class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-141001"></a> in the preamble.) - <!--l. 9114--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-141002"></a> <span -class="cmtt-10">\printnoidxglossaries </span></div><hr> - </p><!--l. 9116--><p class="noindent" > - </p></dd><dt class="description"> -<span -class="cmbx-10">Options</span><span -class="cmbx-10"> </span><a -href="#option2"><span -class="cmbx-10">2</span></a> <span -class="cmbx-10">and</span><span -class="cmbx-10"> </span><a -href="#option3"><span -class="cmbx-10">3</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description">(Must be used with <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-141003"></a> in the preamble.) - <!--l. 9120--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-141004"></a> <span -class="cmtt-10">\printglossaries </span></div><hr> - </p><!--l. 9122--><p class="noindent" > - </p></dd></dl> -<!--l. 9125--><p class="indent" > These commands will display all the glossaries in the order in which they were defined. -</p><!--l. 9128--><p class="indent" > Note that, in the case of Options <a -href="#option2">2</a> and <a -href="#option3">3</a>, no glossaries will appear until you have either used the Perl script -<a -href="#glo:makeglossaries"><span -class="cmtt-10">makeglossaries</span><a - id="dx1-141005"></a></a> or Lua script <a -href="#glo:makeglossaries-lite.lua"><span -class="cmtt-10">makeglossaries-lite</span><a - id="dx1-141006"></a></a> or have directly used <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-141007"></a></a> or <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-141008"></a></a> (as described -in <a -href="#sec:makeglossaries">§1.4 </a><a -href="#sec:makeglossaries">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a>). -</p><!--l. 9134--><p class="indent" > <div class="important" title="Important Note"> While the external files are missing, <span -class="cmtt-10">\printglossary </span>will just do <span -class="cmtt-10">\null</span><a - id="dx1-141009"></a> for each missing glossary to assist -dictionary style documents that just use <span -class="cmtt-10">\glsaddall </span>without inserting any text. This use of <span -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 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> -</p><!--l. 9145--><p class="noindent" > -</p><!--l. 9147--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, it will insert a heading and boilerplate text when the external files are missing. -The extension package also provides <span -class="cmtt-10">\printunsrtglossaries </span>as an alternative. See the <a -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-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 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: - </p><dl class="description"><dt class="description"> -<a -href="#option1"><span -class="cmbx-10">Option</span><span -class="cmbx-10"> 1</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"> - <!--l. 9163--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-141014"></a> <span -class="cmtt-10">\printnoidxglossary[</span>⟨<span -class="cmitt-10">options</span>⟩<span -class="cmtt-10">] </span></div><hr> - </p><!--l. 9165--><p class="noindent" > - (Must be used with <span -class="cmtt-10">\makenoidxglossaries</span><a - id="dx1-141015"></a> in the preamble.) - </p></dd><dt class="description"> -<span -class="cmbx-10">Options</span><span -class="cmbx-10"> </span><a -href="#option2"><span -class="cmbx-10">2</span></a> <span -class="cmbx-10">and</span><span -class="cmbx-10"> </span><a -href="#option3"><span -class="cmbx-10">3</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"> - - - <!--l. 9169--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-141016"></a> <span -class="cmtt-10">\printglossary[</span>⟨<span -class="cmitt-10">options</span>⟩<span -class="cmtt-10">] </span></div><hr> - </p><!--l. 9171--><p class="noindent" > - (Must be used with <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-141017"></a> in the preamble.)</p></dd></dl> -<!--l. 9174--><p class="noindent" >where ⟨<span -class="cmti-10">options</span>⟩ is a ⟨<span -class="cmti-10">key</span>⟩=⟨<span -class="cmti-10">value</span>⟩ list of options. (Again, when the associated external file is missing, <span -class="cmtt-10">\null </span>is inserted -into the document.) -</p><!--l. 9178--><p class="indent" > The following keys are available: - </p><dl class="description"><dt class="description"> -<span -class="cmtt-10">type</span><a - id="dx1-141018"></a> </dt><dd -class="description">The value of this key specifies which glossary to print. If omitted, the default glossary is assumed. For - example, to print the list of acronyms: - - - <div class="verbatim" id="verbatim-262"> - \printglossary[type=\acronymtype] -</div> - <!--l. 9185--><p class="nopar" > Note that you can’t display an ignored glossary, so don’t try setting <span -class="cmtt-10">type</span><a - id="dx1-141019"></a> to the name of a glossary that - was defined using <span -class="cmtt-10">\newignoredglossary</span><a - id="dx1-141020"></a>, described in <a -href="#sec:newglossary">§12 </a><a -href="#sec:newglossary">Defining New Glossaries<!--tex4ht:ref: sec:newglossary --></a>. (You can display an - ignored glossary with <span -class="cmtt-10">\printunsrtglossary </span>provided by <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>.) - </p></dd><dt class="description"> -<span -class="cmtt-10">title</span><a - id="dx1-141021"></a> </dt><dd -class="description">This is the glossary’s title (overriding the title specified when the glossary was defined). - </dd><dt class="description"> -<span -class="cmtt-10">toctitle</span><a - id="dx1-141022"></a> </dt><dd -class="description">This is the title to use for the table of contents (if the <span -class="cmss-10">toc</span><a - id="dx1-141023"></a> package option has been used). It may also - be used for the page header, depending on the page style. If omitted, the value of <span -class="cmtt-10">title</span><a - id="dx1-141024"></a> is - used. - </dd><dt class="description"> -<span -class="cmtt-10">style</span><a - id="dx1-141025"></a> </dt><dd -class="description">This specifies which glossary style to use for this glossary, overriding the effect of the <span -class="cmss-10">style</span><a - id="dx1-141026"></a> package option - or <span -class="cmtt-10">\glossarystyle</span><a - id="dx1-141027"></a>. - </dd><dt class="description"> -<span -class="cmtt-10">numberedsection</span><a - id="dx1-141028"></a> </dt><dd -class="description">This specifies whether to use a numbered section for this glossary, overriding the effect of the - <span -class="cmss-10">numberedsection</span><a - id="dx1-141029"></a> package option. This key has the same syntax as the <span -class="cmss-10">numberedsection</span><a - id="dx1-141030"></a> package option, - described in <a -href="#sec:pkgopts-sec">§2.2 </a><a -href="#sec:pkgopts-sec">Sectioning, Headings and TOC Options<!--tex4ht:ref: sec:pkgopts-sec --></a>. - </dd><dt class="description"> -<span -class="cmtt-10">nonumberlist</span><a - id="dx1-141031"></a> </dt><dd -class="description">This is a boolean key. If true (<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">nonumberlist=true</span></span></span>) the numberlist is suppressed for this - glossary. If false (<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">nonumberlist=false</span></span></span>) the numberlist is displayed for this glossary. - </dd><dt class="description"> -<span -class="cmtt-10">nogroupskip</span><a - id="dx1-141032"></a> </dt><dd -class="description">This is a boolean key. If true the vertical gap between groups is suppressed for this - glossary. - </dd><dt class="description"> -<span -class="cmtt-10">nopostdot</span><a - id="dx1-141033"></a> </dt><dd -class="description">This is a boolean key. If true the full stop after the description is suppressed for this - glossary. - </dd><dt class="description"> -<span -class="cmtt-10">entrycounter</span><a - id="dx1-141034"></a> </dt><dd -class="description">This is a boolean key. Behaves similar to the package option of the same name. The - corresponding package option must be used to make <span -class="cmtt-10">\glsrefentry</span><a - id="dx1-141035"></a> work correctly. - </dd><dt class="description"> -<span -class="cmtt-10">subentrycounter</span><a - id="dx1-141036"></a> </dt><dd -class="description">This is a boolean key. Behaves similar to the package option of the same name. If you want - to set both <span -class="cmtt-10">entrycounter</span><a - id="dx1-141037"></a> and <span -class="cmtt-10">subentrycounter</span><a - id="dx1-141038"></a>, make sure you specify <span -class="cmtt-10">entrycounter</span><a - id="dx1-141039"></a> first. The - corresponding package option must be used to make <span -class="cmtt-10">\glsrefentry</span><a - id="dx1-141040"></a> work correctly. - </dd><dt class="description"> -<span -class="cmtt-10">sort</span><a - id="dx1-141041"></a> </dt><dd -class="description">This key is only available for <a -href="#option1">Option 1</a>. Possible values are: <span -class="cmtt-10">word </span>(word order), <span -class="cmtt-10">letter </span>(letter order), - - - <span -class="cmtt-10">standard </span>(word or letter ordering taken from the <span -class="cmss-10">order</span><a - id="dx1-141042"></a> package option), <span -class="cmtt-10">use </span>(order of use), <span -class="cmtt-10">def </span>(order of - definition) <span -class="cmtt-10">nocase </span>(case-insensitive) or <span -class="cmtt-10">case </span>(case-sensitive). Note that the word and letter comparisons - (that is, everything other than <span -class="cmtt-10">sort=use </span>and <span -class="cmtt-10">sort=def</span>) just use a simple character code comparison. For - a locale-sensitive sort, you must use either <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-141043"></a></a> (<a -href="#option3">Option 3</a>) or <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-141044"></a></a> (<a -href="#option4">Option 4</a>). Note that <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-141045"></a></a> - provides many other sort options. - <!--l. 9249--><p class="noindent" ><div class="important" title="Important Note"> If you use the <span -class="cmtt-10">use </span>or <span -class="cmtt-10">def </span>values make sure that you select a glossary style that doesn’t have a visual - indicator between groups, as the grouping no longer makes sense. Consider using the <span -class="cmss-10">nogroupskip</span><a - id="dx1-141046"></a> option. - </div> - </p><!--l. 9254--><p class="noindent" > - </p><!--l. 9257--><p class="noindent" >The - word - and - letter - order - sort - methods - use - <span -class="cmss-10">datatool</span><a - id="dx1-141047"></a>’s - <span -class="cmtt-10">\dtlwordindexcompare</span><a - id="dx1-141048"></a> - and - <span -class="cmtt-10">\dtlletterindexcompare</span><a - id="dx1-141049"></a> - handlers. - The - case-insensitive - sort - method - uses - <span -class="cmss-10">datatool</span><a - id="dx1-141050"></a>’s - <span -class="cmtt-10">\dtlicompare</span><a - id="dx1-141051"></a> - handler. - The - case-sensitive - sort - method - uses - <span -class="cmss-10">datatool</span><a - id="dx1-141052"></a>’s - <span -class="cmtt-10">\dtlcompare</span><a - id="dx1-141053"></a> - handler. - See - the - <span -class="cmss-10">datatool</span><a - id="dx1-141054"></a> - documentation - for - further - - - details. - </p><!--l. 9266--><p class="noindent" >If you don’t get an error with <span -class="cmtt-10">sort=use </span>and <span -class="cmtt-10">sort=def </span>but you do get an error with one of the other sort - options, then you probably need to use the <span -class="cmss-10">sanitizesort</span><span -class="cmtt-10">=</span><span -class="cmss-10">true</span><a - id="dx1-141055"></a> package option or make sure none of the - entries have fragile commands in their <span -class="cmtt-10">sort</span><a - id="dx1-141056"></a> field. - </p></dd><dt class="description"> -<a - id="dx1-141057"></a><span id="textcolor276"><span -class="cmtt-10">label={</span>⟨<span -class="cmitt-10">label</span>⟩<span -class="cmtt-10">}</span></span> </dt><dd -class="description">This key is only available with <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> and labels the glossary with <span -class="cmtt-10">\label{</span>⟨<span -class="cmti-10">label</span>⟩<span -class="cmtt-10">}</span>. This - is an alternative to the package option <span -class="cmss-10">numberedsection</span><span -class="cmtt-10">=</span><span -class="cmss-10">autolabel</span><a - id="dx1-141058"></a> - </dd><dt class="description"> -<a - id="dx1-141059"></a><span id="textcolor277"><span -class="cmtt-10">target</span></span> </dt><dd -class="description">This is a boolean key only available with <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, which can be used to switch off the - automatic hypertarget for each entry. (This refers to the target used by commands like <span -class="cmtt-10">\gls </span>and - <span -class="cmtt-10">\glslink</span>.) - <!--l. 9282--><p class="noindent" >This option is useful with <span id="textcolor278"><span -class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-141060"></a> as it allows the same list (of sub-list) of entries to be - displayed multiple times without causing duplicate hypertarget names. - </p></dd><dt class="description"> -<a - id="dx1-141061"></a><span id="textcolor279"><span -class="cmtt-10">prefix={</span>⟨<span -class="cmitt-10">prefix</span>⟩<span -class="cmtt-10">}</span></span> </dt><dd -class="description">This key is only available with <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> and provides another way of avoiding - duplicate hypertarget names is to use a different prefix for those names. This locally redefines - <span -class="cmtt-10">\glolinkprefix</span><a - id="dx1-141062"></a> but note this will also affect the target for any entry referenced within the glossary with - commands like <span -class="cmtt-10">\gls</span>, <span -class="cmtt-10">\glslink </span>or <span -class="cmtt-10">\glshypertarget</span>. - </dd><dt class="description"> -<a - id="dx1-141063"></a><span id="textcolor280"><span -class="cmtt-10">targetnameprefix={</span>⟨<span -class="cmitt-10">prefix</span>⟩<span -class="cmtt-10">}</span></span> </dt><dd -class="description">This key is only available with <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>. This is similar to the <span -class="cmss-10">prefix</span> - option, but it alters the prefix of the hypertarget anchors without changing <span -class="cmtt-10">\glslinkprefix</span><a - id="dx1-141064"></a> (so it won’t - change the hyperlinks for any entries referenced in the glossary). - </dd></dl> -<!--l. 9303--><p class="indent" > By default, the glossary is started either by <span -class="cmtt-10">\chapter*</span><a - id="dx1-141065"></a> or by <span -class="cmtt-10">\section*</span><a - id="dx1-141066"></a>, depending on whether or not -<span -class="cmtt-10">\chapter</span><a - id="dx1-141067"></a> is defined. This can be overridden by the <span -class="cmss-10">section</span><a - id="dx1-141068"></a> package option or the <span -class="cmtt-10">\setglossarysection</span><a - id="dx1-141069"></a> -command. Numbered sectional units can be obtained using the <span -class="cmss-10">numberedsection</span><a - id="dx1-141070"></a> package option. Each glossary -sets the page header via the command -</p><!--l. 9309--><p class="indent" > <hr><div title="Definition"><a - id="dx1-141071"></a> <span -class="cmtt-10">\glsglossarymark</span><a - id="dx1-141072"></a><span -class="cmtt-10">{</span>⟨<span -class="cmitt-10">title</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9311--><p class="noindent" > -If this mechanism is unsuitable for your chosen class file or page style package, you will need to redefine -<span -class="cmtt-10">\glsglossarymark</span><a - id="dx1-141073"></a>. Further information about these options and commands is given in <a -href="#sec:pkgopts-sec">§2.2 </a><a -href="#sec:pkgopts-sec">Sectioning, Headings -and TOC Options<!--tex4ht:ref: sec:pkgopts-sec --></a>. -</p><!--l. 9317--><p class="indent" > Information can be added to the start of the glossary (after the title and before the main body of the -glossary) by redefining -</p><!--l. 9319--><p class="indent" > <hr><div title="Definition"><a - id="dx1-141074"></a> <span -class="cmtt-10">\glossarypreamble </span></div><hr> -</p><!--l. 9321--><p class="noindent" > -For example: - - -</p> - <div class="verbatim" id="verbatim-263"> -\renewcommand{\glossarypreamble}{Numbers in italic - <br />indicate primary definitions.} -</div> -<!--l. 9326--><p class="nopar" > This needs to be done before the glossary is displayed. -</p><!--l. 9329--><p class="indent" > If you want a different preamble per glossary you can use -</p><!--l. 9330--><p class="indent" > <hr><div title="Definition"><a - id="dx1-141075"></a> <span -class="cmtt-10">\setglossarypreamble[</span>⟨<span -class="cmitt-10">type</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">preamble text</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9332--><p class="noindent" > -If ⟨<span -class="cmti-10">type</span>⟩ is omitted, <span -class="cmtt-10">\glsdefaulttype </span>is used. -</p><!--l. 9335--><p class="indent" > For example: - - -</p> - <div class="verbatim" id="verbatim-264"> -\setglossarypreamble{Numbers in italic - <br />indicate primary definitions.} -</div> -<!--l. 9339--><p class="nopar" > This will print the given preamble text for the main glossary, but not have any preamble text for any other -glossaries. -</p><!--l. 9343--><p class="indent" > There is an analogous command to <span -class="cmtt-10">\glossarypreamble </span>called -</p><!--l. 9344--><p class="indent" > <hr><div title="Definition"><a - id="dx1-141076"></a> <span -class="cmtt-10">\glossarypostamble </span></div><hr> -</p><!--l. 9346--><p class="noindent" > -which is placed at the end of each glossary. -<a - id="ex:twocolumn"></a> -</p><!--l. 9349--><p class="noindent" ><span -class="cmbx-12">Example 15</span><span -class="cmbx-12"> (Switch to Two Column Mode for Glossary)</span><a - id="x1-141078"></a> -</p><!--l. 9350--><p class="indent" > Suppose you are using the <span -class="cmss-10">superheaderborder</span><a - id="dx1-141079"></a> -style<span class="footnote-mark"><a -href="#fn1x10" id="fn1x10-bk"><sup class="textsuperscript">10.1</sup></a></span><a - id="x1-141080f1"></a>, -and you want the glossary to be in two columns, but after the glossary you want to switch back to one column -mode, you could do: - - -</p> - <div class="verbatim" id="verbatim-265"> -\renewcommand*{\glossarysection}[2][]{% - <br />  \twocolumn[{\chapter*{#2}}]% - <br />  \setlength\glsdescwidth{0.6\linewidth}% - <br />  \glsglossarymark{\glossarytoctitle}% - <br />} - <br />\renewcommand*{\glossarypostamble}{\onecolumn} -</div> -<!--l. 9364--><p class="nopar" > -</p> -<div class="center" -> -<!--l. 9366--><p class="noindent" > -</p><!--l. 9366--><p class="noindent" >____________________________</p></div> -<!--l. 9368--><p class="indent" > Within each glossary, each entry name is formatted according to -</p><!--l. 9369--><p class="indent" > <hr><div title="Definition"><a - id="dx1-141084"></a> <span -class="cmtt-10">\glsnamefont{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9371--><p class="noindent" > -which takes one argument: the entry name. This command is always used regardless of the glossary style. By -default, <span -class="cmtt-10">\glsnamefont </span>simply displays its argument in whatever the surrounding font happens to be. -This means that in the list-like glossary styles (defined in the <span -class="cmss-10">glossary-list</span><a - id="dx1-141085"></a> style file) the name will -appear in bold, since the name is placed in the optional argument of <span -class="cmtt-10">\item</span>, whereas in the tabular -styles (defined in the <span -class="cmss-10">glossary-long</span><a - id="dx1-141086"></a> and <span -class="cmss-10">glossary-super</span><a - id="dx1-141087"></a> style files) the name will appear in the normal -font. The hierarchical glossary styles (defined in the <span -class="cmss-10">glossary-tree</span><a - id="dx1-141088"></a> style file) also set the name in -bold. -</p><!--l. 9384--><p class="indent" > If you want to change the font for the description, or if you only want to change the name -font for some types of entries but not others, you might want to consider using the <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> -package. -<a - id="ex:glsnamefont"></a> -</p><!--l. 9390--><p class="noindent" ><span -class="cmbx-12">Example 16</span><span -class="cmbx-12"> (Changing the Font Used to Display Entry Names in the</span> -<span -class="cmbx-12">Glossary)</span><a - id="x1-141090"></a> -</p><!--l. 9391--><p class="indent" > Suppose you want all the entry names to appear in medium weight small caps in your glossaries, then you -can do: - - -</p> - <div class="verbatim" id="verbatim-266"> -\renewcommand{\glsnamefont}[1]{\textsc{\mdseries #1}} -</div> -<!--l. 9395--><p class="nopar" > </p> -<div class="center" -> -<!--l. 9396--><p class="noindent" > -</p><!--l. 9396--><p class="noindent" >____________________________</p></div> - - -<!--l. 9398--><p class="indent" > </div> -</p><!--l. 9398--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">11. <a - id="sec:xindy"></a>Xindy (Option 3)</h2> -</p><!--l. 9401--><p class="indent" > If you want to use <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-142001"></a></a> to sort the glossary, you must use the package option <span -class="cmss-10">xindy</span><a - id="dx1-142002"></a>: - - -</p> - <div class="verbatim" id="verbatim-267"> -\usepackage[xindy]{glossaries} -</div> -<!--l. 9405--><p class="nopar" > This ensures that the glossary information is written in <span -class="cmtt-10">xindy</span><a - id="dx1-142003"></a> syntax. -</p><!--l. 9409--><p class="indent" > <a -href="#sec:makeglossaries">§1.4 </a><a -href="#sec:makeglossaries">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a> covers how to use the external <a -href="#glo:indexingapp">indexing application</a>, and <a -href="#sec:locationsyntax">§5.2 -</a><a -href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a> covers the issues involved in the location syntax. This section covers the commands provided by the -<span -class="cmss-10">glossaries </span>package that allow you to adjust the <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-142004"></a></a> style file (<span -class="cmtt-10">xdy</span><a - id="dx1-142005"></a>) and parameters. -</p><!--l. 9416--><p class="indent" > To assist writing information to the <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-142006"></a></a> style file, the <span -class="cmss-10">glossaries </span>package provides the following -commands: -</p><!--l. 9419--><p class="indent" > <hr><div title="Definition"><a - id="dx1-142007"></a> <span -class="cmtt-10">\glsopenbrace </span></div><hr> -</p><!--l. 9421--><p class="noindent" > -</p><!--l. 9422--><p class="indent" > <hr><div title="Definition"><a - id="dx1-142008"></a> <span -class="cmtt-10">\glsclosebrace </span></div><hr> -</p><!--l. 9424--><p class="noindent" > -which produce an open and closing brace. (This is needed because <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\{</span></span></span> and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\}</span></span></span> don’t expand to a simple brace -character when written to a file.) Similarly, you can write a percent character using: -</p><!--l. 9429--><p class="indent" > <hr><div title="Definition"><a - id="dx1-142009"></a> <span -class="cmtt-10">\glspercentchar </span></div><hr> -</p><!--l. 9431--><p class="noindent" > -and a tilde character using: -</p><!--l. 9433--><p class="indent" > <hr><div title="Definition"><a - id="dx1-142010"></a> <span -class="cmtt-10">\glstildechar </span></div><hr> -</p><!--l. 9435--><p class="noindent" > -For example, a newline character is specified in a <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-142011"></a></a> style file using <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">~n</span></span></span> so you can use <span -class="cmtt-10">\glstildechar n </span>to -write this correctly (or you can do <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\string~n</span></span></span>). A backslash can be written to a file using -</p><!--l. 9440--><p class="indent" > <hr><div title="Definition"><a - id="dx1-142012"></a> <span -class="cmtt-10">\glsbackslash </span></div><hr> -</p><!--l. 9442--><p class="noindent" > -</p><!--l. 9444--><p class="indent" > In addition, if you are using a package that makes the double quote character active (e.g. <span -class="cmss-10">ngerman</span><a - id="dx1-142013"></a>) you can -use: -</p><!--l. 9446--><p class="indent" > <hr><div title="Definition"><a - id="dx1-142014"></a> <span -class="cmtt-10">\glsquote{</span>⟨<span -class="cmitt-10">text</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9448--><p class="noindent" > -which will produce <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">"</span></span></span>⟨<span -class="cmti-10">text</span>⟩<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">"</span></span></span>. Alternatively, you can use <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\string"</span></span></span> to write the double-quote character. This -document assumes that the double quote character has not been made active, so the examples just use <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">"</span></span></span> for -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 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 - id="dx1-142016"></a> style file. In which case, you must use -<span -class="cmtt-10">\noist</span><a - id="dx1-142017"></a> to prevent the style file from being overwritten by the <span -class="cmss-10">glossaries </span>package. For additional -information about <span -class="cmtt-10">xindy</span><a - id="dx1-142018"></a>, read the <span -class="cmtt-10">xindy</span><a - id="dx1-142019"></a> documentation. I’m sorry I can’t provide any assistance -with writing <span -class="cmtt-10">xindy</span><a - id="dx1-142020"></a> style files. If you need help, I recommend you ask on the <span -class="cmtt-10">xindy</span><a - id="dx1-142021"></a> mailing list -(<a -href="http://xindy.sourceforge.net/mailing-list.html" class="url" ><span -class="cmtt-10">http://xindy.sourceforge.net/mailing-list.html</span></a>). -</p> -<!--l. 9465--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.1 </span> <a - id="sec:langenc"></a>Language and Encodings</h3> -<!--l. 9468--><p class="noindent" >When you use <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-143001"></a></a>, you need to specify the language and encoding used (unless you have written your own - - -custom <span -class="cmtt-10">xindy</span><a - id="dx1-143002"></a> style file that defines the relevant alphabet and sort rules). If you use <a -href="#glo:makeglossaries"><span -class="cmtt-10">makeglossaries</span><a - id="dx1-143003"></a></a>, -this information is obtained from the document’s auxiliary (<span -class="cmtt-10">aux</span><a - id="dx1-143004"></a>) file. The <a -href="#glo:makeglossaries"><span -class="cmtt-10">makeglossaries</span><a - id="dx1-143005"></a></a> script -attempts to find the root language given your document settings, but in the event that it gets -it wrong or if <span -class="cmtt-10">xindy</span><a - id="dx1-143006"></a> doesn’t support that language, then you can specify the required language -using: -</p><!--l. 9477--><p class="indent" > <hr><div title="Definition"><a - id="dx1-143007"></a> <span -class="cmtt-10">\GlsSetXdyLanguage[</span>⟨<span -class="cmitt-10">glossary type</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">language</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9479--><p class="noindent" > -where ⟨<span -class="cmti-10">language</span>⟩ is the name of the language. The optional argument can be used if you have multiple glossaries -in different languages. If ⟨<span -class="cmti-10">glossary type</span>⟩ is omitted, it will be applied to all glossaries, otherwise the language -setting will only be applied to the glossary given by ⟨<span -class="cmti-10">glossary type</span>⟩. -</p><!--l. 9487--><p class="indent" > If the <span -class="cmss-10">inputenc</span><a - id="dx1-143008"></a> package is used, the encoding will be obtained from the value of <span -class="cmtt-10">\inputencodingname</span><a - id="dx1-143009"></a>. -Alternatively, you can specify the encoding using: -</p><!--l. 9490--><p class="indent" > <hr><div title="Definition"><a - id="dx1-143010"></a> <span -class="cmtt-10">\GlsSetXdyCodePage{</span>⟨<span -class="cmitt-10">code</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9492--><p class="noindent" > -where ⟨<span -class="cmti-10">code</span>⟩ is the name of the encoding. For example: - - -</p> - <div class="verbatim" id="verbatim-268"> -\GlsSetXdyCodePage{utf8} -</div> -<!--l. 9496--><p class="nopar" > -</p><!--l. 9498--><p class="indent" > Note that you can also specify the language and encoding using the package option -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">xindy={language=</span></span></span>⟨<span -class="cmti-10">lang</span>⟩<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">,codepage=</span></span></span>⟨<span -class="cmti-10">code</span>⟩<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">}</span></span></span>. For example: - - -</p> - <div class="verbatim" id="verbatim-269"> -\usepackage[xindy={language=english,codepage=utf8}]{glossaries} -</div> -<!--l. 9504--><p class="nopar" > -</p><!--l. 9506--><p class="indent" > If you write your own custom <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-143011"></a></a> style file that includes the language settings, you need to set the -language to nothing: - - -</p> - <div class="verbatim" id="verbatim-270"> -\GlsSetXdyLanguage{} -</div> -<!--l. 9511--><p class="nopar" > (and remember to use <span -class="cmtt-10">\noist</span><a - id="dx1-143012"></a> to prevent the style file from being overwritten). -</p><!--l. 9515--><p class="indent" > <div class="important" title="Important Note"> The commands <span -class="cmtt-10">\GlsSetXdyLanguage </span>and <span -class="cmtt-10">\GlsSetXdyCodePage </span>have no effect if you don’t use -<a -href="#glo:makeglossaries"><span -class="cmtt-10">makeglossaries</span><a - id="dx1-143013"></a></a>. If you call <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-143014"></a></a> without <span -class="cmtt-10">makeglossaries</span><a - id="dx1-143015"></a> you need to remember to set the language and -encoding using the <span -class="cmtt-10">-L</span><a - id="dx1-143016"></a> and <span -class="cmtt-10">-C</span><a - id="dx1-143017"></a> switches. </div> -</p><!--l. 9521--><p class="noindent" > -</p><!--l. 9523--><p class="noindent" > -</p> -<!--l. 9523--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.2 </span> <a - id="sec:xindyloc"></a>Locations and Number lists</h3> -<!--l. 9526--><p class="noindent" >If you use <span -class="cmss-10">xindy</span><a - id="dx1-144001"></a>, the <span -class="cmss-10">glossaries </span>package needs to know which counters you will be using in the <a -href="#glo:numberlist">number list<a - id="dx1-144002"></a></a> in -order to correctly format the <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-144003"></a></a> style file. Counters specified using the <span -class="cmss-10">counter</span><a - id="dx1-144004"></a> package option or the ⟨<span -class="cmti-10">counter</span>⟩ -option of <span -class="cmtt-10">\newglossary</span><a - id="dx1-144005"></a> are automatically taken care of, but if you plan to use a different counter in the -<span -class="cmtt-10">counter</span><a - id="dx1-144006"></a> key for commands like <span -class="cmtt-10">\glslink</span><a - id="dx1-144007"></a>, then you need to identify these counters <span -class="cmti-10">before </span><span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144008"></a> -using: -</p><!--l. 9534--><p class="indent" > <hr><div title="Definition"><a - id="dx1-144009"></a> <span -class="cmtt-10">\GlsAddXdyCounters{</span>⟨<span -class="cmitt-10">counter list</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9536--><p class="noindent" > -where ⟨<span -class="cmti-10">counter list</span>⟩ is a comma-separated list of counter names. -</p><!--l. 9539--><p class="indent" > The most likely <a - id="dx1-144010"></a>attributes used in the <span -class="cmtt-10">format</span><a - id="dx1-144011"></a> key (<span -class="cmtt-10">textrm</span><a - id="dx1-144012"></a>, <span -class="cmtt-10">hyperrm</span><a - id="dx1-144013"></a> etc) are automatically added to the -<a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-144014"></a></a> style file, but if you want to use another attribute, you need to add it using: -</p><!--l. 9543--><p class="indent" > <hr><div title="Definition"><a - id="dx1-144015"></a> <span -class="cmtt-10">\GlsAddXdyAttribute{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9545--><p class="noindent" > -where ⟨<span -class="cmti-10">name</span>⟩ is the name of the attribute, as used in the <span -class="cmtt-10">format</span><a - id="dx1-144016"></a> key. -</p><!--l. 9549--><p class="indent" > Take care if you have multiple instances of the same location with different formats. The duplicate locations -will be discarded according to the order in which the <a - id="dx1-144017"></a>attributes are listed. Consider defining semantic commands -to use for primary references. For example: - - -</p> - <div class="verbatim" id="verbatim-271"> -\newcommand*{\primary}[1]{\textbf{#1}} - <br />\GlsAddXdyAttribute{primary} -</div> -<!--l. 9557--><p class="nopar" > Then in the document: - - -</p> - <div class="verbatim" id="verbatim-272"> -A \gls[format=primary]{duck} is an aquatic bird. - <br />There are lots of different types of \gls{duck}. -</div> -<!--l. 9562--><p class="nopar" > This will give the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">format=primary</span></span></span> instance preference over the next use that doesn’t use the <span -class="cmtt-10">format</span><a - id="dx1-144018"></a> -key. -<a - id="ex:hyperbfit"></a> -</p><!--l. 9566--><p class="noindent" ><span -class="cmbx-12">Example 17</span><span -class="cmbx-12"> (Custom Font for Displaying a Location)</span><a - id="x1-144020"></a> -</p><!--l. 9567--><p class="indent" > Suppose I want a bold, italic, hyperlinked location. I first need to define a command that will do -this: - - -</p> - <div class="verbatim" id="verbatim-273"> -\newcommand*{\hyperbfit}[1]{\textit{\hyperbf{#1}}} -</div> -<!--l. 9571--><p class="nopar" > but with <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-144021"></a></a>, I also need to add this as an allowed <a - id="dx1-144022"></a>attribute: - - -</p> - <div class="verbatim" id="verbatim-274"> -\GlsAddXdyAttribute{hyperbfit} -</div> -<!--l. 9576--><p class="nopar" > Now I can use it in the optional argument of commands like <span -class="cmtt-10">\gls</span><a - id="dx1-144023"></a>: - - -</p> - <div class="verbatim" id="verbatim-275"> -Here is a \gls[format=hyperbfit]{sample} entry. -</div> -<!--l. 9581--><p class="nopar" > (where <span -class="cmtt-10">sample </span>is the label of the required entry). </p> -<div class="center" -> -<!--l. 9583--><p class="noindent" > -</p><!--l. 9583--><p class="noindent" >____________________________</p></div> -<!--l. 9585--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\GlsAddXdyAttribute </span>has no effect if <span -class="cmtt-10">\noist</span><a - id="dx1-144024"></a> is used or if <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144025"></a> is omitted. -<span -class="cmtt-10">\GlsAddXdyAttribute </span>must be used before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144026"></a>. Additionally, <span -class="cmtt-10">\GlsAddXdyCounters </span>must come -before <span -class="cmtt-10">\GlsAddXdyAttribute</span>. </div> -</p><!--l. 9591--><p class="noindent" > -</p><!--l. 9593--><p class="indent" > If the location numbers include formatting commands, then you need to add a location style in the -appropriate format using -</p><!--l. 9595--><p class="indent" > <hr><div title="Definition"><a - id="dx1-144027"></a> <span -class="cmtt-10">\GlsAddXdyLocation[</span>⟨<span -class="cmitt-10">prefix-location</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">definition</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9597--><p class="noindent" > -where ⟨<span -class="cmti-10">name</span>⟩ is the name of the format and ⟨<span -class="cmti-10">definition</span>⟩ is the <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-144028"></a></a> definition. The optional argument -⟨<span -class="cmti-10">prefix-location</span>⟩ is needed if <span -class="cmtt-10">\theH</span>⟨<span -class="cmti-10">counter</span>⟩ either isn’t defined or is different from <span -class="cmtt-10">\the</span>⟨<span -class="cmti-10">counter</span>⟩. Be sure to also -read <a -href="#sec:locationsyntax">§5.2 </a><a -href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a> for some issues that you may encounter. -</p><!--l. 9605--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\GlsAddXdyLocation </span>has no effect if <span -class="cmtt-10">\noist</span><a - id="dx1-144029"></a> is used or if <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144030"></a> is omitted. -<span -class="cmtt-10">\GlsAddXdyLocation </span>must be used before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144031"></a>. </div> -</p><!--l. 9609--><p class="noindent" > -<a - id="ex:customloc"></a> -</p><!--l. 9611--><p class="noindent" ><span -class="cmbx-12">Example 18</span><span -class="cmbx-12"> (Custom Numbering System for Locations)</span><a - id="x1-144033"></a> -</p><!--l. 9612--><p class="indent" > Suppose I decide to use a somewhat eccentric numbering system for sections where I redefine <span -class="cmtt-10">\thesection</span> -as follows: - - -</p> - <div class="verbatim" id="verbatim-276"> -\renewcommand*{\thesection}{[\thechapter]\arabic{section}} -</div> -<!--l. 9616--><p class="nopar" > If I haven’t done <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">counter=section</span></span></span> in the package option, I need to specify that the counter will be used as a -location number: - - -</p> - <div class="verbatim" id="verbatim-277"> -\GlsAddXdyCounters{section} -</div> -<!--l. 9622--><p class="nopar" > Next I need to add the location style (<span -class="cmtt-10">\thechapter </span>is assumed to be the standard <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\arabic{chapter}</span></span></span>): - - -</p> - <div class="verbatim" id="verbatim-278"> -\GlsAddXdyLocation{section}{:sep "[" "arabic-numbers" :sep "]" - <br />  "arabic-numbers" - <br />} -</div> -<!--l. 9629--><p class="nopar" > Note that if I have further decided to use the <span -class="cmss-10">hyperref</span><a - id="dx1-144034"></a> package and want to redefine <span -class="cmtt-10">\theHsection</span> -as: - - -</p> - <div class="verbatim" id="verbatim-279"> -\renewcommand*{\theHsection}{\thepart.\thesection} - <br />\renewcommand*{\thepart}{\Roman{part}} -</div> -<!--l. 9635--><p class="nopar" > then I need to modify the <span -class="cmtt-10">\GlsAddXdyLocation </span>code above to: - - -</p> - <div class="verbatim" id="verbatim-280"> -\GlsAddXdyLocation["roman-numbers-uppercase"]{section}{:sep "[" - <br />  "arabic-numbers" :sep "]" "arabic-numbers" - <br />} -</div> -<!--l. 9641--><p class="nopar" > Since <span -class="cmtt-10">\Roman</span><a - id="dx1-144035"></a> will result in an empty string if the counter is zero, it’s a good idea to add an extra location to -catch this: - - -</p> - <div class="verbatim" id="verbatim-281"> -\GlsAddXdyLocation{zero.section}{:sep "[" - <br />  "arabic-numbers" :sep "]" "arabic-numbers" - <br />} -</div> -<!--l. 9648--><p class="nopar" > This example is illustrated in the sample file <a -href="#ex:samplexdy2"><span -class="cmtt-10">samplexdy2.tex</span></a>. </p> -<div class="center" -> -<!--l. 9651--><p class="noindent" > -</p><!--l. 9651--><p class="noindent" >____________________________</p></div> -<a - id="ex:dice"></a> -<!--l. 9653--><p class="noindent" ><span -class="cmbx-12">Example 19</span><span -class="cmbx-12"> (Locations as Dice)</span><a - id="x1-144037"></a> -</p><!--l. 9654--><p class="indent" > Suppose I want a rather eccentric page numbering system that’s represented by the number of -dots on dice. The <span -class="cmss-10">stix</span><a - id="dx1-144038"></a> package provides <span -class="cmtt-10">\dicei</span>, …, <span -class="cmtt-10">\dicevi </span>that represent the six sides of a die. I -can define a command that takes a number as its argument. If the number is less than seven, the -appropriate <span -class="cmtt-10">\dice</span>⟨<span -class="cmti-10">n</span>⟩ command is used otherwise it does <span -class="cmtt-10">\dicevi </span>the required number of times with the -leftover in a final <span -class="cmtt-10">\dice</span>⟨<span -class="cmti-10">n</span>⟩. For example, the number 16 is represented by <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\dicevi\dicevi\diceiv</span></span></span> -(6 + 6 + 4 = 16). I’ve called this command <span -class="cmtt-10">\tallynum </span>to match the example given earlier in <a -href="#sec:locationsyntax">§5.2 -</a><a -href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a>: - - -</p> - <div class="verbatim" id="verbatim-282"> -\newrobustcmd{\tallynum}[1]{% - <br /> \ifnum\number#1<7 - <br />  $\csname dice\romannumeral#1\endcsname$% - <br /> \else - <br />  $\dicevi$% - <br />  \expandafter\tallynum\expandafter{\numexpr#1-6}% - <br /> \fi - <br />} -</div> -<!--l. 9674--><p class="nopar" > Here’s the counter command: - - -</p> - <div class="verbatim" id="verbatim-283"> -newcommand{\tally}[1]{\tallynum{\arabic{#1}}} -</div> -<!--l. 9678--><p class="nopar" > The <span -class="cmss-10">page</span><a - id="dx1-144039"></a> counter representation (<span -class="cmtt-10">\thepage</span>) needs to be changed to use this command: - - -</p> - <div class="verbatim" id="verbatim-284"> -\renewcommand*{\thepage}{\tally{page}} -</div> -<!--l. 9683--><p class="nopar" > The <span -class="cmtt-10">\tally </span>command expands to <span -class="cmtt-10">\tallynum {</span>⟨<span -class="cmti-10">number</span>⟩<span -class="cmtt-10">} </span>so this needs a location class that matches this -format: - - -</p> - <div class="verbatim" id="verbatim-285"> -\GlsAddXdyLocation{tally}{% - <br /> :sep "\string\tallynum\space\glsopenbrace" - <br /> "arabic-numbers" - <br /> :sep "\glsclosebrace" - <br />} -</div> -<!--l. 9692--><p class="nopar" > The space between <span -class="cmtt-10">\tallynum </span>and <span -class="cmtt-10">{</span>⟨<span -class="cmti-10">number</span>⟩<span -class="cmtt-10">} </span>is significant to <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-144040"></a></a> so <span -class="cmtt-10">\space </span>is required. -</p><!--l. 9696--><p class="indent" > Note that <span -class="cmtt-10">\GlsAddXdyLocation{</span>⟨<span -class="cmti-10">name</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmti-10">definition</span>⟩<span -class="cmtt-10">} </span>will define commands in the form: -</p><!--l. 9699--><p class="indent" > <hr><div title="Definition"><span -class="cmtt-10">\glsX</span>⟨<span -class="cmitt-10">counter</span>⟩<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">X</span></span></span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">{</span>⟨<span -class="cmitt-10">Hprefix</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">location</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9700--><p class="noindent" > -for each counter that has been identified either by the <span -class="cmss-10">counter</span><a - id="dx1-144041"></a> package option, the ⟨<span -class="cmti-10">counter</span>⟩ option for -<span -class="cmtt-10">\newglossary</span><a - id="dx1-144042"></a> or in the argument of <span -class="cmtt-10">\GlsAddXdyCounters</span><a - id="dx1-144043"></a>. The first argument ⟨<span -class="cmti-10">Hprefix</span>⟩ is only relevant when -used with the <span -class="cmss-10">hyperref</span><a - id="dx1-144044"></a> package and indicates that <span -class="cmtt-10">\theH</span>⟨<span -class="cmti-10">counter</span>⟩ is given by <span -class="cmtt-10">\Hprefix</span><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.</span></span></span><span -class="cmtt-10">\the</span>⟨<span -class="cmti-10">counter</span>⟩. -</p><!--l. 9708--><p class="indent" > The sample file <a -href="#ex:samplexdy"><span -class="cmtt-10">samplexdy.tex</span></a>, which comes with the <span -class="cmss-10">glossaries </span>package, uses the default <span -class="cmss-10">page</span><a - id="dx1-144045"></a> counter for -locations, and it uses the default <span -class="cmtt-10">\glsnumberformat</span><a - id="dx1-144046"></a> and a custom <span -class="cmtt-10">\hyperbfit </span>format. A new <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-144047"></a></a> location -called <span -class="cmtt-10">tallynum</span>, as illustrated above, is defined to make the page numbers appear as dice. In order for the -location numbers to hyperlink to the relevant pages, I need to redefine the necessary <span -class="cmtt-10">\glsX</span>⟨<span -class="cmti-10">counter</span>⟩<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">X</span></span></span>⟨<span -class="cmti-10">format</span>⟩ -commands: - - -</p> - <div class="verbatim" id="verbatim-286"> -\renewcommand{\glsXpageXglsnumberformat}[2]{% - <br /> \linkpagenumber#2% - <br />} - <br />\renewcommand{\glsXpageXhyperbfit}[2]{% - <br /> \textbf{\em\linkpagenumber#2}% - <br />} - <br />\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} -</div> -<!--l. 9726--><p class="nopar" > Note that the second argument of <span -class="cmtt-10">\glsXpageXglsnumberformat </span>is in the format <span -class="cmtt-10">\tallynum{</span>⟨<span -class="cmti-10">n</span>⟩<span -class="cmtt-10">} </span>so the -line - - -</p> - <div class="verbatim" id="verbatim-287"> - \linkpagenumber#2% -</div> -<!--l. 9731--><p class="nopar" > does </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10"> \linkpagenumber\tallynum{</span>⟨<span -class="cmitt-10">number</span>⟩<span -class="cmtt-10">}</span> -</div> -</div> so <span -class="cmtt-10">\tallynum </span>is the first argument of <span -class="cmtt-10">\linkpagenumber </span>and ⟨<span -class="cmti-10">number</span>⟩ is the second argument. -<div class="center" -> -<!--l. 9738--><p class="noindent" > -</p><!--l. 9738--><p class="noindent" >____________________________</p></div> -<!--l. 9740--><p class="indent" > <div class="important" title="Important Note"> This method is very sensitive to the internal definition of the location command. </div> -</p><!--l. 9743--><p class="noindent" > -<a - id="ex:fmtcount"></a> -</p><!--l. 9745--><p class="noindent" ><span -class="cmbx-12">Example 20</span><span -class="cmbx-12"> (Locations as Words not Digits)</span><a - id="x1-144049"></a> -</p><!--l. 9746--><p class="indent" > Suppose I want the page numbers written as words rather than digits and I use the <span -class="cmss-10">fmtcount</span><a - id="dx1-144050"></a> package to do -this. I can redefine <span -class="cmtt-10">\thepage</span><a - id="dx1-144051"></a> as follows: - - -</p> - <div class="verbatim" id="verbatim-288"> -\renewcommand*{\thepage}{\Numberstring{page}} -</div> -<!--l. 9751--><p class="nopar" > This <span -class="cmti-10">used </span>to get expanded to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\protect</span><span -class="cmtt-10"> \Numberstringnum</span><span -class="cmtt-10"> </span></span></span><span -class="cmtt-10">{</span>⟨<span -class="cmti-10">n</span>⟩<span -class="cmtt-10">} </span>where ⟨<span -class="cmti-10">n</span>⟩ is the Arabic page number. This -means that I needed to define a new location with the form: - - -</p> - <div class="verbatim" id="verbatim-289"> -\GlsAddXdyLocation{Numberstring}{:sep "\string\protect\space - <br />  \string\Numberstringnum\space\glsopenbrace" - <br />  "arabic-numbers" :sep "\glsclosebrace"} -</div> -<!--l. 9759--><p class="nopar" > and if I’d used the <span -class="cmtt-10">\linkpagenumber </span>command from the previous example, it would need <span -class="cmti-10">three </span>arguments (the -first being <span -class="cmtt-10">\protect</span>): - - -</p> - <div class="verbatim" id="verbatim-290"> -\newcommand{\linkpagenumber}[3]{\hyperlink{page.#3}{#1#2{#3}}} -</div> -<!--l. 9765--><p class="nopar" > -</p><!--l. 9767--><p class="indent" > The internal definition of <span -class="cmtt-10">\Numberstring </span>has since changed so that it now expands to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\Numberstringnum</span><span -class="cmtt-10"> </span></span></span> -<span -class="cmtt-10">{</span>⟨<span -class="cmti-10">n</span>⟩<span -class="cmtt-10">} </span>(no <span -class="cmtt-10">\protect</span>). This means that the location class definition must be changed to: - - -</p> - <div class="verbatim" id="verbatim-291"> -\GlsAddXdyLocation{Numberstring}{% no \protect now! - <br />  :sep "\string\Numberstringnum\space\glsopenbrace" - <br />  "arabic-numbers" :sep "\glsclosebrace"} -</div> -<!--l. 9775--><p class="nopar" > and <span -class="cmtt-10">\linkpagenumber </span>goes back to only two arguments: - - -</p> - <div class="verbatim" id="verbatim-292"> -\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} -</div> -<!--l. 9779--><p class="nopar" > The other change is that <span -class="cmtt-10">\Numberstring </span>uses </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">\the\value{</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">}</span> -</div> -</div> instead of <div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">\expandafter\the\csname</span><span -class="cmtt-10"> c@</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">\endcsname</span> -</div> -</div> so it hides <span -class="cmtt-10">\c@page </span>from the location escaping mechanism (see <a -href="#sec:locationsyntax">§5.2 </a><a -href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a>). This means that the page -number may be incorrect if the indexing occurs during the output routine. -<!--l. 9793--><p class="indent" > A more recent change to <span -class="cmss-10">fmtcount</span><a - id="dx1-144052"></a> (v3.03) now puts three instances of <span -class="cmtt-10">\expandafter </span>before -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\the\value</span></span></span> which no longer hides <span -class="cmtt-10">\c@page </span>from the location escaping mechanism, so the page -numbers should once more be correct. Further changes to the <span -class="cmss-10">fmtcount</span><a - id="dx1-144053"></a> package may cause a problem -again. -</p><!--l. 9799--><p class="indent" > <div class="important" title="Important Note"> When dealing with custom formats where the internal definitions are outside of your control and liable to -change, it’s best to provide a wrapper command. </div> -</p><!--l. 9803--><p class="noindent" > -</p><!--l. 9805--><p class="indent" > Instead of directly using <span -class="cmtt-10">\Numberstring </span>in the definition of <span -class="cmtt-10">\thepage</span>, I can provide a custom command in -the same form as the earlier <span -class="cmtt-10">\tally </span>command: - - -</p> - <div class="verbatim" id="verbatim-293"> -\newcommand{\customfmt}[1]{\customfmtnum{\arabic{#1}}} - <br />\newrobustcmd{\customfmtnum}[1]{\Numberstringnum{#1}} -</div> -<!--l. 9811--><p class="nopar" > This ensures that the location will always be written to the indexing file in the form: </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">:locref</span><span -class="cmtt-10"> "{}{\\customfmtnum</span><span -class="cmtt-10"> {</span>⟨<span -class="cmitt-10">n</span>⟩<span -class="cmtt-10">}}"</span> -</div> -</div> So the location class can be defined as: - - - <div class="verbatim" id="verbatim-294"> -\GlsAddXdyLocation{customfmt}{ - <br /> :sep "\string\customfmtnum\space\glsopenbrace" - <br /> "arabic-numbers" - <br /> :sep "\glsclosebrace"} -</div> -<!--l. 9823--><p class="nopar" > -</p><!--l. 9825--><p class="indent" > The sample file <a -href="#ex:samplexdy3"><span -class="cmtt-10">samplexdy3.tex</span></a> illustrates this. </p> -<div class="center" -> -<!--l. 9827--><p class="noindent" > -</p><!--l. 9827--><p class="noindent" >____________________________</p></div> -<!--l. 9829--><p class="indent" > In the <a -href="#glo:numberlist">number list<a - id="dx1-144054"></a></a>, the locations are sorted according to the list of provided location classes. -The default ordering is: <span -class="cmtt-10">roman-page-numbers </span>(i, ii, …), <span -class="cmtt-10">arabic-page-numbers </span>(1, 2, …), -<span -class="cmtt-10">arabic-section-numbers </span>(for example, 1.1 if the compositor is a full stop or 1-1 if the compositor is a -hyphen<span class="footnote-mark"><a -href="#fn1x11" id="fn1x11-bk"><sup class="textsuperscript">11.1</sup></a></span><a - id="x1-144055f1"></a>), -<span -class="cmtt-10">alpha-page-numbers </span>(a, b, …), <span -class="cmtt-10">Roman-page-numbers </span>(I, II, …), <span -class="cmtt-10">Alpha-page-numbers </span>(A, B, …), -<span -class="cmtt-10">Appendix-page-numbers </span>(for example, A.1 if the Alpha compositor is a full stop or A-1 if the Alpha compositor is a -hyphen<span class="footnote-mark"><a -href="#fn2x11" id="fn2x11-bk"><sup class="textsuperscript">11.2</sup></a></span><a - id="x1-144057f2"></a>), user defined -location names (as specified by <span -class="cmtt-10">\GlsAddXdyLocation</span><a - id="dx1-144059"></a> in the order in which they were defined), and finally <span -class="cmtt-10">see </span>(cross-referenced -entries).<span class="footnote-mark"><a -href="#fn3x11" id="fn3x11-bk"><sup class="textsuperscript">11.3</sup></a></span><a - id="x1-144060f3"></a> -This ordering can be changed using: -</p><!--l. 9846--><p class="indent" > <hr><div title="Definition"><a - id="dx1-144061"></a> <span -class="cmtt-10">\GlsSetXdyLocationClassOrder{</span>⟨<span -class="cmitt-10">location names</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9848--><p class="noindent" > -where each location name is delimited by double quote marks and separated by white space. For -example: - - -</p> - <div class="verbatim" id="verbatim-295"> -\GlsSetXdyLocationClassOrder{ - <br />  "arabic-page-numbers" - <br />  "arabic-section-numbers" - <br />  "roman-page-numbers" - <br />  "Roman-page-numbers" - <br />  "alpha-page-numbers" - <br />  "Alpha-page-numbers" - <br />  "Appendix-page-numbers" - <br />  "see" - <br />} -</div> -<!--l. 9862--><p class="nopar" > (Remember to add <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">"seealso"</span></span></span> if you’re using <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>.) -</p><!--l. 9866--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\GlsSetXdyLocationClassOrder </span>has no effect if <span -class="cmtt-10">\noist</span><a - id="dx1-144062"></a> is used or if <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144063"></a> is -omitted. <span -class="cmtt-10">\GlsSetXdyLocationClassOrder </span>must be used before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144064"></a>. </div> -</p><!--l. 9871--><p class="noindent" > -</p><!--l. 9873--><p class="indent" > If a <a -href="#glo:numberlist">number list<a - id="dx1-144065"></a></a> consists of a sequence of consecutive numbers, the range will be concatenated. The -number of consecutive locations that causes a range formation defaults to 2, but can be changed -using: -</p><!--l. 9878--><p class="indent" > <hr><div title="Definition"><a - id="dx1-144066"></a> <span -class="cmtt-10">\GlsSetXdyMinRangeLength{</span>⟨<span -class="cmitt-10">n</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9880--><p class="noindent" > -For example: - - -</p> - <div class="verbatim" id="verbatim-296"> -\GlsSetXdyMinRangeLength{3} -</div> -<!--l. 9884--><p class="nopar" > The argument may also be the keyword <span -class="cmtt-10">none</span>, to indicate that there should be no range formations. See the -<a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-144067"></a></a> manual for further details on range formations. -</p><!--l. 9889--><p class="indent" > <div class="important" title="Important Note"> Note that <span -class="cmtt-10">\GlsSetXdyMinRangeLength </span>has no effect if <span -class="cmtt-10">\noist</span><a - id="dx1-144068"></a> is used or if <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144069"></a> is omitted. -<span -class="cmtt-10">\GlsSetXdyMinRangeLength </span>must be used before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-144070"></a>. </div> -</p><!--l. 9894--><p class="noindent" > -See also <a -href="#sec:ranges">§5.3 </a><a -href="#sec:ranges">Range Formations<!--tex4ht:ref: sec:ranges --></a>. -</p><!--l. 9897--><p class="noindent" > -</p> -<!--l. 9897--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.3 </span> <a - id="sec:groups"></a>Glossary Groups</h3> -<!--l. 9900--><p class="noindent" >The glossary is divided into groups according to the first letter of the sort key. The <span -class="cmss-10">glossaries </span>package also adds a -number group by default, unless you suppress it in the <span -class="cmss-10">xindy</span><a - id="dx1-145001"></a> package option. For example: - - -</p> - <div class="verbatim" id="verbatim-297"> -\usepackage[xindy={glsnumbers=false}]{glossaries} -</div> -<!--l. 9906--><p class="nopar" > Any entry that doesn’t go in one of the letter groups or the number group is placed in the default group. If you -want <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-145002"></a></a> to sort the number group numerically (rather than by a string sort) then you need to use <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-145003"></a>’s</a> -<span -class="cmtt-10">numeric-sort </span>module: - - -</p> - <div class="verbatim" id="verbatim-298"> -\GlsAddXdyStyle{numeric-sort} -</div> -<!--l. 9913--><p class="nopar" > -</p><!--l. 9915--><p class="indent" > If you don’t use <span -class="cmtt-10">glsnumbers=false</span>, the default behaviour is to locate the number group before the “A” -letter group. If you are not using a Roman alphabet, you need to change this using: -</p><!--l. 9920--><p class="indent" > <hr><div title="Definition"><a - id="dx1-145004"></a> <span -class="cmtt-10">\GlsSetXdyFirstLetterAfterDigits{</span>⟨<span -class="cmitt-10">letter</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9922--><p class="noindent" > -where ⟨<span -class="cmti-10">letter</span>⟩ is the first letter of your alphabet. Take care if you’re using <span -class="cmss-10">inputenc</span><a - id="dx1-145005"></a> as non-ASCII characters are -actually active characters that expand. (This isn’t a problem with the native UTF-8 engines and -<span -class="cmss-10">fontspec</span><a - id="dx1-145006"></a>.) The starred form will sanitize the argument to prevent expansion. Alternatively you can -use: -</p><!--l. 9931--><p class="indent" > <hr><div title="Definition"><a - id="dx1-145007"></a> <span -class="cmtt-10">\GlsSetXdyNumberGroupOrder{</span>⟨<span -class="cmitt-10">relative location</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 9933--><p class="noindent" > -to change the default </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">:before</span><span -class="cmtt-10"> \string"</span>⟨<span -class="cmitt-10">letter</span>⟩<span -class="cmtt-10">\string"</span> -</div> -</div> to ⟨<span -class="cmti-10">relative location</span>⟩. For example: - - - <div class="verbatim" id="verbatim-299"> -\GlsSetXdyNumberGroupOrder{:after \string"Z\string"} -</div> -<!--l. 9941--><p class="nopar" > will put the number group after the “Z” letter group. Again take care of active characters. There’s a starred -version that sanitizes the argument (so don’t use <span -class="cmtt-10">\string </span>in it). </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">\GlsSetXdyNumberGroupOrder*</span><span -class="cmsy-10">{</span><span -class="cmtt-10">:after</span><span -class="cmtt-10"> "</span><span -class="cmtt-10">Ö</span><span -class="cmtt-10">"</span><span -class="cmsy-10">}</span> -</div> -</div> -<!--l. 9949--><p class="indent" > <div class="important" title="Important Note"> Note that these commands have no effect if <span -class="cmtt-10">\noist</span><a - id="dx1-145008"></a> is used or if <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-145009"></a> is omitted. -<span -class="cmtt-10">\GlsSetXdyFirstLetterAfterDigits </span>must be used before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-145010"></a>. - </div> -</p><!--l. 9954--><p class="noindent" > - - -</p> -<!--l. 9957--><p class="indent" > </div> -</p><!--l. 9957--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">12. <a - id="sec:newglossary"></a>Defining New Glossaries</h2> -</p><!--l. 9960--><p class="indent" > A new glossary can be defined using: -</p><!--l. 9961--><p class="indent" > <hr><div title="Definition"><a - id="dx1-146001"></a> <span -class="cmtt-10">\newglossary[</span>⟨<span -class="cmitt-10">log-ext</span>⟩<span -class="cmtt-10">]{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">in-ext</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">out-ext</span>⟩<span -class="cmtt-10">}</span> -<span -class="cmtt-10">{</span>⟨<span -class="cmitt-10">title</span>⟩<span -class="cmtt-10">}[</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">] </span></div><hr> -</p><!--l. 9963--><p class="noindent" > -where ⟨<span -class="cmti-10">name</span>⟩ is the label to assign to this glossary. The arguments ⟨<span -class="cmti-10">in-ext</span>⟩ and ⟨<span -class="cmti-10">out-ext</span>⟩ specify the extensions to -give to the input and output files for that glossary, ⟨<span -class="cmti-10">title</span>⟩ is the default title for this new glossary and the final -optional argument ⟨<span -class="cmti-10">counter</span>⟩ specifies which counter to use for the associated <a -href="#glo:numberlist">number list<a - id="dx1-146002"></a>s</a> (see also <a -href="#sec:numberlists">§5 </a><a -href="#sec:numberlists">Number -lists<!--tex4ht:ref: sec:numberlists --></a>). The first optional argument specifies the extension for the <a -href="#glo:makeindex"><span -class="cmtt-10">makeindex</span><a - id="dx1-146003"></a></a> (<a -href="#option2">Option 2</a>) or <a -href="#glo:xindy"><span -class="cmtt-10">xindy</span><a - id="dx1-146004"></a></a> -(<a -href="#option3">Option 3</a>) transcript file (this information is only used by <a -href="#glo:makeglossaries"><span -class="cmtt-10">makeglossaries</span><a - id="dx1-146005"></a></a> which picks up the -information from the auxiliary file). If you use <a -href="#option1">Option 1</a>, the ⟨<span -class="cmti-10">log-ext</span>⟩, ⟨<span -class="cmti-10">in-ext</span>⟩ and ⟨<span -class="cmti-10">out-ext</span>⟩ arguments are -ignored. -</p><!--l. 9977--><p class="indent" > <div class="important" title="Important Note"> The glossary label ⟨<span -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 LaTeX). -</div> -</p><!--l. 9982--><p class="noindent" > -</p><!--l. 9984--><p class="indent" > There is also a starred version (new to v4.08): -</p><!--l. 9985--><p class="indent" > <hr><div title="Definition"><a - id="dx1-146007"></a> <span -class="cmtt-10">\newglossary*{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">title</span>⟩<span -class="cmtt-10">}[</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">] </span></div><hr> -</p><!--l. 9987--><p class="noindent" > -which is equivalent to </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">\newglossary[</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">-glg]{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">}</span><span -class="cmsy-10">{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">-gls</span><span -class="cmsy-10">}{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">-glo</span><span -class="cmsy-10">}</span><span -class="cmtt-10">{</span>⟨<span -class="cmitt-10">title</span>⟩<span -class="cmtt-10">}[</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">]</span> -</div> -</div> or you can also use: -<!--l. 9993--><p class="indent" > <hr><div title="Definition"><a - id="dx1-146008"></a> <span -class="cmtt-10">\altnewglossary{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">}{</span>⟨<span -class="cmitt-10">title</span>⟩<span -class="cmtt-10">}[</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">] </span></div><hr> -</p><!--l. 9995--><p class="noindent" > -which is equivalent to </p><div class="alltt"> -<div class="obeylines-v"> -<span -class="cmtt-10">\newglossary[</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">-glg]{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">}</span><span -class="cmsy-10">{</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">-gls</span><span -class="cmsy-10">}{</span>⟨<span -class="cmitt-10">tag</span>⟩<span -class="cmtt-10">-glo</span><span -class="cmsy-10">}</span><span -class="cmtt-10">{</span>⟨<span -class="cmitt-10">title</span>⟩<span -class="cmtt-10">}[</span>⟨<span -class="cmitt-10">counter</span>⟩<span -class="cmtt-10">]</span> -</div> -</div> -<!--l. 10001--><p class="indent" > It may be that you have some terms that are so common that they don’t need to be listed. In this case, you -can define a special type of glossary that doesn’t create any associated files. This is referred to as an “ignored -glossary” and it’s ignored by commands that iterate over all the glossaries, such as <span -class="cmtt-10">\printglossaries</span><a - id="dx1-146009"></a>. To -define an ignored glossary, use -</p><!--l. 10007--><p class="indent" > <hr><div title="Definition"><a - id="dx1-146010"></a> <span -class="cmtt-10">\newignoredglossary{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">} </span></div><hr> -</p><!--l. 10009--><p class="noindent" > -where ⟨<span -class="cmti-10">name</span>⟩ is the name of the glossary (as above). This glossary type will automatically be added to the -<span -class="cmss-10">nohypertypes</span><a - id="dx1-146011"></a> list, since there are no hypertargets for the entries in an ignored glossary. (The sample file -<a -href="#ex:sample-entryfmt"><span -class="cmtt-10">sample-entryfmt.tex</span></a> defines an ignored glossary.) - - -</p><!--l. 10016--><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 provides a starred version of this command that allows hyperlinks (since -ignored glossaries can be useful with <a -href="#glo:bib2gls"><span -class="cmtt-10">bib2gls</span><a - id="dx1-146012"></a></a>). There is also an analogous <span id="textcolor281"><span -class="cmtt-10">\provideignoredglossary</span></span><a - id="dx1-146013"></a> -command. </div> -</p><!--l. 10021--><p class="noindent" > -</p><!--l. 10023--><p class="indent" > You can test if a glossary is an ignored one using: -</p><!--l. 10024--><p class="indent" > <hr><div title="Definition"><a - id="dx1-146014"></a> <span -class="cmtt-10">\ifignoredglossary{</span>⟨<span -class="cmitt-10">name</span>⟩<span -class="cmtt-10">}{</span>⟨<span -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. 10026--><p class="noindent" > -This does ⟨<span -class="cmti-10">true</span>⟩ if ⟨<span -class="cmti-10">name</span>⟩ was defined as an ignored glossary, otherwise it does ⟨<span -class="cmti-10">false</span>⟩. -</p><!--l. 10030--><p class="indent" > Note that the main (default) glossary is automatically created as: - - -</p> - <div class="verbatim" id="verbatim-300"> -\newglossary{main}{gls}{glo}{\glossaryname} -</div> -<!--l. 10033--><p class="nopar" > so it can be identified by the label <span -class="cmtt-10">main </span>(unless the <span -class="cmss-10">nomain</span><a - id="dx1-146015"></a> package option is used). Using the <span -class="cmss-10">acronym</span><a - id="dx1-146016"></a> package -option is equivalent to: - - -</p> - <div class="verbatim" id="verbatim-301"> -\newglossary[alg]{acronym}{acr}{acn}{\acronymname} -</div> -<!--l. 10039--><p class="nopar" > so it can be identified by the label <span -class="cmtt-10">acronym</span>. If you are not sure whether the <span -class="cmss-10">acronym</span><a - id="dx1-146017"></a> option has been used, you -can identify the list of acronyms by the command <a - id="dx1-146018"></a><span -class="cmtt-10">\acronymtype </span>which is set to <span -class="cmtt-10">acronym</span>, if the <span -class="cmss-10">acronym</span><a - id="dx1-146019"></a> -option has been used, otherwise it is set to <span -class="cmtt-10">main</span>. Note that if you are using the main glossary -as your list of acronyms, you need to declare it as a list of acronyms using the package option -<span -class="cmss-10">acronymlists</span><a - id="dx1-146020"></a>. -</p><!--l. 10050--><p class="indent" > The <span -class="cmss-10">symbols</span><a - id="dx1-146021"></a> package option creates a new glossary with the label <span -class="cmtt-10">symbols </span>using: - - -</p> - <div class="verbatim" id="verbatim-302"> -\newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname} -</div> -<!--l. 10054--><p class="nopar" > The <span -class="cmss-10">numbers</span><a - id="dx1-146022"></a> package option creates a new glossary with the label <span -class="cmtt-10">numbers </span>using: - - -</p> - <div class="verbatim" id="verbatim-303"> -\newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname} -</div> -<!--l. 10059--><p class="nopar" > The <span -class="cmss-10">index</span><a - id="dx1-146023"></a> package option creates a new glossary with the label <span -class="cmtt-10">index </span>using: - - -</p> - <div class="verbatim" id="verbatim-304"> -\newglossary[ilg]{index}{ind}{idx}{\indexname} -</div> -<!--l. 10064--><p class="nopar" > -</p><!--l. 10066--><p class="indent" > <div class="important" title="Important Note"> Options <a -href="#option2">2</a> and <a -href="#option3">3</a>: all glossaries must be defined before <span -class="cmtt-10">\makeglossaries</span><a - id="dx1-146024"></a> to ensure that the relevant output -files are opened. -</p><!--l. 10070--><p class="indent" > See <a -href="#sec:fixednames">§1.3.1 </a><a -href="#sec:fixednames">Changing the Fixed Names<!--tex4ht:ref: sec:fixednames --></a> if you want to redefine <span -class="cmtt-10">\glossaryname</span>, especially if you are using -<span -class="cmss-10">babel</span><a - id="dx1-146025"></a> or <span -class="cmss-10">translator</span><a - id="dx1-146026"></a>. (Similarly for <span -class="cmtt-10">\glssymbolsgroupname </span>and <span -class="cmtt-10">\glsnumbersgroupname</span>.) If you -want to redefine <span -class="cmtt-10">\indexname</span><a - id="dx1-146027"></a>, just follow the advice in <a -href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fixnam" >How to change LaTeX’s “fixed names”</a>. -</div> -</p><!--l. 10077--><p class="noindent" > - - -</p> -<!--l. 10079--><p class="indent" > </div> -</p><!--l. 10079--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">13. <a +<!--l. 8568--><p class="indent" > </div> +</p><!--l. 8568--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">6. <a id="sec:acronyms"></a>Acronyms and Other Abbreviations</h2> -</p><!--l. 10082--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 8571--><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 provides superior abbreviation handling. You may want to consider using that package instead of the commands described here. </div> -</p><!--l. 10086--><p class="noindent" > -</p><!--l. 10088--><p class="indent" > <div class="important" title="Important Note"> Note that although this chapter uses the term “acronym”, you can also use the commands described here -for initialisms or contractions (as in the case of some of the examples given below). If the glossary title is no -longer applicable (for example, it should be “Abbreviations” rather than “Acronyms”) then you can change the -title either by redefining <span +</p><!--l. 8575--><p class="noindent" > +</p><!--l. 8577--><p class="indent" > <div class="important" title="Important Note"> Note that although this chapter uses the term “acronym”, you can also use the commands +described here for initialisms or contractions (as in the case of some of the examples given below). If +the glossary title is no longer applicable (for example, it should be “Abbreviations” rather than +“Acronyms”) then you can change the title either by redefining <span class="cmtt-10">\acronymname</span><a - id="dx1-147001"></a> (see <a -href="#sec:languages">§1.3 </a><a + id="dx1-135001"></a> (see <a +href="#sec:languages">§<span +class="cmbx-10">??</span>sec:languages +</a><a href="#sec:languages">Multi-Lingual Support<!--tex4ht:ref: sec:languages --></a>) or by using the <span class="cmtt-10">title</span><a - id="dx1-147002"></a> in the optional -argument of <span + id="dx1-135002"></a> key in the optional argument of <span class="cmtt-10">\printglossary</span><a - id="dx1-147003"></a> (or <span + id="dx1-135003"></a> (or +<span class="cmtt-10">\printacronyms</span><a - id="dx1-147004"></a>). Alternatively consider using the <a + id="dx1-135004"></a>). Alternatively consider using the <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package’s -<span id="textcolor282"><span +class="cmss-10">glossaries-extra</span></a> package’s <span id="textcolor286"><span class="cmss-10">abbreviations</span></span><a - id="dx1-147005"></a> option instead. </div> -</p><!--l. 10100--><p class="noindent" > -</p><!--l. 10102--><p class="indent" > You may have noticed in <a -href="#sec:newglosentry">§4 </a><a -href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a> that when you specify a new entry, you can specify -alternate text to use when the term is <a -href="#glo:firstuse">first used</a> in the document. This provides a useful means to define -abbreviations. For convenience, the <span -class="cmss-10">glossaries </span>package defines the command: -</p><!--l. 10107--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147006"></a> <span + id="dx1-135005"></a> option instead. +</div> +</p><!--l. 8589--><p class="noindent" > +</p><!--l. 8591--><p class="indent" > Acronyms use the same underlying mechanism as terms defined with <span +class="cmtt-10">\newglossaryentry </span>so you can +reference them with <span +class="cmtt-10">\gls</span><a + id="dx1-135006"></a> and <span +class="cmtt-10">\glspl</span><a + id="dx1-135007"></a>. The way the acronym is displayed on <a +href="#glo:firstuse">first use</a> is governed by the +acronym style, which should be set before you define your acronyms. For example: + + +</p> + <pre class="verbatim" id="verbatim-227"> +\documentclass{article} +\usepackage{glossaries} +\setacronymstyle{long-short} +\newacronym{html}{HTML}{hypertext markup language} +\newacronym{xml}{XML}{extensible markup language} +\begin{document} +First use: \gls{html} and \gls{xml}. +Next use: \gls{html} and \gls{xml}. +\end{document} +</pre> +<!--l. 8606--><p class="nopar" > If you don’t specify a style, you will have a less-flexible, but backward-compatible, “long (short)” style with just +the base <span +class="cmss-10">glossaries </span>package or the <span id="textcolor287"><span +class="cmss-10">short-nolong</span></span><a + id="dx1-135008"></a> style (which only displays the short form on <a +href="#glo:firstuse">first use</a>) with +<a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>. +</p><!--l. 8613--><p class="indent" > Acronyms are defined using: +</p><!--l. 8614--><p class="indent" > <hr><div title="Definition"><a + id="dx1-135009"></a> <span class="cmtt-10">\newacronym[</span>⟨<span class="cmitt-10">key-val list</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20450,135 +18086,156 @@ class="cmitt-10">abbrv</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">long</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10109--><p class="noindent" > -</p><!--l. 10111--><p class="indent" > This uses <span -class="cmtt-10">\newglossaryentry</span><a - id="dx1-147007"></a> to create an entry with the given label in the glossary given by -<span +</p><!--l. 8616--><p class="noindent" > +</p><!--l. 8618--><p class="indent" > This creates an entry with the given label in the glossary given by <span class="cmtt-10">\acronymtype</span><a - id="dx1-147008"></a>. You can specify a different glossary using the <span + id="dx1-135010"></a>. You can specify a different +glossary using the <span class="cmtt-10">type</span><a - id="dx1-147009"></a> key within the optional argument. The -<span + id="dx1-135011"></a> key within the optional argument. The <span class="cmtt-10">\newacronym </span>command also uses the <span class="cmtt-10">long</span><a - id="dx1-147010"></a>, <span + id="dx1-135012"></a>, +<span class="cmtt-10">longplural</span><a - id="dx1-147011"></a>, <span + id="dx1-135013"></a>, <span class="cmtt-10">short</span><a - id="dx1-147012"></a> and <span + id="dx1-135014"></a> and <span class="cmtt-10">shortplural</span><a - id="dx1-147013"></a> keys in <span -class="cmtt-10">\newglossaryentry</span> -to store the long and abbreviated forms and their plurals. -</p><!--l. 10119--><p class="indent" > Note that the same restrictions on the entry ⟨<span + id="dx1-135015"></a> keys in <span +class="cmtt-10">\newglossaryentry </span>to store the long and abbreviated forms and +their plurals. +</p><!--l. 8626--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use <span +class="cmtt-10">\newacronym </span>with <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>, you need to first set the style with: </p><div class="alltt"> +<div class="obeylines-v"> +<span id="textcolor288"><span +class="cmtt-10">\setabbreviationstyle</span></span><a + id="dx1-135016"></a><span +class="cmtt-10">[acronym]{</span>⟨<span +class="cmitt-10">style-name</span>⟩<span +class="cmtt-10">}</span> +</div> +</div> </div> +<!--l. 8632--><p class="noindent" > +</p><!--l. 8634--><p class="indent" > Note that the same restrictions on the entry ⟨<span class="cmti-10">label</span>⟩ in <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-147014"></a> also apply to <span -class="cmtt-10">\newacronym </span>(see <a -href="#sec:newglosentry">§4 -</a><a -href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>). -</p><!--l. 10123--><p class="indent" > <div class="important" title="Important Note"> If you haven’t identified the specified glossary type as a list of acronyms (via the package option <span + id="dx1-135017"></a> also apply to <span +class="cmtt-10">\newacronym </span>(see +<a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry </a><a +href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>). Since <span +class="cmtt-10">\newacronym</span><a + id="dx1-135018"></a> works like <span +class="cmtt-10">\newglossaryentry</span><a + id="dx1-135019"></a>, you can use +<span +class="cmtt-10">\glsreset</span><a + id="dx1-135020"></a> to reset the <a +href="#glo:firstuseflag">first use flag</a>. +</p><!--l. 8640--><p class="indent" > <div class="important" title="Important Note"> If you haven’t identified the specified glossary type as a list of acronyms (via the package option <span class="cmss-10">acronymlists</span><a - id="dx1-147015"></a> + id="dx1-135021"></a> or the command <span class="cmtt-10">\DeclareAcronymList</span><a - id="dx1-147016"></a>, see <a -href="#sec:pkgopts-acronym">§2.7 </a><a -href="#sec:pkgopts-acronym">Acronym and Abbreviation Options<!--tex4ht:ref: sec:pkgopts-acronym --></a>) <span -class="cmtt-10">\newacronym </span>will add it -to the list and <span + id="dx1-135022"></a>, see <a +href="#sec:pkgopts-acronym">§<span +class="cmbx-10">??</span>sec:pkgopts-acronym </a><a +href="#sec:pkgopts-acronym">Acronym and Abbreviation Options<!--tex4ht:ref: sec:pkgopts-acronym --></a>) +<span +class="cmtt-10">\newacronym </span>will add it to the list and <span class="cmti-10">reset the display style </span>for that glossary via <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-147017"></a>. If you have a mixture of acronyms -and regular entries within the same glossary, care is needed if you want to change the display style: you must -first identify that glossary as a list of acronyms and then use <span + id="dx1-135023"></a>. If you +have a mixture of acronyms and regular entries within the same glossary, care is needed if you want to change +the display style: you must first identify that glossary as a list of acronyms and then use <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-147018"></a> (not redefine <span + id="dx1-135024"></a> (not +redefine <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-147019"></a>) -before defining your entries. </div> -</p><!--l. 10134--><p class="noindent" > -</p><!--l. 10136--><p class="indent" > The optional argument <span + id="dx1-135025"></a>) before defining your entries. Alternatively, use <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> to have better support for +a mixed glossary. </div> +</p><!--l. 8652--><p class="noindent" > +</p><!--l. 8654--><p class="indent" > The optional argument <span class="cmtt-10">{</span>⟨<span class="cmti-10">key-val list</span>⟩<span class="cmtt-10">} </span>allows you to specify additional information. Any key that can be used in the second argument of <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-147020"></a> can also be used here in ⟨<span + id="dx1-135026"></a> can also be used here in ⟨<span class="cmti-10">key-val list</span>⟩. For example, <span class="cmtt-10">description</span><a - id="dx1-147021"></a> + id="dx1-135027"></a> + + (when used with one of the styles that require a description, described in <a -href="#sec:setacronymstyle">§13.1 </a><a -href="#sec:setacronymstyle">Changing the Abbreviation Style<!--tex4ht:ref: sec:setacronymstyle --></a>) -or you can override plural forms of ⟨<span +href="#sec:setacronymstyle">§<span +class="cmbx-10">??</span>sec:setacronymstyle </a><a +href="#sec:setacronymstyle">Changing the +Acronym Style<!--tex4ht:ref: sec:setacronymstyle --></a>) or you can override plural forms of ⟨<span class="cmti-10">abbrv</span>⟩ or ⟨<span class="cmti-10">long</span>⟩ using the <span class="cmtt-10">shortplural</span><a - id="dx1-147022"></a> or <span + id="dx1-135028"></a> or <span class="cmtt-10">longplural</span><a - id="dx1-147023"></a> keys. For -example: + id="dx1-135029"></a> keys. +For example: </p> - <div class="verbatim" id="verbatim-305"> + <pre class="verbatim" id="verbatim-228"> \newacronym[longplural={diagonal matrices}]% - <br />  {dm}{DM}{diagonal matrix} -</div> -<!--l. 10149--><p class="nopar" > If the <a +  {dm}{DM}{diagonal matrix} +</pre> +<!--l. 8667--><p class="nopar" > If the <a href="#glo:firstuse">first use</a> uses the plural form, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspl{dm}</span></span></span> will display: diagonal matrices (DMs). If you want to use the <span class="cmtt-10">longplural</span><a - id="dx1-147024"></a> or <span + id="dx1-135030"></a> or <span class="cmtt-10">shortplural</span><a - id="dx1-147025"></a> keys, I recommend you use <span + id="dx1-135031"></a> keys, I recommend you use <span class="cmtt-10">\setacronymstyle</span><a - id="dx1-147026"></a> to set the display style rather than -using one of the pre-version 4.02 acronym styles. -</p><!--l. 10156--><p class="indent" > As with <span + id="dx1-135032"></a> to set the display style rather than +using one of the pre-version 4.02 acronym styles (described in <a +href="#sec:pkgopts-old-acronym">§<span +class="cmbx-10">??</span>sec:pkgopts-old-acronym </a><a +href="#sec:pkgopts-old-acronym">Deprecated Acronym +Style Options<!--tex4ht:ref: sec:pkgopts-old-acronym --></a>). +</p><!--l. 8675--><p class="indent" > As with <span class="cmtt-10">plural</span><a - id="dx1-147027"></a> and <span -class="cmtt-10">firstplural</span><a - id="dx1-147028"></a>, if <span + id="dx1-135033"></a>, if <span class="cmtt-10">longplural</span><a - id="dx1-147029"></a> is missing, it’s obtained by appended <span + id="dx1-135034"></a> is missing, it’s obtained by appending <span class="cmtt-10">\glspluralsuffix</span><a - id="dx1-147030"></a> -to the singular form. The short plural <span + id="dx1-135035"></a> to the singular +form. The short plural <span class="cmtt-10">shortplural</span><a - id="dx1-147031"></a> is obtained (is not explicitly set) by appending -<span + id="dx1-135036"></a> is obtained (if not explicitly set) by appending <span class="cmtt-10">\glsacrpluralsuffix</span><a - id="dx1-147032"></a> to the short form. These commands may be changed by the associated -language files, but they can’t be added to the usual caption hooks as there’s no guarantee when -they’ll be expanded (as <a -href="#pluralsuffix">discussed earlier</a>). A different approach is used by <span -class="cmss-10">glossaries-extra</span>, which has -<a - id="dx1-147033"></a>category attributes to determine whether or not to append a suffix when forming the default value of -<span + id="dx1-135037"></a> to +the short form. These commands may be changed by the associated language files, but they can’t be +added to the usual caption hooks as there’s no guarantee when they’ll be expanded (as <a +href="#pluralsuffix">discussed +earlier</a>). +</p><!--l. 8684--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> A different approach is used by <span +class="cmss-10">glossaries-extra</span>, which has <a + id="dx1-135038"></a>category attributes to determine whether or not +to append a suffix when forming the default value of <span class="cmtt-10">shortplural</span><a - id="dx1-147034"></a>. -</p><!--l. 10168--><p class="indent" > Since <span -class="cmtt-10">\newacronym</span><a - id="dx1-147035"></a> uses <span -class="cmtt-10">\newglossaryentry</span><a - id="dx1-147036"></a>, you can use commands like <span -class="cmtt-10">\gls</span><a - id="dx1-147037"></a> and <span -class="cmtt-10">\glsreset</span><a - id="dx1-147038"></a> as with any -other glossary entry. -</p><!--l. 10172--><p class="indent" > <div class="important" title="Important Note"> Since <span + id="dx1-135039"></a>. </div> +</p><!--l. 8689--><p class="noindent" > +</p><!--l. 8691--><p class="indent" > <div class="important" title="Important Note"> Since <span class="cmtt-10">\newacronym </span>sets <span class="obeylines-h"><span class="verb"><span class="cmtt-10">type=\acronymtype</span></span></span>, if you want to load a file containing acronym definitions using <span class="cmtt-10">\loadglsentries</span><a - id="dx1-147039"></a><span + id="dx1-135040"></a><span class="cmtt-10">[</span>⟨<span class="cmti-10">type</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20588,40 +18245,44 @@ class="cmti-10">type</span>⟩ will not have an effect unless you explicitl the type as <span class="obeylines-h"><span class="verb"><span class="cmtt-10">type=\glsdefaulttype</span></span></span> in the optional argument to <span class="cmtt-10">\newacronym</span><a - id="dx1-147040"></a>. See <a -href="#sec:loadglsentries">§4.6 </a><a -href="#sec:loadglsentries">Loading Entries From a -File<!--tex4ht:ref: sec:loadglsentries --></a>. </div> -</p><!--l. 10179--><p class="noindent" > + id="dx1-135041"></a>. See <a +href="#sec:loadglsentries">§<span +class="cmbx-10">??</span>sec:loadglsentries </a><a +href="#sec:loadglsentries">Loading +Entries From a File<!--tex4ht:ref: sec:loadglsentries --></a>. </div> +</p><!--l. 8698--><p class="noindent" > <a id="ex:newacronym"></a> -</p><!--l. 10181--><p class="noindent" ><span -class="cmbx-12">Example 21</span><span +</p><!--l. 8700--><p class="noindent" ><span +class="cmbx-12">Example 14</span><span class="cmbx-12"> (Defining an Abbreviation)</span><a - id="x1-147042"></a> -</p><!--l. 10182--><p class="indent" > The following defines the abbreviation IDN: + id="x1-135043"></a> +</p><!--l. 8701--><p class="indent" > The following defines the abbreviation IDN: </p> - <div class="verbatim" id="verbatim-306"> + <pre class="verbatim" id="verbatim-229"> +\setacronymstyle{long-short} \newacronym{idn}{IDN}{identification number} -</div> -<!--l. 10185--><p class="nopar" > <span class="obeylines-h"><span class="verb"><span +</pre> +<!--l. 8705--><p class="nopar" > <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{idn}</span></span></span> will produce “identification number (IDN)” on <a href="#glo:firstuse">first use</a> and “IDN” on subsequent uses. If you want to use one of the <a href="#glo:smallcaps">small caps<a - id="dx1-147043"></a></a> acronym styles, described in <a -href="#sec:setacronymstyle">§13.1 </a><a -href="#sec:setacronymstyle">Changing the Abbreviation Style<!--tex4ht:ref: sec:setacronymstyle --></a>, you need to use -lower case characters for the shortened form: + id="dx1-135044"></a></a> acronym styles, described in <a +href="#sec:setacronymstyle">§<span +class="cmbx-10">??</span>sec:setacronymstyle </a><a +href="#sec:setacronymstyle">Changing the Acronym Style<!--tex4ht:ref: sec:setacronymstyle --></a>, +you need to use lower case characters for the shortened form: </p> - <div class="verbatim" id="verbatim-307"> + <pre class="verbatim" id="verbatim-230"> +\setacronymstyle{long-sc-short} \newacronym{idn}{idn}{identification number} -</div> -<!--l. 10193--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span +</pre> +<!--l. 8714--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{idn}</span></span></span> will produce “identification number (<span class="cmcsc-10"><span class="small-caps">i</span><span @@ -20635,101 +18296,128 @@ class="small-caps">n</span></span>” on subsequent uses. </p> <div class="center" > -<!--l. 10197--><p class="noindent" > -</p><!--l. 10197--><p class="noindent" >____________________________</p></div> -<!--l. 10199--><p class="indent" > <div class="important" title="Important Note"> Avoid nested definitions. </div> -</p><!--l. 10201--><p class="noindent" > -</p><!--l. 10203--><p class="indent" > Recall from the warning in <a -href="#sec:newglosentry">§4 </a><a -href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a> that you should avoid using the <a +<!--l. 8718--><p class="noindent" > +</p><!--l. 8718--><p class="noindent" >____________________________</p></div> +<!--l. 8720--><p class="indent" > <div class="important" title="Important Note"> Avoid nested definitions. </div> +</p><!--l. 8722--><p class="noindent" > +</p><!--l. 8724--><p class="indent" > Recall from the warning in <a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry </a><a +href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a> that you should avoid +using the <a href="#sec:gls-like"><span -class="cmtt-10">\gls</span>-like</a> and -<a +class="cmtt-10">\gls</span>-like</a> and <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands within the value of keys like <span class="cmtt-10">text</span><a - id="dx1-147044"></a> and <span + id="dx1-135045"></a> and <span class="cmtt-10">first</span><a - id="dx1-147045"></a> due to complications arising from nested -links. The same applies to abbreviations defined using <span + id="dx1-135046"></a> +due to complications arising from nested links. The same applies to abbreviations defined using +<span class="cmtt-10">\newacronym</span>. -</p><!--l. 10210--><p class="indent" > For example, suppose you have defined: +</p><!--l. 8731--><p class="indent" > For example, suppose you have defined: </p> - <div class="verbatim" id="verbatim-308"> + <pre class="verbatim" id="verbatim-231"> \newacronym{ssi}{SSI}{server side includes} - <br />\newacronym{html}{HTML}{hypertext markup language} -</div> -<!--l. 10214--><p class="nopar" > you may be tempted to do: +\newacronym{html}{HTML}{hypertext markup language} +</pre> +<!--l. 8735--><p class="nopar" > you may be tempted to do: </p> - <div class="verbatim" id="verbatim-309"> + <pre class="verbatim" id="verbatim-232"> \newacronym{shtml}{S\gls{html}}{\gls{ssi} enabled \gls{html}} -</div> -<!--l. 10218--><p class="nopar" > <strong>Don’t!</strong> This will break the case-changing commands, such as <span +</pre> +<!--l. 8739--><p class="nopar" > <strong>Don’t!</strong> This will break the case-changing commands, such as <span class="cmtt-10">\Gls</span><a - id="dx1-147046"></a>, it will cause inconsistencies on <a + id="dx1-135047"></a>, it will cause inconsistencies on <a href="#glo:firstuse">first use</a>, and, if hyperlinks are enabled, will cause nested hyperlinks. It will also confuse the commands used by the entry formatting (such as <span class="cmtt-10">\glslabel</span><a - id="dx1-147047"></a>). -</p><!--l. 10225--><p class="indent" > Instead, consider doing: + id="dx1-135048"></a>). +</p><!--l. 8746--><p class="indent" > Instead, consider doing: </p> - <div class="verbatim" id="verbatim-310"> + <pre class="verbatim" id="verbatim-233"> \newacronym - <br /> [description={\gls{ssi} enabled \gls{html}}] - <br /> {shtml}{SHTML}{SSI enabled HTML} -</div> -<!--l. 10230--><p class="nopar" > or + [description={\gls{ssi} enabled \gls{html}}] + {shtml}{SHTML}{SSI enabled HTML} +</pre> +<!--l. 8751--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-311"> + <pre class="verbatim" id="verbatim-234"> \newacronym - <br /> [description={\gls{ssi} enabled \gls{html}}] - <br /> {shtml}{SHTML} - <br /> {server side includes enabled hypertext markup language} -</div> -<!--l. 10237--><p class="nopar" > Similarly for the <a + [description={\gls{ssi} enabled \gls{html}}] + {shtml}{SHTML} + {server side includes enabled hypertext markup language} +</pre> +<!--l. 8758--><p class="nopar" > Similarly for the <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands. -</p><!--l. 10240--><p class="indent" > Other approaches are available with <a +</p><!--l. 8761--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> Other approaches are available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. See the section “Nested Links” in the <span class="cmss-10">glossaries-extra</span> -user manual. -</p><!--l. 10244--><p class="indent" > <div class="important" title="Important Note"> The commands described below are similar to the <a +user manual. </div> +</p><!--l. 8765--><p class="noindent" > +</p> +<!--l. 8768--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.1 </span> <a + id="sec:longshortfull"></a>Displaying the Long, Short and Full Forms (Independent of First Use)</h3> +<!--l. 8771--><p class="noindent" >It may be that you want the long, short or full form regardless of whether or not the acronym has already been +used in the document. You can do so with the commands described in this section. +</p><!--l. 8776--><p class="indent" > The <span +class="cmtt-10">\acr</span><span +class="cmtt-10">… </span>commands described below are part of the set of <a href="#sec:glstext-like"><span -class="cmtt-10">\glstext</span>-like</a> commands in that they don’t modify the -<a -href="#glo:firstuseflag">first use flag</a>. However, their display is governed by <span +class="cmtt-10">\glstext</span>-like</a> commands. That is, they +index and can form hyperlinks, but they don’t modify the <a +href="#glo:firstuseflag">first use flag</a>. However, their display is +governed by <span class="cmtt-10">\defentryfmt</span><a - id="dx1-147048"></a> with <span + id="dx1-136001"></a> with <span class="cmtt-10">\glscustomtext</span><a - id="dx1-147049"></a> set as appropriate. All -caveats that apply to the <a + id="dx1-136002"></a> set as appropriate. All caveats that apply to the +<a href="#sec:glstext-like"><span -class="cmtt-10">\glstext</span>-like</a> commands also apply to the following commands. (Including the -warning immediately above this box.) </div> -</p><!--l. 10251--><p class="noindent" > -</p><!--l. 10253--><p class="indent" > The optional arguments are the same as those for the <a +class="cmtt-10">\glstext</span>-like</a> commands also apply to the following commands. (Including the above warning about nested +links.) +</p><!--l. 8784--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you are using <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>, don’t use the commands described in this section. The <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> +package provides analogous <span +class="cmtt-10">\glsxtr</span><span +class="cmtt-10">… </span>or <span +class="cmtt-10">\glsfmt</span><span +class="cmtt-10">… </span>commands. For example, <span +class="cmtt-10">\glsxtrshort </span>instead of +<span +class="cmtt-10">\acrshort </span>or, if needed in a heading, <span +class="cmtt-10">\glsfmtshort</span>. (Similarly for the case-changing variants.) +</div> +</p><!--l. 8791--><p class="noindent" > +</p><!--l. 8793--><p class="indent" > The optional arguments are the same as those for the <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands, and there are similar star and plus variants that switch off or on the hyperlinks. As with the <a href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands, the <a href="#glo:linktext">link text<a - id="dx1-147050"></a></a> is + id="dx1-136003"></a></a> is placed in the argument of <span class="cmtt-10">\glstextformat</span><a - id="dx1-147051"></a>. -</p><!--l. 10258--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147052"></a> <span + id="dx1-136004"></a>. +</p><!--l. 8798--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136005"></a> <span class="cmtt-10">\acrshort[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20737,21 +18425,21 @@ 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. 10260--><p class="noindent" > +</p><!--l. 8800--><p class="noindent" > This sets the <a href="#glo:linktext">link text<a - id="dx1-147053"></a></a> to the short form (within the argument of <span + id="dx1-136006"></a></a> to the short form (within the argument of <span class="cmtt-10">\acronymfont</span><a - id="dx1-147054"></a>) for the entry given by ⟨<span + id="dx1-136007"></a>) for the entry given by ⟨<span class="cmti-10">label</span>⟩. The short form is as supplied by the <span class="cmtt-10">short</span><a - id="dx1-147055"></a> key, which <span + id="dx1-136008"></a> key, which <span class="cmtt-10">\newacronym</span><a - id="dx1-147056"></a> implicitly sets. -</p><!--l. 10266--><p class="indent" > There are also analogous upper case variants: -</p><!--l. 10267--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147057"></a> <span + id="dx1-136009"></a> implicitly sets. +</p><!--l. 8806--><p class="indent" > There are also analogous upper case variants: +</p><!--l. 8807--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136010"></a> <span class="cmtt-10">\Acrshort[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20759,9 +18447,9 @@ 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. 10269--><p class="noindent" > -</p><!--l. 10270--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147058"></a> <span +</p><!--l. 8809--><p class="noindent" > +</p><!--l. 8810--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136011"></a> <span class="cmtt-10">\ACRshort[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20769,10 +18457,10 @@ 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. 10272--><p class="noindent" > +</p><!--l. 8812--><p class="noindent" > There are also plural versions: -</p><!--l. 10274--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147059"></a> <span +</p><!--l. 8814--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136012"></a> <span class="cmtt-10">\acrshortpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20780,9 +18468,11 @@ 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. 10276--><p class="noindent" > -</p><!--l. 10277--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147060"></a> <span +</p><!--l. 8816--><p class="noindent" > + + +</p><!--l. 8817--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136013"></a> <span class="cmtt-10">\Acrshortpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20790,9 +18480,9 @@ 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. 10279--><p class="noindent" > -</p><!--l. 10280--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147061"></a> <span +</p><!--l. 8819--><p class="noindent" > +</p><!--l. 8820--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136014"></a> <span class="cmtt-10">\ACRshortpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20800,14 +18490,14 @@ 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. 10282--><p class="noindent" > +</p><!--l. 8822--><p class="noindent" > The short plural form is as supplied by the <span class="cmtt-10">shortplural</span><a - id="dx1-147062"></a> key, which <span + id="dx1-136015"></a> key, which <span class="cmtt-10">\newacronym</span><a - id="dx1-147063"></a> implicitly sets. -</p><!--l. 10286--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147064"></a> <span + id="dx1-136016"></a> implicitly sets. +</p><!--l. 8826--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136017"></a> <span class="cmtt-10">\acrlong[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20815,19 +18505,19 @@ 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. 10288--><p class="noindent" > +</p><!--l. 8828--><p class="noindent" > This sets the <a href="#glo:linktext">link text<a - id="dx1-147065"></a></a> to the long form for the entry given by ⟨<span + id="dx1-136018"></a></a> to the long form for the entry given by ⟨<span class="cmti-10">label</span>⟩. The long form is as supplied by the <span class="cmtt-10">long</span><a - id="dx1-147066"></a> + id="dx1-136019"></a> key, which <span class="cmtt-10">\newacronym</span><a - id="dx1-147067"></a> implicitly sets. -</p><!--l. 10293--><p class="indent" > There are also analogous upper case variants: -</p><!--l. 10294--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147068"></a> <span + id="dx1-136020"></a> implicitly sets. +</p><!--l. 8833--><p class="indent" > There are also analogous upper case variants: +</p><!--l. 8834--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136021"></a> <span class="cmtt-10">\Acrlong[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20835,11 +18525,9 @@ 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. 10296--><p class="noindent" > -</p><!--l. 10297--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147069"></a> <span +</p><!--l. 8836--><p class="noindent" > +</p><!--l. 8837--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136022"></a> <span class="cmtt-10">\ACRlong[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20847,10 +18535,10 @@ 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. 10299--><p class="noindent" > +</p><!--l. 8839--><p class="noindent" > Again there are also plural versions: -</p><!--l. 10301--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147070"></a> <span +</p><!--l. 8841--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136023"></a> <span class="cmtt-10">\acrlongpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20858,9 +18546,9 @@ 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. 10303--><p class="noindent" > -</p><!--l. 10304--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147071"></a> <span +</p><!--l. 8843--><p class="noindent" > +</p><!--l. 8844--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136024"></a> <span class="cmtt-10">\Acrlongpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20868,9 +18556,9 @@ 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. 10306--><p class="noindent" > -</p><!--l. 10307--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147072"></a> <span +</p><!--l. 8846--><p class="noindent" > +</p><!--l. 8847--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136025"></a> <span class="cmtt-10">\ACRlongpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20878,21 +18566,21 @@ 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. 10309--><p class="noindent" > +</p><!--l. 8849--><p class="noindent" > The long plural form is as supplied by the <span class="cmtt-10">longplural</span><a - id="dx1-147073"></a> key, which <span + id="dx1-136026"></a> key, which <span class="cmtt-10">\newacronym</span><a - id="dx1-147074"></a> implicitly sets. -</p><!--l. 10313--><p class="indent" > The commands below display the full form of the acronym, but note that this isn’t necessarily the same as + id="dx1-136027"></a> implicitly sets. +</p><!--l. 8853--><p class="indent" > The commands below display the full form of the acronym, but note that this isn’t necessarily the same as the form used on <a href="#glo:firstuse">first use</a>. These full-form commands are shortcuts that use the above commands, rather than creating the <a href="#glo:linktext">link text<a - id="dx1-147075"></a></a> from the complete full form. These full-form commands have star and plus variants and + id="dx1-136028"></a></a> from the complete full form. These full-form commands have star and plus variants and optional arguments that are passed to the above commands. -</p><!--l. 10320--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147076"></a> <span +</p><!--l. 8860--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136029"></a> <span class="cmtt-10">\acrfull[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20900,10 +18588,10 @@ 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. 10322--><p class="noindent" > +</p><!--l. 8862--><p class="noindent" > This is a shortcut for -</p><!--l. 10324--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147077"></a> <span +</p><!--l. 8864--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136030"></a> <span class="cmtt-10">\acrfullfmt{</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -20911,7 +18599,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. 10326--><p class="noindent" > +</p><!--l. 8866--><p class="noindent" > which by default does </p><div class="alltt"> <div class="obeylines-v"> <span @@ -20932,27 +18620,30 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}}</span> </div> </div> where -<!--l. 10334--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147078"></a> <span +<!--l. 8874--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136031"></a> <span class="cmtt-10">\acrfullformat{</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. 10336--><p class="noindent" > + + +</p><!--l. 8876--><p class="noindent" > by default does ⟨<span class="cmti-10">long</span>⟩ (⟨<span -class="cmti-10">short</span>⟩). This command is now deprecated for new acronym styles but is used by -the default for backward compatibility if <span +class="cmti-10">short</span>⟩). This command is now deprecated for new acronym styles but is used by default +for backward compatibility if <span class="cmtt-10">\setacronymstyle </span>(<a -href="#sec:setacronymstyle">§13.1 </a><a -href="#sec:setacronymstyle">Changing the Abbreviation +href="#sec:setacronymstyle">§<span +class="cmbx-10">??</span>sec:setacronymstyle </a><a +href="#sec:setacronymstyle">Changing the Acronym Style<!--tex4ht:ref: sec:setacronymstyle --></a>) hasn’t been used. (For further details of these format commands see the documented code, <span class="cmtt-10">glossaries-code.pdf</span>.) -</p><!--l. 10345--><p class="indent" > There are also analogous upper case variants: -</p><!--l. 10346--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147079"></a> <span +</p><!--l. 8885--><p class="indent" > There are also analogous upper case variants: +</p><!--l. 8886--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136032"></a> <span class="cmtt-10">\Acrfull[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20960,9 +18651,9 @@ 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. 10348--><p class="noindent" > -</p><!--l. 10349--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147080"></a> <span +</p><!--l. 8888--><p class="noindent" > +</p><!--l. 8889--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136033"></a> <span class="cmtt-10">\ACRfull[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20970,10 +18661,10 @@ 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. 10351--><p class="noindent" > +</p><!--l. 8891--><p class="noindent" > and plural versions: -</p><!--l. 10353--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147081"></a> <span +</p><!--l. 8893--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136034"></a> <span class="cmtt-10">\acrfullpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20981,11 +18672,9 @@ 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. 10355--><p class="noindent" > -</p><!--l. 10356--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147082"></a> <span +</p><!--l. 8895--><p class="noindent" > +</p><!--l. 8896--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136035"></a> <span class="cmtt-10">\Acrfullpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -20993,9 +18682,9 @@ 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. 10358--><p class="noindent" > -</p><!--l. 10359--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147083"></a> <span +</p><!--l. 8898--><p class="noindent" > +</p><!--l. 8899--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136036"></a> <span class="cmtt-10">\ACRfullpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -21003,27 +18692,28 @@ 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. 10361--><p class="noindent" > -</p><!--l. 10363--><p class="indent" > If you find the above commands too cumbersome to write, you can use the <span +</p><!--l. 8901--><p class="noindent" > +</p><!--l. 8903--><p class="indent" > If you find the above commands too cumbersome to write, you can use the <span class="cmss-10">shortcuts</span><a - id="dx1-147084"></a> package option to + id="dx1-136037"></a> package option to activate the shorter command names listed in <a -href="#tab:shortcuts">table 13.1</a>. +href="#tab:shortcuts">table <span +class="cmbx-10">??</span>tab:shortcuts</a>. </p> <div class="table"> -<!--l. 10367--><p class="indent" > <a +<!--l. 8907--><p class="indent" > <a id="tab:shortcuts"></a></p><hr class="float" /><div class="float" > <div class="caption" -><span class="id">Table 13.1: </span><span +><span class="id">Table 6.1: </span><span class="content">Synonyms provided by the package option <span -class="cmss-10">shortcuts</span></span></div><!--tex4ht:label?: x1-1470851 --> +class="cmss-10">shortcuts</span></span></div><!--tex4ht:label?: x1-1360381 --> <div class="tabular"> <table id="TBL-7" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-7-1g"><col id="TBL-7-1" /><col id="TBL-7-2" /></colgroup><tr @@ -21036,450 +18726,472 @@ class="cmbx-10">Equivalent Command </span></td> style="vertical-align:baseline;" id="TBL-7-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-1" class="td11"> <span class="cmtt-10">\acs</span><a - id="dx1-147086"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-2" + id="dx1-136039"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-2" class="td11"> <span class="cmtt-10">\acrshort</span><a - id="dx1-147087"></a> </td> + id="dx1-136040"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-1" class="td11"> <span class="cmtt-10">\Acs</span><a - id="dx1-147088"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-2" + id="dx1-136041"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-2" class="td11"> <span class="cmtt-10">\Acrshort</span><a - id="dx1-147089"></a> </td> + id="dx1-136042"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-1" class="td11"> <span class="cmtt-10">\acsp</span><a - id="dx1-147090"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-2" + id="dx1-136043"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-2" class="td11"> <span class="cmtt-10">\acrshortpl</span><a - id="dx1-147091"></a> </td> + id="dx1-136044"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-1" class="td11"> <span class="cmtt-10">\Acsp</span><a - id="dx1-147092"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-2" + id="dx1-136045"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-2" class="td11"> <span class="cmtt-10">\Acrshortpl</span><a - id="dx1-147093"></a> </td> + id="dx1-136046"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-1" class="td11"> <span class="cmtt-10">\acl</span><a - id="dx1-147094"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-2" + id="dx1-136047"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-2" class="td11"> <span class="cmtt-10">\acrlong</span><a - id="dx1-147095"></a> </td> + id="dx1-136048"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-1" class="td11"> <span class="cmtt-10">\Acl</span><a - id="dx1-147096"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-2" + id="dx1-136049"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-2" class="td11"> <span class="cmtt-10">\Acrlong</span><a - id="dx1-147097"></a> </td> + id="dx1-136050"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-1" class="td11"> <span class="cmtt-10">\aclp</span><a - id="dx1-147098"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-2" + id="dx1-136051"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-2" class="td11"> <span class="cmtt-10">\acrlongpl</span><a - id="dx1-147099"></a> </td> + id="dx1-136052"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-1" class="td11"> <span class="cmtt-10">\Aclp</span><a - id="dx1-147100"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-2" + id="dx1-136053"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-2" class="td11"> <span class="cmtt-10">\Acrlongpl</span><a - id="dx1-147101"></a> </td> + id="dx1-136054"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-1" class="td11"> <span class="cmtt-10">\acf</span><a - id="dx1-147102"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-2" + id="dx1-136055"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-2" class="td11"> <span class="cmtt-10">\acrfull</span><a - id="dx1-147103"></a> </td> + id="dx1-136056"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-1" class="td11"> <span class="cmtt-10">\Acf</span><a - id="dx1-147104"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-2" + id="dx1-136057"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-2" class="td11"> <span class="cmtt-10">\Acrfull</span><a - id="dx1-147105"></a> </td> + id="dx1-136058"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-1" class="td11"> <span class="cmtt-10">\acfp</span><a - id="dx1-147106"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-2" + id="dx1-136059"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-2" class="td11"> <span class="cmtt-10">\acrfullpl</span><a - id="dx1-147107"></a> </td> + id="dx1-136060"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-1" class="td11"> <span class="cmtt-10">\Acfp</span><a - id="dx1-147108"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-2" + id="dx1-136061"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-2" class="td11"> <span class="cmtt-10">\Acrfullpl</span><a - id="dx1-147109"></a> </td> + id="dx1-136062"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-1" class="td11"> <span class="cmtt-10">\ac</span><a - id="dx1-147110"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-2" + id="dx1-136063"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-2" class="td11"> <span class="cmtt-10">\gls</span><a - id="dx1-147111"></a> </td> + id="dx1-136064"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-1" class="td11"> <span class="cmtt-10">\Ac</span><a - id="dx1-147112"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-2" + id="dx1-136065"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-2" class="td11"> <span class="cmtt-10">\Gls</span><a - id="dx1-147113"></a> </td> + id="dx1-136066"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-1" class="td11"> <span class="cmtt-10">\acp</span><a - id="dx1-147114"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-2" + id="dx1-136067"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-2" class="td11"> <span class="cmtt-10">\glspl</span><a - id="dx1-147115"></a> </td> + id="dx1-136068"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-7-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-1" class="td11"> <span class="cmtt-10">\Acp</span><a - id="dx1-147116"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-2" + id="dx1-136069"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-2" class="td11"> <span class="cmtt-10">\Glspl</span><a - id="dx1-147117"></a> </td></tr></table> + id="dx1-136070"></a> </td></tr></table> </div> </div><hr class="endfloat" /> </div> -<!--l. 10393--><p class="indent" > It is also possible to access the long and short forms without adding information to the glossary using +<!--l. 8933--><p class="indent" > It is also possible to access the long and short forms without adding information to the glossary using commands analogous to <span class="cmtt-10">\glsentrytext</span><a - id="dx1-147118"></a> (described in <a -href="#sec:glsnolink">§9 </a><a -href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>). -</p><!--l. 10397--><p class="indent" > <div class="important" title="Important Note"> The commands that convert the first letter to upper case come with the same caveats as those for analogous + id="dx1-136071"></a> (described in <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a +href="#sec:glsnolink">Using Glossary Terms Without +Links<!--tex4ht:ref: sec:glsnolink --></a>). +</p><!--l. 8937--><p class="indent" > <div class="important" title="Important Note"> The commands that convert the first letter to upper case come with the same caveats as those for analogous commands like <span class="cmtt-10">\Glsentrytext</span><a - id="dx1-147119"></a> (non-expandable, can’t be used in PDF bookmarks, care needs to be -taken if the first letter is an accented character etc). See <a -href="#sec:glsnolink">§9 </a><a + id="dx1-136072"></a> (non-expandable, can’t be used in PDF bookmarks, care needs to be taken if the +first letter is an accented character etc). See <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>. </div> -</p><!--l. 10403--><p class="noindent" > -</p><!--l. 10405--><p class="indent" > The long form can be accessed using: -</p><!--l. 10406--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147120"></a> <span +</p><!--l. 8943--><p class="noindent" > +</p><!--l. 8945--><p class="indent" > The long form can be accessed using: +</p><!--l. 8946--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136073"></a> <span class="cmtt-10">\glsentrylong{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10408--><p class="noindent" > +</p><!--l. 8948--><p class="noindent" > or, with the first letter converted to upper case: -</p><!--l. 10410--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147121"></a> <span +</p><!--l. 8950--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136074"></a> <span class="cmtt-10">\Glsentrylong{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10412--><p class="noindent" > +</p><!--l. 8952--><p class="noindent" > Plural forms: -</p><!--l. 10414--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147122"></a> <span +</p><!--l. 8954--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136075"></a> <span class="cmtt-10">\glsentrylongpl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10416--><p class="noindent" > -</p><!--l. 10417--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147123"></a> <span +</p><!--l. 8956--><p class="noindent" > +</p><!--l. 8957--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136076"></a> <span class="cmtt-10">\Glsentrylongpl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10419--><p class="noindent" > -</p><!--l. 10421--><p class="indent" > Similarly, to access the short form: -</p><!--l. 10422--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147124"></a> <span +</p><!--l. 8959--><p class="noindent" > +</p><!--l. 8961--><p class="indent" > Similarly, to access the short form: +</p><!--l. 8962--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136077"></a> <span class="cmtt-10">\glsentryshort{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10424--><p class="noindent" > +</p><!--l. 8964--><p class="noindent" > or, with the first letter converted to upper case: -</p><!--l. 10426--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147125"></a> <span +</p><!--l. 8966--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136078"></a> <span class="cmtt-10">\Glsentryshort{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10428--><p class="noindent" > +</p><!--l. 8968--><p class="noindent" > Plural forms: -</p><!--l. 10430--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147126"></a> <span +</p><!--l. 8970--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136079"></a> <span class="cmtt-10">\glsentryshortpl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10432--><p class="noindent" > -</p><!--l. 10433--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147127"></a> <span +</p><!--l. 8972--><p class="noindent" > +</p><!--l. 8973--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136080"></a> <span class="cmtt-10">\Glsentryshortpl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10435--><p class="noindent" > -</p><!--l. 10437--><p class="indent" > And the full form can be obtained using: -</p><!--l. 10438--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147128"></a> <span +</p><!--l. 8975--><p class="noindent" > +</p><!--l. 8977--><p class="indent" > And the full form can be obtained using: +</p><!--l. 8978--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136081"></a> <span class="cmtt-10">\glsentryfull{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10440--><p class="noindent" > -</p><!--l. 10441--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147129"></a> <span +</p><!--l. 8980--><p class="noindent" > +</p><!--l. 8981--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136082"></a> <span class="cmtt-10">\Glsentryfull{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10443--><p class="noindent" > -</p><!--l. 10444--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147130"></a> <span +</p><!--l. 8983--><p class="noindent" > +</p><!--l. 8984--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136083"></a> <span class="cmtt-10">\glsentryfullpl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10446--><p class="noindent" > -</p><!--l. 10447--><p class="indent" > <hr><div title="Definition"><a - id="dx1-147131"></a> <span +</p><!--l. 8986--><p class="noindent" > +</p><!--l. 8987--><p class="indent" > <hr><div title="Definition"><a + id="dx1-136084"></a> <span class="cmtt-10">\Glsentryfullpl{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10449--><p class="noindent" > +</p><!--l. 8989--><p class="noindent" > These again use <span class="cmtt-10">\acrfullformat</span><a - id="dx1-147132"></a> by default, but the new styles described in the section below use different + id="dx1-136085"></a> by default, but the new styles described in the section below use different formatting commands. </p> -<!--l. 10454--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">13.1 </span> <a - id="sec:setacronymstyle"></a>Changing the Abbreviation Style</h3> -<!--l. 10457--><p class="noindent" >It may be that the default style doesn’t suit your requirements in which case you can switch to another style -using -</p><!--l. 10459--><p class="indent" > <hr><div title="Definition"><a - id="dx1-148001"></a> <span +<!--l. 8994--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.2 </span> <a + id="sec:setacronymstyle"></a>Changing the Acronym Style</h3> +<!--l. 8997--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you are using <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>, don’t use the commands described in this section. Use <span id="textcolor289"><span +class="cmtt-10">\setabbreviationstyle</span></span><a + id="dx1-137001"></a> to +set the style. This uses a different (but more consistent) naming scheme. For example, <span id="textcolor290"><span +class="cmss-10">long-noshort</span></span><a + id="dx1-137002"></a> instead of +<span +class="cmss-10">dua</span><a + id="dx1-137003"></a>. See the “Acronym Style Modifications” section and the “Abbreviations” chapter in the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> +manual for further details. </div> +</p><!--l. 9005--><p class="noindent" > +</p><!--l. 9007--><p class="noindent" >The acronym style is set using: +</p><!--l. 9008--><p class="indent" > <hr><div title="Definition"><a + id="dx1-137004"></a> <span class="cmtt-10">\setacronymstyle{</span>⟨<span class="cmitt-10">style name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10461--><p class="noindent" > +</p><!--l. 9010--><p class="noindent" > where ⟨<span class="cmti-10">style name</span>⟩ is the name of the required style. -</p><!--l. 10464--><p class="indent" > <div class="important" title="Important Note"> You must use <span +</p><!--l. 9013--><p class="indent" > <div class="important" title="Important Note"> You must use <span class="cmtt-10">\setacronymstyle </span><span class="cmti-10">before </span>you define the acronyms with <span class="cmtt-10">\newacronym</span>. </div> -</p><!--l. 10467--><p class="noindent" > -</p><!--l. 10469--><p class="indent" > For example: +</p><!--l. 9016--><p class="noindent" > +</p><!--l. 9018--><p class="indent" > For example: </p> - <div class="verbatim" id="verbatim-312"> + <pre class="verbatim" id="verbatim-235"> \usepackage[acronym]{glossaries} - <br />\makeglossaries - <br />\setacronymstyle{long-sc-short} - <br />\newacronym{html}{html}{hypertext markup language} - <br />\newacronym{xml}{xml}{extensible markup language} -</div> -<!--l. 10479--><p class="nopar" > Unpredictable results can occur if you try to use multiple styles. -</p><!--l. 10482--><p class="indent" > <div class="important" title="Important Note"> If you need multiple abbreviation styles, then try using the <a -href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package, which has better -abbreviation management. </div> -</p><!--l. 10486--><p class="noindent" > -</p><!--l. 10488--><p class="indent" > Unlike the default behaviour of <span -class="cmtt-10">\newacronym</span>, the styles used via <span -class="cmtt-10">\setacronymstyle </span>don’t use the <span +\makeglossaries +\setacronymstyle{long-sc-short} +\newacronym{html}{html}{hypertext markup language} +\newacronym{xml}{xml}{extensible markup language} +</pre> +<!--l. 9028--><p class="nopar" > Unpredictable results can occur if you try to use multiple styles. +</p><!--l. 9031--><p class="indent" > <div class="important" title="Important Note"> If you need multiple abbreviation styles, then use the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> package, which has better abbreviation +management. See, for example, <a +href="https://www.dickimaw-books.com/gallery/index.php?label=sample-name-font" >Gallery: Mixing Styles</a>. </div> +</p><!--l. 9036--><p class="noindent" > +</p><!--l. 9038--><p class="indent" > Unlike the backward-compatible default behaviour of <span +class="cmtt-10">\newacronym</span>, the styles set via <span +class="cmtt-10">\setacronymstyle</span> +don’t use the <span class="cmtt-10">first</span><a - id="dx1-148002"></a> or -<span + id="dx1-137005"></a> or <span class="cmtt-10">text</span><a - id="dx1-148003"></a> keys, but instead they use <span + id="dx1-137006"></a> keys, but instead they use <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-148004"></a> to set a custom format that uses the <span + id="dx1-137007"></a> to set a custom format +that uses the <span class="cmtt-10">long</span><a - id="dx1-148005"></a> and <span + id="dx1-137008"></a> and <span class="cmtt-10">short</span><a - id="dx1-148006"></a> keys -(or their plural equivalents). This means that these styles cope better with plurals that aren’t formed by simply -appending the singular form with the letter “s”. In fact, most of the predefined styles use <span + id="dx1-137009"></a> keys (or their plural equivalents). This means that these styles cope +better with plurals that aren’t formed by simply appending the singular form with the letter “s”. In +fact, most of the predefined styles use <span class="cmtt-10">\glsgenacfmt</span><a - id="dx1-148007"></a> and -modify the definitions of commands like <span + id="dx1-137010"></a> and modify the definitions of commands like +<span class="cmtt-10">\genacrfullformat</span><a - id="dx1-148008"></a>. -</p><!--l. 10498--><p class="indent" > Note that when you use <span + id="dx1-137011"></a>. +</p><!--l. 9048--><p class="indent" > Note that when you use <span class="cmtt-10">\setacronymstyle </span>the <span class="cmtt-10">name</span><a - id="dx1-148009"></a> key is set to -</p><!--l. 10500--><p class="indent" > <hr><div title="Definition"><a - id="dx1-148010"></a> <span + id="dx1-137012"></a> key is set to +</p><!--l. 9050--><p class="indent" > <hr><div title="Definition"><a + id="dx1-137013"></a> <span class="cmtt-10">\acronymentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10502--><p class="noindent" > +</p><!--l. 9052--><p class="noindent" > and the <span class="cmtt-10">sort</span><a - id="dx1-148011"></a> key is set to -</p><!--l. 10504--><p class="indent" > <hr><div title="Definition"><a - id="dx1-148012"></a> <span + id="dx1-137014"></a> key is set to +</p><!--l. 9054--><p class="indent" > <hr><div title="Definition"><a + id="dx1-137015"></a> <span class="cmtt-10">\acronymsort{</span>⟨<span 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. 10506--><p class="noindent" > +</p><!--l. 9056--><p class="noindent" > These commands are redefined by the acronym styles. However, you can redefine them again after the style has been set but before you use <span class="cmtt-10">\newacronym</span>. Protected expansion is performed on <span class="cmtt-10">\acronymsort </span>when the entry is defined. -</p><!--l. 10512--><p class="noindent" > +</p><!--l. 9062--><p class="noindent" > </p> -<!--l. 10512--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.1 </span> <a +<!--l. 9062--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.2.1 </span> <a id="sec:predefinedacrstyles"></a>Predefined Acronym Styles</h4> -<!--l. 10515--><p class="noindent" >The <span +<!--l. 9065--><p class="noindent" >The <span class="cmss-10">glossaries </span>package provides a number of predefined styles. These styles apply -</p><!--l. 10517--><p class="indent" > <hr><div title="Definition"><a - id="dx1-149001"></a> <span +</p><!--l. 9067--><p class="indent" > <hr><div title="Definition"><a + id="dx1-138001"></a> <span class="cmtt-10">\firstacronymfont{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10519--><p class="noindent" > +</p><!--l. 9069--><p class="noindent" > to the short form on first use and -</p><!--l. 10521--><p class="indent" > <hr><div title="Definition"><a - id="dx1-149002"></a> <span +</p><!--l. 9071--><p class="indent" > <hr><div title="Definition"><a + id="dx1-138002"></a> <span class="cmtt-10">\acronymfont{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10523--><p class="noindent" > +</p><!--l. 9073--><p class="noindent" > on subsequent use. The styles modify the definition of <span class="cmtt-10">\acronymfont </span>as required, but <span class="cmtt-10">\firstacronymfont</span><a - id="dx1-149003"></a> is + id="dx1-138003"></a> is only set once by the package when it’s loaded. By default <span class="cmtt-10">\firstacronymfont</span><a - id="dx1-149004"></a><span + id="dx1-138004"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">text</span>⟩<span class="cmtt-10">} </span>is the same as + + <span class="cmtt-10">\acronymfont</span><a - id="dx1-149005"></a><span + id="dx1-138005"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">text</span>⟩<span class="cmtt-10">}</span>. If you want the short form displayed differently on first use, you can redefine <span class="cmtt-10">\firstacronymfont</span><a - id="dx1-149006"></a> independently of the acronym style. - - -</p><!--l. 10533--><p class="indent" > The predefined styles that contain <span + id="dx1-138006"></a> independently of the acronym style. +</p><!--l. 9083--><p class="indent" > The predefined styles that contain <span class="cmtt-10">sc </span>in their name (for example <span class="cmss-10">long-sc-short</span><a - id="dx1-149007"></a>) redefine <span + id="dx1-138007"></a>) redefine <span class="cmtt-10">\acronymfont </span>to use <span class="cmtt-10">\textsc</span><a - id="dx1-149008"></a>, which means that the short form needs to be specified in lower case. -</p><!--l. 10539--><p class="indent" > <a + id="dx1-138008"></a>, which means that the short form needs to be specified in lower case. +</p><!--l. 9089--><p class="indent" > <a id="boldsc"></a> -</p><!--l. 10540--><p class="indent" > <div class="important" title="Important Note">Some fonts don’t support bold <a +</p><!--l. 9090--><p class="indent" > <div class="important" title="Important Note">Some fonts don’t support bold <a href="#glo:smallcaps">small caps<a - id="dx1-149009"></a></a>, so you may need to redefine <span + id="dx1-138009"></a></a>, so you may need to redefine <span class="cmtt-10">\glsnamefont</span><a - id="dx1-149010"></a> (see <a -href="#sec:printglossary">§10 </a><a -href="#sec:printglossary">Displaying a -glossary<!--tex4ht:ref: sec:printglossary --></a>) to switch to medium weight if you are using a glossary style that displays entry names in bold and you -have chosen an acronym style that uses <span + id="dx1-138010"></a> (see +<a +href="#sec:printglossary">§<span +class="cmbx-10">??</span>sec:printglossary </a><a +href="#sec:printglossary">Displaying a Glossary<!--tex4ht:ref: sec:printglossary --></a>) to switch to medium weight if you are using a glossary +style that displays entry names in bold and you have chosen an acronym style that uses <span class="cmtt-10">\textsc</span><a - id="dx1-149011"></a>. </div> -</p><!--l. 10546--><p class="noindent" > -</p><!--l. 10548--><p class="indent" > The predefined styles that contain <span + id="dx1-138011"></a>. +</div> +</p><!--l. 9096--><p class="noindent" > +</p><!--l. 9098--><p class="indent" > The predefined styles that contain <span class="cmtt-10">sm </span>in their name (for example <span class="cmss-10">long-sm-short</span><a - id="dx1-149012"></a>) redefine <span + id="dx1-138012"></a>) redefine <span class="cmtt-10">\acronymfont </span>to use <span class="cmtt-10">\textsmaller</span><a - id="dx1-149013"></a>. -</p><!--l. 10552--><p class="indent" > <a + id="dx1-138013"></a>. +</p><!--l. 9102--><p class="indent" > <a id="smaller"></a> -</p><!--l. 10553--><p class="indent" > <div class="important" title="Important Note"> Note that the <span +</p><!--l. 9103--><p class="indent" > <div class="important" title="Important Note"> Note that the <span class="cmss-10">glossaries </span>package doesn’t define or load any package that defines <span class="cmtt-10">\textsmaller</span><a - id="dx1-149014"></a>. If you use + id="dx1-138014"></a>. If you use one of the acronym styles that set <span class="cmtt-10">\acronymfont</span><a - id="dx1-149015"></a> to <span + id="dx1-138015"></a> to <span class="cmtt-10">\textsmaller </span>you must explicitly load the <span class="cmss-10">relsize</span><a - id="dx1-149016"></a> package + id="dx1-138016"></a> package or otherwise define <span class="cmtt-10">\textsmaller</span>. </div> -</p><!--l. 10559--><p class="noindent" > -</p><!--l. 10561--><p class="indent" > The remaining predefined styles redefine <span +</p><!--l. 9109--><p class="noindent" > +</p><!--l. 9111--><p class="indent" > The remaining predefined styles redefine <span class="cmtt-10">\acronymfont{</span>⟨<span class="cmti-10">text</span>⟩<span class="cmtt-10">} </span>to simply do its argument ⟨<span class="cmti-10">text</span>⟩. -</p><!--l. 10564--><p class="indent" > <div class="important" title="Important Note"> In most cases, the predefined styles adjust <span +</p><!--l. 9114--><p class="indent" > <div class="important" title="Important Note"> In most cases, the predefined styles adjust <span class="cmtt-10">\acrfull</span><a - id="dx1-149017"></a> and <span + id="dx1-138017"></a> and <span class="cmtt-10">\glsentryfull</span><a - id="dx1-149018"></a> (and their plural and upper case + id="dx1-138018"></a> (and their plural and upper case variants) to reflect the style. The only exceptions to this are the <span class="cmss-10">dua</span><a - id="dx1-149019"></a> and <span + id="dx1-138019"></a> and <span class="cmss-10">footnote</span><a - id="dx1-149020"></a> styles (and their variants). + id="dx1-138020"></a> styles (and their variants). </div> -</p><!--l. 10569--><p class="noindent" > -</p><!--l. 10571--><p class="indent" > The following styles are supplied by the <span +</p><!--l. 9119--><p class="noindent" > +</p><!--l. 9121--><p class="indent" > The following styles are supplied by the <span class="cmss-10">glossaries </span>package: </p> <ul class="itemize1"> - <li class="itemize"><span + <li class="itemize"> + <!--l. 9124--><p class="noindent" ><span class="cmss-10">long-short</span><a - id="dx1-149021"></a>, <span + id="dx1-138021"></a>, <span class="cmss-10">long-sc-short</span><a - id="dx1-149022"></a>, <span + id="dx1-138022"></a>, <span class="cmss-10">long-sm-short</span><a - id="dx1-149023"></a>, <span + id="dx1-138023"></a>, <span class="cmss-10">long-sp-short</span><a - id="dx1-149024"></a>: - <!--l. 10577--><p class="noindent" >With these three styles, acronyms are displayed in the form - </p><!--l. 10579--><p class="noindent" ><hr><div title="Definition">⟨<span + id="dx1-138024"></a>: + </p><!--l. 9127--><p class="noindent" >With these three styles, acronyms are displayed in the form + </p><!--l. 9129--><p class="noindent" ><hr><div title="Definition">⟨<span class="cmitt-10">long</span>⟩ <span class="cmtt-10">(\firstacronymfont</span><a - id="dx1-149025"></a><span + id="dx1-138025"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">short</span>⟩<span class="cmtt-10">}) </span></div><hr> - </p><!--l. 10580--><p class="noindent" > + </p><!--l. 9130--><p class="noindent" > on first use and - </p><!--l. 10583--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 9133--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\acronymfont</span><a - id="dx1-149026"></a><span + id="dx1-138026"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">short</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 10584--><p class="noindent" > + </p><!--l. 9134--><p class="noindent" > on subsequent use. They also set <span class="cmtt-10">\acronymsort{</span>⟨<span class="cmti-10">short</span>⟩<span @@ -21494,19 +19206,21 @@ class="cmtt-10">} </span>is set to just the short form (enclosed in <span class="cmtt-10">\acronymfont</span>) and the <span class="cmtt-10">description</span><a - id="dx1-149027"></a> key is set to the long + id="dx1-138027"></a> key is set to the long form. - </p><!--l. 10592--><p class="noindent" >The <span + </p><!--l. 9142--><p class="noindent" >The <span class="cmss-10">long-sp-short</span><a - id="dx1-149028"></a> style was introduced in version 4.16 and uses - </p><!--l. 10594--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-149029"></a> <span + id="dx1-138028"></a> style was introduced in version 4.16 and uses + </p><!--l. 9144--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-138029"></a> <span class="cmtt-10">\glsacspace{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 10596--><p class="noindent" > + </p><!--l. 9146--><p class="noindent" > for the space between the long and short forms. This defaults to a non-breakable space (<span class="obeylines-h"><span class="verb"><span class="cmtt-10">~</span></span></span>) if + + (<span class="cmtt-10">\acronymfont{</span>⟨<span class="cmti-10">short</span>⟩<span @@ -21515,65 +19229,67 @@ class="cmtt-10">}</span>) is less than 3em, otherwise it uses a normal sp </p> - <div class="verbatim" id="verbatim-313"> + <pre class="verbatim" id="verbatim-236"> \renewcommand*{\glsacspace}[1]{~} -</div> - <!--l. 10604--><p class="nopar" > +</pre> + <!--l. 9154--><p class="nopar" > </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 9156--><p class="noindent" ><span class="cmss-10">short-long</span><a - id="dx1-149030"></a>, <span + id="dx1-138030"></a>, <span class="cmss-10">sc-short-long</span><a - id="dx1-149031"></a>, <span + id="dx1-138031"></a>, <span class="cmss-10">sm-short-long</span><a - id="dx1-149032"></a>: - <!--l. 10609--><p class="noindent" >These three styles are analogous to the above three styles, except the display order is swapped + id="dx1-138032"></a>: + </p><!--l. 9159--><p class="noindent" >These three styles are analogous to the above three styles, except the display order is swapped to - </p><!--l. 10612--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 9162--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\firstacronymfont</span><a - id="dx1-149033"></a><span + id="dx1-138033"></a><span class="cmtt-10">{</span>⟨<span 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. 10613--><p class="noindent" > + </p><!--l. 9163--><p class="noindent" > on first use. - </p><!--l. 10616--><p class="noindent" >Note, however, that <span + </p><!--l. 9166--><p class="noindent" >Note, however, that <span class="cmtt-10">\acronymsort</span><a - id="dx1-149034"></a> and <span + id="dx1-138034"></a> and <span class="cmtt-10">\acronymentry</span><a - id="dx1-149035"></a> are the same as for the ⟨<span + id="dx1-138035"></a> are the same as for the ⟨<span class="cmti-10">long</span>⟩ (⟨<span class="cmti-10">short</span>⟩) styles above, so the acronyms are still sorted according to the short form. </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 9170--><p class="noindent" ><span class="cmss-10">long-short-desc</span><a - id="dx1-149036"></a>, <span + id="dx1-138036"></a>, <span class="cmss-10">long-sc-short-desc</span><a - id="dx1-149037"></a>, <span + id="dx1-138037"></a>, <span class="cmss-10">long-sm-short-desc</span><a - id="dx1-149038"></a>, <span + id="dx1-138038"></a>, <span class="cmss-10">long-sp-short-desc</span><a - id="dx1-149039"></a>: - <!--l. 10623--><p class="noindent" >These are like the <span + id="dx1-138039"></a>: + </p><!--l. 9173--><p class="noindent" >These are like the <span class="cmss-10">long-short</span><a - id="dx1-149040"></a>, <span + id="dx1-138040"></a>, <span class="cmss-10">long-sc-short</span><a - id="dx1-149041"></a>, <span + id="dx1-138041"></a>, <span class="cmss-10">long-sm-short</span><a - id="dx1-149042"></a> and <span + id="dx1-138042"></a> and <span class="cmss-10">long-sp-short</span><a - id="dx1-149043"></a> styles described above, except + id="dx1-138043"></a> styles described above, except that the <span class="cmtt-10">description</span><a - id="dx1-149044"></a> key must be supplied in the optional argument of <span + id="dx1-138044"></a> key must be supplied in the optional argument of <span class="cmtt-10">\newacronym</span><a - id="dx1-149045"></a>. They also redefine + id="dx1-138045"></a>. They also redefine <span class="cmtt-10">\acronymentry</span><a - id="dx1-149046"></a> to <span + id="dx1-138046"></a> to <span class="cmtt-10">{</span>⟨<span class="cmti-10">long</span>⟩<span class="cmtt-10">} </span>(<span @@ -21581,7 +19297,7 @@ class="cmtt-10">\acronymfont{</span>⟨<span class="cmti-10">short</span>⟩<span class="cmtt-10">}</span>) and redefine <span class="cmtt-10">\acronymsort</span><a - id="dx1-149047"></a><span + id="dx1-138047"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">short</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -21592,222 +19308,226 @@ class="cmti-10">long</span>⟩. the name field has the long form followed by the short form in parentheses. I recommend you use a glossary style such as <span class="cmss-10">altlist</span><a - id="dx1-149048"></a> with these acronym styles to allow for the long name + id="dx1-138048"></a> with these acronym styles to allow for the long name field. </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 9185--><p class="noindent" ><span class="cmss-10">short-long-desc</span><a - id="dx1-149049"></a>, <span + id="dx1-138049"></a>, <span class="cmss-10">sc-short-long-desc</span><a - id="dx1-149050"></a>, <span + id="dx1-138050"></a>, <span class="cmss-10">sm-short-long-desc</span><a - id="dx1-149051"></a>: - <!--l. 10638--><p class="noindent" >These styles are analogous to the above three styles, but the first use display style is: - </p><!--l. 10641--><p class="noindent" ><hr><div title="Definition"><span + id="dx1-138051"></a>: + </p><!--l. 9188--><p class="noindent" >These styles are analogous to the above three styles, but the first use display style is: + </p><!--l. 9191--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\firstacronymfont{</span>⟨<span 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. 10642--><p class="noindent" > + </p><!--l. 9192--><p class="noindent" > The definitions of <span class="cmtt-10">\acronymsort </span>and <span class="cmtt-10">\acronymentry </span>are the same as those for <span class="cmss-10">long-short-desc</span><a - id="dx1-149052"></a> + id="dx1-138052"></a> etc. </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 9196--><p class="noindent" ><span class="cmss-10">dua</span><a - id="dx1-149053"></a>, <span + id="dx1-138053"></a>, <span class="cmss-10">dua-desc</span><a - id="dx1-149054"></a>: - <!--l. 10648--><p class="noindent" >With these styles, the <a + id="dx1-138054"></a>: + + + </p><!--l. 9198--><p class="noindent" >With these styles, the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands always display the long form regardless of whether the entry has been used or not. However, <span class="cmtt-10">\acrfull</span><a - id="dx1-149055"></a> and <span + id="dx1-138055"></a> and <span class="cmtt-10">\glsentryfull</span><a - id="dx1-149056"></a> will display ⟨<span + id="dx1-138056"></a> will display ⟨<span class="cmti-10">long</span>⟩ (<span class="cmtt-10">\acronymfont{</span>⟨<span class="cmti-10">short</span>⟩<span class="cmtt-10">}</span>). In the case of <span class="cmss-10">dua</span><a - id="dx1-149057"></a>, the <span + id="dx1-138057"></a>, the <span class="cmtt-10">name</span><a - id="dx1-149058"></a> and <span + id="dx1-138058"></a> and <span class="cmtt-10">sort</span><a - id="dx1-149059"></a> keys are set to the short + id="dx1-138059"></a> keys are set to the short form and the description is set to the long form. In the case of <span class="cmss-10">dua-desc</span><a - id="dx1-149060"></a>, the <span + id="dx1-138060"></a>, the <span class="cmtt-10">name</span><a - id="dx1-149061"></a> and <span + id="dx1-138061"></a> and <span class="cmtt-10">sort</span><a - id="dx1-149062"></a> + id="dx1-138062"></a> keys are set to the long form and the description is supplied in the optional argument of <span class="cmtt-10">\newacronym</span><a - id="dx1-149063"></a>. - - + id="dx1-138063"></a>. </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 9207--><p class="noindent" ><span class="cmss-10">footnote</span><a - id="dx1-149064"></a>, <span + id="dx1-138064"></a>, <span class="cmss-10">footnote-sc</span><a - id="dx1-149065"></a>, <span + id="dx1-138065"></a>, <span class="cmss-10">footnote-sm</span><a - id="dx1-149066"></a>: - <!--l. 10660--><p class="noindent" >With these three styles, on first use the <a + id="dx1-138066"></a>: + </p><!--l. 9210--><p class="noindent" >With these three styles, on first use the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands display: - </p><!--l. 10662--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 9212--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\firstacronymfont{</span>⟨<span class="cmitt-10">short</span>⟩<span class="cmtt-10">}\footnote</span><a - id="dx1-149067"></a><span + id="dx1-138067"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">long</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 10663--><p class="noindent" > + </p><!--l. 9213--><p class="noindent" > However, <span class="cmtt-10">\acrfull</span><a - id="dx1-149068"></a> and <span + id="dx1-138068"></a> and <span class="cmtt-10">\glsentryfull</span><a - id="dx1-149069"></a> are set to <span + id="dx1-138069"></a> are set to <span class="cmtt-10">\acronymfont{</span>⟨<span class="cmti-10">short</span>⟩<span class="cmtt-10">} </span>(⟨<span class="cmti-10">long</span>⟩). On subsequent use the display is: - </p><!--l. 10667--><p class="noindent" ><hr><div title="Definition"><span + </p><!--l. 9217--><p class="noindent" ><hr><div title="Definition"><span class="cmtt-10">\acronymfont{</span>⟨<span class="cmitt-10">short</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 10668--><p class="noindent" > + </p><!--l. 9218--><p class="noindent" > The <span class="cmtt-10">sort</span><a - id="dx1-149070"></a> and <span + id="dx1-138070"></a> and <span class="cmtt-10">name</span><a - id="dx1-149071"></a> keys are set to the short form, and the <span + id="dx1-138071"></a> keys are set to the short form, and the <span class="cmtt-10">description</span><a - id="dx1-149072"></a> is set to the long + id="dx1-138072"></a> is set to the long form. - </p><!--l. 10673--><p class="noindent" ><div class="important" title="Important Note"> In order to avoid nested hyperlinks on <a + </p><!--l. 9223--><p class="noindent" ><div class="important" title="Important Note"> In order to avoid nested hyperlinks on <a href="#glo:firstuse">first use</a> the footnote styles automatically implement <span class="cmss-10">hyperfirst</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-149073"></a> for the acronym lists. </div> - </p><!--l. 10677--><p class="noindent" > + id="dx1-138073"></a> for the acronym lists. </div> + </p><!--l. 9227--><p class="noindent" > </p></li> - <li class="itemize"><span + <li class="itemize"> + <!--l. 9229--><p class="noindent" ><span class="cmss-10">footnote-desc</span><a - id="dx1-149074"></a>, <span + id="dx1-138074"></a>, <span class="cmss-10">footnote-sc-desc</span><a - id="dx1-149075"></a>, <span + id="dx1-138075"></a>, <span class="cmss-10">footnote-sm-desc</span><a - id="dx1-149076"></a>: - <!--l. 10682--><p class="noindent" >These three styles are similar to the previous three styles, but the description has to be supplied in the + id="dx1-138076"></a>: + </p><!--l. 9232--><p class="noindent" >These three styles are similar to the previous three styles, but the description has to be supplied in the optional argument of <span class="cmtt-10">\newacronym</span><a - id="dx1-149077"></a>. The <span + id="dx1-138077"></a>. The <span class="cmtt-10">name</span><a - id="dx1-149078"></a> key is set to the long form followed by the short form in + id="dx1-138078"></a> key is set to the long form followed by the short form in parentheses and the <span class="cmtt-10">sort</span><a - id="dx1-149079"></a> key is set to the long form. This means that the acronyms will be sorted + id="dx1-138079"></a> key is set to the long form. This means that the acronyms will be sorted according to the long form. In addition, since the <span class="cmtt-10">name</span><a - id="dx1-149080"></a> will typically be quite wide it’s best to choose a + id="dx1-138080"></a> will typically be quite wide it’s best to choose a glossary style that can accommodate this, such as <span class="cmss-10">altlist</span><a - id="dx1-149081"></a>. + id="dx1-138081"></a>. </p> </li></ul> <a id="ex:acrstyle"></a> -<!--l. 10693--><p class="noindent" ><span -class="cmbx-12">Example 22</span><span +<!--l. 9243--><p class="noindent" ><span +class="cmbx-12">Example 15</span><span class="cmbx-12"> (Adapting a Predefined Acronym Style)</span><a - id="x1-149083"></a> -</p><!--l. 10694--><p class="indent" > Suppose I want to use the <span + id="x1-138083"></a> +</p><!--l. 9244--><p class="indent" > Suppose I want to use the <span class="cmss-10">footnote-sc-desc</span><a - id="dx1-149084"></a> style, but I want the <span + id="dx1-138084"></a> style, but I want the <span class="cmtt-10">name</span><a - id="dx1-149085"></a> key set to the short form followed by + id="dx1-138085"></a> key set to the short form followed by the long form in parentheses and the <span class="cmtt-10">sort</span><a - id="dx1-149086"></a> key set to the short form. Then I need to specify the <span + id="dx1-138086"></a> key set to the short form. Then I need to specify the <span class="cmss-10">footnote-sc-desc</span><a - id="dx1-149087"></a> + id="dx1-138087"></a> style: </p> - <div class="verbatim" id="verbatim-314"> + <pre class="verbatim" id="verbatim-237"> \setacronymstyle{footnote-sc-desc} -</div> -<!--l. 10700--><p class="nopar" > and then redefine <span +</pre> +<!--l. 9250--><p class="nopar" > and then redefine <span class="cmtt-10">\acronymsort</span><a - id="dx1-149088"></a> and <span + id="dx1-138088"></a> and <span class="cmtt-10">\acronymentry</span><a - id="dx1-149089"></a>: + id="dx1-138089"></a>: </p> - <div class="verbatim" id="verbatim-315"> + <pre class="verbatim" id="verbatim-238"> \renewcommand*{\acronymsort}[2]{#1}% sort by short form - <br />\renewcommand*{\acronymentry}[1]{% - <br />  \acronymfont{\glsentryshort{#1}}\space (\glsentrylong{#1})}% -</div> -<!--l. 10706--><p class="nopar" > (I’ve used <span +\renewcommand*{\acronymentry}[1]{% +  \acronymfont{\glsentryshort{#1}}\space (\glsentrylong{#1})}% +</pre> +<!--l. 9256--><p class="nopar" > (I’ve used <span class="cmtt-10">\space </span>for extra clarity, but you can just use an actual space instead.) -</p><!--l. 10710--><p class="indent" > Note that the default Computer Modern fonts don’t support bold <a +</p><!--l. 9260--><p class="indent" > Note that the default Computer Modern fonts don’t support bold <a href="#glo:smallcaps">small caps<a - id="dx1-149090"></a></a>, so another font is required. For + id="dx1-138090"></a></a>, so another font is required. For example: </p> - <div class="verbatim" id="verbatim-316"> + <pre class="verbatim" id="verbatim-239"> \usepackage[T1]{fontenc} -</div> -<!--l. 10714--><p class="nopar" > The alternative is to redefine <span +</pre> +<!--l. 9264--><p class="nopar" > The alternative is to redefine <span class="cmtt-10">\acronymfont</span><a - id="dx1-149091"></a> so that it always switches to medium weight to ensure the <a + id="dx1-138091"></a> so that it always switches to medium weight to ensure the <a href="#glo:smallcaps">small caps<a - id="dx1-149092"></a></a> setting is used. For example: + id="dx1-138092"></a></a> setting is used. For example: </p> - <div class="verbatim" id="verbatim-317"> + <pre class="verbatim" id="verbatim-240"> \renewcommand*{\acronymfont}[1]{\textmd{\scshape #1}} -</div> -<!--l. 10720--><p class="nopar" > -</p><!--l. 10722--><p class="indent" > The sample file <a +</pre> +<!--l. 9270--><p class="nopar" > +</p><!--l. 9272--><p class="indent" > The sample file <a href="#ex:sampleFnAcrDesc"><span class="cmtt-10">sampleFnAcrDesc.tex</span></a> illustrates this example. </p> <div class="center" > -<!--l. 10724--><p class="noindent" > -</p><!--l. 10724--><p class="noindent" >____________________________</p></div> -<!--l. 10726--><p class="noindent" > +<!--l. 9274--><p class="noindent" > +</p><!--l. 9274--><p class="noindent" >____________________________</p></div> +<!--l. 9276--><p class="noindent" > </p> -<!--l. 10726--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.2 </span> <a +<!--l. 9276--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">6.2.2 </span> <a id="sec:customacronym"></a>Defining A Custom Acronym Style</h4> -<!--l. 10729--><p class="noindent" >You may find that the predefined acronyms styles that come with the <span +<!--l. 9279--><p class="noindent" >You may find that the predefined acronyms styles that come with the <span class="cmss-10">glossaries </span>package don’t suit your requirements. In this case you can define your own style using: -</p><!--l. 10732--><p class="indent" > <hr><div title="Definition"><a - id="dx1-150001"></a> <span +</p><!--l. 9282--><p class="indent" > <hr><div title="Definition"><a + id="dx1-139001"></a> <span class="cmtt-10">\newacronymstyle{</span>⟨<span class="cmitt-10">style name</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -21815,148 +19535,149 @@ class="cmitt-10">display</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">definitions</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10734--><p class="noindent" > +</p><!--l. 9284--><p class="noindent" > where ⟨<span class="cmti-10">style name</span>⟩ is the name of the new style (avoid active characters). The second argument, ⟨<span class="cmti-10">display</span>⟩, is equivalent to the mandatory argument of <span class="cmtt-10">\defglsentryfmt</span><a - id="dx1-150002"></a>. You can simply use <span + id="dx1-139002"></a>. You can simply use <span class="cmtt-10">\glsgenacfmt</span><a - id="dx1-150003"></a> or you can + id="dx1-139003"></a> or you can customize the display using commands like <span class="cmtt-10">\ifglsused</span><a - id="dx1-150004"></a>, <span + id="dx1-139004"></a>, <span class="cmtt-10">\glsifplural</span><a - id="dx1-150005"></a> and <span + id="dx1-139005"></a> and <span class="cmtt-10">\glscapscase</span><a - id="dx1-150006"></a>. (See <a -href="#sec:glsdisplay">§6.3 </a><a -href="#sec:glsdisplay">Changing -the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a> for further details.) If the style is likely to be used with a mixed glossary (that is -entries in that glossary are defined both with <span + id="dx1-139006"></a>. (See +<a +href="#sec:glsdisplay">§<span +class="cmbx-10">??</span>sec:glsdisplay </a><a +href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a> for further details.) If the style is likely to be used with a +mixed glossary (that is entries in that glossary are defined both with <span class="cmtt-10">\newacronym</span><a - id="dx1-150007"></a> and <span + id="dx1-139007"></a> and <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-150008"></a>) then you can test if the -entry is an acronym and use <span + id="dx1-139008"></a>) +then you can test if the entry is an acronym and use <span class="cmtt-10">\glsgenacfmt</span><a - id="dx1-150009"></a> if it is or <span + id="dx1-139009"></a> if it is or <span class="cmtt-10">\glsgenentryfmt</span><a - id="dx1-150010"></a> if it isn’t. For example, the <span + id="dx1-139010"></a> if it isn’t. For +example, the <span class="cmss-10">long-short</span><a - id="dx1-150011"></a> -style sets ⟨<span + id="dx1-139011"></a> style sets ⟨<span class="cmti-10">display</span>⟩ as </p> - <div class="verbatim" id="verbatim-318"> + <pre class="verbatim" id="verbatim-241"> \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% -</div> -<!--l. 10749--><p class="nopar" > (You can use <span +</pre> +<!--l. 9299--><p class="nopar" > (You can use <span class="cmtt-10">\ifglshasshort</span><a - id="dx1-150012"></a> instead of <span + id="dx1-139012"></a> instead of <span class="cmtt-10">\ifglshaslong</span><a - id="dx1-150013"></a> to test if the entry is an acronym if you + id="dx1-139013"></a> to test if the entry is an acronym if you prefer.) -</p><!--l. 10753--><p class="indent" > The third argument, ⟨<span +</p><!--l. 9303--><p class="indent" > The third argument, ⟨<span class="cmti-10">definitions</span>⟩, can be used to redefine the commands that affect the display style, such as <span class="cmtt-10">\acronymfont</span><a - id="dx1-150014"></a> or, if ⟨<span + id="dx1-139014"></a> or, if ⟨<span class="cmti-10">display</span>⟩ uses <span class="cmtt-10">\glsgenacfmt</span>, <span class="cmtt-10">\genacrfullformat</span><a - id="dx1-150015"></a> and its variants. -</p><!--l. 10758--><p class="indent" > Note that <span + id="dx1-139015"></a> and its variants. +</p><!--l. 9308--><p class="indent" > Note that <span class="cmtt-10">\setacronymstyle</span><a - id="dx1-150016"></a> redefines <span + id="dx1-139016"></a> redefines <span class="cmtt-10">\glsentryfull</span><a - id="dx1-150017"></a> and <span + id="dx1-139017"></a> and <span class="cmtt-10">\acrfullfmt</span><a - id="dx1-150018"></a> to use <span + id="dx1-139018"></a> to use <span class="cmtt-10">\genacrfullformat</span><a - id="dx1-150019"></a> (and + id="dx1-139019"></a> (and similarly for the plural and upper case variants). If this isn’t appropriate for the style (as in the case of styles like <span class="cmss-10">footnote</span><a - id="dx1-150020"></a> and <span + id="dx1-139020"></a> and <span class="cmss-10">dua</span><a - id="dx1-150021"></a>) <span + id="dx1-139021"></a>) <span class="cmtt-10">\newacronymstyle </span>should redefine these commands within ⟨<span class="cmti-10">definitions</span>⟩. -</p><!--l. 10766--><p class="indent" > Within <span +</p><!--l. 9316--><p class="indent" > Within <span class="cmtt-10">\newacronymstyle</span>’s ⟨<span class="cmti-10">definitions</span>⟩ argument you can also redefine -</p><!--l. 10768--><p class="indent" > <hr><div title="Definition"><a - id="dx1-150022"></a> <span +</p><!--l. 9318--><p class="indent" > <hr><div title="Definition"><a + id="dx1-139022"></a> <span class="cmtt-10">\GenericAcronymFields </span></div><hr> -</p><!--l. 10770--><p class="noindent" > +</p><!--l. 9320--><p class="noindent" > This is a list of additional fields to be set in <span class="cmtt-10">\newacronym</span><a - id="dx1-150023"></a>. You can use the following token registers to access + id="dx1-139023"></a>. You can use the following token registers to access the entry label, long form and short form: <a - id="dx1-150024"></a><span + id="dx1-139024"></a><span class="cmtt-10">\glslabeltok</span>, <a - id="dx1-150025"></a><span + id="dx1-139025"></a><span class="cmtt-10">\glslongtok </span>and <a - id="dx1-150026"></a><span + id="dx1-139026"></a><span class="cmtt-10">\glsshorttok</span>. As with all 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 + id="dx1-139027"></a>. For example, the <span class="cmss-10">long-short</span><a - id="dx1-150028"></a> style + id="dx1-139028"></a> style does: </p> - <div class="verbatim" id="verbatim-319"> + <pre class="verbatim" id="verbatim-242"> \renewcommand*{\GenericAcronymFields}{% - <br />   description={\the\glslongtok}}% -</div> -<!--l. 10781--><p class="nopar" > which sets the <span +   description={\the\glslongtok}}% +</pre> +<!--l. 9331--><p class="nopar" > which sets the <span class="cmtt-10">description</span><a - id="dx1-150029"></a> field to the long form of the acronym whereas the <span + id="dx1-139029"></a> field to the long form of the acronym whereas the <span class="cmss-10">long-short-desc</span><a - id="dx1-150030"></a> style + id="dx1-139030"></a> style does: </p> - <div class="verbatim" id="verbatim-320"> + <pre class="verbatim" id="verbatim-243"> \renewcommand*{\GenericAcronymFields}{}% -</div> -<!--l. 10786--><p class="nopar" > since the description needs to be specified by the user. -</p><!--l. 10789--><p class="indent" > It may be that you want to define a new acronym style that’s based on an existing style. Within ⟨<span +</pre> +<!--l. 9336--><p class="nopar" > since the description needs to be specified by the user. +</p><!--l. 9339--><p class="indent" > It may be that you want to define a new acronym style that’s based on an existing style. Within ⟨<span class="cmti-10">display</span>⟩ you can use -</p><!--l. 10791--><p class="indent" > <hr><div title="Definition"><a - id="dx1-150031"></a> <span +</p><!--l. 9341--><p class="indent" > <hr><div title="Definition"><a + id="dx1-139031"></a> <span class="cmtt-10">\GlsUseAcrEntryDispStyle{</span>⟨<span class="cmitt-10">style name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10793--><p class="noindent" > +</p><!--l. 9343--><p class="noindent" > to use the ⟨<span class="cmti-10">display</span>⟩ definition from the style given by ⟨<span class="cmti-10">style name</span>⟩. Within ⟨<span class="cmti-10">definitions</span>⟩ you can use -</p><!--l. 10796--><p class="indent" > <hr><div title="Definition"><a - id="dx1-150032"></a> <span +</p><!--l. 9346--><p class="indent" > <hr><div title="Definition"><a + id="dx1-139032"></a> <span class="cmtt-10">\GlsUseAcrStyleDefs{</span>⟨<span class="cmitt-10">style name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 10798--><p class="noindent" > +</p><!--l. 9348--><p class="noindent" > to use the ⟨<span class="cmti-10">definitions</span>⟩ from the style given by ⟨<span class="cmti-10">style name</span>⟩. For example, the <span class="cmss-10">long-sc-short</span><a - id="dx1-150033"></a> acronym style is + id="dx1-139033"></a> acronym style is based on the <span class="cmss-10">long-short</span><a - id="dx1-150034"></a> style with minor modifications (remember to use <span class="obeylines-h"><span class="verb"><span + id="dx1-139034"></a> style with minor modifications (remember to use <span class="obeylines-h"><span class="verb"><span class="cmtt-10">##</span></span></span> instead of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">#</span></span></span> within ⟨<span @@ -21964,27 +19685,27 @@ class="cmti-10">definitions</span>⟩): </p> - <div class="verbatim" id="verbatim-321"> + <pre class="verbatim" id="verbatim-244"> \newacronymstyle{long-sc-short}% - <br />{% use the same display as "long-short" - <br />  \GlsUseAcrEntryDispStyle{long-short}% - <br />}% - <br />{% use the same definitions as "long-short" - <br />  \GlsUseAcrStyleDefs{long-short}% - <br />  % Minor modifications: - <br />  \renewcommand{\acronymfont}[1]{\textsc{##1}}% - <br />  \renewcommand*{\acrpluralsuffix}{\glstextup{\glspluralsuffix}}% - <br />} -</div> -<!--l. 10815--><p class="nopar" > (<a - id="dx1-150035"></a><span +{% use the same display as "long-short" +  \GlsUseAcrEntryDispStyle{long-short}% +}% +{% use the same definitions as "long-short" +  \GlsUseAcrStyleDefs{long-short}% +  % Minor modifications: +  \renewcommand{\acronymfont}[1]{\textsc{##1}}% +  \renewcommand*{\acrpluralsuffix}{\glstextup{\glspluralsuffix}}% +} +</pre> +<!--l. 9365--><p class="nopar" > (<a + id="dx1-139035"></a><span class="cmtt-10">\glstextup </span>is used to cancel the effect of <span class="cmtt-10">\textsc</span><a - id="dx1-150036"></a>. This defaults to <span + id="dx1-139036"></a>. This defaults to <span class="cmtt-10">\textulc</span><a - id="dx1-150037"></a>, if defined, otherwise <span + id="dx1-139037"></a>, if defined, otherwise <span class="cmtt-10">\textup</span><a - id="dx1-150038"></a>. + id="dx1-139038"></a>. For example, the plural of <span class="cmcsc-10"><span class="small-caps">s</span><span @@ -22001,22 +19722,22 @@ class="small-caps">m</span><span class="small-caps">s</span></span>.) <a id="ex:customacrstyle"></a> -</p><!--l. 10821--><p class="noindent" ><span -class="cmbx-12">Example 23</span><span +</p><!--l. 9371--><p class="noindent" ><span +class="cmbx-12">Example 16</span><span class="cmbx-12"> (Defining a Custom Acronym Style)</span><a - id="x1-150040"></a> -</p><!--l. 10822--><p class="indent" > Suppose I want my acronym on <a + id="x1-139040"></a> +</p><!--l. 9372--><p class="indent" > Suppose I want my acronym on <a href="#glo:firstuse">first use</a> to have the short form in the text and the long form with the description in a footnote. Suppose also that I want the short form to be put in small caps in the main body of the document, but I want it in normal capitals in the list of acronyms. In my list of acronyms, I want the long form as the name with the short form in brackets followed by the description. That is, in the text I want <span class="cmtt-10">\gls</span><a - id="dx1-150041"></a> + id="dx1-139041"></a> on <a href="#glo:firstuse">first use</a> to display: <spacer type=vertical size=10><span class="obeylines-h"> <br /><span class="cmtt-10">\textsc</span><a - id="dx1-150042"></a><span + id="dx1-139042"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">abbrv</span>⟩<span class="cmtt-10">}\footnote</span><span class="verb"><span @@ -22028,7 +19749,7 @@ class="cmtt-10">}</span></span> on subsequent use: <spacer type=vertical size=10><span class="obeylines-h"> <br /><span class="cmtt-10">\textsc</span><a - id="dx1-150043"></a><span + id="dx1-139043"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">abbrv</span>⟩<span class="cmtt-10">}</span> @@ -22039,27 +19760,27 @@ class="cmti-10">long</span>⟩ (⟨<span class="cmti-10">short</span>⟩) ⟨<span class="cmti-10">description</span>⟩ <br /><spacer type=vertical size=10></span> -</p><!--l. 10843--><p class="indent" > Let’s suppose it’s possible that I may have a mixed glossary. I can check this in the second argument of +</p><!--l. 9393--><p class="indent" > Let’s suppose it’s possible that I may have a mixed glossary. I can check this in the second argument of <span class="cmtt-10">\newacronymstyle</span><a - id="dx1-150044"></a> using: + id="dx1-139044"></a> using: </p> - <div class="verbatim" id="verbatim-322"> + <pre class="verbatim" id="verbatim-245"> \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% -</div> -<!--l. 10847--><p class="nopar" > This will use <span +</pre> +<!--l. 9397--><p class="nopar" > This will use <span class="cmtt-10">\glsgenentryfmt</span><a - id="dx1-150045"></a> if the entry isn’t an acronym, otherwise it will use <span + id="dx1-139045"></a> if the entry isn’t an acronym, otherwise it will use <span class="cmtt-10">\glsgenacfmt</span><a - id="dx1-150046"></a>. The third + id="dx1-139046"></a>. The third argument (⟨<span class="cmti-10">definitions</span>⟩) of <span class="cmtt-10">\newacronymstyle</span><a - id="dx1-150047"></a> needs to redefine <span + id="dx1-139047"></a> needs to redefine <span class="cmtt-10">\genacrfullformat</span><a - id="dx1-150048"></a> etc so that the <a + id="dx1-139048"></a> etc so that the <a href="#glo:firstuse">first use</a> displays the short form in the text with the long form in a footnote followed by the description. This is done as follows (remember to use <span class="obeylines-h"><span class="verb"><span @@ -22068,388 +19789,388 @@ class="cmtt-10">#</span></span></span>): </p> - <div class="verbatim" id="verbatim-323"> + <pre class="verbatim" id="verbatim-246">  % No case change, singular first use: - <br />  \renewcommand*{\genacrfullformat}[2]{% - <br />   \firstacronymfont{\glsentryshort{##1}}##2% - <br />   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% - <br />  }% - <br /> % First letter upper case, singular first use: - <br />  \renewcommand*{\Genacrfullformat}[2]{% - <br />   \firstacronymfont{\Glsentryshort{##1}}##2% - <br />   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% - <br />  }% - <br /> % No case change, plural first use: - <br />  \renewcommand*{\genplacrfullformat}[2]{% - <br />   \firstacronymfont{\glsentryshortpl{##1}}##2% - <br />   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% - <br />  }% - <br /> % First letter upper case, plural first use: - <br />  \renewcommand*{\Genplacrfullformat}[2]{% - <br />   \firstacronymfont{\Glsentryshortpl{##1}}##2% - <br />   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% - <br />  }% -</div> -<!--l. 10876--><p class="nopar" > If you think it inappropriate for the short form to be capitalised at the start of a sentence you can change the +  \renewcommand*{\genacrfullformat}[2]{% +   \firstacronymfont{\glsentryshort{##1}}##2% +   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% +  }% + % First letter upper case, singular first use: +  \renewcommand*{\Genacrfullformat}[2]{% +   \firstacronymfont{\Glsentryshort{##1}}##2% +   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% +  }% + % No case change, plural first use: +  \renewcommand*{\genplacrfullformat}[2]{% +   \firstacronymfont{\glsentryshortpl{##1}}##2% +   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% +  }% + % First letter upper case, plural first use: +  \renewcommand*{\Genplacrfullformat}[2]{% +   \firstacronymfont{\Glsentryshortpl{##1}}##2% +   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% +  }% +</pre> +<!--l. 9426--><p class="nopar" > If you think it inappropriate for the short form to be capitalised at the start of a sentence you can change the above to: </p> - <div class="verbatim" id="verbatim-324"> + <pre class="verbatim" id="verbatim-247">  % No case change, singular first use: - <br />  \renewcommand*{\genacrfullformat}[2]{% - <br />   \firstacronymfont{\glsentryshort{##1}}##2% - <br />   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% - <br />  }% - <br /> % No case change, plural first use: - <br />  \renewcommand*{\genplacrfullformat}[2]{% - <br />   \firstacronymfont{\glsentryshortpl{##1}}##2% - <br />   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% - <br />  }% - <br /> \let\Genacrfullformat\genacrfullformat - <br /> \let\Genplacrfullformat\genplacrfullformat -</div> -<!--l. 10892--><p class="nopar" > Another variation is to use <span +  \renewcommand*{\genacrfullformat}[2]{% +   \firstacronymfont{\glsentryshort{##1}}##2% +   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% +  }% + % No case change, plural first use: +  \renewcommand*{\genplacrfullformat}[2]{% +   \firstacronymfont{\glsentryshortpl{##1}}##2% +   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% +  }% + \let\Genacrfullformat\genacrfullformat + \let\Genplacrfullformat\genplacrfullformat +</pre> +<!--l. 9442--><p class="nopar" > Another variation is to use <span class="cmtt-10">\Glsentrylong</span><a - id="dx1-150049"></a> and <span + id="dx1-139049"></a> and <span class="cmtt-10">\Glsentrylongpl</span><a - id="dx1-150050"></a> in the footnote instead of <span + id="dx1-139050"></a> in the footnote instead of <span class="cmtt-10">\glsentrylong</span><a - id="dx1-150051"></a> + id="dx1-139051"></a> and <span class="cmtt-10">\glsentrylongpl</span><a - id="dx1-150052"></a>. -</p><!--l. 10897--><p class="indent" > Now let’s suppose that commands such as <span + id="dx1-139052"></a>. +</p><!--l. 9447--><p class="indent" > Now let’s suppose that commands such as <span class="cmtt-10">\glsentryfull</span><a - id="dx1-150053"></a> and <span + id="dx1-139053"></a> and <span class="cmtt-10">\acrfull</span><a - id="dx1-150054"></a> shouldn’t use a footnote, but + id="dx1-139054"></a> shouldn’t use a footnote, but instead use the format: ⟨<span class="cmti-10">long</span>⟩ (⟨<span class="cmti-10">short</span>⟩). This means that the style needs to redefine <span class="cmtt-10">\glsentryfull</span>, <span class="cmtt-10">\acrfullfmt</span><a - id="dx1-150055"></a> + id="dx1-139055"></a> and their plural and upper case variants. -</p><!--l. 10904--><p class="indent" > First, the non-linking commands: +</p><!--l. 9454--><p class="indent" > First, the non-linking commands: </p> - <div class="verbatim" id="verbatim-325"> + <pre class="verbatim" id="verbatim-248">   \renewcommand*{\glsentryfull}[1]{% - <br />    \glsentrylong{##1}\space - <br />      (\acronymfont{\glsentryshort{##1}})% - <br />  }% - <br />  \renewcommand*{\Glsentryfull}[1]{% - <br />    \Glsentrylong{##1}\space - <br />      (\acronymfont{\glsentryshort{##1}})% - <br />  }% - <br />  \renewcommand*{\glsentryfullpl}[1]{% - <br />    \glsentrylongpl{##1}\space - <br />      (\acronymfont{\glsentryshortpl{##1}})% - <br />  }% - <br />  \renewcommand*{\Glsentryfullpl}[1]{% - <br />    \Glsentrylongpl{##1}\space - <br />      (\acronymfont{\glsentryshortpl{##1}})% - <br />  }% -</div> -<!--l. 10922--><p class="nopar" > Now for the linking commands: - - -</p> - <div class="verbatim" id="verbatim-326"> +    \glsentrylong{##1}\space +      (\acronymfont{\glsentryshort{##1}})% +  }% +  \renewcommand*{\Glsentryfull}[1]{% +    \Glsentrylong{##1}\space +      (\acronymfont{\glsentryshort{##1}})% +  }% +  \renewcommand*{\glsentryfullpl}[1]{% +    \glsentrylongpl{##1}\space +      (\acronymfont{\glsentryshortpl{##1}})% +  }% +  \renewcommand*{\Glsentryfullpl}[1]{% +    \Glsentrylongpl{##1}\space +      (\acronymfont{\glsentryshortpl{##1}})% +  }% +</pre> +<!--l. 9472--><p class="nopar" > Now for the linking commands: + + +</p> + <pre class="verbatim" id="verbatim-249">   \renewcommand*{\acrfullfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \glsentrylong{##2}##3\space - <br />      (\acronymfont{\glsentryshort{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\Acrfullfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \Glsentrylong{##2}##3\space - <br />      (\acronymfont{\glsentryshort{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\ACRfullfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \MakeTextUppercase{% - <br />       \glsentrylong{##2}##3\space - <br />         (\acronymfont{\glsentryshort{##2}})% - <br />     }% - <br />    }% - <br />  }% - <br />  \renewcommand*{\acrfullplfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \glsentrylongpl{##2}##3\space - <br />       (\acronymfont{\glsentryshortpl{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\Acrfullplfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \Glsentrylongpl{##2}##3\space - <br />       (\acronymfont{\glsentryshortpl{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\ACRfullplfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \MakeTextUppercase{% - <br />       \glsentrylongpl{##2}##3\space - <br />         (\acronymfont{\glsentryshortpl{##2}})% - <br />     }% - <br />    }% - <br />  }% -</div> -<!--l. 10965--><p class="nopar" > (This may cause problems with long hyperlinks, in which case adjust the definitions so that, for example, only +    \glslink[##1]{##2}{% +     \glsentrylong{##2}##3\space +      (\acronymfont{\glsentryshort{##2}})% +    }% +  }% +  \renewcommand*{\Acrfullfmt}[3]{% +    \glslink[##1]{##2}{% +     \Glsentrylong{##2}##3\space +      (\acronymfont{\glsentryshort{##2}})% +    }% +  }% +  \renewcommand*{\ACRfullfmt}[3]{% +    \glslink[##1]{##2}{% +     \MakeTextUppercase{% +       \glsentrylong{##2}##3\space +         (\acronymfont{\glsentryshort{##2}})% +     }% +    }% +  }% +  \renewcommand*{\acrfullplfmt}[3]{% +    \glslink[##1]{##2}{% +     \glsentrylongpl{##2}##3\space +       (\acronymfont{\glsentryshortpl{##2}})% +    }% +  }% +  \renewcommand*{\Acrfullplfmt}[3]{% +    \glslink[##1]{##2}{% +     \Glsentrylongpl{##2}##3\space +       (\acronymfont{\glsentryshortpl{##2}})% +    }% +  }% +  \renewcommand*{\ACRfullplfmt}[3]{% +    \glslink[##1]{##2}{% +     \MakeTextUppercase{% +       \glsentrylongpl{##2}##3\space +         (\acronymfont{\glsentryshortpl{##2}})% +     }% +    }% +  }% +</pre> +<!--l. 9515--><p class="nopar" > (This may cause problems with long hyperlinks, in which case adjust the definitions so that, for example, only the short form is inside the argument of <span class="cmtt-10">\glslink</span><a - id="dx1-150056"></a>.) -</p><!--l. 10970--><p class="indent" > The style also needs to redefine <span + id="dx1-139056"></a>.) +</p><!--l. 9520--><p class="indent" > The style also needs to redefine <span class="cmtt-10">\acronymsort</span><a - id="dx1-150057"></a> so that the acronyms are sorted according to the long + id="dx1-139057"></a> so that the acronyms are sorted according to the long form: </p> - <div class="verbatim" id="verbatim-327"> + <pre class="verbatim" id="verbatim-250">   \renewcommand*{\acronymsort}[2]{##2}% -</div> -<!--l. 10974--><p class="nopar" > If you prefer them to be sorted according to the short form you can change the above to: +</pre> +<!--l. 9524--><p class="nopar" > If you prefer them to be sorted according to the short form you can change the above to: </p> - <div class="verbatim" id="verbatim-328"> + <pre class="verbatim" id="verbatim-251">   \renewcommand*{\acronymsort}[2]{##1}% -</div> -<!--l. 10979--><p class="nopar" > The acronym font needs to be set to <span +</pre> +<!--l. 9529--><p class="nopar" > The acronym font needs to be set to <span class="cmtt-10">\textsc</span><a - id="dx1-150058"></a> and the plural suffix adjusted so that the “s” suffix in the plural + id="dx1-139058"></a> and the plural suffix adjusted so that the “s” suffix in the plural short form doesn’t get converted to <a href="#glo:smallcaps">small caps<a - id="dx1-150059"></a></a>: + id="dx1-139059"></a></a>: </p> - <div class="verbatim" id="verbatim-329"> + <pre class="verbatim" id="verbatim-252">   \renewcommand*{\acronymfont}[1]{\textsc{##1}}% - <br />  \renewcommand*{\acrpluralsuffix}{\glstextup{\glspluralsuffix}}% -</div> -<!--l. 10986--><p class="nopar" > There are a number of ways of dealing with the format in the list of acronyms. The simplest way is to redefine +  \renewcommand*{\acrpluralsuffix}{\glstextup{\glspluralsuffix}}% +</pre> +<!--l. 9536--><p class="nopar" > There are a number of ways of dealing with the format in the list of acronyms. The simplest way is to redefine <span class="cmtt-10">\acronymentry</span><a - id="dx1-150060"></a> to the long form followed by the upper case short form in parentheses: + id="dx1-139060"></a> to the long form followed by the upper case short form in parentheses: </p> - <div class="verbatim" id="verbatim-330"> + <pre class="verbatim" id="verbatim-253">  \renewcommand*{\acronymentry}[1]{% - <br />   \Glsentrylong{##1}\space - <br />     (\MakeTextUppercase{\glsentryshort{##1}})}% -</div> -<!--l. 10994--><p class="nopar" > (I’ve used <span +   \Glsentrylong{##1}\space +     (\MakeTextUppercase{\glsentryshort{##1}})}% +</pre> +<!--l. 9544--><p class="nopar" > (I’ve used <span class="cmtt-10">\Glsentrylong</span><a - id="dx1-150061"></a> instead of <span + id="dx1-139061"></a> instead of <span class="cmtt-10">\glsentrylong</span><a - id="dx1-150062"></a> to capitalise the name in the glossary.) -</p><!--l. 10998--><p class="indent" > An alternative approach is to set <span + id="dx1-139062"></a> to capitalise the name in the glossary.) +</p><!--l. 9548--><p class="indent" > An alternative approach is to set <span class="cmtt-10">\acronymentry</span><a - id="dx1-150063"></a> to just the long form and redefine <span + id="dx1-139063"></a> to just the long form and redefine <span class="cmtt-10">\GenericAcronymFields</span><a - id="dx1-150064"></a> to + id="dx1-139064"></a> to set the <span class="cmtt-10">symbol</span><a - id="dx1-150065"></a> key to the short form and use a glossary style that displays the symbol in parentheses after the + id="dx1-139065"></a> key to the short form and use a glossary style that displays the symbol in parentheses after the <span class="cmtt-10">name</span><a - id="dx1-150066"></a> (such as the <span + id="dx1-139066"></a> (such as the <span class="cmss-10">tree</span><a - id="dx1-150067"></a> style) like this: + id="dx1-139067"></a> style) like this: </p> - <div class="verbatim" id="verbatim-331"> + <pre class="verbatim" id="verbatim-254">  \renewcommand*{\acronymentry}[1]{\Glsentrylong{##1}}% - <br /> \renewcommand*{\GenericAcronymFields}{% - <br />    symbol={\protect\MakeTextUppercase{\the\glsshorttok}}}% -</div> -<!--l. 11007--><p class="nopar" > I’m going to use the first approach and set <span + \renewcommand*{\GenericAcronymFields}{% +    symbol={\protect\MakeTextUppercase{\the\glsshorttok}}}% +</pre> +<!--l. 9557--><p class="nopar" > I’m going to use the first approach and set <span class="cmtt-10">\GenericAcronymFields</span><a - id="dx1-150068"></a> to do nothing: + id="dx1-139068"></a> to do nothing: </p> - <div class="verbatim" id="verbatim-332"> + <pre class="verbatim" id="verbatim-255">  \renewcommand*{\GenericAcronymFields}{}% -</div> -<!--l. 11012--><p class="nopar" > -</p><!--l. 11014--><p class="indent" > Finally, this style needs to switch off hyperlinks on first use to avoid nested links: +</pre> +<!--l. 9562--><p class="nopar" > +</p><!--l. 9564--><p class="indent" > Finally, this style needs to switch off hyperlinks on first use to avoid nested links: </p> - <div class="verbatim" id="verbatim-333"> + <pre class="verbatim" id="verbatim-256">  \glshyperfirstfalse -</div> -<!--l. 11018--><p class="nopar" > Putting this all together: +</pre> +<!--l. 9568--><p class="nopar" > Putting this all together: </p> - <div class="verbatim" id="verbatim-334"> + <pre class="verbatim" id="verbatim-257"> \newacronymstyle{custom-fn}% new style name - <br />{% - <br />  \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% - <br />}% - <br />{% - <br /> \renewcommand*{\GenericAcronymFields}{}% - <br /> \glshyperfirstfalse - <br />  \renewcommand*{\genacrfullformat}[2]{% - <br />   \firstacronymfont{\glsentryshort{##1}}##2% - <br />   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% - <br />  }% - <br />  \renewcommand*{\Genacrfullformat}[2]{% - <br />   \firstacronymfont{\Glsentryshort{##1}}##2% - <br />   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% - <br />  }% - <br />  \renewcommand*{\genplacrfullformat}[2]{% - <br />   \firstacronymfont{\glsentryshortpl{##1}}##2% - <br />   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% - <br />  }% - <br />  \renewcommand*{\Genplacrfullformat}[2]{% - <br />   \firstacronymfont{\Glsentryshortpl{##1}}##2% - <br />   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% - <br />  }% - <br />  \renewcommand*{\glsentryfull}[1]{% - <br />    \glsentrylong{##1}\space - <br />      (\acronymfont{\glsentryshort{##1}})% - <br />  }% - <br />  \renewcommand*{\Glsentryfull}[1]{% - <br />    \Glsentrylong{##1}\space - <br />      (\acronymfont{\glsentryshort{##1}})% - <br />  }% - <br />  \renewcommand*{\glsentryfullpl}[1]{% - <br />    \glsentrylongpl{##1}\space - <br />      (\acronymfont{\glsentryshortpl{##1}})% - <br />  }% - <br />  \renewcommand*{\Glsentryfullpl}[1]{% - <br />    \Glsentrylongpl{##1}\space - <br />      (\acronymfont{\glsentryshortpl{##1}})% - <br />  }% - <br />  \renewcommand*{\acrfullfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \glsentrylong{##2}##3\space - <br />      (\acronymfont{\glsentryshort{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\Acrfullfmt}[3]{% - - - <br />    \glslink[##1]{##2}{% - <br />     \Glsentrylong{##2}##3\space - <br />      (\acronymfont{\glsentryshort{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\ACRfullfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \MakeTextUppercase{% - <br />       \glsentrylong{##2}##3\space - <br />         (\acronymfont{\glsentryshort{##2}})% - <br />     }% - <br />    }% - <br />  }% - <br />  \renewcommand*{\acrfullplfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \glsentrylongpl{##2}##3\space - <br />       (\acronymfont{\glsentryshortpl{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\Acrfullplfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \Glsentrylongpl{##2}##3\space - <br />       (\acronymfont{\glsentryshortpl{##2}})% - <br />    }% - <br />  }% - <br />  \renewcommand*{\ACRfullplfmt}[3]{% - <br />    \glslink[##1]{##2}{% - <br />     \MakeTextUppercase{% - <br />       \glsentrylongpl{##2}##3\space - <br />         (\acronymfont{\glsentryshortpl{##2}})% - <br />     }% - <br />    }% - <br />  }% - <br />  \renewcommand*{\acronymfont}[1]{\textsc{##1}}% - <br />  \renewcommand*{\acrpluralsuffix}{\glstextup{\glspluralsuffix}}% - <br />  \renewcommand*{\acronymsort}[2]{##2}% - <br />  \renewcommand*{\acronymentry}[1]{% - <br />   \Glsentrylong{##1}\space - <br />     (\MakeTextUppercase{\glsentryshort{##1}})}% - <br />} -</div> -<!--l. 11107--><p class="nopar" > -</p><!--l. 11109--><p class="indent" > Now I need to specify that I want to use this new style: - - -</p> - <div class="verbatim" id="verbatim-335"> +{% +  \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% +}% +{% + \renewcommand*{\GenericAcronymFields}{}% + \glshyperfirstfalse +  \renewcommand*{\genacrfullformat}[2]{% +   \firstacronymfont{\glsentryshort{##1}}##2% +   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% +  }% +  \renewcommand*{\Genacrfullformat}[2]{% +   \firstacronymfont{\Glsentryshort{##1}}##2% +   \footnote{\glsentrylong{##1}: \glsentrydesc{##1}}% +  }% +  \renewcommand*{\genplacrfullformat}[2]{% +   \firstacronymfont{\glsentryshortpl{##1}}##2% +   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% +  }% +  \renewcommand*{\Genplacrfullformat}[2]{% +   \firstacronymfont{\Glsentryshortpl{##1}}##2% +   \footnote{\glsentrylongpl{##1}: \glsentrydesc{##1}}% +  }% +  \renewcommand*{\glsentryfull}[1]{% +    \glsentrylong{##1}\space +      (\acronymfont{\glsentryshort{##1}})% +  }% +  \renewcommand*{\Glsentryfull}[1]{% +    \Glsentrylong{##1}\space +      (\acronymfont{\glsentryshort{##1}})% +  }% +  \renewcommand*{\glsentryfullpl}[1]{% +    \glsentrylongpl{##1}\space +      (\acronymfont{\glsentryshortpl{##1}})% +  }% +  \renewcommand*{\Glsentryfullpl}[1]{% +    \Glsentrylongpl{##1}\space +      (\acronymfont{\glsentryshortpl{##1}})% +  }% +  \renewcommand*{\acrfullfmt}[3]{% +    \glslink[##1]{##2}{% +     \glsentrylong{##2}##3\space +      (\acronymfont{\glsentryshort{##2}})% +    }% +  }% +  \renewcommand*{\Acrfullfmt}[3]{% + + +    \glslink[##1]{##2}{% +     \Glsentrylong{##2}##3\space +      (\acronymfont{\glsentryshort{##2}})% +    }% +  }% +  \renewcommand*{\ACRfullfmt}[3]{% +    \glslink[##1]{##2}{% +     \MakeTextUppercase{% +       \glsentrylong{##2}##3\space +         (\acronymfont{\glsentryshort{##2}})% +     }% +    }% +  }% +  \renewcommand*{\acrfullplfmt}[3]{% +    \glslink[##1]{##2}{% +     \glsentrylongpl{##2}##3\space +       (\acronymfont{\glsentryshortpl{##2}})% +    }% +  }% +  \renewcommand*{\Acrfullplfmt}[3]{% +    \glslink[##1]{##2}{% +     \Glsentrylongpl{##2}##3\space +       (\acronymfont{\glsentryshortpl{##2}})% +    }% +  }% +  \renewcommand*{\ACRfullplfmt}[3]{% +    \glslink[##1]{##2}{% +     \MakeTextUppercase{% +       \glsentrylongpl{##2}##3\space +         (\acronymfont{\glsentryshortpl{##2}})% +     }% +    }% +  }% +  \renewcommand*{\acronymfont}[1]{\textsc{##1}}% +  \renewcommand*{\acrpluralsuffix}{\glstextup{\glspluralsuffix}}% +  \renewcommand*{\acronymsort}[2]{##2}% +  \renewcommand*{\acronymentry}[1]{% +   \Glsentrylong{##1}\space +     (\MakeTextUppercase{\glsentryshort{##1}})}% +} +</pre> +<!--l. 9657--><p class="nopar" > +</p><!--l. 9659--><p class="indent" > Now I need to specify that I want to use this new style: + + +</p> + <pre class="verbatim" id="verbatim-258"> \setacronymstyle{custom-fn} -</div> -<!--l. 11112--><p class="nopar" > I also need to use a glossary style that suits this acronym style, for example <span +</pre> +<!--l. 9662--><p class="nopar" > I also need to use a glossary style that suits this acronym style, for example <span class="cmss-10">altlist</span><a - id="dx1-150069"></a>: + id="dx1-139069"></a>: </p> - <div class="verbatim" id="verbatim-336"> + <pre class="verbatim" id="verbatim-259"> \setglossarystyle{altlist} -</div> -<!--l. 11117--><p class="nopar" > -</p><!--l. 11119--><p class="indent" > Once the acronym style has been set, I can define my acronyms: +</pre> +<!--l. 9667--><p class="nopar" > +</p><!--l. 9669--><p class="indent" > Once the acronym style has been set, I can define my acronyms: </p> - <div class="verbatim" id="verbatim-337"> + <pre class="verbatim" id="verbatim-260"> \newacronym[description={set of tags for use in - <br />developing hypertext documents}]{html}{html}{Hyper - <br />Text Markup Language} - <br />\newacronym[description={language used to describe the - <br />layout of a document written in a markup language}]{css} - <br />{css}{Cascading Style Sheet} -</div> -<!--l. 11128--><p class="nopar" > -</p><!--l. 11130--><p class="indent" > The sample file <a +developing hypertext documents}]{html}{html}{Hyper +Text Markup Language} +\newacronym[description={language used to describe the +layout of a document written in a markup language}]{css} +{css}{Cascading Style Sheet} +</pre> +<!--l. 9678--><p class="nopar" > +</p><!--l. 9680--><p class="indent" > The sample file <a href="#ex:sample-custom-acronym"><span class="cmtt-10">sample-custom-acronym.tex</span></a> illustrates this example. </p> <div class="center" > -<!--l. 11132--><p class="noindent" > -</p><!--l. 11132--><p class="noindent" >____________________________</p></div> +<!--l. 9682--><p class="noindent" > +</p><!--l. 9682--><p class="noindent" >____________________________</p></div> <a id="ex:font-abbr"></a> -<!--l. 11134--><p class="noindent" ><span -class="cmbx-12">Example 24</span><span +<!--l. 9684--><p class="noindent" ><span +class="cmbx-12">Example 17</span><span class="cmbx-12"> (Italic and Upright Abbreviations)</span><a - id="x1-150071"></a> -</p><!--l. 11135--><p class="indent" > Suppose I want to have some abbreviations in italic and some that just use the surrounding font. + id="x1-139071"></a> +</p><!--l. 9685--><p class="indent" > Suppose I want to have some abbreviations in italic and some that just use the surrounding font. Hard-coding this into the ⟨<span class="cmti-10">short</span>⟩ argument of <span class="cmtt-10">\newacronym </span>can cause complications. -</p><!--l. 11139--><p class="indent" > This example uses <span +</p><!--l. 9689--><p class="indent" > This example uses <span class="cmtt-10">\glsaddstoragekey</span><a - id="dx1-150072"></a> to add an extra field that can be used to store the formatting + id="dx1-139072"></a> to add an extra field that can be used to store the formatting declaration (such as <span class="cmtt-10">\em</span>). </p> - <div class="verbatim" id="verbatim-338"> + <pre class="verbatim" id="verbatim-261"> \glsaddstoragekey{font}{}{\entryfont} -</div> -<!--l. 11143--><p class="nopar" > This defines a new field/key called <span +</pre> +<!--l. 9693--><p class="nopar" > This defines a new field/key called <span class="cmtt-10">font</span>, which defaults to nothing if it’s not explicitly set. This also defines a command called <span class="cmtt-10">\entryfont </span>that’s analogous to <span class="cmtt-10">\glsentrytext</span>. A new style is then created to format abbreviations that access this field. -</p><!--l. 11149--><p class="indent" > There are two ways to do this. The first is to create a style that doesn’t use <span +</p><!--l. 9699--><p class="indent" > There are two ways to do this. The first is to create a style that doesn’t use <span class="cmtt-10">\glsgenacfmt</span><a - id="dx1-150073"></a> + id="dx1-139073"></a> but instead provides a modified version that doesn’t use <span class="cmtt-10">\acronymfont{</span>⟨<span class="cmti-10">short</span>⟩<span @@ -22465,19 +20186,19 @@ similarly adjusted. For example: </p> - <div class="verbatim" id="verbatim-339"> + <pre class="verbatim" id="verbatim-262">   \renewcommand*{\genacrfullformat}[2]{% - <br />   \glsentrylong{##1}##2\space - <br />   ({\entryfont{##1}\glsentryshort{##1}})% - <br />  }% -</div> -<!--l. 11161--><p class="nopar" > This will deal with commands like <span +   \glsentrylong{##1}##2\space +   ({\entryfont{##1}\glsentryshort{##1}})% +  }% +</pre> +<!--l. 9711--><p class="nopar" > This will deal with commands like <span class="cmtt-10">\gls</span><a - id="dx1-150074"></a> but not commands like <span + id="dx1-139074"></a> but not commands like <span class="cmtt-10">\acrshort</span><a - id="dx1-150075"></a> which still use <span + id="dx1-139075"></a> which still use <span class="cmtt-10">\acronymfont</span><a - id="dx1-150076"></a>. + id="dx1-139076"></a>. Another approach is to redefine <span class="cmtt-10">\acronymfont </span>to look up the required font declaration. Since <span class="cmtt-10">\acronymfont</span> @@ -22485,7 +20206,7 @@ doesn’t take the entry label as an argument, the following will only work class="cmtt-10">\acronymfont </span>is used in a context where the label is provided by <span class="cmtt-10">\glslabel</span><a - id="dx1-150077"></a>. This is true in <span + id="dx1-139077"></a>. This is true in <span class="cmtt-10">\gls</span>, <span class="cmtt-10">\acrshort </span>and <span class="cmtt-10">\acrfull</span>. The redefinition is @@ -22493,56 +20214,56 @@ now: </p> - <div class="verbatim" id="verbatim-340"> + <pre class="verbatim" id="verbatim-263"> \renewcommand*{\acronymfont}[1]{{\entryfont{\glslabel}#1}}% -</div> -<!--l. 11172--><p class="nopar" > So the new style can be defined as: +</pre> +<!--l. 9722--><p class="nopar" > So the new style can be defined as: </p> - <div class="verbatim" id="verbatim-341"> + <pre class="verbatim" id="verbatim-264"> \newacronymstyle{long-font-short} - <br />{% - <br />  \GlsUseAcrEntryDispStyle{long-short}% - <br />} - <br />{% - <br />  \GlsUseAcrStyleDefs{long-short}% - <br />  \renewcommand*{\genacrfullformat}[2]{% - <br />   \glsentrylong{##1}##2\space - <br />   ({\entryfont{##1}\glsentryshort{##1}})% - <br />  }% - <br />  \renewcommand*{\Genacrfullformat}[2]{% - <br />   \Glsentrylong{##1}##2\space - <br />   ({\entryfont{##1}\glsentryshort{##1}})% - <br />  }% - <br />  \renewcommand*{\genplacrfullformat}[2]{% - <br />   \glsentrylongpl{##1}##2\space - <br />   ({\entryfont{##1}\glsentryshortpl{##1}})% - <br />  }% - <br />  \renewcommand*{\Genplacrfullformat}[2]{% - <br />   \Glsentrylongpl{##1}##2\space - <br />   ({\entryfont{##1}\glsentryshortpl{##1}})% - <br />  }% - <br />  \renewcommand*{\acronymfont}[1]{{\entryfont{\glslabel}##1}}% - <br />  \renewcommand*{\acronymentry}[1]{{\entryfont{##1}\glsentryshort{##1}}}% - <br />} -</div> -<!--l. 11200--><p class="nopar" > Remember the style needs to be set before defining the entries: - - -</p> - <div class="verbatim" id="verbatim-342"> +{% +  \GlsUseAcrEntryDispStyle{long-short}% +} +{% +  \GlsUseAcrStyleDefs{long-short}% +  \renewcommand*{\genacrfullformat}[2]{% +   \glsentrylong{##1}##2\space +   ({\entryfont{##1}\glsentryshort{##1}})% +  }% +  \renewcommand*{\Genacrfullformat}[2]{% +   \Glsentrylong{##1}##2\space +   ({\entryfont{##1}\glsentryshort{##1}})% +  }% +  \renewcommand*{\genplacrfullformat}[2]{% +   \glsentrylongpl{##1}##2\space +   ({\entryfont{##1}\glsentryshortpl{##1}})% +  }% +  \renewcommand*{\Genplacrfullformat}[2]{% +   \Glsentrylongpl{##1}##2\space +   ({\entryfont{##1}\glsentryshortpl{##1}})% +  }% +  \renewcommand*{\acronymfont}[1]{{\entryfont{\glslabel}##1}}% +  \renewcommand*{\acronymentry}[1]{{\entryfont{##1}\glsentryshort{##1}}}% +} +</pre> +<!--l. 9750--><p class="nopar" > Remember the style needs to be set before defining the entries: + + +</p> + <pre class="verbatim" id="verbatim-265"> \setacronymstyle{long-font-short} -</div> -<!--l. 11204--><p class="nopar" > -</p><!--l. 11206--><p class="indent" > The complete document is contained in the sample file <a +</pre> +<!--l. 9754--><p class="nopar" > +</p><!--l. 9756--><p class="indent" > The complete document is contained in the sample file <a href="#ex:sample-font-abbr"><span class="cmtt-10">sample-font-abbr.tex</span></a>. </p> <div class="center" > -<!--l. 11208--><p class="noindent" > -</p><!--l. 11208--><p class="noindent" >____________________________</p></div> -<!--l. 11210--><p class="indent" > Some writers and publishing houses have started to drop full stops (periods) from upper case initials but +<!--l. 9758--><p class="noindent" > +</p><!--l. 9758--><p class="noindent" >____________________________</p></div> +<!--l. 9760--><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 TeXbook </span>discusses the spacing between words but, @@ -22554,25 +20275,25 @@ class="cmtt-10">␣</span></span></span> (back slash space) in place of jus for an inter-word mid-sentence space and use <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\@</span></span></span> before the full stop to indicate the end of the sentence. -</p><!--l. 11225--><p class="indent" > For example: +</p><!--l. 9775--><p class="indent" > For example: </p> - <div class="verbatim" id="verbatim-343"> + <pre class="verbatim" id="verbatim-266"> I was awarded a B.Sc. and a Ph.D. (From the same place.) -</div> -<!--l. 11228--><p class="nopar" > is typeset as <spacer type=vertical size=10><span class="obeylines-h"> +</pre> +<!--l. 9778--><p class="nopar" > is typeset as <spacer type=vertical size=10><span class="obeylines-h"> <br />I was awarded a B.Sc. and a Ph.D. (From the same place.) <br /><spacer type=vertical size=10></span> The spacing is more noticeable with the typewriter font: </p> - <div class="verbatim" id="verbatim-344"> + <pre class="verbatim" id="verbatim-267"> \ttfamily - <br />I was awarded a B.Sc. and a Ph.D. (From the same place.) -</div> -<!--l. 11237--><p class="nopar" > is typeset as <spacer type=vertical size=10><span class="obeylines-h"> +I was awarded a B.Sc. and a Ph.D. (From the same place.) +</pre> +<!--l. 9787--><p class="nopar" > is typeset as <spacer type=vertical size=10><span class="obeylines-h"> <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> @@ -22582,11 +20303,11 @@ the following full stop is just part of the abbreviation. These can be corrected </p> - <div class="verbatim" id="verbatim-345"> + <pre class="verbatim" id="verbatim-268"> I was awarded a B.Sc.\ and a Ph.D\@. (From the same place.) -</div> -<!--l. 11249--><p class="nopar" > -</p><!--l. 11251--><p class="indent" > This situation is a bit problematic for <span +</pre> +<!--l. 9799--><p class="nopar" > +</p><!--l. 9801--><p class="indent" > This situation is a bit problematic for <span class="cmss-10">glossaries</span>. The full stops can form part of the ⟨<span class="cmti-10">short</span>⟩ argument of <span @@ -22599,21 +20320,21 @@ terminating full stop (to avoid two dots) which can make the source code look a but you also need to adjust the space factor, which is usually done by inserting <span class="cmtt-10">\@ </span>before the full stop. -</p><!--l. 11261--><p class="indent" > The next example shows one way of achieving this. (Note that the supplemental <a +</p><!--l. 9811--><p class="indent" > The next example shows one way of achieving this. (Note that the supplemental <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> -package provides a much simpler way of doing this, which you may prefer to use. See the <a -href="https://www.dickimaw-books.com/gallery/sample-initialisms.shtml" >initialisms -example</a>.) +package provides a much simpler way of doing this, which you may prefer to use. See <a +href="https://www.dickimaw-books.com/gallery/sample-initialisms.shtml" >Gallery: +Initialisms</a>.) <a id="ex:dotabbr"></a> -</p><!--l. 11266--><p class="noindent" ><span -class="cmbx-12">Example 25</span><span +</p><!--l. 9816--><p class="noindent" ><span +class="cmbx-12">Example 18</span><span class="cmbx-12"> (Abbreviations with Full Stops (Periods))</span><a - id="x1-150079"></a> -</p><!--l. 11267--><p class="indent" > As from version 4.16, there’s now a hook (<span + id="x1-139079"></a> +</p><!--l. 9817--><p class="indent" > As from version 4.16, there’s now a hook (<span class="cmtt-10">\glspostlinkhook</span><a - id="dx1-150080"></a>) that’s called at the very end of the + id="dx1-139080"></a>) that’s called at the very end of the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> and <a @@ -22621,75 +20342,75 @@ href="#sec:glstext-like"><span class="cmtt-10">\glstext</span>-like</a> commands. This can be redefined to check if the following character is a full stop. The <span class="cmss-10">amsgen</span><a - id="dx1-150081"></a> package (which is automatically loaded by <span + id="dx1-139081"></a> package (which is automatically loaded by <span class="cmss-10">glossaries</span>) provides an internal command called <span class="cmtt-10">\new@ifnextchar </span>that can be used to determine if the given character appears next. (For more information see the <span class="cmss-10">amsgen</span><a - id="dx1-150082"></a> documentation.) -</p><!--l. 11276--><p class="indent" > It’s possible that I may also want acronyms or contractions in my document, so I need some way to + id="dx1-139082"></a> documentation.) +</p><!--l. 9826--><p class="indent" > It’s possible that I may also want acronyms or contractions in my document, so I need some way to differentiate between them. Here I’m going to use the same method as in example <a href="#ex:addstoragekey">4<!--tex4ht:ref: ex:addstoragekey --></a> where a new field is defined to indicate the type of abbreviation: </p> - <div class="verbatim" id="verbatim-346"> + <pre class="verbatim" id="verbatim-269"> \glsaddstoragekey{abbrtype}{word}{\abbrtype} - <br />\newcommand*{\newabbr}[1][]{\newacronym[abbrtype=initials,#1]} -</div> -<!--l. 11285--><p class="nopar" > Now I just use <span +\newcommand*{\newabbr}[1][]{\newacronym[abbrtype=initials,#1]} +</pre> +<!--l. 9835--><p class="nopar" > Now I just use <span class="cmtt-10">\newacronym</span><a - id="dx1-150083"></a> for the acronyms, for example, + id="dx1-139083"></a> for the acronyms, for example, </p> - <div class="verbatim" id="verbatim-347"> + <pre class="verbatim" id="verbatim-270"> \newacronym{laser}{laser}{light amplification by stimulated - <br />emission of radiation} -</div> -<!--l. 11290--><p class="nopar" > and my new command <span +emission of radiation} +</pre> +<!--l. 9840--><p class="nopar" > and my new command <span class="cmtt-10">\newabbr </span>for initials, for example, </p> - <div class="verbatim" id="verbatim-348"> + <pre class="verbatim" id="verbatim-271"> \newabbr{eg}{e.g.}{exempli gratia} - <br />\newabbr{ie}{i.e.}{id est} - <br />\newabbr{bsc}{B.Sc.}{Bachelor of Science} - <br />\newabbr{ba}{B.A.}{Bachelor of Arts} - <br />\newabbr{agm}{A.G.M.}{annual general meeting} -</div> -<!--l. 11298--><p class="nopar" > Within <span +\newabbr{ie}{i.e.}{id est} +\newabbr{bsc}{B.Sc.}{Bachelor of Science} +\newabbr{ba}{B.A.}{Bachelor of Arts} +\newabbr{agm}{A.G.M.}{annual general meeting} +</pre> +<!--l. 9848--><p class="nopar" > Within <span class="cmtt-10">\glspostlinkhook </span>the entry’s label can be accessed using <span class="cmtt-10">\glslabel</span><a - id="dx1-150084"></a> and <span + id="dx1-139084"></a> and <span class="cmtt-10">\ifglsfieldeq</span><a - id="dx1-150085"></a> can be used + id="dx1-139085"></a> can be used to determine if the current entry has the new <span class="cmtt-10">abbrtype </span>field set to “initials”. If it doesn’t, then nothing needs to happen, but if it does, a check is performed to see if the next character is a full stop. If it is, this signals the end of a sentence otherwise it’s mid-sentence. -</p><!--l. 11307--><p class="indent" > Remember that internal commands within the document file (rather than in a class or package) need to be +</p><!--l. 9857--><p class="indent" > Remember that internal commands within the document file (rather than in a class or package) need to be placed between <span class="cmtt-10">\makeatletter</span><a - id="dx1-150086"></a> and <span + id="dx1-139086"></a> and <span class="cmtt-10">\makeatother</span><a - id="dx1-150087"></a>: + id="dx1-139087"></a>: </p> - <div class="verbatim" id="verbatim-349"> + <pre class="verbatim" id="verbatim-272"> \makeatletter - <br />\renewcommand{\glspostlinkhook}{% - <br /> \ifglsfieldeq{\glslabel}{abbrtype}{initials}% - <br /> {\new@ifnextchar.\doendsentence\doendword} - <br /> {}% - <br />} - <br />\makeatother -</div> -<!--l. 11318--><p class="nopar" > In the event that a full stop is found <span +\renewcommand{\glspostlinkhook}{% + \ifglsfieldeq{\glslabel}{abbrtype}{initials}% + {\new@ifnextchar.\doendsentence\doendword} + {}% +} +\makeatother +</pre> +<!--l. 9868--><p class="nopar" > In the event that a full stop is found <span class="cmtt-10">\doendsentence </span>is performed but it will be followed by the full stop, which needs to be discarded. Otherwise <span class="cmtt-10">\doendword </span>will be done but it won’t be followed by a full stop so @@ -22697,73 +20418,79 @@ there’s nothing to discard. The definitions for these commands are: </p> - <div class="verbatim" id="verbatim-350"> + <pre class="verbatim" id="verbatim-273"> \newcommand{\doendsentence}[1]{\spacefactor=10000{}} - <br />\newcommand{\doendword}{\spacefactor=1000{}} -</div> -<!--l. 11327--><p class="nopar" > Now, I can just do <span class="obeylines-h"><span class="verb"><span +\newcommand{\doendword}{\spacefactor=1000{}} +</pre> +<!--l. 9877--><p class="nopar" > Now, I can just do <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{bsc}</span></span></span> mid-sentence and <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{phd}.</span></span></span> at the end of the sentence. The terminating full stop will be discarded in the latter case, but it won’t be discarded in, say, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{laser}.</span></span></span> as that doesn’t have the <span class="cmtt-10">abbrtype </span>field set to “initials”. -</p><!--l. 11334--><p class="indent" > This also works on first use when the style is set to one of the ⟨<span +</p><!--l. 9884--><p class="indent" > This also works on first use when the style is set to one of the ⟨<span class="cmti-10">long</span>⟩ (⟨<span class="cmti-10">short</span>⟩) styles but it will fail with the ⟨<span class="cmti-10">short</span>⟩ (⟨<span class="cmti-10">long</span>⟩) styles as in this case the terminating full stop shouldn’t be discarded. Since <span class="cmtt-10">\glspostlinkhook</span><a - id="dx1-150088"></a> is + id="dx1-139088"></a> is used after the <a href="#glo:firstuseflag">first use flag</a> has been unset for the entry, this can’t be fixed by simply checking with <span class="cmtt-10">\ifglsused</span><a - id="dx1-150089"></a>. One possible solution to this is to redefine <span + id="dx1-139089"></a>. One possible solution to this is to redefine <span class="cmtt-10">\glslinkpostsetkeys</span><a - id="dx1-150090"></a> to check for the <a + id="dx1-139090"></a> to check for the <a href="#glo:firstuseflag">first use flag</a> and define a macro that can then be used in <span class="cmtt-10">\glspostlinkhook</span><a - id="dx1-150091"></a>. -</p><!--l. 11344--><p class="indent" > The other thing to consider is what to do with plurals. One possibility is to check for plural use + id="dx1-139091"></a>. +</p><!--l. 9894--><p class="indent" > The other thing to consider is what to do with plurals. One possibility is to check for plural use within <span class="cmtt-10">\doendsentence </span>(using <span class="cmtt-10">\glsifplural</span><a - id="dx1-150092"></a>) and put the full stop back if the plural has been + id="dx1-139092"></a>) and put the full stop back if the plural has been used. -</p><!--l. 11349--><p class="indent" > The complete document is contained in the sample file <a +</p><!--l. 9899--><p class="indent" > The complete document is contained in the sample file <a href="#ex:sample-dot-abbr"><span class="cmtt-10">sample-dot-abbr.tex</span></a>. </p> <div class="center" > -<!--l. 11351--><p class="noindent" > -</p><!--l. 11351--><p class="noindent" >____________________________</p></div> -<!--l. 11353--><p class="noindent" > +<!--l. 9901--><p class="noindent" > +</p><!--l. 9901--><p class="noindent" >____________________________</p></div> +<!--l. 9903--><p class="noindent" > </p> -<!--l. 11353--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">13.2 </span> <a +<!--l. 9903--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.3 </span> <a id="sec:disploa"></a>Displaying the List of Acronyms</h3> -<!--l. 11356--><p class="noindent" >The list of acronyms is just like any other type of glossary and can be displayed on its own using: +<!--l. 9906--><p class="noindent" >The list of acronyms is just like any other type of glossary and can be displayed on its own using: </p><dl class="description"><dt class="description"> + <!--l. 9909--><p class="noindent" > <a href="#option1"><span class="cmbx-10">Option</span><span class="cmbx-10"> 1</span></a><span -class="cmbx-10">:</span> </dt><dd +class="cmbx-10">:</span> </p></dt><dd class="description"> + <!--l. 9909--><p class="noindent" > +</p> <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-151001"></a><span + id="dx1-140001"></a><span class="cmtt-10">[type=\acronymtype</span><a - id="dx1-151002"></a><span + id="dx1-140002"></a><span class="cmtt-10">]</span> </div> </div> + + </dd><dt class="description"> + <!--l. 9914--><p class="noindent" > <span class="cmbx-10">Options</span><span class="cmbx-10"> </span><a @@ -22773,27 +20500,27 @@ class="cmbx-10">and</span><span class="cmbx-10"> </span><a href="#option3"><span class="cmbx-10">3</span></a><span -class="cmbx-10">:</span> </dt><dd +class="cmbx-10">:</span> </p></dt><dd class="description"> + <!--l. 9914--><p class="noindent" > +</p> <div class="alltt"> - - <div class="obeylines-v"> <span class="cmtt-10">\printglossary</span><a - id="dx1-151003"></a><span + id="dx1-140003"></a><span class="cmtt-10">[type=\acronymtype</span><a - id="dx1-151004"></a><span + id="dx1-140004"></a><span class="cmtt-10">]</span> </div> </div> - <!--l. 11369--><p class="noindent" >(If you use the <span + <!--l. 9919--><p class="noindent" >(If you use the <span class="cmss-10">acronym</span><a - id="dx1-151005"></a> package option you can also use </p><div class="alltt"> + id="dx1-140005"></a> package option you can also use </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printacronyms</span><a - id="dx1-151006"></a><span + id="dx1-140006"></a><span class="cmtt-10">[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> @@ -22802,28 +20529,32 @@ class="cmtt-10">]</span> <div class="obeylines-v"> <span class="cmtt-10">\printglossary</span><a - id="dx1-151007"></a><span + id="dx1-140007"></a><span class="cmtt-10">[type=\acronymtype</span><a - id="dx1-151008"></a><span + id="dx1-140008"></a><span class="cmtt-10">,</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]</span> </div> </div> See <a -href="#sec:pkgopts-acronym">§2.7 </a><a +href="#sec:pkgopts-acronym">§<span +class="cmbx-10">??</span>sec:pkgopts-acronym </a><a href="#sec:pkgopts-acronym">Acronym and Abbreviation Options<!--tex4ht:ref: sec:pkgopts-acronym --></a>.) </dd></dl> -<!--l. 11381--><p class="noindent" >Alternatively the list of acronyms can be displayed with all the other glossaries using: +<!--l. 9931--><p class="noindent" >Alternatively the list of acronyms can be displayed with all the other glossaries using: </p><dl class="description"><dt class="description"> + <!--l. 9934--><p class="noindent" > <a href="#option1"><span class="cmbx-10">Option</span><span class="cmbx-10"> 1</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 9934--><p class="noindent" ><span class="cmtt-10">\printnoidxglossaries</span><a - id="dx1-151009"></a> - </dd><dt class="description"> + id="dx1-140009"></a> + </p></dd><dt class="description"> + <!--l. 9936--><p class="noindent" > <span class="cmbx-10">Options</span><span class="cmbx-10"> </span><a @@ -22833,39 +20564,43 @@ class="cmbx-10">and</span><span class="cmbx-10"> </span><a href="#option3"><span class="cmbx-10">3</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 9936--><p class="noindent" ><span class="cmtt-10">\printglossaries</span><a - id="dx1-151010"></a></dd></dl> -<!--l. 11389--><p class="indent" > However, care must be taken to choose a glossary style that’s appropriate to your acronym style. + id="dx1-140010"></a></p></dd></dl> +<!--l. 9939--><p class="indent" > However, care must be taken to choose a glossary style that’s appropriate to your acronym style. Alternatively, you can define your own custom style (see <a -href="#sec:newglossarystyle">§15.2 </a><a -href="#sec:newglossarystyle">Defining your own glossary style<!--tex4ht:ref: sec:newglossarystyle --></a> for further -details). -</p><!--l. 11394--><p class="noindent" > +href="#sec:newglossarystyle">§<span +class="cmbx-10">??</span>sec:newglossarystyle </a><a +href="#sec:newglossarystyle">Defining your own glossary style<!--tex4ht:ref: sec:newglossarystyle --></a> +for further details). + + +</p><!--l. 9944--><p class="noindent" > </p> -<!--l. 11394--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">13.3 </span> <a +<!--l. 9944--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6.4 </span> <a id="sec:oldacronym"></a>Upgrading From the glossary Package</h3> -<!--l. 11397--><p class="noindent" >Users of the obsolete <span +<!--l. 9947--><p class="noindent" >Users of the obsolete <span class="cmss-10">glossary</span><a - id="dx1-152001"></a> package may recall that the syntax used to define new acronyms has changed with + id="dx1-141001"></a> package may recall that the syntax used to define new acronyms has changed with the replacement <span class="cmss-10">glossaries </span>package. In addition, the old <span class="cmss-10">glossary</span><a - id="dx1-152002"></a> package created the command <span + id="dx1-141002"></a> package created the command <span class="cmtt-10">\</span>⟨<span class="cmti-10">acr-name</span>⟩ when defining the acronym ⟨<span class="cmti-10">acr-name</span>⟩. -</p><!--l. 11403--><p class="indent" > In order to facilitate migrating from the old package to the new one, the <span +</p><!--l. 9953--><p class="indent" > In order to facilitate migrating from the old package to the new one, the <span class="cmss-10">glossaries</span> package<span class="footnote-mark"><a -href="#fn1x13" id="fn1x13-bk"><sup class="textsuperscript">13.1</sup></a></span><a - id="x1-152003f1"></a> +href="#fn1x6" id="fn1x6-bk"><sup class="textsuperscript">6.1</sup></a></span><a + id="x1-141003f1"></a> provides the command: -</p><!--l. 11406--><p class="indent" > <hr><div title="Definition"><a - id="dx1-152004"></a> <span +</p><!--l. 9956--><p class="indent" > <hr><div title="Definition"><a + id="dx1-141004"></a> <span class="cmtt-10">\oldacronym[</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -22875,16 +20610,14 @@ class="cmitt-10">long</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">key-val list</span>⟩<span class="cmtt-10">} </span></div><hr> - - -</p><!--l. 11408--><p class="noindent" > +</p><!--l. 9958--><p class="noindent" > This uses the same syntax as the <span class="cmss-10">glossary</span><a - id="dx1-152005"></a> package’s method of defining acronyms. It is equivalent to: + id="dx1-141005"></a> package’s method of defining acronyms. It is equivalent to: <spacer type=vertical size=10><span class="obeylines-h"> <br /><span class="cmtt-10">\newacronym</span><a - id="dx1-152006"></a><span + id="dx1-141006"></a><span class="cmtt-10">[</span>⟨<span class="cmti-10">key-val list</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -22897,11 +20630,11 @@ class="cmtt-10">}</span> <br /><spacer type=vertical size=10></span> In addition, <span class="cmtt-10">\oldacronym</span><a - id="dx1-152007"></a> also defines the commands <span + id="dx1-141007"></a> also defines the commands <span class="cmtt-10">\</span>⟨<span class="cmti-10">label</span>⟩, which is equivalent to <span class="cmtt-10">\gls</span><a - id="dx1-152008"></a><span + id="dx1-141008"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>, and <span @@ -22910,7 +20643,7 @@ class="cmti-10">label</span>⟩<span class="cmtt-10">*</span>, which is equivalent to <span class="cmtt-10">\Gls</span><a - id="dx1-152009"></a><span + id="dx1-141009"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>. If ⟨<span @@ -22922,86 +20655,87 @@ class="cmtt-10">\</span>⟨<span class="cmti-10">label</span>⟩ doesn’t allow you to use the first optional argument of <span class="cmtt-10">\gls</span><a - id="dx1-152010"></a> or <span + id="dx1-141010"></a> or <span class="cmtt-10">\Gls</span><a - id="dx1-152011"></a> — you will need to explicitly use <span + id="dx1-141011"></a> — you will need to explicitly use <span class="cmtt-10">\gls</span><a - id="dx1-152012"></a> or <span + id="dx1-141012"></a> or <span class="cmtt-10">\Gls</span><a - id="dx1-152013"></a> to change + id="dx1-141013"></a> to change the settings. -</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 +</p><!--l. 9975--><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 class="cmss-10">xspace</span><a - id="dx1-152014"></a> package, but be aware that there + id="dx1-141014"></a> package, but be aware that there are some issues with using <span class="cmss-10">xspace</span><a - id="dx1-152015"></a>.<span class="footnote-mark"><a -href="#fn2x13" id="fn2x13-bk"><sup class="textsuperscript">13.2</sup></a></span></div> -</p><!--l. 11431--><p class="noindent" > + id="dx1-141015"></a>.<span class="footnote-mark"><a +href="#fn2x6" id="fn2x6-bk"><sup class="textsuperscript">6.2</sup></a></span></div> +</p><!--l. 9981--><p class="noindent" > <a - id="x1-152016f2"></a> -</p><!--l. 11436--><p class="indent" > The <span + id="x1-141016f2"></a> +</p><!--l. 9986--><p class="indent" > The <span class="cmss-10">glossaries </span>package doesn’t load the <span class="cmss-10">xspace</span><a - id="dx1-152017"></a> package since there are both advantages and disadvantages to + id="dx1-141017"></a> package since there are both advantages and disadvantages to using <span class="cmtt-10">\xspace</span><a - id="dx1-152018"></a> in <span + id="dx1-141018"></a> in <span class="cmtt-10">\</span>⟨<span class="cmti-10">label</span>⟩. If you don’t use the <span class="cmss-10">xspace</span><a - id="dx1-152019"></a> package you need to explicitly force a space + id="dx1-141019"></a> package you need to explicitly force a space using <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\␣</span></span></span> (backslash space) however you can follow <span class="cmtt-10">\</span>⟨<span class="cmti-10">label</span>⟩ with additional text in square brackets (the final optional argument to <span class="cmtt-10">\gls</span><a - id="dx1-152020"></a>). If you use the <span + id="dx1-141020"></a>). If you use the <span class="cmss-10">xspace</span><a - id="dx1-152021"></a> package you don’t need to escape + id="dx1-141021"></a> package you don’t need to escape the spaces but you can’t use the optional argument to insert text (you will have to explicitly use <span class="cmtt-10">\gls</span><a - id="dx1-152022"></a>). -</p><!--l. 11447--><p class="indent" > To illustrate this, suppose I define the acronym “abc” as follows: + id="dx1-141022"></a>). +</p><!--l. 9997--><p class="indent" > To illustrate this, suppose I define the acronym “abc” as follows: </p> - <div class="verbatim" id="verbatim-351"> + <pre class="verbatim" id="verbatim-274"> \oldacronym{abc}{example acronym}{} -</div> -<!--l. 11451--><p class="nopar" > This will create the command <span +</pre> +<!--l. 10001--><p class="nopar" > This will create the command <span class="cmtt-10">\abc </span>and its starred version <span class="cmtt-10">\abc*</span>. <a -href="#tab:xspace">Table 13.2</a> illustrates the effect of <span -class="cmtt-10">\abc </span>(on -subsequent use) according to whether or not the <span +href="#tab:xspace">Table <span +class="cmbx-10">??</span>tab:xspace</a> illustrates the effect of +<span +class="cmtt-10">\abc </span>(on subsequent use) according to whether or not the <span class="cmss-10">xspace</span><a - id="dx1-152023"></a> package has been loaded. As can be seen + id="dx1-141023"></a> package has been loaded. As can be seen from the final row in the table, the <span class="cmss-10">xspace</span><a - id="dx1-152024"></a> package prevents the optional argument from being + id="dx1-141024"></a> package prevents the optional argument from being recognised. </p> <div class="table"> -<!--l. 11459--><p class="indent" > <a +<!--l. 10009--><p class="indent" > <a id="tab:xspace"></a></p><hr class="float" /><div class="float" > <div class="caption" -><span class="id">Table 13.2: </span><span +><span class="id">Table 6.2: </span><span class="content">The effect of using <span class="cmss-10">xspace </span>with <span -class="cmtt-10">\oldacronym</span></span></div><!--tex4ht:label?: x1-1520252 --> +class="cmtt-10">\oldacronym</span></span></div><!--tex4ht:label?: x1-1410252 --> <div class="tabular"> <table id="TBL-8" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-8-1g"><col id="TBL-8-1" /><col id="TBL-8-2" /><col @@ -23056,71 +20790,71 @@ class="td11"> abc’s xyz </td></tr></table> </div> -<!--l. 11477--><p class="indent" > </div> -</p><!--l. 11477--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">14. <a +<!--l. 10027--><p class="indent" > </div> +</p><!--l. 10027--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">7. <a id="sec:glsunset"></a>Unsetting and Resetting Entry Flags</h2> -</p><!--l. 11480--><p class="indent" > When using the <a +</p><!--l. 10030--><p class="indent" > When using the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands it is possible that you may want to use the value given by the <span class="cmtt-10">first</span><a - id="dx1-153001"></a> + id="dx1-142001"></a> key, even though you have already <a href="#glo:firstuse">used</a> the glossary entry. Conversely, you may want to use the value given by the <span class="cmtt-10">text</span><a - id="dx1-153002"></a> key, even though you haven’t used the glossary entry. The former can be achieved by one of the + id="dx1-142002"></a> key, even though you haven’t used the glossary entry. The former can be achieved by one of the following commands: -</p><!--l. 11486--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153003"></a> <span +</p><!--l. 10036--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142003"></a> <span class="cmtt-10">\glsreset{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 11488--><p class="noindent" > -</p><!--l. 11489--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153004"></a> <span +</p><!--l. 10038--><p class="noindent" > +</p><!--l. 10039--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142004"></a> <span class="cmtt-10">\glslocalreset{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 11491--><p class="noindent" > +</p><!--l. 10041--><p class="noindent" > while the latter can be achieved by one of the following commands: -</p><!--l. 11493--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153005"></a> <span +</p><!--l. 10043--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142005"></a> <span class="cmtt-10">\glsunset{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 11495--><p class="noindent" > -</p><!--l. 11496--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153006"></a> <span +</p><!--l. 10045--><p class="noindent" > +</p><!--l. 10046--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142006"></a> <span class="cmtt-10">\glslocalunset{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 11498--><p class="noindent" > +</p><!--l. 10048--><p class="noindent" > You can also reset or unset all entries for a given glossary or list of glossaries using: -</p><!--l. 11501--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153007"></a> <span +</p><!--l. 10051--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142007"></a> <span class="cmtt-10">\glsresetall[</span>⟨<span class="cmitt-10">glossary list</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 11503--><p class="noindent" > -</p><!--l. 11504--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153008"></a> <span +</p><!--l. 10053--><p class="noindent" > +</p><!--l. 10054--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142008"></a> <span class="cmtt-10">\glslocalresetall[</span>⟨<span class="cmitt-10">glossary list</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 11506--><p class="noindent" > -</p><!--l. 11507--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153009"></a> <span +</p><!--l. 10056--><p class="noindent" > +</p><!--l. 10057--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142009"></a> <span class="cmtt-10">\glsunsetall[</span>⟨<span class="cmitt-10">glossary list</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 11509--><p class="noindent" > -</p><!--l. 11510--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153010"></a> <span +</p><!--l. 10059--><p class="noindent" > +</p><!--l. 10060--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142010"></a> <span class="cmtt-10">\glslocalunsetall[</span>⟨<span class="cmitt-10">glossary list</span>⟩<span class="cmtt-10">] </span></div><hr> -</p><!--l. 11512--><p class="noindent" > +</p><!--l. 10062--><p class="noindent" > where ⟨<span class="cmti-10">glossary list</span>⟩ is a comma-separated list of glossary labels. If omitted, all defined glossaries are assumed (except for the ignored ones). For example, to reset all entries in the main glossary and the list of @@ -23128,14 +20862,14 @@ acronyms: </p> - <div class="verbatim" id="verbatim-352"> + <pre class="verbatim" id="verbatim-275"> \glsresetall[main,acronym] -</div> -<!--l. 11520--><p class="nopar" > -</p><!--l. 11522--><p class="indent" > You can determine whether an entry’s <a +</pre> +<!--l. 10070--><p class="nopar" > +</p><!--l. 10072--><p class="indent" > You can determine whether an entry’s <a href="#glo:firstuseflag">first use flag</a> is set using: -</p><!--l. 11523--><p class="indent" > <hr><div title="Definition"><a - id="dx1-153011"></a> <span +</p><!--l. 10073--><p class="indent" > <hr><div title="Definition"><a + id="dx1-142011"></a> <span class="cmtt-10">\ifglsused{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -23143,115 +20877,135 @@ 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. 11525--><p class="noindent" > +</p><!--l. 10075--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the label of the required entry. If the entry has been used, ⟨<span class="cmti-10">true part</span>⟩ will be done, otherwise ⟨<span class="cmti-10">false</span> <span class="cmti-10">part</span>⟩ will be done. -</p><!--l. 11530--><p class="indent" > <div class="important" title="Important Note"> Be careful when using <a +</p><!--l. 10080--><p class="indent" > Note that <span +class="cmtt-10">\ifglsused </span>is unreliable with <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-142012"></a></a> as the entry isn’t defined on the first LaTeX run, +which means there’s no way of determining if it has been used, so <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> provides a similar +command: +</p><!--l. 10085--><p class="indent" > <hr><div title="Definition"><span id="textcolor291"><span +class="cmtt-10">\GlsXtrIfUnusedOrUndefined</span></span><a + id="dx1-142013"></a><span +class="cmtt-10">{</span>⟨<span +class="cmitt-10">label</span>⟩<span +class="cmtt-10">}{</span>⟨<span +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. 10086--><p class="noindent" > +</p><!--l. 10088--><p class="indent" > <div class="important" title="Important Note"> Be careful when using <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> commands within an environment or command argument that gets processed multiple times as it can cause unwanted side-effects when the first use displayed text is different from subsequent use. </div> -</p><!--l. 11535--><p class="noindent" > -</p><!--l. 11537--><p class="indent" > For example, the <span +</p><!--l. 10093--><p class="noindent" > +</p><!--l. 10095--><p class="indent" > For example, the <span class="cmss-10">frame</span><a - id="dx1-153012"></a><a - id="dx1-153013"></a> environment in <span + id="dx1-142014"></a><a + id="dx1-142015"></a> environment in <span class="cmss-10">beamer</span><a - id="dx1-153014"></a> processes its argument for each overlay. This means that the + id="dx1-142016"></a> processes its argument for each overlay. This means that the <a href="#glo:firstuseflag">first use flag</a> will be unset on the first overlay and subsequent overlays will use the non-first use form. -</p><!--l. 11542--><p class="indent" > Consider the following example: +</p><!--l. 10100--><p class="indent" > Consider the following example: </p> - <div class="verbatim" id="verbatim-353"> + <pre class="verbatim" id="verbatim-276"> \documentclass{beamer} - <br />\usepackage{glossaries} - <br />\newacronym{svm}{SVM}{support vector machine} - <br />\begin{document} - <br />\begin{frame} - <br /> \frametitle{Frame 1} - <br /> \begin{itemize} - <br />  \item<+-> \gls{svm} - <br />  \item<+-> Stuff. - <br /> \end{itemize} - <br />\end{frame} - <br />\end{document} -</div> -<!--l. 11562--><p class="nopar" > -</p><!--l. 11564--><p class="indent" > On the first overlay, <span class="obeylines-h"><span class="verb"><span +\usepackage{glossaries} +\newacronym{svm}{SVM}{support vector machine} +\begin{document} +\begin{frame} + \frametitle{Frame 1} + \begin{itemize} +  \item<+-> \gls{svm} +  \item<+-> Stuff. + \end{itemize} +\end{frame} +\end{document} +</pre> +<!--l. 10120--><p class="nopar" > +</p><!--l. 10122--><p class="indent" > On the first overlay, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{svm}</span></span></span> produces “support vector machine (SVM)” and then unsets the <a href="#glo:firstuseflag">first use flag</a>. When the second overlay is processed, <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{svm}</span></span></span> now produces “SVM”, which is unlikely to be the desired effect. I don’t know anyway around this and I can only offer two suggestions. -</p><!--l. 11570--><p class="indent" > Firstly, unset all acronyms at the start of the document and explicitly use <span +</p><!--l. 10128--><p class="indent" > Firstly, unset all acronyms at the start of the document and explicitly use <span class="cmtt-10">\acrfull</span><a - id="dx1-153015"></a> when you want the full + id="dx1-142017"></a> when you want the full version to be displayed: </p> - <div class="verbatim" id="verbatim-354"> + <pre class="verbatim" id="verbatim-277"> \documentclass{beamer} - <br />\usepackage{glossaries} - <br />\newacronym{svm}{SVM}{support vector machine} - <br />\glsunsetall - <br />\begin{document} - <br />\begin{frame} - <br /> \frametitle{Frame 1} - <br /> \begin{itemize} - <br />  \item<+-> \acrfull{svm} - <br />  \item<+-> Stuff. - <br /> \end{itemize} - <br />\end{frame} - <br />\end{document} -</div> -<!--l. 11592--><p class="nopar" > -</p><!--l. 11594--><p class="indent" > Secondly, explicitly reset each acronym on first use: +\usepackage{glossaries} +\newacronym{svm}{SVM}{support vector machine} +\glsunsetall +\begin{document} +\begin{frame} + \frametitle{Frame 1} + \begin{itemize} +  \item<+-> \acrfull{svm} +  \item<+-> Stuff. + \end{itemize} +\end{frame} +\end{document} +</pre> +<!--l. 10150--><p class="nopar" > +</p><!--l. 10152--><p class="indent" > Secondly, explicitly reset each acronym on first use: </p> - <div class="verbatim" id="verbatim-355"> + <pre class="verbatim" id="verbatim-278"> \begin{frame} - <br /> \frametitle{Frame 1} - <br /> \begin{itemize} - <br />  \item<+-> \glsreset{svm}\gls{svm} - <br />  \item<+-> Stuff. - <br /> \end{itemize} - <br />\end{frame} -</div> -<!--l. 11604--><p class="nopar" > These are non-optimal, but the <span + \frametitle{Frame 1} + \begin{itemize} +  \item<+-> \glsreset{svm}\gls{svm} +  \item<+-> Stuff. + \end{itemize} +\end{frame} +</pre> +<!--l. 10162--><p class="nopar" > These are non-optimal, but the <span class="cmss-10">beamer</span><a - id="dx1-153016"></a> class is too complex for me to provide a programmatic solution. Other + id="dx1-142018"></a> class is too complex for me to provide a programmatic solution. Other potentially problematic environments are some <span class="cmss-10">tabular</span><a - id="dx1-153017"></a><a - id="dx1-153018"></a>-like environments (but not <span + id="dx1-142019"></a><a + id="dx1-142020"></a>-like environments (but not <span class="cmss-10">tabular</span><a - id="dx1-153019"></a><a - id="dx1-153020"></a> itself) that process the + id="dx1-142021"></a><a + id="dx1-142022"></a> itself) that process the contents in order to work out the column widths and then reprocess the contents to do the actual typesetting. -</p><!--l. 11612--><p class="indent" > The <span +</p><!--l. 10170--><p class="indent" > The <span class="cmss-10">amsmath</span><a - id="dx1-153021"></a> environments, such as <span + id="dx1-142023"></a> environments, such as <span class="cmss-10">align</span><a - id="dx1-153022"></a><a - id="dx1-153023"></a>, also process their contents multiple times, but the <span + id="dx1-142024"></a><a + id="dx1-142025"></a>, also process their contents multiple times, but the <span class="cmss-10">glossaries</span> package now checks for this. For <span class="cmss-10">tabularx</span><a - id="dx1-153024"></a>, you need to explicitly patch it by placing <span + id="dx1-142026"></a>, you need to explicitly patch it by placing <span class="cmtt-10">\glspatchtabularx </span>in the preamble (or anywhere before the problematic use of <span class="cmss-10">tabularx</span>). -</p><!--l. 11618--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you need to use commands like <span +</p><!--l. 10176--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you need to use commands like <span class="cmtt-10">\gls </span>in any problematic context that interferes with the <a href="#glo:firstuseflag">first use flag</a>, then you can try using the buffering system provided with <a @@ -23260,12 +21014,12 @@ class="cmss-10">glossaries-extra</span></a>. See the “First Use Flag” the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual. </div> -</p><!--l. 11623--><p class="noindent" > +</p><!--l. 10181--><p class="noindent" > </p> -<!--l. 11626--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">14.1 </span> <a +<!--l. 10184--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">7.1 </span> <a id="sec:enableentrycount"></a>Counting the Number of Times an Entry has been Used (First Use Flag Unset)</h3> -<!--l. 11629--><p class="noindent" >As from version 4.14, it’s now possible to keep track of how many times an entry is used. That is, +<!--l. 10187--><p class="noindent" >As from version 4.14, it’s now possible to keep track of how many times an entry is used. That is, how many times the <a href="#glo:firstuseflag">first use flag</a> is unset. Note that the supplemental <a href="#glo:glossaries-extra"><span @@ -23273,23 +21027,23 @@ class="cmss-10">glossaries-extra</span></a> package improves this function and also provides per-unit counting, which isn’t available with the <span class="cmss-10">glossaries</span> package. -</p><!--l. 11635--><p class="indent" > <div class="important" title="Important Note"> This function is disabled by default as it adds extra overhead to the document build time and +</p><!--l. 10193--><p class="indent" > <div class="important" title="Important Note"> This function is disabled by default as it adds extra overhead to the document build time and also switches <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-154001"></a> (and therefore <span + id="dx1-143001"></a> (and therefore <span class="cmtt-10">\newacronym</span><a - id="dx1-154002"></a>) into a preamble-only command. + id="dx1-143002"></a>) into a preamble-only command. </div> -</p><!--l. 11640--><p class="noindent" > -</p><!--l. 11642--><p class="indent" > To enable this function, use -</p><!--l. 11643--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154003"></a> <span +</p><!--l. 10198--><p class="noindent" > +</p><!--l. 10200--><p class="indent" > To enable this function, use +</p><!--l. 10201--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143003"></a> <span class="cmtt-10">\glsenableentrycount </span></div><hr> -</p><!--l. 11645--><p class="noindent" > +</p><!--l. 10203--><p class="noindent" > before defining your entries. This adds two extra (internal) fields to entries: <span class="cmtt-10">currcount </span>and <span class="cmtt-10">prevcount</span>. -</p><!--l. 11649--><p class="indent" > The <span +</p><!--l. 10207--><p class="indent" > The <span class="cmtt-10">currcount </span>field keeps track of how many times <span class="cmtt-10">\glsunset </span>is used within the document. A local unset (using <span @@ -23306,54 +21060,54 @@ class="cmtt-10">\glslocalreset </span>performs a local change). -</p><!--l. 11657--><p class="indent" > The <span +</p><!--l. 10215--><p class="indent" > The <span class="cmtt-10">prevcount </span>field stores the final value of the <span class="cmtt-10">currcount </span>field <span class="cmti-10">from the previous run</span>. This value is read from the <span class="cmtt-10">aux</span><a - id="dx1-154004"></a> file at the beginning of the <span + id="dx1-143004"></a> file at the beginning of the <span class="cmss-10">document</span><a - id="dx1-154005"></a><a - id="dx1-154006"></a> environment. -</p><!--l. 11662--><p class="indent" > You can access these fields using -</p><!--l. 11663--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154007"></a> <span + id="dx1-143005"></a><a + id="dx1-143006"></a> environment. +</p><!--l. 10220--><p class="indent" > You can access these fields using +</p><!--l. 10221--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143007"></a> <span class="cmtt-10">\glsentrycurrcount{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 11665--><p class="noindent" > +</p><!--l. 10223--><p class="noindent" > for the <span class="cmtt-10">currcount </span>field, and -</p><!--l. 11667--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154008"></a> <span +</p><!--l. 10225--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143008"></a> <span class="cmtt-10">\glsentryprevcount{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 11669--><p class="noindent" > +</p><!--l. 10227--><p class="noindent" > for the <span class="cmtt-10">prevcount </span>field. -</p><!--l. 11672--><p class="indent" > <div class="important" title="Important Note"> These commands are only defined if you have used <span +</p><!--l. 10230--><p class="indent" > <div class="important" title="Important Note"> These commands are only defined if you have used <span class="cmtt-10">\glsenableentrycount</span>. </div> -</p><!--l. 11674--><p class="noindent" > -</p><!--l. 11676--><p class="indent" > For example: +</p><!--l. 10232--><p class="noindent" > +</p><!--l. 10234--><p class="indent" > For example: </p> - <div class="verbatim" id="verbatim-356"> + <pre class="verbatim" id="verbatim-279"> \documentclass{article} - <br />\usepackage{glossaries} - <br />\makeglossaries - <br />\glsenableentrycount - <br />\newglossaryentry{apple}{name=apple,description={a fruit}} - <br />\begin{document} - <br />Total usage on previous run: \glsentryprevcount{apple}. - <br />\gls{apple}. \gls{apple}. \glsadd{apple}\glsentrytext{apple}. - <br />\glslink{apple}{apple}. \glsdisp{apple}{apple}. \Gls{apple}. - <br />Number of times apple has been used: \glsentrycurrcount{apple}. - <br />\end{document} -</div> -<!--l. 11694--><p class="nopar" > On the first LaTeX run, <span class="obeylines-h"><span class="verb"><span +\usepackage{glossaries} +\makeglossaries +\glsenableentrycount +\newglossaryentry{apple}{name=apple,description={a fruit}} +\begin{document} +Total usage on previous run: \glsentryprevcount{apple}. +\gls{apple}. \gls{apple}. \glsadd{apple}\glsentrytext{apple}. +\glslink{apple}{apple}. \glsdisp{apple}{apple}. \Gls{apple}. +Number of times apple has been used: \glsentrycurrcount{apple}. +\end{document} +</pre> +<!--l. 10252--><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 @@ -23374,11 +21128,11 @@ the value of the <span class="cmtt-10">currcount </span>field for the <span class="cmtt-10">apple </span>entry at the end of the document on the previous run. -</p><!--l. 11707--><p class="indent" > When you enable the entry count using <span +</p><!--l. 10265--><p class="indent" > When you enable the entry count using <span class="cmtt-10">\glsenableentrycount</span>, you also enable the following commands: -</p><!--l. 11709--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154009"></a> <span +</p><!--l. 10267--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143009"></a> <span class="cmtt-10">\cgls[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -23386,10 +21140,10 @@ 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. 11711--><p class="noindent" > +</p><!--l. 10269--><p class="noindent" > (no case-change, singular) -</p><!--l. 11713--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154010"></a> <span +</p><!--l. 10271--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143010"></a> <span class="cmtt-10">\cglspl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -23397,10 +21151,10 @@ 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. 11715--><p class="noindent" > +</p><!--l. 10273--><p class="noindent" > (no case-change, plural) -</p><!--l. 11717--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154011"></a> <span +</p><!--l. 10275--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143011"></a> <span class="cmtt-10">\cGls[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -23408,10 +21162,10 @@ 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. 11719--><p class="noindent" > +</p><!--l. 10277--><p class="noindent" > (first letter uppercase, singular), and -</p><!--l. 11721--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154012"></a> <span +</p><!--l. 10279--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143012"></a> <span class="cmtt-10">\cGlspl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -23419,14 +21173,14 @@ 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. 11723--><p class="noindent" > +</p><!--l. 10281--><p class="noindent" > (first letter uppercase, plural). These all have plus and starred variants like the analogous <span class="cmtt-10">\gls</span>, <span class="cmtt-10">\glspl</span>, <span class="cmtt-10">\Gls</span> and <span class="cmtt-10">\Glspl </span>commands. -</p><!--l. 11728--><p class="indent" > If you don’t use <span +</p><!--l. 10286--><p class="indent" > If you don’t use <span class="cmtt-10">\glsenableentrycount</span>, these commands behave like <span class="cmtt-10">\gls</span>, <span class="cmtt-10">\glspl</span>, <span @@ -23462,14 +21216,14 @@ class="cmtt-10">\cgls</span>, <span class="cmtt-10">\cglspl</span>, <span class="cmtt-10">\cGls </span>or <span class="cmtt-10">\cGlspl</span>. -<!--l. 11743--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154013"></a> <span +<!--l. 10301--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143013"></a> <span class="cmtt-10">\cglsformat{</span>⟨<span 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. 11745--><p class="noindent" > +</p><!--l. 10303--><p class="noindent" > This command is used by <span class="cmtt-10">\cgls </span>and defaults to </p><div class="alltt"> <div class="obeylines-v"> @@ -23489,14 +21243,14 @@ class="cmtt-10">}</span>⟨<span class="cmitt-10">insert</span>⟩ </div> </div> otherwise. -<!--l. 11757--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154014"></a> <span +<!--l. 10315--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143014"></a> <span class="cmtt-10">\cglsplformat{</span>⟨<span 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. 11759--><p class="noindent" > +</p><!--l. 10317--><p class="noindent" > This command is used by <span class="cmtt-10">\cglspl </span>and defaults to </p><div class="alltt"> <div class="obeylines-v"> @@ -23516,14 +21270,14 @@ class="cmtt-10">}</span>⟨<span class="cmitt-10">insert</span>⟩ </div> </div> otherwise. -<!--l. 11771--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154015"></a> <span +<!--l. 10329--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143015"></a> <span class="cmtt-10">\cGlsformat{</span>⟨<span 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. 11773--><p class="noindent" > +</p><!--l. 10331--><p class="noindent" > This command is used by <span class="cmtt-10">\cGls </span>and defaults to </p><div class="alltt"> <div class="obeylines-v"> @@ -23545,14 +21299,14 @@ class="cmtt-10">}</span>⟨<span class="cmitt-10">insert</span>⟩ </div> </div> otherwise. -<!--l. 11784--><p class="indent" > <hr><div title="Definition"><a - id="dx1-154016"></a> <span +<!--l. 10342--><p class="indent" > <hr><div title="Definition"><a + id="dx1-143016"></a> <span class="cmtt-10">\cGlsplformat{</span>⟨<span 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. 11786--><p class="noindent" > +</p><!--l. 10344--><p class="noindent" > This command is used by <span class="cmtt-10">\cGlspl </span>and defaults to </p><div class="alltt"> <div class="obeylines-v"> @@ -23572,15 +21326,15 @@ class="cmtt-10">}</span>⟨<span class="cmitt-10">insert</span>⟩ </div> </div> otherwise. -<!--l. 11797--><p class="indent" > This means that if the previous count for the given entry was 1, the entry won’t be hyperlinked with the +<!--l. 10355--><p class="indent" > This means that if the previous count for the given entry was 1, the entry won’t be hyperlinked with the <span class="cmtt-10">\cgls</span>-like commands and they won’t add a line to the external glossary file. If you haven’t used any of the -other commands that add information to glossary file (such as <span +other commands that add information to the glossary file (such as <span class="cmtt-10">\glsadd </span>or the <a 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">\glstext</span>-like</a> commands) +then the entry won’t appear in the glossary. +</p><!--l. 10362--><p class="indent" > Remember that since these commands use <span 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 @@ -23590,210 +21344,2714 @@ class="cmtt-10">makeglossaries</span>, class="cmtt-10">(pdf)latex</span>. <a id="sec:entrycount"></a> -</p><!--l. 11809--><p class="noindent" ><span -class="cmbx-12">Example 26</span><span +</p><!--l. 10367--><p class="noindent" ><span +class="cmbx-12">Example 19</span><span class="cmbx-12"> (Don’t index entries that are only used once)</span><a - id="x1-154018"></a> -</p><!--l. 11810--><p class="indent" > In this example, the abbreviations that have only been used once (on the previous run) only have their long + id="x1-143018"></a> +</p><!--l. 10368--><p class="indent" > In this example, the abbreviations that have only been used once (on the previous run) only have their long form shown with <span class="cmtt-10">\cgls</span>. </p> - <div class="verbatim" id="verbatim-357"> + <pre class="verbatim" id="verbatim-280"> \documentclass{article} - <br />\usepackage[colorlinks]{hyperref} - <br />\usepackage[acronym]{glossaries} - <br />\makeglossaries - <br />\glsenableentrycount - <br />\setacronymstyle{long-short} - <br />\newacronym{html}{HTML}{hypertext markup language} - <br />\newacronym{css}{CSS}{cascading style sheets} - <br />\newacronym{xml}{XML}{extensible markup language} - <br />\newacronym{sql}{SQL}{structured query language} - <br />\newacronym{rdbms}{RDBMS}{relational database management system} - <br />\newacronym{rdsms}{RDSMS}{relational data stream management system} - <br />\begin{document} - <br />These entries are only used once: \cgls{sql}, \cgls{rdbms}, - <br />\cgls{xml}. These entries are used multiple times: - <br />\cgls{html}, \cgls{html}, \cgls{css}, \cgls{css}, \cgls{css}, - <br />\cgls{rdsms}, \cgls{rdsms}. - <br />\printglossaries - <br />\end{document} -</div> -<!--l. 11838--><p class="nopar" > After a complete document build (<span +\usepackage[colorlinks]{hyperref} +\usepackage[acronym]{glossaries} +\makeglossaries +\glsenableentrycount +\setacronymstyle{long-short} +\newacronym{html}{HTML}{hypertext markup language} +\newacronym{css}{CSS}{cascading style sheets} +\newacronym{xml}{XML}{extensible markup language} +\newacronym{sql}{SQL}{structured query language} +\newacronym{rdbms}{RDBMS}{relational database management system} +\newacronym{rdsms}{RDSMS}{relational data stream management system} +\begin{document} +These entries are only used once: \cgls{sql}, \cgls{rdbms}, +\cgls{xml}. These entries are used multiple times: +\cgls{html}, \cgls{html}, \cgls{css}, \cgls{css}, \cgls{css}, +\cgls{rdsms}, \cgls{rdsms}. +\printglossaries +\end{document} +</pre> +<!--l. 10396--><p class="nopar" > After a complete document build (<span class="cmtt-10">latex</span>, <span class="cmtt-10">latex</span>, <span class="cmtt-10">makeglossaries</span>, <span -class="cmtt-10">latex</span>) the list of abbrevaitions only +class="cmtt-10">latex</span>) the list of abbreviations only includes the entries HTML, CSS and RDSMS. The entries SQL, RDBMS and XML only have their long forms displayed and don’t have a hyperlink. </p> <div class="center" > -<!--l. 11844--><p class="noindent" > -</p><!--l. 11844--><p class="noindent" >____________________________</p></div> -<!--l. 11846--><p class="indent" > Remember that if you don’t like typing <span +<!--l. 10402--><p class="noindent" > +</p><!--l. 10402--><p class="noindent" >____________________________</p></div> +<!--l. 10404--><p class="indent" > Remember that if you don’t like typing <span class="cmtt-10">\cgls </span>you can create a synonym. For example </p> - <div class="verbatim" id="verbatim-358"> + <pre class="verbatim" id="verbatim-281"> \let\ac\cgls -</div> -<!--l. 11850--><p class="nopar" > -</p><!--l. 11852--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a +</pre> +<!--l. 10408--><p class="nopar" > +</p><!--l. 10410--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-154019"></a></a> there’s an analogous record counting set of commands. See <a + id="dx1-143019"></a></a> there’s an analogous record counting set of commands. See <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> and <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-154020"></a></a> + id="dx1-143020"></a></a> manuals for further details. </div> -</p><!--l. 11855--><p class="noindent" > +</p><!--l. 10413--><p class="noindent" > </p> -<!--l. 11857--><p class="indent" > </div> -</p><!--l. 11857--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">15. <a - id="sec:styles"></a>Glossary Styles</h2> -</p><!--l. 11860--><p class="indent" > Glossaries vary from lists that simply contain a symbol with a terse description to lists of terms or phrases -with lengthy descriptions. Some glossaries may have terms with associated symbols. Some may have hierarchical -entries. There is therefore no single style that fits every type of glossary. The <span -class="cmss-10">glossaries </span>package comes with a -number of pre-defined glossary styles, described in <a -href="#sec:predefinedstyles">§15.1 </a><a -href="#sec:predefinedstyles">Predefined Styles<!--tex4ht:ref: sec:predefinedstyles --></a>. You can choose one of these that best -suits your type of glossary or, if none of them suit your document, you can defined your own style (see +<!--l. 10415--><p class="indent" > </div> +</p><!--l. 10415--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">8. <a + id="sec:printglossary"></a>Displaying a Glossary</h2> +</p><!--l. 10418--><p class="indent" > All defined glossaries may be displayed using: + </p><dl class="description"><dt class="description"> + <!--l. 10420--><p class="noindent" > +<a +href="#option1"><span +class="cmbx-10">Option</span><span +class="cmbx-10"> 1</span></a><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 10420--><p class="noindent" >(Must be used with <span +class="cmtt-10">\makenoidxglossaries</span><a + id="dx1-144001"></a> in the preamble.) + </p><!--l. 10422--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-144002"></a> <span +class="cmtt-10">\printnoidxglossaries </span></div><hr> + </p><!--l. 10424--><p class="noindent" > + which internally uses <span +class="cmtt-10">\printnoidxglossary </span>for each glossary. + </p></dd><dt class="description"> + <!--l. 10427--><p class="noindent" > +<span +class="cmbx-10">Options</span><span +class="cmbx-10"> </span><a +href="#option2"><span +class="cmbx-10">2</span></a> <span +class="cmbx-10">and</span><span +class="cmbx-10"> </span><a +href="#option3"><span +class="cmbx-10">3</span></a><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 10427--><p class="noindent" >(Must be used with <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-144003"></a> in the preamble.) + </p><!--l. 10429--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-144004"></a> <span +class="cmtt-10">\printglossaries </span></div><hr> + </p><!--l. 10431--><p class="noindent" > + which internally uses <span +class="cmtt-10">\printglossary </span>for each glossary. + </p></dd><dt class="description"> + <!--l. 10434--><p class="noindent" > +<span +class="cmbx-10">Options</span><span +class="cmbx-10"> </span><a +href="#option4"><span +class="cmbx-10">4</span></a><span +class="cmbx-10">–</span><a +href="#option6"><span +class="cmbx-10">6</span></a><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 10434--><p class="noindent" >(<a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> only) + </p><!--l. 10435--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-144005"></a> <span +class="cmtt-10">\printunsrtglossaries </span></div><hr> + </p><!--l. 10437--><p class="noindent" > + which internally uses <span +class="cmtt-10">\printunsrtglossary </span>for each glossary.</p></dd></dl> +<!--l. 10440--><p class="noindent" >These commands will display all the glossaries in the order in which they were defined. +</p><!--l. 10443--><p class="indent" > Note that, in the case of Options <a +href="#option2">2</a> and <a +href="#option3">3</a>, no glossaries will appear until you have either used the Perl script <a -href="#sec:newglossarystyle">§15.2 </a><a -href="#sec:newglossarystyle">Defining your own glossary style<!--tex4ht:ref: sec:newglossarystyle --></a>). There are some examples of glossary styles available at +href="#glo:makeglossaries"><span +class="cmtt-10">makeglossaries</span><a + id="dx1-144006"></a></a> or Lua script <a +href="#glo:makeglossaries-lite.lua"><span +class="cmtt-10">makeglossaries-lite</span><a + id="dx1-144007"></a></a> or have directly used <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-144008"></a></a> or <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-144009"></a></a> (as described +in <a +href="#sec:makeglossaries">§<span +class="cmbx-10">??</span>sec:makeglossaries </a><a +href="#sec:makeglossaries">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a>). In the case of <a +href="#option4">Option 4</a>, no glossary will +appear until you have used <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-144010"></a></a>. +</p><!--l. 10450--><p class="indent" > <div class="important" title="Important Note"> While the external files are missing, <span +class="cmtt-10">\printglossary </span>will just do <span +class="cmtt-10">\null</span><a + id="dx1-144011"></a> for each missing glossary to assist +dictionary style documents that just use <span +class="cmtt-10">\glsaddall </span>without inserting any text. This use of <span +class="cmtt-10">\null</span><a + id="dx1-144012"></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 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> +</p><!--l. 10461--><p class="noindent" > +</p><!--l. 10463--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you use <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>, it will insert a heading and boilerplate text when the external files are missing. +See the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> manual for further details. </div> + + +</p><!--l. 10467--><p class="noindent" > +</p><!--l. 10469--><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-144013"></a>, <span +class="cmtt-10">xindy</span><a + id="dx1-144014"></a> or +<span +class="cmtt-10">bib2gls</span><a + id="dx1-144015"></a> log files, as applicable, 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-144016"></a>s</a> +up-to-date. +</p><!--l. 10475--><p class="indent" > An individual glossary can be displayed using: + </p><dl class="description"><dt class="description"> + <!--l. 10477--><p class="noindent" > <a +href="#option1"><span +class="cmbx-10">Option</span><span +class="cmbx-10"> 1</span></a><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 10477--><p class="noindent" > + </p><!--l. 10478--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-144017"></a> <span +class="cmtt-10">\printnoidxglossary[</span>⟨<span +class="cmitt-10">options</span>⟩<span +class="cmtt-10">] </span></div><hr> + </p><!--l. 10480--><p class="noindent" > + (Must be used with <span +class="cmtt-10">\makenoidxglossaries</span><a + id="dx1-144018"></a> in the preamble.) + </p></dd><dt class="description"> + <!--l. 10483--><p class="noindent" > +<span +class="cmbx-10">Options</span><span +class="cmbx-10"> </span><a +href="#option2"><span +class="cmbx-10">2</span></a> <span +class="cmbx-10">and</span><span +class="cmbx-10"> </span><a +href="#option3"><span +class="cmbx-10">3</span></a><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 10483--><p class="noindent" > + </p><!--l. 10484--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-144019"></a> <span +class="cmtt-10">\printglossary[</span>⟨<span +class="cmitt-10">options</span>⟩<span +class="cmtt-10">] </span></div><hr> + </p><!--l. 10486--><p class="noindent" > + (Must be used with <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-144020"></a> in the preamble.) + </p></dd><dt class="description"> + <!--l. 10489--><p class="noindent" > +<span +class="cmbx-10">Options</span><span +class="cmbx-10"> </span><a +href="#option4"><span +class="cmbx-10">4</span></a><span +class="cmbx-10">–</span><a +href="#option6"><span +class="cmbx-10">6</span></a><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 10489--><p class="noindent" > + </p><!--l. 10491--><p class="noindent" ><hr><div title="Definition"><span id="textcolor292"><span +class="cmtt-10">\printunsrtglossary</span></span><a + id="dx1-144021"></a><span +class="cmtt-10">[</span>⟨<span +class="cmitt-10">options</span>⟩<span +class="cmtt-10">] </span></div><hr> + </p><!--l. 10492--><p class="noindent" > + (May be used with or without <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-144022"></a></a>.)</p></dd></dl> +<!--l. 10495--><p class="noindent" >where ⟨<span +class="cmti-10">options</span>⟩ is a ⟨<span +class="cmti-10">key</span>⟩=⟨<span +class="cmti-10">value</span>⟩ list of options. (Again, when the associated external file is missing, <span +class="cmtt-10">\null </span>is inserted +into the document.) +</p><!--l. 10499--><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 also provides +</p><!--l. 10502--><p class="indent" > <hr><div title="Definition"><span id="textcolor293"><span +class="cmtt-10">\printunsrtinnerglossary</span></span><a + id="dx1-144023"></a><span +class="cmtt-10">[</span>⟨<span +class="cmitt-10">options</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">pre code</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">post code</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 10504--><p class="noindent" > +which is designed for inner or nested glossaries. It allows many, but not all, of the options listed below. There’s +an example available in the gallery: <a +href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-inner" >Inner or Nested Glossaries</a>. See the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> package for further +details. </div> +</p><!--l. 10509--><p class="noindent" > +</p><!--l. 10511--><p class="indent" > The following keys are available in <span +class="cmtt-10">{</span>⟨<span +class="cmti-10">options</span>⟩<span +class="cmtt-10">}</span>: + </p><dl class="description"><dt class="description"> + + + <!--l. 10513--><p class="noindent" > +<span +class="cmtt-10">type</span><a + id="dx1-144024"></a> </p></dt><dd +class="description"> + <!--l. 10513--><p class="noindent" >The value of this key specifies which glossary to print. If omitted, the default glossary is assumed. For + example, to print the list of acronyms: + + +</p> + <pre class="verbatim" id="verbatim-282"> + \printglossary[type=\acronymtype] +</pre> + <!--l. 10518--><p class="nopar" > Note that you can’t display an ignored glossary, so don’t try setting <span +class="cmtt-10">type</span><a + id="dx1-144025"></a> to the name of a glossary + that was defined using <span +class="cmtt-10">\newignoredglossary</span><a + id="dx1-144026"></a>, described in <a +href="#sec:newglossary">§<span +class="cmbx-10">??</span>sec:newglossary </a><a +href="#sec:newglossary">Defining New + Glossaries<!--tex4ht:ref: sec:newglossary --></a>. (You can display an ignored glossary with <span id="textcolor294"><span +class="cmtt-10">\printunsrtglossary</span></span><a + id="dx1-144027"></a> provided by + <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>.) + </p></dd><dt class="description"> + <!--l. 10525--><p class="noindent" > +<span +class="cmtt-10">title</span><a + id="dx1-144028"></a> </p></dt><dd +class="description"> + <!--l. 10525--><p class="noindent" >This is the glossary’s title (overriding the title specified when the glossary was defined). + </p></dd><dt class="description"> + <!--l. 10529--><p class="noindent" > +<span +class="cmtt-10">toctitle</span><a + id="dx1-144029"></a> </p></dt><dd +class="description"> + <!--l. 10529--><p class="noindent" >This is the title to use for the table of contents (if the <span +class="cmss-10">toc</span><a + id="dx1-144030"></a> package option has been used). It may also + be used for the page header, depending on the page style. If omitted, the value of <span +class="cmtt-10">title</span><a + id="dx1-144031"></a> is + used. + </p></dd><dt class="description"> + <!--l. 10535--><p class="noindent" > +<span +class="cmtt-10">style</span><a + id="dx1-144032"></a> </p></dt><dd +class="description"> + <!--l. 10535--><p class="noindent" >This specifies which glossary style to use for this glossary, overriding the effect of the <span +class="cmss-10">style</span><a + id="dx1-144033"></a> package option + or <span +class="cmtt-10">\glossarystyle</span><a + id="dx1-144034"></a>. + </p></dd><dt class="description"> + <!--l. 10539--><p class="noindent" > +<span +class="cmtt-10">numberedsection</span><a + id="dx1-144035"></a> </p></dt><dd +class="description"> + <!--l. 10539--><p class="noindent" >This specifies whether to use a numbered section for this glossary, overriding the effect of the + <span +class="cmss-10">numberedsection</span><a + id="dx1-144036"></a> package option. This key has the same syntax as the <span +class="cmss-10">numberedsection</span><a + id="dx1-144037"></a> package option, + described in <a +href="#sec:pkgopts-sec">§<span +class="cmbx-10">??</span>sec:pkgopts-sec </a><a +href="#sec:pkgopts-sec">Sectioning, Headings and TOC Options<!--tex4ht:ref: sec:pkgopts-sec --></a>. + </p></dd><dt class="description"> + <!--l. 10545--><p class="noindent" > +<span +class="cmtt-10">nonumberlist</span><a + id="dx1-144038"></a> </p></dt><dd +class="description"> + <!--l. 10545--><p class="noindent" >This is a boolean key. If true (<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">nonumberlist=true</span></span></span>) the numberlist is suppressed for this glossary. If false + (<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">nonumberlist=false</span></span></span>) the numberlist is displayed for this glossary. + </p></dd><dt class="description"> + + + <!--l. 10550--><p class="noindent" > +<span +class="cmtt-10">nogroupskip</span><a + id="dx1-144039"></a> </p></dt><dd +class="description"> + <!--l. 10550--><p class="noindent" >This is a boolean key. If true the vertical gap between groups is suppressed for this glossary. + </p></dd><dt class="description"> + <!--l. 10554--><p class="noindent" > +<span +class="cmtt-10">nopostdot</span><a + id="dx1-144040"></a> </p></dt><dd +class="description"> + <!--l. 10554--><p class="noindent" >This is a boolean key. If true the full stop after the description is suppressed for this glossary. + </p></dd><dt class="description"> + <!--l. 10558--><p class="noindent" > +<span +class="cmtt-10">entrycounter</span><a + id="dx1-144041"></a> </p></dt><dd +class="description"> + <!--l. 10558--><p class="noindent" >This is a boolean key. Behaves similar to the package option of the same name. The corresponding package + option must be used to make <span +class="cmtt-10">\glsrefentry</span><a + id="dx1-144042"></a> work correctly. + </p></dd><dt class="description"> + <!--l. 10563--><p class="noindent" > +<span +class="cmtt-10">subentrycounter</span><a + id="dx1-144043"></a> </p></dt><dd +class="description"> + <!--l. 10563--><p class="noindent" >This is a boolean key. Behaves similar to the package option of the same name. If you want to set both + <span +class="cmtt-10">entrycounter</span><a + id="dx1-144044"></a> and <span +class="cmtt-10">subentrycounter</span><a + id="dx1-144045"></a>, make sure you specify <span +class="cmtt-10">entrycounter</span><a + id="dx1-144046"></a> first. The corresponding + package option must be used to make <span +class="cmtt-10">\glsrefentry</span><a + id="dx1-144047"></a> work correctly. + </p></dd><dt class="description"> + <!--l. 10570--><p class="noindent" > +<span +class="cmtt-10">sort</span><a + id="dx1-144048"></a> </p></dt><dd +class="description"> + <!--l. 10570--><p class="noindent" >This key is only available for <a +href="#option1">Option 1</a>. Possible values are: <span +class="cmtt-10">word </span>(word order), <span +class="cmtt-10">letter </span>(letter order), + <span +class="cmtt-10">standard </span>(word or letter ordering taken from the <span +class="cmss-10">order</span><a + id="dx1-144049"></a> package option), <span +class="cmtt-10">use </span>(order of use), <span +class="cmtt-10">def </span>(order of + definition) <span +class="cmtt-10">nocase </span>(case-insensitive) or <span +class="cmtt-10">case </span>(case-sensitive). Note that the word and letter comparisons + (that is, everything other than <span +class="cmtt-10">sort=use </span>and <span +class="cmtt-10">sort=def</span>) just use a simple character code comparison. For + a locale-sensitive sort, you must use either <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-144050"></a></a> (<a +href="#option3">Option 3</a>) or <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-144051"></a></a> (<a +href="#option4">Option 4</a>). Note that <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-144052"></a></a> + provides many other sort options. + </p><!--l. 10582--><p class="noindent" ><div class="important" title="Important Note"> If you use the <span +class="cmtt-10">use </span>or <span +class="cmtt-10">def </span>values make sure that you select a glossary style that doesn’t have a visual + indicator between groups, as the grouping no longer makes sense. Consider using the <span +class="cmss-10">nogroupskip</span><a + id="dx1-144053"></a> option. + </div> + </p><!--l. 10587--><p class="noindent" > + </p><!--l. 10590--><p class="noindent" >The + word + and + letter + order + sort + methods + use + + + <span +class="cmss-10">datatool</span><a + id="dx1-144054"></a>’s + <span +class="cmtt-10">\dtlwordindexcompare</span><a + id="dx1-144055"></a> + and + <span +class="cmtt-10">\dtlletterindexcompare</span><a + id="dx1-144056"></a> + handlers. + The + case-insensitive + sort + method + uses + <span +class="cmss-10">datatool</span><a + id="dx1-144057"></a>’s + <span +class="cmtt-10">\dtlicompare</span><a + id="dx1-144058"></a> + handler. + The + case-sensitive + sort + method + uses + <span +class="cmss-10">datatool</span><a + id="dx1-144059"></a>’s + <span +class="cmtt-10">\dtlcompare</span><a + id="dx1-144060"></a> + handler. + See + the + <span +class="cmss-10">datatool</span><a + id="dx1-144061"></a> + documentation + for + further + details. + </p><!--l. 10599--><p class="noindent" >If you don’t get an error with <span +class="cmtt-10">sort=use </span>and <span +class="cmtt-10">sort=def </span>but you do get an error with one of the other sort + options, then you probably need to use the <span +class="cmss-10">sanitizesort</span><span +class="cmtt-10">=</span><span +class="cmss-10">true</span><a + id="dx1-144062"></a> package option or make sure none of the + entries have fragile commands in their <span +class="cmtt-10">sort</span><a + id="dx1-144063"></a> field. + </p></dd><dt class="description"> + <!--l. 10605--><p class="noindent" > +<a + id="dx1-144064"></a><span id="textcolor295"><span +class="cmtt-10">label={</span>⟨<span +class="cmitt-10">label</span>⟩<span +class="cmtt-10">}</span></span> </p></dt><dd +class="description"> + <!--l. 10605--><p class="noindent" >This key is only available with <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> and labels the glossary with <span +class="cmtt-10">\label{</span>⟨<span +class="cmti-10">label</span>⟩<span +class="cmtt-10">}</span>. This is an + alternative to the package option <span +class="cmss-10">numberedsection</span><span +class="cmtt-10">=</span><span +class="cmss-10">autolabel</span><a + id="dx1-144065"></a> + </p></dd><dt class="description"> + <!--l. 10610--><p class="noindent" > +<a + id="dx1-144066"></a><span id="textcolor296"><span +class="cmtt-10">target={</span>⟨<span +class="cmitt-10">boolean</span>⟩<span +class="cmtt-10">}</span></span> </p></dt><dd +class="description"> + <!--l. 10610--><p class="noindent" >This boolean key is only available with <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> and can be used to switch off the + automatic hypertarget for each entry. (This refers to the target used by commands like <span +class="cmtt-10">\gls </span>and + <span +class="cmtt-10">\glslink</span>.) + </p><!--l. 10615--><p class="noindent" >This option is useful with <span id="textcolor297"><span +class="cmtt-10">\printunsrtglossary</span></span><a + id="dx1-144067"></a> as it allows the same list (or sub-list) of entries to be + + + displayed multiple times without causing duplicate hypertarget names. + </p></dd><dt class="description"> + <!--l. 10619--><p class="noindent" > +<a + id="dx1-144068"></a><span id="textcolor298"><span +class="cmtt-10">prefix={</span>⟨<span +class="cmitt-10">prefix</span>⟩<span +class="cmtt-10">}</span></span> </p></dt><dd +class="description"> + <!--l. 10619--><p class="noindent" >This key is only available with <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> and provides another way of avoiding duplicate hypertarget + names. In this case it uses a different prefix for those names. This locally redefines <span +class="cmtt-10">\glolinkprefix</span><a + id="dx1-144069"></a> but + note this will also affect the target for any entry referenced within the glossary with commands like <span +class="cmtt-10">\gls</span>, + <span +class="cmtt-10">\glslink </span>or <span +class="cmtt-10">\glshypertarget</span>. + </p></dd><dt class="description"> + <!--l. 10627--><p class="noindent" > +<a + id="dx1-144070"></a><span id="textcolor299"><span +class="cmtt-10">targetnameprefix={</span>⟨<span +class="cmitt-10">prefix</span>⟩<span +class="cmtt-10">}</span></span> </p></dt><dd +class="description"> + <!--l. 10627--><p class="noindent" >This key is only available with <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>. This is similar to the <span +class="cmss-10">prefix </span>option, but it alters the prefix of + the hypertarget anchors without changing <span +class="cmtt-10">\glslinkprefix</span><a + id="dx1-144071"></a> (so it won’t change the hyperlinks for any + entries referenced in the glossary). + </p></dd><dt class="description"> + <!--l. 10634--><p class="noindent" > +<a + id="dx1-144072"></a><span id="textcolor300"><span +class="cmtt-10">groups={</span>⟨<span +class="cmitt-10">boolean</span>⟩<span +class="cmtt-10">}</span></span> </p></dt><dd +class="description"> + <!--l. 10634--><p class="noindent" >This boolean key is only available with <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> and, if true, will attempt to perform group + formation. See the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> manual for further details. + </p></dd><dt class="description"> + <!--l. 10639--><p class="noindent" > +<a + id="dx1-144073"></a><span id="textcolor301"><span +class="cmtt-10">leveloffset={</span>⟨<span +class="cmitt-10">n</span>⟩<span +class="cmtt-10">}</span></span> </p></dt><dd +class="description"> + <!--l. 10639--><p class="noindent" >This key is only available with <span id="textcolor302"><span +class="cmtt-10">\printunsrtglossary</span></span><a + id="dx1-144074"></a>. It can be used to locally adjust the hierarchical + level used by the glossary style. See the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> manual for further details.</p></dd></dl> +<!--l. 10646--><p class="indent" > By default, the glossary is started either by <span +class="cmtt-10">\chapter*</span><a + id="dx1-144075"></a> or by <span +class="cmtt-10">\section*</span><a + id="dx1-144076"></a>, depending on whether or not +<span +class="cmtt-10">\chapter</span><a + id="dx1-144077"></a> is defined. This can be overridden by the <span +class="cmss-10">section</span><a + id="dx1-144078"></a> package option or the <span +class="cmtt-10">\setglossarysection</span><a + id="dx1-144079"></a> +command. Numbered sectional units can be obtained using the <span +class="cmss-10">numberedsection</span><a + id="dx1-144080"></a> package option. Each glossary +sets the page header via the command +</p><!--l. 10652--><p class="indent" > <hr><div title="Definition"><a + id="dx1-144081"></a> <span +class="cmtt-10">\glsglossarymark</span><a + id="dx1-144082"></a><span +class="cmtt-10">{</span>⟨<span +class="cmitt-10">title</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 10654--><p class="noindent" > +If this mechanism is unsuitable for your chosen class file or page style package, you will need to redefine +<span +class="cmtt-10">\glsglossarymark</span><a + id="dx1-144083"></a>. Further information about these options and commands is given in <a +href="#sec:pkgopts-sec">§<span +class="cmbx-10">??</span>sec:pkgopts-sec +</a><a +href="#sec:pkgopts-sec">Sectioning, Headings and TOC Options<!--tex4ht:ref: sec:pkgopts-sec --></a>. +</p><!--l. 10660--><p class="indent" > Information can be added to the start of the glossary (after the title and before the main body of the +glossary) by redefining +</p><!--l. 10662--><p class="indent" > <hr><div title="Definition"><a + id="dx1-144084"></a> <span +class="cmtt-10">\glossarypreamble </span></div><hr> +</p><!--l. 10664--><p class="noindent" > +For example: + + +</p> + <pre class="verbatim" id="verbatim-283"> +\renewcommand{\glossarypreamble}{Numbers in italic +indicate primary definitions.} +</pre> +<!--l. 10669--><p class="nopar" > This needs to be done before the glossary is displayed. +</p><!--l. 10672--><p class="indent" > If you want a different preamble per glossary you can use +</p><!--l. 10673--><p class="indent" > <hr><div title="Definition"><a + id="dx1-144085"></a> <span +class="cmtt-10">\setglossarypreamble[</span>⟨<span +class="cmitt-10">type</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">preamble text</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 10675--><p class="noindent" > +If ⟨<span +class="cmti-10">type</span>⟩ is omitted, <span +class="cmtt-10">\glsdefaulttype </span>is used. +</p><!--l. 10678--><p class="indent" > For example: + + +</p> + <pre class="verbatim" id="verbatim-284"> +\setglossarypreamble{Numbers in italic +indicate primary definitions.} +</pre> +<!--l. 10682--><p class="nopar" > This will print the given preamble text for the main glossary, but not have any preamble text for any other +glossaries. +</p><!--l. 10686--><p class="indent" > There is an analogous command to <span +class="cmtt-10">\glossarypreamble </span>called +</p><!--l. 10687--><p class="indent" > <hr><div title="Definition"><a + id="dx1-144086"></a> <span +class="cmtt-10">\glossarypostamble </span></div><hr> +</p><!--l. 10689--><p class="noindent" > +which is placed at the end of each glossary. +<a + id="ex:twocolumn"></a> +</p><!--l. 10692--><p class="noindent" ><span +class="cmbx-12">Example 20</span><span +class="cmbx-12"> (Switch to Two Column Mode for Glossary)</span><a + id="x1-144088"></a> +</p><!--l. 10693--><p class="indent" > Suppose you are using the <span +class="cmss-10">superheaderborder</span><a + id="dx1-144089"></a> +style<span class="footnote-mark"><a +href="#fn1x8" id="fn1x8-bk"><sup class="textsuperscript">8.1</sup></a></span><a + id="x1-144090f1"></a>, +and you want the glossary to be in two columns, but after the glossary you want to switch back to one column +mode, you could do: + + +</p> + <pre class="verbatim" id="verbatim-285"> +\renewcommand*{\glossarysection}[2][]{% +  \twocolumn[{\chapter*{#2}}]% +  \setlength\glsdescwidth{0.6\linewidth}% +  \glsglossarymark{\glossarytoctitle}% +} +\renewcommand*{\glossarypostamble}{\onecolumn} +</pre> +<!--l. 10707--><p class="nopar" > +</p> +<div class="center" +> +<!--l. 10709--><p class="noindent" > +</p><!--l. 10709--><p class="noindent" >____________________________</p></div> +<!--l. 10711--><p class="indent" > Within each glossary, each entry name is formatted according to +</p><!--l. 10712--><p class="indent" > <hr><div title="Definition"><a + id="dx1-144094"></a> <span +class="cmtt-10">\glsnamefont{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 10714--><p class="noindent" > +which takes one argument: the entry name. This command is always used regardless of the glossary style. By +default, <span +class="cmtt-10">\glsnamefont </span>simply displays its argument in whatever the surrounding font happens to be. +This means that in the list-like glossary styles (defined in the <span +class="cmss-10">glossary-list</span><a + id="dx1-144095"></a> style file) the name will +appear in bold, since the name is placed in the optional argument of <span +class="cmtt-10">\item</span>, whereas in the tabular +styles (defined in the <span +class="cmss-10">glossary-long</span><a + id="dx1-144096"></a> and <span +class="cmss-10">glossary-super</span><a + id="dx1-144097"></a> style files) the name will appear in the normal +font. The hierarchical glossary styles (defined in the <span +class="cmss-10">glossary-tree</span><a + id="dx1-144098"></a> style file) also set the name in +bold. +</p><!--l. 10727--><p class="indent" > If you want to change the font for the description, or if you only want to change the name +font for some types of entries but not others, you might want to consider using the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> +package. +<a + id="ex:glsnamefont"></a> +</p><!--l. 10733--><p class="noindent" ><span +class="cmbx-12">Example 21</span><span +class="cmbx-12"> (Changing the Font Used to Display Entry Names in the</span> +<span +class="cmbx-12">Glossary)</span><a + id="x1-144100"></a> +</p><!--l. 10734--><p class="indent" > Suppose you want all the entry names to appear in medium weight small caps in your glossaries, then you +can do: + + +</p> + <pre class="verbatim" id="verbatim-286"> +\renewcommand{\glsnamefont}[1]{\textsc{\mdseries #1}} +</pre> +<!--l. 10738--><p class="nopar" > </p> +<div class="center" +> +<!--l. 10739--><p class="noindent" > +</p><!--l. 10739--><p class="noindent" >____________________________</p></div> +<!--l. 10741--><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 provides additional hooks that can be used to make other minor adjustments. +</div> +</p><!--l. 10744--><p class="noindent" > +</p><!--l. 10746--><p class="indent" > The letter group titles (which are displayed for styles like <span +class="cmss-10">indexgroup</span><a + id="dx1-144101"></a>) can be changed either by redefining the +corresponding <span +class="cmtt-10">\</span>⟨<span +class="cmitt-10">group-label</span>⟩<span +class="cmtt-10">groupname </span>commands, such as <span +class="cmtt-10">\glssymbolsgroupname</span><a + id="dx1-144102"></a>, (see <a +href="#sec:fixednames">§<span +class="cmbx-10">??</span>sec:fixednames +</a><a +href="#sec:fixednames">Changing the Fixed Names<!--tex4ht:ref: sec:fixednames --></a>) or by using the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> commands <span id="textcolor303"><span +class="cmtt-10">\glsxtrsetgrouptitle</span></span><a + id="dx1-144103"></a> and +<span id="textcolor304"><span +class="cmtt-10">\glsxtrlocalsetgrouptitle</span></span><a + id="dx1-144104"></a>. The ⟨<span +class="cmti-10">group-label</span>⟩ is typically obtained by the <a +href="#glo:indexingapp">indexing application</a>. + + +</p> +<!--l. 10754--><p class="indent" > </div> +</p><!--l. 10754--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">9. <a + id="sec:newglossary"></a>Defining New Glossaries</h2> +</p><!--l. 10757--><p class="indent" > A new glossary can be defined using: +</p><!--l. 10758--><p class="indent" > <hr><div title="Definition"><a + id="dx1-145001"></a> <span +class="cmtt-10">\newglossary[</span>⟨<span +class="cmitt-10">log-ext</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">in-ext</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">out-ext</span>⟩<span +class="cmtt-10">}</span> +<span +class="cmtt-10">{</span>⟨<span +class="cmitt-10">title</span>⟩<span +class="cmtt-10">}[</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">] </span></div><hr> +</p><!--l. 10760--><p class="noindent" > +where ⟨<span +class="cmti-10">name</span>⟩ is the label to assign to this glossary. The arguments ⟨<span +class="cmti-10">in-ext</span>⟩ and ⟨<span +class="cmti-10">out-ext</span>⟩ specify the extensions to +give to the input and output files for that glossary, ⟨<span +class="cmti-10">title</span>⟩ is the default title for this new glossary and the final +optional argument ⟨<span +class="cmti-10">counter</span>⟩ specifies which counter to use for the associated <a +href="#glo:numberlist">number list<a + id="dx1-145002"></a>s</a> (see also +<a +href="#sec:numberlists">§<span +class="cmbx-10">??</span>sec:numberlists </a><a +href="#sec:numberlists">Number Lists<!--tex4ht:ref: sec:numberlists --></a>). The first optional argument specifies the extension for the <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-145003"></a></a> +(<a +href="#option2">Option 2</a>) or <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-145004"></a></a> (<a +href="#option3">Option 3</a>) transcript file (this information is only used by <a +href="#glo:makeglossaries"><span +class="cmtt-10">makeglossaries</span><a + id="dx1-145005"></a></a> which picks +up the information from the auxiliary file). If you use <a +href="#option1">Option 1</a>, the ⟨<span +class="cmti-10">log-ext</span>⟩, ⟨<span +class="cmti-10">in-ext</span>⟩ and ⟨<span +class="cmti-10">out-ext</span>⟩ arguments are +ignored. +</p><!--l. 10774--><p class="indent" > <div class="important" title="Important Note"> The glossary label ⟨<span +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-145006"></a>s</a> for standard LaTeX). +</div> +</p><!--l. 10779--><p class="noindent" > +</p><!--l. 10781--><p class="indent" > There is also a starred version (new to v4.08): +</p><!--l. 10782--><p class="indent" > <hr><div title="Definition"><a + id="dx1-145007"></a> <span +class="cmtt-10">\newglossary*{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">title</span>⟩<span +class="cmtt-10">}[</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">] </span></div><hr> +</p><!--l. 10784--><p class="noindent" > +which is equivalent to </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">\newglossary[</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">-glg]{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">}</span><span +class="cmsy-10">{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">-gls</span><span +class="cmsy-10">}{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">-glo</span><span +class="cmsy-10">}</span><span +class="cmtt-10">{</span>⟨<span +class="cmitt-10">title</span>⟩<span +class="cmtt-10">}[</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">]</span> +</div> +</div> or you can also use: +<!--l. 10790--><p class="indent" > <hr><div title="Definition"><a + id="dx1-145008"></a> <span +class="cmtt-10">\altnewglossary{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">title</span>⟩<span +class="cmtt-10">}[</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">] </span></div><hr> +</p><!--l. 10792--><p class="noindent" > +which is equivalent to </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">\newglossary[</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">-glg]{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">}</span><span +class="cmsy-10">{</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">-gls</span><span +class="cmsy-10">}{</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">-glo</span><span +class="cmsy-10">}</span><span +class="cmtt-10">{</span>⟨<span +class="cmitt-10">title</span>⟩<span +class="cmtt-10">}[</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">]</span> +</div> +</div> +<!--l. 10798--><p class="indent" > It may be that you have some terms that are so common that they don’t need to be listed. In this case, you +can define a special type of glossary that doesn’t create any associated files. This is referred to as an “ignored +glossary” and it’s ignored by commands that iterate over all the glossaries, such as <span +class="cmtt-10">\printglossaries</span><a + id="dx1-145009"></a>. To +define an ignored glossary, use +</p><!--l. 10804--><p class="indent" > <hr><div title="Definition"><a + id="dx1-145010"></a> <span +class="cmtt-10">\newignoredglossary{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 10806--><p class="noindent" > +where ⟨<span +class="cmti-10">name</span>⟩ is the name of the glossary (as above). This glossary type will automatically be added to the +<span +class="cmss-10">nohypertypes</span><a + id="dx1-145011"></a> list, since there are no hypertargets for the entries in an ignored glossary. (The sample file +<a +href="#ex:sample-entryfmt"><span +class="cmtt-10">sample-entryfmt.tex</span></a> defines an ignored glossary.) + + +</p><!--l. 10813--><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 provides a starred version of this command that allows hyperlinks (since +ignored glossaries can be useful with <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-145012"></a></a>). There is also an analogous <span id="textcolor305"><span +class="cmtt-10">\provideignoredglossary</span></span><a + id="dx1-145013"></a> +command. </div> +</p><!--l. 10818--><p class="noindent" > +</p><!--l. 10820--><p class="indent" > You can test if a glossary is an ignored one using: +</p><!--l. 10821--><p class="indent" > <hr><div title="Definition"><a + id="dx1-145014"></a> <span +class="cmtt-10">\ifignoredglossary{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">}{</span>⟨<span +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. 10823--><p class="noindent" > +This does ⟨<span +class="cmti-10">true</span>⟩ if ⟨<span +class="cmti-10">name</span>⟩ was defined as an ignored glossary, otherwise it does ⟨<span +class="cmti-10">false</span>⟩. +</p><!--l. 10827--><p class="indent" > Note that the main (default) glossary is automatically created as: + + +</p> + <pre class="verbatim" id="verbatim-287"> +\newglossary{main}{gls}{glo}{\glossaryname} +</pre> +<!--l. 10830--><p class="nopar" > so it can be identified by the label <span +class="cmtt-10">main </span>(unless the <span +class="cmss-10">nomain</span><a + id="dx1-145015"></a> package option is used). Using the <span +class="cmss-10">acronym</span><a + id="dx1-145016"></a> package +option is equivalent to: + + +</p> + <pre class="verbatim" id="verbatim-288"> +\newglossary[alg]{acronym}{acr}{acn}{\acronymname} +</pre> +<!--l. 10836--><p class="nopar" > so it can be identified by the label <span +class="cmtt-10">acronym</span>. If you are not sure whether the <span +class="cmss-10">acronym</span><a + id="dx1-145017"></a> option has been used, you +can identify the list of acronyms by the command <a + id="dx1-145018"></a><span +class="cmtt-10">\acronymtype </span>which is set to <span +class="cmtt-10">acronym</span>, if the <span +class="cmss-10">acronym</span><a + id="dx1-145019"></a> +option has been used, otherwise it is set to <span +class="cmtt-10">main</span>. Note that if you are using the main glossary +as your list of acronyms, you need to declare it as a list of acronyms using the package option +<span +class="cmss-10">acronymlists</span><a + id="dx1-145020"></a>. +</p><!--l. 10847--><p class="indent" > The <span +class="cmss-10">symbols</span><a + id="dx1-145021"></a> package option creates a new glossary with the label <span +class="cmtt-10">symbols </span>using: + + +</p> + <pre class="verbatim" id="verbatim-289"> +\newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname} +</pre> +<!--l. 10851--><p class="nopar" > The <span +class="cmss-10">numbers</span><a + id="dx1-145022"></a> package option creates a new glossary with the label <span +class="cmtt-10">numbers </span>using: + + +</p> + <pre class="verbatim" id="verbatim-290"> +\newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname} +</pre> +<!--l. 10856--><p class="nopar" > The <span +class="cmss-10">index</span><a + id="dx1-145023"></a> package option creates a new glossary with the label <span +class="cmtt-10">index </span>using: + + +</p> + <pre class="verbatim" id="verbatim-291"> +\newglossary[ilg]{index}{ind}{idx}{\indexname} +</pre> +<!--l. 10861--><p class="nopar" > +</p><!--l. 10863--><p class="indent" > <div class="important" title="Important Note"> Options <a +href="#option2">2</a> and <a +href="#option3">3</a>: all glossaries must be defined before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-145024"></a> to ensure that the relevant output +files are opened. +</p><!--l. 10867--><p class="indent" > See <a +href="#sec:fixednames">§<span +class="cmbx-10">??</span>sec:fixednames </a><a +href="#sec:fixednames">Changing the Fixed Names<!--tex4ht:ref: sec:fixednames --></a> if you want to redefine <span +class="cmtt-10">\glossaryname</span>, especially if you +are using <span +class="cmss-10">babel</span><a + id="dx1-145025"></a> or <span +class="cmss-10">translator</span><a + id="dx1-145026"></a>. (Similarly for <span +class="cmtt-10">\glssymbolsgroupname </span>and <span +class="cmtt-10">\glsnumbersgroupname</span>.) If you +want to redefine <span +class="cmtt-10">\indexname</span><a + id="dx1-145027"></a>, just follow the advice in <a +href="https://texfaq.org/FAQ-fixnam" >How to change LaTeX’s “fixed names”</a>. +</div> +</p><!--l. 10874--><p class="noindent" > + + +</p> +<!--l. 10876--><p class="indent" > </div> +</p><!--l. 10876--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">10. <a + id="sec:glsadd"></a>Adding an Entry to the Glossary Without Generating Text</h2> +</p><!--l. 10879--><p class="indent" > It is possible to add a line to the glossary file without generating any text at that point in the document +using: +</p><!--l. 10881--><p class="indent" > <hr><div title="Definition"><a + id="dx1-146001"></a> <span +class="cmtt-10">\glsadd[</span>⟨<span +class="cmitt-10">options</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">label</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 10883--><p class="noindent" > +This is similar to the <a +href="#sec:glstext-like"><span +class="cmtt-10">\glstext</span>-like</a> commands, only it doesn’t produce any text (so therefore, there is no <span +class="cmtt-10">hyper</span><a + id="dx1-146002"></a> +key available in ⟨<span +class="cmti-10">options</span>⟩ but all the other options that can be used with <a +href="#sec:glstext-like"><span +class="cmtt-10">\glstext</span>-like</a> commands can be passed +to <span +class="cmtt-10">\glsadd</span>). +</p><!--l. 10889--><p class="indent" > This command essentially works like <span +class="cmtt-10">\index </span>(provided by the LaTeX kernel) in that it doesn’t produce text +but it does add a line with an associated location to the glossary file. In this case, the “encap” (the page +encapsulator information) is specified with the <span +class="cmtt-10">format</span><a + id="dx1-146003"></a> key. (See <a +href="#sec:encap">§<span +class="cmbx-10">??</span>sec:encap </a><a +href="#sec:encap">Encap Values (Location +Formats)<!--tex4ht:ref: sec:encap --></a>.) +</p><!--l. 10895--><p class="indent" > For example, to add a page range to the glossary number list for the entry whose label is given by +<span +class="cmtt-10">set</span>: + + +</p> + <pre class="verbatim" id="verbatim-292"> +\glsadd[format=(]{set} +Lots of text about sets spanning many pages. +\glsadd[format=)]{set} +</pre> +<!--l. 10901--><p class="nopar" > +</p><!--l. 10903--><p class="indent" > To add all entries that have been defined, use: +</p><!--l. 10904--><p class="indent" > <hr><div title="Definition"><a + id="dx1-146004"></a> <span +class="cmtt-10">\glsaddall[</span>⟨<span +class="cmitt-10">options</span>⟩<span +class="cmtt-10">] </span></div><hr> +</p><!--l. 10906--><p class="noindent" > +The optional argument is the same as for <span +class="cmtt-10">\glsadd</span>, except there is also a key <span +class="cmtt-10">types</span><a + id="dx1-146005"></a> which can be +used to specify which glossaries to use. This should be a comma-separated list. For example, if +you only want to add all the entries belonging to the list of acronyms (specified by the glossary +type <span +class="cmtt-10">\acronymtype</span><a + id="dx1-146006"></a>) and a list of notation (specified by the glossary type <span +class="cmtt-10">notation</span>) then you can +do: + + +</p> + <pre class="verbatim" id="verbatim-293"> +\glsaddall[types={\acronymtype,notation}] +</pre> +<!--l. 10917--><p class="nopar" > +</p><!--l. 10919--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you are using <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-146007"></a></a> with <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>, you can’t use <span +class="cmtt-10">\glsaddall</span>. Instead use the <span +class="cmss-10">selection=all</span> +resource option to select all entries in the given <span +class="cmtt-10">bib</span><a + id="dx1-146008"></a> files. </div> +</p><!--l. 10923--><p class="noindent" > +</p><!--l. 10925--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\glsadd </span>and <span +class="cmtt-10">\glsaddall </span>add the current location to the <a +href="#glo:numberlist">number list<a + id="dx1-146009"></a></a>. In the case of <span +class="cmtt-10">\glsaddall</span>, +all entries in the glossary will have the same location in the number list. If you want to use <span +class="cmtt-10">\glsaddall</span>, it’s +best to suppress the number list with the <span +class="cmss-10">nonumberlist</span><a + id="dx1-146010"></a> package option. (See sections <a +href="#sec:pkgopts-printglos">2.3<!--tex4ht:ref: sec:pkgopts-printglos --></a> and <a +href="#sec:numberlists">12<!--tex4ht:ref: sec:numberlists --></a>.) +</div> +</p><!--l. 10932--><p class="noindent" > +</p><!--l. 10934--><p class="indent" > There is now a variation of <span +class="cmtt-10">\glsaddall </span>that skips any entries that have been <a +href="#glo:firstuseflag">marked as used</a>: +</p><!--l. 10936--><p class="indent" > <hr><div title="Definition"><a + id="dx1-146011"></a> <span +class="cmtt-10">\glsaddallunused[</span>⟨<span +class="cmitt-10">list</span>⟩<span +class="cmtt-10">] </span></div><hr> +</p><!--l. 10938--><p class="noindent" > +This command uses <span +class="cmtt-10">\glsadd[format=glsignore] </span>which will ignore this location in the number list. (See +<a +href="#sec:encap">§<span +class="cmbx-10">??</span>sec:encap </a><a +href="#sec:encap">Encap Values (Location Formats)<!--tex4ht:ref: sec:encap --></a>.) The optional argument ⟨<span +class="cmti-10">list</span>⟩ is a comma-separated list of +glossary types. If omitted, it defaults to the list of all defined glossaries. +</p><!--l. 10945--><p class="indent" > <div class="important" title="Important Note"> If you want to use <span +class="cmtt-10">\glsaddallunused</span>, it’s best to place the command at the end of the document to ensure +that all the commands you intend to use have already been used. Otherwise you could end up with a spurious +comma or dash in the location list. </div> +</p><!--l. 10950--><p class="noindent" > +</p><!--l. 10952--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> and <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-146012"></a></a>, <span +class="cmtt-10">glsignore </span>indicates an “ignored location” which influences selection but +isn’t added to the location list. In this case, if you use <span +class="cmss-10">selection=all </span>then only those entries that have been +explicitly indexed in the document will have location lists. The other entries that were selected as a result of +<span +class="cmss-10">selection=all </span>won’t have location lists. </div> +</p><!--l. 10960--><p class="noindent" > +</p><!--l. 10962--><p class="indent" > Base <span +class="cmss-10">glossaries</span><a + id="dx1-146013"></a> package only: + + +</p> + <pre class="verbatim" id="verbatim-294"> +\documentclass{article} +\usepackage{glossaries} +\makeglossaries +\newglossaryentry{cat}{name={cat},description={feline}} +\newglossaryentry{dog}{name={dog},description={canine}} +\begin{document} +\gls{cat}. +\printglossaries +\glsaddallunused % <- make sure dog is also listed +\end{document} +</pre> +<!--l. 10974--><p class="nopar" > Corresponding <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> and <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-146014"></a></a> document code: + + +</p> + <pre class="verbatim" id="verbatim-295"> +\documentclass{article} +\usepackage[record]{glossaries-extra} +\GlsXtrLoadResources[src={entries},selection=all] +\begin{document} +\gls{cat}. +\printunsrtglossaries +\end{document} +</pre> +<!--l. 10984--><p class="nopar" > With the file <span +class="cmtt-10">entries.bib</span>: + + +</p> + <pre class="verbatim" id="verbatim-296"> +@entry{cat,name={cat},description={feline}} +@entry{dog,name={dog},description={canine}} +</pre> +<!--l. 10989--><p class="nopar" > +<a + id="ex:dual"></a> +</p><!--l. 10991--><p class="noindent" ><span +class="cmbx-12">Example 22</span><span +class="cmbx-12"> (Dual Entries)</span><a + id="x1-146016"></a> +</p><!--l. 10992--><p class="indent" > The example file <a +href="#ex:sample-dual"><span +class="cmtt-10">sample-dual.tex</span></a> makes use of <span +class="cmtt-10">\glsadd </span>to allow for an entry that should appear both in +the main glossary and in the list of acronyms. This example sets up the list of acronyms using the <span +class="cmss-10">acronym</span><a + id="dx1-146017"></a> +package option: + + +</p> + <pre class="verbatim" id="verbatim-297"> +\usepackage[acronym]{glossaries} +</pre> +<!--l. 10998--><p class="nopar" > A new command is then defined to make it easier to define dual entries: + + +</p> + <pre class="verbatim" id="verbatim-298"> +\newcommand*{\newdualentry}[5][]{% +  \newglossaryentry{main-#2}{name={#4},% +  text={#3\glsadd{#2}},% +  description={#5},% +  #1 +  }% +  \newacronym{#2}{#3\glsadd{main-#2}}{#4}% +} +</pre> +<!--l. 11010--><p class="nopar" > This has the following syntax: </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">\newdualentry</span><a + id="dx1-146018"></a><span +class="cmtt-10">[</span>⟨<span +class="cmitt-10">options</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">label</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">abbrv</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">long</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">description</span>⟩<span +class="cmtt-10">}</span> +</div> +</div> You can then define a new dual entry: + + + <pre class="verbatim" id="verbatim-299"> +\newdualentry{svm}% label +  {SVM}% abbreviation +  {support vector machine}% long form +  {Statistical pattern recognition technique}% description +</pre> +<!--l. 11021--><p class="nopar" > Now you can reference the acronym with <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\gls{svm}</span></span></span> or you can reference the entry in the main glossary with +<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\gls{main-svm}</span></span></span>. +</p><!--l. 11025--><p class="indent" > This is just an example. In general, think twice before you add this kind of duplication. If all information +(short, long and description) can be provided in a single list, it’s redundant to provide a second list unless any of +the short forms start with a different letter to the associated long form, which may make it harder to +lookup. +</p><!--l. 11032--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> Note that with <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-146019"></a></a>, there are special dual entry types that implement this behaviour. That is, if an +entry is referenced then its corresponding dual entry will automatically be selected as well. So there +is less need for <span +class="cmtt-10">\glsadd </span>with <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-146020"></a></a>. (Although it can still be useful, as shown in <a +href="#option6">Option 6</a>.) +</div> +</p><!--l. 11038--><p class="noindent" > +</p> +<div class="center" +> +<!--l. 11039--><p class="noindent" > +</p><!--l. 11039--><p class="noindent" >____________________________</p></div> + + +<!--l. 11041--><p class="indent" > </div> +</p><!--l. 11041--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">11. <a + id="sec:crossref"></a>Cross-Referencing Entries</h2> +</p><!--l. 11044--><p class="indent" > <div class="important" title="Important Note"> You must use <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-147001"></a> (Options <a +href="#option2">2</a> or <a +href="#option3">3</a>) or <span +class="cmtt-10">\makenoidxglossaries</span><a + id="dx1-147002"></a> (<a +href="#option1">Option 1</a>) <span +class="cmti-10">before</span> +defining any terms that cross-reference entries. If any of the terms that you have cross-referenced +don’t appear in the glossary, check that you have put <span +class="cmtt-10">\makeglossaries</span>/<span +class="cmtt-10">\makenoidxglossaries</span> +before all entry definitions. The <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> package provides better cross-reference handling. +</div> +</p><!--l. 11052--><p class="noindent" > +</p><!--l. 11054--><p class="indent" > There are several ways of cross-referencing entries in the glossary: + </p><ol class="enumerate1" > +<li + class="enumerate" id="x1-147004x1"> + <!--l. 11058--><p class="noindent" >You can use commands such as <span +class="cmtt-10">\gls</span><a + id="dx1-147005"></a> in the entries description. For example: + + +</p> + <pre class="verbatim" id="verbatim-300"> + \newglossaryentry{apple}{name=apple, + description={firm, round fruit. See also \gls{pear}}} +</pre> + <!--l. 11063--><p class="nopar" > Note that with this method, if you don’t use the cross-referenced term in the main part of the document, + you will need two runs of <a +href="#glo:makeglossaries"><span +class="cmtt-10">makeglossaries</span><a + id="dx1-147006"></a></a>: + </p><!--l. 11067--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + <br />pdflatex filename + <br />makeglossaries filename + <br />pdflatex filename + <br />makeglossaries filename + <br />pdflatex filename + <br /></pre><spacer type=vertical size=10> + <br /></span> + This is because the <span +class="cmtt-10">\gls </span>in the description won’t be detected until the glossary has been created (unless + the description is used elsewhere in the document with <span +class="cmtt-10">\glsentrydesc</span><a + id="dx1-147007"></a>). Take care not to use <span +class="cmtt-10">\glsdesc</span><a + id="dx1-147008"></a> + (or <span +class="cmtt-10">\Glsdesc</span><a + id="dx1-147009"></a>) in this case as it will cause a nested link. + </p></li> +<li + class="enumerate" id="x1-147011x2"> + <!--l. 11080--><p class="noindent" >As described in <a +href="#sec:newglosentry">§<span +class="cmbx-10">??</span>sec:newglosentry </a><a +href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>, you can use the <span +class="cmtt-10">see</span><a + id="dx1-147012"></a> key when you define + the entry. For example: + + +</p> + <pre class="verbatim" id="verbatim-301"> + \newglossaryentry{MaclaurinSeries}{name={Maclaurin + series}, + description={Series expansion}, + see={TaylorsTheorem}} +</pre> + <!--l. 11087--><p class="nopar" > Note that in this case, the entry with the <span +class="cmtt-10">see</span><a + id="dx1-147013"></a> key will automatically be added to the glossary, but the + cross-referenced entry won’t. You therefore need to ensure that you use the cross-referenced term with the + commands described in <a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink </a><a +href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> or <a +href="#sec:glsadd">§<span +class="cmbx-10">??</span>sec:glsadd </a><a +href="#sec:glsadd">Adding an Entry to the + Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a>. + </p><!--l. 11094--><p class="noindent" >The “see” tag is produce using <span +class="cmtt-10">\seename</span><a + id="dx1-147014"></a>, but can be overridden in specific instances using square brackets + at the start of the <span +class="cmtt-10">see</span><a + id="dx1-147015"></a> value. For example: + + +</p> + <pre class="verbatim" id="verbatim-302"> + \newglossaryentry{MaclaurinSeries}{name={Maclaurin + series}, + description={Series expansion}, + see=[see also]{TaylorsTheorem}} +</pre> + <!--l. 11102--><p class="nopar" > Take care if you want to use the optional argument of commands such as <span +class="cmtt-10">\newacronym</span><a + id="dx1-147016"></a> or <span +class="cmtt-10">\newterm</span><a + id="dx1-147017"></a> as + the value will need to be grouped. For example: + + +</p> + <pre class="verbatim" id="verbatim-303"> + \newterm{seal} + \newterm[see={[see also]seal}]{sea lion} +</pre> + <!--l. 11109--><p class="nopar" > Similarly if the value contains a list. For example: + + +</p> + <pre class="verbatim" id="verbatim-304"> + \glossaryentry{lemon}{ +   name={lemon}, +   description={Yellow citrus fruit} + } + \glossaryentry{lime} + { +   name={lime}, +   description={Green citrus fruit} + } + \glossaryentry{citrus} + { +   name={citrus}, +   description={Plant in the Rutaceae family}, +   see={lemon,lime} + } +</pre> + <!--l. 11127--><p class="nopar" > + </p></li> +<li + class="enumerate" id="x1-147019x3"> + <!--l. 11129--><p class="noindent" >After you have defined the entry, use + </p><!--l. 11130--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-147020"></a> <span +class="cmtt-10">\glssee[</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">label</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">xr label list</span>⟩<span +class="cmtt-10">} </span></div><hr> + </p><!--l. 11132--><p class="noindent" > + where ⟨<span +class="cmti-10">xr label list</span>⟩ is a comma-separated list of entry labels to be cross-referenced, ⟨<span +class="cmti-10">label</span>⟩ is the label of the + entry doing the cross-referencing and ⟨<span +class="cmti-10">tag</span>⟩ is the “see” tag. (The default value of ⟨<span +class="cmti-10">tag</span>⟩ is <span +class="cmtt-10">\seename</span><a + id="dx1-147021"></a>.) For + example: + + +</p> + <pre class="verbatim" id="verbatim-305"> + \glssee[see also]{series}{FourierSeries,TaylorsTheorem} +</pre> + <!--l. 11140--><p class="nopar" > Note that this automatically adds the entry given by ⟨<span +class="cmti-10">label</span>⟩ to the glossary but doesn’t add the + cross-referenced entries (specified by ⟨<span +class="cmti-10">xr label list</span>⟩) to the glossary.</p></li></ol> +<!--l. 11146--><p class="indent" > In both cases 2 and 3 above, the cross-referenced information appears in the <a +href="#glo:numberlist">number list<a + id="dx1-147022"></a></a>, whereas in case 1, +the cross-referenced information appears in the description. (See the <a +href="#ex:sample-crossref"><span +class="cmtt-10">sample-crossref.tex</span></a> example file that +comes with this package.) This means that in cases 2 and 3, the cross-referencing information won’t appear if +you have suppressed the number list<a + id="dx1-147023"></a>. In this case, you will need to activate the number list<a + id="dx1-147024"></a> for +the given entries using <span +class="cmtt-10">nonumberlist=false</span><a + id="dx1-147025"></a>. Alternatively, if you just use the <span +class="cmtt-10">see</span><a + id="dx1-147026"></a> key instead +of <span +class="cmtt-10">\glssee</span><a + id="dx1-147027"></a>, you can automatically activate the number list<a + id="dx1-147028"></a> using the <span +class="cmss-10">seeautonumberlist</span><a + id="dx1-147029"></a> package +option. +</p><!--l. 11158--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-147030"></a></a> provides much better support for cross-references. See, for example, <a +href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-xr" >Gallery: Cross-References +(bib2gls)</a>. </div> +</p><!--l. 11162--><p class="noindent" > +</p> +<!--l. 11164--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">11.1 </span> <a + id="sec:customxr"></a>Customising Cross-reference Text</h3> +<!--l. 11167--><p class="noindent" >When you use either the <span +class="cmtt-10">see</span><a + id="dx1-148001"></a> key or the command <span +class="cmtt-10">\glssee</span>, the cross-referencing information will be typeset in +the glossary according to: +</p><!--l. 11170--><p class="indent" > <hr><div title="Definition"><a + id="dx1-148002"></a> <span +class="cmtt-10">\glsseeformat[</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">label-list</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">location</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11172--><p class="noindent" > +The default definition of <span +class="cmtt-10">\glsseeformat </span>is: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="cmtt-10">\emph{</span>⟨<span +class="cmti-10">tag</span>⟩<span +class="cmtt-10">} \glsseelist{</span>⟨<span +class="cmti-10">label-list</span>⟩<span +class="cmtt-10">}</span> + <br /><spacer type=vertical size=10></span> +Note that the location is always ignored.<span class="footnote-mark"><a +href="#fn1x11" id="fn1x11-bk"><sup class="textsuperscript">11.1</sup></a></span><a + id="x1-148003f1"></a> +For example, if you want the tag to appear in bold, you can +do:<span class="footnote-mark"><a +href="#fn2x11" id="fn2x11-bk"><sup class="textsuperscript">11.2</sup></a></span><a + id="x1-148005f2"></a> + + +</p> + <pre class="verbatim" id="verbatim-306"> +\renewcommand*{\glsseeformat}[3][\seename]{\textbf{#1} + \glsseelist{#2}} +</pre> +<!--l. 11188--><p class="nopar" > +</p><!--l. 11191--><p class="indent" > The list of labels is dealt with by <span +class="cmtt-10">\glsseelist</span>, which iterates through the list and typesets each entry in +the label. The entries are separated by +</p><!--l. 11194--><p class="indent" > <hr><div title="Definition"><a + id="dx1-148008"></a> <span +class="cmtt-10">\glsseesep </span></div><hr> +</p><!--l. 11196--><p class="noindent" > +or (for the last pair) +</p><!--l. 11198--><p class="indent" > <hr><div title="Definition"><a + id="dx1-148009"></a> <span +class="cmtt-10">\glsseelastsep </span></div><hr> +</p><!--l. 11200--><p class="noindent" > +These default to “<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">,\space</span></span></span>” and “<span +class="cmtt-10">\space\andname</span><a + id="dx1-148010"></a><span +class="cmtt-10">\space</span>” respectively. The list entry text is displayed +using: +</p><!--l. 11204--><p class="indent" > <hr><div title="Definition"><a + id="dx1-148011"></a> <span +class="cmtt-10">\glsseeitemformat{</span>⟨<span +class="cmitt-10">label</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11206--><p class="noindent" > +This defaults to <span +class="cmtt-10">\glsentrytext</span><a + id="dx1-148012"></a><span +class="cmtt-10">{</span>⟨<span +class="cmti-10">label</span>⟩<span +class="cmtt-10">}</span>.<span class="footnote-mark"><a +href="#fn3x11" id="fn3x11-bk"><sup class="textsuperscript">11.3</sup></a></span><a + id="x1-148013f3"></a> +For example, to make the cross-referenced list use small caps: + + +</p> + <pre class="verbatim" id="verbatim-307"> +\renewcommand{\glsseeitemformat}[1]{% +  \textsc{\glsentrytext{#1}}} +</pre> +<!--l. 11214--><p class="nopar" > +</p><!--l. 11215--><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 redefines <span +class="cmtt-10">\glsseeitemformat </span>and additionally provides <span id="textcolor306"><span +class="cmtt-10">\glsxtrhiername</span></span><a + id="dx1-148016"></a> +which can be used as an alternative to <span +class="cmtt-10">\glsentrytext</span>. See the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> manual for further details. +</div> +</p><!--l. 11220--><p class="noindent" > +</p><!--l. 11222--><p class="indent" > <div class="important" title="Important Note"> You can use <span +class="cmtt-10">\glsseeformat</span><a + id="dx1-148017"></a> and <span +class="cmtt-10">\glsseelist</span><a + id="dx1-148018"></a> in the main body of the text, but they won’t automatically +add the cross-referenced entries to the glossary. If you want them added with that location, you can +do: + + +</p> + <pre class="verbatim" id="verbatim-308"> +Some information (see also +\glsseelist{FourierSeries,TaylorsTheorem}% +\glsadd{FourierSeries}\glsadd{TaylorsTheorem}). +</pre> +<!--l. 11231--><p class="nopar" > </div> +</p><!--l. 11232--><p class="noindent" > + + +</p> +<!--l. 11234--><p class="indent" > </div> +</p><!--l. 11234--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">12. <a + id="sec:numberlists"></a>Number Lists</h2> +</p><!--l. 11237--><p class="indent" > Each entry in the glossary has an associated <a +href="#glo:numberlist">number list<a + id="dx1-149001"></a></a>. By default, these numbers refer to the pages on +which that entry has been indexed (using any of the commands described in <a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink </a><a +href="#sec:glslink">Links to Glossary +Entries<!--tex4ht:ref: sec:glslink --></a> and <a +href="#sec:glsadd">§<span +class="cmbx-10">??</span>sec:glsadd </a><a +href="#sec:glsadd">Adding an Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a>). The number list +can be suppressed using the <span +class="cmss-10">nonumberlist</span><a + id="dx1-149002"></a> package option, or an alternative counter can be set as +the default using the <span +class="cmss-10">counter</span><a + id="dx1-149003"></a> package option. The number list is also referred to as the location +list<a + id="dx1-149004"></a>. +</p><!--l. 11246--><p class="indent" > <a +href="#glo:numberlist">Number list<a + id="dx1-149005"></a>s</a> are more common with indexes rather than glossaries (although you can use the <span +class="cmss-10">glossaries</span> +package for indexes as well). However, the <span +class="cmss-10">glossaries </span>package makes use of <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-149006"></a></a> or <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-149007"></a></a> to hierarchically +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 + id="dx1-149008"></a>, the locations must still be provided and acceptable to the <a +href="#glo:indexingapp">indexing +application</a> or they will cause an error during the indexing stage, which will interrupt the document build. +However, if you’re not interested in the locations, each entry only needs to be indexed once, so consider using +<span +class="cmss-10">indexonlyfirst</span><a + id="dx1-149009"></a>, which can improve the document build time by only indexing the <a +href="#glo:firstuse">first use</a> of each +term. +</p><!--l. 11261--><p class="indent" > The <span +class="cmtt-10">\glsaddall</span><a + id="dx1-149010"></a> command (see <a +href="#sec:glsadd">§<span +class="cmbx-10">??</span>sec:glsadd </a><a +href="#sec:glsadd">Adding an Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a>), +which is used to automatically index all entries, iterates over all defined entries and does <span +class="cmtt-10">\glsadd{</span>⟨<span +class="cmti-10">label</span>⟩<span +class="cmtt-10">} </span>for +each entry (where ⟨<span +class="cmti-10">label</span>⟩ is that entry’s label). This means that <span +class="cmtt-10">\glsaddall </span>automatically adds +the same location to every entry’s <a +href="#glo:numberlist">number list<a + id="dx1-149011"></a></a>, which looks weird if the number list<a + id="dx1-149012"></a> hasn’t been +suppressed. +</p><!--l. 11268--><p class="indent" > With <a +href="#option4">Option 4</a>, the indexing is performed by <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-149013"></a></a>, which was specifically designed for the <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a> +package. So it will allow any location format, and its <span +class="cmtt-10">selection=all </span>option will select all entries without +adding an unwanted location to the <a +href="#glo:numberlist">number list<a + id="dx1-149014"></a></a>. If <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-149015"></a></a> can deduce a numerical value for a location, it will +attempt to form a range over consecutive locations, otherwise it won’t try to form a range and the location will +just form an individual item in the list. <a +href="#option1">Option 1</a> also allows any location but it doesn’t form +ranges. +</p> +<!--l. 11278--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">12.1 </span> <a + id="sec:encap"></a>Encap Values (Location Formats)</h3> +<!--l. 11281--><p class="noindent" >Each location in the <a +href="#glo:numberlist">number list<a + id="dx1-150001"></a></a> is encapsulated with a command formed from the <span +class="cmti-10">encap</span><a + id="dx1-150002"></a> value. By default this +is the <span +class="cmtt-10">\glsnumberformat</span><a + id="dx1-150003"></a> command, which corresponds to the encap <span +class="cmtt-10">glsnumberformat</span>, but this may be +overridden using the <span +class="cmtt-10">format</span><a + id="dx1-150004"></a> key in the optional argument to commands like <span +class="cmtt-10">\gls</span>. (See <a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink </a><a +href="#sec:glslink">Links to +Glossary Entries<!--tex4ht:ref: sec:glslink --></a>.) For example, you may want the location to appear in bold to indicate the principle use of a +term or symbol. If the encap starts with an open parenthesis <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">(</span></span></span> this signifies the start of a range and if the encap +starts with close parenthesis <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">)</span></span></span> this signifies the end of a range. These must always occur in matching +pairs. +</p><!--l. 11293--><p class="indent" > The <span +class="cmss-10">glossaries </span>package provides the command: +</p><!--l. 11294--><p class="indent" > <hr><div title="Definition"> <span +class="cmtt-10">\glsignore{</span>⟨<span +class="cmti-10">text</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11296--><p class="noindent" > +which ignores its argument. This is the format used by <span +class="cmtt-10">\glsaddallunused </span>to suppress the location, +which works fine as long as no other locations are added to the <a +href="#glo:numberlist">number list<a + id="dx1-150005"></a></a>. For example, if you use +<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\gls{sample}</span></span></span> on page 2 then reset the <a +href="#glo:firstuseflag">first use flag</a> and then use <span +class="cmtt-10">\glsaddallunused </span>on page 10, the +<a +href="#glo:numberlist">number list<a + id="dx1-150006"></a></a> for <span +class="cmtt-10">sample </span>will be <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">2,</span><span +class="cmtt-10"> \glsignore{10}</span></span></span> which will result in “2, ” which has a spurious + + +comma. +</p><!--l. 11305--><p class="indent" > This isn’t a problem with <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-150007"></a></a> because you would need to use <span +class="cmtt-10">selection=all </span>instead of +<span +class="cmtt-10">\glsaddallunused</span>, but even if you explicitly had used <span +class="cmtt-10">glsignore</span>, for example, <span +class="cmtt-10">\gls[format=glsignore]</span> +<span +class="cmtt-10">{</span>⟨<span +class="cmti-10">label</span>⟩<span +class="cmtt-10">}</span>, then <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-150008"></a></a> will recognise <span +class="cmtt-10">glsignore </span>as a special encap indicating an ignored location, so it will +select the entry but not add that location to the <a +href="#glo:numberlist">number list<a + id="dx1-150009"></a></a>. It’s a problem for all the other indexing +options. +</p><!--l. 11314--><p class="indent" > Complications can arise if you use different encap values for the same location. For example, suppose on +page 10 you have both the default <span +class="cmtt-10">glsnumberformat </span>and <span +class="cmtt-10">textbf </span>encaps. While it may seem apparent that +<span +class="cmtt-10">textbf </span>should override <span +class="cmtt-10">glsnumberformat </span>in this situation, the <a +href="#glo:indexingapp">indexing application</a> may not know it. This is +therefore something you need to be careful about if you use the <span +class="cmtt-10">format</span><a + id="dx1-150010"></a> key or if you use a command that +implicitly sets it. +</p><!--l. 11323--><p class="indent" > In the case of <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-150011"></a></a>, it only accepts one encap (according to the order of precedence given in the <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-150012"></a></a> +module) and discards the others for identical locations (for the same entry). This can cause a problem if a +discarded location forms the start or end of a range. +</p><!--l. 11328--><p class="indent" > In the case of <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-150013"></a></a>, it accepts different encaps for the same location, but warns about it. This leads to +a <a +href="#glo:numberlist">number list<a + id="dx1-150014"></a></a> with the same location repeated in different formats. If you use the <a +href="#glo:makeglossaries"><span +class="cmtt-10">makeglossaries</span><a + id="dx1-150015"></a></a> Perl script +with <a +href="#option2">Option 2</a> it will detect <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-150016"></a></a>’s warning and attempt to fix the problem, ensuring that the +<span +class="cmtt-10">glsnumberformat </span>encap always has the least precedence unless it includes a range identifier. Other conflicting +encaps will have the last one override earlier ones for the same location with range identifiers taking +priority. +</p><!--l. 11338--><p class="indent" > No discard occurs with <a +href="#option1">Option 1</a> so again you get the same location repeated in different formats. With +<a +href="#option4">Option 4</a>, <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-150017"></a></a> will discard according to order of precedence, giving priority to start and end range encaps. +(See the <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-150018"></a></a> manual for further details.) +</p><!--l. 11343--><p class="noindent" > +</p> +<!--l. 11343--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">12.2 </span> <a + id="sec:locationsyntax"></a>Locations</h3> +<!--l. 11346--><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 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-151001"></a> file. The write +operation is deferred to avoid the problems associated with TeX’s asynchronous output routine. (See, for +example, <a +href="https://texfaq.org/FAQ-oddpage" >Finding if you’re on an odd or an even page</a> for more details on this issue.) Unfortunately +Options <a +href="#option2">2</a> and <a +href="#option3">3</a> are far more problematic and need some complex code to deal with awkward +locations. +</p><!--l. 11357--><p class="indent" > If you know that your locations will always expand to a format acceptable to your chosen <a +href="#glo:indexingapp">indexing +application</a> then use the package option <span +class="cmss-10">esclocations</span><span +class="cmtt-10">=</span><span +class="cmss-10">false</span><a + id="dx1-151002"></a> to bypass this operation. This setting only affects +Options <a +href="#option2">2</a> and <a +href="#option3">3</a> as the problem doesn’t arise with the other indexing options. +</p><!--l. 11363--><p class="indent" > Both <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-151003"></a></a> and <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-151004"></a></a> are fussy about the syntax of the locations. In the case of <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-151005"></a></a>, only the +numbering system obtained with <span +class="cmtt-10">\arabic</span>, <span +class="cmtt-10">\roman</span>, <span +class="cmtt-10">\Roman</span>, <span +class="cmtt-10">\alph </span>and <span +class="cmtt-10">\Alph </span>or composites formed from them +with the same separator (set with <span +class="cmtt-10">\glsSetCompositor{</span>⟨<span +class="cmti-10">char</span>⟩<span +class="cmtt-10">}</span>) are accepted. (<a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-151006"></a></a> won’t accept an empty +location.) In the case of <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-151007"></a></a>, you can define your own location classes, but if the location contains a robust +command then the leading backslash must be escaped. The <span +class="cmss-10">glossaries</span><a + id="dx1-151008"></a> package tries to do this, but it’s caught +between two conflicting requirements: + </p><ol class="enumerate1" > + + +<li + class="enumerate" id="x1-151010x1"> + <!--l. 11374--><p class="noindent" >The location must be fully expanded before <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\</span></span></span> can be converted to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\\</span></span></span> (there’s no point converting + <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\thepage</span></span></span> to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\\thepage</span></span></span>); + </p></li> +<li + class="enumerate" id="x1-151012x2"> + <!--l. 11377--><p class="noindent" >The page number can’t be expanded until the deferred write operation (so <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\c@page</span></span></span> mustn’t + expand in the previous step but <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\the\c@page</span></span></span> mustn’t be converted to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\\the\\c@page</span></span></span> and + <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\number\c@page</span></span></span> mustn’t be converted to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\\number\\c@page</span></span></span> etc).</p></li></ol> +<!--l. 11383--><p class="noindent" >There’s a certain amount of trickery needed to deal with this conflict and the code requires the location to be in a +form that doesn’t embed the counter’s internal register in commands like <span +class="cmtt-10">\value</span>. For example, +suppose you have a robust command called <span +class="cmtt-10">\tallynum </span>that takes a number as the argument and an +expandable command called <span +class="cmtt-10">\tally </span>that converts a counter name into the associated register or +number to pass to <span +class="cmtt-10">\tallynum</span>. Let’s suppose that this command is used to represent the page +number: + + +</p> + <pre class="verbatim" id="verbatim-309"> +\renewcommand{\thepage}{\tally{page}} +</pre> +<!--l. 11393--><p class="nopar" > Now let’s suppose that a term is indexed at the beginning of page 2 at the end of a paragraph that started on +page 1. With <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-151013"></a></a>, the location <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\tally{page}</span></span></span> needs to be written to the file as <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\\tallynum{2}</span></span></span>. If it’s written +as <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\tallynum{2}</span></span></span> then <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-151014"></a></a> will interpret <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\t</span></span></span> as the character “t” (which means the location would appear as +“tallynum2”). So <span +class="cmss-10">glossaries</span><a + id="dx1-151015"></a> tries to expand <span +class="cmtt-10">\thepage </span>without expanding <span +class="cmtt-10">\c@page </span>and then escapes all the +backslashes, except for the page counter’s internal command. The following definitions of <span +class="cmtt-10">\tally </span>will work: +</p> + <ul class="itemize1"> + <li class="itemize"> + <!--l. 11405--><p class="noindent" >In the following, <span +class="cmtt-10">\arabic </span>works as its internal command <span +class="cmtt-10">\c@arabic </span>is temporarily redefined to check for + <span +class="cmtt-10">\c@page</span>: + + +</p> + <pre class="verbatim" id="verbatim-310"> + \newcommand{\tally}[1]{\tallynum{\arabic{#1}}} +</pre> + <!--l. 11409--><p class="nopar" > + </p></li> + <li class="itemize"> + <!--l. 11411--><p class="noindent" >The form <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\expandafter\the\csname</span><span +class="cmtt-10"> c@</span></span></span>⟨<span +class="cmti-10">counter</span>⟩<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\endcsname</span></span></span> also works (provided <span +class="cmtt-10">\the </span>is allowed to be + temporarily redefined, see below): + + +</p> + <pre class="verbatim" id="verbatim-311"> + \newcommand{\tally}[1]{% +  \tallynum{\expandafter\the\csname c@#1\endcsname}} +</pre> + <!--l. 11417--><p class="nopar" > + </p></li> + <li class="itemize"> + <!--l. 11419--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\expandafter\the\value</span></span></span><span +class="cmtt-10">{</span>⟨<span +class="cmti-10">counter</span>⟩<span +class="cmtt-10">} </span>now also works (with the same condition as above): + + +</p> + <pre class="verbatim" id="verbatim-312"> + \newcommand{\tally}[1]{\tallynum{\expandafter\the\value{#1}}} +</pre> + <!--l. 11423--><p class="nopar" > + </p></li> + <li class="itemize"> + <!--l. 11425--><p class="noindent" >Another variation that will work: + + +</p> + <pre class="verbatim" id="verbatim-313"> + \newcommand{\tally}[1]{% +   \expandafter\tallynum\expandafter{\the\csname c@#1\endcsname}} +</pre> + <!--l. 11429--><p class="nopar" > + </p></li> + <li class="itemize"> + <!--l. 11431--><p class="noindent" >and also: + + +</p> + <pre class="verbatim" id="verbatim-314"> + \newcommand{\tally}[1]{\tallynum{\the\csname c@#1\endcsname}} +</pre> + <!--l. 11434--><p class="nopar" ></p></li></ul> +<!--l. 11436--><p class="noindent" >The following <span +class="cmti-10">don’t work</span>: </p> + <ul class="itemize1"> + <li class="itemize"> + <!--l. 11438--><p class="noindent" >This definition leads to the premature expansion of <span +class="cmtt-10">\c@page </span>to “1” when, in this case, it should be + “2”: + + +</p> + <pre class="verbatim" id="verbatim-315"> + \newcommand{\tally}[1]{\tallynum{\the\value{#1}}} +</pre> + <!--l. 11442--><p class="nopar" > + </p></li> + <li class="itemize"> + <!--l. 11443--><p class="noindent" >This definition leads to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\\c@page</span></span></span> in the glossary file: + + +</p> + <pre class="verbatim" id="verbatim-316"> + \newcommand{\tally}[1]{\tallynum{\csname c@#1\endcsname}} +</pre> + <!--l. 11446--><p class="nopar" ></p></li></ul> +<!--l. 11448--><p class="noindent" >If you have a numbering system where <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\</span></span></span>⟨<span +class="cmti-10">cs name</span>⟩<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">{page}</span></span></span> expands to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\</span></span></span>⟨<span +class="cmti-10">internal cs name</span>⟩<span +class="cmtt-10">\c@page </span>(for example, if +<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\tally{page}</span></span></span> expands to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\tallynum\c@page</span></span></span>) then you need to use: +</p><!--l. 11453--><p class="indent" > <hr><div title="Definition"><a + id="dx1-151016"></a> <span +class="cmtt-10">\glsaddprotectedpagefmt{</span>⟨<span +class="cmitt-10">internal cs name</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11455--><p class="noindent" > +Note that the backslash must be omitted from ⟨<span +class="cmti-10">internal cs name</span>⟩ and the corresponding command must be able +to process a count register as the (sole) argument. +</p><!--l. 11460--><p class="indent" > For example, suppose you have a style <span +class="cmtt-10">samplenum </span>that is implemented as follows: + + +</p> + <pre class="verbatim" id="verbatim-317"> + \newcommand*{\samplenum}[1]{% +   \expandafter\@samplenum\csname c@#1\endcsname} + \newcommand*{\@samplenum}[1]{\two@digits{#1}} +</pre> +<!--l. 11467--><p class="nopar" > (That is, it displays the value of the counter as a two-digit number.) Then to ensure the location is correct for +entries in page-spanning paragraphs, you need to do: + + +</p> + <pre class="verbatim" id="verbatim-318"> +\glsaddprotectedpagefmt{@samplenum} +</pre> +<!--l. 11473--><p class="nopar" > (If you are using a different counter for the location, such as <span +class="cmtt-10">section </span>or <span +class="cmtt-10">equation</span>, you don’t need to worry +about this provided the inner command is expandable.) +</p><!--l. 11478--><p class="indent" > If the inner macro (as given by <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\</span></span></span>⟨<span +class="cmti-10">internal cs name</span>⟩) contains non-expandable commands then you may need +to redefine <span +class="cmtt-10">\gls</span>⟨<span +class="cmti-10">internal cs name</span>⟩<span +class="cmtt-10">page </span>after using </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">\glsaddprotectedpagefmt{</span>⟨<span +class="cmitt-10">internal</span><span +class="cmitt-10"> cs</span><span +class="cmitt-10"> name</span>⟩<span +class="cmtt-10">}</span> +</div> +</div> This command doesn’t take any arguments as <span +class="cmti-10">the location is assumed to be given by </span><span +class="cmitt-10">\c@page </span>because that’s +the only occasion this command should be used. For example, suppose now my page counter format uses small +caps Roman numerals: + + + <pre class="verbatim" id="verbatim-319"> + \newcommand*{\samplenum}[1]{% +  \expandafter\@samplenum\csname c@#1\endcsname} + \newcommand*{\@samplenum}[1]{\textsc{\romannumeral#1}} +</pre> +<!--l. 11492--><p class="nopar" > Again, the inner macro needs to be identified using: + + +</p> + <pre class="verbatim" id="verbatim-320"> +\glsaddprotectedpagefmt{@samplenum} +</pre> +<!--l. 11496--><p class="nopar" > However, since <span +class="cmtt-10">\textsc </span>isn’t fully expandable, the location is written to the file as <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\textsc</span><span +class="cmtt-10"> </span><span +class="cmtt-10"> {i}</span></span></span> (for page 1), +<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\textsc</span><span +class="cmtt-10"> </span><span +class="cmtt-10"> {ii}</span></span></span> (for page 2), etc. This format may cause a problem for the <a +href="#glo:indexingapp">indexing application</a> +(particularly for <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-151017"></a></a>). To compensate for this, the <span +class="cmtt-10">\gls</span>⟨<span +class="cmti-10">internal cs name</span>⟩<span +class="cmtt-10">page </span>command +may be redefined so that it expands to a format that’s acceptable to the indexing application. For +example: + + +</p> + <pre class="verbatim" id="verbatim-321"> +\renewcommand*{\gls@samplenumpage}{\romannumeral\c@page} +</pre> +<!--l. 11506--><p class="nopar" > While this modification means that the <a +href="#glo:numberlist">number list<a + id="dx1-151018"></a></a> in the glossary won’t exactly match the format of the page +numbers (displaying lower case Roman numbers instead of small cap Roman numerals) this method +will at least work correctly for both <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-151019"></a></a> and <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-151020"></a></a>. If you are using <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-151021"></a></a>, the following +definition: + + +</p> + <pre class="verbatim" id="verbatim-322"> + \renewcommand*{\gls@samplenumpage}{% +   \glsbackslash\string\textsc{\romannumeral\c@page}} +</pre> +<!--l. 11516--><p class="nopar" > combined with + + +</p> + <pre class="verbatim" id="verbatim-323"> +\GlsAddXdyLocation{romansc}{:sep "\string\textsc\glsopenbrace" + "roman-numbers-lowercase" :sep "\glsclosebrace"} +</pre> +<!--l. 11521--><p class="nopar" > will now have lowercase Roman numerals in the location list (see <a +href="#sec:xindyloc">§<span +class="cmbx-10">??</span>sec:xindyloc </a><a +href="#sec:xindyloc">Locations and Number lists<!--tex4ht:ref: sec:xindyloc --></a> for +further details on that command). Take care of the backslashes. The location (which ends up in the +<span +class="cmtt-10">:locref</span><a + id="dx1-151022"></a> attribute) needs <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\\</span></span></span> but the location class (identified with <span +class="cmtt-10">\GlsAddXdyLocation</span>) just +has a single backslash. Note that this example will cause problems if your locations should be +hyperlinks. +</p><!--l. 11530--><p class="indent" > Another possibility that may work with both <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-151023"></a></a> and <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-151024"></a></a> is to redefine <span +class="cmtt-10">\gls</span>⟨<span +class="cmti-10">internal cs name</span>⟩<span +class="cmtt-10">page</span> +(<span +class="cmtt-10">\gls@samplenumpage </span>in this example) to just expand to the decimal page number (<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\number\c@page</span></span></span>) and +redefine <span +class="cmtt-10">\glsnumberformat</span><a + id="dx1-151025"></a> to change the displayed format: + + +</p> + <pre class="verbatim" id="verbatim-324"> +\renewcommand*{\gls@samplenumpage}{\number\c@page} +\renewcommand*{\glsnumberformat}[1]{\textsc{\romannumeral#1}} +</pre> +<!--l. 11538--><p class="nopar" > +</p><!--l. 11540--><p class="indent" > <div class="important" title="Important Note"> If you redefine <span +class="cmtt-10">\gls</span>⟨<span +class="cmti-10">internal cs name</span>⟩<span +class="cmtt-10">page</span>, you must make sure that <span +class="cmtt-10">\c@page </span>is expanded when it’s written +to the file. (So don’t, for example, hide <span +class="cmtt-10">\c@page </span>inside a robust command.) </div> +</p><!--l. 11545--><p class="noindent" > +</p><!--l. 11547--><p class="indent" > The mechanism that allows this to work temporarily redefines <span +class="cmtt-10">\the</span><a + id="dx1-151026"></a> and <span +class="cmtt-10">\number</span><a + id="dx1-151027"></a> while it processes the +location. If this causes a problem you can disallow it using +</p><!--l. 11550--><p class="indent" > <hr><div title="Definition"><a + id="dx1-151028"></a> <span +class="cmtt-10">\glswrallowprimitivemodsfalse </span></div><hr> +</p><!--l. 11552--><p class="noindent" > +but you will need to find some other way to ensure the location expands correctly. +</p><!--l. 11556--><p class="noindent" > +</p> +<!--l. 11556--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">12.3 </span> <a + id="sec:ranges"></a>Range Formations</h3> +<!--l. 11559--><p class="noindent" >Both <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-152001"></a></a> and <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-152002"></a></a> (Options <a +href="#option2">2</a> and <a +href="#option3">3</a>) concatenate a sequence of 3 or more consecutive +pages into a range. With <span +class="cmtt-10">xindy</span><a + id="dx1-152003"></a> (<a +href="#option3">Option 3</a>) you can vary the minimum sequence length using +<span +class="cmtt-10">\GlsSetXdyMinRangeLength</span><a + id="dx1-152004"></a><span +class="cmtt-10">{</span>⟨<span +class="cmti-10">n</span>⟩<span +class="cmtt-10">} </span>where ⟨<span +class="cmti-10">n</span>⟩ is either an integer or the keyword <span +class="cmtt-10">none </span>which indicates that +there should be no range formation (see <a +href="#sec:xindyloc">§<span +class="cmbx-10">??</span>sec:xindyloc </a><a +href="#sec:xindyloc">Locations and Number lists<!--tex4ht:ref: sec:xindyloc --></a> for further +details). +</p><!--l. 11567--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\GlsSetXdyMinRangeLength </span>must be used before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-152005"></a> and has no effect if <span +class="cmtt-10">\noist</span><a + id="dx1-152006"></a> +is used. </div> +</p><!--l. 11570--><p class="noindent" > +</p><!--l. 11572--><p class="indent" > With both <a +href="#glo:makeindex"><span +class="cmtt-10">makeindex</span><a + id="dx1-152007"></a></a> and <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-152008"></a></a> (Options <a +href="#option2">2</a> and <a +href="#option3">3</a>), you can replace the separator and the closing number +in the range using: +</p><!--l. 11574--><p class="indent" > <hr><div title="Definition"><a + id="dx1-152009"></a> <span +class="cmtt-10">\glsSetSuffixF{</span>⟨<span +class="cmitt-10">suffix</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11576--><p class="noindent" > +</p><!--l. 11577--><p class="indent" > <hr><div title="Definition"><a + id="dx1-152010"></a> <span +class="cmtt-10">\glsSetSuffixFF{</span>⟨<span +class="cmitt-10">suffix</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11579--><p class="noindent" > +where the former command specifies the suffix to use for a 2 page list and the latter specifies the suffix to use for +longer lists. For example: + + +</p> + <pre class="verbatim" id="verbatim-325"> +\glsSetSuffixF{f.} +\glsSetSuffixFF{ff.} +</pre> +<!--l. 11586--><p class="nopar" > Note that if you use <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-152011"></a></a> (<a +href="#option3">Option 3</a>), you will also need to set the minimum range length to 1 if you want to +change these suffixes: + + +</p> + <pre class="verbatim" id="verbatim-326"> +\GlsSetXdyMinRangeLength{1} +</pre> +<!--l. 11592--><p class="nopar" > Note that if you use the <span +class="cmss-10">hyperref</span><a + id="dx1-152012"></a> package, you will need to use <span +class="cmtt-10">\nohyperpage</span><a + id="dx1-152013"></a> in the suffix to ensure that the +hyperlinks work correctly. For example: + + +</p> + <pre class="verbatim" id="verbatim-327"> +\glsSetSuffixF{\nohyperpage{f.}} +\glsSetSuffixFF{\nohyperpage{ff.}} +</pre> +<!--l. 11599--><p class="nopar" > +</p><!--l. 11601--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\glsSetSuffixF </span>and <span +class="cmtt-10">\glsSetSuffixFF </span>must be used before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-152014"></a> and have no +effect if <span +class="cmtt-10">\noist</span><a + id="dx1-152015"></a> is used. </div> +</p><!--l. 11605--><p class="noindent" > +</p><!--l. 11607--><p class="indent" > It’s also possible to concatenate a sequence of consecutive locations into a range or have suffixes with +<a +href="#option4">Option 4</a>, but with <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-152016"></a></a> these implicit ranges can’t be merged with explicit ranges (created with the <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">(</span></span></span> and +<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">)</span></span></span> encaps). See the <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-152017"></a></a> manual for further details. +</p><!--l. 11613--><p class="indent" > <a +href="#option1">Option 1</a> doesn’t form ranges. However, with this option you can iterate over an entry’s <a +href="#glo:numberlist">number list<a + id="dx1-152018"></a></a> +using: +</p><!--l. 11615--><p class="indent" > <hr><div title="Definition"><a + id="dx1-152019"></a> <span +class="cmtt-10">\glsnumberlistloop{</span>⟨<span +class="cmitt-10">label</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">handler cs</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">xr handler cs</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11618--><p class="noindent" > +where ⟨<span +class="cmti-10">label</span>⟩ is the entry’s label and ⟨<span +class="cmti-10">handler cs</span>⟩ is a handler control sequence of the form: +</p><!--l. 11622--><p class="indent" > <hr><div title="Definition">⟨<span +class="cmitt-10">handler cs</span>⟩<span +class="cmtt-10">{</span>⟨<span +class="cmitt-10">prefix</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">format</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">location</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11623--><p class="noindent" > +where ⟨<span +class="cmti-10">prefix</span>⟩ is the <span +class="cmss-10">hyperref</span><a + id="dx1-152020"></a> prefix, ⟨<span +class="cmti-10">counter</span>⟩ is the name of the counter used for the location, ⟨<span +class="cmti-10">format</span>⟩ is the +format used to display the location (e.g. <span +class="cmtt-10">textbf</span>) and ⟨<span +class="cmti-10">location</span>⟩ is the location. The third argument +is the control sequence to use for any cross-references in the list. This handler should have the +syntax: +</p><!--l. 11631--><p class="indent" > <hr><div title="Definition">⟨<span +class="cmitt-10">xr handler cs</span>⟩<span +class="cmtt-10">[</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">xr list</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11632--><p class="noindent" > +where ⟨<span +class="cmti-10">tag</span>⟩ is the cross-referenced text (e.g. “see”) and ⟨<span +class="cmti-10">xr list</span>⟩ is a comma-separated list of labels. (This actually +has a third argument but it’s always empty when used with <a +href="#option1">Option 1</a>.) +</p><!--l. 11637--><p class="indent" > For example, if on page 12 I have used + + +</p> + <pre class="verbatim" id="verbatim-328"> +\gls[format=textbf]{apple} +</pre> +<!--l. 11641--><p class="nopar" > and on page 18 I have used + + +</p> + <pre class="verbatim" id="verbatim-329"> +\gls[format=emph]{apple} +</pre> +<!--l. 11645--><p class="nopar" > then + + +</p> + <pre class="verbatim" id="verbatim-330"> +\glsnumberlistloop{apple}{\myhandler} +</pre> +<!--l. 11649--><p class="nopar" > will be equivalent to: + + +</p> + <pre class="verbatim" id="verbatim-331"> +\myhandler{}{page}{textbf}{12}% +\myhandler{}{page}{emph}{18}% +</pre> +<!--l. 11654--><p class="nopar" > There is a predefined handler that’s used to display the <a +href="#glo:numberlist">number list<a + id="dx1-152021"></a></a> in the glossary: +</p><!--l. 11657--><p class="indent" > <hr><div title="Definition"><a + id="dx1-152022"></a> <span +class="cmtt-10">\glsnoidxdisplayloc{</span>⟨<span +class="cmitt-10">prefix</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">format</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">location</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11659--><p class="noindent" > +The predefined handler used for the cross-references in the glossary is: +</p><!--l. 11662--><p class="indent" > <hr><div title="Definition"><span +class="cmtt-10">\glsseeformat[</span>⟨<span +class="cmitt-10">tag</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">xr list</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">location</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11663--><p class="noindent" > +which is described in <a +href="#sec:customxr">§<span +class="cmbx-10">??</span>sec:customxr </a><a +href="#sec:customxr">Customising Cross-reference Text<!--tex4ht:ref: sec:customxr --></a>. +</p><!--l. 11666--><p class="indent" > <div class="important" title="Important Note"> <span +class="cmtt-10">\glsnumberlistloop </span>is not available for Options <a +href="#option2">2</a> and <a +href="#option3">3</a>. </div> +</p><!--l. 11668--><p class="noindent" > +</p><!--l. 11670--><p class="noindent" > +</p> +<!--l. 11670--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">12.4 </span> <a + id="sec:isthook"></a>Style Hook</h3> +<!--l. 11673--><p class="noindent" >As from version 4.24, there’s a hook that’s used near the end of <span +class="cmtt-10">\writeist</span><a + id="dx1-153001"></a> before the file is closed. You can set +the code to be performed then using: +</p><!--l. 11676--><p class="indent" > <hr><div title="Definition"><a + id="dx1-153002"></a> <span +class="cmtt-10">\GlsSetWriteIstHook{</span>⟨<span +class="cmitt-10">code</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11678--><p class="noindent" > +If you want the ⟨<span +class="cmti-10">code</span>⟩ to write any information to the file, you need to use +</p><!--l. 11681--><p class="indent" > <hr><div title="Definition"><a + id="dx1-153003"></a> <span +class="cmtt-10">\write\glswrite{</span>⟨<span +class="cmitt-10">style information</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 11683--><p class="noindent" > +Make sure you use the correct format within ⟨<span +class="cmti-10">style information</span>⟩. For example, if you are using <span +class="cmtt-10">makeindex</span><a + id="dx1-153004"></a>: + + +</p> + <pre class="verbatim" id="verbatim-332"> +\GlsSetWriteIstHook{% + \write\glswrite{page_precedence "arnAR"}% + \write\glswrite{line_max 80}% +} +</pre> +<!--l. 11691--><p class="nopar" > This changes the page type precedence<a + id="dx1-153005"></a> and the maximum line length used by <span +class="cmtt-10">makeindex</span><a + id="dx1-153006"></a>. +</p><!--l. 11695--><p class="indent" > Remember that if you switch to <span +class="cmtt-10">xindy</span><a + id="dx1-153007"></a>, this will no longer be valid code. + + +</p> +<!--l. 11698--><p class="indent" > </div> +</p><!--l. 11698--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">13. <a + id="sec:styles"></a>Glossary Styles</h2> +</p><!--l. 11701--><p class="indent" > Glossaries vary from lists that simply contain a symbol with a terse description to lists of terms or phrases +with lengthy descriptions. Some glossaries may have terms with associated symbols. Some may have +hierarchical entries. There is therefore no single style that fits every type of glossary. The <span +class="cmss-10">glossaries</span> +package comes with a number of pre-defined glossary styles, described in <a +href="#sec:predefinedstyles">§<span +class="cmbx-10">??</span>sec:predefinedstyles +</a><a +href="#sec:predefinedstyles">Predefined Styles<!--tex4ht:ref: sec:predefinedstyles --></a>. You can choose one of these that best suits your type of glossary or, if none of +them suit your document, you can defined your own style (see <a +href="#sec:newglossarystyle">§<span +class="cmbx-10">??</span>sec:newglossarystyle </a><a +href="#sec:newglossarystyle">Defining +your own glossary style<!--tex4ht:ref: sec:newglossarystyle --></a>). There are some examples of glossary styles available at the <a href="https://www.dickimaw-books.com/gallery/#glossaries" ><span -class="cmtt-10">https://www.dickimaw-books.com/gallery/#glossaries</span></a>. -</p><!--l. 11872--><p class="indent" > The glossary style can be set using the <span +class="cmss-10">glossaries</span> +gallery</a>. +</p><!--l. 11713--><p class="indent" > The glossary style can be set using the <span class="cmtt-10">style</span><a - id="dx1-155001"></a> key in the optional argument to <span + id="dx1-154001"></a> key in the optional argument to <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-155002"></a> + id="dx1-154002"></a> (<a href="#option1">Option 1</a>) or <span class="cmtt-10">\printglossary</span><a - id="dx1-155003"></a> (Options <a + id="dx1-154003"></a> (Options <a href="#option2">2</a> and <a href="#option3">3</a>) or using the command: -</p><!--l. 11875--><p class="indent" > <hr><div title="Definition"><a - id="dx1-155004"></a> <span +</p><!--l. 11716--><p class="indent" > <hr><div title="Definition"><a + id="dx1-154004"></a> <span class="cmtt-10">\setglossarystyle{</span>⟨<span class="cmitt-10">style-name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 11877--><p class="noindent" > +</p><!--l. 11718--><p class="noindent" > (before the glossary is displayed). -</p><!--l. 11880--><p class="indent" > Some of the predefined glossary styles may also be set using the <span +</p><!--l. 11721--><p class="indent" > Some of the predefined glossary styles may also be set using the <span class="cmss-10">style</span><a - id="dx1-155005"></a> package option, it depends if the + id="dx1-154005"></a> package option, it depends if the package in which they are defined is automatically loaded by the <span class="cmss-10">glossaries </span>package. -</p><!--l. 11884--><p class="indent" > You can use the lorum ipsum dummy entries provided in the accompanying <span +</p><!--l. 11725--><p class="indent" > You can use the lorum ipsum dummy entries provided in the accompanying <span class="cmtt-10">example-glossaries-*.tex</span> files (described in <a -href="#sec:lipsum">§1.2 </a><a +href="#sec:lipsum">§<span +class="cmbx-10">??</span>sec:lipsum </a><a href="#sec:lipsum">Dummy Entries for Testing<!--tex4ht:ref: sec:lipsum --></a>) to test the different styles. -</p><!--l. 11889--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <span +</p><!--l. 11730--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <span class="cmss-10">glossaries-extra-stylemods</span><a - id="dx1-155006"></a> package provided with <a + id="dx1-154006"></a> package provided with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> patches the predefined styles. There also more styles available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. </div> -</p><!--l. 11893--><p class="noindent" > +</p><!--l. 11734--><p class="noindent" > </p> -<!--l. 11895--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">15.1 </span> <a +<!--l. 11736--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">13.1 </span> <a id="sec:predefinedstyles"></a>Predefined Styles</h3> -<!--l. 11898--><p class="noindent" >The predefined styles can accommodate numbered level 0 (main) and level 1 entries. See the package options +<!--l. 11739--><p class="noindent" >The predefined styles can accommodate numbered level 0 (main) and level 1 entries. See the package options <span class="cmss-10">entrycounter</span><a - id="dx1-156001"></a>, <span + id="dx1-155001"></a>, <span class="cmss-10">counterwithin</span><a - id="dx1-156002"></a> and <span + id="dx1-155002"></a> and <span class="cmss-10">subentrycounter</span><a - id="dx1-156003"></a> described in <a -href="#sec:pkgopts-printglos">§2.3 </a><a -href="#sec:pkgopts-printglos">Glossary Appearance Options<!--tex4ht:ref: sec:pkgopts-printglos --></a>. There is a -summary of available styles in <a -href="#tab:styles">table 15.1</a>. You can view samples of all the predefined styles at -<a + id="dx1-155003"></a> described in <a +href="#sec:pkgopts-printglos">§<span +class="cmbx-10">??</span>sec:pkgopts-printglos </a><a +href="#sec:pkgopts-printglos">Glossary Appearance +Options<!--tex4ht:ref: sec:pkgopts-printglos --></a>. There is a summary of available styles in <a +href="#tab:styles">table <span +class="cmbx-10">??</span>tab:styles</a>. You can view samples of all the predefined +styles at <a href="https://www.dickimaw-books.com/gallery/glossaries-styles/" ><span class="cmtt-10">https://www.dickimaw-books.com/gallery/glossaries-styles/</span></a>. Note that <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> provides -additional styles in the supplementary packages <span +class="cmss-10">glossaries-extra</span></a> +provides additional styles in the supplementary packages <span class="cmss-10">glossary-bookindex</span><a - id="dx1-156004"></a> and <span -class="cmss-10">glossary-longnoloc</span><a - id="dx1-156005"></a>. See the <a + id="dx1-155004"></a>, <span +class="cmss-10">glossary-topic</span><a + id="dx1-155005"></a> and <span +class="cmss-10">glossary-longextra</span><a + id="dx1-155006"></a>. +See the <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> -manual for further details. -</p><!--l. 11911--><p class="indent" > <div class="important" title="Important Note"> Note that the group styles (such as <span +class="cmss-10">glossaries-extra</span></a> manual for further details. +</p><!--l. 11752--><p class="indent" > <div class="important" title="Important Note"> Note that the group styles (such as <span class="cmss-10">listgroup</span><a - id="dx1-156006"></a>) will have unexpected results if used with the <span + id="dx1-155007"></a>) will have unexpected results if used with the <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">def</span><a - id="dx1-156007"></a> or + id="dx1-155008"></a> or <span class="cmss-10">sort</span><span class="cmtt-10">=</span><span class="cmss-10">use</span><a - id="dx1-156008"></a> options. If you don’t sort your entries alphabetically, it’s best to set the <span + id="dx1-155009"></a> options. If you don’t sort your entries alphabetically, it’s best to set the <span class="cmss-10">nogroupskip</span><a - id="dx1-156009"></a> package option to + id="dx1-155010"></a> package option to prevent odd vertical gaps appearing. </div> -</p><!--l. 11917--><p class="noindent" > -</p><!--l. 11919--><p class="indent" > The group title is obtained using <span +</p><!--l. 11758--><p class="noindent" > +</p><!--l. 11760--><p class="indent" > The group title is obtained using <span class="cmtt-10">\glsgetgrouptitle{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>, which is described in <a -href="#sec:newglossarystyle">§15.2 </a><a -href="#sec:newglossarystyle">Defining your own -glossary style<!--tex4ht:ref: sec:newglossarystyle --></a>. +href="#sec:newglossarystyle">§<span +class="cmbx-10">??</span>sec:newglossarystyle +</a><a +href="#sec:newglossarystyle">Defining your own glossary style<!--tex4ht:ref: sec:newglossarystyle --></a>. </p> <div class="table"> -<!--l. 11922--><p class="indent" > <a +<!--l. 11763--><p class="indent" > <a id="tab:styles"></a></p><hr class="float" /><div class="float" > <div class="caption" -><span class="id">Table 15.1: </span><span +><span class="id">Table 13.1: </span><span class="content">Glossary Styles. An asterisk in the style name indicates anything that matches that doesn’t match any previously listed style (e.g. <span class="cmtt-10">long3col* </span>matches <span class="cmss-10">long3col</span><a - id="dx1-156011"></a>, <span + id="dx1-155012"></a>, <span class="cmss-10">long3colheader</span><a - id="dx1-156012"></a>, <span + id="dx1-155013"></a>, <span class="cmss-10">long3colborder</span><a - id="dx1-156013"></a> and + id="dx1-155014"></a> and <span class="cmss-10">long3colheaderborder</span><a - id="dx1-156014"></a>). A maximum level of 0 indicates a flat glossary (sub-entries are displayed in the + id="dx1-155015"></a>). A maximum level of 0 indicates a flat glossary (sub-entries are displayed in the same way as main entries). Where the maximum level is given as — there is no limit, but note that <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-156015"></a></a> (<a + id="dx1-155016"></a></a> (<a href="#option2">Option 2</a>) imposes a limit of 2 sub-levels. If the homograph column is checked, then the -name is not displayed for sub-entries. If the symbol column is checked, then the symbol will be displayed.</span></div><!--tex4ht:label?: x1-1560101 --> +name is not displayed for sub-entries. If the symbol column is checked, then the symbol will be displayed.</span></div><!--tex4ht:label?: x1-1550111 --> <div class="tabular"> <table id="TBL-9" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-9-1g"><col id="TBL-9-1" /><col id="TBL-9-2" /><col @@ -23950,236 +24208,244 @@ class="td11"> </td></tr></table></div> </div><hr class="endfloat" /> </div> -<!--l. 11962--><p class="indent" > The tabular-like styles that allow multi-line descriptions and page lists use the length -</p><!--l. 11964--><p class="indent" > <hr><div title="Definition"><a - id="dx1-156016"></a> <span +<!--l. 11803--><p class="indent" > The tabular-like styles that allow multi-line descriptions and page lists use the length +</p><!--l. 11805--><p class="indent" > <hr><div title="Definition"><a + id="dx1-155017"></a> <span class="cmtt-10">\glsdescwidth </span></div><hr> -</p><!--l. 11966--><p class="noindent" > +</p><!--l. 11807--><p class="noindent" > to set the width of the description column and the length -</p><!--l. 11968--><p class="indent" > <hr><div title="Definition"><a - id="dx1-156017"></a> <span +</p><!--l. 11809--><p class="indent" > <hr><div title="Definition"><a + id="dx1-155018"></a> <span class="cmtt-10">\glspagelistwidth </span></div><hr> -</p><!--l. 11970--><p class="noindent" > +</p><!--l. 11811--><p class="noindent" > to set the width of the page list column.<span class="footnote-mark"><a -href="#fn1x15" id="fn1x15-bk"><sup class="textsuperscript">15.1</sup></a></span><a - id="x1-156018f1"></a> +href="#fn1x13" id="fn1x13-bk"><sup class="textsuperscript">13.1</sup></a></span><a + id="x1-155019f1"></a> These will need to be changed using <span class="cmtt-10">\setlength </span>if the glossary is too wide. Note that the <span class="cmss-10">long4col</span><a - id="dx1-156022"></a> and <span + id="dx1-155023"></a> and <span class="cmss-10">super4col</span><a - id="dx1-156023"></a> + id="dx1-155024"></a> styles (and their header and border variations) don’t use these lengths as they are designed for single line entries. Instead you should use the analogous <span class="cmss-10">altlong4col</span><a - id="dx1-156024"></a> and <span + id="dx1-155025"></a> and <span class="cmss-10">altsuper4col</span><a - id="dx1-156025"></a> styles. If you want to explicitly create + id="dx1-155026"></a> styles. If you want to explicitly create a line-break within a multi-line description in a tabular-like style it’s better to use <span class="cmtt-10">\newline</span><a - id="dx1-156026"></a> instead of + id="dx1-155027"></a> instead of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\\</span></span></span>. -</p><!--l. 11985--><p class="indent" > <div class="important" title="Important Note"> Remember that a cell within a tabular-like environment can’t be broken across a page, so even if a +</p><!--l. 11826--><p class="indent" > <div class="important" title="Important Note"> Remember that a cell within a tabular-like environment can’t be broken across a page, so even if a tabular-like style, such as <span class="cmss-10">long</span><a - id="dx1-156027"></a>, allows multilined descriptions, you’ll probably encounter page-breaking problems + id="dx1-155028"></a>, allows multilined descriptions, you’ll probably encounter page-breaking problems if you have entries with long descriptions. You may want to consider using the <span class="cmss-10">alttree</span><a - id="dx1-156028"></a> style instead. + id="dx1-155029"></a> style instead. </div> -</p><!--l. 11991--><p class="noindent" > -</p><!--l. 11993--><p class="indent" > Note that if you use the <span +</p><!--l. 11832--><p class="noindent" > +</p><!--l. 11834--><p class="indent" > Note that if you use the <span class="cmtt-10">style</span><a - id="dx1-156029"></a> key in the optional argument to <span + id="dx1-155030"></a> key in the optional argument to <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-156030"></a> (<a + id="dx1-155031"></a> (<a href="#option1">Option 1</a>) or <span class="cmtt-10">\printglossary</span><a - id="dx1-156031"></a> (Options <a + id="dx1-155032"></a> (Options <a href="#option2">2</a> and <a href="#option3">3</a>), it will override any previous style settings for the given glossary, so if, for example, you do </p> - <div class="verbatim" id="verbatim-359"> + <pre class="verbatim" id="verbatim-333"> \renewcommand*{\glsgroupskip}{} - <br />\printglossary[style=long] -</div> -<!--l. 12001--><p class="nopar" > then the new definition of <span +\printglossary[style=long] +</pre> +<!--l. 11842--><p class="nopar" > then the new definition of <span class="cmtt-10">\glsgroupskip</span><a - id="dx1-156032"></a> will not have an affect for this glossary, as <span + id="dx1-155033"></a> will not have an affect for this glossary, as <span class="cmtt-10">\glsgroupskip </span>is redefined by <span class="obeylines-h"><span class="verb"><span class="cmtt-10">style=long</span></span></span>. Likewise, <span class="cmtt-10">\setglossarystyle</span><a - id="dx1-156033"></a> will also override any previous style definitions, so, + id="dx1-155034"></a> will also override any previous style definitions, so, again </p> - <div class="verbatim" id="verbatim-360"> + <pre class="verbatim" id="verbatim-334"> \renewcommand*{\glsgroupskip}{} - <br />\setglossarystyle{long} -</div> -<!--l. 12009--><p class="nopar" > will reset <span +\setglossarystyle{long} +</pre> +<!--l. 11850--><p class="nopar" > will reset <span class="cmtt-10">\glsgroupskip </span>back to its default definition for the named glossary style (<span class="cmss-10">long</span><a - id="dx1-156034"></a> in this case). If you + id="dx1-155035"></a> in this case). If you want to modify the styles, either use <span class="cmtt-10">\newglossarystyle</span><a - id="dx1-156035"></a> (described in the next section) or make the + id="dx1-155036"></a> (described in the next section) or make the modifications after <span class="cmtt-10">\setglossarystyle</span><a - id="dx1-156036"></a>, e.g.: + id="dx1-155037"></a>, e.g.: </p> - <div class="verbatim" id="verbatim-361"> + <pre class="verbatim" id="verbatim-335"> \setglossarystyle{long} - <br />\renewcommand*{\glsgroupskip}{} -</div> -<!--l. 12018--><p class="nopar" > As from version 3.03, you can now use the package option <span +\renewcommand*{\glsgroupskip}{} +</pre> +<!--l. 11859--><p class="nopar" > As from version 3.03, you can now use the package option <span class="cmss-10">nogroupskip</span><a - id="dx1-156037"></a> to suppress the gap between groups for + id="dx1-155038"></a> to suppress the gap between groups for the default styles instead of redefining <span class="cmtt-10">\glsgroupskip</span>. -</p><!--l. 12023--><p class="indent" > All the styles except for the three- and four-column styles and the <span +</p><!--l. 11864--><p class="indent" > All the styles except for the three- and four-column styles and the <span class="cmss-10">listdotted</span><a - id="dx1-156038"></a> style use the command -</p><!--l. 12025--><p class="indent" > <hr><div title="Definition"><a - id="dx1-156039"></a> <span + id="dx1-155039"></a> style use the command +</p><!--l. 11866--><p class="indent" > <hr><div title="Definition"><a + id="dx1-155040"></a> <span class="cmtt-10">\glspostdescription </span></div><hr> -</p><!--l. 12027--><p class="noindent" > +</p><!--l. 11868--><p class="noindent" > after the description. This simply displays a full stop by default. To eliminate this full stop (or replace it with something else, say, a comma) you will need to redefine <span class="cmtt-10">\glspostdescription </span>before the glossary is displayed. Alternatively, you can suppress it for a given entry by placing <span class="cmtt-10">\nopostdesc</span><a - id="dx1-156040"></a> in the entry’s description. Note that + id="dx1-155041"></a> in the entry’s description. Note that <span class="cmtt-10">\longnewglossaryentry</span><a - id="dx1-156041"></a> puts <span + id="dx1-155042"></a> puts <span class="cmtt-10">\nopostdesc </span>at the end of the description. The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package provides a starred version that doesn’t. -</p><!--l. 12037--><p class="indent" > As from version 3.03 you can now use the package option <span +</p><!--l. 11878--><p class="indent" > As from version 3.03 you can now use the package option <span class="cmss-10">nopostdot</span><a - id="dx1-156042"></a> to suppress this full stop. This is the + id="dx1-155043"></a> to suppress this full stop. This is the better option if you want to use the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package. The <span class="cmss-10">glossaries-extra-stylemods</span><a - id="dx1-156043"></a> package provides + id="dx1-155044"></a> package provides some adjustments some of to the predefined styles listed here, allowing for greater flexibility. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> documentation for further details. </p> -<!--l. 12045--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.1 </span> <a +<!--l. 11886--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.1 </span> <a id="sec:liststyles"></a>List Styles</h4> -<!--l. 12048--><p class="noindent" >The styles described in this section are all defined in the package <span +<!--l. 11889--><p class="noindent" >The styles described in this section are all defined in the package <span class="cmss-10">glossary-list</span><a - id="dx1-157001"></a>. Since they all use the <span + id="dx1-156001"></a>. Since they all use the <span class="cmss-10">description</span><a - id="dx1-157002"></a><a - id="dx1-157003"></a> + id="dx1-156002"></a><a + id="dx1-156003"></a> environment, they are governed by the same parameters as that environment. These styles all ignore the entry’s symbol. Note that these styles will automatically be available unless you use the <span class="cmss-10">nolist</span><a - id="dx1-157004"></a> or <span + id="dx1-156004"></a> or <span class="cmss-10">nostyles</span><a - id="dx1-157005"></a> package + id="dx1-156005"></a> package options. -</p><!--l. 12055--><p class="indent" > <div class="important" title="Important Note"> Note that, except for the <span +</p><!--l. 11896--><p class="indent" > <div class="important" title="Important Note"> Note that, except for the <span class="cmss-10">listdotted</span><a - id="dx1-157006"></a> style, these list styles are incompatible with <span + id="dx1-156006"></a> style, these list styles are incompatible with <span class="cmss-10">classicthesis</span><a - id="dx1-157007"></a>. They + id="dx1-156007"></a>. They may also be incompatible with other classes or packages that modify the <span class="cmss-10">description</span><a - id="dx1-157008"></a><a - id="dx1-157009"></a> environment. + id="dx1-156008"></a><a + id="dx1-156009"></a> environment. </div> -</p><!--l. 12060--><p class="noindent" > +</p><!--l. 11901--><p class="noindent" > </p><dl class="description"><dt class="description"> + <!--l. 11904--><p class="noindent" > <span -class="cmbx-10">list</span> </dt><dd -class="description">The <span +class="cmbx-10">list</span> </p></dt><dd +class="description"> + <!--l. 11904--><p class="noindent" >The <span class="cmss-10">list</span><a - id="dx1-157010"></a> style uses the <span + id="dx1-156010"></a> style uses the <span class="cmss-10">description</span><a - id="dx1-157011"></a><a - id="dx1-157012"></a> environment. The entry name is placed in the optional argument of - the <span + id="dx1-156011"></a><a + id="dx1-156012"></a> environment. The entry name is placed in the optional argument + of the <span class="cmtt-10">\item</span><a - id="dx1-157013"></a> command (so it will usually appear in bold by default). The description follows, and then - the associated <a + id="dx1-156013"></a> command (so it will usually appear in bold by default). The description follows, + and then the associated <a href="#glo:numberlist">number list<a - id="dx1-157014"></a></a> for that entry. The symbol is ignored. If the entry has child entries, the - description and number list follows (but not the name) for each child entry. Groups are separated - using <span + id="dx1-156014"></a></a> for that entry. The symbol is ignored. If the entry has child + entries, the description and number list follows (but not the name) for each child entry. Groups are + separated using <span class="cmtt-10">\indexspace</span><a - id="dx1-157015"></a>. - <!--l. 12071--><p class="noindent" >The closest matching non-list style is the <span + id="dx1-156015"></a>. + </p><!--l. 11912--><p class="noindent" >The closest matching non-list style is the <span class="cmss-10">index</span><a - id="dx1-157016"></a> style. + id="dx1-156016"></a> style. + + </p></dd><dt class="description"> + <!--l. 11914--><p class="noindent" > <span -class="cmbx-10">listgroup</span> </dt><dd -class="description">The <span +class="cmbx-10">listgroup</span> </p></dt><dd +class="description"> + <!--l. 11914--><p class="noindent" >The <span class="cmss-10">listgroup</span><a - id="dx1-157017"></a> style is like <span + id="dx1-156017"></a> style is like <span class="cmss-10">list</span><a - id="dx1-157018"></a> but the glossary groups have headings obtained using + id="dx1-156018"></a> but the glossary groups have headings obtained using <span class="cmtt-10">\glsgetgrouptitle{</span>⟨<span class="cmti-10">label</span>⟩<span -class="cmtt-10">}</span>, which is described in <a -href="#sec:newglossarystyle">§15.2 </a><a -href="#sec:newglossarystyle">Defining your own glossary style<!--tex4ht:ref: sec:newglossarystyle --></a>. - - - </dd><dt class="description"> +class="cmtt-10">}</span>, which is described in <a +href="#sec:newglossarystyle">§<span +class="cmbx-10">??</span>sec:newglossarystyle </a><a +href="#sec:newglossarystyle">Defining your own + glossary style<!--tex4ht:ref: sec:newglossarystyle --></a>. + </p></dd><dt class="description"> + <!--l. 11919--><p class="noindent" > <span -class="cmbx-10">listhypergroup</span> </dt><dd -class="description">The <span +class="cmbx-10">listhypergroup</span> </p></dt><dd +class="description"> + <!--l. 11919--><p class="noindent" >The <span class="cmss-10">listhypergroup</span><a - id="dx1-157019"></a> style is like <span + id="dx1-156019"></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 LaTeX to + id="dx1-156020"></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 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 + </p><!--l. 11925--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-156021"></a> <span class="cmtt-10">\glshypernavsep </span></div><hr> - </p><!--l. 12086--><p class="noindent" > + </p><!--l. 11927--><p class="noindent" > which defaults to a vertical bar with a space on either side. For example, to simply have a space separating each group, do: </p> - <div class="verbatim" id="verbatim-362"> + <pre class="verbatim" id="verbatim-336"> \renewcommand*{\glshypernavsep}{\space} -</div> - <!--l. 12091--><p class="nopar" > - </p><!--l. 12093--><p class="noindent" >Note that the hyper-navigation line is now (as from version 1.14) set inside the optional +</pre> + <!--l. 11932--><p class="nopar" > + </p><!--l. 11934--><p class="noindent" >Note that the hyper-navigation line is now (as from version 1.14) set inside the optional argument to <span class="cmtt-10">\item</span><a - id="dx1-157022"></a> instead of after it to prevent a spurious space at the start. This can cause a + id="dx1-156022"></a> instead of after it to prevent a spurious space at the start. This can cause a problem if the navigation line is too long. As from v4.22, if you need to adjust this, you can redefine - </p><!--l. 12098--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-157023"></a> <span + </p><!--l. 11939--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-156023"></a> <span class="cmtt-10">\glslistnavigationitem{</span>⟨<span class="cmitt-10">navigation line</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 12100--><p class="noindent" > + </p><!--l. 11941--><p class="noindent" > The default definition is <span class="cmtt-10">\item[</span>⟨<span class="cmti-10">navigation line</span>⟩<span @@ -24188,1315 +24454,1475 @@ class="cmtt-10">] </span>but may be redefined independently of setting the style </p> - <div class="verbatim" id="verbatim-363"> + <pre class="verbatim" id="verbatim-337"> \renewcommand*{\glslistnavigationitem}[1]{\item \textbf{#1}} -</div> - <!--l. 12105--><p class="nopar" > - </p><!--l. 12107--><p class="noindent" >You may prefer to use the tree-like styles, such as <span +</pre> + <!--l. 11946--><p class="nopar" > + </p><!--l. 11948--><p class="noindent" >You may prefer to use the tree-like styles, such as <span class="cmss-10">treehypergroup</span><a - id="dx1-157024"></a> instead. + id="dx1-156024"></a> instead. </p></dd><dt class="description"> + <!--l. 11951--><p class="noindent" > <span -class="cmbx-10">altlist</span> </dt><dd -class="description">The <span +class="cmbx-10">altlist</span> </p></dt><dd +class="description"> + <!--l. 11951--><p class="noindent" >The <span class="cmss-10">altlist</span><a - id="dx1-157025"></a> style is like <span + id="dx1-156025"></a> style is like <span class="cmss-10">list</span><a - id="dx1-157026"></a> but the description starts on the line following the name. (As with the <span + id="dx1-156026"></a> but the description starts on the line following the name. (As with the <span class="cmss-10">list</span><a - id="dx1-157027"></a> - style, the symbol is ignored.) Each child entry starts a new line, but as with the <span + id="dx1-156027"></a> style, + the symbol is ignored.) Each child entry starts a new line, but as with the <span class="cmss-10">list</span><a - id="dx1-157028"></a> style, the name - associated with each child entry is ignored. - <!--l. 12116--><p class="noindent" >The closest matching non-list style is the <span + id="dx1-156028"></a> style, the name associated + with each child entry is ignored. + </p><!--l. 11957--><p class="noindent" >The closest matching non-list style is the <span class="cmss-10">index</span><a - id="dx1-157029"></a> style with the following adjustment: + id="dx1-156029"></a> style with the following adjustment: </p> - <div class="verbatim" id="verbatim-364"> + <pre class="verbatim" id="verbatim-338"> \renewcommand{\glstreepredesc}{% -  <br /> \glstreeitem\parindent\hangindent} -</div> - <!--l. 12121--><p class="nopar" > +  \glstreeitem\parindent\hangindent} +</pre> + <!--l. 11962--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 11965--><p class="noindent" > <span -class="cmbx-10">altlistgroup</span> </dt><dd -class="description">The <span +class="cmbx-10">altlistgroup</span> </p></dt><dd +class="description"> + <!--l. 11965--><p class="noindent" >The <span class="cmss-10">altlistgroup</span><a - id="dx1-157030"></a> style is like <span + id="dx1-156030"></a> style is like <span class="cmss-10">altlist</span><a - id="dx1-157031"></a> but the glossary groups have headings. - </dd><dt class="description"> + id="dx1-156031"></a> but the glossary groups have headings. + </p></dd><dt class="description"> + <!--l. 11968--><p class="noindent" > <span -class="cmbx-10">altlisthypergroup</span> </dt><dd -class="description">The <span +class="cmbx-10">altlisthypergroup</span> </p></dt><dd +class="description"> + <!--l. 11968--><p class="noindent" >The <span class="cmss-10">altlisthypergroup</span><a - id="dx1-157032"></a> style is like <span + id="dx1-156032"></a> style is like <span class="cmss-10">altlistgroup</span><a - id="dx1-157033"></a> but has a set of links to the glossary groups. - The navigation line is the same as that for <span + id="dx1-156033"></a> but has a set of links to the glossary groups. The navigation + line is the same as that for <span class="cmss-10">listhypergroup</span><a - id="dx1-157034"></a>, described above. - </dd><dt class="description"> + id="dx1-156034"></a>, described above. + </p></dd><dt class="description"> + <!--l. 11973--><p class="noindent" > <span -class="cmbx-10">listdotted</span> </dt><dd -class="description">This style uses the <span +class="cmbx-10">listdotted</span> </p></dt><dd +class="description"> + <!--l. 11973--><p class="noindent" >This style uses the <span class="cmss-10">description</span><a - id="dx1-157035"></a><a - id="dx1-157036"></a> - environment.<span class="footnote-mark"><a -href="#fn2x15" id="fn2x15-bk"><sup class="textsuperscript">15.2</sup></a></span><a - id="x1-157037f2"></a> + id="dx1-156035"></a><a + id="dx1-156036"></a> environment.<span class="footnote-mark"><a +href="#fn2x13" id="fn2x13-bk"><sup class="textsuperscript">13.2</sup></a></span><a + id="x1-156037f2"></a> Each entry starts with <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\item[]</span></span></span>, followed by the name followed by a dotted line, followed by the description. Note that this style ignores both the <a href="#glo:numberlist">number list<a - id="dx1-157038"></a></a> and the symbol. The + id="dx1-156038"></a></a> and the symbol. The length - <!--l. 12137--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-157039"></a> <span + </p><!--l. 11978--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-156039"></a> <span class="cmtt-10">\glslistdottedwidth </span></div><hr> - </p><!--l. 12139--><p class="noindent" > + </p><!--l. 11980--><p class="noindent" > governs where the description should start. This is a flat style, so child entries are formatted in the same way as the parent entries. - </p><!--l. 12143--><p class="noindent" >A non-list alternative is to use the <span + </p><!--l. 11984--><p class="noindent" >A non-list alternative is to use the <span class="cmss-10">index</span><a - id="dx1-157040"></a> style with + id="dx1-156040"></a> style with </p> - <div class="verbatim" id="verbatim-365"> + <pre class="verbatim" id="verbatim-339"> \renewcommand{\glstreepredesc}{\dotfill} -  <br />\renewcommand{\glstreechildpredesc}{\dotfill} -</div> - <!--l. 12148--><p class="nopar" > Note that this doesn’t use <span + \renewcommand{\glstreechildpredesc}{\dotfill} +</pre> + <!--l. 11989--><p class="nopar" > Note that this doesn’t use <span class="cmtt-10">\glslistdottedwidth </span>and causes the description to be flush-right and will display the symbol, if provided. (It also doesn’t suppress the number list<a - id="dx1-157041"></a>, but that can be achieved with + id="dx1-156041"></a>, but that can be achieved with the <span class="cmss-10">nonumberlist</span><a - id="dx1-157042"></a> option.) + id="dx1-156042"></a> option.) </p></dd><dt class="description"> + <!--l. 11996--><p class="noindent" > <span -class="cmbx-10">sublistdotted</span> </dt><dd -class="description">This is a variation on the <span +class="cmbx-10">sublistdotted</span> </p></dt><dd +class="description"> + <!--l. 11996--><p class="noindent" >This is a variation on the <span class="cmss-10">listdotted</span><a - id="dx1-157043"></a> style designed for hierarchical glossaries. The main entries - have just the name displayed. The sub entries are displayed in the same manner as <span + id="dx1-156043"></a> style designed for hierarchical glossaries. The main entries have just + the name displayed. The sub entries are displayed in the same manner as <span class="cmss-10">listdotted</span><a - id="dx1-157044"></a>. Unlike the - <span + id="dx1-156044"></a>. Unlike the <span class="cmss-10">listdotted</span><a - id="dx1-157045"></a> style, this style is incompatible with <span + id="dx1-156045"></a> + style, this style is incompatible with <span class="cmss-10">classicthesis</span><a - id="dx1-157046"></a>.</dd></dl> -<!--l. 12164--><p class="noindent" > + id="dx1-156046"></a>.</p></dd></dl> +<!--l. 12005--><p class="noindent" > </p> -<!--l. 12164--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.2 </span> <a +<!--l. 12005--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.2 </span> <a id="sec:longstyles"></a>Longtable Styles</h4> -<!--l. 12167--><p class="noindent" >The styles described in this section are all defined in the package <span +<!--l. 12008--><p class="noindent" >The styles described in this section are all defined in the package <span class="cmss-10">glossary-long</span><a - id="dx1-158001"></a>. Since they all use the -<span + id="dx1-157001"></a>. Since they all use the <span class="cmss-10">longtable</span><a - id="dx1-158002"></a><a - id="dx1-158003"></a> environment, they are governed by the same parameters as that environment. Note that -these styles will automatically be available unless you use the <span + id="dx1-157002"></a><a + id="dx1-157003"></a> +environment, they are governed by the same parameters as that environment. Note that these styles will +automatically be available unless you use the <span class="cmss-10">nolong</span><a - id="dx1-158004"></a> or <span + id="dx1-157004"></a> or <span class="cmss-10">nostyles</span><a - id="dx1-158005"></a> package options. -These styles fully justify the description and page list columns. If you want ragged right formatting -instead, use the analogous styles described in <a -href="#sec:longraggedstyles">§15.1.3 </a><a -href="#sec:longraggedstyles">Longtable Styles (Ragged Right)<!--tex4ht:ref: sec:longraggedstyles --></a>. If you want to -incorporate rules from the <span + id="dx1-157005"></a> package options. These styles fully justify the +description and page list columns. If you want ragged right formatting instead, use the analogous styles +described in <a +href="#sec:longraggedstyles">§<span +class="cmbx-10">??</span>sec:longraggedstyles </a><a +href="#sec:longraggedstyles">Longtable Styles (Ragged Right)<!--tex4ht:ref: sec:longraggedstyles --></a>. If you want to incorporate rules +from the <span class="cmss-10">booktabs</span><a - id="dx1-158006"></a> package, try the styles described in <a -href="#sec:longbooktabsstyles">§15.1.4 </a><a + id="dx1-157006"></a> package, try the styles described in <a +href="#sec:longbooktabsstyles">§<span +class="cmbx-10">??</span>sec:longbooktabsstyles </a><a href="#sec:longbooktabsstyles">Longtable Styles (<span class="cmss-10">booktabs</span>)<!--tex4ht:ref: sec:longbooktabsstyles --></a>. </p><dl class="description"><dt class="description"> + <!--l. 12020--><p class="noindent" > <span -class="cmbx-10">long</span> </dt><dd -class="description">The <span +class="cmbx-10">long</span> </p></dt><dd +class="description"> + <!--l. 12020--><p class="noindent" >The <span class="cmss-10">long</span><a - id="dx1-158007"></a> style uses the <span + id="dx1-157007"></a> style uses the <span class="cmss-10">longtable</span><a - id="dx1-158008"></a><a - id="dx1-158009"></a> environment (defined by the <span + id="dx1-157008"></a><a + id="dx1-157009"></a> environment (defined by the <span class="cmss-10">longtable</span><a - id="dx1-158010"></a> package). It has two columns: + id="dx1-157010"></a> package). It has two columns: the first column contains the entry’s name and the second column contains the description followed by the <a href="#glo:numberlist">number list<a - id="dx1-158011"></a></a>. The entry’s symbol is ignored. Sub groups are separated with a blank row. The + id="dx1-157011"></a></a>. The entry’s symbol is ignored. Sub groups are separated with a blank row. The width of the first column is governed by the widest entry in that column. The width of the second column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-158012"></a>. Child entries have a similar format to the parent + id="dx1-157012"></a>. Child entries have a similar format to the parent entries except that their name is suppressed. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12031--><p class="noindent" > <span -class="cmbx-10">longborder</span> </dt><dd -class="description">The <span +class="cmbx-10">longborder</span> </p></dt><dd +class="description"> + <!--l. 12031--><p class="noindent" >The <span class="cmss-10">longborder</span><a - id="dx1-158013"></a> style is like <span + id="dx1-157013"></a> style is like <span class="cmss-10">long</span><a - id="dx1-158014"></a> but has horizontal and vertical lines around it. - </dd><dt class="description"> + id="dx1-157014"></a> but has horizontal and vertical lines around it. + + + </p></dd><dt class="description"> + <!--l. 12034--><p class="noindent" > <span -class="cmbx-10">longheader</span> </dt><dd -class="description">The <span +class="cmbx-10">longheader</span> </p></dt><dd +class="description"> + <!--l. 12034--><p class="noindent" >The <span class="cmss-10">longheader</span><a - id="dx1-158015"></a> style is like <span + id="dx1-157015"></a> style is like <span class="cmss-10">long</span><a - id="dx1-158016"></a> but has a header row. - </dd><dt class="description"> + id="dx1-157016"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12037--><p class="noindent" > <span -class="cmbx-10">longheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">longheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12037--><p class="noindent" >The <span class="cmss-10">longheaderborder</span><a - id="dx1-158017"></a> style is like <span + id="dx1-157017"></a> style is like <span class="cmss-10">longheader</span><a - id="dx1-158018"></a> but has horizontal and vertical lines - around it. - - - </dd><dt class="description"> + id="dx1-157018"></a> but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12041--><p class="noindent" > <span -class="cmbx-10">long3col</span> </dt><dd -class="description">The <span +class="cmbx-10">long3col</span> </p></dt><dd +class="description"> + <!--l. 12041--><p class="noindent" >The <span class="cmss-10">long3col</span><a - id="dx1-158019"></a> style is like <span + id="dx1-157019"></a> style is like <span class="cmss-10">long</span><a - id="dx1-158020"></a> but has three columns. The first column contains the entry’s - name, the second column contains the description and the third column contains the <a + id="dx1-157020"></a> but has three columns. The first column contains the entry’s name, + the second column contains the description and the third column contains the <a href="#glo:numberlist">number list<a - id="dx1-158021"></a></a>. - The entry’s symbol is ignored. The width of the first column is governed by the widest entry in - that column, the width of the second column is governed by the length <span + id="dx1-157021"></a></a>. The + entry’s symbol is ignored. The width of the first column is governed by the widest entry in that + column, the width of the second column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-158022"></a>, and the - width of the third column is governed by the length <span + id="dx1-157022"></a>, and the width + of the third column is governed by the length <span class="cmtt-10">\glspagelistwidth</span><a - id="dx1-158023"></a>. - </dd><dt class="description"> + id="dx1-157023"></a>. + </p></dd><dt class="description"> + <!--l. 12051--><p class="noindent" > <span -class="cmbx-10">long3colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">long3colborder</span> </p></dt><dd +class="description"> + <!--l. 12051--><p class="noindent" >The <span class="cmss-10">long3colborder</span><a - id="dx1-158024"></a> style is like the <span + id="dx1-157024"></a> style is like the <span class="cmss-10">long3col</span><a - id="dx1-158025"></a> style but has horizontal and vertical lines - around it. - </dd><dt class="description"> + id="dx1-157025"></a> style but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12055--><p class="noindent" > <span -class="cmbx-10">long3colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">long3colheader</span> </p></dt><dd +class="description"> + <!--l. 12055--><p class="noindent" >The <span class="cmss-10">long3colheader</span><a - id="dx1-158026"></a> style is like <span + id="dx1-157026"></a> style is like <span class="cmss-10">long3col</span><a - id="dx1-158027"></a> but has a header row. - </dd><dt class="description"> + id="dx1-157027"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12058--><p class="noindent" > <span -class="cmbx-10">long3colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">long3colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12058--><p class="noindent" >The <span class="cmss-10">long3colheaderborder</span><a - id="dx1-158028"></a> style is like <span + id="dx1-157028"></a> style is like <span class="cmss-10">long3colheader</span><a - id="dx1-158029"></a> but has horizontal and - vertical lines around it. - </dd><dt class="description"> + id="dx1-157029"></a> but has horizontal and vertical lines around + it. + </p></dd><dt class="description"> + <!--l. 12062--><p class="noindent" > <span -class="cmbx-10">long4col</span> </dt><dd -class="description">The <span +class="cmbx-10">long4col</span> </p></dt><dd +class="description"> + <!--l. 12062--><p class="noindent" >The <span class="cmss-10">long4col</span><a - id="dx1-158030"></a> style is like <span + id="dx1-157030"></a> style is like <span class="cmss-10">long3col</span><a - id="dx1-158031"></a> but has an additional column in which the entry’s associated + id="dx1-157031"></a> but has an additional column in which the entry’s associated symbol appears. This style is used for brief single line descriptions. The column widths are governed by the widest entry in the given column. Use <span class="cmss-10">altlong4col</span><a - id="dx1-158032"></a> for multi-line descriptions. - </dd><dt class="description"> + id="dx1-157032"></a> for multi-line descriptions. + + + </p></dd><dt class="description"> + <!--l. 12069--><p class="noindent" > <span -class="cmbx-10">long4colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">long4colborder</span> </p></dt><dd +class="description"> + <!--l. 12069--><p class="noindent" >The <span class="cmss-10">long4colborder</span><a - id="dx1-158033"></a> style is like the <span + id="dx1-157033"></a> style is like the <span class="cmss-10">long4col</span><a - id="dx1-158034"></a> style but has horizontal and vertical lines - around it. - </dd><dt class="description"> + id="dx1-157034"></a> style but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12073--><p class="noindent" > <span -class="cmbx-10">long4colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">long4colheader</span> </p></dt><dd +class="description"> + <!--l. 12073--><p class="noindent" >The <span class="cmss-10">long4colheader</span><a - id="dx1-158035"></a> style is like <span + id="dx1-157035"></a> style is like <span class="cmss-10">long4col</span><a - id="dx1-158036"></a> but has a header row. - </dd><dt class="description"> + id="dx1-157036"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12076--><p class="noindent" > <span -class="cmbx-10">long4colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">long4colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12076--><p class="noindent" >The <span class="cmss-10">long4colheaderborder</span><a - id="dx1-158037"></a> style is like <span + id="dx1-157037"></a> style is like <span class="cmss-10">long4colheader</span><a - id="dx1-158038"></a> but has horizontal and - vertical lines around it. - </dd><dt class="description"> + id="dx1-157038"></a> but has horizontal and vertical lines around + it. + </p></dd><dt class="description"> + <!--l. 12080--><p class="noindent" > <span -class="cmbx-10">altlong4col</span> </dt><dd -class="description">The <span +class="cmbx-10">altlong4col</span> </p></dt><dd +class="description"> + <!--l. 12080--><p class="noindent" >The <span class="cmss-10">altlong4col</span><a - id="dx1-158039"></a> style is like <span + id="dx1-157039"></a> style is like <span class="cmss-10">long4col</span><a - id="dx1-158040"></a> but allows multi-line descriptions and page lists. The - width of the description column is governed by the length <span + id="dx1-157040"></a> but allows multi-line descriptions and page lists. The width + of the description column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-158041"></a> and the width of the page + id="dx1-157041"></a> and the width of the page list column is governed by the length <span class="cmtt-10">\glspagelistwidth</span><a - id="dx1-158042"></a>. The widths of the name and symbol + id="dx1-157042"></a>. The widths of the name and symbol columns are governed by the widest entry in the given column. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12088--><p class="noindent" > <span -class="cmbx-10">altlong4colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altlong4colborder</span> </p></dt><dd +class="description"> + <!--l. 12088--><p class="noindent" >The <span class="cmss-10">altlong4colborder</span><a - id="dx1-158043"></a> style is like the <span + id="dx1-157043"></a> style is like the <span class="cmss-10">long4colborder</span><a - id="dx1-158044"></a> but allows multi-line - descriptions and page lists. - </dd><dt class="description"> + id="dx1-157044"></a> but allows multi-line descriptions and page + lists. + </p></dd><dt class="description"> + <!--l. 12092--><p class="noindent" > <span -class="cmbx-10">altlong4colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">altlong4colheader</span> </p></dt><dd +class="description"> + <!--l. 12092--><p class="noindent" >The <span class="cmss-10">altlong4colheader</span><a - id="dx1-158045"></a> style is like <span + id="dx1-157045"></a> style is like <span class="cmss-10">long4colheader</span><a - id="dx1-158046"></a> but allows multi-line descriptions - and page lists. - </dd><dt class="description"> + id="dx1-157046"></a> but allows multi-line descriptions and page lists. + </p></dd><dt class="description"> + <!--l. 12096--><p class="noindent" > <span -class="cmbx-10">altlong4colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altlong4colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12096--><p class="noindent" >The <span class="cmss-10">altlong4colheaderborder</span><a - id="dx1-158047"></a> style is like <span + id="dx1-157047"></a> style is like <span class="cmss-10">long4colheaderborder</span><a - id="dx1-158048"></a> but allows - multi-line descriptions and page lists.</dd></dl> + id="dx1-157048"></a> but allows multi-line descriptions and + page lists.</p></dd></dl> -<!--l. 12261--><p class="noindent" > +<!--l. 12102--><p class="noindent" > </p> -<!--l. 12261--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.3 </span> <a +<!--l. 12102--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.3 </span> <a id="sec:longraggedstyles"></a>Longtable Styles (Ragged Right)</h4> -<!--l. 12264--><p class="noindent" >The styles described in this section are all defined in the package <span +<!--l. 12105--><p class="noindent" >The styles described in this section are all defined in the package <span class="cmss-10">glossary-longragged</span><a - id="dx1-159001"></a>. These styles are analogous + id="dx1-158001"></a>. These styles are analogous to those defined in <span class="cmss-10">glossary-long</span><a - id="dx1-159002"></a> but the multiline columns are left justified instead of fully justified. Since these + id="dx1-158002"></a> but the multiline columns are left justified instead of fully justified. Since these styles all use the <span class="cmss-10">longtable</span><a - id="dx1-159003"></a><a - id="dx1-159004"></a> environment, they are governed by the same parameters as that environment. The + id="dx1-158003"></a><a + id="dx1-158004"></a> environment, they are governed by the same parameters as that environment. The <span class="cmss-10">glossary-longragged</span><a - id="dx1-159005"></a> package additionally requires the <span + id="dx1-158005"></a> package additionally requires the <span class="cmss-10">array</span><a - id="dx1-159006"></a> package. Note that these styles will only be available + id="dx1-158006"></a> package. Note that these styles will only be available if you explicitly load <span class="cmss-10">glossary-longragged</span><a - id="dx1-159007"></a>: + id="dx1-158007"></a>: </p> - <div class="verbatim" id="verbatim-366"> + <pre class="verbatim" id="verbatim-340"> \usepackage{glossaries} - <br />\usepackage{glossary-longragged} -</div> -<!--l. 12276--><p class="nopar" > Note that you can’t set these styles using the <span +\usepackage{glossary-longragged} +</pre> +<!--l. 12117--><p class="nopar" > Note that you can’t set these styles using the <span class="cmss-10">style</span><a - id="dx1-159008"></a> package option since the styles aren’t defined until after the + id="dx1-158008"></a> package option since the styles aren’t defined until after the <span class="cmss-10">glossaries </span>package has been loaded. If you want to incorporate rules from the <span class="cmss-10">booktabs</span><a - id="dx1-159009"></a> package, try the styles + id="dx1-158009"></a> package, try the styles described in <a -href="#sec:longbooktabsstyles">§15.1.4 </a><a +href="#sec:longbooktabsstyles">§<span +class="cmbx-10">??</span>sec:longbooktabsstyles </a><a href="#sec:longbooktabsstyles">Longtable Styles (<span class="cmss-10">booktabs</span>)<!--tex4ht:ref: sec:longbooktabsstyles --></a>. </p><dl class="description"><dt class="description"> + <!--l. 12125--><p class="noindent" > <span -class="cmbx-10">longragged</span> </dt><dd -class="description">The <span +class="cmbx-10">longragged</span> </p></dt><dd +class="description"> + <!--l. 12125--><p class="noindent" >The <span class="cmss-10">longragged</span><a - id="dx1-159010"></a> style has two columns: the first column contains the entry’s name and the - second column contains the (left-justified) description followed by the <a + id="dx1-158010"></a> style has two columns: the first column contains the entry’s name and the second + column contains the (left-justified) description followed by the <a href="#glo:numberlist">number list<a - id="dx1-159011"></a></a>. The entry’s - symbol is ignored. Sub groups are separated with a blank row. The width of the first column is - governed by the widest entry in that column. The width of the second column is governed by the - length <span + id="dx1-158011"></a></a>. The entry’s symbol is + ignored. Sub groups are separated with a blank row. The width of the first column is governed + by the widest entry in that column. The width of the second column is governed by the length + <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-159012"></a>. Child entries have a similar format to the parent entries except that their - name is suppressed. - </dd><dt class="description"> + id="dx1-158012"></a>. Child entries have a similar format to the parent entries except that their name + is suppressed. + </p></dd><dt class="description"> + <!--l. 12135--><p class="noindent" > <span -class="cmbx-10">longraggedborder</span> </dt><dd -class="description">The <span +class="cmbx-10">longraggedborder</span> </p></dt><dd +class="description"> + <!--l. 12135--><p class="noindent" >The <span class="cmss-10">longraggedborder</span><a - id="dx1-159013"></a> style is like <span + id="dx1-158013"></a> style is like <span class="cmss-10">longragged</span><a - id="dx1-159014"></a> but has horizontal and vertical lines - around it. - </dd><dt class="description"> + id="dx1-158014"></a> but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12138--><p class="noindent" > <span -class="cmbx-10">longraggedheader</span> </dt><dd -class="description">The <span +class="cmbx-10">longraggedheader</span> </p></dt><dd +class="description"> + <!--l. 12138--><p class="noindent" >The <span class="cmss-10">longraggedheader</span><a - id="dx1-159015"></a> style is like <span + id="dx1-158015"></a> style is like <span class="cmss-10">longragged</span><a - id="dx1-159016"></a> but has a header row. - </dd><dt class="description"> + id="dx1-158016"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12141--><p class="noindent" > <span -class="cmbx-10">longraggedheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">longraggedheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12141--><p class="noindent" >The <span class="cmss-10">longraggedheaderborder</span><a - id="dx1-159017"></a> style is like <span + id="dx1-158017"></a> style is like <span class="cmss-10">longraggedheader</span><a - id="dx1-159018"></a> but has horizontal - and vertical lines around it. - </dd><dt class="description"> + id="dx1-158018"></a> but has horizontal and vertical lines + around it. + </p></dd><dt class="description"> + <!--l. 12145--><p class="noindent" > <span -class="cmbx-10">longragged3col</span> </dt><dd -class="description">The <span +class="cmbx-10">longragged3col</span> </p></dt><dd +class="description"> + <!--l. 12145--><p class="noindent" >The <span class="cmss-10">longragged3col</span><a - id="dx1-159019"></a> style is like <span + id="dx1-158019"></a> style is like <span class="cmss-10">longragged</span><a - id="dx1-159020"></a> but has three columns. The first column - contains the entry’s name, the second column contains the (left justified) description and the third - column contains the (left justified) <a + id="dx1-158020"></a> but has three columns. The first column contains the + entry’s name, the second column contains the (left justified) description and the third column + contains the (left justified) <a href="#glo:numberlist">number list<a - id="dx1-159021"></a></a>. The entry’s symbol is ignored. The width of the - first column is governed by the widest entry in that column, the width of the second column is - governed by the length <span + id="dx1-158021"></a></a>. The entry’s symbol is ignored. The width of the first + column is governed by the widest entry in that column, the width of the second column is governed + by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-159022"></a>, and the width of the third column is governed by the - length <span + id="dx1-158022"></a>, and the width of the third column is governed by the length + <span class="cmtt-10">\glspagelistwidth</span><a - id="dx1-159023"></a>. - </dd><dt class="description"> + id="dx1-158023"></a>. + + + </p></dd><dt class="description"> + <!--l. 12155--><p class="noindent" > <span -class="cmbx-10">longragged3colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">longragged3colborder</span> </p></dt><dd +class="description"> + <!--l. 12155--><p class="noindent" >The <span class="cmss-10">longragged3colborder</span><a - id="dx1-159024"></a> style is like the <span + id="dx1-158024"></a> style is like the <span class="cmss-10">longragged3col</span><a - id="dx1-159025"></a> style but has horizontal - and vertical lines around it. - </dd><dt class="description"> + id="dx1-158025"></a> style but has horizontal and vertical lines + around it. + </p></dd><dt class="description"> + <!--l. 12159--><p class="noindent" > <span -class="cmbx-10">longragged3colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">longragged3colheader</span> </p></dt><dd +class="description"> + <!--l. 12159--><p class="noindent" >The <span class="cmss-10">longragged3colheader</span><a - id="dx1-159026"></a> style is like <span + id="dx1-158026"></a> style is like <span class="cmss-10">longragged3col</span><a - id="dx1-159027"></a> but has a header row. - </dd><dt class="description"> + id="dx1-158027"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12162--><p class="noindent" > <span -class="cmbx-10">longragged3colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">longragged3colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12162--><p class="noindent" >The <span class="cmss-10">longragged3colheaderborder</span><a - id="dx1-159028"></a> style is like <span + id="dx1-158028"></a> style is like <span class="cmss-10">longragged3colheader</span><a - id="dx1-159029"></a> but - has horizontal and vertical lines around it. - - - </dd><dt class="description"> + id="dx1-158029"></a> but has horizontal and vertical + lines around it. + </p></dd><dt class="description"> + <!--l. 12166--><p class="noindent" > <span -class="cmbx-10">altlongragged4col</span> </dt><dd -class="description">The <span +class="cmbx-10">altlongragged4col</span> </p></dt><dd +class="description"> + <!--l. 12166--><p class="noindent" >The <span class="cmss-10">altlongragged4col</span><a - id="dx1-159030"></a> style is like <span + id="dx1-158030"></a> style is like <span class="cmss-10">longragged3col</span><a - id="dx1-159031"></a> but has an additional column in - which the entry’s associated symbol appears. The width of the description column is governed - by the length <span + id="dx1-158031"></a> but has an additional column in which the + entry’s associated symbol appears. The width of the description column is governed by the + length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-159032"></a> and the width of the page list column is governed by the length + id="dx1-158032"></a> and the width of the page list column is governed by the length <span class="cmtt-10">\glspagelistwidth</span><a - id="dx1-159033"></a>. The widths of the name and symbol columns are governed by the widest + id="dx1-158033"></a>. The widths of the name and symbol columns are governed by the widest entry in the given column. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12174--><p class="noindent" > <span -class="cmbx-10">altlongragged4colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altlongragged4colborder</span> </p></dt><dd +class="description"> + <!--l. 12174--><p class="noindent" >The <span class="cmss-10">altlongragged4colborder</span><a - id="dx1-159034"></a> style is like the <span + id="dx1-158034"></a> style is like the <span class="cmss-10">altlongragged4col</span><a - id="dx1-159035"></a> but has - horizontal and vertical lines around it. - </dd><dt class="description"> + id="dx1-158035"></a> but has horizontal and vertical lines + around it. + </p></dd><dt class="description"> + <!--l. 12179--><p class="noindent" > <span -class="cmbx-10">altlongragged4colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">altlongragged4colheader</span> </p></dt><dd +class="description"> + <!--l. 12179--><p class="noindent" >The <span class="cmss-10">altlongragged4colheader</span><a - id="dx1-159036"></a> style is like <span + id="dx1-158036"></a> style is like <span class="cmss-10">altlongragged4col</span><a - id="dx1-159037"></a> but has a header - row. - </dd><dt class="description"> + id="dx1-158037"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12183--><p class="noindent" > <span -class="cmbx-10">altlongragged4colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altlongragged4colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12183--><p class="noindent" >The <span class="cmss-10">altlongragged4colheaderborder</span><a - id="dx1-159038"></a> style is like - <span + id="dx1-158038"></a> style is like <span class="cmss-10">altlongragged4colheader</span><a - id="dx1-159039"></a> but has horizontal and vertical lines around it. + id="dx1-158039"></a> but has horizontal and + vertical lines around it. +</p> </dd></dl> -<!--l. 12349--><p class="noindent" > + + +<!--l. 12190--><p class="noindent" > </p> -<!--l. 12349--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.4 </span> <a +<!--l. 12190--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.4 </span> <a id="sec:longbooktabsstyles"></a>Longtable Styles (<span class="cmss-10">booktabs</span>)</h4> -<!--l. 12352--><p class="noindent" >The styles described in this section are all defined in the package <span +<!--l. 12193--><p class="noindent" >The styles described in this section are all defined in the package <span class="cmss-10">glossary-longbooktabs</span><a - id="dx1-160001"></a>. -</p><!--l. 12355--><p class="indent" > Since these styles all use the <span + id="dx1-159001"></a>. +</p><!--l. 12196--><p class="indent" > Since these styles all use the <span class="cmss-10">longtable</span><a - id="dx1-160002"></a><a - id="dx1-160003"></a> environment, they are governed by the same parameters as that + id="dx1-159002"></a><a + id="dx1-159003"></a> environment, they are governed by the same parameters as that environment. The <span class="cmss-10">glossary-longbooktabs</span><a - id="dx1-160004"></a> package automatically loads the <span + id="dx1-159004"></a> package automatically loads the <span class="cmss-10">glossary-long</span><a - id="dx1-160005"></a> (<a -href="#sec:longstyles">§15.1.2 </a><a -href="#sec:longstyles">Longtable Styles<!--tex4ht:ref: sec:longstyles --></a>) -and <span + id="dx1-159005"></a> (<a +href="#sec:longstyles">§<span +class="cmbx-10">??</span>sec:longstyles +</a><a +href="#sec:longstyles">Longtable Styles<!--tex4ht:ref: sec:longstyles --></a>) and <span class="cmss-10">glossary-longragged</span><a - id="dx1-160006"></a> (<a -href="#sec:longraggedstyles">§15.1.3 </a><a -href="#sec:longraggedstyles">Longtable Styles (Ragged Right)<!--tex4ht:ref: sec:longraggedstyles --></a>) packages. Note that these styles will only be -available if you explicitly load <span + id="dx1-159006"></a> (<a +href="#sec:longraggedstyles">§<span +class="cmbx-10">??</span>sec:longraggedstyles </a><a +href="#sec:longraggedstyles">Longtable Styles (Ragged Right)<!--tex4ht:ref: sec:longraggedstyles --></a>) packages. +Note that these styles will only be available if you explicitly load <span class="cmss-10">glossary-longbooktabs</span><a - id="dx1-160007"></a>: + id="dx1-159007"></a>: </p> - <div class="verbatim" id="verbatim-367"> + <pre class="verbatim" id="verbatim-341"> \usepackage{glossaries} - <br />\usepackage{glossary-longbooktabs} -</div> -<!--l. 12366--><p class="nopar" > Note that you can’t set these styles using the <span +\usepackage{glossary-longbooktabs} +</pre> +<!--l. 12207--><p class="nopar" > Note that you can’t set these styles using the <span class="cmss-10">style</span><a - id="dx1-160008"></a> package option since the styles aren’t defined until after the + id="dx1-159008"></a> package option since the styles aren’t defined until after the <span class="cmss-10">glossaries </span>package has been loaded. -</p><!--l. 12371--><p class="indent" > These styles are similar to the “header” styles in the <span +</p><!--l. 12212--><p class="indent" > These styles are similar to the “header” styles in the <span class="cmss-10">glossary-long</span><a - id="dx1-160009"></a> and <span + id="dx1-159009"></a> and <span class="cmss-10">glossary-ragged</span><a - id="dx1-160010"></a> packages, but they add + id="dx1-159010"></a> packages, but they add the rules provided by the <span class="cmss-10">booktabs</span><a - id="dx1-160011"></a> package, <span + id="dx1-159011"></a> package, <span class="cmtt-10">\toprule</span><a - id="dx1-160012"></a>, <span + id="dx1-159012"></a>, <span class="cmtt-10">\midrule</span><a - id="dx1-160013"></a> and <span + id="dx1-159013"></a> and <span class="cmtt-10">\bottomrule</span><a - id="dx1-160014"></a>. Additionally these styles + id="dx1-159014"></a>. Additionally these styles patch the <span class="cmss-10">longtable</span><a - id="dx1-160015"></a><a - id="dx1-160016"></a> environment to check for instances of the group skip occurring at a page break. If you don’t + id="dx1-159015"></a><a + id="dx1-159016"></a> environment to check for instances of the group skip occurring at a page break. If you don’t want this patch to affect any other use of <span class="cmss-10">longtable</span><a - id="dx1-160017"></a><a - id="dx1-160018"></a> in your document, you can scope the effect by only setting + id="dx1-159017"></a><a + id="dx1-159018"></a> in your document, you can scope the effect by only setting the style through the <span class="cmtt-10">style</span><a - id="dx1-160019"></a> key in the optional argument of <span + id="dx1-159019"></a> key in the optional argument of <span class="cmtt-10">\printglossary</span>. (The <span class="cmss-10">nogroupskip</span><a - id="dx1-160020"></a> package option + id="dx1-159020"></a> package option is checked by these styles.) -</p><!--l. 12384--><p class="indent" > Alternatively, you can restore the original <span +</p><!--l. 12225--><p class="indent" > Alternatively, you can restore the original <span class="cmss-10">longtable</span><a - id="dx1-160021"></a><a - id="dx1-160022"></a> behaviour with: -</p><!--l. 12386--><p class="indent" > <hr><div title="Definition"><a - id="dx1-160023"></a> <span + id="dx1-159021"></a><a + id="dx1-159022"></a> behaviour with: +</p><!--l. 12227--><p class="indent" > <hr><div title="Definition"><a + id="dx1-159023"></a> <span class="cmtt-10">\glsrestoreLToutput </span></div><hr> -</p><!--l. 12388--><p class="noindent" > +</p><!--l. 12229--><p class="noindent" > For more information about the patch, see the documented code (<span class="cmtt-10">glossaries-code.pdf</span>). </p><dl class="description"><dt class="description"> + <!--l. 12234--><p class="noindent" > <span class="cmssbx-10">long-booktabs</span><a - id="dx1-160024"></a> </dt><dd -class="description">This style is similar to the <span + id="dx1-159024"></a> </p></dt><dd +class="description"> + <!--l. 12234--><p class="noindent" >This style is similar to the <span class="cmss-10">longheader</span><a - id="dx1-160025"></a> style but adds rules above and below the header - (<span -class="cmtt-10">\toprule </span>and <span + id="dx1-159025"></a> style but adds rules above and below the header (<span +class="cmtt-10">\toprule</span> + and <span class="cmtt-10">\midrule</span>) and inserts a rule at the bottom of the table (<span class="cmtt-10">\bottomrule</span>). - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12239--><p class="noindent" > <span class="cmssbx-10">long3col-booktabs</span><a - id="dx1-160026"></a> </dt><dd -class="description">This style is similar to the <span + id="dx1-159026"></a> </p></dt><dd +class="description"> + <!--l. 12239--><p class="noindent" >This style is similar to the <span class="cmss-10">long3colheader</span><a - id="dx1-160027"></a> style but adds rules as per <span + id="dx1-159027"></a> style but adds rules as per <span class="cmss-10">long-booktabs</span><a - id="dx1-160028"></a>. - </dd><dt class="description"> + id="dx1-159028"></a>. + </p></dd><dt class="description"> + <!--l. 12243--><p class="noindent" > <span class="cmssbx-10">long4col-booktabs</span><a - id="dx1-160029"></a> </dt><dd -class="description">This style is similar to the <span + id="dx1-159029"></a> </p></dt><dd +class="description"> + <!--l. 12243--><p class="noindent" >This style is similar to the <span class="cmss-10">long4colheader</span><a - id="dx1-160030"></a> style but adds rules as above. - </dd><dt class="description"> + id="dx1-159030"></a> style but adds rules as above. + </p></dd><dt class="description"> + <!--l. 12246--><p class="noindent" > <span class="cmssbx-10">altlong4col-booktabs</span><a - id="dx1-160031"></a> </dt><dd -class="description">This style is similar to the <span + id="dx1-159031"></a> </p></dt><dd +class="description"> + <!--l. 12246--><p class="noindent" >This style is similar to the <span class="cmss-10">altlong4colheader</span><a - id="dx1-160032"></a> style but adds rules as above. - </dd><dt class="description"> + id="dx1-159032"></a> style but adds rules as above. + </p></dd><dt class="description"> + <!--l. 12249--><p class="noindent" > <span class="cmssbx-10">longragged-booktabs</span><a - id="dx1-160033"></a> </dt><dd -class="description">This style is similar to the <span + id="dx1-159033"></a> </p></dt><dd +class="description"> + <!--l. 12249--><p class="noindent" >This style is similar to the <span class="cmss-10">longraggedheader</span><a - id="dx1-160034"></a> style but adds rules as above. - </dd><dt class="description"> + id="dx1-159034"></a> style but adds rules as above. + + + </p></dd><dt class="description"> + <!--l. 12252--><p class="noindent" > <span class="cmssbx-10">longragged3col-booktabs</span><a - id="dx1-160035"></a> </dt><dd -class="description">This style is similar to the <span + id="dx1-159035"></a> </p></dt><dd +class="description"> + <!--l. 12252--><p class="noindent" >This style is similar to the <span class="cmss-10">longragged3colheader</span><a - id="dx1-160036"></a> style but adds rules as above. - </dd><dt class="description"> + id="dx1-159036"></a> style but adds rules as above. + </p></dd><dt class="description"> + <!--l. 12255--><p class="noindent" > <span class="cmssbx-10">altlongragged4col-booktabs</span><a - id="dx1-160037"></a> </dt><dd -class="description">This style is similar to the <span + id="dx1-159037"></a> </p></dt><dd +class="description"> + <!--l. 12255--><p class="noindent" >This style is similar to the <span class="cmss-10">altlongragged4colheader</span><a - id="dx1-160038"></a> style but adds rules as - above. + id="dx1-159038"></a> style but adds rules as above. +</p> </dd></dl> - - -<!--l. 12419--><p class="noindent" > +<!--l. 12260--><p class="noindent" > </p> -<!--l. 12419--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.5 </span> <a +<!--l. 12260--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.5 </span> <a id="sec:superstyles"></a>Supertabular Styles</h4> -<!--l. 12422--><p class="noindent" >The styles described in this section are all defined in the package <span +<!--l. 12263--><p class="noindent" >The styles described in this section are all defined in the package <span class="cmss-10">glossary-super</span><a - id="dx1-161001"></a>. Since they all use the + id="dx1-160001"></a>. Since they all use the <span class="cmss-10">supertabular</span><a - id="dx1-161002"></a><a - id="dx1-161003"></a> environment, they are governed by the same parameters as that environment. Note that these styles + id="dx1-160002"></a><a + id="dx1-160003"></a> environment, they are governed by the same parameters as that environment. Note that these styles will automatically be available unless you use the <span class="cmss-10">nosuper</span><a - id="dx1-161004"></a> or <span + id="dx1-160004"></a> or <span class="cmss-10">nostyles</span><a - id="dx1-161005"></a> package options. In general, + id="dx1-160005"></a> package options. In general, the <span class="cmss-10">longtable</span><a - id="dx1-161006"></a><a - id="dx1-161007"></a> environment is better, but there are some circumstances where it is better to use + id="dx1-160006"></a><a + id="dx1-160007"></a> environment is better, but there are some circumstances where it is better to use <span class="cmss-10">supertabular</span><a - id="dx1-161008"></a><a - id="dx1-161009"></a>.<span class="footnote-mark"><a -href="#fn3x15" id="fn3x15-bk"><sup class="textsuperscript">15.3</sup></a></span><a - id="x1-161010f3"></a> -These styles fully justify the description and page list columns. If you want ragged right formatting instead, use -the analogous styles described in <a -href="#sec:superraggedstyles">§15.1.6 </a><a -href="#sec:superraggedstyles">Supertabular Styles (Ragged Right)<!--tex4ht:ref: sec:superraggedstyles --></a>. + id="dx1-160008"></a><a + id="dx1-160009"></a>.<span class="footnote-mark"><a +href="#fn3x13" id="fn3x13-bk"><sup class="textsuperscript">13.3</sup></a></span><a + id="x1-160010f3"></a> +These styles fully justify the description and page list columns. If you want ragged right formatting +instead, use the analogous styles described in <a +href="#sec:superraggedstyles">§<span +class="cmbx-10">??</span>sec:superraggedstyles </a><a +href="#sec:superraggedstyles">Supertabular Styles (Ragged +Right)<!--tex4ht:ref: sec:superraggedstyles --></a>. </p><dl class="description"><dt class="description"> + <!--l. 12276--><p class="noindent" > <span -class="cmbx-10">super</span> </dt><dd -class="description">The <span +class="cmbx-10">super</span> </p></dt><dd +class="description"> + <!--l. 12276--><p class="noindent" >The <span class="cmss-10">super</span><a - id="dx1-161012"></a> style uses the <span + id="dx1-160012"></a> style uses the <span class="cmss-10">supertabular</span><a - id="dx1-161013"></a><a - id="dx1-161014"></a> environment (defined by the <span + id="dx1-160013"></a><a + id="dx1-160014"></a> environment (defined by the <span class="cmss-10">supertabular</span><a - id="dx1-161015"></a> package). It has two + id="dx1-160015"></a> package). It has two columns: the first column contains the entry’s name and the second column contains the description followed by the <a href="#glo:numberlist">number list<a - id="dx1-161016"></a></a>. The entry’s symbol is ignored. Sub groups are separated with a blank + id="dx1-160016"></a></a>. The entry’s symbol is ignored. Sub groups are separated with a blank row. The width of the first column is governed by the widest entry in that column. The width of the second column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-161017"></a>. Child entries have a similar format + id="dx1-160017"></a>. Child entries have a similar format to the parent entries except that their name is suppressed. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12287--><p class="noindent" > <span -class="cmbx-10">superborder</span> </dt><dd -class="description">The <span +class="cmbx-10">superborder</span> </p></dt><dd +class="description"> + <!--l. 12287--><p class="noindent" >The <span class="cmss-10">superborder</span><a - id="dx1-161018"></a> style is like <span + id="dx1-160018"></a> style is like <span class="cmss-10">super</span><a - id="dx1-161019"></a> but has horizontal and vertical lines around it. - </dd><dt class="description"> + id="dx1-160019"></a> but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12290--><p class="noindent" > <span -class="cmbx-10">superheader</span> </dt><dd -class="description">The <span +class="cmbx-10">superheader</span> </p></dt><dd +class="description"> + + + <!--l. 12290--><p class="noindent" >The <span class="cmss-10">superheader</span><a - id="dx1-161020"></a> style is like <span + id="dx1-160020"></a> style is like <span class="cmss-10">super</span><a - id="dx1-161021"></a> but has a header row. - </dd><dt class="description"> + id="dx1-160021"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12293--><p class="noindent" > <span -class="cmbx-10">superheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">superheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12293--><p class="noindent" >The <span class="cmss-10">superheaderborder</span><a - id="dx1-161022"></a> style is like <span + id="dx1-160022"></a> style is like <span class="cmss-10">superheader</span><a - id="dx1-161023"></a> but has horizontal and vertical - lines around it. - </dd><dt class="description"> + id="dx1-160023"></a> but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12297--><p class="noindent" > <span -class="cmbx-10">super3col</span> </dt><dd -class="description">The <span +class="cmbx-10">super3col</span> </p></dt><dd +class="description"> + <!--l. 12297--><p class="noindent" >The <span class="cmss-10">super3col</span><a - id="dx1-161024"></a> style is like <span + id="dx1-160024"></a> style is like <span class="cmss-10">super</span><a - id="dx1-161025"></a> but has three columns. The first column contains the entry’s - name, the second column contains the description and the third column contains the <a + id="dx1-160025"></a> but has three columns. The first column contains the entry’s name, + the second column contains the description and the third column contains the <a href="#glo:numberlist">number list<a - id="dx1-161026"></a></a>. - The entry’s symbol is ignored. The width of the first column is governed by the widest entry in that + id="dx1-160026"></a></a>. The + entry’s symbol is ignored. The width of the first column is governed by the widest entry in that column. The width of the second column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-161027"></a>. The width of + id="dx1-160027"></a>. The width of the third column is governed by the length <span class="cmtt-10">\glspagelistwidth</span><a - id="dx1-161028"></a>. - </dd><dt class="description"> + id="dx1-160028"></a>. + </p></dd><dt class="description"> + <!--l. 12307--><p class="noindent" > <span -class="cmbx-10">super3colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">super3colborder</span> </p></dt><dd +class="description"> + <!--l. 12307--><p class="noindent" >The <span class="cmss-10">super3colborder</span><a - id="dx1-161029"></a> style is like the <span + id="dx1-160029"></a> style is like the <span class="cmss-10">super3col</span><a - id="dx1-161030"></a> style but has horizontal and vertical - lines around it. - </dd><dt class="description"> + id="dx1-160030"></a> style but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12311--><p class="noindent" > <span -class="cmbx-10">super3colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">super3colheader</span> </p></dt><dd +class="description"> + <!--l. 12311--><p class="noindent" >The <span class="cmss-10">super3colheader</span><a - id="dx1-161031"></a> style is like <span + id="dx1-160031"></a> style is like <span class="cmss-10">super3col</span><a - id="dx1-161032"></a> but has a header row. - </dd><dt class="description"> + id="dx1-160032"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12314--><p class="noindent" > <span -class="cmbx-10">super3colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">super3colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12314--><p class="noindent" >The <span class="cmss-10">super3colheaderborder</span><a - id="dx1-161033"></a> style is like the <span + id="dx1-160033"></a> style is like the <span class="cmss-10">super3colheader</span><a - id="dx1-161034"></a> style but has - horizontal and vertical lines around it. - - - </dd><dt class="description"> + id="dx1-160034"></a> style but has horizontal and vertical lines + around it. + </p></dd><dt class="description"> + <!--l. 12318--><p class="noindent" > <span -class="cmbx-10">super4col</span> </dt><dd -class="description">The <span +class="cmbx-10">super4col</span> </p></dt><dd +class="description"> + <!--l. 12318--><p class="noindent" >The <span class="cmss-10">super4col</span><a - id="dx1-161035"></a> style is like <span + id="dx1-160035"></a> style is like <span class="cmss-10">super3col</span><a - id="dx1-161036"></a> but has an additional column in which the entry’s - associated symbol appears. This style is designed for entries with brief single line descriptions. The - column widths are governed by the widest entry in the given column. Use <span + id="dx1-160036"></a> but has an additional column in which the entry’s associated + symbol appears. This style is designed for entries with brief single line descriptions. The column + widths are governed by the widest entry in the given column. Use <span class="cmss-10">altsuper4col</span><a - id="dx1-161037"></a> for multi-line + id="dx1-160037"></a> for multi-line descriptions. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12325--><p class="noindent" > <span -class="cmbx-10">super4colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">super4colborder</span> </p></dt><dd +class="description"> + <!--l. 12325--><p class="noindent" >The <span class="cmss-10">super4colborder</span><a - id="dx1-161038"></a> style is like the <span + id="dx1-160038"></a> style is like the <span class="cmss-10">super4col</span><a - id="dx1-161039"></a> style but has horizontal and vertical - lines around it. - </dd><dt class="description"> + id="dx1-160039"></a> style but has horizontal and vertical lines around it. + + + </p></dd><dt class="description"> + <!--l. 12329--><p class="noindent" > <span -class="cmbx-10">super4colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">super4colheader</span> </p></dt><dd +class="description"> + <!--l. 12329--><p class="noindent" >The <span class="cmss-10">super4colheader</span><a - id="dx1-161040"></a> style is like <span + id="dx1-160040"></a> style is like <span class="cmss-10">super4col</span><a - id="dx1-161041"></a> but has a header row. - </dd><dt class="description"> + id="dx1-160041"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12332--><p class="noindent" > <span -class="cmbx-10">super4colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">super4colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12332--><p class="noindent" >The <span class="cmss-10">super4colheaderborder</span><a - id="dx1-161042"></a> style is like the <span + id="dx1-160042"></a> style is like the <span class="cmss-10">super4colheader</span><a - id="dx1-161043"></a> style but has - horizontal and vertical lines around it. - </dd><dt class="description"> + id="dx1-160043"></a> style but has horizontal and vertical lines + around it. + </p></dd><dt class="description"> + <!--l. 12336--><p class="noindent" > <span -class="cmbx-10">altsuper4col</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuper4col</span> </p></dt><dd +class="description"> + <!--l. 12336--><p class="noindent" >The <span class="cmss-10">altsuper4col</span><a - id="dx1-161044"></a> style is like <span + id="dx1-160044"></a> style is like <span class="cmss-10">super4col</span><a - id="dx1-161045"></a> but allows multi-line descriptions and page lists. - The width of the description column is governed by the length <span + id="dx1-160045"></a> but allows multi-line descriptions and page lists. The width + of the description column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-161046"></a> and the width of - the page list column is governed by the length <span + id="dx1-160046"></a> and the width of the page list + column is governed by the length <span class="cmtt-10">\glspagelistwidth</span><a - id="dx1-161047"></a>. The width of the name and - symbol columns is governed by the widest entry in the given column. - </dd><dt class="description"> + id="dx1-160047"></a>. The width of the name and symbol columns + is governed by the widest entry in the given column. + </p></dd><dt class="description"> + <!--l. 12345--><p class="noindent" > <span -class="cmbx-10">altsuper4colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuper4colborder</span> </p></dt><dd +class="description"> + <!--l. 12345--><p class="noindent" >The <span class="cmss-10">altsuper4colborder</span><a - id="dx1-161048"></a> style is like the <span + id="dx1-160048"></a> style is like the <span class="cmss-10">super4colborder</span><a - id="dx1-161049"></a> style but allows multi-line - descriptions and page lists. - </dd><dt class="description"> + id="dx1-160049"></a> style but allows multi-line descriptions and + page lists. + </p></dd><dt class="description"> + <!--l. 12349--><p class="noindent" > <span -class="cmbx-10">altsuper4colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuper4colheader</span> </p></dt><dd +class="description"> + <!--l. 12349--><p class="noindent" >The <span class="cmss-10">altsuper4colheader</span><a - id="dx1-161050"></a> style is like <span + id="dx1-160050"></a> style is like <span class="cmss-10">super4colheader</span><a - id="dx1-161051"></a> but allows multi-line - descriptions and page lists. - </dd><dt class="description"> + id="dx1-160051"></a> but allows multi-line descriptions and page lists. + </p></dd><dt class="description"> + <!--l. 12353--><p class="noindent" > <span -class="cmbx-10">altsuper4colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuper4colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12353--><p class="noindent" >The <span class="cmss-10">altsuper4colheaderborder</span><a - id="dx1-161052"></a> style is like <span + id="dx1-160052"></a> style is like <span class="cmss-10">super4colheaderborder</span><a - id="dx1-161053"></a> but allows - multi-line descriptions and page lists.</dd></dl> -<!--l. 12518--><p class="noindent" > + id="dx1-160053"></a> but allows multi-line descriptions + and page lists.</p></dd></dl> +<!--l. 12359--><p class="noindent" > </p> -<!--l. 12518--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.6 </span> <a +<!--l. 12359--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.6 </span> <a id="sec:superraggedstyles"></a>Supertabular Styles (Ragged Right)</h4> -<!--l. 12521--><p class="noindent" >The styles described in this section are all defined in the package <span +<!--l. 12362--><p class="noindent" >The styles described in this section are all defined in the package <span class="cmss-10">glossary-superragged</span><a - id="dx1-162001"></a>. These styles are + id="dx1-161001"></a>. These styles are analogous to those defined in <span class="cmss-10">glossary-super</span><a - id="dx1-162002"></a> but the multiline columns are left justified instead of fully justified. + id="dx1-161002"></a> but the multiline columns are left justified instead of fully justified. Since these styles all use the <span class="cmss-10">supertabular</span><a - id="dx1-162003"></a><a - id="dx1-162004"></a> environment, they are governed by the same parameters as that + id="dx1-161003"></a><a + id="dx1-161004"></a> environment, they are governed by the same parameters as that environment. The <span class="cmss-10">glossary-superragged</span><a - id="dx1-162005"></a> package additionally requires the <span + id="dx1-161005"></a> package additionally requires the <span class="cmss-10">array</span><a - id="dx1-162006"></a> package. Note that these styles + id="dx1-161006"></a> package. Note that these styles will only be available if you explicitly load <span class="cmss-10">glossary-superragged</span><a - id="dx1-162007"></a>: + id="dx1-161007"></a>: </p> - <div class="verbatim" id="verbatim-368"> + <pre class="verbatim" id="verbatim-342"> \usepackage{glossaries} - <br />\usepackage{glossary-superragged} -</div> -<!--l. 12533--><p class="nopar" > Note that you can’t set these styles using the <span +\usepackage{glossary-superragged} +</pre> +<!--l. 12374--><p class="nopar" > Note that you can’t set these styles using the <span class="cmss-10">style</span><a - id="dx1-162008"></a> package option since the styles aren’t defined until after the + id="dx1-161008"></a> package option since the styles aren’t defined until after the <span class="cmss-10">glossaries </span>package has been loaded. </p><dl class="description"><dt class="description"> + <!--l. 12380--><p class="noindent" > <span -class="cmbx-10">superragged</span> </dt><dd -class="description">The <span +class="cmbx-10">superragged</span> </p></dt><dd +class="description"> + <!--l. 12380--><p class="noindent" >The <span class="cmss-10">superragged</span><a - id="dx1-162009"></a> style uses the <span + id="dx1-161009"></a> style uses the <span class="cmss-10">supertabular</span><a - id="dx1-162010"></a><a - id="dx1-162011"></a> environment (defined by the <span + id="dx1-161010"></a><a + id="dx1-161011"></a> environment (defined by the <span class="cmss-10">supertabular</span><a - id="dx1-162012"></a> - package). It has two columns: the first column contains the entry’s name and the second column - contains the (left justified) description followed by the <a + id="dx1-161012"></a> package). It + has two columns: the first column contains the entry’s name and the second column contains the + (left justified) description followed by the <a href="#glo:numberlist">number list<a - id="dx1-162013"></a></a>. The entry’s symbol is ignored. - Sub groups are separated with a blank row. The width of the first column is governed by the widest - entry in that column. The width of the second column is governed by the length <span + id="dx1-161013"></a></a>. The entry’s symbol is ignored. Sub groups + are separated with a blank row. The width of the first column is governed by the widest entry in + that column. The width of the second column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-162014"></a>. - Child entries have a similar format to the parent entries except that their name is suppressed. - </dd><dt class="description"> + id="dx1-161014"></a>. Child + entries have a similar format to the parent entries except that their name is suppressed. + </p></dd><dt class="description"> + <!--l. 12391--><p class="noindent" > <span -class="cmbx-10">superraggedborder</span> </dt><dd -class="description">The <span +class="cmbx-10">superraggedborder</span> </p></dt><dd +class="description"> + <!--l. 12391--><p class="noindent" >The <span class="cmss-10">superraggedborder</span><a - id="dx1-162015"></a> style is like <span + id="dx1-161015"></a> style is like <span class="cmss-10">superragged</span><a - id="dx1-162016"></a> but has horizontal and vertical - lines around it. - </dd><dt class="description"> + id="dx1-161016"></a> but has horizontal and vertical lines around it. + </p></dd><dt class="description"> + <!--l. 12395--><p class="noindent" > <span -class="cmbx-10">superraggedheader</span> </dt><dd -class="description">The <span +class="cmbx-10">superraggedheader</span> </p></dt><dd +class="description"> + <!--l. 12395--><p class="noindent" >The <span class="cmss-10">superraggedheader</span><a - id="dx1-162017"></a> style is like <span + id="dx1-161017"></a> style is like <span class="cmss-10">superragged</span><a - id="dx1-162018"></a> but has a header row. - </dd><dt class="description"> + id="dx1-161018"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12398--><p class="noindent" > <span -class="cmbx-10">superraggedheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">superraggedheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12398--><p class="noindent" >The <span class="cmss-10">superraggedheaderborder</span><a - id="dx1-162019"></a> style is like <span + id="dx1-161019"></a> style is like <span class="cmss-10">superraggedheader</span><a - id="dx1-162020"></a> but has - horizontal and vertical lines around it. - </dd><dt class="description"> + id="dx1-161020"></a> but has horizontal and vertical lines + around it. + </p></dd><dt class="description"> + <!--l. 12403--><p class="noindent" > <span -class="cmbx-10">superragged3col</span> </dt><dd -class="description">The <span +class="cmbx-10">superragged3col</span> </p></dt><dd +class="description"> + <!--l. 12403--><p class="noindent" >The <span class="cmss-10">superragged3col</span><a - id="dx1-162021"></a> style is like <span + id="dx1-161021"></a> style is like <span class="cmss-10">superragged</span><a - id="dx1-162022"></a> but has three columns. The first column - contains the entry’s name, the second column contains the (left justified) description and the third - column contains the (left justified) <a + id="dx1-161022"></a> but has three columns. The first column contains + the entry’s name, the second column contains the (left justified) description and the third column + contains the (left justified) <a href="#glo:numberlist">number list<a - id="dx1-162023"></a></a>. The entry’s symbol is ignored. The width of the - first column is governed by the widest entry in that column. The width of the second column is + id="dx1-161023"></a></a>. The entry’s symbol is ignored. The width of the first + column is governed by the widest entry in that column. The width of the second column is governed by the length <span class="cmtt-10">\glsdescwidth</span><a - id="dx1-162024"></a>. The width of the third column is governed by the length + id="dx1-161024"></a>. The width of the third column is governed by the length <span class="cmtt-10">\glspagelistwidth</span><a - id="dx1-162025"></a>. - </dd><dt class="description"> + id="dx1-161025"></a>. + + + </p></dd><dt class="description"> + <!--l. 12413--><p class="noindent" > <span -class="cmbx-10">superragged3colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">superragged3colborder</span> </p></dt><dd +class="description"> + <!--l. 12413--><p class="noindent" >The <span class="cmss-10">superragged3colborder</span><a - id="dx1-162026"></a> style is like the <span + id="dx1-161026"></a> style is like the <span class="cmss-10">superragged3col</span><a - id="dx1-162027"></a> style but has - horizontal and vertical lines around it. - </dd><dt class="description"> + id="dx1-161027"></a> style but has horizontal and vertical + lines around it. + </p></dd><dt class="description"> + <!--l. 12417--><p class="noindent" > <span -class="cmbx-10">superragged3colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">superragged3colheader</span> </p></dt><dd +class="description"> + <!--l. 12417--><p class="noindent" >The <span class="cmss-10">superragged3colheader</span><a - id="dx1-162028"></a> style is like <span + id="dx1-161028"></a> style is like <span class="cmss-10">superragged3col</span><a - id="dx1-162029"></a> but has a header row. - </dd><dt class="description"> + id="dx1-161029"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12420--><p class="noindent" > <span -class="cmbx-10">superragged3colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">superragged3colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12420--><p class="noindent" >The <span class="cmss-10">superragged3colheaderborder</span><a - id="dx1-162030"></a> style is like the above but has - horizontal and vertical lines around it. - - - </dd><dt class="description"> + id="dx1-161030"></a> style is like the above but has horizontal and vertical lines around + it. + </p></dd><dt class="description"> + <!--l. 12425--><p class="noindent" > <span -class="cmbx-10">altsuperragged4col</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuperragged4col</span> </p></dt><dd +class="description"> + <!--l. 12425--><p class="noindent" >The <span class="cmss-10">altsuperragged4col</span><a - id="dx1-162031"></a> style is like <span + id="dx1-161031"></a> style is like <span class="cmss-10">superragged3col</span><a - id="dx1-162032"></a> but has an additional column - in which the entry’s associated symbol appears. The column widths for the name and symbol - column are governed by the widest entry in the given column. - </dd><dt class="description"> + id="dx1-161032"></a> but has an additional column in which the entry’s + associated symbol appears. The column widths for the name and symbol column are governed by + the widest entry in the given column. + </p></dd><dt class="description"> + <!--l. 12431--><p class="noindent" > <span -class="cmbx-10">altsuperragged4colborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuperragged4colborder</span> </p></dt><dd +class="description"> + <!--l. 12431--><p class="noindent" >The <span class="cmss-10">altsuperragged4colborder</span><a - id="dx1-162033"></a> style is like the <span + id="dx1-161033"></a> style is like the <span class="cmss-10">altsuperragged4col</span><a - id="dx1-162034"></a> style but - has horizontal and vertical lines around it. - </dd><dt class="description"> + id="dx1-161034"></a> style but has horizontal and vertical + lines around it. + </p></dd><dt class="description"> + <!--l. 12436--><p class="noindent" > <span -class="cmbx-10">altsuperragged4colheader</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuperragged4colheader</span> </p></dt><dd +class="description"> + <!--l. 12436--><p class="noindent" >The <span class="cmss-10">altsuperragged4colheader</span><a - id="dx1-162035"></a> style is like <span + id="dx1-161035"></a> style is like <span class="cmss-10">altsuperragged4col</span><a - id="dx1-162036"></a> but has a - header row. - </dd><dt class="description"> + id="dx1-161036"></a> but has a header row. + </p></dd><dt class="description"> + <!--l. 12440--><p class="noindent" > <span -class="cmbx-10">altsuperragged4colheaderborder</span> </dt><dd -class="description">The <span +class="cmbx-10">altsuperragged4colheaderborder</span> </p></dt><dd +class="description"> + <!--l. 12440--><p class="noindent" >The <span class="cmss-10">altsuperragged4colheaderborder</span><a - id="dx1-162037"></a> style is like the above but has - horizontal and vertical lines around it. + id="dx1-161037"></a> style is like the above but has horizontal and vertical lines + around it. +</p> </dd></dl> -<!--l. 12606--><p class="noindent" > + + +<!--l. 12447--><p class="noindent" > </p> -<!--l. 12606--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.7 </span> <a +<!--l. 12447--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.7 </span> <a id="sec:treestyles"></a>Tree-Like Styles</h4> -<!--l. 12609--><p class="noindent" >The styles described in this section are all defined in the package <span +<!--l. 12450--><p class="noindent" >The styles described in this section are all defined in the package <span class="cmss-10">glossary-tree</span><a - id="dx1-163001"></a>. These styles are designed for + id="dx1-162001"></a>. These styles are designed for hierarchical glossaries but can also be used with glossaries that don’t have sub-entries. These styles will display the entry’s symbol if it exists. Note that these styles will automatically be available unless you use the <span class="cmss-10">notree</span><a - id="dx1-163002"></a> or + id="dx1-162002"></a> or <span class="cmss-10">nostyles</span><a - id="dx1-163003"></a> package options. -</p><!--l. 12617--><p class="indent" > These styles all format the entry name using: -</p><!--l. 12618--><p class="indent" > <hr><div title="Definition"><a - id="dx1-163004"></a> <span + id="dx1-162003"></a> package options. +</p><!--l. 12458--><p class="indent" > These styles all format the entry name using: +</p><!--l. 12459--><p class="indent" > <hr><div title="Definition"><a + id="dx1-162004"></a> <span class="cmtt-10">\glstreenamefmt{</span>⟨<span class="cmitt-10">name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12620--><p class="noindent" > +</p><!--l. 12461--><p class="noindent" > This defaults to <span class="cmtt-10">\textbf{</span>⟨<span class="cmti-10">name</span>⟩<span class="cmtt-10">}</span>, but note that ⟨<span class="cmti-10">name</span>⟩ includes <span class="cmtt-10">\glsnamefont</span><a - id="dx1-163005"></a> so the bold setting in + id="dx1-162005"></a> so the bold setting in <span class="cmtt-10">\glstreenamefont </span>may be counteracted by another font change in <span class="cmtt-10">\glsnamefont </span>(or in <span class="cmtt-10">\acronymfont</span>). The tree-like styles that also display the header use -</p><!--l. 12626--><p class="indent" > <hr><div title="Definition"><a - id="dx1-163006"></a> <span +</p><!--l. 12467--><p class="indent" > <hr><div title="Definition"><a + id="dx1-162006"></a> <span class="cmtt-10">\glstreegroupheaderfmt{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12628--><p class="noindent" > +</p><!--l. 12469--><p class="noindent" > to format the heading. This defaults to <span class="cmtt-10">\glstreenamefmt{</span>⟨<span class="cmti-10">text</span>⟩<span class="cmtt-10">}</span>. The tree-like styles that display navigation links to the groups (such as <span class="cmss-10">indexhypergroup</span><a - id="dx1-163007"></a>), format the navigation line using -</p><!--l. 12633--><p class="indent" > <hr><div title="Definition"><a - id="dx1-163008"></a> <span + id="dx1-162007"></a>), format the navigation line using +</p><!--l. 12474--><p class="indent" > <hr><div title="Definition"><a + id="dx1-162008"></a> <span class="cmtt-10">\glstreenavigationfmt{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12635--><p class="noindent" > +</p><!--l. 12476--><p class="noindent" > which defaults to <span class="cmtt-10">\glstreenamefmt{</span>⟨<span class="cmti-10">text</span>⟩<span class="cmtt-10">}</span>. -</p><!--l. 12638--><p class="indent" > Note that this is different from <span +</p><!--l. 12479--><p class="indent" > Note that this is different from <span class="cmtt-10">\glslistnavigationitem</span>, provided with the styles such as <span class="cmss-10">listhypergroup</span><a - id="dx1-163009"></a>, as + id="dx1-162009"></a>, as that also includes <span class="cmtt-10">\item</span>. -</p><!--l. 12642--><p class="indent" > With the exception of the <span +</p><!--l. 12483--><p class="indent" > With the exception of the <span class="cmss-10">alttree</span><a - id="dx1-163010"></a> style (and those derived from it), the space before the description for + id="dx1-162010"></a> style (and those derived from it), the space before the description for top-level entries is produced with -</p><!--l. 12645--><p class="indent" > <hr><div title="Definition"><a - id="dx1-163011"></a> <span +</p><!--l. 12486--><p class="indent" > <hr><div title="Definition"><a + id="dx1-162011"></a> <span class="cmtt-10">\glstreepredesc </span></div><hr> -</p><!--l. 12647--><p class="noindent" > +</p><!--l. 12488--><p class="noindent" > This defaults to <span class="cmtt-10">\space</span>. - - -</p><!--l. 12650--><p class="indent" > With the exception of the <span +</p><!--l. 12491--><p class="indent" > With the exception of the <span class="cmss-10">treenoname</span><a - id="dx1-163012"></a> and <span + id="dx1-162012"></a> and <span class="cmss-10">alttree</span><a - id="dx1-163013"></a> styles (and those derived from them), the space before the + id="dx1-162013"></a> styles (and those derived from them), the space before the description for child entries is produced with -</p><!--l. 12654--><p class="indent" > <hr><div title="Definition"><a - id="dx1-163014"></a> <span +</p><!--l. 12495--><p class="indent" > <hr><div title="Definition"><a + id="dx1-162014"></a> <span class="cmtt-10">\glstreechildpredesc </span></div><hr> -</p><!--l. 12656--><p class="noindent" > +</p><!--l. 12497--><p class="noindent" > This defaults to <span class="cmtt-10">\space</span>. -</p><!--l. 12659--><p class="indent" > <div class="important" title="Important Note"> Most of these styles are not designed for multi-paragraph descriptions. (The <span +</p><!--l. 12500--><p class="indent" > <div class="important" title="Important Note"> Most of these styles are not designed for multi-paragraph descriptions. (The <span class="cmss-10">tree</span><a - id="dx1-163015"></a> style isn’t too bad for + id="dx1-162015"></a> style isn’t too bad for multi-paragraph top-level entry descriptions, or you can use the <span class="cmss-10">index</span><a - id="dx1-163016"></a> style with the adjustment shown below.) + id="dx1-162016"></a> style with the adjustment shown below.) </div> -</p><!--l. 12664--><p class="noindent" > +</p><!--l. 12505--><p class="noindent" > </p><dl class="description"><dt class="description"> + <!--l. 12508--><p class="noindent" > <span -class="cmbx-10">index</span> </dt><dd -class="description">The <span +class="cmbx-10">index</span> </p></dt><dd +class="description"> + <!--l. 12508--><p class="noindent" >The <span class="cmss-10">index</span><a - id="dx1-163017"></a> style is similar to the way indices are usually formatted in that it has a hierarchical + id="dx1-162017"></a> style is similar to the way indices are usually formatted in that it has a hierarchical structure up to three levels (the main level plus two sub-levels). The name is typeset in bold, and if the symbol is present it is set in parentheses after the name and before the description. Sub-entries are indented and also include the name, the symbol in brackets (if present) and the description. + + Groups are separated using <span class="cmtt-10">\indexspace</span><a - id="dx1-163018"></a>. - <!--l. 12676--><p class="noindent" >Each main level item is started with - </p><!--l. 12677--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-163019"></a> <span + id="dx1-162018"></a>. + </p><!--l. 12517--><p class="noindent" >Each main level item is started with + </p><!--l. 12518--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-162019"></a> <span class="cmtt-10">\glstreeitem </span></div><hr> - </p><!--l. 12679--><p class="noindent" > + </p><!--l. 12520--><p class="noindent" > The level 1 entries are started with - </p><!--l. 12681--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-163020"></a> <span + </p><!--l. 12522--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-162020"></a> <span class="cmtt-10">\glstreesubitem </span></div><hr> - </p><!--l. 12683--><p class="noindent" > - </p><!--l. 12685--><p class="noindent" >The level 2 entries are started with - </p><!--l. 12686--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-163021"></a> <span + </p><!--l. 12524--><p class="noindent" > + </p><!--l. 12526--><p class="noindent" >The level 2 entries are started with + </p><!--l. 12527--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-162021"></a> <span class="cmtt-10">\glstreesubsubitem </span></div><hr> - </p><!--l. 12688--><p class="noindent" > - </p><!--l. 12690--><p class="noindent" >Note that the <span + </p><!--l. 12529--><p class="noindent" > + </p><!--l. 12531--><p class="noindent" >Note that the <span class="cmss-10">index</span><a - id="dx1-163022"></a> style automatically sets + id="dx1-162022"></a> style automatically sets </p> - <div class="verbatim" id="verbatim-369"> + <pre class="verbatim" id="verbatim-343"> \let\item\glstreeitem -  <br />\let\subitem\glstreesubitem -  <br />\let\subsubitem\glstreesubsubitem -</div> - <!--l. 12695--><p class="nopar" > at the start of the glossary for backward compatibility. - </p><!--l. 12698--><p class="noindent" >The <span + \let\subitem\glstreesubitem + \let\subsubitem\glstreesubsubitem +</pre> + <!--l. 12536--><p class="nopar" > at the start of the glossary for backward compatibility. + </p><!--l. 12539--><p class="noindent" >The <span class="cmss-10">index</span><a - id="dx1-163023"></a> style isn’t suitable for multi-paragraph descriptions, but this limitation can be overcome by + id="dx1-162023"></a> style isn’t suitable for multi-paragraph descriptions, but this limitation can be overcome by redefining the above commands. For example: </p> - <div class="verbatim" id="verbatim-370"> + <pre class="verbatim" id="verbatim-344"> \renewcommand{\glstreeitem}{% -  <br /> \parindent0pt\par\hangindent40pt -  <br /> \everypar{\parindent50pt\hangindent40pt}} -</div> - <!--l. 12705--><p class="nopar" > +  \parindent0pt\par\hangindent40pt +  \everypar{\parindent50pt\hangindent40pt}} +</pre> + <!--l. 12546--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 12548--><p class="noindent" > <span -class="cmbx-10">indexgroup</span> </dt><dd -class="description">The <span +class="cmbx-10">indexgroup</span> </p></dt><dd +class="description"> + <!--l. 12548--><p class="noindent" >The <span class="cmss-10">indexgroup</span><a - id="dx1-163024"></a> style is similar to the <span + id="dx1-162024"></a> style is similar to the <span class="cmss-10">index</span><a - id="dx1-163025"></a> style except that each group has a heading - obtained using <span + id="dx1-162025"></a> style except that each group has a heading obtained using + <span class="cmtt-10">\glsgetgrouptitle{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>, which is described in <a -href="#sec:newglossarystyle">§15.2 </a><a +href="#sec:newglossarystyle">§<span +class="cmbx-10">??</span>sec:newglossarystyle </a><a href="#sec:newglossarystyle">Defining your own glossary style<!--tex4ht:ref: sec:newglossarystyle --></a>. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12553--><p class="noindent" > <span -class="cmbx-10">indexhypergroup</span> </dt><dd -class="description">The <span +class="cmbx-10">indexhypergroup</span> </p></dt><dd +class="description"> + <!--l. 12553--><p class="noindent" >The <span class="cmss-10">indexhypergroup</span><a - id="dx1-163026"></a> style is like <span + id="dx1-162026"></a> style is like <span class="cmss-10">indexgroup</span><a - id="dx1-163027"></a> but has a set of links to the glossary groups. - The navigation line is the same as that for <span + id="dx1-162027"></a> but has a set of links to the glossary groups. The + navigation line is the same as that for <span class="cmss-10">listhypergroup</span><a - id="dx1-163028"></a>, described above, but is formatted using + id="dx1-162028"></a>, described above, but is formatted using <span class="cmtt-10">\glstreenavigationfmt</span>. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12559--><p class="noindent" > <span -class="cmbx-10">tree</span> </dt><dd -class="description">The <span +class="cmbx-10">tree</span> </p></dt><dd +class="description"> + <!--l. 12559--><p class="noindent" >The <span class="cmss-10">tree</span><a - id="dx1-163029"></a> style is similar to the <span + id="dx1-162029"></a> style is similar to the <span class="cmss-10">index</span><a - id="dx1-163030"></a> style except that it can have arbitrary levels. (Note that <a + id="dx1-162030"></a> style except that it can have arbitrary levels. (Note that <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-163031"></a></a> is + id="dx1-162031"></a></a> is limited to three levels, so you will need to use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-163032"></a></a> if you want more than three levels.) Each sub-level is + id="dx1-162032"></a></a> if you want more than three levels.) Each sub-level is indented by <a - id="dx1-163033"></a><span + id="dx1-162033"></a><span class="cmtt-10">\glstreeindent</span>. Note that the name, symbol (if present) and description are placed in the same paragraph block. If you want the name to be apart from the description, use the <span class="cmss-10">alttree</span><a - id="dx1-163034"></a> style instead. + id="dx1-162034"></a> style instead. (See below.) - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12569--><p class="noindent" > <span -class="cmbx-10">treegroup</span> </dt><dd -class="description">The <span +class="cmbx-10">treegroup</span> </p></dt><dd +class="description"> + <!--l. 12569--><p class="noindent" >The <span class="cmss-10">treegroup</span><a - id="dx1-163035"></a> style is similar to the <span + id="dx1-162035"></a> style is similar to the <span class="cmss-10">tree</span><a - id="dx1-163036"></a> style except that each group has a heading. - </dd><dt class="description"> + id="dx1-162036"></a> style except that each group has a heading. + </p></dd><dt class="description"> + <!--l. 12572--><p class="noindent" > <span -class="cmbx-10">treehypergroup</span> </dt><dd -class="description">The <span +class="cmbx-10">treehypergroup</span> </p></dt><dd +class="description"> + <!--l. 12572--><p class="noindent" >The <span class="cmss-10">treehypergroup</span><a - id="dx1-163037"></a> style is like <span + id="dx1-162037"></a> style is like <span class="cmss-10">treegroup</span><a - id="dx1-163038"></a> but has a set of links to the glossary groups. The + id="dx1-162038"></a> but has a set of links to the glossary groups. The navigation line is the same as that for <span class="cmss-10">listhypergroup</span><a - id="dx1-163039"></a>, described above, but is formatted using + id="dx1-162039"></a>, described above, but is formatted using <span class="cmtt-10">\glstreenavigationfmt</span>. - </dd><dt class="description"> + + + </p></dd><dt class="description"> + <!--l. 12578--><p class="noindent" > <span -class="cmbx-10">treenoname</span> </dt><dd -class="description">The <span +class="cmbx-10">treenoname</span> </p></dt><dd +class="description"> + <!--l. 12578--><p class="noindent" >The <span class="cmss-10">treenoname</span><a - id="dx1-163040"></a> style is like the <span + id="dx1-162040"></a> style is like the <span class="cmss-10">tree</span><a - id="dx1-163041"></a> style except that the name for each sub-entry is - ignored. - </dd><dt class="description"> + id="dx1-162041"></a> style except that the name for each sub-entry is ignored. + </p></dd><dt class="description"> + <!--l. 12582--><p class="noindent" > <span -class="cmbx-10">treenonamegroup</span> </dt><dd -class="description">The <span +class="cmbx-10">treenonamegroup</span> </p></dt><dd +class="description"> + <!--l. 12582--><p class="noindent" >The <span class="cmss-10">treenonamegroup</span><a - id="dx1-163042"></a> style is similar to the <span + id="dx1-162042"></a> style is similar to the <span class="cmss-10">treenoname</span><a - id="dx1-163043"></a> style except that each group has a + id="dx1-162043"></a> style except that each group has a heading. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12586--><p class="noindent" > <span -class="cmbx-10">treenonamehypergroup</span> </dt><dd -class="description">The <span +class="cmbx-10">treenonamehypergroup</span> </p></dt><dd +class="description"> + <!--l. 12586--><p class="noindent" >The <span class="cmss-10">treenonamehypergroup</span><a - id="dx1-163044"></a> style is like <span + id="dx1-162044"></a> style is like <span class="cmss-10">treenonamegroup</span><a - id="dx1-163045"></a> but has a set of links to the - glossary groups. The navigation line is the same as that for <span + id="dx1-162045"></a> but has a set of links to the glossary groups. The + navigation line is the same as that for <span class="cmss-10">listhypergroup</span><a - id="dx1-163046"></a>, described above, but is - formatted using <span + id="dx1-162046"></a>, described above, but is formatted using + <span class="cmtt-10">\glstreenavigationfmt</span>. - - - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 12592--><p class="noindent" > <span -class="cmbx-10">alttree</span> </dt><dd -class="description">The <span +class="cmbx-10">alttree</span> </p></dt><dd +class="description"> + <!--l. 12592--><p class="noindent" >The <span class="cmss-10">alttree</span><a - id="dx1-163047"></a> style is similar to the <span + id="dx1-162047"></a> style is similar to the <span class="cmss-10">tree</span><a - id="dx1-163048"></a> style except that the indentation for each level is determined by - the width of the text specified by - <!--l. 12754--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-163049"></a> <span + id="dx1-162048"></a> style except that the indentation for each level is determined by the + width of the text specified by + </p><!--l. 12595--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-162049"></a> <span class="cmtt-10">\glssetwidest[</span>⟨<span class="cmitt-10">level</span>⟩<span class="cmtt-10">]{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 12756--><p class="noindent" > + </p><!--l. 12597--><p class="noindent" > The optional argument ⟨<span class="cmti-10">level</span>⟩ indicates the level, where 0 indicates the top-most level, 1 indicates the first level sub-entries, etc. If <span class="cmtt-10">\glssetwidest </span>hasn’t been used for a given sub-level, the level 0 widest text is used instead. If ⟨<span class="cmti-10">level</span>⟩ is omitted, 0 is assumed. - </p><!--l. 12763--><p class="noindent" >As from v4.22, the <span + </p><!--l. 12604--><p class="noindent" >As from v4.22, the <span class="cmss-10">glossary-tree</span><a - id="dx1-163050"></a> package also provides - </p><!--l. 12764--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-163051"></a> <span + id="dx1-162050"></a> package also provides + </p><!--l. 12605--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-162051"></a> <span class="cmtt-10">\glsfindwidesttoplevelname[</span>⟨<span class="cmitt-10">glossary list</span>⟩<span class="cmtt-10">] </span></div><hr> - </p><!--l. 12766--><p class="noindent" > + </p><!--l. 12607--><p class="noindent" > This iterates over all parentless entries in the given glossary lists and determines the widest entry. If the optional argument is omitted, all glossaries are assumed (as per <span class="cmtt-10">\forallglossaries</span>). - </p><!--l. 12771--><p class="noindent" >For example, to have the same name width for all glossaries: + </p><!--l. 12612--><p class="noindent" >For example, to have the same name width for all glossaries: </p> - <div class="verbatim" id="verbatim-371"> + <pre class="verbatim" id="verbatim-345"> \glsfindwidesttoplevelname -  <br />\setglossarystyle{alttree} -  <br />\printglossaries -</div> - <!--l. 12776--><p class="nopar" > Alternatively, to compute the widest entry for each glossary before it’s displayed: + \setglossarystyle{alttree} + \printglossaries +</pre> + <!--l. 12617--><p class="nopar" > Alternatively, to compute the widest entry for each glossary before it’s displayed: </p> - <div class="verbatim" id="verbatim-372"> + <pre class="verbatim" id="verbatim-346"> \renewcommand{\glossarypreamble}{% -  <br />  \glsfindwidesttoplevelname[\currentglossary]} -  <br />\setglossarystyle{alttree} -  <br />\printglossaries -</div> - <!--l. 12784--><p class="nopar" > - </p><!--l. 12786--><p class="noindent" ><div class="important" title="Important Note"> These commands only affects the <span +   \glsfindwidesttoplevelname[\currentglossary]} + \setglossarystyle{alttree} + \printglossaries +</pre> + <!--l. 12625--><p class="nopar" > + </p><!--l. 12627--><p class="noindent" ><div class="important" title="Important Note"> These commands only affects the <span class="cmss-10">alttree</span><a - id="dx1-163052"></a> styles, including those listed below and the ones in the + id="dx1-162052"></a> styles, including those listed below and the ones in the <span class="cmss-10">glossary-mcols</span><a - id="dx1-163053"></a> package. If you forget to set the widest entry name, the description will overwrite the name. + id="dx1-162053"></a> package. If you forget to set the widest entry name, the description will overwrite the name. </div> - </p><!--l. 12791--><p class="noindent" > - </p><!--l. 12793--><p class="noindent" >For each level, the name is placed to the left of the paragraph block containing the symbol + </p><!--l. 12632--><p class="noindent" > + </p><!--l. 12634--><p class="noindent" >For each level, the name is placed to the left of the paragraph block containing the symbol (optional) and the description. If the symbol is present, it is placed in parentheses before the description. - </p><!--l. 12798--><p class="noindent" >The name is placed inside a left-aligned <span + </p><!--l. 12639--><p class="noindent" >The name is placed inside a left-aligned <span class="cmtt-10">\makebox</span>. As from v4.19, this can now be adjusted by redefining - </p><!--l. 12800--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-163054"></a> <span + </p><!--l. 12641--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-162054"></a> <span class="cmtt-10">\glstreenamebox{</span>⟨<span class="cmitt-10">width</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> - </p><!--l. 12802--><p class="noindent" > + </p><!--l. 12643--><p class="noindent" > where ⟨<span class="cmti-10">width</span>⟩ is the width of the box and ⟨<span class="cmti-10">text</span>⟩ is the contents of the box. For example, to make the name @@ -25504,65 +25930,72 @@ class="cmti-10">text</span>⟩ is the contents of the box. For example, to </p> - <div class="verbatim" id="verbatim-373"> + <pre class="verbatim" id="verbatim-347"> \renewcommand*{\glstreenamebox}[2]{% -  <br />  \makebox[#1][r]{#2}% -  <br />} -</div> - <!--l. 12809--><p class="nopar" > +   \makebox[#1][r]{#2}% + } +</pre> + <!--l. 12650--><p class="nopar" > </p></dd><dt class="description"> + <!--l. 12652--><p class="noindent" > <span -class="cmbx-10">alttreegroup</span> </dt><dd -class="description">The <span +class="cmbx-10">alttreegroup</span> </p></dt><dd +class="description"> + <!--l. 12652--><p class="noindent" >The <span class="cmss-10">alttreegroup</span><a - id="dx1-163055"></a> is like the <span + id="dx1-162055"></a> is like the <span class="cmss-10">alttree</span><a - id="dx1-163056"></a> style except that each group has a heading. - </dd><dt class="description"> + id="dx1-162056"></a> style except that each group has a heading. + </p></dd><dt class="description"> + <!--l. 12655--><p class="noindent" > <span -class="cmbx-10">alttreehypergroup</span> </dt><dd -class="description">The <span +class="cmbx-10">alttreehypergroup</span> </p></dt><dd +class="description"> + <!--l. 12655--><p class="noindent" >The <span class="cmss-10">alttreehypergroup</span><a - id="dx1-163057"></a> style is like <span + id="dx1-162057"></a> style is like <span class="cmss-10">alttreegroup</span><a - id="dx1-163058"></a> but has a set of links to the glossary groups. - The navigation line is the same as that for <span + id="dx1-162058"></a> but has a set of links to the glossary groups. The navigation + line is the same as that for <span class="cmss-10">listhypergroup</span><a - id="dx1-163059"></a>, described above. + id="dx1-162059"></a>, described above. +</p> </dd></dl> -<!--l. 12821--><p class="noindent" > +<!--l. 12662--><p class="noindent" > </p> -<!--l. 12821--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.8 </span> <a +<!--l. 12662--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.8 </span> <a id="sec:mcolstyles"></a>Multicols Style</h4> -<!--l. 12824--><p class="noindent" >The <span +<!--l. 12665--><p class="noindent" >The <span class="cmss-10">glossary-mcols</span><a - id="dx1-164001"></a> package provides tree-like styles that are in the <span + id="dx1-163001"></a> package provides tree-like styles that are in the <span class="cmss-10">multicols</span><a - id="dx1-164002"></a><a - id="dx1-164003"></a> environment (defined by the <span + id="dx1-163002"></a><a + id="dx1-163003"></a> environment (defined by the <span class="cmss-10">multicol</span><a - id="dx1-164004"></a> + id="dx1-163004"></a> package). The style names are as their analogous tree styles (as defined in <a -href="#sec:treestyles">§15.1.7 </a><a -href="#sec:treestyles">Tree-Like Styles<!--tex4ht:ref: sec:treestyles --></a>) but are -prefixed with “mcol”. For example, the <span +href="#sec:treestyles">§<span +class="cmbx-10">??</span>sec:treestyles </a><a +href="#sec:treestyles">Tree-Like Styles<!--tex4ht:ref: sec:treestyles --></a>) but +are prefixed with “mcol”. For example, the <span class="cmss-10">mcolindex</span><a - id="dx1-164005"></a> style is essentially the <span + id="dx1-163005"></a> style is essentially the <span class="cmss-10">index</span><a - id="dx1-164006"></a> style but put in a <span + id="dx1-163006"></a> style but put in a <span class="cmss-10">multicols</span><a - id="dx1-164007"></a><a - id="dx1-164008"></a> + id="dx1-163007"></a><a + id="dx1-163008"></a> environment. For the complete list, see <a -href="#tab:mcols">table 15.2</a>. The <span +href="#tab:mcols">table <span +class="cmbx-10">??</span>tab:mcols</a>. The <span class="cmss-10">glossary-tree</span><a - id="dx1-164009"></a> package is automatically loaded by + id="dx1-163009"></a> package is automatically loaded by <span class="cmss-10">glossary-mcols</span><a - id="dx1-164010"></a> (even if the <span + id="dx1-163010"></a> (even if the <span class="cmss-10">notree</span><a - id="dx1-164011"></a> package option is used when loading <span + id="dx1-163011"></a> package option is used when loading <span class="cmss-10">glossaries</span>). The formatting commands <span class="cmtt-10">\glstreenamefmt</span>, <span @@ -25570,53 +26003,53 @@ class="cmtt-10">\glstreegroupheaderfmt </span>and <span class="cmtt-10">\glstreenavigationfmt </span>are all used by the corresponding <span class="cmss-10">glossary-mcols</span><a - id="dx1-164012"></a> styles. -</p><!--l. 12839--><p class="indent" > <div class="important" title="Important Note"> Note that <span + id="dx1-163012"></a> styles. +</p><!--l. 12680--><p class="indent" > <div class="important" title="Important Note"> Note that <span class="cmss-10">glossary-mcols</span><a - id="dx1-164013"></a> is not loaded by <span + id="dx1-163013"></a> is not loaded by <span class="cmss-10">glossaries</span>. If you want to use any of the multicol styles in that package you need to load it explicitly with <span class="cmtt-10">\usepackage </span>and set the required glossary style using <span class="cmtt-10">\setglossarystyle</span><a - id="dx1-164014"></a>. </div> -</p><!--l. 12844--><p class="noindent" > -</p><!--l. 12846--><p class="indent" > The default number of columns is 2, but can be changed by redefining -</p><!--l. 12847--><p class="indent" > <hr><div title="Definition"><a - id="dx1-164015"></a> <span + id="dx1-163014"></a>. </div> +</p><!--l. 12685--><p class="noindent" > +</p><!--l. 12687--><p class="indent" > The default number of columns is 2, but can be changed by redefining +</p><!--l. 12688--><p class="indent" > <hr><div title="Definition"><a + id="dx1-163015"></a> <span class="cmtt-10">\glsmcols </span></div><hr> -</p><!--l. 12849--><p class="noindent" > +</p><!--l. 12690--><p class="noindent" > to the required number. For example, for a three column glossary: </p> - <div class="verbatim" id="verbatim-374"> + <pre class="verbatim" id="verbatim-348"> \usepackage{glossary-mcols} - <br />\renewcommand*{\glsmcols}{3} - <br />\setglossarystyle{mcolindex} -</div> -<!--l. 12855--><p class="nopar" > +\renewcommand*{\glsmcols}{3} +\setglossarystyle{mcolindex} +</pre> +<!--l. 12696--><p class="nopar" > </p> <div class="table"> -<!--l. 12857--><p class="indent" > <a +<!--l. 12698--><p class="indent" > <a id="tab:mcols"></a></p><hr class="float" /><div class="float" > <div class="caption" -><span class="id">Table 15.2: </span><span -class="content">Multicolumn Styles</span></div><!--tex4ht:label?: x1-1640162 --> +><span class="id">Table 13.2: </span><span +class="content">Multicolumn Styles</span></div><!--tex4ht:label?: x1-1630162 --> <div class="tabular"> <table id="TBL-10" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-10-1g"><col id="TBL-10-1" /><col id="TBL-10-2" /></colgroup><tr style="vertical-align:baseline;" id="TBL-10-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-1-1" class="td11"> <span class="cmssbx-10">glossary-mcols</span><a - id="dx1-164017"></a> <span + id="dx1-163017"></a> <span class="cmbx-10">Style </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-10-1-2" class="td11"> <span class="cmbx-10">Analogous Tree Style </span></td> @@ -25624,200 +26057,200 @@ class="cmbx-10">Analogous Tree Style </span></td> style="vertical-align:baseline;" id="TBL-10-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-1" class="td11"> <span class="cmss-10">mcolindex</span><a - id="dx1-164018"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-2" + id="dx1-163018"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-2-2" class="td11"> <span class="cmss-10">index</span><a - id="dx1-164019"></a> </td></tr><tr + id="dx1-163019"></a> </td></tr><tr style="vertical-align:baseline;" id="TBL-10-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-3-1" class="td11"> <span class="cmss-10">mcolindexgroup</span><a - id="dx1-164020"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-3-2" + id="dx1-163020"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-3-2" class="td11"> <span class="cmss-10">indexgroup</span><a - id="dx1-164021"></a></td> + id="dx1-163021"></a></td> </tr><tr style="vertical-align:baseline;" id="TBL-10-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-1" class="td11"> <span class="cmss-10">mcolindexhypergroup</span><a - id="dx1-164022"></a> or <span + id="dx1-163022"></a> or <span class="cmss-10">mcolindexspannav</span><a - id="dx1-164023"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-2" + id="dx1-163023"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-4-2" class="td11"> <span class="cmss-10">indexhypergroup</span><a - id="dx1-164024"></a> </td> + id="dx1-163024"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-5-1" class="td11"> <span class="cmss-10">mcoltree</span><a - id="dx1-164025"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-5-2" + id="dx1-163025"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-5-2" class="td11"> <span class="cmss-10">tree</span><a - id="dx1-164026"></a> </td></tr><tr + id="dx1-163026"></a> </td></tr><tr style="vertical-align:baseline;" id="TBL-10-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-6-1" class="td11"> <span class="cmss-10">mcoltreegroup</span><a - id="dx1-164027"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-6-2" + id="dx1-163027"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-6-2" class="td11"> <span class="cmss-10">treegroup</span><a - id="dx1-164028"></a></td> + id="dx1-163028"></a></td> </tr><tr style="vertical-align:baseline;" id="TBL-10-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-7-1" class="td11"> <span class="cmss-10">mcoltreehypergroup</span><a - id="dx1-164029"></a> or <span + id="dx1-163029"></a> or <span class="cmss-10">mcoltreespannav</span><a - id="dx1-164030"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-7-2" + id="dx1-163030"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-7-2" class="td11"> <span class="cmss-10">treehypergroup</span><a - id="dx1-164031"></a> </td> + id="dx1-163031"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-8-1" class="td11"> <span class="cmss-10">mcoltreenoname</span><a - id="dx1-164032"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-8-2" + id="dx1-163032"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-8-2" class="td11"> <span class="cmss-10">treenoname</span><a - id="dx1-164033"></a> </td> + id="dx1-163033"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-9-1" class="td11"> <span class="cmss-10">mcoltreenonamegroup</span><a - id="dx1-164034"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-9-2" + id="dx1-163034"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-9-2" class="td11"> <span class="cmss-10">treenonamegroup</span><a - id="dx1-164035"></a> </td> + id="dx1-163035"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-10-1" class="td11"> <span class="cmss-10">mcoltreenonamehypergroup</span><a - id="dx1-164036"></a> or <span + id="dx1-163036"></a> or <span class="cmss-10">mcoltreenonamespannav</span><a - id="dx1-164037"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-10-2" + id="dx1-163037"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-10-2" class="td11"> <span class="cmss-10">treenonamehypergroup</span><a - id="dx1-164038"></a> </td> + id="dx1-163038"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-11-1" class="td11"> <span class="cmss-10">mcolalttree</span><a - id="dx1-164039"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-11-2" + id="dx1-163039"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-11-2" class="td11"> <span class="cmss-10">alttree</span><a - id="dx1-164040"></a> </td> + id="dx1-163040"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-12-1" class="td11"> <span class="cmss-10">mcolalttreegroup</span><a - id="dx1-164041"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-12-2" + id="dx1-163041"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-12-2" class="td11"> <span class="cmss-10">alttreegroup</span><a - id="dx1-164042"></a> </td> + id="dx1-163042"></a> </td> </tr><tr style="vertical-align:baseline;" id="TBL-10-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-10-13-1" class="td11"> <span class="cmss-10">mcolalttreehypergroup</span><a - id="dx1-164043"></a> or <span + id="dx1-163043"></a> or <span class="cmss-10">mcolalttreespannav</span><a - id="dx1-164044"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-13-2" + id="dx1-163044"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-10-13-2" class="td11"> <span class="cmss-10">alttreehypergroup</span><a - id="dx1-164045"></a> </td></tr></table></div> + id="dx1-163045"></a> </td></tr></table></div> </div><hr class="endfloat" /> </div> -<!--l. 12882--><p class="indent" > The styles with a navigation line, such as <span +<!--l. 12723--><p class="indent" > The styles with a navigation line, such as <span class="cmss-10">mcoltreehypergroup</span><a - id="dx1-164046"></a>, now have a variant (as from + id="dx1-163046"></a>, now have a variant (as from v4.22) with “hypergroup” replaced with “spannav” in the style name. The original “hypergroup” styles place the navigation line at the start of the first column. The newer “spannav” styles put the navigation line in the optional argument of the <span class="cmss-10">multicols</span><a - id="dx1-164047"></a><a - id="dx1-164048"></a> environment so that it spans across all the + id="dx1-163047"></a><a + id="dx1-163048"></a> environment so that it spans across all the columns. </p> -<!--l. 12890--><p class="noindent" ><a -href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">15.1.9 </span> <a +<!--l. 12731--><p class="noindent" ><a +href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">13.1.9 </span> <a id="sec:inline"></a>In-Line Style</h4> -<!--l. 12893--><p class="noindent" >This section covers the <span +<!--l. 12734--><p class="noindent" >This section covers the <span class="cmss-10">glossary-inline</span><a - id="dx1-165001"></a> package that supplies the <span + id="dx1-164001"></a> package that supplies the <span class="cmss-10">inline</span><a - id="dx1-165002"></a> style. This is a style that is designed for + id="dx1-164002"></a> style. This is a style that is designed for in-line use (as opposed to block styles, such as lists or tables). This style doesn’t display the <a href="#glo:numberlist">number list<a - id="dx1-165003"></a></a>. -</p><!--l. 12898--><p class="indent" > You will most likely need to redefine <span + id="dx1-164003"></a></a>. +</p><!--l. 12739--><p class="indent" > You will most likely need to redefine <span class="cmtt-10">\glossarysection</span><a - id="dx1-165004"></a> with this style. For example, suppose you are + id="dx1-164004"></a> with this style. For example, suppose you are required to have your glossaries and list of acronyms in a footnote, you can do: </p> - <div class="verbatim" id="verbatim-375"> + <pre class="verbatim" id="verbatim-349">  \usepackage{glossary-inline} - <br /> \renewcommand*{\glossarysection}[2][]{\textbf{#1}: } - <br /> \setglossarystyle{inline} -</div> -<!--l. 12906--><p class="nopar" > -</p><!--l. 12908--><p class="indent" > <div class="important" title="Important Note"> Note that you need to include <span + \renewcommand*{\glossarysection}[2][]{\textbf{#1}: } + \setglossarystyle{inline} +</pre> +<!--l. 12747--><p class="nopar" > +</p><!--l. 12749--><p class="indent" > <div class="important" title="Important Note"> Note that you need to include <span class="cmss-10">glossary-inline</span><a - id="dx1-165005"></a> with <span + id="dx1-164005"></a> with <span class="cmtt-10">\usepackage </span>as it’s not automatically included by the <span class="cmss-10">glossaries </span>package and then set the style using <span class="cmtt-10">\setglossarystyle</span><a - id="dx1-165006"></a>. </div> -</p><!--l. 12913--><p class="noindent" > -</p><!--l. 12915--><p class="indent" > Where you need to include your glossaries as a footnote you can do: + id="dx1-164006"></a>. </div> +</p><!--l. 12754--><p class="noindent" > +</p><!--l. 12756--><p class="indent" > Where you need to include your glossaries as a footnote you can do: </p> - <div class="verbatim" id="verbatim-376"> + <pre class="verbatim" id="verbatim-350"> \footnote{\printglossaries} -</div> -<!--l. 12918--><p class="nopar" > -</p><!--l. 12920--><p class="indent" > The <span +</pre> +<!--l. 12759--><p class="nopar" > +</p><!--l. 12761--><p class="indent" > The <span class="cmss-10">inline</span><a - id="dx1-165007"></a> style is governed by the following: -</p><!--l. 12921--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165008"></a> <span + id="dx1-164007"></a> style is governed by the following: +</p><!--l. 12762--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164008"></a> <span class="cmtt-10">\glsinlineseparator</span><a - id="dx1-165009"></a> </div><hr> -</p><!--l. 12923--><p class="noindent" > + id="dx1-164009"></a> </div><hr> +</p><!--l. 12764--><p class="noindent" > This defaults to “<span class="cmtt-10">; </span>” and is used between main (i.e. level 0) entries. -</p><!--l. 12926--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165010"></a> <span +</p><!--l. 12767--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164010"></a> <span class="cmtt-10">\glsinlinesubseparator</span><a - id="dx1-165011"></a> </div><hr> -</p><!--l. 12928--><p class="noindent" > + id="dx1-164011"></a> </div><hr> +</p><!--l. 12769--><p class="noindent" > This defaults to “<span class="cmtt-10">, </span>” and is used between sub-entries. -</p><!--l. 12931--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165012"></a> <span +</p><!--l. 12772--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164012"></a> <span class="cmtt-10">\glsinlineparentchildseparator</span><a - id="dx1-165013"></a> </div><hr> -</p><!--l. 12933--><p class="noindent" > + id="dx1-164013"></a> </div><hr> +</p><!--l. 12774--><p class="noindent" > This defaults to “<span class="cmtt-10">: </span>” and is used between a parent main entry and its first sub-entry. -</p><!--l. 12936--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165014"></a> <span +</p><!--l. 12777--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164014"></a> <span class="cmtt-10">\glspostinline</span><a - id="dx1-165015"></a> </div><hr> -</p><!--l. 12938--><p class="noindent" > + id="dx1-164015"></a> </div><hr> +</p><!--l. 12779--><p class="noindent" > This defaults to “<span class="cmtt-10">; </span>” and is used at the end of the glossary. -</p><!--l. 12941--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165016"></a> <span +</p><!--l. 12782--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164016"></a> <span class="cmtt-10">\glsinlinenameformat{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12943--><p class="noindent" > +</p><!--l. 12784--><p class="noindent" > This is used to format the entry name and defaults to <span class="cmtt-10">\glstarget{</span>⟨<span class="cmti-10">label</span>⟩<span @@ -25832,40 +26265,40 @@ class="cmtt-10">} </span>and ⟨<span class="cmti-10">label</span>⟩ is the entry’s label. For example, if you want the name to appear in <a href="#glo:smallcaps">small caps<a - id="dx1-165017"></a></a>: + id="dx1-164017"></a></a>: </p> - <div class="verbatim" id="verbatim-377"> + <pre class="verbatim" id="verbatim-351"> \renewcommand*{\glsinlinenameformat}[2]{\glstarget{#1}{\textsc{#2}}} -</div> -<!--l. 12951--><p class="nopar" > Sub-entry names are formatted according to -</p><!--l. 12953--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165018"></a> <span +</pre> +<!--l. 12792--><p class="nopar" > Sub-entry names are formatted according to +</p><!--l. 12794--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164018"></a> <span class="cmtt-10">\glsinlinesubnameformat{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">name</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12955--><p class="noindent" > +</p><!--l. 12796--><p class="noindent" > This defaults to <span class="cmtt-10">\glstarget{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span><span class="obeylines-h"><span class="verb"><span class="cmtt-10">{}</span></span></span> so the sub-entry name is ignored. -</p><!--l. 12959--><p class="indent" > If the description has been suppressed (according to <span +</p><!--l. 12800--><p class="indent" > If the description has been suppressed (according to <span class="cmtt-10">\ifglsdescsuppressed</span>) then -</p><!--l. 12961--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165019"></a> <span +</p><!--l. 12802--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164019"></a> <span class="cmtt-10">\glsinlineemptydescformat{</span>⟨<span class="cmitt-10">symbol</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">number list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12963--><p class="noindent" > +</p><!--l. 12804--><p class="noindent" > (which defaults to nothing) is used, otherwise the description is formatted according to -</p><!--l. 12966--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165020"></a> <span +</p><!--l. 12807--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164020"></a> <span class="cmtt-10">\glsinlinedescformat{</span>⟨<span class="cmitt-10">description</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -25873,24 +26306,24 @@ class="cmitt-10">symbol</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">number list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12969--><p class="noindent" > +</p><!--l. 12810--><p class="noindent" > This defaults to just <span class="cmtt-10">\space</span>⟨<span class="cmti-10">description</span>⟩ so the symbol and location list are ignored. If the description is missing (according to <span class="cmtt-10">\ifglshasdesc</span>), then <span class="cmtt-10">\glsinlineemptydescformat </span>is used instead. -</p><!--l. 12975--><p class="indent" > For example, if you want a colon between the name and the description: +</p><!--l. 12816--><p class="indent" > For example, if you want a colon between the name and the description: </p> - <div class="verbatim" id="verbatim-378"> + <pre class="verbatim" id="verbatim-352"> \renewcommand*{\glsinlinedescformat}[3]{: #1} -</div> -<!--l. 12979--><p class="nopar" > -</p><!--l. 12981--><p class="indent" > The sub-entry description is formatted according to: -</p><!--l. 12982--><p class="indent" > <hr><div title="Definition"><a - id="dx1-165021"></a> <span +</pre> +<!--l. 12820--><p class="nopar" > +</p><!--l. 12822--><p class="indent" > The sub-entry description is formatted according to: +</p><!--l. 12823--><p class="indent" > <hr><div title="Definition"><a + id="dx1-164021"></a> <span class="cmtt-10">\glsinlinesubdescformat{</span>⟨<span class="cmitt-10">description</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -25898,107 +26331,117 @@ class="cmitt-10">symbol</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">number list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12985--><p class="noindent" > +</p><!--l. 12826--><p class="noindent" > This defaults to just ⟨<span class="cmti-10">description</span>⟩. -</p><!--l. 12988--><p class="noindent" > +</p><!--l. 12829--><p class="noindent" > </p> -<!--l. 12988--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">15.2 </span> <a +<!--l. 12829--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">13.2 </span> <a id="sec:newglossarystyle"></a>Defining your own glossary style</h3> -<!--l. 12991--><p class="noindent" >If the predefined styles don’t fit your requirements, you can define your own style using: -</p><!--l. 12993--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166001"></a> <span +<!--l. 12832--><p class="noindent" ><div class="important" title="Important Note"> Commands like <span +class="cmtt-10">\printglossary </span>are designed to produce content in the PDF. If your intention is to design a +style that doesn’t print any content (for example, to simply capture information) then you are likely to +experience unwanted side-effects. If you just want to capture indexing information (such as locations) then a +much better approach is to use <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-165001"></a></a>, which automatically stores this information in dedicated fields when +the entry is defined. </div> +</p><!--l. 12840--><p class="noindent" > +</p><!--l. 12842--><p class="noindent" >If the predefined styles don’t fit your requirements, you can define your own style using: +</p><!--l. 12844--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165002"></a> <span class="cmtt-10">\newglossarystyle{</span>⟨<span class="cmitt-10">name</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">definitions</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 12995--><p class="noindent" > +</p><!--l. 12846--><p class="noindent" > where ⟨<span class="cmti-10">name</span>⟩ is the name of the new glossary style (to be used in <span class="cmtt-10">\setglossarystyle</span>). The second argument ⟨<span class="cmti-10">definitions</span>⟩ needs to redefine all of the following: -</p><!--l. 13000--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166002"></a><a - id="dx1-166003"></a> <span +</p><!--l. 12851--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165003"></a><a + id="dx1-165004"></a> <span class="cmss-10">theglossary</span><a - id="dx1-166004"></a><a - id="dx1-166005"></a> </div><hr> -</p><!--l. 13002--><p class="noindent" > + id="dx1-165005"></a><a + id="dx1-165006"></a> </div><hr> +</p><!--l. 12853--><p class="noindent" > This environment defines how the main body of the glossary should be typeset. -</p><!--l. 13006--><p class="indent" > Note that this does not include the section heading, the glossary preamble (defined by <span +</p><!--l. 12857--><p class="indent" > Note that this does not include the section heading, the glossary preamble (defined by <span class="cmtt-10">\glossarypreamble</span><a - id="dx1-166006"></a>) + id="dx1-165007"></a>) or the glossary postamble (defined by <span class="cmtt-10">\glossarypostamble</span><a - id="dx1-166007"></a>). For example, the <span + id="dx1-165008"></a>). For example, the <span class="cmss-10">list</span><a - id="dx1-166008"></a> style uses the <span + id="dx1-165009"></a> style uses the <span class="cmss-10">description</span><a - id="dx1-166009"></a><a - id="dx1-166010"></a> + id="dx1-165010"></a><a + id="dx1-165011"></a> environment, so the <span class="cmss-10">theglossary</span><a - id="dx1-166011"></a><a - id="dx1-166012"></a> environment is simply redefined to begin and end the <span + id="dx1-165012"></a><a + id="dx1-165013"></a> environment is simply redefined to begin and end the <span class="cmss-10">description</span><a - id="dx1-166013"></a><a - id="dx1-166014"></a> + id="dx1-165014"></a><a + id="dx1-165015"></a> environment. -</p><!--l. 13013--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166015"></a> <span +</p><!--l. 12864--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165016"></a> <span class="cmtt-10">\glossaryheader </span></div><hr> -</p><!--l. 13015--><p class="noindent" > +</p><!--l. 12866--><p class="noindent" > This macro indicates what to do at the start of the main body of the glossary. Note that this is not the same as <span class="cmtt-10">\glossarypreamble</span><a - id="dx1-166016"></a>, which should not be affected by changes in the glossary style. The <span + id="dx1-165017"></a>, which should not be affected by changes in the glossary style. The <span class="cmss-10">list</span><a - id="dx1-166017"></a> glossary style + id="dx1-165018"></a> glossary style redefines <span class="cmtt-10">\glossaryheader</span><a - id="dx1-166018"></a> to do nothing, whereas the <span + id="dx1-165019"></a> to do nothing, whereas the <span class="cmss-10">longheader</span><a - id="dx1-166019"></a> glossary style redefines <span + id="dx1-165020"></a> glossary style redefines <span class="cmtt-10">\glossaryheader </span>to do a header row. -</p><!--l. 13023--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166020"></a> <span +</p><!--l. 12874--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165021"></a> <span class="cmtt-10">\glsgroupheading{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13025--><p class="noindent" > +</p><!--l. 12876--><p class="noindent" > This macro indicates what to do at the start of each logical block within the main body of the glossary. If you use <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-166021"></a></a> the glossary is sub-divided into a maximum of twenty-eight logical blocks that are determined by + id="dx1-165022"></a></a> the glossary is sub-divided into a maximum of twenty-eight logical blocks that are determined by + + the first character of the <span class="cmtt-10">sort</span><a - id="dx1-166022"></a> key (or <span + id="dx1-165023"></a> key (or <span class="cmtt-10">name</span><a - id="dx1-166023"></a> key if the <span + id="dx1-165024"></a> key if the <span class="cmtt-10">sort</span><a - id="dx1-166024"></a> key is omitted). The sub-divisions are in the + id="dx1-165025"></a> key is omitted). The sub-divisions are in the following order: symbols, numbers, A, …, Z. If you use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-166025"></a></a>, the sub-divisions depend on the language + id="dx1-165026"></a></a>, the sub-divisions depend on the language settings. -</p><!--l. 13036--><p class="indent" > Note that the argument to <span +</p><!--l. 12887--><p class="indent" > Note that the argument to <span class="cmtt-10">\glsgroupheading </span>is a label <span class="cmti-10">not </span>the group title. The group title can be obtained via -</p><!--l. 13039--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166026"></a> <span +</p><!--l. 12890--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165027"></a> <span class="cmtt-10">\glsgetgrouptitle{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> - - -</p><!--l. 13041--><p class="noindent" > +</p><!--l. 12892--><p class="noindent" > This obtains the title as follows: if ⟨<span class="cmti-10">label</span>⟩ consists of a single non-active character or ⟨<span class="cmti-10">label</span>⟩ is equal to <span @@ -26012,180 +26455,181 @@ class="cmti-10">label</span>⟩. (The “symbols” group has the label <span class="cmtt-10">glssymbols</span>, so the command <span class="cmtt-10">\glssymbolsgroupname</span><a - id="dx1-166027"></a> is used, + id="dx1-165028"></a> is used, and the “numbers” group has the label <span class="cmtt-10">glsnumbers</span>, so the command <span class="cmtt-10">\glsnumbersgrouptitle</span><a - id="dx1-166028"></a> is + id="dx1-165029"></a> is used.) If you are using <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-166029"></a></a>, ⟨<span + id="dx1-165030"></a></a>, ⟨<span class="cmti-10">label</span>⟩ may be an active character (for example ø), in which case the title will be set to just ⟨<span class="cmti-10">label</span>⟩. You can redefine <span class="cmtt-10">\glsgetgrouptitle </span>if this is unsuitable for your document. -</p><!--l. 13055--><p class="indent" > A navigation hypertarget can be created using -</p><!--l. 13056--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166030"></a> <span +</p><!--l. 12906--><p class="indent" > A navigation hypertarget can be created using +</p><!--l. 12907--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165031"></a> <span class="cmtt-10">\glsnavhypertarget{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13058--><p class="noindent" > +</p><!--l. 12909--><p class="noindent" > This typically requires <span class="cmtt-10">\glossaryheader </span>to be redefined to use -</p><!--l. 13060--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166031"></a> <span +</p><!--l. 12911--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165032"></a> <span class="cmtt-10">\glsnavigation </span></div><hr> -</p><!--l. 13062--><p class="noindent" > +</p><!--l. 12913--><p class="noindent" > which displays the navigation line. -</p><!--l. 13065--><p class="indent" > For further details about <span +</p><!--l. 12916--><p class="indent" > For further details about <span class="cmtt-10">\glsnavhypertarget</span>, see the documented code (<span class="cmtt-10">glossaries-code.pdf</span>). -</p><!--l. 13069--><p class="indent" > Most of the predefined glossary styles redefine <span +</p><!--l. 12920--><p class="indent" > Most of the predefined glossary styles redefine <span class="cmtt-10">\glsgroupheading </span>to simply ignore its argument. The <span class="cmss-10">listhypergroup</span><a - id="dx1-166032"></a> style redefines <span + id="dx1-165033"></a> style redefines <span class="cmtt-10">\glsgroupheading </span>as follows: </p> - <div class="verbatim" id="verbatim-379"> + <pre class="verbatim" id="verbatim-353"> \renewcommand*{\glsgroupheading}[1]{% - <br />\item[\glsnavhypertarget{##1}{\glsgetgrouptitle{##1}}]} -</div> -<!--l. 13075--><p class="nopar" > See also <span +\item[\glsnavhypertarget{##1}{\glsgetgrouptitle{##1}}]} +</pre> +<!--l. 12926--><p class="nopar" > See also <span class="cmtt-10">\glsgroupskip </span>below. -</p><!--l. 13078--><p class="indent" > Note that command definitions within <span +</p><!--l. 12929--><p class="indent" > Note that command definitions within <span class="cmtt-10">\newglossarystyle</span><a - id="dx1-166033"></a> must use <span class="obeylines-h"><span class="verb"><span + id="dx1-165034"></a> must use <span class="obeylines-h"><span class="verb"><span class="cmtt-10">##1</span></span></span> instead of <span class="obeylines-h"><span class="verb"><span class="cmtt-10">#1</span></span></span> etc. -</p><!--l. 13081--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166034"></a> <span +</p><!--l. 12932--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165035"></a> <span class="cmtt-10">\glsgroupskip </span></div><hr> -</p><!--l. 13083--><p class="noindent" > +</p><!--l. 12934--><p class="noindent" > This macro determines what to do after one logical group but before the header for the next logical group. The <span class="cmss-10">list</span><a - id="dx1-166035"></a> glossary style simply redefines <span + id="dx1-165036"></a> glossary style simply redefines <span class="cmtt-10">\glsgroupskip </span>to be <span class="cmtt-10">\indexspace</span><a - id="dx1-166036"></a>, whereas the tabular-like styles redefine + id="dx1-165037"></a>, whereas the tabular-like styles redefine <span class="cmtt-10">\glsgroupskip </span>to produce a blank row. -</p><!--l. 13090--><p class="indent" > As from version 3.03, the package option <span +</p><!--l. 12941--><p class="indent" > As from version 3.03, the package option <span class="cmss-10">nogroupskip</span><a - id="dx1-166037"></a> can be used to suppress this default gap for the + id="dx1-165038"></a> can be used to suppress this default gap for the predefined styles. -</p><!--l. 13093--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166038"></a> <span +</p><!--l. 12944--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165039"></a> <span class="cmtt-10">\glossentry{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">number list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13095--><p class="noindent" > +</p><!--l. 12946--><p class="noindent" > This macro indicates what to do for each top-level (level 0) glossary entry. The entry label is given by ⟨<span class="cmti-10">label</span>⟩ and the associated <a href="#glo:numberlist">number list<a - id="dx1-166039"></a></a> is given by ⟨<span + id="dx1-165040"></a></a> is given by ⟨<span class="cmti-10">number list</span>⟩. You can redefine <span class="cmtt-10">\glossentry</span><a - id="dx1-166040"></a> to use commands like + id="dx1-165041"></a> to use commands like <span class="cmtt-10">\glossentryname</span><a - id="dx1-166041"></a><span + id="dx1-165042"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">}</span>, <span class="cmtt-10">\glossentrydesc</span><a - id="dx1-166042"></a><span + id="dx1-165043"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">} </span>and <span class="cmtt-10">\glossentrysymbol</span><a - id="dx1-166043"></a><span + id="dx1-165044"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span class="cmtt-10">} </span>to display the name, description and symbol fields, or to access other fields, use commands like <span class="cmtt-10">\glsentryuseri</span><a - id="dx1-166044"></a><span + id="dx1-165045"></a><span class="cmtt-10">{</span>⟨<span class="cmti-10">label</span>⟩<span -class="cmtt-10">}</span>. -(See <a -href="#sec:glsnolink">§9 </a><a +class="cmtt-10">}</span>. (See +<a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </a><a href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a> for further details.) You can also use the following commands: -</p><!--l. 13106--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166045"></a> <span +</p><!--l. 12957--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165046"></a> <span class="cmtt-10">\glsentryitem{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13108--><p class="noindent" > +</p><!--l. 12959--><p class="noindent" > This macro will increment and display the associated counter for the main (level 0) entries if the <span class="cmss-10">entrycounter</span><a - id="dx1-166046"></a> or + id="dx1-165047"></a> or <span class="cmss-10">counterwithin</span><a - id="dx1-166047"></a> package options have been used. This macro is typically called by <span + id="dx1-165048"></a> package options have been used. This macro is typically called by <span class="cmtt-10">\glossentry </span>before <span class="cmtt-10">\glstarget</span>. The format of the counter is controlled by the macro -</p><!--l. 13114--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166048"></a> <span +</p><!--l. 12965--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165049"></a> <span class="cmtt-10">\glsentrycounterlabel </span></div><hr> -</p><!--l. 13116--><p class="noindent" > -</p><!--l. 13118--><p class="indent" > Each time you use a glossary entry it creates a hyperlink (if hyperlinks are enabled) to the relevant line in +</p><!--l. 12967--><p class="noindent" > +</p><!--l. 12969--><p class="indent" > Each time you use a glossary entry it creates a hyperlink (if hyperlinks are enabled) to the relevant line in the glossary. Your new glossary style must therefore redefine <span class="cmtt-10">\glossentry </span>to set the appropriate target. This is done using -</p><!--l. 13123--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166049"></a> <span +</p><!--l. 12974--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165050"></a> <span class="cmtt-10">\glstarget{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">text</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13125--><p class="noindent" > +</p><!--l. 12976--><p class="noindent" > where ⟨<span class="cmti-10">label</span>⟩ is the entry’s label. Note that you don’t need to worry about whether the <span class="cmss-10">hyperref</span><a - id="dx1-166050"></a> package has been + id="dx1-165051"></a> package has been loaded, as <span class="cmtt-10">\glstarget </span>won’t create a target if <span class="cmtt-10">\hypertarget </span>hasn’t been defined. -</p><!--l. 13131--><p class="indent" > For example, the <span +</p><!--l. 12982--><p class="indent" > For example, the <span class="cmss-10">list</span><a - id="dx1-166051"></a> style defines <span + id="dx1-165052"></a> style defines <span class="cmtt-10">\glossentry </span>as follows: </p> - <div class="verbatim" id="verbatim-380"> + <pre class="verbatim" id="verbatim-354">   \renewcommand*{\glossentry}[2]{% - <br />    \item[\glsentryitem{##1}% - <br />          \glstarget{##1}{\glossentryname{##1}}] - <br />       \glossentrydesc{##1}\glspostdescription\space ##2} -</div> -<!--l. 13137--><p class="nopar" > -</p><!--l. 13139--><p class="indent" > Note also that ⟨<span +    \item[\glsentryitem{##1}% +          \glstarget{##1}{\glossentryname{##1}}] +       \glossentrydesc{##1}\glspostdescription\space ##2} +</pre> +<!--l. 12988--><p class="nopar" > +</p><!--l. 12990--><p class="indent" > Note also that ⟨<span class="cmti-10">number list</span>⟩ will always be of the form -</p><!--l. 13141--><p class="indent" > <hr><div title="Definition"><span +</p><!--l. 12992--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\glossaryentrynumbers</span><a - id="dx1-166052"></a><span + id="dx1-165053"></a><span class="cmsy-10">{</span><span class="cmtt-10">\relax</span><br class="newline" /><span class="cmtt-10">\setentrycounter</span><a - id="dx1-166053"></a><span + id="dx1-165054"></a><span class="cmtt-10">[</span>⟨<span class="cmitt-10">Hprefix</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -26196,16 +26640,16 @@ class="cmtt-10">{</span>⟨<span class="cmitt-10">number(s)</span>⟩<span class="cmtt-10">}</span><span class="cmsy-10">} </span></div><hr> -</p><!--l. 13143--><p class="noindent" > +</p><!--l. 12994--><p class="noindent" > where ⟨<span class="cmti-10">number(s)</span>⟩ may contain <span class="cmtt-10">\delimN</span><a - id="dx1-166054"></a> (to delimit individual numbers) and/or <span + id="dx1-165055"></a> (to delimit individual numbers) and/or <span class="cmtt-10">\delimR</span><a - id="dx1-166055"></a> (to indicate a range of + id="dx1-165056"></a> (to indicate a range of numbers). There may be multiple occurrences of <span class="cmtt-10">\setentrycounter</span><a - id="dx1-166056"></a><span + id="dx1-165057"></a><span class="cmtt-10">[</span>⟨<span class="cmti-10">Hprefix</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -26217,22 +26661,22 @@ class="cmtt-10">{</span>⟨<span class="cmti-10">number(s)</span>⟩<span class="cmtt-10">}</span>, but note that the entire number list is enclosed within the argument of <span class="cmtt-10">\glossaryentrynumbers</span><a - id="dx1-166057"></a>. + id="dx1-165058"></a>. The user can redefine this to change the way the entire number list is formatted, regardless of the glossary style. However the most common use of <span class="cmtt-10">\glossaryentrynumbers</span><a - id="dx1-166058"></a> is to provide a means of suppressing the number list + id="dx1-165059"></a> is to provide a means of suppressing the number list altogether. (In fact, the <span class="cmss-10">nonumberlist</span><a - id="dx1-166059"></a> option redefines <span + id="dx1-165060"></a> option redefines <span class="cmtt-10">\glossaryentrynumbers</span><a - id="dx1-166060"></a> to ignore its argument.) + id="dx1-165061"></a> to ignore its argument.) Therefore, when you define a new glossary style, you don’t need to worry about whether the user has specified the <span class="cmss-10">nonumberlist</span><a - id="dx1-166061"></a> package option. -</p><!--l. 13160--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166062"></a> <span + id="dx1-165062"></a> package option. +</p><!--l. 13011--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165063"></a> <span class="cmtt-10">\subglossentry{</span>⟨<span class="cmitt-10">level</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26240,291 +26684,1307 @@ class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">number list</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13162--><p class="noindent" > +</p><!--l. 13013--><p class="noindent" > This is used to display sub-entries. The first argument, ⟨<span class="cmti-10">level</span>⟩, indicates the sub-entry level. This must be an integer from 1 (first sub-level) onwards. The remaining arguments are analogous to those for <span class="cmtt-10">\glossentry</span><a - id="dx1-166063"></a> + id="dx1-165064"></a> described above. -</p><!--l. 13169--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166064"></a> <span +</p><!--l. 13020--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165065"></a> <span class="cmtt-10">\glssubentryitem{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13171--><p class="noindent" > +</p><!--l. 13022--><p class="noindent" > This macro will increment and display the associated counter for the level 1 entries if the <span class="cmss-10">subentrycounter</span><a - id="dx1-166065"></a> + id="dx1-165066"></a> package option has been used. This macro is typically called by <span class="cmtt-10">\subglossentry </span>before <span class="cmtt-10">\glstarget</span><a - id="dx1-166066"></a>. The + id="dx1-165067"></a>. The format of the counter is controlled by the macro -</p><!--l. 13177--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166067"></a> <span +</p><!--l. 13028--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165068"></a> <span class="cmtt-10">\glssubentrycounterlabel </span></div><hr> -</p><!--l. 13179--><p class="noindent" > -</p><!--l. 13181--><p class="indent" > Note that <span +</p><!--l. 13030--><p class="noindent" > +</p><!--l. 13032--><p class="indent" > Note that <span class="cmtt-10">\printglossary</span><a - id="dx1-166068"></a> (which <span + id="dx1-165069"></a> (which <span class="cmtt-10">\printglossaries</span><a - id="dx1-166069"></a> calls) sets -</p><!--l. 13183--><p class="indent" > <hr><div title="Definition"><a - id="dx1-166070"></a> <span + id="dx1-165070"></a> calls) sets +</p><!--l. 13034--><p class="indent" > <hr><div title="Definition"><a + id="dx1-165071"></a> <span class="cmtt-10">\currentglossary </span></div><hr> -</p><!--l. 13185--><p class="noindent" > +</p><!--l. 13036--><p class="noindent" > to the current glossary label, so it’s possible to create a glossary style that varies according to the glossary type. -</p><!--l. 13189--><p class="indent" > For further details of these commands, see “Displaying the glossary” in the documented code +</p><!--l. 13040--><p class="indent" > For further details of these commands, see “Displaying the glossary” in the documented code (<span class="cmtt-10">glossaries-code.pdf</span>). <a id="sec:exnewstyle"></a> -</p><!--l. 13193--><p class="noindent" ><span -class="cmbx-12">Example 27</span><span +</p><!--l. 13044--><p class="noindent" ><span +class="cmbx-12">Example 23</span><span class="cmbx-12"> (Creating a completely new style)</span><a - id="x1-166072"></a> -</p><!--l. 13195--><p class="indent" > If you want a completely new style, you will need to redefine all of the commands and the environment listed + id="x1-165073"></a> +</p><!--l. 13046--><p class="indent" > If you want a completely new style, you will need to redefine all of the commands and the environment listed above. -</p><!--l. 13198--><p class="indent" > For example, suppose you want each entry to start with a bullet point. This means that the glossary should +</p><!--l. 13049--><p class="indent" > For example, suppose you want each entry to start with a bullet point. This means that the glossary should be placed in the <span class="cmss-10">itemize</span><a - id="dx1-166073"></a><a - id="dx1-166074"></a> environment, so <span + id="dx1-165074"></a><a + id="dx1-165075"></a> environment, so <span class="cmss-10">theglossary</span><a - id="dx1-166075"></a><a - id="dx1-166076"></a> should start and end that environment. Let’s also suppose + id="dx1-165076"></a><a + id="dx1-165077"></a> should start and end that environment. Let’s also suppose that you don’t want anything between the glossary groups (so <span class="cmtt-10">\glsgroupheading</span><a - id="dx1-166077"></a> and <span + id="dx1-165078"></a> and <span class="cmtt-10">\glsgroupskip</span><a - id="dx1-166078"></a> should + id="dx1-165079"></a> should do nothing) and suppose you don’t want anything to appear immediately after <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\begin{theglossary}</span></span></span> (so <span class="cmtt-10">\glossaryheader</span><a - id="dx1-166079"></a> should do nothing). In addition, let’s suppose the symbol should appear in brackets + id="dx1-165080"></a> should do nothing). In addition, let’s suppose the symbol should appear in brackets after the name, followed by the description and last of all the <a href="#glo:numberlist">number list<a - id="dx1-166080"></a></a> should appear within + id="dx1-165081"></a></a> should appear within square brackets at the end. Then you can create this new glossary style, called, say, <span class="cmtt-10">mylist</span>, as follows: </p> - <div class="verbatim" id="verbatim-381"> + <pre class="verbatim" id="verbatim-355">  \newglossarystyle{mylist}{% - <br /> % put the glossary in the itemize environment: - <br /> \renewenvironment{theglossary}% - <br />   {\begin{itemize}}{\end{itemize}}% - <br /> % have nothing after \begin{theglossary}: - <br /> \renewcommand*{\glossaryheader}{}% - <br /> % have nothing between glossary groups: - <br /> \renewcommand*{\glsgroupheading}[1]{}% - <br /> \renewcommand*{\glsgroupskip}{}% - <br /> % set how each entry should appear: - <br /> \renewcommand*{\glossentry}[2]{% - <br /> \item % bullet point - <br /> \glstarget{##1}{\glossentryname{##1}}% the entry name - <br /> \space (\glossentrysymbol{##1})% the symbol in brackets - <br /> \space \glossentrydesc{##1}% the description - <br /> \space [##2]% the number list in square brackets - <br /> }% - <br /> % set how sub-entries appear: - <br /> \renewcommand*{\subglossentry}[3]{% - <br />   \glossentry{##2}{##3}}% - <br /> } -</div> -<!--l. 13232--><p class="nopar" > Note that this style creates a flat glossary, where sub-entries are displayed in exactly the same way as the top + % put the glossary in the itemize environment: + \renewenvironment{theglossary}% +   {\begin{itemize}}{\end{itemize}}% + % have nothing after \begin{theglossary}: + \renewcommand*{\glossaryheader}{}% + % have nothing between glossary groups: + \renewcommand*{\glsgroupheading}[1]{}% + \renewcommand*{\glsgroupskip}{}% + % set how each entry should appear: + \renewcommand*{\glossentry}[2]{% + \item % bullet point + \glstarget{##1}{\glossentryname{##1}}% the entry name + \space (\glossentrysymbol{##1})% the symbol in brackets + \space \glossentrydesc{##1}% the description + \space [##2]% the number list in square brackets + }% + % set how sub-entries appear: + \renewcommand*{\subglossentry}[3]{% +   \glossentry{##2}{##3}}% + } +</pre> +<!--l. 13083--><p class="nopar" > Note that this style creates a flat glossary, where sub-entries are displayed in exactly the same way as the top level entries. It also hasn’t used <span class="cmtt-10">\glsentryitem</span><a - id="dx1-166081"></a> or <span + id="dx1-165082"></a> or <span class="cmtt-10">\glssubentryitem</span><a - id="dx1-166082"></a> so it won’t be affected by the + id="dx1-165083"></a> so it won’t be affected by the <span class="cmss-10">entrycounter</span><a - id="dx1-166083"></a>, <span + id="dx1-165084"></a>, <span class="cmss-10">counterwithin</span><a - id="dx1-166084"></a> or <span + id="dx1-165085"></a> or <span class="cmss-10">subentrycounter</span><a - id="dx1-166085"></a> package options. -</p><!--l. 13239--><p class="indent" > Variations: </p> + id="dx1-165086"></a> package options. +</p><!--l. 13090--><p class="indent" > Variations: </p> <ul class="itemize1"> - <li class="itemize">You might want the entry name to be capitalised, in which case use <span + <li class="itemize"> + <!--l. 13092--><p class="noindent" >You might want the entry name to be capitalised, in which case use <span class="cmtt-10">\Glossentryname</span><a - id="dx1-166086"></a> instead of + id="dx1-165087"></a> instead of <span class="cmtt-10">\glossentryname</span><a - id="dx1-166087"></a>. - </li> - <li class="itemize">You might want to check if the symbol hasn’t been set and omit the parentheses if the symbol is absent. In + id="dx1-165088"></a>. + </p></li> + <li class="itemize"> + <!--l. 13095--><p class="noindent" >You might want to check if the symbol hasn’t been set and omit the parentheses if the symbol is absent. In this case you can use <span class="cmtt-10">\ifglshassymbol</span><a - id="dx1-166088"></a> (see <a -href="#sec:utilities">§16 </a><a + id="dx1-165089"></a> (see <a +href="#sec:utilities">§<span +class="cmbx-10">??</span>sec:utilities </a><a href="#sec:utilities">Utilities<!--tex4ht:ref: sec:utilities --></a>): - <div class="verbatim" id="verbatim-382"> +</p> + <pre class="verbatim" id="verbatim-356">  \renewcommand*{\glossentry}[2]{% -  <br /> \item % bullet point -  <br /> \glstarget{##1}{\glossentryname{##1}}% the entry name -  <br /> \ifglshassymbol{##1}% check if symbol exists -  <br /> {% -  <br />   \space (\glossentrysymbol{##1})% the symbol in brackets -  <br /> }% -  <br /> {}% no symbol so do nothing -  <br /> \space \glossentrydesc{##1}% the description -  <br /> \space [##2]% the number list in square brackets -  <br /> }% -</div> - <!--l. 13259--><p class="nopar" ></p></li></ul> +  \item % bullet point +  \glstarget{##1}{\glossentryname{##1}}% the entry name +  \ifglshassymbol{##1}% check if symbol exists +  {% +    \space (\glossentrysymbol{##1})% the symbol in brackets +  }% +  {}% no symbol so do nothing +  \space \glossentrydesc{##1}% the description +  \space [##2]% the number list in square brackets +  }% +</pre> + <!--l. 13110--><p class="nopar" ></p></li></ul> <div class="center" > -<!--l. 13261--><p class="noindent" > -</p><!--l. 13261--><p class="noindent" >____________________________</p></div> +<!--l. 13112--><p class="noindent" > +</p><!--l. 13112--><p class="noindent" >____________________________</p></div> <a id="sec:exadaptstyle"></a> -<!--l. 13264--><p class="noindent" ><span -class="cmbx-12">Example 28</span><span +<!--l. 13115--><p class="noindent" ><span +class="cmbx-12">Example 24</span><span class="cmbx-12"> (Creating a new glossary style based on an existing style)</span><a - id="x1-166090"></a> -</p><!--l. 13266--><p class="indent" > If you want to define a new style that is a slightly modified version of an existing style, you can use + id="x1-165091"></a> +</p><!--l. 13117--><p class="indent" > If you want to define a new style that is a slightly modified version of an existing style, you can use <span class="cmtt-10">\setglossarystyle</span><a - id="dx1-166091"></a> within the second argument of <span + id="dx1-165092"></a> within the second argument of <span class="cmtt-10">\newglossarystyle</span><a - id="dx1-166092"></a> followed by whatever alterations you + id="dx1-165093"></a> followed by whatever alterations you require. For example, suppose you want a style like the <span class="cmss-10">list</span><a - id="dx1-166093"></a> style but you don’t want the extra vertical space + id="dx1-165094"></a> style but you don’t want the extra vertical space created by <span class="cmtt-10">\indexspace</span><a - id="dx1-166094"></a> between groups, then you can create a new glossary style called, say, <span + id="dx1-165095"></a> between groups, then you can create a new glossary style called, say, <span class="cmtt-10">mylist </span>as follows: </p> - <div class="verbatim" id="verbatim-383"> + <pre class="verbatim" id="verbatim-357"> \newglossarystyle{mylist}{% - <br />\setglossarystyle{list}% base this style on the list style - <br />\renewcommand{\glsgroupskip}{}% make nothing happen - <br />                              % between groups - <br />} -</div> -<!--l. 13280--><p class="nopar" > (In this case, you can actually achieve the same effect using the <span +\setglossarystyle{list}% base this style on the list style +\renewcommand{\glsgroupskip}{}% make nothing happen +                              % between groups +} +</pre> +<!--l. 13131--><p class="nopar" > (In this case, you can actually achieve the same effect using the <span class="cmss-10">list</span><a - id="dx1-166095"></a> style in combination with the package + id="dx1-165096"></a> style in combination with the package option <span class="cmss-10">nogroupskip</span><a - id="dx1-166096"></a>.) </p> + id="dx1-165097"></a>.) </p> <div class="center" > -<!--l. 13284--><p class="noindent" > -</p><!--l. 13284--><p class="noindent" >____________________________</p></div> +<!--l. 13135--><p class="noindent" > +</p><!--l. 13135--><p class="noindent" >____________________________</p></div> <a id="sec:exuserstyle"></a> -<!--l. 13288--><p class="noindent" ><span -class="cmbx-12">Example 29</span><span +<!--l. 13139--><p class="noindent" ><span +class="cmbx-12">Example 25</span><span class="cmbx-12"> (Example: creating a glossary style that uses the </span><span class="cmtt-12">user1</span><a - id="dx1-166098"></a><span + id="dx1-165099"></a><span class="cmbx-12">, </span><span class="cmbx-12">…, </span><span class="cmtt-12">user6</span><a - id="dx1-166099"></a> + id="dx1-165100"></a> <span class="cmbx-12">keys)</span><a - id="x1-166100"></a> -</p><!--l. 13290--><p class="indent" > Suppose each entry not only has an associated symbol, but also units (stored in <span + id="x1-165101"></a> +</p><!--l. 13141--><p class="indent" > Suppose each entry not only has an associated symbol, but also units (stored in <span class="cmtt-10">user1</span><a - id="dx1-166101"></a>) and dimension + id="dx1-165102"></a>) and dimension (stored in <span class="cmtt-10">user2</span><a - id="dx1-166102"></a>). Then you can define a glossary style that displays each entry in a <span + id="dx1-165103"></a>). Then you can define a glossary style that displays each entry in a <span class="cmss-10">longtable</span><a - id="dx1-166103"></a><a - id="dx1-166104"></a> as + id="dx1-165104"></a><a + id="dx1-165105"></a> as follows: </p> - <div class="verbatim" id="verbatim-384"> + <pre class="verbatim" id="verbatim-358"> \newglossarystyle{long6col}{% - <br /> % put the glossary in a longtable environment: - <br /> \renewenvironment{theglossary}% - <br />  {\begin{longtable}{lp{\glsdescwidth}cccp{\glspagelistwidth}}}% - <br />  {\end{longtable}}% - <br /> % Set the table's header: - <br /> \renewcommand*{\glossaryheader}{% - <br />  \bfseries Term & \bfseries Description & \bfseries Symbol & - <br />  \bfseries Units & \bfseries Dimensions & \bfseries Page List - <br />  \\\endhead}% - <br /> % No heading between groups: - <br />  \renewcommand*{\glsgroupheading}[1]{}% - <br /> % Main (level 0) entries displayed in a row optionally numbered: - <br />  \renewcommand*{\glossentry}[2]{% - <br />    \glsentryitem{##1}% Entry number if required - <br />    \glstarget{##1}{\glossentryname{##1}}% Name - <br />    & \glossentrydesc{##1}% Description - <br />    & \glossentrysymbol{##1}% Symbol - <br />    & \glsentryuseri{##1}% Units - <br />    & \glsentryuserii{##1}% Dimensions - <br />    & ##2% Page list - <br />    \tabularnewline % end of row - <br />  }% - <br /> % Similarly for sub-entries (no sub-entry numbers): - <br /> \renewcommand*{\subglossentry}[3]{% - <br />    % ignoring first argument (sub-level) - <br />    \glstarget{##2}{\glossentryname{##2}}% Name - <br />    & \glossentrydesc{##2}% Description - <br />    & \glossentrysymbol{##2}% Symbol - <br />    & \glsentryuseri{##2}% Units - <br />    & \glsentryuserii{##2}% Dimensions - <br />    & ##3% Page list - <br />    \tabularnewline % end of row - <br />  }% - <br /> % Nothing between groups: - <br /> \renewcommand*{\glsgroupskip}{}% - <br />} -</div> -<!--l. 13332--><p class="nopar" > </p> + % put the glossary in a longtable environment: + \renewenvironment{theglossary}% +  {\begin{longtable}{lp{\glsdescwidth}cccp{\glspagelistwidth}}}% +  {\end{longtable}}% + % Set the table's header: + \renewcommand*{\glossaryheader}{% +  \bfseries Term & \bfseries Description & \bfseries Symbol & +  \bfseries Units & \bfseries Dimensions & \bfseries Page List +  \\\endhead}% + % No heading between groups: +  \renewcommand*{\glsgroupheading}[1]{}% + % Main (level 0) entries displayed in a row optionally numbered: +  \renewcommand*{\glossentry}[2]{% +    \glsentryitem{##1}% Entry number if required +    \glstarget{##1}{\glossentryname{##1}}% Name +    & \glossentrydesc{##1}% Description +    & \glossentrysymbol{##1}% Symbol +    & \glsentryuseri{##1}% Units +    & \glsentryuserii{##1}% Dimensions +    & ##2% Page list +    \tabularnewline % end of row +  }% + % Similarly for sub-entries (no sub-entry numbers): + \renewcommand*{\subglossentry}[3]{% +    % ignoring first argument (sub-level) +    \glstarget{##2}{\glossentryname{##2}}% Name +    & \glossentrydesc{##2}% Description +    & \glossentrysymbol{##2}% Symbol +    & \glsentryuseri{##2}% Units +    & \glsentryuserii{##2}% Dimensions +    & ##3% Page list +    \tabularnewline % end of row +  }% + % Nothing between groups: + \renewcommand*{\glsgroupskip}{}% +} +</pre> +<!--l. 13183--><p class="nopar" > </p> <div class="center" > -<!--l. 13333--><p class="noindent" > -</p><!--l. 13333--><p class="noindent" >____________________________</p></div> +<!--l. 13184--><p class="noindent" > +</p><!--l. 13184--><p class="noindent" >____________________________</p></div> -<!--l. 13335--><p class="indent" > </div> -</p><!--l. 13335--><p class="noindent" ><a -href="#top">Top</a><div class="chapter"><h2 class="chapterHead">16. <a +<!--l. 13186--><p class="indent" > </div> +</p><!--l. 13186--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">14. <a + id="sec:xindy"></a>Xindy (Option 3)</h2> +</p><!--l. 13189--><p class="indent" > If you want to use <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-166001"></a></a> to sort the glossary, you must use the package option <span +class="cmss-10">xindy</span><a + id="dx1-166002"></a>: + + +</p> + <pre class="verbatim" id="verbatim-359"> +\usepackage[xindy]{glossaries} +</pre> +<!--l. 13193--><p class="nopar" > This ensures that the glossary information is written in <span +class="cmtt-10">xindy</span><a + id="dx1-166003"></a> syntax. +</p><!--l. 13197--><p class="indent" > <a +href="#sec:makeglossaries">§<span +class="cmbx-10">??</span>sec:makeglossaries </a><a +href="#sec:makeglossaries">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a> covers how to use the external <a +href="#glo:indexingapp">indexing +application</a>, and <a +href="#sec:locationsyntax">§<span +class="cmbx-10">??</span>sec:locationsyntax </a><a +href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a> covers the issues involved in the location syntax. This section +covers the commands provided by the <span +class="cmss-10">glossaries </span>package that allow you to adjust the <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-166004"></a></a> style file (<span +class="cmtt-10">xdy</span><a + id="dx1-166005"></a>) and +parameters. +</p><!--l. 13204--><p class="indent" > To assist writing information to the <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-166006"></a></a> style file, the <span +class="cmss-10">glossaries </span>package provides the following +commands: +</p><!--l. 13207--><p class="indent" > <hr><div title="Definition"><a + id="dx1-166007"></a> <span +class="cmtt-10">\glsopenbrace </span></div><hr> +</p><!--l. 13209--><p class="noindent" > +</p><!--l. 13210--><p class="indent" > <hr><div title="Definition"><a + id="dx1-166008"></a> <span +class="cmtt-10">\glsclosebrace </span></div><hr> +</p><!--l. 13212--><p class="noindent" > +which produce an open and closing brace. (This is needed because <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\{</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\}</span></span></span> don’t expand to a simple brace +character when written to a file.) Similarly, you can write a percent character using: +</p><!--l. 13217--><p class="indent" > <hr><div title="Definition"><a + id="dx1-166009"></a> <span +class="cmtt-10">\glspercentchar </span></div><hr> +</p><!--l. 13219--><p class="noindent" > +and a tilde character using: +</p><!--l. 13221--><p class="indent" > <hr><div title="Definition"><a + id="dx1-166010"></a> <span +class="cmtt-10">\glstildechar </span></div><hr> +</p><!--l. 13223--><p class="noindent" > +For example, a newline character is specified in a <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-166011"></a></a> style file using <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">~n</span></span></span> so you can use <span +class="cmtt-10">\glstildechar n </span>to +write this correctly (or you can do <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\string~n</span></span></span>). A backslash can be written to a file using +</p><!--l. 13228--><p class="indent" > <hr><div title="Definition"><a + id="dx1-166012"></a> <span +class="cmtt-10">\glsbackslash </span></div><hr> +</p><!--l. 13230--><p class="noindent" > +</p><!--l. 13232--><p class="indent" > In addition, if you are using a package that makes the double quote character active (e.g. <span +class="cmss-10">ngerman</span><a + id="dx1-166013"></a>) you can +use: +</p><!--l. 13234--><p class="indent" > <hr><div title="Definition"><a + id="dx1-166014"></a> <span +class="cmtt-10">\glsquote{</span>⟨<span +class="cmitt-10">text</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13236--><p class="noindent" > +which will produce <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">"</span></span></span>⟨<span +class="cmti-10">text</span>⟩<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">"</span></span></span>. Alternatively, you can use <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\string"</span></span></span> to write the double-quote character. This +document assumes that the double quote character has not been made active, so the examples just use <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">"</span></span></span> for +clarity. +</p><!--l. 13242--><p class="indent" > If you want greater control over the <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-166015"></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 + id="dx1-166016"></a> style file. In which case, you must use +<span +class="cmtt-10">\noist</span><a + id="dx1-166017"></a> to prevent the style file from being overwritten by the <span +class="cmss-10">glossaries </span>package. For additional +information about <span +class="cmtt-10">xindy</span><a + id="dx1-166018"></a>, read the <span +class="cmtt-10">xindy</span><a + id="dx1-166019"></a> documentation. I’m sorry I can’t provide any assistance +with writing <span +class="cmtt-10">xindy</span><a + id="dx1-166020"></a> style files. If you need help, I recommend you ask on the <span +class="cmtt-10">xindy</span><a + id="dx1-166021"></a> mailing list +(<a +href="http://xindy.sourceforge.net/mailing-list.html" class="url" ><span +class="cmtt-10">http://xindy.sourceforge.net/mailing-list.html</span></a>). +</p> + + +<!--l. 13253--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">14.1 </span> <a + id="sec:langenc"></a>Language and Encodings</h3> +<!--l. 13256--><p class="noindent" >When you use <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-167001"></a></a>, you need to specify the language and encoding used (unless you have written your own +custom <span +class="cmtt-10">xindy</span><a + id="dx1-167002"></a> style file that defines the relevant alphabet and sort rules). If you use <a +href="#glo:makeglossaries"><span +class="cmtt-10">makeglossaries</span><a + id="dx1-167003"></a></a>, +this information is obtained from the document’s auxiliary (<span +class="cmtt-10">aux</span><a + id="dx1-167004"></a>) file. The <a +href="#glo:makeglossaries"><span +class="cmtt-10">makeglossaries</span><a + id="dx1-167005"></a></a> script +attempts to find the root language given your document settings, but in the event that it gets +it wrong or if <span +class="cmtt-10">xindy</span><a + id="dx1-167006"></a> doesn’t support that language, then you can specify the required language +using: +</p><!--l. 13265--><p class="indent" > <hr><div title="Definition"><a + id="dx1-167007"></a> <span +class="cmtt-10">\GlsSetXdyLanguage[</span>⟨<span +class="cmitt-10">glossary type</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">language</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13267--><p class="noindent" > +where ⟨<span +class="cmti-10">language</span>⟩ is the name of the language. The optional argument can be used if you have multiple glossaries +in different languages. If ⟨<span +class="cmti-10">glossary type</span>⟩ is omitted, it will be applied to all glossaries, otherwise the language +setting will only be applied to the glossary given by ⟨<span +class="cmti-10">glossary type</span>⟩. +</p><!--l. 13275--><p class="indent" > If the <span +class="cmss-10">inputenc</span><a + id="dx1-167008"></a> package is used, the encoding will be obtained from the value of <span +class="cmtt-10">\inputencodingname</span><a + id="dx1-167009"></a>. +Alternatively, you can specify the encoding using: +</p><!--l. 13278--><p class="indent" > <hr><div title="Definition"><a + id="dx1-167010"></a> <span +class="cmtt-10">\GlsSetXdyCodePage{</span>⟨<span +class="cmitt-10">code</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13280--><p class="noindent" > +where ⟨<span +class="cmti-10">code</span>⟩ is the name of the encoding. For example: + + +</p> + <pre class="verbatim" id="verbatim-360"> +\GlsSetXdyCodePage{utf8} +</pre> +<!--l. 13284--><p class="nopar" > +</p><!--l. 13286--><p class="indent" > Note that you can also specify the language and encoding using the package option +<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">xindy={language=</span></span></span>⟨<span +class="cmti-10">lang</span>⟩<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">,codepage=</span></span></span>⟨<span +class="cmti-10">code</span>⟩<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">}</span></span></span>. For example: + + +</p> + <pre class="verbatim" id="verbatim-361"> +\usepackage[xindy={language=english,codepage=utf8}]{glossaries} +</pre> +<!--l. 13292--><p class="nopar" > +</p><!--l. 13294--><p class="indent" > If you write your own custom <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-167011"></a></a> style file that includes the language settings, you need to set the +language to nothing: + + +</p> + <pre class="verbatim" id="verbatim-362"> +\GlsSetXdyLanguage{} +</pre> +<!--l. 13299--><p class="nopar" > (and remember to use <span +class="cmtt-10">\noist</span><a + id="dx1-167012"></a> to prevent the style file from being overwritten). +</p><!--l. 13303--><p class="indent" > <div class="important" title="Important Note"> The commands <span +class="cmtt-10">\GlsSetXdyLanguage </span>and <span +class="cmtt-10">\GlsSetXdyCodePage </span>have no effect if you don’t use +<a +href="#glo:makeglossaries"><span +class="cmtt-10">makeglossaries</span><a + id="dx1-167013"></a></a>. If you call <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-167014"></a></a> without <span +class="cmtt-10">makeglossaries</span><a + id="dx1-167015"></a> you need to remember to set the language and +encoding using the <span +class="cmtt-10">-L</span><a + id="dx1-167016"></a> and <span +class="cmtt-10">-C</span><a + id="dx1-167017"></a> switches. </div> +</p><!--l. 13309--><p class="noindent" > +</p><!--l. 13311--><p class="noindent" > +</p> +<!--l. 13311--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">14.2 </span> <a + id="sec:xindyloc"></a>Locations and Number lists</h3> +<!--l. 13314--><p class="noindent" >If you use <span +class="cmss-10">xindy</span><a + id="dx1-168001"></a>, the <span +class="cmss-10">glossaries </span>package needs to know which counters you will be using in the <a +href="#glo:numberlist">number list<a + id="dx1-168002"></a></a> in +order to correctly format the <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-168003"></a></a> style file. Counters specified using the <span +class="cmss-10">counter</span><a + id="dx1-168004"></a> package option or the ⟨<span +class="cmti-10">counter</span>⟩ +option of <span +class="cmtt-10">\newglossary</span><a + id="dx1-168005"></a> are automatically taken care of, but if you plan to use a different counter in the +<span +class="cmtt-10">counter</span><a + id="dx1-168006"></a> key for commands like <span +class="cmtt-10">\glslink</span><a + id="dx1-168007"></a>, then you need to identify these counters <span +class="cmti-10">before </span><span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168008"></a> +using: +</p><!--l. 13322--><p class="indent" > <hr><div title="Definition"><a + id="dx1-168009"></a> <span +class="cmtt-10">\GlsAddXdyCounters{</span>⟨<span +class="cmitt-10">counter list</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13324--><p class="noindent" > +where ⟨<span +class="cmti-10">counter list</span>⟩ is a comma-separated list of counter names. +</p><!--l. 13327--><p class="indent" > The most likely <a + id="dx1-168010"></a>attributes used in the <span +class="cmtt-10">format</span><a + id="dx1-168011"></a> key (<span +class="cmtt-10">textrm</span><a + id="dx1-168012"></a>, <span +class="cmtt-10">hyperrm</span><a + id="dx1-168013"></a> etc) are automatically added to the +<a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-168014"></a></a> style file, but if you want to use another attribute, you need to add it using: +</p><!--l. 13331--><p class="indent" > <hr><div title="Definition"><a + id="dx1-168015"></a> <span +class="cmtt-10">\GlsAddXdyAttribute{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13333--><p class="noindent" > +where ⟨<span +class="cmti-10">name</span>⟩ is the name of the attribute, as used in the <span +class="cmtt-10">format</span><a + id="dx1-168016"></a> key. +</p><!--l. 13337--><p class="indent" > Take care if you have multiple instances of the same location with different formats. The duplicate locations +will be discarded according to the order in which the <a + id="dx1-168017"></a>attributes are listed. Consider defining semantic commands +to use for primary references. For example: + + +</p> + <pre class="verbatim" id="verbatim-363"> +\newcommand*{\primary}[1]{\textbf{#1}} +\GlsAddXdyAttribute{primary} +</pre> +<!--l. 13345--><p class="nopar" > Then in the document: + + +</p> + <pre class="verbatim" id="verbatim-364"> +A \gls[format=primary]{duck} is an aquatic bird. +There are lots of different types of \gls{duck}. +</pre> +<!--l. 13350--><p class="nopar" > This will give the <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">format=primary</span></span></span> instance preference over the next use that doesn’t use the <span +class="cmtt-10">format</span><a + id="dx1-168018"></a> +key. +<a + id="ex:hyperbfit"></a> +</p><!--l. 13354--><p class="noindent" ><span +class="cmbx-12">Example 26</span><span +class="cmbx-12"> (Custom Font for Displaying a Location)</span><a + id="x1-168020"></a> +</p><!--l. 13355--><p class="indent" > Suppose I want a bold, italic, hyperlinked location. I first need to define a command that will do +this: + + +</p> + <pre class="verbatim" id="verbatim-365"> +\newcommand*{\hyperbfit}[1]{\textit{\hyperbf{#1}}} +</pre> +<!--l. 13359--><p class="nopar" > but with <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-168021"></a></a>, I also need to add this as an allowed <a + id="dx1-168022"></a>attribute: + + +</p> + <pre class="verbatim" id="verbatim-366"> +\GlsAddXdyAttribute{hyperbfit} +</pre> +<!--l. 13364--><p class="nopar" > Now I can use it in the optional argument of commands like <span +class="cmtt-10">\gls</span><a + id="dx1-168023"></a>: + + +</p> + <pre class="verbatim" id="verbatim-367"> +Here is a \gls[format=hyperbfit]{sample} entry. +</pre> +<!--l. 13369--><p class="nopar" > (where <span +class="cmtt-10">sample </span>is the label of the required entry). </p> +<div class="center" +> +<!--l. 13371--><p class="noindent" > +</p><!--l. 13371--><p class="noindent" >____________________________</p></div> +<!--l. 13373--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\GlsAddXdyAttribute </span>has no effect if <span +class="cmtt-10">\noist</span><a + id="dx1-168024"></a> is used or if <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168025"></a> is omitted. +<span +class="cmtt-10">\GlsAddXdyAttribute </span>must be used before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168026"></a>. Additionally, <span +class="cmtt-10">\GlsAddXdyCounters </span>must come +before <span +class="cmtt-10">\GlsAddXdyAttribute</span>. </div> +</p><!--l. 13379--><p class="noindent" > +</p><!--l. 13381--><p class="indent" > If the location numbers include formatting commands, then you need to add a location style in the +appropriate format using +</p><!--l. 13383--><p class="indent" > <hr><div title="Definition"><a + id="dx1-168027"></a> <span +class="cmtt-10">\GlsAddXdyLocation[</span>⟨<span +class="cmitt-10">prefix-location</span>⟩<span +class="cmtt-10">]{</span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">definition</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13385--><p class="noindent" > +where ⟨<span +class="cmti-10">name</span>⟩ is the name of the format and ⟨<span +class="cmti-10">definition</span>⟩ is the <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-168028"></a></a> definition. The optional argument +⟨<span +class="cmti-10">prefix-location</span>⟩ is needed if <span +class="cmtt-10">\theH</span>⟨<span +class="cmti-10">counter</span>⟩ either isn’t defined or is different from <span +class="cmtt-10">\the</span>⟨<span +class="cmti-10">counter</span>⟩. Be sure to also +read <a +href="#sec:locationsyntax">§<span +class="cmbx-10">??</span>sec:locationsyntax </a><a +href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a> for some issues that you may encounter. +</p><!--l. 13393--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\GlsAddXdyLocation </span>has no effect if <span +class="cmtt-10">\noist</span><a + id="dx1-168029"></a> is used or if <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168030"></a> is omitted. +<span +class="cmtt-10">\GlsAddXdyLocation </span>must be used before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168031"></a>. </div> +</p><!--l. 13397--><p class="noindent" > +<a + id="ex:customloc"></a> +</p><!--l. 13399--><p class="noindent" ><span +class="cmbx-12">Example 27</span><span +class="cmbx-12"> (Custom Numbering System for Locations)</span><a + id="x1-168033"></a> +</p><!--l. 13400--><p class="indent" > Suppose I decide to use a somewhat eccentric numbering system for sections where I redefine <span +class="cmtt-10">\thesection</span> +as follows: + + +</p> + <pre class="verbatim" id="verbatim-368"> +\renewcommand*{\thesection}{[\thechapter]\arabic{section}} +</pre> +<!--l. 13404--><p class="nopar" > If I haven’t done <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">counter=section</span></span></span> in the package option, I need to specify that the counter will be used as a +location number: + + +</p> + <pre class="verbatim" id="verbatim-369"> +\GlsAddXdyCounters{section} +</pre> +<!--l. 13410--><p class="nopar" > Next I need to add the location style (<span +class="cmtt-10">\thechapter </span>is assumed to be the standard <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\arabic{chapter}</span></span></span>): + + +</p> + <pre class="verbatim" id="verbatim-370"> +\GlsAddXdyLocation{section}{:sep "[" "arabic-numbers" :sep "]" +  "arabic-numbers" +} +</pre> +<!--l. 13417--><p class="nopar" > Note that if I have further decided to use the <span +class="cmss-10">hyperref</span><a + id="dx1-168034"></a> package and want to redefine <span +class="cmtt-10">\theHsection</span> +as: + + +</p> + <pre class="verbatim" id="verbatim-371"> +\renewcommand*{\theHsection}{\thepart.\thesection} +\renewcommand*{\thepart}{\Roman{part}} +</pre> +<!--l. 13423--><p class="nopar" > then I need to modify the <span +class="cmtt-10">\GlsAddXdyLocation </span>code above to: + + +</p> + <pre class="verbatim" id="verbatim-372"> +\GlsAddXdyLocation["roman-numbers-uppercase"]{section}{:sep "[" +  "arabic-numbers" :sep "]" "arabic-numbers" +} +</pre> +<!--l. 13429--><p class="nopar" > Since <span +class="cmtt-10">\Roman</span><a + id="dx1-168035"></a> will result in an empty string if the counter is zero, it’s a good idea to add an extra location to +catch this: + + +</p> + <pre class="verbatim" id="verbatim-373"> +\GlsAddXdyLocation{zero.section}{:sep "[" +  "arabic-numbers" :sep "]" "arabic-numbers" +} +</pre> +<!--l. 13436--><p class="nopar" > This example is illustrated in the sample file <a +href="#ex:samplexdy2"><span +class="cmtt-10">samplexdy2.tex</span></a>. </p> +<div class="center" +> +<!--l. 13439--><p class="noindent" > +</p><!--l. 13439--><p class="noindent" >____________________________</p></div> +<a + id="ex:dice"></a> +<!--l. 13441--><p class="noindent" ><span +class="cmbx-12">Example 28</span><span +class="cmbx-12"> (Locations as Dice)</span><a + id="x1-168037"></a> +</p><!--l. 13442--><p class="indent" > Suppose I want a rather eccentric page numbering system that’s represented by the number of dots on dice. +The <span +class="cmss-10">stix</span><a + id="dx1-168038"></a> package provides <span +class="cmtt-10">\dicei</span>, …, <span +class="cmtt-10">\dicevi </span>that represent the six sides of a die. I can define a command +that takes a number as its argument. If the number is less than seven, the appropriate <span +class="cmtt-10">\dice</span>⟨<span +class="cmti-10">n</span>⟩ +command is used otherwise it does <span +class="cmtt-10">\dicevi </span>the required number of times with the leftover in a final +<span +class="cmtt-10">\dice</span>⟨<span +class="cmti-10">n</span>⟩. For example, the number 16 is represented by <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\dicevi\dicevi\diceiv</span></span></span> (6 + 6 + 4 = 16). +I’ve called this command <span +class="cmtt-10">\tallynum </span>to match the example given earlier in <a +href="#sec:locationsyntax">§<span +class="cmbx-10">??</span>sec:locationsyntax +</a><a +href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a>: + + +</p> + <pre class="verbatim" id="verbatim-374"> +\newrobustcmd{\tallynum}[1]{% + \ifnum\number#1<7 +  $\csname dice\romannumeral#1\endcsname$% + \else +  $\dicevi$% +  \expandafter\tallynum\expandafter{\numexpr#1-6}% + \fi +} +</pre> +<!--l. 13462--><p class="nopar" > Here’s the counter command: + + +</p> + <pre class="verbatim" id="verbatim-375"> +newcommand{\tally}[1]{\tallynum{\arabic{#1}}} +</pre> +<!--l. 13466--><p class="nopar" > The <span +class="cmss-10">page</span><a + id="dx1-168039"></a> counter representation (<span +class="cmtt-10">\thepage</span>) needs to be changed to use this command: + + +</p> + <pre class="verbatim" id="verbatim-376"> +\renewcommand*{\thepage}{\tally{page}} +</pre> +<!--l. 13471--><p class="nopar" > The <span +class="cmtt-10">\tally </span>command expands to <span +class="cmtt-10">\tallynum {</span>⟨<span +class="cmti-10">number</span>⟩<span +class="cmtt-10">} </span>so this needs a location class that matches this +format: + + +</p> + <pre class="verbatim" id="verbatim-377"> +\GlsAddXdyLocation{tally}{% + :sep "\string\tallynum\space\glsopenbrace" + "arabic-numbers" + :sep "\glsclosebrace" +} +</pre> +<!--l. 13480--><p class="nopar" > The space between <span +class="cmtt-10">\tallynum </span>and <span +class="cmtt-10">{</span>⟨<span +class="cmti-10">number</span>⟩<span +class="cmtt-10">} </span>is significant to <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-168040"></a></a> so <span +class="cmtt-10">\space </span>is required. +</p><!--l. 13484--><p class="indent" > Note that <span +class="cmtt-10">\GlsAddXdyLocation{</span>⟨<span +class="cmti-10">name</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmti-10">definition</span>⟩<span +class="cmtt-10">} </span>will define commands in the form: +</p><!--l. 13487--><p class="indent" > <hr><div title="Definition"><span +class="cmtt-10">\glsX</span>⟨<span +class="cmitt-10">counter</span>⟩<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">X</span></span></span>⟨<span +class="cmitt-10">name</span>⟩<span +class="cmtt-10">{</span>⟨<span +class="cmitt-10">Hprefix</span>⟩<span +class="cmtt-10">}{</span>⟨<span +class="cmitt-10">location</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13488--><p class="noindent" > +for each counter that has been identified either by the <span +class="cmss-10">counter</span><a + id="dx1-168041"></a> package option, the ⟨<span +class="cmti-10">counter</span>⟩ option for +<span +class="cmtt-10">\newglossary</span><a + id="dx1-168042"></a> or in the argument of <span +class="cmtt-10">\GlsAddXdyCounters</span><a + id="dx1-168043"></a>. The first argument ⟨<span +class="cmti-10">Hprefix</span>⟩ is only relevant when +used with the <span +class="cmss-10">hyperref</span><a + id="dx1-168044"></a> package and indicates that <span +class="cmtt-10">\theH</span>⟨<span +class="cmti-10">counter</span>⟩ is given by <span +class="cmtt-10">\Hprefix</span><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">.</span></span></span><span +class="cmtt-10">\the</span>⟨<span +class="cmti-10">counter</span>⟩. +</p><!--l. 13496--><p class="indent" > The sample file <a +href="#ex:samplexdy"><span +class="cmtt-10">samplexdy.tex</span></a>, which comes with the <span +class="cmss-10">glossaries </span>package, uses the default <span +class="cmss-10">page</span><a + id="dx1-168045"></a> counter for +locations, and it uses the default <span +class="cmtt-10">\glsnumberformat</span><a + id="dx1-168046"></a> and a custom <span +class="cmtt-10">\hyperbfit </span>format. A new <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-168047"></a></a> location +called <span +class="cmtt-10">tallynum</span>, as illustrated above, is defined to make the page numbers appear as dice. In order for the +location numbers to hyperlink to the relevant pages, I need to redefine the necessary <span +class="cmtt-10">\glsX</span>⟨<span +class="cmti-10">counter</span>⟩<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">X</span></span></span>⟨<span +class="cmti-10">format</span>⟩ +commands: + + +</p> + <pre class="verbatim" id="verbatim-378"> +\renewcommand{\glsXpageXglsnumberformat}[2]{% + \linkpagenumber#2% +} +\renewcommand{\glsXpageXhyperbfit}[2]{% + \textbf{\em\linkpagenumber#2}% +} +\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} +</pre> +<!--l. 13514--><p class="nopar" > Note that the second argument of <span +class="cmtt-10">\glsXpageXglsnumberformat </span>is in the format <span +class="cmtt-10">\tallynum{</span>⟨<span +class="cmti-10">n</span>⟩<span +class="cmtt-10">} </span>so the +line + + +</p> + <pre class="verbatim" id="verbatim-379"> + \linkpagenumber#2% +</pre> +<!--l. 13519--><p class="nopar" > does </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10"> \linkpagenumber\tallynum{</span>⟨<span +class="cmitt-10">number</span>⟩<span +class="cmtt-10">}</span> +</div> +</div> so <span +class="cmtt-10">\tallynum </span>is the first argument of <span +class="cmtt-10">\linkpagenumber </span>and ⟨<span +class="cmti-10">number</span>⟩ is the second argument. +<div class="center" +> +<!--l. 13526--><p class="noindent" > +</p><!--l. 13526--><p class="noindent" >____________________________</p></div> +<!--l. 13528--><p class="indent" > <div class="important" title="Important Note"> This method is very sensitive to the internal definition of the location command. </div> +</p><!--l. 13531--><p class="noindent" > +<a + id="ex:fmtcount"></a> +</p><!--l. 13533--><p class="noindent" ><span +class="cmbx-12">Example 29</span><span +class="cmbx-12"> (Locations as Words not Digits)</span><a + id="x1-168049"></a> +</p><!--l. 13534--><p class="indent" > Suppose I want the page numbers written as words rather than digits and I use the <span +class="cmss-10">fmtcount</span><a + id="dx1-168050"></a> package to do +this. I can redefine <span +class="cmtt-10">\thepage</span><a + id="dx1-168051"></a> as follows: + + +</p> + <pre class="verbatim" id="verbatim-380"> +\renewcommand*{\thepage}{\Numberstring{page}} +</pre> +<!--l. 13539--><p class="nopar" > This <span +class="cmti-10">used </span>to get expanded to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\protect</span><span +class="cmtt-10"> \Numberstringnum</span><span +class="cmtt-10"> </span></span></span><span +class="cmtt-10">{</span>⟨<span +class="cmti-10">n</span>⟩<span +class="cmtt-10">} </span>where ⟨<span +class="cmti-10">n</span>⟩ is the Arabic page number. This +means that I needed to define a new location with the form: + + +</p> + <pre class="verbatim" id="verbatim-381"> +\GlsAddXdyLocation{Numberstring}{:sep "\string\protect\space +  \string\Numberstringnum\space\glsopenbrace" +  "arabic-numbers" :sep "\glsclosebrace"} +</pre> +<!--l. 13547--><p class="nopar" > and if I’d used the <span +class="cmtt-10">\linkpagenumber </span>command from the previous example, it would need <span +class="cmti-10">three </span>arguments (the +first being <span +class="cmtt-10">\protect</span>): + + +</p> + <pre class="verbatim" id="verbatim-382"> +\newcommand{\linkpagenumber}[3]{\hyperlink{page.#3}{#1#2{#3}}} +</pre> +<!--l. 13553--><p class="nopar" > +</p><!--l. 13555--><p class="indent" > The internal definition of <span +class="cmtt-10">\Numberstring </span>has since changed so that it now expands to <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\Numberstringnum</span><span +class="cmtt-10"> </span></span></span> +<span +class="cmtt-10">{</span>⟨<span +class="cmti-10">n</span>⟩<span +class="cmtt-10">} </span>(no <span +class="cmtt-10">\protect</span>). This means that the location class definition must be changed to: + + +</p> + <pre class="verbatim" id="verbatim-383"> +\GlsAddXdyLocation{Numberstring}{% no \protect now! +  :sep "\string\Numberstringnum\space\glsopenbrace" +  "arabic-numbers" :sep "\glsclosebrace"} +</pre> +<!--l. 13563--><p class="nopar" > and <span +class="cmtt-10">\linkpagenumber </span>goes back to only two arguments: + + +</p> + <pre class="verbatim" id="verbatim-384"> +\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} +</pre> +<!--l. 13567--><p class="nopar" > The other change is that <span +class="cmtt-10">\Numberstring </span>uses </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">\the\value{</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">}</span> +</div> +</div> instead of <div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">\expandafter\the\csname</span><span +class="cmtt-10"> c@</span>⟨<span +class="cmitt-10">counter</span>⟩<span +class="cmtt-10">\endcsname</span> +</div> +</div> so it hides <span +class="cmtt-10">\c@page </span>from the location escaping mechanism (see <a +href="#sec:locationsyntax">§<span +class="cmbx-10">??</span>sec:locationsyntax </a><a +href="#sec:locationsyntax">Locations<!--tex4ht:ref: sec:locationsyntax --></a>). This means +that the page number may be incorrect if the indexing occurs during the output routine. +<!--l. 13581--><p class="indent" > A more recent change to <span +class="cmss-10">fmtcount</span><a + id="dx1-168052"></a> (v3.03) now puts three instances of <span +class="cmtt-10">\expandafter </span>before +<span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\the\value</span></span></span> which no longer hides <span +class="cmtt-10">\c@page </span>from the location escaping mechanism, so the page +numbers should once more be correct. Further changes to the <span +class="cmss-10">fmtcount</span><a + id="dx1-168053"></a> package may cause a problem +again. +</p><!--l. 13587--><p class="indent" > <div class="important" title="Important Note"> When dealing with custom formats where the internal definitions are outside of your control and liable to +change, it’s best to provide a wrapper command. </div> +</p><!--l. 13591--><p class="noindent" > +</p><!--l. 13593--><p class="indent" > Instead of directly using <span +class="cmtt-10">\Numberstring </span>in the definition of <span +class="cmtt-10">\thepage</span>, I can provide a custom command in +the same form as the earlier <span +class="cmtt-10">\tally </span>command: + + +</p> + <pre class="verbatim" id="verbatim-385"> +\newcommand{\customfmt}[1]{\customfmtnum{\arabic{#1}}} +\newrobustcmd{\customfmtnum}[1]{\Numberstringnum{#1}} +</pre> +<!--l. 13599--><p class="nopar" > This ensures that the location will always be written to the indexing file in the form: </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">:locref</span><span +class="cmtt-10"> "{}{\\customfmtnum</span><span +class="cmtt-10"> {</span>⟨<span +class="cmitt-10">n</span>⟩<span +class="cmtt-10">}}"</span> +</div> +</div> So the location class can be defined as: + + + <pre class="verbatim" id="verbatim-386"> +\GlsAddXdyLocation{customfmt}{ + :sep "\string\customfmtnum\space\glsopenbrace" + "arabic-numbers" + :sep "\glsclosebrace"} +</pre> +<!--l. 13611--><p class="nopar" > +</p><!--l. 13613--><p class="indent" > The sample file <a +href="#ex:samplexdy3"><span +class="cmtt-10">samplexdy3.tex</span></a> illustrates this. </p> +<div class="center" +> +<!--l. 13615--><p class="noindent" > +</p><!--l. 13615--><p class="noindent" >____________________________</p></div> +<!--l. 13617--><p class="indent" > In the <a +href="#glo:numberlist">number list<a + id="dx1-168054"></a></a>, the locations are sorted according to the list of provided location classes. +The default ordering is: <span +class="cmtt-10">roman-page-numbers </span>(i, ii, …), <span +class="cmtt-10">arabic-page-numbers </span>(1, 2, …), +<span +class="cmtt-10">arabic-section-numbers </span>(for example, 1.1 if the compositor is a full stop or 1-1 if the compositor is a +hyphen<span class="footnote-mark"><a +href="#fn1x14" id="fn1x14-bk"><sup class="textsuperscript">14.1</sup></a></span><a + id="x1-168055f1"></a>), +<span +class="cmtt-10">alpha-page-numbers </span>(a, b, …), <span +class="cmtt-10">Roman-page-numbers </span>(I, II, …), <span +class="cmtt-10">Alpha-page-numbers </span>(A, B, …), +<span +class="cmtt-10">Appendix-page-numbers </span>(for example, A.1 if the Alpha compositor is a full stop or A-1 if the Alpha compositor is a +hyphen<span class="footnote-mark"><a +href="#fn2x14" id="fn2x14-bk"><sup class="textsuperscript">14.2</sup></a></span><a + id="x1-168057f2"></a>), user defined +location names (as specified by <span +class="cmtt-10">\GlsAddXdyLocation</span><a + id="dx1-168059"></a> in the order in which they were defined), and finally <span +class="cmtt-10">see </span>(cross-referenced +entries).<span class="footnote-mark"><a +href="#fn3x14" id="fn3x14-bk"><sup class="textsuperscript">14.3</sup></a></span><a + id="x1-168060f3"></a> +This ordering can be changed using: +</p><!--l. 13634--><p class="indent" > <hr><div title="Definition"><a + id="dx1-168061"></a> <span +class="cmtt-10">\GlsSetXdyLocationClassOrder{</span>⟨<span +class="cmitt-10">location names</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13636--><p class="noindent" > +where each location name is delimited by double quote marks and separated by white space. For +example: + + +</p> + <pre class="verbatim" id="verbatim-387"> +\GlsSetXdyLocationClassOrder{ +  "arabic-page-numbers" +  "arabic-section-numbers" +  "roman-page-numbers" +  "Roman-page-numbers" +  "alpha-page-numbers" +  "Alpha-page-numbers" +  "Appendix-page-numbers" +  "see" +} +</pre> +<!--l. 13650--><p class="nopar" > (Remember to add <span class="obeylines-h"><span class="verb"><span +class="cmtt-10">"seealso"</span></span></span> if you’re using <a +href="#glo:glossaries-extra"><span +class="cmss-10">glossaries-extra</span></a>.) +</p><!--l. 13654--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\GlsSetXdyLocationClassOrder </span>has no effect if <span +class="cmtt-10">\noist</span><a + id="dx1-168062"></a> is used or if <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168063"></a> is +omitted. <span +class="cmtt-10">\GlsSetXdyLocationClassOrder </span>must be used before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168064"></a>. </div> +</p><!--l. 13659--><p class="noindent" > +</p><!--l. 13661--><p class="indent" > If a <a +href="#glo:numberlist">number list<a + id="dx1-168065"></a></a> consists of a sequence of consecutive numbers, the range will be concatenated. The +number of consecutive locations that causes a range formation defaults to 2, but can be changed +using: +</p><!--l. 13666--><p class="indent" > <hr><div title="Definition"><a + id="dx1-168066"></a> <span +class="cmtt-10">\GlsSetXdyMinRangeLength{</span>⟨<span +class="cmitt-10">n</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13668--><p class="noindent" > +For example: + + +</p> + <pre class="verbatim" id="verbatim-388"> +\GlsSetXdyMinRangeLength{3} +</pre> +<!--l. 13672--><p class="nopar" > The argument may also be the keyword <span +class="cmtt-10">none</span>, to indicate that there should be no range formations. See the +<a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-168067"></a></a> manual for further details on range formations. +</p><!--l. 13677--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="cmtt-10">\GlsSetXdyMinRangeLength </span>has no effect if <span +class="cmtt-10">\noist</span><a + id="dx1-168068"></a> is used or if <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168069"></a> is omitted. +<span +class="cmtt-10">\GlsSetXdyMinRangeLength </span>must be used before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-168070"></a>. </div> +</p><!--l. 13682--><p class="noindent" > +See also <a +href="#sec:ranges">§<span +class="cmbx-10">??</span>sec:ranges </a><a +href="#sec:ranges">Range Formations<!--tex4ht:ref: sec:ranges --></a>. +</p><!--l. 13685--><p class="noindent" > +</p> +<!--l. 13685--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">14.3 </span> <a + id="sec:groups"></a>Glossary Groups</h3> +<!--l. 13688--><p class="noindent" >The glossary is divided into groups according to the first letter of the sort key. The <span +class="cmss-10">glossaries </span>package also adds a +number group by default, unless you suppress it in the <span +class="cmss-10">xindy</span><a + id="dx1-169001"></a> package option. For example: + + +</p> + <pre class="verbatim" id="verbatim-389"> +\usepackage[xindy={glsnumbers=false}]{glossaries} +</pre> +<!--l. 13694--><p class="nopar" > Any entry that doesn’t go in one of the letter groups or the number group is placed in the default group. If you +want <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-169002"></a></a> to sort the number group numerically (rather than by a string sort) then you need to use <a +href="#glo:xindy"><span +class="cmtt-10">xindy</span><a + id="dx1-169003"></a>’s</a> +<span +class="cmtt-10">numeric-sort </span>module: + + +</p> + <pre class="verbatim" id="verbatim-390"> +\GlsAddXdyStyle{numeric-sort} +</pre> +<!--l. 13701--><p class="nopar" > +</p><!--l. 13703--><p class="indent" > If you don’t use <span +class="cmtt-10">glsnumbers=false</span>, the default behaviour is to locate the number group before the “A” +letter group. If you are not using a Roman alphabet, you need to change this using: +</p><!--l. 13708--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169004"></a> <span +class="cmtt-10">\GlsSetXdyFirstLetterAfterDigits{</span>⟨<span +class="cmitt-10">letter</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13710--><p class="noindent" > +where ⟨<span +class="cmti-10">letter</span>⟩ is the first letter of your alphabet. Take care if you’re using <span +class="cmss-10">inputenc</span><a + id="dx1-169005"></a> as non-ASCII characters are +actually active characters that expand. (This isn’t a problem with the native <a +href="#glo:UTF-8">UTF-8</a> engines and +<span +class="cmss-10">fontspec</span><a + id="dx1-169006"></a>.) The starred form will sanitize the argument to prevent expansion. Alternatively you can +use: +</p><!--l. 13719--><p class="indent" > <hr><div title="Definition"><a + id="dx1-169007"></a> <span +class="cmtt-10">\GlsSetXdyNumberGroupOrder{</span>⟨<span +class="cmitt-10">relative location</span>⟩<span +class="cmtt-10">} </span></div><hr> +</p><!--l. 13721--><p class="noindent" > +to change the default </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">:before</span><span +class="cmtt-10"> \string"</span>⟨<span +class="cmitt-10">letter</span>⟩<span +class="cmtt-10">\string"</span> +</div> +</div> to ⟨<span +class="cmti-10">relative location</span>⟩. For example: + + + <pre class="verbatim" id="verbatim-391"> +\GlsSetXdyNumberGroupOrder{:after \string"Z\string"} +</pre> +<!--l. 13729--><p class="nopar" > will put the number group after the “Z” letter group. Again take care of active characters. There’s a starred +version that sanitizes the argument (so don’t use <span +class="cmtt-10">\string </span>in it). </p><div class="alltt"> +<div class="obeylines-v"> +<span +class="cmtt-10">\GlsSetXdyNumberGroupOrder*</span><span +class="cmsy-10">{</span><span +class="cmtt-10">:after</span><span +class="cmtt-10"> "</span><span +class="cmtt-10">Ö</span><span +class="cmtt-10">"</span><span +class="cmsy-10">}</span> +</div> +</div> +<!--l. 13737--><p class="indent" > <div class="important" title="Important Note"> Note that these commands have no effect if <span +class="cmtt-10">\noist</span><a + id="dx1-169008"></a> is used or if <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-169009"></a> is omitted. +<span +class="cmtt-10">\GlsSetXdyFirstLetterAfterDigits </span>must be used before <span +class="cmtt-10">\makeglossaries</span><a + id="dx1-169010"></a>. + </div> +</p><!--l. 13742--><p class="noindent" > + + +</p> +<!--l. 13745--><p class="indent" > </div> +</p><!--l. 13745--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">15. <a id="sec:utilities"></a>Utilities</h2> -</p><!--l. 13338--><p class="indent" > This section describes some utility commands. Additional commands can be found in the documented code +</p><!--l. 13748--><p class="indent" > This section describes some utility commands. Additional commands can be found in the documented code (glossaries-code.pdf). -</p><!--l. 13341--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 13751--><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 provides extra utility commands. See the “Utilities” section of the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> manual. </div> -</p><!--l. 13344--><p class="noindent" > +</p><!--l. 13754--><p class="noindent" > </p> -<!--l. 13346--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">16.1 </span> <a +<!--l. 13756--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">15.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 LaTeX’s <span +<!--l. 13759--><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 “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 +</p><!--l. 13766--><p class="noindent" > +</p><!--l. 13768--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-171001"></a> <span class="cmtt-10">\forallglossaries[</span>⟨<span class="cmitt-10">glossary list</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -26532,7 +27992,7 @@ class="cmitt-10">cs</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">body</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13360--><p class="noindent" > +</p><!--l. 13770--><p class="noindent" > This iterates through ⟨<span class="cmti-10">glossary list</span>⟩, a comma-separated list of glossary labels (as supplied when the glossary was defined). At each iteration ⟨<span @@ -26541,26 +28001,32 @@ iteration and ⟨<span class="cmti-10">body</span>⟩ is performed. If ⟨<span class="cmti-10">glossary list</span>⟩ is omitted, the default is to iterate over all glossaries (except the ignored ones). -</p><!--l. 13368--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-168002"></a> <span +</p><!--l. 13778--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-171002"></a> <span class="cmtt-10">\forallacronyms{</span>⟨<span class="cmitt-10">cs</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">body</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13370--><p class="noindent" > +</p><!--l. 13780--><p class="noindent" > This is like <span class="cmtt-10">\forallglossaries </span>but only iterates over the lists of acronyms (that have previously been declared using <span class="cmtt-10">\DeclareAcronymList</span><a - id="dx1-168003"></a> or the <span + id="dx1-171003"></a> or the <span class="cmss-10">acronymlists</span><a - id="dx1-168004"></a> package option). This command doesn’t have an optional + id="dx1-171004"></a> package option). This command doesn’t have an optional argument. If you want to explicitly say which lists to iterate over, just use the optional argument of <span class="cmtt-10">\forallglossaries</span>. -</p><!--l. 13378--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-168005"></a> <span +</p><!--l. 13788--><p class="noindent" ><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 provides an analogous command <span id="textcolor307"><span +class="cmtt-10">\forallabbreviationlists</span></span><a + id="dx1-171005"></a>. </div> +</p><!--l. 13792--><p class="noindent" > +</p><!--l. 13794--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-171006"></a> <span class="cmtt-10">\forglsentries[</span>⟨<span class="cmitt-10">glossary label</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -26568,7 +28034,7 @@ class="cmitt-10">cs</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">body</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13380--><p class="noindent" > +</p><!--l. 13796--><p class="noindent" > This iterates through all entries in the glossary given by ⟨<span class="cmti-10">glossary label</span>⟩. At each iteration ⟨<span class="cmti-10">cs</span>⟩ (which must be a @@ -26577,9 +28043,9 @@ class="cmti-10">body</span>⟩ is performed. If ⟨<span class="cmti-10">glossary label</span>⟩ is omitted, <span class="cmtt-10">\glsdefaulttype</span><a - id="dx1-168006"></a> (usually the main glossary) is used. -</p><!--l. 13387--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-168007"></a> <span + id="dx1-171007"></a> (usually the main glossary) is used. +</p><!--l. 13803--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-171008"></a> <span class="cmtt-10">\forallglsentries[</span>⟨<span class="cmitt-10">glossary list</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -26587,7 +28053,7 @@ class="cmitt-10">cs</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">body</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13389--><p class="noindent" > +</p><!--l. 13805--><p class="noindent" > This is like <span class="cmtt-10">\forglsentries </span>but for each glossary in ⟨<span class="cmti-10">glossary list</span>⟩ (a comma-separated list of glossary labels). If @@ -26601,20 +28067,20 @@ class="cmtt-10">\glsentrytype{</span>⟨<span class="cmti-10">cs</span>⟩<span class="cmtt-10">} </span>within ⟨<span class="cmti-10">body</span>⟩.) -</p><!--l. 13398--><p class="noindent" > + + +</p><!--l. 13814--><p class="noindent" > </p> -<!--l. 13398--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">16.2 </span> <a +<!--l. 13814--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">15.2 </span> <a id="sec:conditionals"></a>Conditionals</h3> -<!--l. 13401--><p class="noindent" ><hr><div title="Definition"><a - id="dx1-169001"></a> <span +<!--l. 13817--><p class="noindent" ><hr><div title="Definition"><a + id="dx1-172001"></a> <span class="cmtt-10">\ifglossaryexists</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. 13404--><p class="noindent" > +</p><!--l. 13820--><p class="noindent" > 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 @@ -26626,24 +28092,24 @@ form of this command which will also consider ignored glossaries as existing. Fo <div class="obeylines-v"> <span class="cmtt-10">\newignoredglossary</span><a - id="dx1-169002"></a><span + id="dx1-172002"></a><span class="cmtt-10">{common}</span> </div> </div> then - <div class="verbatim" id="verbatim-385"> + <pre class="verbatim" id="verbatim-392"> \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 +\ifglossaryexists*{common}{true}{false} +</pre> +<!--l. 13834--><p class="nopar" > will produce “false true”. +</p><!--l. 13837--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172003"></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. 13424--><p class="noindent" > +</p><!--l. 13840--><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 @@ -26652,49 +28118,50 @@ 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-169004"></a> or <span + id="dx1-172004"></a> or <span class="cmtt-10">\printglossaries</span><a - id="dx1-169005"></a> even if the entry is explicitly defined later in the document. This is + id="dx1-172005"></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. 13434--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169006"></a> <span +href="#sec:techissues">§<span +class="cmbx-10">??</span>sec:techissues </a><a +href="#sec:techissues">Technical +Issues<!--tex4ht:ref: sec:techissues --></a> for further details.) +</p><!--l. 13850--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172006"></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. 13436--><p class="noindent" > +</p><!--l. 13852--><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. 13441--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169007"></a> <span +</p><!--l. 13857--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172007"></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. 13443--><p class="noindent" > +</p><!--l. 13859--><p class="noindent" > Does the reverse of <span class="cmtt-10">\glsdoifexists</span>. (This command uses <span class="cmtt-10">\ifglsentryexists</span>.) -</p><!--l. 13447--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169008"></a> <span +</p><!--l. 13863--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172008"></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. 13449--><p class="noindent" > +</p><!--l. 13865--><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. 13453--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169009"></a> <span +</p><!--l. 13869--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172009"></a> <span class="cmtt-10">\glsdoifexistsordo{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26702,13 +28169,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. 13455--><p class="noindent" > +</p><!--l. 13871--><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. 13459--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169010"></a> <span +</p><!--l. 13875--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172010"></a> <span class="cmtt-10">\glsdoifnoexistsordo{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26716,47 +28183,58 @@ 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. 13461--><p class="noindent" > +</p><!--l. 13877--><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. 13465--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169011"></a> <span +</p><!--l. 13881--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172011"></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. 13468--><p class="noindent" > +</p><!--l. 13884--><p class="noindent" > See <a -href="#sec:glsunset">§14 </a><a +href="#sec:glsunset">§<span +class="cmbx-10">??</span>sec:glsunset </a><a href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>. -</p><!--l. 13471--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169012"></a> <span +</p><!--l. 13887--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172012"></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. 13474--><p class="noindent" > +</p><!--l. 13890--><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. 13479--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169013"></a> <span +class="cmti-10">false part</span>⟩. This uses an inefficient method since this information isn’t stored. +</p><!--l. 13896--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you use <a +href="#glo:bib2gls"><span +class="cmtt-10">bib2gls</span><a + id="dx1-172013"></a></a>, a more efficient method is to use the <span id="textcolor308"><span +class="cmtt-10">save-child-count</span></span><a + id="dx1-172014"></a> resource option and test the +value of the <span +class="cmtt-10">childcount</span><a + id="dx1-172015"></a> field. </div> +</p><!--l. 13900--><p class="noindent" > +</p><!--l. 13902--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172016"></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. 13482--><p class="noindent" > +</p><!--l. 13905--><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. 13487--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169014"></a> <span +</p><!--l. 13910--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172017"></a> <span class="cmtt-10">\ifglshassymbol{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26764,16 +28242,18 @@ 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. 13489--><p class="noindent" > + + +</p><!--l. 13912--><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-169015"></a> field set. If it has, ⟨<span + id="dx1-172018"></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. 13494--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169016"></a> <span +</p><!--l. 13917--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172019"></a> <span class="cmtt-10">\ifglshaslong{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26781,22 +28261,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. 13496--><p class="noindent" > +</p><!--l. 13919--><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-169017"></a> field set. If it has, ⟨<span + id="dx1-172020"></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-169018"></a>. There is no + id="dx1-172021"></a>. There is no check for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13503--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169019"></a> <span +</p><!--l. 13926--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172022"></a> <span class="cmtt-10">\ifglshasshort{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26804,20 +28282,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. 13505--><p class="noindent" > +</p><!--l. 13928--><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-169020"></a> field set. If it has, ⟨<span + id="dx1-172023"></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-169021"></a>. There is no + id="dx1-172024"></a>. There is no check for the existence of ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13512--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169022"></a> <span +</p><!--l. 13935--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172025"></a> <span class="cmtt-10">\ifglshasdesc{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26825,16 +28303,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. 13514--><p class="noindent" > +</p><!--l. 13937--><p class="noindent" > This checks if the <span class="cmtt-10">description</span><a - id="dx1-169023"></a> field is non-empty for the entry given by ⟨<span + id="dx1-172026"></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. 13518--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169024"></a> <span +</p><!--l. 13941--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172027"></a> <span class="cmtt-10">\ifglsdescsuppressed{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26842,21 +28320,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. 13520--><p class="noindent" > +</p><!--l. 13943--><p class="noindent" > This checks if the <span class="cmtt-10">description</span><a - id="dx1-169025"></a> field has been set to just <span + id="dx1-172028"></a> field has been set to just <span class="cmtt-10">\nopostdesc</span><a - id="dx1-169026"></a> for the entry given by ⟨<span + id="dx1-172029"></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. 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 +</p><!--l. 13949--><p class="indent" > For all other fields you can use: +</p><!--l. 13950--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172030"></a> <span class="cmtt-10">\ifglshasfield{</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26866,7 +28344,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. 13530--><p class="noindent" > +</p><!--l. 13953--><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 @@ -26879,29 +28357,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. 13539--><p class="indent" > As from version 4.23, within ⟨<span +</p><!--l. 13962--><p class="indent" > As from version 4.23, within ⟨<span class="cmti-10">true part</span>⟩ you can use -</p><!--l. 13540--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169028"></a> <span +</p><!--l. 13963--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172031"></a> <span class="cmtt-10">\glscurrentfieldvalue </span></div><hr> -</p><!--l. 13542--><p class="noindent" > +</p><!--l. 13965--><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-386"> + <pre class="verbatim" id="verbatim-393"> \ifglshasfield{useri}{sample}{, \glscurrentfieldvalue}{} -</div> -<!--l. 13549--><p class="nopar" > will insert a comma, space and the field value if the <span +</pre> +<!--l. 13972--><p class="nopar" > will insert a comma, space and the field value if the <span class="cmtt-10">user1</span><a - id="dx1-169029"></a> key has been set for the entry whose label is + id="dx1-172032"></a> key has been set for the entry whose label is <span class="cmtt-10">sample</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 +</p><!--l. 13977--><p class="indent" > You can test if the value of the field is equal to a given string using: +</p><!--l. 13979--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172033"></a> <span class="cmtt-10">\ifglsfieldeq{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -26913,96 +28391,97 @@ 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. 13558--><p class="noindent" > +</p><!--l. 13981--><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 +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>). If the field isn’t recognised, +an error will occur. This command internally uses <span class="cmss-10">etoolbox</span><a - id="dx1-169031"></a>’s <span + id="dx1-172034"></a>’s <span class="cmtt-10">\ifcsstring </span>to perform the comparison. <span -class="cmti-10">The string is not</span> +class="cmti-10">The</span> <span -class="cmti-10">expanded during the test.</span> -</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 +class="cmti-10">string is not expanded during the test.</span> +</p><!--l. 13988--><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-387"> + <pre class="verbatim" id="verbatim-394"> \documentclass{article} - <br />\usepackage{glossaries} - <br />\newcommand*{\foo}{FOO} - <br />\newglossaryentry{sample1}{name={sample1},description={an example}, - <br />user1={FOO}} - <br />\newglossaryentry{sample2}{name={sample2},description={an example}, - <br />user1={\foo}} - <br />\begin{document} - <br />\ifglsfieldeq{sample1}{useri}{FOO}{TRUE}{FALSE}. - <br />\ifglsfieldeq{sample2}{useri}{FOO}{TRUE}{FALSE}. - <br />\end{document} -</div> -<!--l. 13584--><p class="nopar" > This will produce “TRUE” in both cases since expansion is on, so <span +\usepackage{glossaries} +\newcommand*{\foo}{FOO} +\newglossaryentry{sample1}{name={sample1},description={an example}, +user1={FOO}} +\newglossaryentry{sample2}{name={sample2},description={an example}, +user1={\foo}} +\begin{document} +\ifglsfieldeq{sample1}{useri}{FOO}{TRUE}{FALSE}. +\ifglsfieldeq{sample2}{useri}{FOO}{TRUE}{FALSE}. +\end{document} +</pre> +<!--l. 14007--><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-388"> + <pre class="verbatim" id="verbatim-395"> \ifglsfieldeq{sample1}{useri}{\foo}{TRUE}{FALSE}. - <br />\ifglsfieldeq{sample2}{useri}{\foo}{TRUE}{FALSE}. -</div> -<!--l. 13592--><p class="nopar" > then this will produce “FALSE” in both cases. Now suppose expansion is switched off for the <span +\ifglsfieldeq{sample2}{useri}{\foo}{TRUE}{FALSE}. +</pre> +<!--l. 14015--><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-169032"></a> + id="dx1-172035"></a> key: </p> - <div class="verbatim" id="verbatim-389"> + <pre class="verbatim" id="verbatim-396"> \documentclass{article} - <br />\usepackage{glossaries} - <br />\newcommand*{\foo}{FOO} - <br />\glssetnoexpandfield{useri} - <br />\newglossaryentry{sample1}{name={sample1},description={an example}, - <br />user1={FOO}} - <br />\newglossaryentry{sample2}{name={sample2},description={an example}, - <br />user1={\foo}} - <br />\begin{document} - <br />\ifglsfieldeq{sample1}{useri}{FOO}{TRUE}{FALSE}. - <br />\ifglsfieldeq{sample2}{useri}{FOO}{TRUE}{FALSE}. - <br />\end{document} -</div> -<!--l. 13614--><p class="nopar" > This now produces “TRUE” for the first case (comparing “FOO” with “FOO”) and “FALSE” for the second +\usepackage{glossaries} +\newcommand*{\foo}{FOO} +\glssetnoexpandfield{useri} +\newglossaryentry{sample1}{name={sample1},description={an example}, +user1={FOO}} +\newglossaryentry{sample2}{name={sample2},description={an example}, +user1={\foo}} +\begin{document} +\ifglsfieldeq{sample1}{useri}{FOO}{TRUE}{FALSE}. +\ifglsfieldeq{sample2}{useri}{FOO}{TRUE}{FALSE}. +\end{document} +</pre> +<!--l. 14037--><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. 13619--><p class="indent" > The reverse happens in the following: +</p><!--l. 14042--><p class="indent" > The reverse happens in the following: </p> - <div class="verbatim" id="verbatim-390"> + <pre class="verbatim" id="verbatim-397"> \documentclass{article} - <br />\usepackage{glossaries} - <br />\newcommand*{\foo}{FOO} - <br />\glssetnoexpandfield{useri} - <br />\newglossaryentry{sample1}{name={sample1},description={an example}, - <br />user1={FOO}} - <br />\newglossaryentry{sample2}{name={sample2},description={an example}, - <br />user1={\foo}} - <br />\begin{document} - <br />\ifglsfieldeq{sample1}{useri}{\foo}{TRUE}{FALSE}. - <br />\ifglsfieldeq{sample2}{useri}{\foo}{TRUE}{FALSE}. - <br />\end{document} -</div> -<!--l. 13639--><p class="nopar" > This now produces “FALSE” for the first case (comparing “FOO” with “<span +\usepackage{glossaries} +\newcommand*{\foo}{FOO} +\glssetnoexpandfield{useri} +\newglossaryentry{sample1}{name={sample1},description={an example}, +user1={FOO}} +\newglossaryentry{sample2}{name={sample2},description={an example}, +user1={\foo}} +\begin{document} +\ifglsfieldeq{sample1}{useri}{\foo}{TRUE}{FALSE}. +\ifglsfieldeq{sample2}{useri}{\foo}{TRUE}{FALSE}. +\end{document} +</pre> +<!--l. 14062--><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. 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 +</p><!--l. 14067--><p class="indent" > You can test if the value of a field is equal to the replacement text of a command using: +</p><!--l. 14069--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172036"></a> <span class="cmtt-10">\ifglsfielddefeq{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27014,38 +28493,38 @@ 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. 13648--><p class="noindent" > +</p><!--l. 14071--><p class="noindent" > This internally uses <span class="cmss-10">etoolbox</span><a - id="dx1-169034"></a>’s <span + id="dx1-172037"></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. 13652--><p class="indent" > For example: +</p><!--l. 14075--><p class="indent" > For example: </p> - <div class="verbatim" id="verbatim-391"> + <pre class="verbatim" id="verbatim-398"> \documentclass{article} - <br />\usepackage{glossaries} - <br />\newcommand*{\foo}{FOO} - <br />\glssetnoexpandfield{useri} - <br />\newglossaryentry{sample1}{name={sample1},description={an example}, - <br />user1={FOO}} - <br />\newglossaryentry{sample2}{name={sample2},description={an example}, - <br />user1={\foo}} - <br />\begin{document} - <br />\ifglsfielddefeq{sample1}{useri}{\foo}{TRUE}{FALSE}. - <br />\ifglsfielddefeq{sample2}{useri}{\foo}{TRUE}{FALSE}. - <br />\end{document} -</div> -<!--l. 13672--><p class="nopar" > Here, the first case produces “TRUE” since the value of the <span +\usepackage{glossaries} +\newcommand*{\foo}{FOO} +\glssetnoexpandfield{useri} +\newglossaryentry{sample1}{name={sample1},description={an example}, +user1={FOO}} +\newglossaryentry{sample2}{name={sample2},description={an example}, +user1={\foo}} +\begin{document} +\ifglsfielddefeq{sample1}{useri}{\foo}{TRUE}{FALSE}. +\ifglsfielddefeq{sample2}{useri}{\foo}{TRUE}{FALSE}. +\end{document} +</pre> +<!--l. 14095--><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. 13678--><p class="indent" > The second case produces “FALSE” since the value of the <span +</p><!--l. 14101--><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 @@ -27054,15 +28533,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. 13684--><p class="indent" > If we add: +</p><!--l. 14107--><p class="indent" > If we add: </p> - <div class="verbatim" id="verbatim-392"> + <pre class="verbatim" id="verbatim-399"> \newcommand{\FOO}{\foo} - <br />\ifglsfielddefeq{sample2}{useri}{\FOO}{TRUE}{FALSE}. -</div> -<!--l. 13688--><p class="nopar" > we now get “TRUE” since the value of the <span +\ifglsfielddefeq{sample2}{useri}{\FOO}{TRUE}{FALSE}. +</pre> +<!--l. 14111--><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 @@ -27070,10 +28549,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. 13694--><p class="indent" > There is a similar command that requires the control sequence name (without the leading backslash) instead +</p><!--l. 14117--><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. 13696--><p class="indent" > <hr><div title="Definition"><a - id="dx1-169035"></a> <span +</p><!--l. 14119--><p class="indent" > <hr><div title="Definition"><a + id="dx1-172038"></a> <span class="cmtt-10">\ifglsfieldcseq{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27085,45 +28564,46 @@ 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. 13698--><p class="noindent" > +</p><!--l. 14121--><p class="noindent" > This internally uses <span class="cmss-10">etoolbox</span><a - id="dx1-169036"></a>’s <span + id="dx1-172039"></a>’s <span class="cmtt-10">\ifcsstrequal </span>command instead of <span class="cmtt-10">\ifdefstrequal</span>. -</p><!--l. 13702--><p class="noindent" > +</p><!--l. 14125--><p class="noindent" > </p> -<!--l. 13702--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">16.3 </span> <a +<!--l. 14125--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">15.3 </span> <a id="sec:fetchset"></a>Fetching and Updating the Value of a Field</h3> -<!--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. 13707--><p class="indent" > <hr><div title="Definition"><a - id="dx1-170001"></a> <span +<!--l. 14128--><p class="noindent" >In addition to the commands described in <a +href="#sec:glsnolink">§<span +class="cmbx-10">??</span>sec:glsnolink </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. 14130--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173001"></a> <span class="cmtt-10">\glsentrytype{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13709--><p class="noindent" > +</p><!--l. 14132--><p class="noindent" > Expands to the entry’s glossary type. No existence check is performed. -</p><!--l. 13713--><p class="indent" > <hr><div title="Definition"><a - id="dx1-170002"></a> <span +</p><!--l. 14136--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173002"></a> <span class="cmtt-10">\glsentryparent{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13715--><p class="noindent" > +</p><!--l. 14138--><p class="noindent" > Expands to the label of the entry’s parent. No existence check is performed. -</p><!--l. 13719--><p class="indent" > <hr><div title="Definition"><a - id="dx1-170003"></a> <span +</p><!--l. 14142--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173003"></a> <span class="cmtt-10">\glsentrysort{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13721--><p class="noindent" > +</p><!--l. 14144--><p class="noindent" > Expands to the entry’s sort value. No existence check is performed. -</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 +</p><!--l. 14147--><p class="indent" > You can fetch the value of a given field and store it in a control sequence using: +</p><!--l. 14149--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173004"></a> <span class="cmtt-10">\glsfieldfetch{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27131,37 +28611,38 @@ 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. 13728--><p class="noindent" > +</p><!--l. 14151--><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 -href="#tab:fieldmap">table 4.1</a>) and ⟨<span -class="cmti-10">cs</span>⟩ is the control -sequence in which to store the value. Remember that ⟨<span -class="cmti-10">field</span>⟩ is the internal label and is not necessarily the same as -the key used to set that field in the argument of <span +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>) and ⟨<span +class="cmti-10">cs</span>⟩ is +the control sequence in which to store the value. Remember that ⟨<span +class="cmti-10">field</span>⟩ is the internal label and is not necessarily +the same as 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. 13737--><p class="indent" > You can change the value of a given field using one of the following commands. Note that these commands +</p><!--l. 14160--><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 - id="dx1-170005"></a> field, it won’t modify the value given by the <span + id="dx1-173005"></a> field, it won’t modify the value given by the <span class="cmtt-10">name</span><a - id="dx1-170006"></a>, <span + id="dx1-173006"></a>, <span class="cmtt-10">plural</span><a - id="dx1-170007"></a>, <span + id="dx1-173007"></a>, <span class="cmtt-10">first</span><a - id="dx1-170008"></a> or any other related + id="dx1-173008"></a> or any other related key. -</p><!--l. 13743--><p class="indent" > In all the four related commands below, ⟨<span +</p><!--l. 14166--><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. 13747--><p class="indent" > <hr><div title="Definition"><a - id="dx1-170009"></a> <span +</p><!--l. 14170--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173009"></a> <span class="cmtt-10">\glsfielddef{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27169,13 +28650,13 @@ 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. 14172--><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. 13753--><p class="indent" > <hr><div title="Definition"><a - id="dx1-170010"></a> <span +</p><!--l. 14176--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173010"></a> <span class="cmtt-10">\glsfieldedef{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27183,13 +28664,13 @@ 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. 13755--><p class="noindent" > +</p><!--l. 14178--><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. 13760--><p class="indent" > <hr><div title="Definition"><a - id="dx1-170011"></a> <span +</p><!--l. 14183--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173011"></a> <span class="cmtt-10">\glsfieldgdef{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27197,11 +28678,11 @@ 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. 13762--><p class="noindent" > +</p><!--l. 14185--><p class="noindent" > This uses <span class="cmtt-10">\gdef </span>to change the value of the field. -</p><!--l. 13765--><p class="indent" > <hr><div title="Definition"><a - id="dx1-170012"></a> <span +</p><!--l. 14188--><p class="indent" > <hr><div title="Definition"><a + id="dx1-173012"></a> <span class="cmtt-10">\glsfieldxdef{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27209,7 +28690,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. 13767--><p class="noindent" > +</p><!--l. 14190--><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 @@ -27217,102 +28698,109 @@ protected. </p> -<!--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 +<!--l. 14195--><p class="indent" > </div> +</p><!--l. 14195--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">16. <a id="sec:prefix"></a>Prefixes or Determiners</h2> -</p><!--l. 13774--><p class="indent" > The <span +</p><!--l. 14197--><p class="indent" > The <span class="cmss-10">glossaries-prefix</span><a - id="dx1-171001"></a> package that comes with the <span + id="dx1-174001"></a> package that comes with the <span class="cmss-10">glossaries </span>package provides additional keys that can be used as prefixes. For example, if you want to specify determiners (such as “a”, “an” or “the”). 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. 13782--><p class="indent" > The extra keys for <span +</p><!--l. 14205--><p class="indent" > The extra keys for <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-171002"></a> are as follows: + id="dx1-174002"></a> are as follows: </p><dl class="description"><dt class="description"> + <!--l. 14207--><p class="noindent" > <span class="cmtt-10">prefix</span><a - id="dx1-171003"></a> </dt><dd -class="description">The prefix associated with the <span + id="dx1-174003"></a> </p></dt><dd +class="description"> + <!--l. 14207--><p class="noindent" >The prefix associated with the <span class="cmtt-10">text</span><a - id="dx1-171004"></a> key. This defaults to nothing. - </dd><dt class="description"> + id="dx1-174004"></a> key. This defaults to nothing. + </p></dd><dt class="description"> + <!--l. 14210--><p class="noindent" > <span class="cmtt-10">prefixplural</span><a - id="dx1-171005"></a> </dt><dd -class="description">The prefix associated with the <span + id="dx1-174005"></a> </p></dt><dd +class="description"> + <!--l. 14210--><p class="noindent" >The prefix associated with the <span class="cmtt-10">plural</span><a - id="dx1-171006"></a> key. This defaults to nothing. - </dd><dt class="description"> + id="dx1-174006"></a> key. This defaults to nothing. + </p></dd><dt class="description"> + <!--l. 14213--><p class="noindent" > <span class="cmtt-10">prefixfirst</span><a - id="dx1-171007"></a> </dt><dd -class="description">The prefix associated with the <span + id="dx1-174007"></a> </p></dt><dd +class="description"> + <!--l. 14213--><p class="noindent" >The prefix associated with the <span class="cmtt-10">first</span><a - id="dx1-171008"></a> key. If omitted, this defaults to the value of the - <span + id="dx1-174008"></a> key. If omitted, this defaults to the value of the <span class="cmtt-10">prefix</span><a - id="dx1-171009"></a> key. - </dd><dt class="description"> + id="dx1-174009"></a> key. + </p></dd><dt class="description"> + <!--l. 14217--><p class="noindent" > <span class="cmtt-10">prefixfirstplural</span><a - id="dx1-171010"></a> </dt><dd -class="description">The prefix associated with the <span + id="dx1-174010"></a> </p></dt><dd +class="description"> + <!--l. 14217--><p class="noindent" >The prefix associated with the <span class="cmtt-10">firstplural</span><a - id="dx1-171011"></a> key. If omitted, this defaults to the - value of the <span + id="dx1-174011"></a> key. If omitted, this defaults to the value of the + <span class="cmtt-10">prefixplural</span><a - id="dx1-171012"></a> key.</dd></dl> + id="dx1-174012"></a> key.</p></dd></dl> <a id="ex:determiners"></a> -<!--l. 13799--><p class="noindent" ><span +<!--l. 14222--><p class="noindent" ><span class="cmbx-12">Example 30</span><span class="cmbx-12"> (Defining Determiners)</span><a - id="x1-171014"></a> -</p><!--l. 13800--><p class="indent" > Here’s the start of my example document: + id="x1-174014"></a> +</p><!--l. 14223--><p class="indent" > Here’s the start of my example document: </p> - <div class="verbatim" id="verbatim-393"> + <pre class="verbatim" id="verbatim-400"> \documentclass{article} - <br />\usepackage[colorlinks]{hyperref} - <br />\usepackage[toc,acronym]{glossaries-prefix} -</div> -<!--l. 13806--><p class="nopar" > Note that I’ve simply replaced <span +\usepackage[colorlinks]{hyperref} +\usepackage[toc,acronym]{glossaries-prefix} +</pre> +<!--l. 14229--><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 -href="#fn1x17" id="fn1x17-bk"><sup class="textsuperscript">17.1</sup></a></span><a - id="x1-171015f1"></a>: +href="#fn1x16" id="fn1x16-bk"><sup class="textsuperscript">16.1</sup></a></span><a + id="x1-174015f1"></a>: </p> - <div class="verbatim" id="verbatim-394"> + <pre class="verbatim" id="verbatim-401"> \newglossaryentry{sample}{name={sample},% - <br />  description={an example},% - <br />  prefix={a~},% - <br />  prefixplural={the\space}% - <br />} -</div> -<!--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 +  description={an example},% +  prefix={a~},% +  prefixplural={the\space}% +} +</pre> +<!--l. 14241--><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-395"> + <pre class="verbatim" id="verbatim-402"> \newglossaryentry{oeil}{name={oeil}, - <br />  plural={yeux}, - <br />  description={eye}, - <br />  prefix={l'}, - <br />  prefixplural={les\space}} -</div> -<!--l. 13831--><p class="nopar" > Where a space is required at the end of the prefix, you must use a spacing command, such as +  plural={yeux}, +  description={eye}, +  prefix={l'}, +  prefixplural={les\space}} +</pre> +<!--l. 14254--><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 @@ -27320,51 +28808,52 @@ 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. 13837--><p class="indent" > In the event that you always require a space between the prefix and the term, then you can instead +</p><!--l. 14260--><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. 13839--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171017"></a> <span +</p><!--l. 14262--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174017"></a> <span class="cmtt-10">\glsprefixsep </span></div><hr> -</p><!--l. 13841--><p class="noindent" > +</p><!--l. 14264--><p class="noindent" > to do a space. (This command does nothing by default.) For example: </p> - <div class="verbatim" id="verbatim-396"> + <pre class="verbatim" id="verbatim-403"> \renewcommand{\glsprefixsep}{\space} -</div> -<!--l. 13845--><p class="nopar" > -</p><!--l. 13847--><p class="indent" > The prefixes can also be used with acronyms. For example: +</pre> +<!--l. 14268--><p class="nopar" > +</p><!--l. 14270--><p class="indent" > The prefixes can also be used with acronyms. For example: </p> - <div class="verbatim" id="verbatim-397"> + <pre class="verbatim" id="verbatim-404"> \newacronym - <br /> [% - <br />   prefix={an\space},prefixfirst={a~}% - <br /> ]{svm}{SVM}{support vector machine} -</div> -<!--l. 13853--><p class="nopar" > </p> + [% +   prefix={an\space},prefixfirst={a~}% + ]{svm}{SVM}{support vector machine} +</pre> +<!--l. 14276--><p class="nopar" > </p> <div class="center" > -<!--l. 13854--><p class="noindent" > -</p><!--l. 13854--><p class="noindent" >____________________________</p></div> -<!--l. 13856--><p class="indent" > The <span +<!--l. 14277--><p class="noindent" > +</p><!--l. 14277--><p class="noindent" >____________________________</p></div> +<!--l. 14279--><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 + id="dx1-174018"></a> package provides convenient commands to use these prefixes with commands such as <span class="cmtt-10">\gls</span><a - id="dx1-171019"></a>. Note that the prefix is not considered part of the <a + id="dx1-174019"></a>. Note that the prefix is not considered part of the <a href="#glo:linktext">link text<a - id="dx1-171020"></a></a>, so it’s not included in the hyperlink (where + id="dx1-174020"></a></a>, so it’s not included in the hyperlink (where hyperlinks are enabled). The options and any star or plus modifier are passed on to the <a href="#sec:gls-like"><span class="cmtt-10">\gls</span>-like</a> command. (See <a -href="#sec:glslink">§6 </a><a +href="#sec:glslink">§<span +class="cmbx-10">??</span>sec:glslink </a><a href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> for further details.) -</p><!--l. 13863--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171021"></a> <span +</p><!--l. 14286--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174021"></a> <span class="cmtt-10">\pgls[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27372,12 +28861,12 @@ 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. 13865--><p class="noindent" > +</p><!--l. 14288--><p class="noindent" > This is inserts the value of the <span class="cmtt-10">prefix</span><a - id="dx1-171022"></a> key (or <span + id="dx1-174022"></a> key (or <span class="cmtt-10">prefixfirst</span><a - id="dx1-171023"></a> key, on <a + id="dx1-174023"></a> key, on <a href="#glo:firstuse">first use</a>) in front of <span class="cmtt-10">\gls[</span>⟨<span class="cmti-10">options</span>⟩<span @@ -27388,8 +28877,8 @@ class="cmtt-10">}</span> class="cmtt-10">[</span>⟨<span class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. -</p><!--l. 13870--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171024"></a> <span +</p><!--l. 14293--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174024"></a> <span class="cmtt-10">\Pgls[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27397,12 +28886,12 @@ 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. 13872--><p class="noindent" > +</p><!--l. 14295--><p class="noindent" > If the <span class="cmtt-10">prefix</span><a - id="dx1-171025"></a> key (or <span + id="dx1-174025"></a> key (or <span class="cmtt-10">prefixfirst</span><a - id="dx1-171026"></a>, on first use) has been set, this displays the value of that key with the first + id="dx1-174026"></a>, on first use) has been set, this displays the value of that key with the first letter converted to upper case followed by <span class="cmtt-10">\gls[</span>⟨<span class="cmti-10">options</span>⟩<span @@ -27413,7 +28902,7 @@ class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. If that key hasn’t been set, this is equivalent to <span class="cmtt-10">\Gls</span><a - id="dx1-171027"></a><span + id="dx1-174027"></a><span class="cmtt-10">[</span>⟨<span class="cmti-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27421,8 +28910,8 @@ 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 - id="dx1-171028"></a> <span +</p><!--l. 14303--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174028"></a> <span class="cmtt-10">\PGLS[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27430,14 +28919,14 @@ 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. 14305--><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 + id="dx1-174029"></a> instead of <span class="cmtt-10">\gls</span>. -</p><!--l. 13886--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171030"></a> <span +</p><!--l. 14309--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174030"></a> <span class="cmtt-10">\pglspl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27445,12 +28934,12 @@ 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. 13888--><p class="noindent" > +</p><!--l. 14311--><p class="noindent" > This is inserts the value of the <span class="cmtt-10">prefixplural</span><a - id="dx1-171031"></a> key (or <span + id="dx1-174031"></a> key (or <span class="cmtt-10">prefixfirstplural</span><a - id="dx1-171032"></a> key, on <a + id="dx1-174032"></a> key, on <a href="#glo:firstuse">first use</a>) in front of <span class="cmtt-10">\glspl</span> <span @@ -27461,8 +28950,8 @@ class="cmti-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. -</p><!--l. 13893--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171033"></a> <span +</p><!--l. 14316--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174033"></a> <span class="cmtt-10">\Pglspl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27470,12 +28959,12 @@ 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. 13895--><p class="noindent" > +</p><!--l. 14318--><p class="noindent" > If the <span class="cmtt-10">prefixplural</span><a - id="dx1-171034"></a> key (or <span + id="dx1-174034"></a> key (or <span class="cmtt-10">prefixfirstplural</span><a - id="dx1-171035"></a>, on first use) has been set, this displays the value of that key + id="dx1-174035"></a>, on first use) has been set, this displays the value of that key with the first letter converted to upper case followed by <span class="cmtt-10">\glspl[</span>⟨<span class="cmti-10">options</span>⟩<span @@ -27486,7 +28975,7 @@ class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. If that key hasn’t been set, this is equivalent to <span class="cmtt-10">\Glspl</span><a - id="dx1-171036"></a><span + id="dx1-174036"></a><span class="cmtt-10">[</span>⟨<span class="cmti-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27494,8 +28983,8 @@ class="cmti-10">label</span>⟩<span class="cmtt-10">}[</span>⟨<span class="cmti-10">insert</span>⟩<span class="cmtt-10">]</span>. -</p><!--l. 13903--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171037"></a> <span +</p><!--l. 14326--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174037"></a> <span class="cmtt-10">\PGLSpl[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -27503,19 +28992,19 @@ 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. 13905--><p class="noindent" > +</p><!--l. 14328--><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 - id="dx1-171038"></a> instead of <span + id="dx1-174038"></a> instead of <span class="cmtt-10">\glspl</span>. <a id="ex:prefixes"></a> -</p><!--l. 13909--><p class="noindent" ><span +</p><!--l. 14332--><p class="noindent" ><span class="cmbx-12">Example 31</span><span class="cmbx-12"> (Using Prefixes)</span><a - id="x1-171040"></a> -</p><!--l. 13910--><p class="indent" > Continuing from Example <a + id="x1-174040"></a> +</p><!--l. 14333--><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 @@ -27523,26 +29012,26 @@ commands: </p> - <div class="verbatim" id="verbatim-398"> + <pre class="verbatim" id="verbatim-405"> First use: \pgls{svm}. Next use: \pgls{svm}. - <br />Singular: \pgls{sample}, \pgls{oeil}. - <br />Plural: \pglspl{sample}, \pglspl{oeil}. -</div> -<!--l. 13916--><p class="nopar" > which produces: - </p><div class="quote"> - <!--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. 13923--><p class="noindent" >For a complete document, see <a +Singular: \pgls{sample}, \pgls{oeil}. +Plural: \pglspl{sample}, \pglspl{oeil}. +</pre> +<!--l. 14339--><p class="nopar" > which produces: + </p><blockquote class="quote"> + <!--l. 14342--><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></blockquote> +<!--l. 14346--><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. 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 +<!--l. 14347--><p class="noindent" > +</p><!--l. 14347--><p class="noindent" >____________________________</p></div> +<!--l. 14349--><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. 13929--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171041"></a> <span +</p><!--l. 14352--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174041"></a> <span class="cmtt-10">\ifglshasprefix{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27550,15 +29039,15 @@ 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. 14354--><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. 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 + id="dx1-174042"></a> key. +</p><!--l. 14358--><p class="indent" > This package also provides the following commands: +</p><!--l. 14359--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174043"></a> <span class="cmtt-10">\ifglshasprefixplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27566,14 +29055,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. 13938--><p class="noindent" > +</p><!--l. 14361--><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. 13942--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171045"></a> <span + id="dx1-174044"></a> key. +</p><!--l. 14365--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174045"></a> <span class="cmtt-10">\ifglshasprefixfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27581,14 +29070,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. 13944--><p class="noindent" > +</p><!--l. 14367--><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. 13948--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171047"></a> <span + id="dx1-174046"></a> key. +</p><!--l. 14371--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174047"></a> <span class="cmtt-10">\ifglshasprefixfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -27596,217 +29085,218 @@ 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. 13950--><p class="noindent" > +</p><!--l. 14373--><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. 13954--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171048"></a> <span +</p><!--l. 14377--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174048"></a> <span class="cmtt-10">\glsentryprefix{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13956--><p class="noindent" > +</p><!--l. 14379--><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 + id="dx1-174049"></a> key for the entry given by ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13960--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171050"></a> <span +</p><!--l. 14383--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174050"></a> <span class="cmtt-10">\glsentryprefixfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13962--><p class="noindent" > +</p><!--l. 14385--><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 + id="dx1-174051"></a> key for the entry given by ⟨<span class="cmti-10">label</span>⟩. -</p><!--l. 13966--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171052"></a> <span +</p><!--l. 14389--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174052"></a> <span class="cmtt-10">\glsentryprefixplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13968--><p class="noindent" > +</p><!--l. 14391--><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 + id="dx1-174053"></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. 13973--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171054"></a> <span +</p><!--l. 14396--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174054"></a> <span class="cmtt-10">\glsentryprefixfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13975--><p class="noindent" > +</p><!--l. 14398--><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 + id="dx1-174055"></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. 13980--><p class="indent" > There are also variants that convert the first letter to upper +</p><!--l. 14403--><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. 13983--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171057"></a> <span +href="#fn2x16" id="fn2x16-bk"><sup class="textsuperscript">16.2</sup></a></span><a + id="x1-174056f2"></a>: +</p><!--l. 14406--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174057"></a> <span class="cmtt-10">\Glsentryprefix{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13985--><p class="noindent" > -</p><!--l. 13986--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171058"></a> <span +</p><!--l. 14408--><p class="noindent" > +</p><!--l. 14409--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174058"></a> <span class="cmtt-10">\Glsentryprefixfirst{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13988--><p class="noindent" > -</p><!--l. 13989--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171059"></a> <span +</p><!--l. 14411--><p class="noindent" > +</p><!--l. 14412--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174059"></a> <span class="cmtt-10">\Glsentryprefixplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</p><!--l. 13991--><p class="noindent" > -</p><!--l. 13993--><p class="indent" > <hr><div title="Definition"><a - id="dx1-171060"></a> <span +</p><!--l. 14414--><p class="noindent" > +</p><!--l. 14416--><p class="indent" > <hr><div title="Definition"><a + id="dx1-174060"></a> <span class="cmtt-10">\Glsentryprefixfirstplural{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span></div><hr> -</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 +</p><!--l. 14418--><p class="noindent" > +</p><!--l. 14420--><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 + id="dx1-174061"></a>, these commands aren’t expandable so can’t be used in PDF bookmarks. </div> -</p><!--l. 14000--><p class="noindent" > +</p><!--l. 14423--><p class="noindent" > <a id="ex:plist"></a> -</p><!--l. 14002--><p class="noindent" ><span +</p><!--l. 14425--><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. 14003--><p class="indent" > You can use the above commands to define a new glossary style that uses the determiner. For + id="x1-174063"></a> +</p><!--l. 14426--><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 + id="dx1-174064"></a> style that inserts the prefix before the name: </p> - <div class="verbatim" id="verbatim-399"> + <pre class="verbatim" id="verbatim-406"> \newglossarystyle{plist}{% - <br />  \setglossarystyle{list}% - <br />  \renewcommand*{\glossentry}[2]{% - <br />    \item[\glsentryitem{##1}% - <br />          \glsentryprefix{##1}% - <br />          \glstarget{##1}{\glossentryname{##1}}] - <br />       \glossentrydesc{##1}\glspostdescription\space ##2}% - <br />} -</div> -<!--l. 14016--><p class="nopar" > If you want to change the prefix separator (<span +  \setglossarystyle{list}% +  \renewcommand*{\glossentry}[2]{% +    \item[\glsentryitem{##1}% +          \glsentryprefix{##1}% +          \glstarget{##1}{\glossentryname{##1}}] +       \glossentrydesc{##1}\glspostdescription\space ##2}% +} +</pre> +<!--l. 14439--><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-400"> + <pre class="verbatim" id="verbatim-407"> \newglossarystyle{plist}{% - <br />  \setglossarystyle{list}% - <br />  \renewcommand*{\glossentry}[2]{% - <br />    \item[\glsentryitem{##1}% - <br />          \ifglshasprefix{##1}{\glsentryprefix{##1}\glsprefixsep}{}% - <br />          \glstarget{##1}{\glossentryname{##1}}] - <br />       \glossentrydesc{##1}\glspostdescription\space ##2}% - <br />} -</div> -<!--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 +  \setglossarystyle{list}% +  \renewcommand*{\glossentry}[2]{% +    \item[\glsentryitem{##1}% +          \ifglshasprefix{##1}{\glsentryprefix{##1}\glsprefixsep}{}% +          \glstarget{##1}{\glossentryname{##1}}] +       \glossentrydesc{##1}\glspostdescription\space ##2}% +} +</pre> +<!--l. 14451--><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-401"> + <pre class="verbatim" id="verbatim-408"> \newglossarystyle{plist}{% - <br />  \setglossarystyle{list}% - <br />  \renewcommand*{\glossentry}[2]{% - <br />    \item[\glsentryitem{##1}% - <br />          \glstarget{##1}% - <br />          {% - <br />            \ifglshasprefix{##1}% - <br />            {\Glsentryprefix{##1}\glsprefixsep\glossentryname{##1}}% - <br />            {\Glossentryname{##1}}% - <br />          }] - <br />       \glossentrydesc{##1}\glspostdescription\space ##2}% - <br />} -</div> -<!--l. 14044--><p class="nopar" > </p> +  \setglossarystyle{list}% +  \renewcommand*{\glossentry}[2]{% +    \item[\glsentryitem{##1}% +          \glstarget{##1}% +          {% +            \ifglshasprefix{##1}% +            {\Glsentryprefix{##1}\glsprefixsep\glossentryname{##1}}% +            {\Glossentryname{##1}}% +          }] +       \glossentrydesc{##1}\glspostdescription\space ##2}% +} +</pre> +<!--l. 14467--><p class="nopar" > </p> <div class="center" > -<!--l. 14045--><p class="noindent" > -</p><!--l. 14045--><p class="noindent" >____________________________</p></div> +<!--l. 14468--><p class="noindent" > +</p><!--l. 14468--><p class="noindent" >____________________________</p></div> -<!--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 +<!--l. 14470--><p class="indent" > </div> +</p><!--l. 14470--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">17. <a id="sec:accsupp"></a>Accessibility Support</h2> -</p><!--l. 14049--><p class="indent" > Limited accessibility support is provided by the accompanying <span +</p><!--l. 14472--><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 + id="dx1-175001"></a> package, but note that this package is experimental and it requires the <span class="cmss-10">accsupp</span><a - id="dx1-172002"></a> package which is also listed as experimental. This package + id="dx1-175002"></a> package which is also listed as experimental. This package automatically loads the <span class="cmss-10">glossaries</span><a - id="dx1-172003"></a> package. Any options are passed to <span + id="dx1-175003"></a> package. Any options are passed to <span class="cmss-10">glossaries</span><a - id="dx1-172004"></a> (if it hasn’t already been loaded). + id="dx1-175004"></a> (if it hasn’t already been loaded). For example: </p> - <div class="verbatim" id="verbatim-402"> + <pre class="verbatim" id="verbatim-409"> \usepackage[acronym]{glossaries-accsupp} -</div> -<!--l. 14057--><p class="nopar" > This will load <span +</pre> +<!--l. 14480--><p class="nopar" > This will load <span class="cmss-10">glossaries</span><a - id="dx1-172005"></a> with the <span + id="dx1-175005"></a> with the <span class="cmss-10">acronym</span><a - id="dx1-172006"></a> package option as well as loading <span + id="dx1-175006"></a> package option as well as loading <span class="cmss-10">glossaries-accsupp</span><a - id="dx1-172007"></a>. -</p><!--l. 14061--><p class="indent" > If you are using the <a + id="dx1-175007"></a>. +</p><!--l. 14484--><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 -class="cmss-10">glossaries-extra</span></a> with the <span id="textcolor283"><span +class="cmss-10">glossaries-extra</span></a> with the <span id="textcolor309"><span class="cmss-10">accsupp</span></span><a - id="dx1-172008"></a> + id="dx1-175008"></a> package option. For example: </p> - <div class="verbatim" id="verbatim-403"> + <pre class="verbatim" id="verbatim-410"> \usepackage[abbreviations,accsupp]{glossaries-extra} -</div> -<!--l. 14066--><p class="nopar" > This will load <a +</pre> +<!--l. 14489--><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">glossaries-extra</span></a> (with the <span id="textcolor310"><span class="cmss-10">abbreviations</span></span><a - id="dx1-172009"></a> option), <span + id="dx1-175009"></a> option), <span class="cmss-10">glossaries</span><a - id="dx1-172010"></a> and <span + id="dx1-175010"></a> and <span class="cmss-10">glossaries-accsupp</span><a - id="dx1-172011"></a> and make + id="dx1-175011"></a> and make appropriate patches to integrate the accessibility support with the extension commands. -</p><!--l. 14072--><p class="indent" > The <span +</p><!--l. 14495--><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 + id="dx1-175012"></a> package defines additional keys that may be used when defining glossary entries. The keys are as follows: </p><dl class="description"><dt class="description"> + <!--l. 14499--><p class="noindent" > <span class="cmtt-10">access</span><a - id="dx1-172013"></a> </dt><dd + id="dx1-175013"></a> </p></dt><dd class="description"> - The + <!--l. 14499--><p class="noindent" >The replacement text corresponding @@ -27814,14 +29304,15 @@ class="description"> the <span class="cmtt-10">name</span><a - id="dx1-172014"></a> + id="dx1-175014"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14502--><p class="noindent" > <span class="cmtt-10">textaccess</span><a - id="dx1-172015"></a> </dt><dd + id="dx1-175015"></a> </p></dt><dd class="description"> - The + <!--l. 14502--><p class="noindent" >The replacement text corresponding @@ -27829,31 +29320,33 @@ class="description"> the <span class="cmtt-10">text</span><a - id="dx1-172016"></a> + id="dx1-175016"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14505--><p class="noindent" > <span class="cmtt-10">firstaccess</span><a - id="dx1-172017"></a> </dt><dd + id="dx1-175017"></a> </p></dt><dd class="description"> - The + <!--l. 14505--><p class="noindent" >The replacement text corresponding to + + the <span class="cmtt-10">first</span><a - id="dx1-172018"></a> + id="dx1-175018"></a> key. - </dd><dt class="description"> - - + </p></dd><dt class="description"> + <!--l. 14508--><p class="noindent" > <span class="cmtt-10">pluralaccess</span><a - id="dx1-172019"></a> </dt><dd + id="dx1-175019"></a> </p></dt><dd class="description"> - The + <!--l. 14508--><p class="noindent" >The replacement text corresponding @@ -27861,14 +29354,15 @@ class="description"> the <span class="cmtt-10">plural</span><a - id="dx1-172020"></a> + id="dx1-175020"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14511--><p class="noindent" > <span class="cmtt-10">firstpluralaccess</span><a - id="dx1-172021"></a> </dt><dd + id="dx1-175021"></a> </p></dt><dd class="description"> - The + <!--l. 14511--><p class="noindent" >The replacement text corresponding @@ -27876,14 +29370,15 @@ class="description"> the <span class="cmtt-10">firstplural</span><a - id="dx1-172022"></a> + id="dx1-175022"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14514--><p class="noindent" > <span class="cmtt-10">symbolaccess</span><a - id="dx1-172023"></a> </dt><dd + id="dx1-175023"></a> </p></dt><dd class="description"> - The + <!--l. 14514--><p class="noindent" >The replacement text corresponding @@ -27891,14 +29386,17 @@ class="description"> the <span class="cmtt-10">symbol</span><a - id="dx1-172024"></a> + id="dx1-175024"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14517--><p class="noindent" > + + <span class="cmtt-10">symbolpluralaccess</span><a - id="dx1-172025"></a> </dt><dd + id="dx1-175025"></a> </p></dt><dd class="description"> - The + <!--l. 14517--><p class="noindent" >The replacement text corresponding @@ -27906,16 +29404,15 @@ class="description"> the <span class="cmtt-10">symbolplural</span><a - id="dx1-172026"></a> + id="dx1-175026"></a> key. - </dd><dt class="description"> - - + </p></dd><dt class="description"> + <!--l. 14520--><p class="noindent" > <span class="cmtt-10">descriptionaccess</span><a - id="dx1-172027"></a> </dt><dd + id="dx1-175027"></a> </p></dt><dd class="description"> - The + <!--l. 14520--><p class="noindent" >The replacement text corresponding @@ -27923,14 +29420,15 @@ class="description"> the <span class="cmtt-10">description</span><a - id="dx1-172028"></a> + id="dx1-175028"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14523--><p class="noindent" > <span class="cmtt-10">descriptionpluralaccess</span><a - id="dx1-172029"></a> </dt><dd + id="dx1-175029"></a> </p></dt><dd class="description"> - The + <!--l. 14523--><p class="noindent" >The replacement text corresponding @@ -27938,34 +29436,38 @@ class="description"> the <span class="cmtt-10">descriptionplural</span><a - id="dx1-172030"></a> + id="dx1-175030"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14526--><p class="noindent" > <span class="cmtt-10">longaccess</span><a - id="dx1-172031"></a> </dt><dd + id="dx1-175031"></a> </p></dt><dd class="description"> - The + <!--l. 14526--><p class="noindent" >The replacement text corresponding + + to the <span class="cmtt-10">long</span><a - id="dx1-172032"></a> + id="dx1-175032"></a> key (used by <span class="cmtt-10">\newacronym</span><a - id="dx1-172033"></a>). - </dd><dt class="description"> + id="dx1-175033"></a>). + </p></dd><dt class="description"> + <!--l. 14529--><p class="noindent" > <span class="cmtt-10">shortaccess</span><a - id="dx1-172034"></a> </dt><dd + id="dx1-175034"></a> </p></dt><dd class="description"> - The + <!--l. 14529--><p class="noindent" >The replacement text corresponding @@ -27973,21 +29475,20 @@ class="description"> the <span class="cmtt-10">short</span><a - id="dx1-172035"></a> - - + id="dx1-175035"></a> key (used by <span class="cmtt-10">\newacronym</span><a - id="dx1-172036"></a>). - </dd><dt class="description"> + id="dx1-175036"></a>). + </p></dd><dt class="description"> + <!--l. 14532--><p class="noindent" > <span class="cmtt-10">longpluralaccess</span><a - id="dx1-172037"></a> </dt><dd + id="dx1-175037"></a> </p></dt><dd class="description"> - The + <!--l. 14532--><p class="noindent" >The replacement text corresponding @@ -27995,19 +29496,22 @@ class="description"> the <span class="cmtt-10">longplural</span><a - id="dx1-172038"></a> + id="dx1-175038"></a> key (used by <span class="cmtt-10">\newacronym</span><a - id="dx1-172039"></a>). - </dd><dt class="description"> + id="dx1-175039"></a>). + </p></dd><dt class="description"> + <!--l. 14535--><p class="noindent" > <span class="cmtt-10">shortpluralaccess</span><a - id="dx1-172040"></a> </dt><dd + id="dx1-175040"></a> </p></dt><dd class="description"> - The + <!--l. 14535--><p class="noindent" >The + + replacement text corresponding @@ -28015,19 +29519,20 @@ class="description"> the <span class="cmtt-10">shortplural</span><a - id="dx1-172041"></a> + id="dx1-175041"></a> key (used by <span class="cmtt-10">\newacronym</span><a - id="dx1-172042"></a>). - </dd><dt class="description"> + id="dx1-175042"></a>). + </p></dd><dt class="description"> + <!--l. 14538--><p class="noindent" > <span class="cmtt-10">user1access</span><a - id="dx1-172043"></a> </dt><dd + id="dx1-175043"></a> </p></dt><dd class="description"> - The + <!--l. 14538--><p class="noindent" >The replacement text corresponding @@ -28035,16 +29540,15 @@ class="description"> the <span class="cmtt-10">user1</span><a - id="dx1-172044"></a> + id="dx1-175044"></a> key. - </dd><dt class="description"> - - + </p></dd><dt class="description"> + <!--l. 14541--><p class="noindent" > <span class="cmtt-10">user2access</span><a - id="dx1-172045"></a> </dt><dd + id="dx1-175045"></a> </p></dt><dd class="description"> - The + <!--l. 14541--><p class="noindent" >The replacement text corresponding @@ -28052,29 +29556,33 @@ class="description"> the <span class="cmtt-10">user2</span><a - id="dx1-172046"></a> + id="dx1-175046"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14544--><p class="noindent" > <span class="cmtt-10">user3access</span><a - id="dx1-172047"></a> </dt><dd + id="dx1-175047"></a> </p></dt><dd class="description"> - The + <!--l. 14544--><p class="noindent" >The replacement text corresponding + + to the <span class="cmtt-10">user3</span><a - id="dx1-172048"></a> + id="dx1-175048"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14547--><p class="noindent" > <span class="cmtt-10">user4access</span><a - id="dx1-172049"></a> </dt><dd + id="dx1-175049"></a> </p></dt><dd class="description"> - The + <!--l. 14547--><p class="noindent" >The replacement text corresponding @@ -28082,14 +29590,15 @@ class="description"> the <span class="cmtt-10">user4</span><a - id="dx1-172050"></a> + id="dx1-175050"></a> key. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14550--><p class="noindent" > <span class="cmtt-10">user5access</span><a - id="dx1-172051"></a> </dt><dd + id="dx1-175051"></a> </p></dt><dd class="description"> - The + <!--l. 14550--><p class="noindent" >The replacement text corresponding @@ -28097,16 +29606,15 @@ class="description"> the <span class="cmtt-10">user5</span><a - id="dx1-172052"></a> + id="dx1-175052"></a> key. - </dd><dt class="description"> - - + </p></dd><dt class="description"> + <!--l. 14553--><p class="noindent" > <span class="cmtt-10">user6access</span><a - id="dx1-172053"></a> </dt><dd + id="dx1-175053"></a> </p></dt><dd class="description"> - The + <!--l. 14553--><p class="noindent" >The replacement text corresponding @@ -28114,79 +29622,85 @@ class="description"> the <span class="cmtt-10">user6</span><a - id="dx1-172054"></a> - key.</dd></dl> -<!--l. 14133--><p class="noindent" >For example: + id="dx1-175054"></a> + key.</p></dd></dl> +<!--l. 14556--><p class="noindent" >For example: </p> - <div class="verbatim" id="verbatim-404"> + <pre class="verbatim" id="verbatim-411"> \newglossaryentry{tex}{name={\TeX},description={Document - <br />preparation language},access={TeX}} -</div> -<!--l. 14137--><p class="nopar" > Now the <a +preparation language},access={TeX}} +</pre> +<!--l. 14560--><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 + id="dx1-175055"></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-405"> + <pre class="verbatim" id="verbatim-412"> \BeginAccSupp{ActualText={TeX}}\TeX\EndAccSupp{} -</div> -<!--l. 14141--><p class="nopar" > The sample file <a +</pre> +<!--l. 14564--><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. 14145--><p class="indent" > If you prefer to use <span + id="dx1-175056"></a> package. +</p><!--l. 14568--><p class="indent" > If you prefer to use <span class="cmss-10">accessibility</span><a - id="dx1-172057"></a> or <span + id="dx1-175057"></a> or <span class="cmss-10">tagpdf</span><a - id="dx1-172058"></a> instead of <span + id="dx1-175058"></a> instead of <span class="cmss-10">accsupp</span><a - id="dx1-172059"></a> then you’ll need to define <span + id="dx1-175059"></a> then you’ll need to define <span class="cmtt-10">\gls@accsupp@engine</span> and <span 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 + id="dx1-175060"></a>. See the section “Accessibility Support”in the documented code for further details. -</p><!--l. 14152--><p class="indent" > The PDF specification identifies three different types of replacement text: +</p><!--l. 14575--><p class="indent" > The PDF specification identifies three different types of replacement text: </p><dl class="description"><dt class="description"> + <!--l. 14578--><p class="noindent" > <span -class="cmbx-10">Alt</span> </dt><dd -class="description">Description of some content that’s non-textual (for example, an image). A word break is assumed +class="cmbx-10">Alt</span> </p></dt><dd +class="description"> + <!--l. 14578--><p class="noindent" >Description of some content that’s non-textual (for example, an image). A word break is assumed after the content. - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 14580--><p class="noindent" > <span -class="cmbx-10">ActualText</span> </dt><dd -class="description">A character or sequence of characters that replaces textual content (for example, a dropped - capital, a ligature or a symbol). No word break is assumed after the content. - </dd><dt class="description"> +class="cmbx-10">ActualText</span> </p></dt><dd +class="description"> + <!--l. 14580--><p class="noindent" >A character or sequence of characters that replaces textual content (for example, a dropped capital, + a ligature or a symbol). No word break is assumed after the content. + </p></dd><dt class="description"> + <!--l. 14583--><p class="noindent" > <span -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. 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” +class="cmbx-10">E</span> </p></dt><dd +class="description"> + <!--l. 14583--><p class="noindent" >Expansion of an abbreviation to avoid ambiguity (for example, “St” could be short for “saint” or + “street”).</p></dd></dl> +<!--l. 14587--><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. 14170--><p class="noindent" > -</p><!--l. 14172--><p class="indent" > If you define abbreviations with <span +</p><!--l. 14593--><p class="noindent" > +</p><!--l. 14595--><p class="indent" > If you define abbreviations with <span class="cmtt-10">\newacronym</span><a - id="dx1-172061"></a>, the <span + id="dx1-175061"></a>, the <span class="cmtt-10">shortaccess</span><a - id="dx1-172062"></a> field will automatically be set + id="dx1-175062"></a> field will automatically be set to: -</p><!--l. 14174--><p class="indent" > <hr><div title="Definition"><a - id="dx1-172063"></a> <span +</p><!--l. 14597--><p class="indent" > <hr><div title="Definition"><a + id="dx1-175063"></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. 14176--><p class="noindent" > +</p><!--l. 14599--><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 @@ -28195,23 +29709,25 @@ 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. 14182--><p class="indent" > As from <span +</p><!--l. 14605--><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 + id="dx1-175064"></a> v4.45, the helper command used to identify the replacement text depends on the field name. Previous versions just used: -</p><!--l. 14185--><p class="indent" > <hr><div title="Definition"><a - id="dx1-172065"></a> <span +</p><!--l. 14608--><p class="indent" > <hr><div title="Definition"><a + id="dx1-175065"></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. 14187--><p class="noindent" > +</p><!--l. 14610--><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. 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 +</p><!--l. 14614--><p class="indent" > As from v4.45, there’s a new helper command: + + +</p><!--l. 14615--><p class="indent" > <hr><div title="Definition"><a + id="dx1-175066"></a> <span class="cmtt-10">\glsfieldaccsupp{</span>⟨<span class="cmitt-10">replacement</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -28221,40 +29737,38 @@ 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. 14194--><p class="noindent" > +</p><!--l. 14617--><p class="noindent" > This will use <span class="cmtt-10">\gls</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">accsupp</span><a - id="dx1-172067"></a> if it’s defined otherwise it will just use <span + id="dx1-175067"></a> if it’s defined otherwise it will just use <span class="cmtt-10">\glsaccsupp</span>. There are just two of these field commands for <span class="cmtt-10">short</span><a - id="dx1-172068"></a> and <span + id="dx1-175068"></a> and <span class="cmtt-10">shortplural</span><a - id="dx1-172069"></a>: -</p><!--l. 14198--><p class="indent" > <hr><div title="Definition"><a - id="dx1-172070"></a> <span + id="dx1-175069"></a>: +</p><!--l. 14621--><p class="indent" > <hr><div title="Definition"><a + id="dx1-175070"></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. 14200--><p class="noindent" > +</p><!--l. 14623--><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. 14203--><p class="indent" > <hr><div title="Definition"><a - id="dx1-172071"></a> <span +</p><!--l. 14626--><p class="indent" > <hr><div title="Definition"><a + id="dx1-175071"></a> <span class="cmtt-10">\glsshortplaccsupp{</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. 14205--><p class="noindent" > +</p><!--l. 14628--><p class="noindent" > which just does <span class="cmtt-10">\glsshortaccsupp{</span>⟨<span class="cmti-10">replacement</span>⟩<span @@ -28266,12 +29780,13 @@ class="cmti-10">internal </span>field name (such as <span 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. 14211--><p class="indent" > Rather than explicitly using <span +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>. +</p><!--l. 14634--><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. 14213--><p class="indent" > <hr><div title="Definition"><a - id="dx1-172073"></a> <span + id="dx1-175072"></a>, these helper commands can use: +</p><!--l. 14636--><p class="indent" > <hr><div title="Definition"><a + id="dx1-175073"></a> <span class="cmtt-10">\glsaccessibility[</span>⟨<span class="cmitt-10">options</span>⟩<span class="cmtt-10">]{</span>⟨<span @@ -28281,7 +29796,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. 14215--><p class="noindent" > +</p><!--l. 14638--><p class="noindent" > where ⟨<span class="cmti-10">tag</span>⟩ is one of <span class="cmtt-10">E</span>, <span @@ -28293,7 +29808,7 @@ does: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\BeginAccSupp</span><a - id="dx1-172074"></a><span + id="dx1-175074"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">tag</span>⟩<span class="cmtt-10">={</span>⟨<span @@ -28303,123 +29818,123 @@ class="cmitt-10">options</span>⟩<span class="cmtt-10">}</span>⟨<span class="cmitt-10">content</span>⟩<span class="cmtt-10">\EndAccSupp</span><a - id="dx1-172075"></a><span + id="dx1-175075"></a><span class="cmtt-10">{}</span> </div> </div> but it also provides debugging information if <span class="cmss-10">debug</span><span class="cmtt-10">=</span><span class="cmss-10">showaccsupp</span><a - id="dx1-172076"></a> is used. If you explicitly use <span + id="dx1-175076"></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. 14227--><p class="indent" > You can define your own custom helper commands for specific fields that require them. For +<!--l. 14650--><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-406"> + <pre class="verbatim" id="verbatim-413"> \newcommand{\glssymbolaccsupp}[2]{% - <br /> \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}% - <br />} -</div> -<!--l. 14233--><p class="nopar" > This definition requires the replacement text to be specified with the hexadecimal character code. For + \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}% +} +</pre> +<!--l. 14656--><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-407"> + <pre class="verbatim" id="verbatim-414"> \newglossaryentry{int}{name={int},description={integral}, - <br />  symbol={\ensuremath{\int}},symbolaccess={222B} - <br />} -</div> -<!--l. 14240--><p class="nopar" > -</p><!--l. 14242--><p class="indent" > If you are using <a +  symbol={\ensuremath{\int}},symbolaccess={222B} +} +</pre> +<!--l. 14663--><p class="nopar" > +</p><!--l. 14665--><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 -<span id="textcolor285"><span +<span id="textcolor311"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">category</span>⟩⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">accsupp</span></span><a - id="dx1-172077"></a> and <span id="textcolor286"><span + id="dx1-175077"></a> and <span id="textcolor312"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">category</span>⟩<span class="cmtt-10">accsupp</span></span><a - id="dx1-172078"></a> and then for <span + id="dx1-175078"></a> and then for <span class="cmtt-10">\gls</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">accsupp</span><a - id="dx1-172079"></a>. For + id="dx1-175079"></a>. For example: </p> - <div class="verbatim" id="verbatim-408"> + <pre class="verbatim" id="verbatim-415"> \usepackage{siunitx} - <br />\usepackage[accsupp]{glossaries-extra} - <br />\glsnoexpandfields - <br />\newcommand{\glsxtrsymbolaccsupp}[2]{% - <br /> \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}% - <br />} - <br />\newcommand{\glsxtrunitaccsupp}[2]{\glsaccessibility{E}{#1}{#2}} - <br />\newglossaryentry{cm}{name={\si{\centi\metre}}, - <br /> access={centimetre}, - <br /> description={centimetre}, - <br /> category=unit - <br />} - <br />\newglossaryentry{int}{name={\ensuremath{\int}},access={222B}, - <br />  description={integral},category={symbol} - <br />} -</div> -<!--l. 14268--><p class="nopar" > The above uses the <span id="textcolor287"><span +\usepackage[accsupp]{glossaries-extra} +\glsnoexpandfields +\newcommand{\glsxtrsymbolaccsupp}[2]{% + \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}% +} +\newcommand{\glsxtrunitaccsupp}[2]{\glsaccessibility{E}{#1}{#2}} +\newglossaryentry{cm}{name={\si{\centi\metre}}, + access={centimetre}, + description={centimetre}, + category=unit +} +\newglossaryentry{int}{name={\ensuremath{\int}},access={222B}, +  description={integral},category={symbol} +} +</pre> +<!--l. 14691--><p class="nopar" > The above uses the <span id="textcolor313"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">category</span>⟩<span class="cmtt-10">accsupp</span></span><a - id="dx1-172080"></a> form that doesn’t include the field name. Remember that if you + id="dx1-175080"></a> form that doesn’t include the field name. Remember that if you want to supply a command specifically for the <span class="cmtt-10">name</span><a - id="dx1-172081"></a> field then it won’t be picked up by the <span + id="dx1-175081"></a> field then it won’t be picked up by the <span class="cmtt-10">text</span><a - id="dx1-172082"></a>, <span + id="dx1-175082"></a>, <span class="cmtt-10">plural</span><a - id="dx1-172083"></a>, + id="dx1-175083"></a>, <span class="cmtt-10">firstplural</span><a - id="dx1-172084"></a> and <span + id="dx1-175084"></a> and <span class="cmtt-10">first</span><a - id="dx1-172085"></a> fields. You’d need to supply them all. For example: + id="dx1-175085"></a> fields. You’d need to supply them all. For example: </p> - <div class="verbatim" id="verbatim-409"> + <pre class="verbatim" id="verbatim-416"> \newcommand{\glsnameaccsupp}[2]{% - <br /> \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}% - <br />} - <br />\newcommand{\glstextaccsupp}{\glsnameaccsupp} - <br />\newcommand{\glspluralaccsupp}{\glsnameaccsupp} - <br />\newcommand{\glsfirstaccsupp}{\glsnameaccsupp} - <br />\newcommand{\glsfirstplaccsupp}{\glsnameaccsupp} -</div> -<!--l. 14282--><p class="nopar" > -</p><!--l. 14284--><p class="indent" > See the documented code (<span + \glsaccessibility[method=hex,unicode]{ActualText}{#1}{#2}% +} +\newcommand{\glstextaccsupp}{\glsnameaccsupp} +\newcommand{\glspluralaccsupp}{\glsnameaccsupp} +\newcommand{\glsfirstaccsupp}{\glsnameaccsupp} +\newcommand{\glsfirstplaccsupp}{\glsnameaccsupp} +</pre> +<!--l. 14705--><p class="nopar" > +</p><!--l. 14707--><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 - id="dx1-172086"></a> documentation. See also the <span + id="dx1-175086"></a> documentation. See also the <span class="cmss-10">accessibility</span><a - id="dx1-172087"></a> and <span + id="dx1-175087"></a> and <span class="cmss-10">tagpdf</span><a - id="dx1-172088"></a> packages. + id="dx1-175088"></a> packages. </p> -<!--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 +<!--l. 14712--><p class="indent" > </div> +</p><!--l. 14712--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">18. <a id="sec:samples"></a>Sample Documents</h2> -</p><!--l. 14292--><p class="indent" > The <span +</p><!--l. 14715--><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 @@ -28429,7 +29944,7 @@ 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. 14300--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14723--><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> @@ -28437,153 +29952,160 @@ 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. 14307--><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. 14730--><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. 14313--><p class="indent" > The <a +</p><!--l. 14736--><p class="indent" > The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package and <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-173001"></a></a> provide some additional sample files. There are also examples in + id="dx1-176001"></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. 14317--><p class="indent" > If you prefer to use UTF-8 aware engines (<span +</p><!--l. 14740--><p class="indent" > If you prefer to use <a +href="#glo:UTF-8">UTF-8</a> 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. 14323--><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. 14746--><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 class="cmss-10">hyperref</span><a - id="dx1-173002"></a> is loaded you will get + id="dx1-176002"></a> is loaded you will get warnings about non-existent references that look something like: </p> - <div class="verbatim" id="verbatim-410"> + <pre class="verbatim" id="verbatim-417"> pdfTeX warning (dest): name{glo:aca} has been - <br />referenced but does not exist, replaced by a fixed one -</div> -<!--l. 14330--><p class="nopar" > These warnings may be ignored on the first LaTeX run. (The destinations won’t be defined until the glossary +referenced but does not exist, replaced by a fixed one +</pre> +<!--l. 14753--><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. 14334--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.1 </span> <a +<!--l. 14757--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.1 </span> <a id="sec:samplesbasic"></a>Basic</h3> <a - id="x1-174001r1"></a> -<!--l. 14337--><p class="noindent" > + id="x1-177001r1"></a> +<!--l. 14760--><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. 14337--><p class="noindent" >This document is a minimal working example. You can test your installation using this file. To create the +<!--l. 14760--><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 +<li + class="enumerate" id="x1-178002x1"> + <!--l. 14765--><p class="noindent" >Run <span 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"> + </p><!--l. 14767--><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> in a terminal or by using the relevant button or menu item in your text editor or front-end. This will create the required associated files but you will not see the glossary in the document. </p></li> - <li - class="enumerate" id="x1-175004x2">If you have Perl installed, run <a +<li + class="enumerate" id="x1-178004x2"> + <!--l. 14774--><p class="noindent" >If you have Perl installed, run <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-175005"></a></a> on the document (<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. 14353--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-178005"></a></a> on the document (<a +href="#sec:makeglossaries">§<span +class="cmbx-10">??</span>sec:makeglossaries </a><a +href="#sec:makeglossaries">Generating the + Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a>). This can be done on a terminal by typing: + </p><!--l. 14776--><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. 14357--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 14780--><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> If for some reason you want to call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-175006"></a></a> explicitly, you can do this in a terminal by typing (all on + id="dx1-178006"></a></a> explicitly, you can do this in a terminal by typing (all on one line): - - - </p><!--l. 14362--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 14785--><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> See <a -href="#sec:makeindexapp">§1.4.4 </a><a +href="#sec:makeindexapp">§<span +class="cmbx-10">??</span>sec:makeindexapp </a><a href="#sec:makeindexapp">Using <a href="#glo:makeindex"><span 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 + id="dx1-178007"></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. 14368--><p class="noindent" >Note that if the file name contains spaces, you will need to use the double-quote character to delimit the + id="dx1-178008"></a> + explicitly. + </p><!--l. 14791--><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 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 +<li + class="enumerate" id="x1-178010x3"> + <!--l. 14794--><p class="noindent" >Run <span +class="cmtt-10">minimalgls.tex </span>through LaTeX again (as step 1)</p></li></ol> +<!--l. 14796--><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. 14377--><p class="indent" > The <span +</p><!--l. 14800--><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 + id="dx1-178011"></a> package option creates a second glossary with the label <span class="cmtt-10">acronym </span>(which can be referenced with <span class="cmtt-10">\acronymtype</span>). If you decide to enable this option then there will be a second set of glossary files that need to be processed by <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-175012"></a></a>. If you use <a + id="dx1-178012"></a></a>. If you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-175013"></a></a> or <a + id="dx1-178013"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-175014"></a></a> you don’t need to worry + id="dx1-178014"></a></a> you don’t need to worry about it, as those scripts automatically detect which files need to be processed and will run <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-175015"></a></a> (or + id="dx1-178015"></a></a> (or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-175016"></a></a>) the appropriate number of times. -</p><!--l. 14387--><p class="indent" > If for some reason you don’t want to use <a + id="dx1-178016"></a></a>) the appropriate number of times. +</p><!--l. 14810--><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 + id="dx1-178017"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-175018"></a></a> and you want the + id="dx1-178018"></a></a> and you want the <span class="cmss-10">acronym</span><a - id="dx1-175019"></a> package option then the complete build process is: -</p><!--l. 14390--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-178019"></a> package option then the complete build process is: +</p><!--l. 14813--><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. 14397--><p class="indent" > There are three other files that can be used as <a +</p><!--l. 14820--><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 @@ -28592,7 +30114,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. 14402--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 14825--><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 @@ -28603,24 +30125,24 @@ loading line: </p><div class="alltt"> class="cmtt-10">\usepackage[acronym]{</span><strong><span class="cmtt-10">glossaries</span></strong><span class="cmtt-10">}</span> + + </div> </div> with: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[acronym</span><strong><span -class="cmtt-10">,</span><span id="textcolor288"><span +class="cmtt-10">,</span><span id="textcolor314"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor289"><span +class="cmtt-10">,</span><span id="textcolor315"><span class="cmtt-10">stylemods</span></span></strong><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> - - </div> </div> Note the different default package options. (You may omit the <span class="cmss-10">acronym</span><a - id="dx1-175020"></a> package option in both cases if + id="dx1-178020"></a> package option in both cases if you only want a single glossary.) The <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> package internally loads the base <span @@ -28630,44 +30152,44 @@ href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> load <span class="cmss-10">glossaries</span>). -<!--l. 14419--><p class="indent" > Next, replace: </p><div class="alltt"> +<!--l. 14842--><p class="indent" > Next, replace: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\setacronymstyle{long-short}</span> </div> </div> with: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor290"><span +<span id="textcolor316"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-175021"></a><span + id="dx1-178021"></a><span class="cmtt-10">[</span><strong><span class="cmtt-10">acronym</span></strong><span class="cmtt-10">]{long-short}</span> </div> -</div> The optional argument <span id="textcolor291"><span +</div> The optional argument <span id="textcolor317"><span class="cmss-10">acronym</span></span><a - id="dx1-175022"></a> identifies the category that this style should be applied to. The <span + id="dx1-178022"></a> identifies the category that this style should be applied to. The <span class="cmtt-10">\newacronym</span> command provided by the base <span class="cmss-10">glossaries </span>package is redefined by <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> to use <span id="textcolor292"><span +class="cmss-10">glossaries-extra</span></a> to use <span id="textcolor318"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-175023"></a> with -the category set to <span id="textcolor293"><span + id="dx1-178023"></a> with +the category set to <span id="textcolor319"><span class="cmss-10">acronym</span></span><a - id="dx1-175024"></a>. -<!--l. 14433--><p class="indent" > If you prefer to replace <span -class="cmtt-10">\newacronym </span>with <span id="textcolor294"><span + id="dx1-178024"></a>. +<!--l. 14856--><p class="indent" > If you prefer to replace <span +class="cmtt-10">\newacronym </span>with <span id="textcolor320"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-175025"></a> then the default category is <span id="textcolor295"><span + id="dx1-178025"></a> then the default category is <span id="textcolor321"><span class="cmss-10">abbreviation</span></span><a - id="dx1-175026"></a> so the + id="dx1-178026"></a> so the style should instead be: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor296"><span +<span id="textcolor322"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-175027"></a><span + id="dx1-178027"></a><span class="cmtt-10">[</span><strong><span class="cmtt-10">abbreviation</span></strong><span class="cmtt-10">]{long-short}</span> @@ -28675,107 +30197,107 @@ class="cmtt-10">]{long-short}</span> </div> This is actually the default category if the optional argument is omitted, so you can simply do: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor297"><span +<span id="textcolor323"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-175028"></a><span + id="dx1-178028"></a><span class="cmtt-10">{long-short}</span> </div> -</div> The <span id="textcolor298"><span +</div> The <span id="textcolor324"><span class="cmss-10">long-short</span></span><a - id="dx1-175029"></a> style is the default for the <span id="textcolor299"><span + id="dx1-178029"></a> style is the default for the <span id="textcolor325"><span class="cmss-10">abbreviation</span></span><a - id="dx1-175030"></a> category so you can omit this line completely if you + id="dx1-178030"></a> category so you can omit this line completely if you replace <span -class="cmtt-10">\newacronym</span>. (The default style for the <span id="textcolor300"><span +class="cmtt-10">\newacronym</span>. (The default style for the <span id="textcolor326"><span class="cmss-10">acronym</span></span><a - id="dx1-175031"></a> category is <span id="textcolor301"><span + id="dx1-178031"></a> category is <span id="textcolor327"><span class="cmss-10">short-nolong</span></span><a - id="dx1-175032"></a>, which only shows the short + id="dx1-178032"></a>, which only shows the short form on <a href="#glo:firstuse">first use</a>.) -<!--l. 14450--><p class="indent" > As mentioned earlier, the <span +<!--l. 14873--><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 + id="dx1-178033"></a> package option creates a new glossary with the label <span class="cmtt-10">acronym</span>. This is -independent of the <span id="textcolor302"><span +independent of the <span id="textcolor328"><span class="cmss-10">acronym</span></span><a - id="dx1-175034"></a> category. You can use the <span + id="dx1-178034"></a> category. You can use the <span class="cmss-10">acronym</span><a - id="dx1-175035"></a> package option with either <span + id="dx1-178035"></a> package option with either <span class="cmtt-10">\newacronym </span>or -<span id="textcolor303"><span +<span id="textcolor329"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-175036"></a>. -</p><!--l. 14455--><p class="indent" > You may instead prefer to use the <span id="textcolor304"><span + id="dx1-178036"></a>. +</p><!--l. 14878--><p class="indent" > You may instead prefer to use the <span id="textcolor330"><span class="cmss-10">abbreviations</span></span><a - id="dx1-175037"></a> package option, which creates a new glossary with the label + id="dx1-178037"></a> package option, which creates a new glossary with the label <span class="cmtt-10">abbreviations</span>: </p><div class="alltt"> + + <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor305"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor331"><span class="cmtt-10">abbreviations</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor306"><span +class="cmtt-10">,</span><span id="textcolor332"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor307"><span +class="cmtt-10">,</span><span id="textcolor333"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> - - </div> </div> This can again be used with either <span -class="cmtt-10">\newacronym </span>or <span id="textcolor308"><span +class="cmtt-10">\newacronym </span>or <span id="textcolor334"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-175038"></a>, but the file extensions are different. + id="dx1-178038"></a>, but the file extensions are different. This isn’t a problem if you are using <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-175039"></a></a> or <a + id="dx1-178039"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-175040"></a></a>. If you are explicitly calling + id="dx1-178040"></a></a>. If you are explicitly calling <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-175041"></a></a> (or <a + id="dx1-178041"></a></a> (or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-175042"></a></a>) then you need to modify the file extensions. See the <a + id="dx1-178042"></a></a>) then you need to modify the file extensions. See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details. -<!--l. 14468--><p class="indent" > If you use both the <span +<!--l. 14891--><p class="indent" > If you use both the <span class="cmss-10">acronym</span><a - id="dx1-175043"></a> and <span id="textcolor309"><span + id="dx1-178043"></a> and <span id="textcolor335"><span class="cmss-10">abbreviations</span></span><a - id="dx1-175044"></a> package options then <span + id="dx1-178044"></a> package options then <span class="cmtt-10">\newacronym </span>will default to the <span class="cmtt-10">acronym</span> -glossary and <span id="textcolor310"><span +glossary and <span id="textcolor336"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-175045"></a> will default to the <span + id="dx1-178045"></a> will default to the <span class="cmtt-10">abbreviations </span>glossary. -</p><!--l. 14473--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 14896--><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 + id="dx1-178046"></a></a></span>If you want to try <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-175047"></a></a>, you first need to convert the document to use <a + id="dx1-178047"></a></a>, you first need to convert the document to use <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> as -described above. Then add the <span id="textcolor311"><span +described above. Then add the <span id="textcolor337"><span class="cmss-10">record</span></span><a - id="dx1-175048"></a> package option. For example: </p><div class="alltt"> + id="dx1-178048"></a> package option. For example: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor312"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor338"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor313"><span +class="cmtt-10">,</span><span id="textcolor339"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor314"><span +class="cmtt-10">,</span><span id="textcolor340"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -28783,15 +30305,15 @@ class="cmtt-10">}</span> </div> </div> Next you need to convert the entry definitions into the <span class="cmtt-10">bib</span><a - id="dx1-175049"></a> format required by <a + id="dx1-178049"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-175050"></a></a>. This can easily be + id="dx1-178050"></a></a>. This can easily be done with <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-175051"></a></a>. For example: -<!--l. 14483--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-178051"></a></a>. For example: +<!--l. 14906--><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> @@ -28803,12 +30325,12 @@ class="cmtt-10">\makeglossaries</span> </div> </div> with: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor315"><span +<span id="textcolor341"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-175052"></a><span -class="cmtt-10">[</span><span id="textcolor316"><span + id="dx1-178052"></a><span +class="cmtt-10">[</span><span id="textcolor342"><span class="cmtt-10">src</span></span><a - id="dx1-175053"></a><span + id="dx1-178053"></a><span class="cmtt-10">=</span><strong><span class="cmtt-10">entries</span></strong><span class="cmtt-10">]</span> @@ -28819,74 +30341,74 @@ class="cmtt-10">\newglossaryentry </span>and <span class="cmtt-10">\newacronym </span>or <span class="cmtt-10">\newabbreviation</span>). -<!--l. 14498--><p class="indent" > The abbreviation style command must go before <span id="textcolor317"><span +<!--l. 14921--><p class="indent" > The abbreviation style command must go before <span id="textcolor343"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-175054"></a>. For example (if you are using + id="dx1-178054"></a>. For example (if you are using <span class="cmtt-10">\newacronym</span>): </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor318"><span +<span id="textcolor344"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-175055"></a><span + id="dx1-178055"></a><span class="cmtt-10">[acronym]{long-short}</span> -<br /><span id="textcolor319"><span +<br /><span id="textcolor345"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-175056"></a><span -class="cmtt-10">[</span><span id="textcolor320"><span + id="dx1-178056"></a><span +class="cmtt-10">[</span><span id="textcolor346"><span class="cmtt-10">src</span></span><a - id="dx1-175057"></a><span + id="dx1-178057"></a><span class="cmtt-10">=entries]</span> </div> </div> Finally, replace: - <div class="verbatim" id="verbatim-411"> + <pre class="verbatim" id="verbatim-418"> \printglossaries -</div> -<!--l. 14508--><p class="nopar" > with: </p><div class="alltt"> +</pre> +<!--l. 14931--><p class="nopar" > with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor321"><span +<span id="textcolor347"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-175058"></a> + id="dx1-178058"></a> </div> </div> The document build is now: -<!--l. 14514--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 14937--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex minimalgls <br />bib2gls minimalgls <br />pdflatex minimalgls <br /></pre><spacer type=vertical size=10> <br /></span> <a - id="x1-175059r2"></a> -</p><!--l. 14520--><p class="noindent" > + id="x1-178059r2"></a> +</p><!--l. 14943--><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. 14520--><p class="noindent" >This document illustrates how to load external files containing the glossary definitions. It also illustrates how to +<!--l. 14943--><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 + id="dx1-179001"></a></a> suppressed and uses <a href="#sec:glsadd"><span class="cmtt-10">\glsaddall</span><a - id="dx1-176002"></a></a> to add all the + id="dx1-179002"></a></a> to add all the entries to the glossaries without referencing each one explicitly. (Note that it’s more efficient to use <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> and <a 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 + id="dx1-179003"></a></a> if you have a large number of entries.) To create the document do: -</p><!--l. 14528--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14951--><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. 14534--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 14957--><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 @@ -28900,43 +30422,45 @@ class="cmtt-10">database2.tex</span></a>. If for some reason you want to call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-176004"></a></a> explicitly you must have a separate call for each + id="dx1-179004"></a></a> explicitly you must have a separate call for each glossary: </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-176006x1">Create the main glossary (all on one line): - <!--l. 14545--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<li + class="enumerate" id="x1-179006x1"> + <!--l. 14967--><p class="noindent" >Create the main glossary (all on one line): + </p><!--l. 14968--><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. 14549--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<li + class="enumerate" id="x1-179008x2"> + <!--l. 14971--><p class="noindent" >Create the secondary glossary (all on one line): + </p><!--l. 14972--><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> Note that both <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-176009"></a></a> and <a + id="dx1-179009"></a></a> and <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-176010"></a></a> do this all in one call, so they not only make + id="dx1-179010"></a></a> do this all in one call, so they not only make it easier because you don’t need to supply all the switches and remember all the extensions but they also call <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. 14558--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a + id="dx1-179011"></a></a> the appropriate number of times.</p></li></ol> +<!--l. 14981--><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 + id="dx1-179012"></a></a></span>If you want to switch to using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-176013"></a></a> with <a + id="dx1-179013"></a></a> with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, you can convert <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/database1.tex" ><span @@ -28945,11 +30469,11 @@ class="cmtt-10">database1.tex</span></a> and href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/database2.tex" ><span class="cmtt-10">database2.tex</span></a> to <span class="cmtt-10">bib</span><a - id="dx1-176014"></a> files using <a + id="dx1-179014"></a> files using <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-176015"></a></a>: -</p><!--l. 14562--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-179015"></a></a>: +</p><!--l. 14985--><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> @@ -28962,9 +30486,9 @@ class="cmtt-10">\documentclass{article}</span> <br /><span class="cmtt-10">\usepackage[colorlinks,plainpages=false]{hyperref}</span> <br /><span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor322"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor348"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor323"><span +class="cmtt-10">,</span><span id="textcolor349"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -28972,79 +30496,79 @@ class="cmtt-10">}</span> <br /> <br /><strong><span class="cmtt-10">\newglossary*</span><a - id="dx1-176016"></a></strong><span + id="dx1-179016"></a></strong><span class="cmtt-10">{punc}{Punctuation</span><span class="cmtt-10"> Characters}</span> <br /> -<br /><span id="textcolor324"><span +<br /><span id="textcolor350"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-176017"></a><span -class="cmtt-10">[</span><span id="textcolor325"><span + id="dx1-179017"></a><span +class="cmtt-10">[</span><span id="textcolor351"><span class="cmtt-10">src</span></span><a - id="dx1-176018"></a><span + id="dx1-179018"></a><span class="cmtt-10">={database1},</span> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor326"><span +class="cmtt-10"> </span><strong><span id="textcolor352"><span class="cmtt-10">selection</span></span><span class="cmtt-10">=all</span></strong><span -class="cmtt-10">,</span><span id="textcolor327"><span +class="cmtt-10">,</span><span id="textcolor353"><span class="cmtt-10">sort</span></span><a - id="dx1-176019"></a><span + id="dx1-179019"></a><span class="cmtt-10">=en]</span> -<br /><span id="textcolor328"><span +<br /><span id="textcolor354"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-176020"></a><span -class="cmtt-10">[</span><span id="textcolor329"><span + id="dx1-179020"></a><span +class="cmtt-10">[</span><span id="textcolor355"><span class="cmtt-10">src</span></span><a - id="dx1-176021"></a><span -class="cmtt-10">={database2},</span><strong><span id="textcolor330"><span + id="dx1-179021"></a><span +class="cmtt-10">={database2},</span><strong><span id="textcolor356"><span class="cmtt-10">type</span></span><span class="cmtt-10">=punc,</span></strong> + + <br /><span -class="cmtt-10"> </span><strong><span id="textcolor331"><span +class="cmtt-10"> </span><strong><span id="textcolor357"><span class="cmtt-10">selection</span></span><span class="cmtt-10">=all</span></strong><span -class="cmtt-10">,</span><span id="textcolor332"><span +class="cmtt-10">,</span><span id="textcolor358"><span class="cmtt-10">sort</span></span><a - id="dx1-176022"></a><span + id="dx1-179022"></a><span class="cmtt-10">=letter-case]</span> <br /> <br /><span class="cmtt-10">\begin{document}</span> -<br /><span id="textcolor333"><span +<br /><span id="textcolor359"><span class="cmtt-10">\print</span><strong><span class="cmtt-10">unsrt</span></strong><span class="cmtt-10">glossaries</span></span> <br /><span class="cmtt-10">\end{document}</span> - - </div> </div> Note that the <span class="cmss-10">nonumberlist</span><a - id="dx1-176023"></a> package option has been omitted. It’s not needed because there are no + id="dx1-179023"></a> package option has been omitted. It’s not needed because there are no locations in this amended document (whereas in the original <a href="#ex:sampleDB"><span class="cmtt-10">sampleDB.tex</span></a> locations are created with <span class="cmtt-10">\glsaddall</span>). The starred <span class="cmtt-10">\newglossary*</span><a - id="dx1-176024"></a> is used since the <a + id="dx1-179024"></a> is used since the <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-176025"></a></a>/<a + id="dx1-179025"></a></a>/<a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-176026"></a></a> extensions are now + id="dx1-179026"></a></a> extensions are now irrelevant. -<!--l. 14590--><p class="indent" > Instead of using <a +<!--l. 15013--><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 + id="dx1-179027"></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. 14592--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-179028"></a></a> when you build the document: +</p><!--l. 15015--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleDB <br />bib2gls sampleDB <br />pdflatex sampleDB @@ -29053,30 +30577,30 @@ class="cmtt-10">bib2gls</span><a Note that one <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-176029"></a></a> call processes all the indexing (rather than one call per glossary). Unlike <a + id="dx1-179029"></a></a> call processes all the indexing (rather than one call per glossary). Unlike <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-176030"></a></a> and + id="dx1-179030"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-176031"></a></a>, <a + id="dx1-179031"></a></a>, <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-176032"></a></a> processes each resource set in turn, but the resource sets aren’t linked to a specific glossary. + id="dx1-179032"></a></a> processes each resource set in turn, but the resource sets aren’t linked to a specific glossary. Multiple glossaries may be processed in a single resource set or sub-blocks of a single glossary may be processed 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. 14608--><p class="indent" > If you want letter groups, you need to use the <span id="textcolor334"><span +</p><!--l. 15031--><p class="indent" > If you want letter groups, you need to use the <span id="textcolor360"><span class="cmtt-10">--group</span></span><a - id="dx1-176033"></a> switch: -</p><!--l. 14610--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-179033"></a> switch: +</p><!--l. 15033--><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. 14615--><p class="indent" > See also <a +</p><!--l. 15038--><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 @@ -29084,54 +30608,54 @@ class="cmss-10">glossaries-extra </span>and <span class="cmtt-10">bib2gls</span>: An Introductory Guide</a> and the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-176034"></a></a> user + id="dx1-179034"></a></a> user manual. -</p><!--l. 14617--><p class="noindent" > +</p><!--l. 15040--><p class="noindent" > </p> -<!--l. 14617--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.2 </span> <a +<!--l. 15040--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.2 </span> <a id="sec:sampleacronyms"></a>Acronyms and First Use</h3> <a - id="x1-177001r3"></a> -<!--l. 14620--><p class="noindent" > + id="x1-180001r3"></a> +<!--l. 15043--><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. 14620--><p class="noindent" >This document has some sample abbreviations. It also adds the glossary to the table of contents, so an extra run +<!--l. 15043--><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"> +</p><!--l. 15047--><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 />pdflatex sampleAcr <br /></pre><spacer type=vertical size=10> - - <br /></span> (or use <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-178001"></a></a>). -</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 + id="dx1-181001"></a></a>). +</p><!--l. 15055--><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 LaTeX call are required. In + id="dx1-181002"></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. 14641--><p class="indent" > This document uses <span +</p><!--l. 15064--><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"> + id="dx1-181003"></a> to determine whether to use “a” or “an” in: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">…</span><span class="cmtt-10"> is</span><span class="cmtt-10"> \ifglsused</span><a - id="dx1-178004"></a><span + id="dx1-181004"></a><span class="cmtt-10">{svm}{an}{a}</span><span class="cmtt-10"> \gls{svm}</span><span class="cmtt-10"> </span><span @@ -29139,16 +30663,16 @@ class="cmtt-10">…</span> </div> </div> This clumsy bit of code can be tidied up with the <span class="cmss-10">glossaries-prefix</span><a - id="dx1-178005"></a> package. Since that package automatically + id="dx1-181005"></a> package. Since that package automatically loads <span class="cmss-10">glossaries </span>and passes all its options to the base package it’s possible to do a simple replacement of: - <div class="verbatim" id="verbatim-412"> + <pre class="verbatim" id="verbatim-419"> \usepackage[style=long,toc]{glossaries} -</div> -<!--l. 14652--><p class="nopar" > with: </p><div class="alltt"> +</pre> +<!--l. 15075--><p class="nopar" > with: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[style=long,toc]{</span><strong><span @@ -29160,7 +30684,7 @@ class="cmtt-10">svm </span>now needs an adjustment: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newacronym</span><a - id="dx1-178006"></a><span + id="dx1-181006"></a><span class="cmtt-10">[description={statistical</span><span class="cmtt-10"> pattern</span><span class="cmtt-10"> recognition</span> @@ -29168,7 +30692,7 @@ class="cmtt-10"> recognition</span> class="cmtt-10">technique~\protect\cite{svm}},</span> <br /><strong><span class="cmtt-10">prefixfirst={a~},prefix={an\space</span><a - id="dx1-178007"></a><span + id="dx1-181007"></a><span class="cmtt-10">}</span></strong> <br /><span class="cmtt-10">]{svm}{svm}{support</span><span @@ -29181,26 +30705,26 @@ class="cmtt-10"> machine}</span> class="cmtt-10">…</span><span class="cmtt-10"> is</span><span class="cmtt-10"> \pgls</span><a - id="dx1-178008"></a><span + id="dx1-181008"></a><span class="cmtt-10">{svm}</span><span class="cmtt-10"> </span><span class="cmtt-10">…</span> </div> </div> -<!--l. 14669--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 15092--><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 class="cmss-10">glossaries-extra</span></a>, you may want the patched version of the styles provided in <span class="cmss-10">glossary-long</span><a - id="dx1-178009"></a>, in which case you can also add <span id="textcolor335"><span + id="dx1-181009"></a>, in which case you can also add <span id="textcolor361"><span class="cmss-10">stylemods</span></span><a - id="dx1-178010"></a>: + id="dx1-181010"></a>: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor336"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor362"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,</span></strong><span class="cmtt-10">style=long]{</span><strong><span @@ -29209,41 +30733,41 @@ class="cmtt-10">}</span> </div> </div> If you want to suppress all the other glossary style packages with <span class="cmss-10">nostyles</span><a - id="dx1-178011"></a>, then you need to specify exactly + id="dx1-181011"></a>, then you need to specify exactly which package (or packages) that you do want: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[</span><strong><span -class="cmtt-10">nostyles,</span></strong><span id="textcolor337"><span +class="cmtt-10">nostyles,</span></strong><span id="textcolor363"><span class="cmtt-10">stylemods</span><strong><span class="cmtt-10">=long</span></strong></span><span class="cmtt-10">,style=long]{glossaries-extra}</span> </div> </div> (Now that <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> is being used, there are more available “long” styles in the <span id="textcolor338"><span +class="cmss-10">glossaries-extra</span></a> is being used, there are more available “long” styles in the <span id="textcolor364"><span class="cmss-10">glossary-longextra</span></span><a - id="dx1-178012"></a> package, + id="dx1-181012"></a> package, which you may prefer.) -<!--l. 14686--><p class="indent" > If you want to use <span +<!--l. 15109--><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 + id="dx1-181013"></a>, you can either load it after <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> or (with at least <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> -v1.42) you can simply use the <span id="textcolor339"><span +v1.42) you can simply use the <span id="textcolor365"><span class="cmss-10">prefix</span></span><a - id="dx1-178014"></a> package option. -</p><!--l. 14691--><p class="indent" > Note that the <span + id="dx1-181014"></a> package option. +</p><!--l. 15114--><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 + id="dx1-181015"></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. 14694--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15117--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleAcr <br />makeglossaries sampleAcr <br />pdflatex sampleAcr @@ -29255,115 +30779,115 @@ href="#glo:glossaries-extra"><span 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 LaTeX call, whereas with just the base <span + id="dx1-181016"></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 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> + id="dx1-181017"></a> package.) -</p><!--l. 14711--><p class="indent" > The other different default setting is the post-description punctuation. The base package has <span +</p><!--l. 15134--><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 - id="dx1-178018"></a> + id="dx1-181018"></a> as the default. This means that a full stop (period) is automatically inserted after the description in the glossary. The extension package has <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-178019"></a> as the default. If you want the original behaviour then you + id="dx1-181019"></a> as the default. If you want the original behaviour then you can use <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-178020"></a> or the shorter synonym <span id="textcolor340"><span + id="dx1-181020"></a> or the shorter synonym <span id="textcolor366"><span class="cmss-10">postdot</span></span><a - id="dx1-178021"></a>. -</p><!--l. 14719--><p class="indent" > The <a + id="dx1-181021"></a>. +</p><!--l. 15142--><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 -class="cmss-10">glossaries </span>package. The style now needs to be set with <span id="textcolor341"><span +class="cmss-10">glossaries </span>package. The style now needs to be set with <span id="textcolor367"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-178022"></a> instead of + id="dx1-181022"></a> instead of <span class="cmtt-10">\setacronymstyle</span><a - id="dx1-178023"></a>: </p><div class="alltt"> + id="dx1-181023"></a>: </p><div class="alltt"> <div class="obeylines-v"> -<strong><span id="textcolor342"><span +<strong><span id="textcolor368"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-178024"></a><span + id="dx1-181024"></a><span class="cmtt-10">[acronym]{long-short-sc}</span></strong> <br /><span class="cmtt-10">\newacronym</span><a - id="dx1-178025"></a><span + id="dx1-181025"></a><span class="cmtt-10">{svm}{svm}{support</span><span class="cmtt-10"> vector</span><span class="cmtt-10"> machine}</span> </div> -</div> (Note the different style name <span id="textcolor343"><span +</div> (Note the different style name <span id="textcolor369"><span class="cmss-10">long-short-sc</span></span><a - id="dx1-178026"></a> instead of <span + id="dx1-181026"></a> instead of <span class="cmss-10">long-sc-short</span><a - id="dx1-178027"></a> and the optional argument <span id="textcolor344"><span + id="dx1-181027"></a> and the optional argument <span id="textcolor370"><span class="cmss-10">acronym</span></span><a - id="dx1-178028"></a>.) If + id="dx1-181028"></a>.) If you prefer to replace <span class="cmtt-10">\newacronym</span><a - id="dx1-178029"></a> with <span id="textcolor345"><span + id="dx1-181029"></a> with <span id="textcolor371"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-178030"></a> then omit the optional argument: + id="dx1-181030"></a> then omit the optional argument: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor346"><span +<span id="textcolor372"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-178031"></a><span + id="dx1-181031"></a><span class="cmtt-10">{long-short-sc}</span> -<br /><span id="textcolor347"><span +<br /><span id="textcolor373"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-178032"></a><span + id="dx1-181032"></a><span class="cmtt-10">{svm}{svm}{support</span><span class="cmtt-10"> vector</span><span class="cmtt-10"> machine}</span> </div> -</div> (The optional argument of <span id="textcolor348"><span +</div> (The optional argument of <span id="textcolor374"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-178033"></a> is the category to which the style should be -applied. If it’s omitted, <span id="textcolor349"><span + id="dx1-181033"></a> is the category to which the style should be +applied. If it’s omitted, <span id="textcolor375"><span class="cmss-10">abbreviation</span></span><a - id="dx1-178034"></a> is assumed. You can therefore have different styles for different + id="dx1-181034"></a> is assumed. You can therefore have different styles for different categories.) -<!--l. 14740--><p class="indent" > Finally, you need to replace <span +<!--l. 15163--><p class="indent" > Finally, you need to replace <span class="cmtt-10">\acrshort</span><a - id="dx1-178035"></a>, <span + id="dx1-181035"></a>, <span class="cmtt-10">\acrlong</span><a - id="dx1-178036"></a> and <span + id="dx1-181036"></a> and <span class="cmtt-10">\acrfull</span><a - id="dx1-178037"></a> and their variants with <span id="textcolor350"><span + id="dx1-181037"></a> and their variants with <span id="textcolor376"><span class="cmtt-10">\glsxtrshort</span></span><a - id="dx1-178038"></a>, -<span id="textcolor351"><span + id="dx1-181038"></a>, +<span id="textcolor377"><span class="cmtt-10">\glsxtrlong</span></span><a - id="dx1-178039"></a> and <span id="textcolor352"><span + id="dx1-181039"></a> and <span id="textcolor378"><span class="cmtt-10">\glsxtrfull</span></span><a - id="dx1-178040"></a> etc. + id="dx1-181040"></a> etc. <a - id="x1-178041r4"></a> + id="x1-181041r4"></a> -</p><!--l. 14744--><p class="noindent" > +</p><!--l. 15167--><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. 14744--><p class="noindent" >This is similar to the previous example, except that the abbreviations have an associated description. As with +<!--l. 15167--><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. 14748--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15171--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleAcrDesc <br />makeglossaries sampleAcrDesc <br />pdflatex sampleAcrDesc @@ -29372,21 +30896,21 @@ required: <br /></span> This document uses the <span class="cmss-10">acronym</span><a - id="dx1-179001"></a> package option, which creates a new glossary used by <span + id="dx1-182001"></a> package option, which creates a new glossary used by <span class="cmtt-10">\newacronym</span>. This leaves the default <span class="cmtt-10">main </span>glossary available for general terms. However, in this case there are no general terms so the <span class="cmtt-10">main </span>glossary is redundant. The <span class="cmss-10">nomain</span><a - id="dx1-179002"></a> package option will prevent its creation. Obviously, if you decide to + id="dx1-182002"></a> package option will prevent its creation. Obviously, if you decide to add some terms with <span class="cmtt-10">\newglossaryentry </span>you will need to remove the <span class="cmss-10">nomain</span><a - id="dx1-179003"></a> option as the <span + id="dx1-182003"></a> option as the <span class="cmtt-10">main </span>glossary will now be required. -</p><!--l. 14764--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15187--><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 @@ -29397,21 +30921,21 @@ class="cmtt-10">glossaries-extra </span>in the <span class="cmtt-10">\usepackage </span>argument. Again you can omit <span class="cmss-10">toc</span><a - id="dx1-179004"></a> as this is the default for <a + id="dx1-182004"></a> as this is the default for <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. As in the previous example, you may want to use the patched styles. This document uses <span class="cmss-10">altlist</span><a - id="dx1-179005"></a> which is provided by <span + id="dx1-182005"></a> which is provided by <span class="cmss-10">glossary-list</span><a - id="dx1-179006"></a>, so -the style can be patched with <span id="textcolor353"><span + id="dx1-182006"></a>, so +the style can be patched with <span id="textcolor379"><span class="cmss-10">stylemods</span></span><a - id="dx1-179007"></a>. </p><div class="alltt"> + id="dx1-182007"></a>. </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[acronym,nomain,style=altlist</span><strong><span -class="cmtt-10">,</span><span id="textcolor354"><span +class="cmtt-10">,</span><span id="textcolor380"><span class="cmtt-10">stylemods</span></span></strong><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -29419,42 +30943,42 @@ class="cmtt-10">}</span> </div> </div> You may prefer to replace the <span class="cmss-10">acronym</span><a - id="dx1-179008"></a> option with <span id="textcolor355"><span + id="dx1-182008"></a> option with <span id="textcolor381"><span class="cmss-10">abbreviations</span></span><a - id="dx1-179009"></a>, but this will change the file + id="dx1-182009"></a>, but this will change the file extensions. If you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-179010"></a></a> or <a + id="dx1-182010"></a></a> or <a 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 + id="dx1-182011"></a></a> you don’t need to worry about it. -<!--l. 14782--><p class="indent" > Again the style command needs to be changed: </p><div class="alltt"> +<!--l. 15205--><p class="indent" > Again the style command needs to be changed: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor356"><span +<span id="textcolor382"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-179012"></a><span + id="dx1-182012"></a><span class="cmtt-10">[acronym]{long-short-sc-desc}</span> </div> -</div> (Note the change in style name <span id="textcolor357"><span +</div> (Note the change in style name <span id="textcolor383"><span class="cmss-10">long-short-sc-desc</span></span><a - id="dx1-179013"></a> instead of <span + id="dx1-182013"></a> instead of <span class="cmss-10">long-sc-short-desc</span><a - id="dx1-179014"></a> and the optional argument -<span id="textcolor358"><span + id="dx1-182014"></a> and the optional argument +<span id="textcolor384"><span class="cmss-10">acronym</span></span><a - id="dx1-179015"></a>.) -<!--l. 14789--><p class="indent" > As with the previous example, if you prefer to use <span id="textcolor359"><span + id="dx1-182015"></a>.) +<!--l. 15212--><p class="indent" > As with the previous example, if you prefer to use <span id="textcolor385"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-179016"></a> instead of <span + id="dx1-182016"></a> instead of <span class="cmtt-10">\newacronym</span><a - id="dx1-179017"></a> then you need + id="dx1-182017"></a> then you need to omit the optional argument: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor360"><span +<span id="textcolor386"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-179018"></a><span + id="dx1-182018"></a><span class="cmtt-10">{long-short-sc-desc}</span> @@ -29463,44 +30987,44 @@ class="cmtt-10">{long-short-sc-desc}</span> <div class="obeylines-v"> <span class="cmtt-10">\renewcommand*{\glsseeitemformat</span><a - id="dx1-179019"></a><span + id="dx1-182019"></a><span class="cmtt-10">}[1]{%</span> <br /><span class="cmtt-10"> \acronymfont</span><a - id="dx1-179020"></a><span + id="dx1-182020"></a><span class="cmtt-10">{\glsentrytext</span><a - id="dx1-179021"></a><span + id="dx1-182021"></a><span class="cmtt-10">{#1}}}</span> </div> </div> to ensure that the cross-references (from the <span class="cmtt-10">see</span><a - id="dx1-179022"></a> key) use the acronym font. The new abbreviation styles don’t + id="dx1-182022"></a> key) use the acronym font. The new abbreviation styles don’t use <span class="cmtt-10">\acronymfont</span><a - id="dx1-179023"></a> so this isn’t appropriate with <a + id="dx1-182023"></a> so this isn’t appropriate with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. If you’re using at least version 1.42 of <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, you don’t need to do anything as it automatically redefines <span class="cmtt-10">\glsseeitemformat</span><a - id="dx1-179024"></a> to take the + id="dx1-182024"></a> to take the style formatting into account. If you have an earlier version you can redefine this command as follows: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\renewcommand*{\glsseeitemformat</span><a - id="dx1-179025"></a><span + id="dx1-182025"></a><span class="cmtt-10">}[1]{%</span> <br /><span class="cmtt-10"> \ifglshasshort</span><a - id="dx1-179026"></a><span -class="cmtt-10">{#1}{</span><span id="textcolor361"><span + id="dx1-182026"></a><span +class="cmtt-10">{#1}{</span><span id="textcolor387"><span class="cmtt-10">\glsfmttext</span></span><a - id="dx1-179027"></a><span -class="cmtt-10">{#1}}{</span><span id="textcolor362"><span + id="dx1-182027"></a><span +class="cmtt-10">{#1}}{</span><span id="textcolor388"><span class="cmtt-10">\glsfmtname</span></span><a - id="dx1-179028"></a><span + id="dx1-182028"></a><span class="cmtt-10">{#1}}%</span> <br /><span class="cmtt-10">}</span> @@ -29510,29 +31034,29 @@ short and long form) you can use: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\renewcommand*{\glsseeitemformat</span><a - id="dx1-179029"></a><span -class="cmtt-10">}[1]{</span><span id="textcolor363"><span + id="dx1-182029"></a><span +class="cmtt-10">}[1]{</span><span id="textcolor389"><span class="cmtt-10">\glsfmtname</span></span><a - id="dx1-179030"></a><span + id="dx1-182030"></a><span class="cmtt-10">{#1}}</span> </div> </div> -<!--l. 14819--><p class="indent" > The <a +<!--l. 15242--><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="cmss-10">glossaries-extra</span></a> package provides two additional cross-referencing keys <span id="textcolor390"><span id="textcolor391"><span class="cmtt-10">seealso</span></span><a - id="dx1-179031"></a></span> and <span id="textcolor366"><span id="textcolor367"><span + id="dx1-182031"></a></span> and <span id="textcolor392"><span id="textcolor393"><span class="cmtt-10">alias</span></span><a - id="dx1-179032"></a></span>, so <span + id="dx1-182032"></a></span>, so <span class="cmtt-10">see</span><a - id="dx1-179033"></a><span + id="dx1-182033"></a><span class="cmtt-10">={[see</span> <span class="cmtt-10">also]{svm}} </span>can be replaced with a more appropriate key: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newacronym</span><a - id="dx1-179034"></a><span + id="dx1-182034"></a><span class="cmtt-10">[description={Statistical</span><span class="cmtt-10"> pattern</span><span class="cmtt-10"> recognition</span> @@ -29542,9 +31066,9 @@ class="cmtt-10"> using</span><span class="cmtt-10"> the</span><span class="cmtt-10"> ``kernel</span><span class="cmtt-10"> trick''},</span> -<br /><strong><span id="textcolor368"><span id="textcolor369"><span +<br /><strong><span id="textcolor394"><span id="textcolor395"><span class="cmtt-10">seealso</span></span><a - id="dx1-179035"></a></span><span + id="dx1-182035"></a></span><span class="cmtt-10">={svm}</span></strong><span class="cmtt-10">,</span> <br /><span @@ -29554,41 +31078,41 @@ class="cmtt-10"> vector</span><span class="cmtt-10"> machine}</span> </div> </div> -<!--l. 14830--><p class="indent" > Finally, as with the previous example, you need to replace <span +<!--l. 15253--><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 + id="dx1-182036"></a>, <span class="cmtt-10">\acrlong</span><a - id="dx1-179037"></a> and <span + id="dx1-182037"></a> and <span class="cmtt-10">\acrfull</span><a - id="dx1-179038"></a> etc with -<span id="textcolor370"><span + id="dx1-182038"></a> etc with +<span id="textcolor396"><span class="cmtt-10">\glsxtrshort</span></span><a - id="dx1-179039"></a>, <span id="textcolor371"><span + id="dx1-182039"></a>, <span id="textcolor397"><span class="cmtt-10">\glsxtrlong</span></span><a - id="dx1-179040"></a> and <span id="textcolor372"><span + id="dx1-182040"></a> and <span id="textcolor398"><span class="cmtt-10">\glsxtrfull</span></span><a - id="dx1-179041"></a> etc. -</p><!--l. 14834--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a + id="dx1-182041"></a> etc. +</p><!--l. 15257--><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 + id="dx1-182042"></a></a></span>If you want to convert this document so that it uses <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-179043"></a></a>, you first need to convert it to use + id="dx1-182043"></a></a>, you first need to convert it to use <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, as above, but remember that you now need the <span id="textcolor373"><span +class="cmss-10">glossaries-extra</span></a>, as above, but remember that you now need the <span id="textcolor399"><span class="cmss-10">record</span></span><a - id="dx1-179044"></a> option: </p><div class="alltt"> + id="dx1-182044"></a> option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[acronym,nomain,style=altlist,</span><strong><span id="textcolor374"><span +class="cmtt-10">\usepackage[acronym,nomain,style=altlist,</span><strong><span id="textcolor400"><span class="cmtt-10">record</span></span><span -class="cmtt-10">,</span><span id="textcolor375"><span +class="cmtt-10">,</span><span id="textcolor401"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor376"><span +class="cmtt-10">,</span><span id="textcolor402"><span class="cmtt-10">stylemods</span></span></strong><span class="cmtt-10">]</span> <br /><span @@ -29598,26 +31122,26 @@ class="cmtt-10">}</span> </div> </div> Now you need to convert the abbreviation definitions to the <span class="cmtt-10">bib</span><a - id="dx1-179045"></a> format required by <a + id="dx1-182045"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-179046"></a></a>. This can be done + id="dx1-182046"></a></a>. This can be done with: -<!--l. 14844--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 15267--><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> If you retained <span class="cmtt-10">\newacronym</span><a - id="dx1-179047"></a> from the original example file, then the new <span + id="dx1-182047"></a> from the original example file, then the new <span class="cmtt-10">entries.bib </span>file will contain entries -defined with <span id="textcolor377"><span +defined with <span id="textcolor403"><span class="cmtt-10">@acronym</span></span><a - id="dx1-179048"></a>. For example: </p><div class="alltt"> + id="dx1-182048"></a>. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor378"><span +<span id="textcolor404"><span class="cmtt-10">@acronym</span></span><a - id="dx1-179049"></a><span + id="dx1-182049"></a><span class="cmtt-10">{ksvm,</span> <br /><span class="cmtt-10"> </span><span @@ -29635,7 +31159,7 @@ class="cmtt-10"> ``kernel</span><span class="cmtt-10"> trick''},</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor379"><span +class="cmtt-10"> </span><span id="textcolor405"><span class="cmtt-10">seealso</span></span><span class="cmtt-10"> =</span><span class="cmtt-10"> {svm},</span> @@ -29655,159 +31179,159 @@ class="cmtt-10"> machine}</span> <br /><span class="cmtt-10">}</span> </div> -</div> If you switched to <span id="textcolor380"><span +</div> If you switched to <span id="textcolor406"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-179050"></a> then the entries will instead be defined with <span id="textcolor381"><span + id="dx1-182050"></a> then the entries will instead be defined with <span id="textcolor407"><span class="cmtt-10">@abbreviation</span></span><a - id="dx1-179051"></a>. -<!--l. 14862--><p class="indent" > Next replace <span + id="dx1-182051"></a>. +<!--l. 15285--><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"> -<strong><span id="textcolor382"><span +<strong><span id="textcolor408"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-179052"></a><span + id="dx1-182052"></a><span class="cmtt-10">[acronym]{long-short-sc-desc}</span></strong> -<br /><span id="textcolor383"><span +<br /><span id="textcolor409"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-179053"></a><span -class="cmtt-10">[</span><span id="textcolor384"><span + id="dx1-182053"></a><span +class="cmtt-10">[</span><span id="textcolor410"><span class="cmtt-10">src</span></span><a - id="dx1-179054"></a><span + id="dx1-182054"></a><span class="cmtt-10">=entries,%</span><span class="cmtt-10"> terms</span><span class="cmtt-10"> defined</span><span class="cmtt-10"> in</span><span class="cmtt-10"> entries.bib</span> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor385"><span +class="cmtt-10"> </span><strong><span id="textcolor411"><span class="cmtt-10">abbreviation-sort-fallback</span></span><span class="cmtt-10">=long</span></strong><span class="cmtt-10">]</span> </div> -</div> Another possibility is to make <span id="textcolor386"><span +</div> Another possibility is to make <span id="textcolor412"><span class="cmtt-10">@acronym</span></span><a - id="dx1-179055"></a> behave as though it was actually <span id="textcolor387"><span + id="dx1-182055"></a> behave as though it was actually <span id="textcolor413"><span class="cmtt-10">@abbreviation</span></span><a - id="dx1-179056"></a>: <div class="alltt"> + id="dx1-182056"></a>: <div class="alltt"> <div class="obeylines-v"> -<strong><span id="textcolor388"><span +<strong><span id="textcolor414"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-179057"></a><span + id="dx1-182057"></a><span class="cmtt-10">{long-short-sc-desc}</span></strong> -<br /><span id="textcolor389"><span +<br /><span id="textcolor415"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-179058"></a><span -class="cmtt-10">[</span><span id="textcolor390"><span + id="dx1-182058"></a><span +class="cmtt-10">[</span><span id="textcolor416"><span class="cmtt-10">src</span></span><a - id="dx1-179059"></a><span -class="cmtt-10">=entries,</span><span id="textcolor391"><span + id="dx1-182059"></a><span +class="cmtt-10">=entries,</span><span id="textcolor417"><span class="cmtt-10">abbreviation-sort-fallback</span></span><a - id="dx1-179060"></a><span + id="dx1-182060"></a><span class="cmtt-10">=long</span><strong><span class="cmtt-10">,</span> <br /><span class="cmtt-10"> entry-type-aliases={acronym=abbreviation}</span></strong><span class="cmtt-10">]</span> </div> -</div> Note that the category is now <span id="textcolor392"><span +</div> Note that the category is now <span id="textcolor418"><span class="cmss-10">abbreviation</span></span><a - id="dx1-179061"></a> not <span id="textcolor393"><span + id="dx1-182061"></a> not <span id="textcolor419"><span class="cmss-10">acronym</span></span><a - id="dx1-179062"></a> so the optional argument of <span id="textcolor394"><span + id="dx1-182062"></a> so the optional argument of <span id="textcolor420"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-179063"></a> + id="dx1-182063"></a> needs adjusting. -<!--l. 14879--><p class="indent" > If the <span +<!--l. 15302--><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 + id="dx1-182064"></a> field is missing (which should usually be the case), then both <span id="textcolor421"><span class="cmtt-10">@acronym</span></span><a - id="dx1-179065"></a> and <span id="textcolor396"><span + id="dx1-182065"></a> and <span id="textcolor422"><span class="cmtt-10">@abbreviation</span></span><a - id="dx1-179066"></a> will + id="dx1-182066"></a> will fallback on the <span class="cmtt-10">short</span><a - id="dx1-179067"></a> field (not the <span + id="dx1-182067"></a> field (not the <span class="cmtt-10">name</span><a - id="dx1-179068"></a> field, which is usually set by the style and therefore not visible to + id="dx1-182068"></a> field, which is usually set by the style and therefore not visible to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-179069"></a></a>). For some styles, as in this example, it’s more appropriate to sort by the long form so the fallback is + id="dx1-182069"></a></a>). For some styles, as in this example, it’s more appropriate to sort by the long form so the fallback is changed. (Remember that you will break this fallback mechanism if you explicitly set the sort value.) See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-179070"></a></a> manual for further details and other examples. -</p><!--l. 14889--><p class="indent" > Remember to delete any <span + id="dx1-182070"></a></a> manual for further details and other examples. +</p><!--l. 15312--><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 - id="dx1-179071"></a> file. Finally replace <span + id="dx1-182071"></a> file. Finally replace <span class="cmtt-10">\printglossary</span> -with <span id="textcolor397"><span +with <span id="textcolor423"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-179072"></a>. The document build is now: -</p><!--l. 14893--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-182072"></a>. The document build is now: +</p><!--l. 15316--><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. 14899--><p class="indent" > Note that it’s now much easier to revert back to the descriptionless style used in <a +</p><!--l. 15322--><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"> <div class="obeylines-v"> -<span id="textcolor398"><span +<span id="textcolor424"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-179073"></a><span + id="dx1-182073"></a><span class="cmtt-10">[acronym]{</span><strong><span class="cmtt-10">long-short-sc</span></strong><span class="cmtt-10">}</span> -<br /><span id="textcolor399"><span +<br /><span id="textcolor425"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-179074"></a><span -class="cmtt-10">[</span><span id="textcolor400"><span + id="dx1-182074"></a><span +class="cmtt-10">[</span><span id="textcolor426"><span class="cmtt-10">src</span></span><a - id="dx1-179075"></a><span + id="dx1-182075"></a><span class="cmtt-10">=entries</span><strong><span -class="cmtt-10">,</span><span id="textcolor401"><span +class="cmtt-10">,</span><span id="textcolor427"><span class="cmtt-10">ignore-fields</span></span><a - id="dx1-179076"></a><span + id="dx1-182076"></a><span class="cmtt-10">=description</span></strong><span class="cmtt-10">]</span> </div> </div> With the other options it would be necessary to delete all the <span class="cmtt-10">description</span><a - id="dx1-179077"></a> fields from the abbreviation + id="dx1-182077"></a> fields from the abbreviation definitions in order to omit them, but with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-179078"></a></a> you can simply instruct <a + id="dx1-182078"></a></a> you can simply instruct <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-179079"></a></a> to ignore the description. + id="dx1-182079"></a></a> to ignore the description. This makes it much easier to have a large database of abbreviations for use across multiple documents that may or may not require the description. <a - id="x1-179080r5"></a> -<!--l. 14912--><p class="noindent" > + id="x1-182080r5"></a> +<!--l. 15335--><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. 14912--><p class="noindent" >This is similar to the previous example, except that it defines the abbreviations using <span +<!--l. 15335--><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> + id="dx1-183001"></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 + id="dx1-183002"></a>. As with the previous example, the glossary is added to the table of contents, so an extra run through LaTeX is required: -</p><!--l. 14917--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15340--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleDesc <br />makeglossaries sampleDesc <br />pdflatex sampleDesc @@ -29816,14 +31340,14 @@ extra run through LaTeX is required: <br /></span> This sample file demonstrates the use of the <span class="cmtt-10">first</span><a - id="dx1-180003"></a> and <span + id="dx1-183003"></a> and <span class="cmtt-10">text</span><a - id="dx1-180004"></a> keys but in general it’s better to use <span + id="dx1-183004"></a> keys but in general it’s better to use <span class="cmtt-10">\newacronym</span><a - id="dx1-180005"></a> -instead as it’s more flexible. For even greater flexibility use <span id="textcolor402"><span + id="dx1-183005"></a> +instead as it’s more flexible. For even greater flexibility use <span id="textcolor428"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-180006"></a> provided by <a + id="dx1-183006"></a> provided by <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. For other variations, such as showing the symbol on <a @@ -29834,21 +31358,21 @@ class="cmss-10">glossaries-extra </span>and <span class="cmtt-10">bib2gls</span>: An Introductory Guide</a>. <a - id="x1-180007r6"></a> + id="x1-183007r6"></a> -</p><!--l. 14931--><p class="noindent" > +</p><!--l. 15354--><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. 14931--><p class="noindent" >This document has some sample abbreviations that use the <span +<!--l. 15354--><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 + id="dx1-184001"></a> acronym style. As with the previous example, the glossary is added to the table of contents, so an extra run through LaTeX is required: -</p><!--l. 14935--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15358--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleFnAcrDesc <br />makeglossaries sampleFnAcrDesc <br />pdflatex sampleFnAcrDesc @@ -29862,32 +31386,32 @@ href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, then you just need to follow the same steps as for <a href="#ex:sampleAcr"><span -class="cmtt-10">sampleAcr.tex</span></a> with a slight modification. This time the <span id="textcolor403"><span +class="cmtt-10">sampleAcr.tex</span></a> with a slight modification. This time the <span id="textcolor429"><span class="cmss-10">short-sc-footnote-desc</span></span><a - id="dx1-181002"></a> + id="dx1-184002"></a> abbreviation style is needed: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor404"><span +<span id="textcolor430"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-181003"></a><span + id="dx1-184003"></a><span class="cmtt-10">[acronym]{short-sc-footnote-desc}</span> </div> </div> The command redefinitions (performed with <span class="cmtt-10">\renewcommand</span>) should now all be deleted as they are no longer applicable. -<!--l. 14952--><p class="indent" > You may prefer to use the <span id="textcolor405"><span +<!--l. 15375--><p class="indent" > You may prefer to use the <span id="textcolor431"><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 + id="dx1-184004"></a> style instead. There are subtle differences between the +<span id="textcolor432"><span class="cmss-10">postfootnote</span></span><a - id="dx1-181005"></a> and <span id="textcolor407"><span + id="dx1-184005"></a> and <span id="textcolor433"><span class="cmss-10">footnote</span></span><a - id="dx1-181006"></a> set of styles. Try changing the abbreviation style to <span id="textcolor408"><span + id="dx1-184006"></a> set of styles. Try changing the abbreviation style to <span id="textcolor434"><span class="cmss-10">short-sc-footnote</span></span><a - id="dx1-181007"></a> and compare the + id="dx1-184007"></a> and compare the location of the footnote marker with the two styles. -</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"> +</p><!--l. 15381--><p class="indent" > This modified sample file now has a shorter build: +</p><!--l. 15382--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleFnAcrDesc <br />makeglossaries sampleFnAcrDesc <br />pdflatex sampleFnAcrDesc @@ -29898,18 +31422,18 @@ 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 LaTeX run) which adds the glossary title to the table of contents (<span class="cmtt-10">toc</span><a - id="dx1-181008"></a>) file. + id="dx1-184008"></a>) file. <a - id="x1-181009r7"></a> -</p><!--l. 14969--><p class="noindent" > + id="x1-184009r7"></a> +</p><!--l. 15392--><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. 14969--><p class="noindent" >This document has some sample abbreviations with a custom acronym style. It also adds the glossary to the +<!--l. 15392--><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"> +</p><!--l. 15395--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleCustomAcr <br />makeglossaries sampleCustomAcr @@ -29925,15 +31449,15 @@ class="cmti-10">short</span>⟩ (⟨<span class="cmti-10">long</span>⟩), and the <span class="cmtt-10">sort</span><a - id="dx1-182001"></a> key is set to the long form instead of the short form. On <a + id="dx1-185001"></a> key is set to the long form instead of the short form. On <a href="#glo:firstuse">first use</a>, the footnote text is in the form ⟨<span class="cmti-10">long</span>⟩: ⟨<span class="cmti-10">description</span>⟩ (instead of just the long form). This requires defining a new acronym style that inherits from the <span class="cmss-10">footnote-sc-desc</span><a - id="dx1-182002"></a> style. -</p><!--l. 14986--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a + id="dx1-185002"></a> style. +</p><!--l. 15409--><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 @@ -29941,9 +31465,9 @@ class="cmss-10">glossaries-extra</span></a> starts in much the same way as the p </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[acronym,nomain,</span><strong><span id="textcolor409"><span +class="cmtt-10">\usepackage[acronym,nomain,</span><strong><span id="textcolor435"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor410"><span +class="cmtt-10">,</span><span id="textcolor436"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,</span></strong><span class="cmtt-10">style=altlist]</span> @@ -29954,57 +31478,57 @@ 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. 14997--><p class="indent" > The <span id="textcolor411"><span +<!--l. 15420--><p class="indent" > The <span id="textcolor437"><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 + id="dx1-185003"></a> abbreviation style is the closest match to the requirement, so replace the <span class="cmtt-10">\setacronymstyle </span>command with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor412"><span +<span id="textcolor438"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-182004"></a><span + id="dx1-185004"></a><span class="cmtt-10">[acronym]{short-sc-footnote-desc}</span> </div> -</div> Again, you may prefer <span id="textcolor413"><span +</div> Again, you may prefer <span id="textcolor439"><span class="cmss-10">short-sc-postfootnote-desc</span></span><a - id="dx1-182005"></a>. Both styles use the same helper commands. -<!--l. 15006--><p class="indent" > Next some adjustments need to be made to fit the new requirements. The name needs to be ⟨<span + id="dx1-185005"></a>. Both styles use the same helper commands. +<!--l. 15429--><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"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor414"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor440"><span class="cmtt-10">\glsxtrfootnotedescname</span></span><a - id="dx1-182006"></a><span + id="dx1-185006"></a><span class="cmtt-10">}{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \protect</span><strong><span id="textcolor415"><span +class="cmtt-10"> \protect</span><strong><span id="textcolor441"><span class="cmtt-10">\glslongfont</span></span><a - id="dx1-182007"></a><span + id="dx1-185007"></a><span class="cmtt-10">{\the\glslongtok</span><a - id="dx1-182008"></a><span + id="dx1-185008"></a><span class="cmtt-10">}</span></strong><span class="cmtt-10">%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \protect</span><span id="textcolor416"><span +class="cmtt-10"> \protect</span><span id="textcolor442"><span class="cmtt-10">\glsxtrfullsep</span></span><a - id="dx1-182009"></a><span + id="dx1-185009"></a><span class="cmtt-10">{\the\glslabeltok</span><a - id="dx1-182010"></a><span + id="dx1-185010"></a><span class="cmtt-10">}%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \protect</span><span id="textcolor417"><span +class="cmtt-10"> \protect</span><span id="textcolor443"><span class="cmtt-10">\glsxtrparen</span></span><a - id="dx1-182011"></a><span -class="cmtt-10">{\protect</span><strong><span id="textcolor418"><span + id="dx1-185011"></a><span +class="cmtt-10">{\protect</span><strong><span id="textcolor444"><span class="cmtt-10">\glsabbrvfont</span></span><a - id="dx1-182012"></a><span + id="dx1-185012"></a><span class="cmtt-10">{\the\glsshorttok</span><a - id="dx1-182013"></a><span + id="dx1-185013"></a><span class="cmtt-10">}</span></strong><span class="cmtt-10">}%</span> <br /><span @@ -30016,21 +31540,21 @@ be expanded at that point, and make sure that the token registers that store the able to expand. Similarly the sort value needs adjusting: <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor419"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor445"><span class="cmtt-10">\glsxtrfootnotedescsort</span></span><a - id="dx1-182014"></a><span + id="dx1-185014"></a><span class="cmtt-10">}{</span><strong><span class="cmtt-10">\the\glslongtok</span><a - id="dx1-182015"></a></strong><span + id="dx1-185015"></a></strong><span class="cmtt-10">}</span> </div> </div> The footnote for all the footnote abbreviation styles is produced with: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor420"><span +<span id="textcolor446"><span class="cmtt-10">\glsxtrabbrvfootnote</span></span><a - id="dx1-182016"></a><span + id="dx1-185016"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -30044,81 +31568,81 @@ class="cmtt-10">\gls</span>, <span class="cmtt-10">\glspl </span>etc). This can simply be redefined as: <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor421"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor447"><span class="cmtt-10">\glsxtrabbrvfootnote</span></span><a - id="dx1-182017"></a><span + id="dx1-185017"></a><span class="cmtt-10">}[2]{\footnote</span><a - id="dx1-182018"></a><span + id="dx1-185018"></a><span class="cmtt-10">{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> #2:</span><span class="cmtt-10"> \glsentrydesc</span><a - id="dx1-182019"></a><span + id="dx1-185019"></a><span class="cmtt-10">{#1}}}</span> </div> </div> This will mimic the result from the original sample document. -<!--l. 15037--><p class="indent" > You may prefer to replace <span class="obeylines-h"><span class="verb"><span +<!--l. 15460--><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 -class="cmtt-10">\renewcommand*{</span><span id="textcolor422"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor448"><span class="cmtt-10">\glsxtrabbrvfootnote</span></span><a - id="dx1-182020"></a><span + id="dx1-185020"></a><span class="cmtt-10">}[2]{\footnote</span><a - id="dx1-182021"></a><span + id="dx1-185021"></a><span class="cmtt-10">{%</span> <br /><span -class="cmtt-10"> </span><span id="textcolor423"><span +class="cmtt-10"> </span><span id="textcolor449"><span class="cmtt-10">\Glsfmtlong</span></span><a - id="dx1-182022"></a><span + id="dx1-185022"></a><span class="cmtt-10">{#1}</span><span -class="cmtt-10"> (</span><span id="textcolor424"><span +class="cmtt-10"> (</span><span id="textcolor450"><span class="cmtt-10">\glsfmtshort</span></span><a - id="dx1-182023"></a><span + id="dx1-185023"></a><span class="cmtt-10">{#1}):</span><span class="cmtt-10"> \glsentrydesc</span><a - id="dx1-182024"></a><span + id="dx1-185024"></a><span class="cmtt-10">{#1}.}}</span> </div> </div> As with the earlier <a href="#ex:sampleAcrDesc"><span class="cmtt-10">sampleAcrDesc.tex</span></a>, you need to remove or change the redefinition of <span class="cmtt-10">\glsseeitemformat</span><a - id="dx1-182025"></a> + id="dx1-185025"></a> since <span class="cmtt-10">\acronymfont </span>is no longer appropriate. -<!--l. 15046--><p class="indent" > In the original <span +<!--l. 15469--><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-413"> + <pre class="verbatim" id="verbatim-420"> \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. 15053--><p class="nopar" > This leads to a capital letter after the colon in the footnote, which is undesirable, but I would like to +technique using the ``kernel trick''}, +see={[see also]{svm}}, +]{ksvm}{ksvm}{kernel support vector machine} +</pre> +<!--l. 15476--><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 -class="cmss-10">glossaries-extra</span></a>. I start the description with a lowercase letter and set the <span id="textcolor425"><span +class="cmss-10">glossaries-extra</span></a>. I start the description with a lowercase letter and set the <span id="textcolor451"><span class="cmss-10">glossdesc</span></span><a - id="dx1-182026"></a> attribute to <span + id="dx1-185026"></a> attribute to <span class="cmss-10">firstuc</span>: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor426"><span +<span id="textcolor452"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-182027"></a><span + id="dx1-185027"></a><span class="cmtt-10">{acronym}{glossdesc}{firstuc}</span> </div> </div> The abbreviation definitions are modified slightly: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newacronym</span><a - id="dx1-182028"></a><span + id="dx1-185028"></a><span class="cmtt-10">[description={</span><strong><span class="cmtt-10">s</span></strong><span class="cmtt-10">tatistical</span><span @@ -30130,9 +31654,9 @@ class="cmtt-10"> using</span><span class="cmtt-10"> the</span><span class="cmtt-10"> ``kernel</span><span class="cmtt-10"> trick''},</span> -<br /><strong><span id="textcolor427"><span id="textcolor428"><span +<br /><strong><span id="textcolor453"><span id="textcolor454"><span class="cmtt-10">seealso</span></span><a - id="dx1-182029"></a></span><span + id="dx1-185029"></a></span><span class="cmtt-10">={svm}</span></strong><span class="cmtt-10">,</span> <br /><span @@ -30141,25 +31665,25 @@ class="cmtt-10"> support</span><span class="cmtt-10"> vector</span><span class="cmtt-10"> machine}</span> </div> -</div> Note the use of the <span id="textcolor429"><span id="textcolor430"><span +</div> Note the use of the <span id="textcolor455"><span id="textcolor456"><span class="cmtt-10">seealso</span></span><a - id="dx1-182030"></a></span> key, which is only available with <a + id="dx1-185030"></a></span> key, which is only available with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>. -<!--l. 15073--><p class="indent" > If you prefer to use <span id="textcolor431"><span +<!--l. 15496--><p class="indent" > If you prefer to use <span id="textcolor457"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-182031"></a> instead of <span + id="dx1-185031"></a> instead of <span class="cmtt-10">\newacronym</span><a - id="dx1-182032"></a>, then the category needs to be <span id="textcolor432"><span + id="dx1-185032"></a>, then the category needs to be <span id="textcolor458"><span class="cmss-10">abbreviation</span></span><a - id="dx1-182033"></a> -rather than <span id="textcolor433"><span + id="dx1-185033"></a> +rather than <span id="textcolor459"><span class="cmss-10">acronym</span></span><a - id="dx1-182034"></a>: </p><div class="alltt"> + id="dx1-185034"></a>: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor434"><span +<span id="textcolor460"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-182035"></a><span + id="dx1-185035"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">abbreviation</span></strong><span class="cmtt-10">}{glossdesc}{firstuc}</span> @@ -30167,25 +31691,25 @@ class="cmtt-10">}{glossdesc}{firstuc}</span> </div> and the style command needs to be adjusted so that it omits the optional argument. For example: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor435"><span +<span id="textcolor461"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-182036"></a><span + id="dx1-185036"></a><span class="cmtt-10">{short-sc-postfootnote-desc}</span> </div> </div> <a - id="x1-182037r8"></a> + id="x1-185037r8"></a> -<!--l. 15085--><p class="noindent" > +<!--l. 15508--><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. 15085--><p class="noindent" >This example defines a custom display format that puts the description in a footnote on <a +<!--l. 15508--><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. 15088--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15511--><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 @@ -30195,142 +31719,142 @@ In order to prevent nested hyperlinks, this document uses the <span class="cmss-10">hyperfirst</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-183001"></a> package option (otherwise the + id="dx1-186001"></a> package option (otherwise the 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 + id="dx1-186002"></a></a> which would result in a nested hyperlink). -</p><!--l. 15098--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15521--><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 class="cmss-10">glossaries-extra</span></a> package has category post-link hooks that make it easier to adjust the formatting. The post-link hook is placed after the hyperlink around the <a href="#glo:linktext">link text<a - id="dx1-183003"></a></a>, so a hyperlink created by + id="dx1-186003"></a></a>, so a hyperlink created by <span class="cmtt-10">\footnote</span><a - id="dx1-183004"></a> in the post-link hook won’t cause a nested link. This means that the <span + id="dx1-186004"></a> in the post-link hook won’t cause a nested link. This means that the <span class="cmss-10">hyperfirst</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-183005"></a> option isn’t + id="dx1-186005"></a> option isn’t required: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><span id="textcolor436"><span +class="cmtt-10">\usepackage[</span><span id="textcolor462"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor437"><span +class="cmtt-10">,</span><span id="textcolor463"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 15109--><p class="indent" > <div class="important" title="Important Note"> Never use commands like <span +<!--l. 15532--><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. 15114--><p class="noindent" > -</p><!--l. 15116--><p class="indent" > In the original <span +</p><!--l. 15537--><p class="noindent" > +</p><!--l. 15539--><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 class="cmtt-10">\renewcommand*{\glsentryfmt</span><a - id="dx1-183006"></a><span + id="dx1-186006"></a><span class="cmtt-10">}{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \glsgenentryfmt</span><a - id="dx1-183007"></a> + id="dx1-186007"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \ifglsused</span><a - id="dx1-183008"></a><span + id="dx1-186008"></a><span class="cmtt-10">{\glslabel</span><a - id="dx1-183009"></a><span + id="dx1-186009"></a><span class="cmtt-10">}{}{\footnote</span><a - id="dx1-183010"></a><span + id="dx1-186010"></a><span class="cmtt-10">{\glsentrydesc</span><a - id="dx1-183011"></a><span + id="dx1-186011"></a><span class="cmtt-10">{\glslabel</span><a - id="dx1-183012"></a><span + id="dx1-186012"></a><span class="cmtt-10">}}}%</span> <br /><span class="cmtt-10">}</span> </div> </div> This can be changed to: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor438"><span +<span id="textcolor464"><span class="cmtt-10">\glsdefpostlink</span></span><a - id="dx1-183013"></a> + id="dx1-186013"></a> <br /><span class="cmtt-10">{general}%</span><span class="cmtt-10"> category</span><span class="cmtt-10"> label</span> <br /><span -class="cmtt-10">{</span><span id="textcolor439"><span +class="cmtt-10">{</span><span id="textcolor465"><span class="cmtt-10">\glsxtrifwasfirstuse</span></span><a - id="dx1-183014"></a><span + id="dx1-186014"></a><span class="cmtt-10">{\footnote</span><a - id="dx1-183015"></a><span + id="dx1-186015"></a><span class="cmtt-10">{\glsentrydesc</span><a - id="dx1-183016"></a><span + id="dx1-186016"></a><span class="cmtt-10">{\glslabel</span><a - id="dx1-183017"></a><span + id="dx1-186017"></a><span class="cmtt-10">}}}{}}</span> </div> -</div> This sets the post-link hook for the <span id="textcolor440"><span +</div> This sets the post-link hook for the <span id="textcolor466"><span class="cmss-10">general</span></span><a - id="dx1-183018"></a> category (which is the default category for entries defined with + id="dx1-186018"></a> category (which is the default category for entries defined with <span 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 + id="dx1-186019"></a>). If I added some abbreviations (which have a different category) then this change wouldn’t apply to them. -<!--l. 15135--><p class="indent" > The first paragraph in the document is: +<!--l. 15558--><p class="indent" > The first paragraph in the document is: </p> - <div class="verbatim" id="verbatim-414"> + <pre class="verbatim" id="verbatim-421"> First use: \gls{sample}. -</div> -<!--l. 15138--><p class="nopar" > So the PDF will have the word “sample” (the <a +</pre> +<!--l. 15561--><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 + id="dx1-186020"></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. 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 +</p><!--l. 15568--><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"> -<span id="textcolor441"><span +<span id="textcolor467"><span class="cmtt-10">\glsdefpostlink</span></span><a - id="dx1-183021"></a> + id="dx1-186021"></a> <br /><span class="cmtt-10">{general}%</span><span class="cmtt-10"> category</span><span class="cmtt-10"> label</span> <br /><span -class="cmtt-10">{</span><span id="textcolor442"><span +class="cmtt-10">{</span><span id="textcolor468"><span class="cmtt-10">\glsxtrifwasfirstuse</span></span><a - id="dx1-183022"></a> + id="dx1-186022"></a> <br /><span -class="cmtt-10"> {</span><span id="textcolor443"><span +class="cmtt-10"> {</span><span id="textcolor469"><span class="cmtt-10">\glsxtrdopostpunc</span></span><a - id="dx1-183023"></a><span + id="dx1-186023"></a><span class="cmtt-10">{\footnote</span><a - id="dx1-183024"></a><span + id="dx1-186024"></a><span class="cmtt-10">{\glsentrydesc</span><a - id="dx1-183025"></a><span + id="dx1-186025"></a><span class="cmtt-10">{\glslabel</span><a - id="dx1-183026"></a><span + id="dx1-186026"></a><span class="cmtt-10">}}}}%</span> <br /><span class="cmtt-10"> {}%</span> @@ -30339,40 +31863,40 @@ class="cmtt-10">}</span> </div> </div> You may prefer to use <span class="cmtt-10">\glossentrydesc</span><a - id="dx1-183027"></a> instead of <span + id="dx1-186027"></a> instead of <span class="cmtt-10">\glsentrydesc</span><a - id="dx1-183028"></a>. This will obey the <span id="textcolor444"><span + id="dx1-186028"></a>. This will obey the <span id="textcolor470"><span class="cmss-10">glossdesc</span></span><a - id="dx1-183029"></a> attribute. If + id="dx1-186029"></a> attribute. If you append <span class="cmtt-10">\glspostdescription</span><a - id="dx1-183030"></a>, you can also pick up the <span id="textcolor445"><span + id="dx1-186030"></a>, you can also pick up the <span id="textcolor471"><span class="cmss-10">postdot</span></span><a - id="dx1-183031"></a> package option. For example: + id="dx1-186031"></a> package option. For example: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor446"><span +<span id="textcolor472"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-183032"></a><span + id="dx1-186032"></a><span class="cmtt-10">{general}{glossdesc}{firstuc}</span> <br /> -<br /><span id="textcolor447"><span +<br /><span id="textcolor473"><span class="cmtt-10">\glsdefpostlink</span></span><a - id="dx1-183033"></a> + id="dx1-186033"></a> <br /><span class="cmtt-10">{general}%</span><span class="cmtt-10"> category</span><span class="cmtt-10"> label</span> <br /><span -class="cmtt-10">{</span><span id="textcolor448"><span +class="cmtt-10">{</span><span id="textcolor474"><span class="cmtt-10">\glsxtrifwasfirstuse</span></span><a - id="dx1-183034"></a> + id="dx1-186034"></a> <br /><span -class="cmtt-10"> {</span><span id="textcolor449"><span +class="cmtt-10"> {</span><span id="textcolor475"><span class="cmtt-10">\glsxtrdopostpunc</span></span><a - id="dx1-183035"></a><span + id="dx1-186035"></a><span class="cmtt-10">{\footnote</span><a - id="dx1-183036"></a><span + id="dx1-186036"></a><span class="cmtt-10">{%</span> <br /><span class="cmtt-10"> </span><span @@ -30380,12 +31904,12 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><strong><span class="cmtt-10">\glossentrydesc</span><a - id="dx1-183037"></a></strong><span + id="dx1-186037"></a></strong><span class="cmtt-10">{\glslabel</span><a - id="dx1-183038"></a><span + id="dx1-186038"></a><span class="cmtt-10">}</span><strong><span class="cmtt-10">\glspostdescription</span><a - id="dx1-183039"></a></strong><span + id="dx1-186039"></a></strong><span class="cmtt-10">}}}%</span> <br /><span class="cmtt-10"> {}%</span> @@ -30394,20 +31918,20 @@ class="cmtt-10">}</span> </div> </div> Alternatively, you could just use <span class="cmtt-10">\Glsentrydesc</span><a - id="dx1-183040"></a> and explicitly append the full stop. + id="dx1-186040"></a> and explicitly append the full stop. <a - id="x1-183041r9"></a> -<!--l. 15174--><p class="noindent" > + id="x1-186041r9"></a> +<!--l. 15597--><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. 15175--><p class="noindent" >This document illustrates how to define your own acronym style if the predefined styles don’t suit your +<!--l. 15598--><p class="noindent" >This document illustrates how to define your own acronym style if the predefined styles don’t suit your requirements. -</p><!--l. 15177--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15600--><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 @@ -30417,44 +31941,44 @@ In this case, a style is defined to show the short form in the text with the lon footnote on <a href="#glo:firstuse">first use</a>. The long form is used for the <span class="cmtt-10">sort</span><a - id="dx1-184001"></a> value. The short form is displayed in <a + id="dx1-187001"></a> value. The short form is displayed in <a href="#glo:smallcaps">small caps<a - id="dx1-184002"></a></a> in the + id="dx1-187002"></a></a> in the main part of the document but in uppercase in the list of acronyms. (So it’s a slight variation of some of the examples above.) The <span 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 + id="dx1-187003"></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. 15193--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15616--><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 -class="cmtt-10">sampleFnAcrDesc.tex</span></a>, the <span id="textcolor450"><span +class="cmtt-10">sampleFnAcrDesc.tex</span></a>, the <span id="textcolor476"><span class="cmss-10">short-sc-footnote-desc</span></span><a - id="dx1-184004"></a> and <span id="textcolor451"><span + id="dx1-187004"></a> and <span id="textcolor477"><span class="cmss-10">short-sc-postfootnote-desc</span></span><a - id="dx1-184005"></a> + id="dx1-187005"></a> abbreviation styles produce almost the required effect so one of those can be used as a starting point. However the final requirement doesn’t fit. It’s now necessary to actually define a custom abbreviation -style, but it can mostly inherit from the <span id="textcolor452"><span +style, but it can mostly inherit from the <span id="textcolor478"><span class="cmss-10">short-sc-footnote-desc</span></span><a - id="dx1-184006"></a> or <span id="textcolor453"><span + id="dx1-187006"></a> or <span id="textcolor479"><span class="cmss-10">short-sc-postfootnote-desc</span></span><a - id="dx1-184007"></a> style: + id="dx1-187007"></a> style: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor454"><span +<span id="textcolor480"><span class="cmtt-10">\newabbreviationstyle</span></span><a - id="dx1-184008"></a><span + id="dx1-187008"></a><span class="cmtt-10">{custom-fn}%</span> <br /><span class="cmtt-10">{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor455"><span +class="cmtt-10"> </span><span id="textcolor481"><span class="cmtt-10">\GlsXtrUseAbbrStyleSetup</span></span><a - id="dx1-184009"></a><span + id="dx1-187009"></a><span class="cmtt-10">{short-sc-footnote-desc}%</span> <br /><span class="cmtt-10">}%</span> @@ -30462,26 +31986,26 @@ class="cmtt-10">}%</span> class="cmtt-10">{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor456"><span +class="cmtt-10"> </span><span id="textcolor482"><span class="cmtt-10">\GlsXtrUseAbbrStyleFmts</span></span><a - id="dx1-184010"></a><span + id="dx1-187010"></a><span class="cmtt-10">{short-sc-footnote-desc}%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \renewcommand*{</span><span id="textcolor457"><span +class="cmtt-10"> \renewcommand*{</span><span id="textcolor483"><span class="cmtt-10">\glsxtrinlinefullformat</span></span><a - id="dx1-184011"></a><span + id="dx1-187011"></a><span class="cmtt-10">}[2]{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><strong><span id="textcolor458"><span +class="cmtt-10"> </span><strong><span id="textcolor484"><span class="cmtt-10">\glsfirstlongfootnotefont</span></span><a - id="dx1-184012"></a></strong><span -class="cmtt-10">{</span><strong><span id="textcolor459"><span + id="dx1-187012"></a></strong><span +class="cmtt-10">{</span><strong><span id="textcolor485"><span class="cmtt-10">\glsaccesslong</span></span><a - id="dx1-184013"></a><span + id="dx1-187013"></a><span class="cmtt-10">{##1}</span></strong><span class="cmtt-10">%</span> <br /><span @@ -30491,35 +32015,35 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor460"><span +class="cmtt-10"> </span><span id="textcolor486"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184014"></a><span + id="dx1-187014"></a><span class="cmtt-10">##2\fi}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor461"><span +class="cmtt-10"> </span><span id="textcolor487"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184015"></a><span -class="cmtt-10">\else##2\fi</span><span id="textcolor462"><span + id="dx1-187015"></a><span +class="cmtt-10">\else##2\fi</span><span id="textcolor488"><span class="cmtt-10">\glsxtrfullsep</span></span><a - id="dx1-184016"></a><span + id="dx1-187016"></a><span class="cmtt-10">{##1}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor463"><span +class="cmtt-10"> </span><span id="textcolor489"><span class="cmtt-10">\glsxtrparen</span></span><a - id="dx1-184017"></a><span -class="cmtt-10">{</span><strong><span id="textcolor464"><span + id="dx1-187017"></a><span +class="cmtt-10">{</span><strong><span id="textcolor490"><span class="cmtt-10">\glsfirstabbrvscfont</span></span><a - id="dx1-184018"></a><span -class="cmtt-10">{</span><span id="textcolor465"><span + id="dx1-187018"></a><span +class="cmtt-10">{</span><span id="textcolor491"><span class="cmtt-10">\glsaccessshort</span></span><a - id="dx1-184019"></a><span + id="dx1-187019"></a><span class="cmtt-10">{##1}}</span></strong><span class="cmtt-10">}%</span> <br /><span @@ -30527,20 +32051,20 @@ class="cmtt-10"> </span><span class="cmtt-10"> }%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \renewcommand*{</span><span id="textcolor466"><span +class="cmtt-10"> \renewcommand*{</span><span id="textcolor492"><span class="cmtt-10">\glsxtrinlinefullplformat</span></span><a - id="dx1-184020"></a><span + id="dx1-187020"></a><span class="cmtt-10">}[2]{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><strong><span id="textcolor467"><span +class="cmtt-10"> </span><strong><span id="textcolor493"><span class="cmtt-10">\glsfirstlongfootnotefont</span></span><a - id="dx1-184021"></a></strong><span -class="cmtt-10">{</span><strong><span id="textcolor468"><span + id="dx1-187021"></a></strong><span +class="cmtt-10">{</span><strong><span id="textcolor494"><span class="cmtt-10">\glsaccesslongpl</span></span><a - id="dx1-184022"></a><span + id="dx1-187022"></a><span class="cmtt-10">{##1}</span></strong><span class="cmtt-10">%</span> <br /><span @@ -30550,34 +32074,34 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor469"><span +class="cmtt-10"> </span><span id="textcolor495"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184023"></a><span + id="dx1-187023"></a><span class="cmtt-10">##2\fi}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor470"><span +class="cmtt-10"> </span><span id="textcolor496"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184024"></a><span -class="cmtt-10">\else##2\fi</span><span id="textcolor471"><span + id="dx1-187024"></a><span +class="cmtt-10">\else##2\fi</span><span id="textcolor497"><span class="cmtt-10">\glsxtrfullsep</span></span><a - id="dx1-184025"></a><span + id="dx1-187025"></a><span class="cmtt-10">{##1}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor472"><span +class="cmtt-10"> </span><span id="textcolor498"><span class="cmtt-10">\glsxtrparen</span></span><a - id="dx1-184026"></a><span -class="cmtt-10">{</span><strong><span id="textcolor473"><span + id="dx1-187026"></a><span +class="cmtt-10">{</span><strong><span id="textcolor499"><span class="cmtt-10">\glsfirstabbrvscfont</span></span><a - id="dx1-184027"></a><span -class="cmtt-10">{</span><span id="textcolor474"><span + id="dx1-187027"></a><span +class="cmtt-10">{</span><span id="textcolor500"><span class="cmtt-10">\glsaccessshortpl</span></span><a - id="dx1-184028"></a><span + id="dx1-187028"></a><span class="cmtt-10">{##1}}</span></strong><span class="cmtt-10">}%</span> <br /><span @@ -30585,20 +32109,20 @@ class="cmtt-10"> </span><span class="cmtt-10"> }%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \renewcommand*{</span><span id="textcolor475"><span +class="cmtt-10"> \renewcommand*{</span><span id="textcolor501"><span class="cmtt-10">\Glsxtrinlinefullformat</span></span><a - id="dx1-184029"></a><span + id="dx1-187029"></a><span class="cmtt-10">}[2]{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><strong><span id="textcolor476"><span +class="cmtt-10"> </span><strong><span id="textcolor502"><span class="cmtt-10">\glsfirstlongfootnotefont</span></span><a - id="dx1-184030"></a></strong><span -class="cmtt-10">{</span><strong><span id="textcolor477"><span + id="dx1-187030"></a></strong><span +class="cmtt-10">{</span><strong><span id="textcolor503"><span class="cmtt-10">\Glsaccesslong</span></span><a - id="dx1-184031"></a><span + id="dx1-187031"></a><span class="cmtt-10">{##1}</span></strong><span class="cmtt-10">%</span> <br /><span @@ -30608,35 +32132,35 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor478"><span +class="cmtt-10"> </span><span id="textcolor504"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184032"></a><span + id="dx1-187032"></a><span class="cmtt-10">##2\fi}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor479"><span +class="cmtt-10"> </span><span id="textcolor505"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184033"></a><span -class="cmtt-10">\else##2\fi</span><span id="textcolor480"><span + id="dx1-187033"></a><span +class="cmtt-10">\else##2\fi</span><span id="textcolor506"><span class="cmtt-10">\glsxtrfullsep</span></span><a - id="dx1-184034"></a><span + id="dx1-187034"></a><span class="cmtt-10">{##1}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor481"><span +class="cmtt-10"> </span><span id="textcolor507"><span class="cmtt-10">\glsxtrparen</span></span><a - id="dx1-184035"></a><span -class="cmtt-10">{</span><strong><span id="textcolor482"><span + id="dx1-187035"></a><span +class="cmtt-10">{</span><strong><span id="textcolor508"><span class="cmtt-10">\glsfirstabbrvscfont</span></span><a - id="dx1-184036"></a><span -class="cmtt-10">{</span><span id="textcolor483"><span + id="dx1-187036"></a><span +class="cmtt-10">{</span><span id="textcolor509"><span class="cmtt-10">\glsaccessshort</span></span><a - id="dx1-184037"></a><span + id="dx1-187037"></a><span class="cmtt-10">{##1}}</span></strong><span class="cmtt-10">}%</span> <br /><span @@ -30644,20 +32168,20 @@ class="cmtt-10"> </span><span class="cmtt-10"> }%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \renewcommand*{</span><span id="textcolor484"><span +class="cmtt-10"> \renewcommand*{</span><span id="textcolor510"><span class="cmtt-10">\Glsxtrinlinefullplformat</span></span><a - id="dx1-184038"></a><span + id="dx1-187038"></a><span class="cmtt-10">}[2]{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><strong><span id="textcolor485"><span +class="cmtt-10"> </span><strong><span id="textcolor511"><span class="cmtt-10">\glsfirstlongfootnotefont</span></span><a - id="dx1-184039"></a></strong><span -class="cmtt-10">{</span><strong><span id="textcolor486"><span + id="dx1-187039"></a></strong><span +class="cmtt-10">{</span><strong><span id="textcolor512"><span class="cmtt-10">\Glsaccesslongpl</span></span><a - id="dx1-184040"></a><span + id="dx1-187040"></a><span class="cmtt-10">{##1}</span></strong><span class="cmtt-10">%</span> @@ -30669,34 +32193,34 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor487"><span +class="cmtt-10"> </span><span id="textcolor513"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184041"></a><span + id="dx1-187041"></a><span class="cmtt-10">##2\fi}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor488"><span +class="cmtt-10"> </span><span id="textcolor514"><span class="cmtt-10">\ifglsxtrinsertinside</span></span><a - id="dx1-184042"></a><span -class="cmtt-10">\else##2\fi</span><span id="textcolor489"><span + id="dx1-187042"></a><span +class="cmtt-10">\else##2\fi</span><span id="textcolor515"><span class="cmtt-10">\glsxtrfullsep</span></span><a - id="dx1-184043"></a><span + id="dx1-187043"></a><span class="cmtt-10">{##1}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor490"><span +class="cmtt-10"> </span><span id="textcolor516"><span class="cmtt-10">\glsxtrparen</span></span><a - id="dx1-184044"></a><span -class="cmtt-10">{</span><strong><span id="textcolor491"><span + id="dx1-187044"></a><span +class="cmtt-10">{</span><strong><span id="textcolor517"><span class="cmtt-10">\glsfirstabbrvscfont</span></span><a - id="dx1-184045"></a><span -class="cmtt-10">{</span><span id="textcolor492"><span + id="dx1-187045"></a><span +class="cmtt-10">{</span><span id="textcolor518"><span class="cmtt-10">\glsaccessshortpl</span></span><a - id="dx1-184046"></a><span + id="dx1-187046"></a><span class="cmtt-10">{##1}}</span></strong><span class="cmtt-10">}%</span> <br /><span @@ -30708,27 +32232,27 @@ 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. 15235--><p class="indent" > This new custom style now needs to be set: </p><div class="alltt"> +<!--l. 15658--><p class="indent" > This new custom style now needs to be set: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor493"><span +<span id="textcolor519"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-184047"></a><span + id="dx1-187047"></a><span class="cmtt-10">[acronym]{custom-fn}</span> </div> -</div> Remember that if you decide to use <span id="textcolor494"><span +</div> Remember that if you decide to use <span id="textcolor520"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-184048"></a> instead of <span + id="dx1-187048"></a> instead of <span class="cmtt-10">\newacronym</span><a - id="dx1-184049"></a> then the category will be -<span id="textcolor495"><span + id="dx1-187049"></a> then the category will be +<span id="textcolor521"><span class="cmss-10">abbreviation</span></span><a - id="dx1-184050"></a> not <span id="textcolor496"><span + id="dx1-187050"></a> not <span id="textcolor522"><span class="cmss-10">acronym</span></span><a - id="dx1-184051"></a>: <div class="alltt"> + id="dx1-187051"></a>: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor497"><span +<span id="textcolor523"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-184052"></a><span + id="dx1-187052"></a><span class="cmtt-10">{custom-fn}</span> </div> </div> This custom style simply adjusts the inline full form. There are other adjustments to be made that apply to the @@ -30737,15 +32261,15 @@ long form followed by the description. This is the same as the modification to a <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor498"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor524"><span class="cmtt-10">\glsxtrabbrvfootnote</span></span><a - id="dx1-184053"></a><span + id="dx1-187053"></a><span class="cmtt-10">}[2]{\footnote</span><a - id="dx1-184054"></a><span + id="dx1-187054"></a><span class="cmtt-10">{#2:</span> <br /><span class="cmtt-10">\glsentrydesc</span><a - id="dx1-184055"></a><span + id="dx1-187055"></a><span class="cmtt-10">{#1}.}}</span> </div> </div> As with <a @@ -30754,96 +32278,96 @@ class="cmtt-10">sampleCustomAcr.tex</span></a>, if you specifically want the sin argument. For example: <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor499"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor525"><span class="cmtt-10">\glsxtrabbrvfootnote</span></span><a - id="dx1-184056"></a><span + id="dx1-187056"></a><span class="cmtt-10">}[2]{\footnote</span><a - id="dx1-184057"></a> + id="dx1-187057"></a> <br /><span -class="cmtt-10"> {</span><span id="textcolor500"><span +class="cmtt-10"> {</span><span id="textcolor526"><span class="cmtt-10">\Glsfmtlong</span></span><a - id="dx1-184058"></a><span + id="dx1-187058"></a><span class="cmtt-10">{#1}:</span><span class="cmtt-10"> \glsentrydesc</span><a - id="dx1-184059"></a><span + id="dx1-187059"></a><span class="cmtt-10">{#1}.}}</span> </div> </div> -<!--l. 15261--><p class="indent" > The <span +<!--l. 15684--><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 + id="dx1-187060"></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 href="#glo:smallcaps">small caps<a - id="dx1-184061"></a></a> and the long form should start with + id="dx1-187061"></a></a> and the long form should start with a capital letter. </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor501"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor527"><span class="cmtt-10">\glsxtrfootnotedescname</span></span><a - id="dx1-184062"></a><span + id="dx1-187062"></a><span class="cmtt-10">}{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> \protect</span><span id="textcolor502"><span +class="cmtt-10"> \protect</span><span id="textcolor528"><span class="cmtt-10">\glsfirstlongfootnotefont</span></span><a - id="dx1-184063"></a> + id="dx1-187063"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> {\makefirstuc</span><a - id="dx1-184064"></a><span + id="dx1-187064"></a><span class="cmtt-10">{\the\glslongtok</span><a - id="dx1-184065"></a><span + id="dx1-187065"></a><span class="cmtt-10">}}</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> (\protect\MakeTextUppercase</span><a - id="dx1-184066"></a><span + id="dx1-187066"></a><span class="cmtt-10">{\the\glsshorttok</span><a - id="dx1-184067"></a><span + id="dx1-187067"></a><span class="cmtt-10">})%</span> <br /><span class="cmtt-10">}</span> </div> </div> The inherited abbreviation style uses the short form as the <span class="cmtt-10">sort</span><a - id="dx1-184068"></a> value by default. This needs to be changed to + id="dx1-187068"></a> value by default. This needs to be changed to the long form: <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\renewcommand*{</span><span id="textcolor503"><span +class="cmtt-10">\renewcommand*{</span><span id="textcolor529"><span class="cmtt-10">\glsxtrfootnotedescsort</span></span><a - id="dx1-184069"></a><span + id="dx1-187069"></a><span class="cmtt-10">}{\the</span><strong><span class="cmtt-10">\glslongtok</span><a - id="dx1-184070"></a></strong><span + id="dx1-187070"></a></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 15278--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you want to switch to using <a +<!--l. 15701--><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 + id="dx1-187071"></a></a>, remember to set the abbreviation style before the resource command and change the default sort fallback field to <span class="cmtt-10">long</span><a - id="dx1-184072"></a>, as with <a + id="dx1-187072"></a>, as with <a href="#ex:sampleAcrDesc"><span class="cmtt-10">sampleAcrDesc.tex</span></a>. </div> -</p><!--l. 15283--><p class="noindent" > +</p><!--l. 15706--><p class="noindent" > <a - id="x1-184073r10"></a> -</p><!--l. 15285--><p class="noindent" > + id="x1-187073r10"></a> +</p><!--l. 15708--><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. 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"> +<!--l. 15708--><p class="noindent" >This document illustrates how to use the base post link hook to adjust the space factor after abbreviations. +</p><!--l. 15710--><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 @@ -30851,11 +32375,11 @@ class="cmtt-10">sample-dot-abbr.tex</span></a></h4> <br /></span> This example creates a custom storage key that provides a similar function to <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span>’s</a> <span id="textcolor504"><span id="textcolor505"><span +class="cmss-10">glossaries-extra</span>’s</a> <span id="textcolor530"><span id="textcolor531"><span class="cmtt-10">category</span></span><a - id="dx1-185001"></a></span> + id="dx1-188001"></a></span> key. -</p><!--l. 15295--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15718--><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 @@ -30864,90 +32388,90 @@ using: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glsaddstoragekey</span><a - id="dx1-185002"></a><span + id="dx1-188002"></a><span class="cmtt-10">{abbrtype}{word}{\abbrtype}</span> </div> </div> can now be removed. -<!--l. 15303--><p class="indent" > The <span id="textcolor506"><span id="textcolor507"><span +<!--l. 15726--><p class="indent" > The <span id="textcolor532"><span id="textcolor533"><span class="cmtt-10">category</span></span><a - id="dx1-185003"></a></span> key is set to <span + id="dx1-188003"></a></span> key is set to <span class="cmtt-10">initials </span>for the initialisms (which are defined with the custom <span class="cmtt-10">\newacr</span> command). The abbreviation styles can be set with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor508"><span +<span id="textcolor534"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-185004"></a><span + id="dx1-188004"></a><span class="cmtt-10">[acronym]{long-short}</span> -<br /><span id="textcolor509"><span +<br /><span id="textcolor535"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-185005"></a><span + id="dx1-188005"></a><span class="cmtt-10">[initials]{long-short}</span> </div> -</div> The <span id="textcolor510"><span +</div> The <span id="textcolor536"><span class="cmss-10">discardperiod</span></span><a - id="dx1-185006"></a> attribute will discard any full stop (period) following commands like <span + id="dx1-188006"></a> attribute will discard any full stop (period) following commands like <span class="cmtt-10">\gls</span>: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor511"><span +<span id="textcolor537"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-185007"></a><span + id="dx1-188007"></a><span class="cmtt-10">{initials}{discardperiod}{true}</span> </div> -</div> (If you want to use the <span id="textcolor512"><span +</div> (If you want to use the <span id="textcolor538"><span class="cmss-10">noshortplural</span></span><a - id="dx1-185008"></a> attribute then you will also need to set the <span id="textcolor513"><span + id="dx1-188008"></a> attribute then you will also need to set the <span id="textcolor539"><span class="cmss-10">pluraldiscardperiod</span></span><a - id="dx1-185009"></a> + id="dx1-188009"></a> attribute.) -<!--l. 15318--><p class="indent" > The <a -href="#glo:firstuse">first use</a> is governed by the <span id="textcolor514"><span +<!--l. 15741--><p class="indent" > The <a +href="#glo:firstuse">first use</a> is governed by the <span id="textcolor540"><span class="cmss-10">retainfirstuseperiod</span></span><a - id="dx1-185010"></a> attribute. If set, the period won’t be discarded if it + id="dx1-188010"></a> attribute. If set, the period won’t be discarded if it follows the <a href="#glo:firstuse">first use</a> of commands like <span class="cmtt-10">\gls</span>. This is useful for styles where the <a href="#glo:firstuse">first use</a> doesn’t end with the short form. In this case, the <a -href="#glo:firstuse">first use</a> of the <span id="textcolor515"><span +href="#glo:firstuse">first use</a> of the <span id="textcolor541"><span class="cmss-10">long-short</span></span><a - id="dx1-185011"></a> style ends with a closing parenthesis, so the end of + id="dx1-188011"></a> style ends with a closing parenthesis, so the end of sentence might be clearer if the period is retained: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor516"><span +<span id="textcolor542"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-185012"></a><span + id="dx1-188012"></a><span class="cmtt-10">{initials}{retainfirstuseperiod}{true}</span> </div> </div> -<!--l. 15329--><p class="indent" > The <span id="textcolor517"><span +<!--l. 15752--><p class="indent" > The <span id="textcolor543"><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 + id="dx1-188013"></a> attribute can automatically insert dots into the short form with a final space factor adjustment: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor518"><span +<span id="textcolor544"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-185014"></a><span + id="dx1-188014"></a><span class="cmtt-10">{initials}{insertdots}{true}</span> </div> </div> -<!--l. 15335--><p class="indent" > The custom helper command defined in the example needs to be slightly modified: </p><div class="alltt"> +<!--l. 15758--><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> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor519"><span +class="cmtt-10"> </span><strong><span id="textcolor545"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-185015"></a></strong><span -class="cmtt-10">[</span><strong><span id="textcolor520"><span + id="dx1-188015"></a></strong><span +class="cmtt-10">[</span><strong><span id="textcolor546"><span class="cmtt-10">category</span></span></strong><span class="cmtt-10">=initials,#1]}</span> </div> -</div> The definitions need to be slightly modified to work with the <span id="textcolor521"><span +</div> The definitions need to be slightly modified to work with the <span id="textcolor547"><span class="cmss-10">insertdots</span></span><a - id="dx1-185016"></a> attribute: <div class="alltt"> + id="dx1-188016"></a> attribute: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newabbr{eg}{</span><strong><span @@ -30977,33 +32501,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. 15355--><p class="indent" > The “laser” definition remains unchanged: +<!--l. 15778--><p class="indent" > The “laser” definition remains unchanged: </p> - <div class="verbatim" id="verbatim-415"> + <pre class="verbatim" id="verbatim-422"> \newacronym{laser}{laser}{light amplification by stimulated - <br />emission of radiation} -</div> -<!--l. 15359--><p class="nopar" > The remaining code in the preamble must now be removed. (It will interfere with <a +emission of radiation} +</pre> +<!--l. 15782--><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. 15364--><p class="indent" > See the <a +</p><!--l. 15787--><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. 15367--><p class="noindent" > + id="x1-188017r11"></a> +</p><!--l. 15790--><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. 15367--><p class="noindent" >This document illustrates how to have different fonts for abbreviations within the style. The document build +<!--l. 15790--><p class="noindent" >This document illustrates how to have different fonts for abbreviations within the style. The document build is: -</p><!--l. 15369--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15792--><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 @@ -31013,35 +32537,35 @@ The acronym mechanism provided by the base <span class="cmss-10">glossaries </span>package isn’t well suited to having a mixture of styles. This example provides a workaround that involves defining a new storage key with <span class="cmtt-10">\glsaddstoragekey</span><a - id="dx1-186001"></a> that’s + id="dx1-189001"></a> that’s used to hold the font declaration (such as <span class="cmtt-10">\em</span>). </p> - <div class="verbatim" id="verbatim-416"> + <pre class="verbatim" id="verbatim-423"> \glsaddstoragekey{font}{}{\entryfont} -</div> -<!--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 +</pre> +<!--l. 15804--><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-417"> + <pre class="verbatim" id="verbatim-424"> \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. 15392--><p class="nopar" > This makes the <a +\newcommand*{\newupabbr}{\newacronym} +\newitabbr{eg}{e.g.}{exempli gratia} +\newupabbr{bsc}{BSc}{Bachelor of Science} +</pre> +<!--l. 15815--><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. 15397--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 15820--><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 @@ -31050,9 +32574,9 @@ class="cmtt-10">\usepackage</span> command needs adjusting: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><span id="textcolor522"><span +class="cmtt-10">\usepackage[</span><span id="textcolor548"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor523"><span +class="cmtt-10">,</span><span id="textcolor549"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -31061,87 +32585,87 @@ class="cmtt-10">}</span> </div> The custom storage key can now be removed and also the custom acronym style. Now replace the <span class="cmtt-10">\setacronymstyle</span><a - id="dx1-186002"></a> line with: <div class="alltt"> + id="dx1-189002"></a> line with: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor524"><span +<span id="textcolor550"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-186003"></a><span + id="dx1-189003"></a><span class="cmtt-10">[acronym]{long-short-em}</span> </div> </div> and change the definition of the helper commands: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newcommand*{\newitabbr}{\newacronym</span><a - id="dx1-186004"></a><span + id="dx1-189004"></a><span class="cmtt-10">}</span> <br /><span -class="cmtt-10">\newcommand*{\newupabbr}{</span><strong><span id="textcolor525"><span +class="cmtt-10">\newcommand*{\newupabbr}{</span><strong><span id="textcolor551"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-186005"></a></strong><span + id="dx1-189005"></a></strong><span class="cmtt-10">}</span> </div> </div> Note that the <span class="obeylines-h"><span class="verb"><span class="cmtt-10">font=\em,</span></span></span> part has been removed from the definition of the first command and the second -command uses <span id="textcolor526"><span +command uses <span id="textcolor552"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-186006"></a> instead of <span + id="dx1-189006"></a> instead of <span class="cmtt-10">\newacronym</span><a - id="dx1-186007"></a>. This means that <span + id="dx1-189007"></a>. This means that <span class="cmtt-10">\newitabbr </span>will default to -<span id="textcolor527"><span id="textcolor528"><span +<span id="textcolor553"><span id="textcolor554"><span class="cmtt-10">category</span></span><a - id="dx1-186008"></a></span><span + id="dx1-189008"></a></span><span class="cmtt-10">=acronym </span>and <span -class="cmtt-10">\newupabbr </span>will default to <span id="textcolor529"><span id="textcolor530"><span +class="cmtt-10">\newupabbr </span>will default to <span id="textcolor555"><span id="textcolor556"><span class="cmtt-10">category</span></span><a - id="dx1-186009"></a></span><span + id="dx1-189009"></a></span><span class="cmtt-10">=abbreviation</span>. The default style for the -<span id="textcolor531"><span +<span id="textcolor557"><span class="cmss-10">abbreviation</span></span><a - id="dx1-186010"></a> category is <span id="textcolor532"><span + id="dx1-189010"></a> category is <span id="textcolor558"><span class="cmss-10">long-short</span></span><a - id="dx1-186011"></a>, which is the required style for this example. This just means that -only the <span id="textcolor533"><span + id="dx1-189011"></a>, which is the required style for this example. This just means that +only the <span id="textcolor559"><span class="cmss-10">acronym</span></span><a - id="dx1-186012"></a> category needs to have the style set (with the above <span id="textcolor534"><span + id="dx1-189012"></a> category needs to have the style set (with the above <span id="textcolor560"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-186013"></a> + id="dx1-189013"></a> command). -<!--l. 15425--><p class="indent" > Finally, the <span +<!--l. 15848--><p class="indent" > Finally, the <span class="cmtt-10">\acrshort</span><a - id="dx1-186014"></a>, <span + id="dx1-189014"></a>, <span class="cmtt-10">\acrlong</span><a - id="dx1-186015"></a> and <span -class="cmtt-10">\acrfull </span>commands need to be replaced with <span id="textcolor535"><span + id="dx1-189015"></a> and <span +class="cmtt-10">\acrfull </span>commands need to be replaced with <span id="textcolor561"><span class="cmtt-10">\glsxtrshort</span></span><a - id="dx1-186016"></a>, -<span id="textcolor536"><span + id="dx1-189016"></a>, +<span id="textcolor562"><span class="cmtt-10">\glsxtrlong</span></span><a - id="dx1-186017"></a> and <span id="textcolor537"><span + id="dx1-189017"></a> and <span id="textcolor563"><span class="cmtt-10">\glsxtrfull</span></span><a - id="dx1-186018"></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 + id="dx1-189018"></a>. +</p><!--l. 15852--><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 -on the <span id="textcolor538"><span +on the <span id="textcolor564"><span class="cmss-10">insertdots</span></span><a - id="dx1-186019"></a> attribute). You can either remove the dots and use <span id="textcolor539"><span + id="dx1-189019"></a> attribute). You can either remove the dots and use <span id="textcolor565"><span class="cmss-10">insertdots</span></span><a - id="dx1-186020"></a> with <span id="textcolor540"><span + id="dx1-189020"></a> with <span id="textcolor566"><span class="cmss-10">discardperiod</span></span><a - id="dx1-186021"></a>: + id="dx1-189021"></a>: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor541"><span +<span id="textcolor567"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-186022"></a><span + id="dx1-189022"></a><span class="cmtt-10">{acronym}{insertdots}{true}</span> -<br /><span id="textcolor542"><span +<br /><span id="textcolor568"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-186023"></a><span + id="dx1-189023"></a><span class="cmtt-10">{acronym}{discardperiod}{true}</span> <br /> <br /><span @@ -31155,61 +32679,61 @@ class="cmtt-10">ie</span></strong><span class="cmtt-10">}{id</span><span class="cmtt-10"> est}</span> </div> -</div> Or you can manually insert the space factor adjustment and only use the <span id="textcolor543"><span +</div> Or you can manually insert the space factor adjustment and only use the <span id="textcolor569"><span class="cmss-10">discardperiod</span></span><a - id="dx1-186024"></a> attribute: + id="dx1-189024"></a> attribute: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor544"><span +<span id="textcolor570"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-186025"></a><span + id="dx1-189025"></a><span class="cmtt-10">{acronym}{discardperiod}{true}</span> <br /> <br /><span class="cmtt-10">\newitabbr{eg}{e.g.</span><strong><span class="cmtt-10">\@</span><a - id="dx1-186026"></a></strong><span + id="dx1-189026"></a></strong><span class="cmtt-10">}{exempli</span><span class="cmtt-10"> gratia}</span> <br /><span class="cmtt-10">\newitabbr{ie}{i.e.</span><strong><span class="cmtt-10">\@</span><a - id="dx1-186027"></a></strong><span + id="dx1-189027"></a></strong><span class="cmtt-10">}{id</span><span class="cmtt-10"> est}</span> </div> </div> -<!--l. 15451--><p class="indent" > You don’t have to use the <span id="textcolor545"><span +<!--l. 15874--><p class="indent" > You don’t have to use the <span id="textcolor571"><span class="cmss-10">acronym</span></span><a - id="dx1-186028"></a> category. You may prefer a different label that fits better semantically. + id="dx1-189028"></a> category. You may prefer a different label that fits better semantically. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor546"><span +<span id="textcolor572"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-186029"></a><span + id="dx1-189029"></a><span class="cmtt-10">[</span><strong><span class="cmtt-10">latinabbr</span></strong><span class="cmtt-10">]{long-short-em}</span> <br /><span class="cmtt-10">\newcommand*{\new</span><strong><span class="cmtt-10">latin</span></strong><span -class="cmtt-10">abbr}[1][]{</span><span id="textcolor547"><span +class="cmtt-10">abbr}[1][]{</span><span id="textcolor573"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-186030"></a><span -class="cmtt-10">[</span><span id="textcolor548"><span + id="dx1-189030"></a><span +class="cmtt-10">[</span><span id="textcolor574"><span class="cmtt-10">category</span></span><span class="cmtt-10">=</span><strong><span class="cmtt-10">latinabbr</span></strong><span class="cmtt-10">,#1]}</span> -<br /><span id="textcolor549"><span +<br /><span id="textcolor575"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-186031"></a><span + id="dx1-189031"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">latinabbr</span></strong><span class="cmtt-10">}{insertdots}{true}</span> -<br /><span id="textcolor550"><span +<br /><span id="textcolor576"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-186032"></a><span + id="dx1-189032"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">latinabbr</span></strong><span class="cmtt-10">}{discardperiod}{true}</span> @@ -31219,7 +32743,7 @@ class="cmtt-10">\new</span><strong><span class="cmtt-10">latin</span></strong><span class="cmtt-10">abbr{eg}{e.g.</span><strong><span class="cmtt-10">\@</span><a - id="dx1-186033"></a></strong><span + id="dx1-189033"></a></strong><span class="cmtt-10">}{exempli</span><span class="cmtt-10"> gratia}</span> <br /><span @@ -31227,19 +32751,19 @@ class="cmtt-10">\new</span><strong><span class="cmtt-10">latin</span></strong><span class="cmtt-10">abbr{ie}{i.e.</span><strong><span class="cmtt-10">\@</span><a - id="dx1-186034"></a></strong><span + id="dx1-189034"></a></strong><span class="cmtt-10">}{id</span><span class="cmtt-10"> est}</span> </div> </div> -<!--l. 15463--><p class="noindent" > +<!--l. 15886--><p class="noindent" > </p> -<!--l. 15463--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.3 </span> <a +<!--l. 15886--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.3 </span> <a id="sec:samplecounter"></a>Non-Page Locations</h3> <a - id="x1-187001r12"></a> -<!--l. 15466--><p class="noindent" > + id="x1-190001r12"></a> +<!--l. 15889--><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 @@ -31247,14 +32771,14 @@ href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples/sampleEq.t class="cmtt-10">sampleEq.tex</span></a></h4> -<!--l. 15466--><p class="noindent" >This document illustrates how to change the location to something other than the page number. In this case, +<!--l. 15889--><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 + id="dx1-191001"></a><a + id="dx1-191002"></a> environment. To create the document do: -</p><!--l. 15471--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15894--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleEq <br />makeglossaries sampleEq <br />pdflatex sampleEq @@ -31263,45 +32787,45 @@ document do: The <span class="cmss-10">glossaries </span>package provides some location formats, such as <span class="cmtt-10">\hyperrm</span><a - id="dx1-188003"></a> and <span + id="dx1-191003"></a> and <span class="cmtt-10">\hyperbf</span><a - id="dx1-188004"></a>, that allow the + id="dx1-191004"></a>, that allow the locations in the <a href="#glo:numberlist">number list<a - id="dx1-188005"></a></a> to hyperlink to the appropriate place in the document (if <span + id="dx1-191005"></a></a> to hyperlink to the appropriate place in the document (if <span class="cmss-10">hyperref</span><a - id="dx1-188006"></a> has + id="dx1-191006"></a> has been used). Since it’s not possible to include the hyperlink name in the indexing information with <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-188007"></a></a> and <a + id="dx1-191007"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-188008"></a></a>, the <span + id="dx1-191008"></a></a>, the <span class="cmss-10">glossaries </span>package has to reform the name from a prefix and the location value. -</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 +</p><!--l. 15907--><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). This means that it’s necessary to redefine <span class="cmtt-10">\theHequation</span><a - id="dx1-188009"></a> so that it has a format that fits the + id="dx1-191009"></a> so that it has a format that fits the requirement: </p> - <div class="verbatim" id="verbatim-418"> + <pre class="verbatim" id="verbatim-425"> \renewcommand*\theHequation{\theHchapter.\arabic{equation}} -</div> -<!--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 +</pre> +<!--l. 15914--><p class="nopar" > If you don’t do this, the equation locations in the glossary won’t form valid hyperlinks. +</p><!--l. 15918--><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 class="cmtt-10">sort</span><a - id="dx1-188010"></a> key. For example: </p><div class="alltt"> + id="dx1-191010"></a> key. For example: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{Gamma}{name=\ensuremath{\Gamma(z)},</span> @@ -31312,45 +32836,45 @@ class="cmtt-10">sort=Gamma</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 15503--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 15926--><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 + id="dx1-191011"></a></a></span>If you want to switch to using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-188012"></a></a>, the first change you need to make is to switch from + id="dx1-191012"></a></a>, the first change you need to make is to switch from explicitly loading <span class="cmss-10">glossaries </span>to loading <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> with the <span id="textcolor551"><span +class="cmss-10">glossaries-extra</span></a> with the <span id="textcolor577"><span class="cmss-10">record</span></span><a - id="dx1-188013"></a> package option. If <span id="textcolor552"><span + id="dx1-191013"></a> package option. If <span id="textcolor578"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">only</span></span><a - id="dx1-188014"></a> (or <span id="textcolor553"><span + id="dx1-191014"></a> (or <span id="textcolor579"><span class="cmss-10">record</span></span><a - id="dx1-188015"></a> + id="dx1-191015"></a> without a value) is used, then the above redefinition of <span -class="cmtt-10">\theHequation </span>is still required. If <span id="textcolor554"><span +class="cmtt-10">\theHequation </span>is still required. If <span id="textcolor580"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-188016"></a> is used + id="dx1-191016"></a> is used instead then the redefinition of <span -class="cmtt-10">\theHequation </span>isn’t required. You may also want to use the <span id="textcolor555"><span +class="cmtt-10">\theHequation </span>isn’t required. You may also want to use the <span id="textcolor581"><span class="cmss-10">stylemods</span></span><a - id="dx1-188017"></a> and -<span id="textcolor556"><span + id="dx1-191017"></a> and +<span id="textcolor582"><span class="cmss-10">postdot</span></span><a - id="dx1-188018"></a> options: </p><div class="alltt"> + id="dx1-191018"></a> options: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><strong><span id="textcolor557"><span +class="cmtt-10">\usepackage[</span><strong><strong><span id="textcolor583"><span class="cmtt-10">record=nameref</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor558"><span +class="cmtt-10">,</span><span id="textcolor584"><span class="cmtt-10">stylemods</span></span><span -class="cmtt-10">,</span><span id="textcolor559"><span +class="cmtt-10">,</span><span id="textcolor585"><span class="cmtt-10">postdot</span></span></strong><span class="cmtt-10">,</span> <br /><span @@ -31360,15 +32884,15 @@ class="cmtt-10">}</span> </div> </div> The entries now need to be converted into the <span class="cmtt-10">bib</span><a - id="dx1-188019"></a> format required by <a + id="dx1-191019"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-188020"></a></a>, which can be done with + id="dx1-191020"></a></a>, which can be done with <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-188021"></a></a>: -<!--l. 15519--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-191021"></a></a>: +<!--l. 15942--><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> @@ -31379,9 +32903,9 @@ class="cmtt-10">entries.bib </span>that starts: </p><div class="alltt"> class="cmtt-10">%</span><span class="cmtt-10"> Encoding:</span><span class="cmtt-10"> UTF-8</span> -<br /><span id="textcolor560"><span +<br /><span id="textcolor586"><span class="cmtt-10">@entry</span></span><a - id="dx1-188022"></a><span + id="dx1-191022"></a><span class="cmtt-10">{Gamma,</span> <br /><span class="cmtt-10"> </span><span @@ -31397,68 +32921,68 @@ class="cmtt-10"> function}</span> <br /><span class="cmtt-10">}</span> </div> -</div> You may prefer to change <span id="textcolor561"><span +</div> You may prefer to change <span id="textcolor587"><span class="cmtt-10">@entry</span></span><a - id="dx1-188023"></a> to <span id="textcolor562"><span + id="dx1-191023"></a> to <span id="textcolor588"><span class="cmtt-10">@symbol</span></span><a - id="dx1-188024"></a>. (This should be easy to do with your text editor’s search and + id="dx1-191024"></a>. (This should be easy to do with your text editor’s search and replace function.) -<!--l. 15534--><p class="indent" > Note that the <span +<!--l. 15957--><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 + id="dx1-191025"></a> key has been omitted. This is because it typically shouldn’t be used. The difference +between using <span id="textcolor589"><span class="cmtt-10">@entry</span></span><a - id="dx1-188026"></a> and <span id="textcolor564"><span + id="dx1-191026"></a> and <span id="textcolor590"><span class="cmtt-10">@symbol</span></span><a - id="dx1-188027"></a> is that with <span id="textcolor565"><span + id="dx1-191027"></a> is that with <span id="textcolor591"><span class="cmtt-10">@entry</span></span><a - id="dx1-188028"></a> the sort value will be obtained from the <span + id="dx1-191028"></a> the sort value will be obtained from the <span class="cmtt-10">name</span><a - id="dx1-188029"></a> but with -<span id="textcolor566"><span + id="dx1-191029"></a> but with +<span id="textcolor592"><span class="cmtt-10">@symbol</span></span><a - id="dx1-188030"></a> the sort value will be obtained from the label. If you explicitly use the <span + id="dx1-191030"></a> the sort value will be obtained from the label. If you explicitly use the <span class="cmtt-10">sort</span><a - id="dx1-188031"></a> key then you will break -this behaviour. (If you try this example out, notice the difference in the ordering if you switch between <span id="textcolor567"><span + id="dx1-191031"></a> key then you will break +this behaviour. (If you try this example out, notice the difference in the ordering if you switch between <span id="textcolor593"><span class="cmtt-10">@entry</span></span><a - id="dx1-188032"></a> -and <span id="textcolor568"><span + id="dx1-191032"></a> +and <span id="textcolor594"><span class="cmtt-10">@symbol</span></span><a - id="dx1-188033"></a>. See also <a + id="dx1-191033"></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. 15544--><p class="indent" > Next replace <span +</p><!--l. 15967--><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 +<strong><span id="textcolor595"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-188034"></a><span -class="cmtt-10">[</span><span id="textcolor570"><span + id="dx1-191034"></a><span +class="cmtt-10">[</span><span id="textcolor596"><span class="cmtt-10">src</span></span><a - id="dx1-188035"></a><span + id="dx1-191035"></a><span class="cmtt-10">=entries]</span></strong> </div> -</div> If you have used <span id="textcolor571"><span +</div> If you have used <span id="textcolor597"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-188036"></a> then you can remove the redefinition of <span + id="dx1-191036"></a> then you can remove the redefinition of <span 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. 15553--><p class="indent" > Finally, replace <span + id="dx1-191037"></a> file). +<!--l. 15976--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossary</span><a - id="dx1-188038"></a> with <span id="textcolor572"><span + id="dx1-191038"></a> with <span id="textcolor598"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-188039"></a>: </p><div class="alltt"> + id="dx1-191039"></a>: </p><div class="alltt"> <div class="obeylines-v"> -<strong><span id="textcolor573"><span +<strong><span id="textcolor599"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-188040"></a></strong><span + id="dx1-191040"></a></strong><span class="cmtt-10">[title={Index</span><span class="cmtt-10"> of</span><span class="cmtt-10"> Special</span><span @@ -31467,24 +32991,24 @@ class="cmtt-10"> and</span> <br /><span class="cmtt-10">Notations}]</span> </div> -</div> The rest of the document remains unchanged (unless you want to use <span id="textcolor574"><span +</div> The rest of the document remains unchanged (unless you want to use <span id="textcolor600"><span class="cmtt-10">\glsxtrfmt</span></span><a - id="dx1-188041"></a> as described in the following + id="dx1-191041"></a> as described in the following example). <a - id="x1-188042r13"></a> -<!--l. 15561--><p class="noindent" > + id="x1-191042r13"></a> +<!--l. 15984--><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. 15561--><p class="noindent" >This is similar to the previous example, but the <a +<!--l. 15984--><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 + id="dx1-192001"></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 LaTeX run is required: -</p><!--l. 15565--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 15988--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleEqPg <br />makeglossaries sampleEqPg <br />pdflatex sampleEqPg @@ -31495,64 +33019,64 @@ As with the previous example, entries are defined like this: </p> - <div class="verbatim" id="verbatim-419"> + <pre class="verbatim" id="verbatim-426"> \newglossaryentry{Gamma}{name=\ensuremath{\Gamma(z)}, - <br />description=Gamma function,sort=Gamma} -</div> -<!--l. 15575--><p class="nopar" > The <span +description=Gamma function,sort=Gamma} +</pre> +<!--l. 15998--><p class="nopar" > The <span class="cmss-10">counter</span><span class="cmtt-10">=</span><span class="cmss-10">equation</span><a - id="dx1-189002"></a> package option is used to set the default indexing counter to <span + id="dx1-192002"></a> package option is used to set the default indexing counter to <span class="cmss-10">equation</span>. This means that it has to be changed for indexing outside of any numbered equation. For example: </p> - <div class="verbatim" id="verbatim-420"> + <pre class="verbatim" id="verbatim-427"> \glslink[format=hyperbf,counter=page]{Gamma}{gamma function} -</div> -<!--l. 15582--><p class="nopar" > I’ve set the <span +</pre> +<!--l. 16005--><p class="nopar" > I’ve set the <span class="cmtt-10">format</span><a - id="dx1-189003"></a> to <span + id="dx1-192003"></a> to <span class="cmtt-10">hyperbf</span><a - id="dx1-189004"></a> to indicate that this is a primary reference. (Note that I’m using <span + id="dx1-192004"></a> to indicate that this is a primary reference. (Note that I’m using <span class="cmtt-10">\hyperbf</span><a - id="dx1-189005"></a> not + id="dx1-192005"></a> not <span class="cmtt-10">\textbf</span><a - id="dx1-189006"></a> in order to include a hyperlink in the location.) -</p><!--l. 15587--><p class="indent" > The <a + id="dx1-192006"></a> in order to include a hyperlink in the location.) +</p><!--l. 16010--><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 + id="dx1-192007"></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 class="cmtt-10">\glsdesc</span><a - id="dx1-189008"></a> instead of + id="dx1-192008"></a> instead of <span class="cmtt-10">\glslink</span><a - id="dx1-189009"></a>. If I change the entry descriptions so that they all start with a lowercase letter then I would need to + id="dx1-192009"></a>. If I change the entry descriptions so that they all start with a lowercase letter then I would need to create a custom glossary style that used <span class="cmtt-10">\Glossentrydesc</span><a - id="dx1-189010"></a> instead of <span + id="dx1-192010"></a> instead of <span class="cmtt-10">\glossentrydesc</span><a - id="dx1-189011"></a>. -</p><!--l. 15595--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a + id="dx1-192011"></a>. +</p><!--l. 16018--><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 class="cmss-10">glossaries-extra</span></a> I wouldn’t need a new glossary style. Instead I could just -use the <span id="textcolor575"><span +use the <span id="textcolor601"><span class="cmss-10">glossdesc</span></span><a - id="dx1-189012"></a> attribute to perform the case change. Remember that the first change to make is to replace + id="dx1-192012"></a> attribute to perform the case change. Remember that the first change to make is to replace <span class="cmss-10">glossaries </span>with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[style=long3colheader,</span><strong><span id="textcolor576"><span +class="cmtt-10">\usepackage[style=long3colheader,</span><strong><span id="textcolor602"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor577"><span +class="cmtt-10">,</span><span id="textcolor603"><span class="cmtt-10">stylemods</span></span></strong><span class="cmtt-10">,</span> <br /><span @@ -31576,7 +33100,7 @@ that start with a proper noun). For example: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-189013"></a><span + id="dx1-192013"></a><span class="cmtt-10">{Gamma}{name=\ensuremath{\Gamma(z)},</span> <br /><span class="cmtt-10">description=</span><strong><span @@ -31584,21 +33108,21 @@ class="cmtt-10">g</span></strong><span class="cmtt-10">amma</span><span class="cmtt-10"> function,sort=Gamma}</span> </div> -</div> The <span id="textcolor578"><span +</div> The <span id="textcolor604"><span class="cmss-10">glossdesc</span></span><a - id="dx1-189014"></a> attribute needs setting: <div class="alltt"> + id="dx1-192014"></a> attribute needs setting: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor579"><span +<span id="textcolor605"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-189015"></a><span + id="dx1-192015"></a><span class="cmtt-10">{general}{glossdesc}{firstuc}</span> </div> </div> This means that I can now use <span class="cmtt-10">\glsdesc</span><a - id="dx1-189016"></a> instead of <span + id="dx1-192016"></a> instead of <span class="cmtt-10">\glslink</span><a - id="dx1-189017"></a>. -<!--l. 15618--><p class="indent" > It’s a bit cumbersome typing <span + id="dx1-192017"></a>. +<!--l. 16041--><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 @@ -31610,9 +33134,9 @@ class="cmtt-10">* </span>or <span class="cmtt-10">+ </span>which are already in use). For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor580"><span +<span id="textcolor606"><span class="cmtt-10">\GlsXtrSetAltModifier</span></span><a - id="dx1-189018"></a><span + id="dx1-192018"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">!</span></strong><span class="cmtt-10">}{format=hyperbf,counter=page}</span> @@ -31621,13 +33145,13 @@ class="cmtt-10">}{format=hyperbf,counter=page}</span> </div> </div> Now <span class="cmtt-10">\glsdesc</span><a - id="dx1-189019"></a><strong><span + id="dx1-192019"></a><strong><span class="cmtt-10">!</span></strong><span class="cmtt-10">{Gamma} </span>is equivalent to: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glsdesc</span><a - id="dx1-189020"></a><span + id="dx1-192020"></a><span class="cmtt-10">[format=hyperbf,counter=page]{Gamma}</span> </div> </div> So the text at the start of the “Gamma Functions” chapter is now just: <div class="alltt"> @@ -31635,7 +33159,7 @@ class="cmtt-10">[format=hyperbf,counter=page]{Gamma}</span> <span class="cmtt-10">The</span><span class="cmtt-10"> \glsdesc</span><a - id="dx1-189021"></a><span + id="dx1-192021"></a><span class="cmtt-10">!{Gamma}</span><span class="cmtt-10"> is</span><span class="cmtt-10"> defined</span><span @@ -31643,46 +33167,46 @@ class="cmtt-10"> as</span> </div> </div> which is much more compact. Similar changes can be made for the other instance of <span class="cmtt-10">\glslink</span><a - id="dx1-189022"></a> where the <a + id="dx1-192022"></a> where the <a href="#glo:linktext">link text<a - id="dx1-189023"></a></a> is just the description: <div class="alltt"> + id="dx1-192023"></a></a> is just the description: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">The</span><span class="cmtt-10"> \glsdesc</span><a - id="dx1-189024"></a><span + id="dx1-192024"></a><span class="cmtt-10">!{erf}</span><span class="cmtt-10"> is</span><span class="cmtt-10"> defined</span><span class="cmtt-10"> as</span> </div> </div> -<!--l. 15643--><p class="indent" > There are three other instances of <span +<!--l. 16066--><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"> + id="dx1-192025"></a>, such as: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glslink</span><a - id="dx1-189026"></a><span + id="dx1-192026"></a><span class="cmtt-10">{Gamma}{\Gamma(x+1)}</span> </div> </div> If I just use <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\gls{Gamma}</span></span></span> then I would get Γ(<span class="cmmi-10">z</span>) as the <a href="#glo:linktext">link text<a - id="dx1-189027"></a></a>. For entries like this that represent functions + id="dx1-192027"></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. 15653--><p class="indent" > With the base <span +<!--l. 16076--><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 - id="dx1-189028"></a> field, for example: </p><div class="alltt"> + id="dx1-192028"></a> field, for example: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-189029"></a><span + id="dx1-192029"></a><span class="cmtt-10">{Gamma}{name=\ensuremath{\Gamma(z)},</span> <br /><strong><span class="cmtt-10">symbol={\ensuremath{\Gamma}},</span></strong> @@ -31694,7 +33218,7 @@ class="cmtt-10"> function,sort=Gamma}</span> <div class="obeylines-v"> <strong><span class="cmtt-10">\glssymbol</span><a - id="dx1-189030"></a></strong><span + id="dx1-192030"></a></strong><span class="cmtt-10">{Gamma}</span><strong><span class="cmtt-10">[</span></strong><span class="cmtt-10">(\Gamma(x+1))</span><strong><span @@ -31702,77 +33226,78 @@ class="cmtt-10">]</span></strong> </div> </div> (which includes the function parameter inside the <a href="#glo:linktext">link text<a - id="dx1-189031"></a></a>) or just: <div class="alltt"> + id="dx1-192031"></a></a>) or just: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glssymbol</span><a - id="dx1-189032"></a><span + id="dx1-192032"></a><span class="cmtt-10">{Gamma}(\Gamma(x+1))</span> </div> </div> (which has the function parameter after the <a href="#glo:linktext">link text<a - id="dx1-189033"></a></a>). This is a convenient approach where the extra material + id="dx1-192033"></a></a>). This is a convenient approach where the extra material 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. 15673--><p class="indent" > The <a +<!--l. 16096--><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-421"> + <pre class="verbatim" id="verbatim-428"> \newcommand{\Gammafunction}[1]{\Gamma(#1)} -</div> -<!--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 +</pre> +<!--l. 16100--><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="textcolor607"><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 -href="#tab:fieldmap">table 4.1</a>). -The default is <span + id="dx1-192034"></a> (this should be the internal field name not the key name, see +<a +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>). The default is <span class="cmtt-10">useri</span><a - id="dx1-189035"></a> which corresponds to the <span + id="dx1-192035"></a> which corresponds to the <span class="cmtt-10">user1</span><a - id="dx1-189036"></a> key. This means that the <span -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. 15686--><p class="indent" > Another approach is to store the parameterless function in the <span + id="dx1-192036"></a> key. This means that the <span +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. 16109--><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 + id="dx1-192037"></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 class="cmtt-10">\glslabel</span> within the <a href="#glo:linktext">link text<a - id="dx1-189038"></a></a>: </p><div class="alltt"> + id="dx1-192038"></a></a>: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newcommand{\entryfunc}[1]{\glsentrysymbol</span><a - id="dx1-189039"></a><span + id="dx1-192039"></a><span class="cmtt-10">{\glslabel</span><a - id="dx1-189040"></a><span + id="dx1-192040"></a><span class="cmtt-10">}(#1)}</span> </div> </div> (Obviously, this command can’t be used outside of the <a href="#glo:linktext">link text<a - id="dx1-189041"></a></a> or post-link hooks since it uses + id="dx1-192041"></a></a> or post-link hooks since it uses <span class="cmtt-10">\glslabel</span><a - id="dx1-189042"></a>.) -<!--l. 15696--><p class="indent" > So the entry now needs the parameterless function in <span + id="dx1-192042"></a>.) +<!--l. 16119--><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 + id="dx1-192043"></a> and the control sequence name of this generic command in <span class="cmtt-10">user1</span><a - id="dx1-189044"></a>. For example: </p><div class="alltt"> + id="dx1-192044"></a>. For example: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-189045"></a><span + id="dx1-192045"></a><span class="cmtt-10">{Gamma}{name=\ensuremath{\Gamma(z)},</span> <br /><strong><span class="cmtt-10">symbol={\ensuremath{\Gamma}},user1=entryfunc,</span></strong> @@ -31783,72 +33308,72 @@ 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. 15707--><p class="indent" > You may want to consider providing helper commands to make the functions easier to define. For +<!--l. 16130--><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-422"> + <pre class="verbatim" id="verbatim-429"> \newcommand{\func}[2]{#1(#2)} - <br />\newcommand{\entryfunc}[1]{\func{\glsentrysymbol{\glslabel}}{#1}} - <br />\newcommand{\newfunc}[5][]{% - <br /> \newglossaryentry{#2}{name={\ensuremath{\func{#3}{#4}}}, - <br />   symbol={#3}, - <br />   user1={entryfunc}, - <br />   description={#5}, - <br />   sort={#2},#1 - <br /> }% - <br />} -</div> -<!--l. 15720--><p class="nopar" > The entries can now be defined using this custom <span +\newcommand{\entryfunc}[1]{\func{\glsentrysymbol{\glslabel}}{#1}} +\newcommand{\newfunc}[5][]{% + \newglossaryentry{#2}{name={\ensuremath{\func{#3}{#4}}}, +   symbol={#3}, +   user1={entryfunc}, +   description={#5}, +   sort={#2},#1 + }% +} +</pre> +<!--l. 16143--><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-423"> + <pre class="verbatim" id="verbatim-430"> \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. 15729--><p class="nopar" > -</p><!--l. 15731--><p class="indent" > Note that in <span +\newfunc[sort=gamma1]{gamma}{\gamma}{\alpha,x}{lower +  incomplete gamma function} +\newfunc[sort=Gamma2]{iGamma}{\Gamma}{\alpha,x}{upper +  incomplete gamma function} +</pre> +<!--l. 16152--><p class="nopar" > +</p><!--l. 16154--><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 + id="dx1-192046"></a> key doesn’t have its value encapsulated with <span class="cmtt-10">\ensuremath</span><a - id="dx1-189047"></a> so <span + id="dx1-192047"></a> so <span class="cmtt-10">\glssymbol</span> will need to explicitly be placed in math mode. If you switch to a glossary style that displays the symbol, you will either need to adjust the definition of <span class="cmtt-10">\newfunc </span>to use <span class="cmtt-10">\ensuremath</span><a - id="dx1-189048"></a> in the <span + id="dx1-192048"></a> in the <span class="cmtt-10">symbol</span><a - id="dx1-189049"></a> field or you can add the -encapsulation with the <span id="textcolor582"><span + id="dx1-192049"></a> field or you can add the +encapsulation with the <span id="textcolor608"><span class="cmss-10">glosssymbolfont</span></span><a - id="dx1-189050"></a> attribute. -</p><!--l. 15739--><p class="indent" > Now <span class="obeylines-h"><span class="verb"><span + id="dx1-192050"></a> attribute. +</p><!--l. 16162--><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 + id="dx1-192051"></a><span class="cmtt-10">{Znu} </span>(no parameter is required in this case). For the other cases, where the parameter is different from that given in the <span class="cmtt-10">text</span><a - id="dx1-189052"></a> field (which is + id="dx1-192052"></a> field (which is obtained from the <span class="cmtt-10">name</span><a - id="dx1-189053"></a>), you can use <span id="textcolor583"><span + id="dx1-192053"></a>), you can use <span id="textcolor609"><span class="cmtt-10">\glsxtrfmt</span></span><a - id="dx1-189054"></a>. For example, <span + id="dx1-192054"></a>. For example, <span class="cmtt-10">\glslink{Gamma}{\Gamma(x+1)} </span>can now be replaced with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor584"><span +<span id="textcolor610"><span class="cmtt-10">\glsxtrfmt</span></span><a - id="dx1-189055"></a><span + id="dx1-192055"></a><span class="cmtt-10">{Gamma}{x+1}</span> </div> </div> This effectively works like <span @@ -31856,53 +33381,53 @@ 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. 15751--><p class="indent" > <div class="important" title="Important Note"> Don’t use <span id="textcolor585"><span +<!--l. 16174--><p class="indent" > <div class="important" title="Important Note"> Don’t use <span id="textcolor611"><span class="cmtt-10">\glsxtrfmt</span></span><a - id="dx1-189056"></a> within the argument of another <span id="textcolor586"><span + id="dx1-192056"></a> within the argument of another <span id="textcolor612"><span class="cmtt-10">\glsxtrfmt</span></span><a - id="dx1-189057"></a> command (or inside any other <a + id="dx1-192057"></a> command (or inside any other <a href="#glo:linktext">link text<a - id="dx1-189058"></a></a>). </div> -</p><!--l. 15754--><p class="noindent" > -</p><!--l. 15756--><p class="indent" > Similarly <span class="obeylines-h"><span class="verb"><span + id="dx1-192058"></a></a>). </div> +</p><!--l. 16177--><p class="noindent" > +</p><!--l. 16179--><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 +<span id="textcolor613"><span class="cmtt-10">\glsxtrfmt</span></span><a - id="dx1-189059"></a><span + id="dx1-192059"></a><span class="cmtt-10">{Gamma}{\alpha}</span> </div> </div> Note that it’s still possible to use: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glssymbol</span><a - id="dx1-189060"></a><span + id="dx1-192060"></a><span class="cmtt-10">{Gamma}[(\alpha)]</span> </div> </div> You may prefer to define a helper command that makes it easier to switch between your preferred method. For example: - <div class="verbatim" id="verbatim-424"> + <pre class="verbatim" id="verbatim-431"> \newcommand*{\Fn}[3][]{\glssymbol[#1]{#2}[(#3)]} -</div> -<!--l. 15769--><p class="nopar" > or: </p><div class="alltt"> +</pre> +<!--l. 16192--><p class="nopar" > or: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\newcommand*{\Fn}[3][]{</span><span id="textcolor588"><span +class="cmtt-10">\newcommand*{\Fn}[3][]{</span><span id="textcolor614"><span class="cmtt-10">\glsxtrfmt</span></span><a - id="dx1-189061"></a><span + id="dx1-192061"></a><span class="cmtt-10">[#1]{#2}{#3}}</span> </div> </div> -<!--l. 15775--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 16198--><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 + id="dx1-192062"></a></a></span>If you want to convert this example so that it works with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-189063"></a></a>, first convert it to use + id="dx1-192063"></a></a>, first convert it to use <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> (as described above), and then follow the instructions from <a @@ -31911,44 +33436,44 @@ class="cmtt-10">sampleEq.tex</span></a>. The <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-189064"></a></a> application recognises <span + id="dx1-192064"></a></a> application recognises <span class="cmtt-10">\newcommand </span>so it will be able to parse the custom <span class="cmtt-10">\newfunc</span> commands. -</p><!--l. 15782--><p class="indent" > Note that <a +</p><!--l. 16205--><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 + id="dx1-192065"></a></a> allows you to separate the locations in the <a href="#glo:numberlist">number list<a - id="dx1-189066"></a></a> into different groups according to -the counter used for the location. This can be done with the <span id="textcolor589"><span + id="dx1-192066"></a></a> into different groups according to +the counter used for the location. This can be done with the <span id="textcolor615"><span class="cmtt-10">loc-counters</span></span><a - id="dx1-189067"></a> resource option. It’s also possible to + id="dx1-192067"></a> resource option. It’s also possible to identify primary formats (such as <span class="cmtt-10">hyperbf</span><a - id="dx1-189068"></a> used in this example) using the <span id="textcolor590"><span + id="dx1-192068"></a> used in this example) using the <span id="textcolor616"><span class="cmtt-10">primary-location-formats</span></span><a - id="dx1-189069"></a> option. + id="dx1-192069"></a> option. The primary locations can then be given a more prominent position in the <a href="#glo:numberlist">number list<a - id="dx1-189070"></a></a>. See the <a + id="dx1-192070"></a></a>. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-189071"></a></a> user + id="dx1-192071"></a></a> user manual for further details. <a - id="x1-189072r14"></a> -</p><!--l. 15792--><p class="noindent" > + id="x1-192072r14"></a> +</p><!--l. 16215--><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. 15792--><p class="noindent" >This document also illustrates how to change the location to something other than the page number. In this +<!--l. 16215--><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 LaTeX run is required: -</p><!--l. 15797--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16220--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSec <br />makeglossaries sampleSec <br />pdflatex sampleSec @@ -31958,87 +33483,87 @@ LaTeX run is required: Note that there are conflicting location formats, which trigger a warning from <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-190001"></a></a>: + id="dx1-193001"></a></a>: </p> - <div class="verbatim" id="verbatim-425"> + <pre class="verbatim" id="verbatim-432"> ## Warning (input = sampleSec.glo, line = 6; output = - <br />sampleSec.gls, line = 9): - <br />   -- Conflicting entries: multiple encaps for the same page - <br />under same key. - <br />## Warning (input = sampleSec.glo, line = 2; output = - <br />sampleSec.gls, line = 10): - <br />   -- Conflicting entries: multiple encaps for the same page - <br />under same key. -</div> -<!--l. 15815--><p class="nopar" > This is the result of indexing an entry multiple times for the same +sampleSec.gls, line = 9): +   -- Conflicting entries: multiple encaps for the same page +under same key. +## Warning (input = sampleSec.glo, line = 2; output = +sampleSec.gls, line = 10): +   -- Conflicting entries: multiple encaps for the same page +under same key. +</pre> +<!--l. 16238--><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> +href="#fn1x18" id="fn1x18-bk"><sup class="textsuperscript">18.1</sup></a></span><a + id="x1-193002f1"></a> with different values of the <span class="cmtt-10">format</span><a - id="dx1-190004"></a> key. In this case, it’s caused by three references to the <span + id="dx1-193004"></a> key. In this case, it’s caused by three references to the <span class="cmtt-10">ident </span>entry in section 2.1: </p> - <div class="verbatim" id="verbatim-426"> + <pre class="verbatim" id="verbatim-433"> \gls[format=hyperit]{ident} - <br />\glspl{ident} % default format=glsnumberformat - <br />\gls*[format=hyperbf]{ident} -</div> -<!--l. 15824--><p class="nopar" > -</p><!--l. 15826--><p class="indent" > If you use the <a +\glspl{ident} % default format=glsnumberformat +\gls*[format=hyperbf]{ident} +</pre> +<!--l. 16247--><p class="nopar" > +</p><!--l. 16249--><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 + id="dx1-193005"></a></a> Perl script it will detect the warnings in the <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-190006"></a></a> transcript file and + id="dx1-193006"></a></a> transcript file and attempt to fix the conflict by removing entries from the <span class="cmtt-10">glo</span><a - id="dx1-190007"></a> file: + id="dx1-193007"></a> file: </p> - <div class="verbatim" id="verbatim-427"> + <pre class="verbatim" id="verbatim-434"> Multiple encaps detected. Attempting to remedy. - <br />Reading sampleSec.glo... - <br />Writing sampleSec.glo... - <br />Retrying -</div> -<!--l. 15834--><p class="nopar" > (Range formats have highest precedence. The default <span +Reading sampleSec.glo... +Writing sampleSec.glo... +Retrying +</pre> +<!--l. 16257--><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. 15838--><p class="indent" > If you use <a + id="dx1-193008"></a> has the lowest precedence.) +</p><!--l. 16261--><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 + id="dx1-193009"></a></a> or call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-190010"></a></a> directly then the problem won’t be fixed and the + id="dx1-193010"></a></a> directly then the problem won’t be fixed and the glossary will end up with the rather odd <a href="#glo:numberlist">number list<a - id="dx1-190011"></a></a> for the identity matrix entry consisting of three references + id="dx1-193011"></a></a> for the identity matrix entry consisting of three references to section 2.1: the first in the default font, followed by bold (<span class="cmtt-10">hyperbf</span><a - id="dx1-190012"></a>) and then italic (<span + id="dx1-193012"></a>) and then italic (<span class="cmtt-10">hyperit</span><a - id="dx1-190013"></a>), + id="dx1-193013"></a>), which results in 2.1, <span class="cmbx-10">2.1</span>, <span class="cmti-10">2.1</span>. If you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-190014"></a></a> then only the bold entry (<span + id="dx1-193014"></a></a> then only the bold entry (<span class="cmbx-10">2.1</span>) will be present. -</p><!--l. 15847--><p class="indent" > If you switch to <a +</p><!--l. 16270--><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"> + id="dx1-193015"></a></a>: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[</span><strong><span @@ -32048,7 +33573,7 @@ class="cmtt-10">,style=altlist,toc,counter=section]{glossaries}</span> </div> then the conflict will be resolved using the number format attribute list order of priority. In this case, <span class="cmtt-10">glsnumberformat</span><a - id="dx1-190016"></a> has the highest priority. This means that only the upright medium weight entry (2.1) will be + id="dx1-193016"></a> has the highest priority. This means that only the upright medium weight entry (2.1) will be present. The simplest way of altering this is to provide your own custom format. For example: <div class="alltt"> <div class="obeylines-v"> @@ -32056,11 +33581,11 @@ present. The simplest way of altering this is to provide your own custom format. class="cmtt-10">\newcommand*{</span><strong><span class="cmtt-10">\primary</span></strong><span class="cmtt-10">}[1]{\hyperit</span><a - id="dx1-190017"></a><span + id="dx1-193017"></a><span class="cmtt-10">{#1}}</span> <br /><span class="cmtt-10">\GlsAddXdyAttribute</span><a - id="dx1-190018"></a><span + id="dx1-193018"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">primary</span></strong><span class="cmtt-10">}</span> @@ -32071,35 +33596,35 @@ class="cmtt-10">\gls[format=</span><strong><span class="cmtt-10">primary</span></strong><span class="cmtt-10">] </span>etc. This will give <span class="cmtt-10">format</span><a - id="dx1-190019"></a><span + id="dx1-193019"></a><span class="cmtt-10">=primary</span><a - id="dx1-190020"></a> the highest + id="dx1-193020"></a> the highest priority. (It’s also better practice to provide this kind of semantic command.) -<!--l. 15864--><p class="indent" > With <a +<!--l. 16287--><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. 15867--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a + id="dx1-193021"></a></a>, you can supply rules to deal with location format conflicts, as illustrated below. +</p><!--l. 16290--><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 + id="dx1-193022"></a></a></span>In order to switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-190023"></a></a>, first replace <span + id="dx1-193023"></a></a>, first replace <span class="cmss-10">glossaries </span>with <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, and add the <span id="textcolor591"><span +class="cmss-10">glossaries-extra</span></a>, and add the <span id="textcolor617"><span class="cmss-10">record</span></span><a - id="dx1-190024"></a> + id="dx1-193024"></a> package option. Remember that <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> has a different set of defaults and you may also want to patch the predefined base styles. For example: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[style=altlist,</span><strong><span id="textcolor592"><span +class="cmtt-10">\usepackage[style=altlist,</span><strong><span id="textcolor618"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor593"><span +class="cmtt-10">,</span><span id="textcolor619"><span class="cmtt-10">stylemods</span></span></strong><span class="cmtt-10">,counter=section]</span> <br /><span @@ -32108,40 +33633,40 @@ class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 15878--><p class="indent" > The entry definitions now need to be converted into <a +<!--l. 16301--><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 + id="dx1-193025"></a></a> format and saved in a <span class="cmtt-10">bib</span><a - id="dx1-190026"></a> file (say, + id="dx1-193026"></a> file (say, <span class="cmtt-10">entries.bib</span>). You can use <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-190027"></a></a>: + id="dx1-193027"></a></a>: -</p><!--l. 15881--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16304--><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. 15885--><p class="indent" > Next replace <span +</p><!--l. 16308--><p class="indent" > Next replace <span class="cmtt-10">\makeglossaries</span><a - id="dx1-190028"></a> with: </p><div class="alltt"> + id="dx1-193028"></a> with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor594"><span +<span id="textcolor620"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-190029"></a><span + id="dx1-193029"></a><span class="cmtt-10">[src=entries]</span> </div> </div> and remove all the <span class="cmtt-10">\newglossaryentry </span>commands. -<!--l. 15891--><p class="indent" > Finally, replace <span +<!--l. 16314--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossaries</span><a - id="dx1-190030"></a> with <span id="textcolor595"><span + id="dx1-193030"></a> with <span id="textcolor621"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-190031"></a>. The document build is now: -</p><!--l. 15893--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-193031"></a>. The document build is now: +</p><!--l. 16316--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSec <br />bib2gls sampleSec <br />pdflatex sampleSec @@ -32150,46 +33675,46 @@ class="cmtt-10">\printunsrtglossaries</span></span><a As with the original example, there’s still a location format conflict, which <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-190032"></a></a> warns about: + id="dx1-193032"></a></a> warns about: </p> - <div class="verbatim" id="verbatim-428"> + <pre class="verbatim" id="verbatim-435"> 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. 15904--><p class="nopar" > This means that it has discarded the bold location and kept the italic one. (As with <a +Discarding: {ident}{}{section}{hyperbf}{2.1} +Conflicts with: {ident}{}{section}{hyperit}{2.1} +</pre> +<!--l. 16327--><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 + id="dx1-193033"></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. 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 + id="dx1-193034"></a> has the lowest.) +</p><!--l. 16332--><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 class="cmtt-10">\newcommand*{\hyperbfit</span><a - id="dx1-190035"></a><span + id="dx1-193035"></a><span class="cmtt-10">}[1]{\textbf{\hyperit{#1}}}</span> </div> </div> Now <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-190036"></a></a> needs to be invoked with the appropriate mapping with the <span id="textcolor596"><span + id="dx1-193036"></a></a> needs to be invoked with the appropriate mapping with the <span id="textcolor622"><span class="cmtt-10">--map-format</span></span><a - id="dx1-190037"></a> or <span id="textcolor597"><span + id="dx1-193037"></a> or <span id="textcolor623"><span class="cmtt-10">-m</span></span><a - id="dx1-190038"></a> + id="dx1-193038"></a> switch: -<!--l. 15917--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16340--><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> If you are using <span class="cmtt-10">arara</span><a - id="dx1-190039"></a> the directive should be: </p><div class="alltt"> + id="dx1-193039"></a> the directive should be: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">%</span><span @@ -32210,24 +33735,24 @@ class="cmtt-10"> ]</span><span class="cmtt-10"> }</span> </div> </div> -<!--l. 15926--><p class="indent" > If you try out this example, notice the difference between <span id="textcolor598"><span +<!--l. 16349--><p class="indent" > If you try out this example, notice the difference between <span id="textcolor624"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">only</span></span><a - id="dx1-190040"></a> and <span id="textcolor599"><span + id="dx1-193040"></a> and <span id="textcolor625"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-190041"></a>. If you use the + id="dx1-193041"></a>. If you use the latter, the locations will now be the section titles rather than the section numbers. If you use the <span class="cmss-10">nameref </span>setting you can customize the location by defining the command: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor600"><span +<span id="textcolor626"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">counter</span>⟩<span class="cmtt-10">locfmt</span></span><a - id="dx1-190042"></a><span + id="dx1-193042"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">location</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -32235,18 +33760,18 @@ class="cmitt-10">title</span>⟩<span class="cmtt-10">}</span> </div> </div> -<!--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 +<!--l. 16358--><p class="indent" > In this case the counter is <span +class="cmss-10">section</span>, so the command should be <span id="textcolor627"><span class="cmtt-10">\glsxtrsectionlocfmt</span></span><a - id="dx1-190043"></a>. It takes two + id="dx1-193043"></a>. It takes two arguments: the first is the location and the second is the title. For example: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\newcommand*{</span><span id="textcolor602"><span +class="cmtt-10">\newcommand*{</span><span id="textcolor628"><span class="cmtt-10">\glsxtrsectionlocfmt</span></span><a - id="dx1-190044"></a><span + id="dx1-193044"></a><span class="cmtt-10">}[2]{\S</span><a - id="dx1-190045"></a><span + id="dx1-193045"></a><span class="cmtt-10">#1</span><span class="cmtt-10"> #2}</span> @@ -32254,32 +33779,33 @@ class="cmtt-10"> #2}</span> </div> </div> (The only command of this type that is defined by default is the one for the <span class="cmss-10">equation </span>counter, -<span id="textcolor603"><span +<span id="textcolor629"><span class="cmtt-10">\glsxtrequationlocfmt</span></span><a - id="dx1-190046"></a>.) Make sure that you have at least version 1.42 of <a + id="dx1-193046"></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. 15945--><p class="noindent" > +<!--l. 16368--><p class="noindent" > </p> -<!--l. 15945--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.4 </span> <a +<!--l. 16368--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.4 </span> <a id="sec:samplestype"></a>Multiple Glossaries</h3> -<!--l. 15948--><p class="noindent" >See also <a +<!--l. 16371--><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">§<span +class="cmbx-10">??</span>sec:samplessort </a><a href="#sec:samplessort">Sorting<!--tex4ht:ref: sec:samplessort --></a>, which has three glossaries. <a - id="x1-191001r15"></a> -</p><!--l. 15951--><p class="noindent" > + id="x1-194001r15"></a> +</p><!--l. 16374--><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. 15951--><p class="noindent" >This document illustrates how to create an additional glossary type. This example adds the glossary to the table +<!--l. 16374--><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"> +</p><!--l. 16378--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleNtn <br />makeglossaries sampleNtn <br />pdflatex sampleNtn @@ -32289,39 +33815,41 @@ of contents, so an extra LaTeX run is required: Note that if you want to call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-192001"></a></a> explicitly instead of using the <a + id="dx1-195001"></a></a> explicitly instead of using the <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-192002"></a></a> or <a + id="dx1-195002"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-192003"></a></a> + id="dx1-195003"></a></a> scripts then you need to call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-192004"></a></a> twice: + id="dx1-195004"></a></a> twice: </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-192006x1">Create the main glossary (all on one line): - <!--l. 15966--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<li + class="enumerate" id="x1-195006x1"> + <!--l. 16388--><p class="noindent" >Create the main glossary (all on one line): + </p><!--l. 16389--><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. 15970--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<li + class="enumerate" id="x1-195008x2"> + <!--l. 16392--><p class="noindent" >Create the secondary glossary (all on one line): + </p><!--l. 16393--><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. 15974--><p class="noindent" >This document creates a new glossary using: </p><div class="alltt"> + <br /></span> + </p></li></ol> +<!--l. 16397--><p class="noindent" >This document creates a new glossary using: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossary</span><a - id="dx1-192009"></a><span + id="dx1-195009"></a><span class="cmtt-10">[nlg]{notation}{not}{ntn}{Notation}</span> </div> </div> This defines a glossary that can be identified with the label <span @@ -32333,90 +33861,90 @@ class="cmss-10">glossaries</span> package needs to know the input and output files required by <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-192010"></a></a> or <a + id="dx1-195010"></a></a> or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-192011"></a></a>. -<!--l. 15984--><p class="indent" > (The optional argument is the file extension of the indexing transcript file, which <span + id="dx1-195011"></a></a>. +<!--l. 16407--><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 - id="dx1-192012"></a> file for the benefit of <a + id="dx1-195012"></a> file for the benefit of <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-192013"></a></a> and + id="dx1-195013"></a></a> and <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-192014"></a></a>.) -</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 + id="dx1-195014"></a></a>.) +</p><!--l. 16412--><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 class="cmtt-10">\newglossary*</span><a - id="dx1-192015"></a><span + id="dx1-195015"></a><span class="cmtt-10">{notation}{Notation}</span> </div> </div> -<!--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 +<!--l. 16418--><p class="indent" > This example uses a label prefixing system<span class="footnote-mark"><a +href="#fn2x18" id="fn2x18-bk"><sup class="textsuperscript">18.2</sup></a></span><a + id="x1-195016f2"></a> to differentiate between the different types of entries. For example, the term “set” is defined as: </p> - <div class="verbatim" id="verbatim-429"> + <pre class="verbatim" id="verbatim-436"> \newglossaryentry{gls:set}{name=set, - <br />description={A collection of distinct objects}} -</div> -<!--l. 16003--><p class="nopar" > and the set notation is defined as: +description={A collection of distinct objects}} +</pre> +<!--l. 16426--><p class="nopar" > and the set notation is defined as: </p> - <div class="verbatim" id="verbatim-430"> + <pre class="verbatim" id="verbatim-437"> \newglossaryentry{not:set}{type=notation, - <br />name={\ensuremath{\mathcal{S}}}, - <br />description={A \gls{gls:set}},sort={S}} -</div> -<!--l. 16009--><p class="nopar" > Notice that the latter description contains <span +name={\ensuremath{\mathcal{S}}}, +description={A \gls{gls:set}},sort={S}} +</pre> +<!--l. 16432--><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 + id="dx1-195018"></a> with this entry otherwise you will end up with nested links. -</p><!--l. 16014--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 16437--><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 class="cmss-10">glossaries-extra</span></a> package provides a command for use in within field values to prevent nested <a href="#glo:linktext">link text<a - id="dx1-192019"></a></a>: </p><div class="alltt"> + id="dx1-195019"></a></a>: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor604"><span +<span id="textcolor630"><span class="cmtt-10">\glsxtrp</span></span><a - id="dx1-192020"></a><span + id="dx1-195020"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">}{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}</span> </div> -</div> There are convenient shortcuts for common fields: <span id="textcolor605"><span +</div> There are convenient shortcuts for common fields: <span id="textcolor631"><span class="cmtt-10">\glsps</span></span><a - id="dx1-192021"></a><span + id="dx1-195021"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">} </span>(for the <span class="cmtt-10">short</span><a - id="dx1-192022"></a> field) and <span id="textcolor606"><span + id="dx1-195022"></a> field) and <span id="textcolor632"><span class="cmtt-10">\glspt</span></span><a - id="dx1-192023"></a><span + id="dx1-195023"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">label</span>⟩<span class="cmtt-10">}</span> (for the <span class="cmtt-10">text</span><a - id="dx1-192024"></a> field). So the set notation definition can be modified: <div class="alltt"> + id="dx1-195024"></a> field). So the set notation definition can be modified: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{not:set}{type=notation,</span> @@ -32424,30 +33952,30 @@ class="cmtt-10">\newglossaryentry{not:set}{type=notation,</span> class="cmtt-10">name={\ensuremath{\mathcal{S}}},</span> <br /><span class="cmtt-10">description={A</span><span -class="cmtt-10"> </span><strong><span id="textcolor607"><span +class="cmtt-10"> </span><strong><span id="textcolor633"><span class="cmtt-10">\glspt</span></span><a - id="dx1-192025"></a><span + id="dx1-195025"></a><span class="cmtt-10">{gls:set}</span></strong><span class="cmtt-10">},sort=S}</span> </div> </div> This will stop the inner reference from causing interference if you use <span class="cmtt-10">\glsdesc</span><a - id="dx1-192026"></a>. It will also suppress indexing + id="dx1-195026"></a>. It will also suppress indexing within the glossary but will have a hyperlink (if <span class="cmss-10">hyperref </span>is used). -<!--l. 16033--><p class="indent" > The <a +<!--l. 16456--><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 prefix. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor608"><span +<span id="textcolor634"><span class="cmtt-10">\glsxtrnewgls</span></span><a - id="dx1-192027"></a><span + id="dx1-195027"></a><span class="cmtt-10">{not:}{\sym}</span> -<br /><span id="textcolor609"><span +<br /><span id="textcolor635"><span class="cmtt-10">\glsxtrnewglslike</span></span><a - id="dx1-192028"></a><span + id="dx1-195028"></a><span class="cmtt-10">{gls:}{\term}{\termpl}{\Term}{\Termpl}</span> </div> </div> (there’s no point providing commands for plural or case-changing with symbols). Now <span class="obeylines-h"><span class="verb"><span @@ -32456,75 +33984,75 @@ 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. 16044--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 16467--><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 + id="dx1-195029"></a></a></span>These two commands are primarily provided for the benefit of <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-192030"></a></a> as the information is written + id="dx1-195030"></a></a> as the information is written to the <span class="cmtt-10">aux</span><a - id="dx1-192031"></a> file. This allows <a + id="dx1-195031"></a> file. This allows <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-192032"></a></a> to recognise the custom commands if they have been used in the <span + id="dx1-195032"></a></a> to recognise the custom commands if they have been used in the <span class="cmtt-10">bib</span><a - id="dx1-192033"></a> files. -When combined with <span id="textcolor610"><span + id="dx1-195033"></a> files. +When combined with <span id="textcolor636"><span class="cmtt-10">label-prefix</span></span><a - id="dx1-192034"></a> and <span id="textcolor611"><span + id="dx1-195034"></a> and <span id="textcolor637"><span class="cmtt-10">ext-prefixes</span></span><a - id="dx1-192035"></a> (see below) this makes it much simpler to change the + id="dx1-195035"></a> (see below) this makes it much simpler to change the prefixes if necessary. -</p><!--l. 16053--><p class="indent" > If you want to convert this document to use <a +</p><!--l. 16476--><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 + id="dx1-195036"></a></a>, remember that you need the <span id="textcolor638"><span class="cmss-10">record</span></span><a - id="dx1-192037"></a> or <span id="textcolor613"><span + id="dx1-195037"></a> or <span id="textcolor639"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-192038"></a> + id="dx1-195038"></a> option. For example: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor614"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor640"><span class="cmtt-10">record</span></span><span -class="cmtt-10">,</span></strong><span id="textcolor615"><span +class="cmtt-10">,</span></strong><span id="textcolor641"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor616"><span +class="cmtt-10">,</span><span id="textcolor642"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">]{glossaries-extra}</span> </div> </div> As with earlier examples, <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-192039"></a></a> can be used to convert the entry definitions into + id="dx1-195039"></a></a> can be used to convert the entry definitions into the required <span class="cmtt-10">bib</span><a - id="dx1-192040"></a> format. You may prefer to split the entries into separate files according to + id="dx1-195040"></a> format. You may prefer to split the entries into separate files according to type.<span class="footnote-mark"><a -href="#fn3x19" id="fn3x19-bk"><sup class="textsuperscript">19.3</sup></a></span><a - id="x1-192041f3"></a> +href="#fn3x18" id="fn3x18-bk"><sup class="textsuperscript">18.3</sup></a></span><a + id="x1-195041f3"></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. 16066--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16489--><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> This will create a file called <span class="cmtt-10">entries.bib </span>that contains the entries that didn’t have a <span class="cmtt-10">type</span><a - id="dx1-192043"></a> assigned in the + id="dx1-195043"></a> assigned in the original file, such as: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor617"><span +<span id="textcolor643"><span class="cmtt-10">@entry</span></span><a - id="dx1-192044"></a><span + id="dx1-195044"></a><span class="cmtt-10">{gls:set,</span> <br /><span class="cmtt-10"> </span><span @@ -32546,13 +34074,13 @@ class="cmtt-10">}</span> </div> It will also create a file called <span class="cmtt-10">notation.bib </span>that contains the entries that had the <span class="cmtt-10">type</span><a - id="dx1-192045"></a> set to <span + id="dx1-195045"></a> set to <span class="cmtt-10">notation </span>in the original file, such as: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor618"><span +<span id="textcolor644"><span class="cmtt-10">@entry</span></span><a - id="dx1-192046"></a><span + id="dx1-195046"></a><span class="cmtt-10">{not:set,</span> <br /><span class="cmtt-10"> </span><span @@ -32564,34 +34092,34 @@ class="cmtt-10"> </span><span class="cmtt-10"> description</span><span class="cmtt-10"> =</span><span class="cmtt-10"> {A</span><span -class="cmtt-10"> </span><span id="textcolor619"><span +class="cmtt-10"> </span><span id="textcolor645"><span class="cmtt-10">\glspt</span></span><a - id="dx1-192047"></a><span + id="dx1-195047"></a><span class="cmtt-10">{gls:set}}</span> <br /><span class="cmtt-10">}</span> </div> </div> Note that the <span class="cmtt-10">type</span><a - id="dx1-192048"></a> field has been removed. The above entry in the <span + id="dx1-195048"></a> field has been removed. The above entry in the <span class="cmtt-10">notation.bib </span>file references a term in the <span class="cmtt-10">entries.bib </span>file. It’s possible to strip all the prefixes from the <span class="cmtt-10">bib</span><a - id="dx1-192049"></a> files and get <a + id="dx1-195049"></a> files and get <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-192050"></a></a> to + id="dx1-195050"></a></a> to automatically insert them. In which case, this cross-reference needs adjusting to indicate that it’s -referring to an entry in another file. This can be done with one of the special <span id="textcolor620"><span +referring to an entry in another file. This can be done with one of the special <span id="textcolor646"><span class="cmtt-10">ext</span>⟨<span class="cmitt-10">n</span>⟩<span class="cmtt-10">.</span></span> prefixes: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor621"><span +<span id="textcolor647"><span class="cmtt-10">@entry</span></span><a - id="dx1-192051"></a><span + id="dx1-195051"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">set</span></strong><span class="cmtt-10">,</span> @@ -32605,10 +34133,10 @@ class="cmtt-10"> </span><span class="cmtt-10"> description</span><span class="cmtt-10"> =</span><span class="cmtt-10"> {A</span><span -class="cmtt-10"> </span><span id="textcolor622"><span +class="cmtt-10"> </span><span id="textcolor648"><span class="cmtt-10">\glspt</span></span><a - id="dx1-192052"></a><span -class="cmtt-10">{</span><strong><span id="textcolor623"><span + id="dx1-195052"></a><span +class="cmtt-10">{</span><strong><span id="textcolor649"><span class="cmtt-10">ext1.</span></span></strong><span class="cmtt-10">set}}</span> <br /><span @@ -32619,9 +34147,9 @@ class="cmtt-10">}</span> </div> The corresponding term in the <span class="cmtt-10">entries.bib </span>file is now: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor624"><span +<span id="textcolor650"><span class="cmtt-10">@entry</span></span><a - id="dx1-192053"></a><span + id="dx1-195053"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">set</span></strong><span class="cmtt-10">,</span> @@ -32643,76 +34171,76 @@ class="cmtt-10"> objects}</span> class="cmtt-10">}</span> </div> </div> -<!--l. 16109--><p class="indent" > Now you can replace <span +<!--l. 16532--><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 +<span id="textcolor651"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-192054"></a><span -class="cmtt-10">[</span><span id="textcolor626"><span + id="dx1-195054"></a><span +class="cmtt-10">[</span><span id="textcolor652"><span class="cmtt-10">src</span></span><a - id="dx1-192055"></a><span -class="cmtt-10">={entries},</span><strong><span id="textcolor627"><span + id="dx1-195055"></a><span +class="cmtt-10">={entries},</span><strong><span id="textcolor653"><span class="cmtt-10">label-prefix</span></span><span class="cmtt-10">={gls:}</span></strong><span class="cmtt-10">]</span> -<br /><span id="textcolor628"><span +<br /><span id="textcolor654"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-192056"></a><span -class="cmtt-10">[</span><span id="textcolor629"><span + id="dx1-195056"></a><span +class="cmtt-10">[</span><span id="textcolor655"><span class="cmtt-10">src</span></span><a - id="dx1-192057"></a><span -class="cmtt-10">={notation},</span><span id="textcolor630"><span + id="dx1-195057"></a><span +class="cmtt-10">={notation},</span><span id="textcolor656"><span class="cmtt-10">type</span></span><a - id="dx1-192058"></a><span + id="dx1-195058"></a><span class="cmtt-10">=notation,</span> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor631"><span +class="cmtt-10"> </span><strong><span id="textcolor657"><span class="cmtt-10">label-prefix</span></span><span -class="cmtt-10">={not:},</span><span id="textcolor632"><span +class="cmtt-10">={not:},</span><span id="textcolor658"><span class="cmtt-10">ext-prefixes</span></span><span class="cmtt-10">={gls:}</span></strong><span class="cmtt-10">]</span> </div> </div> Remove all the <span class="cmtt-10">\newglossaryentry </span>definitions and replace <span -class="cmtt-10">\printglossaries </span>with <span id="textcolor633"><span +class="cmtt-10">\printglossaries </span>with <span id="textcolor659"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-192059"></a>. -<!--l. 16118--><p class="indent" > Regardless of how many resource sets the document contains, only one <a + id="dx1-195059"></a>. +<!--l. 16541--><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. 16120--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-195060"></a></a> call is required: +</p><!--l. 16543--><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. 16126--><p class="indent" > You may notice that the ordering in the notations list has changed from the original. This is because the +</p><!--l. 16549--><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 + id="dx1-195061"></a> field was automatically removed by <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-192062"></a></a>, so the entries are now sorted according to the <span + id="dx1-195062"></a></a>, so the entries are now sorted according to the <span class="cmtt-10">name</span><a - id="dx1-192063"></a> -field (since they are defined with <span id="textcolor634"><span + id="dx1-195063"></a> +field (since they are defined with <span id="textcolor660"><span class="cmtt-10">@entry</span></span><a - id="dx1-192064"></a>). You can use your text editor’s search and replace function to replace -all instances of <span id="textcolor635"><span + id="dx1-195064"></a>). You can use your text editor’s search and replace function to replace +all instances of <span id="textcolor661"><span class="cmtt-10">@entry</span></span><a - id="dx1-192065"></a> with <span id="textcolor636"><span + id="dx1-195065"></a> with <span id="textcolor662"><span class="cmtt-10">@symbol</span></span><a - id="dx1-192066"></a> in the <span + id="dx1-195066"></a> in the <span class="cmtt-10">notations.bib </span>file so that, for example, the <span class="cmtt-10">set </span>definition becomes: </p><div class="alltt"> <div class="obeylines-v"> -<strong><span id="textcolor637"><span +<strong><span id="textcolor663"><span class="cmtt-10">@symbol</span></span><a - id="dx1-192067"></a></strong><span + id="dx1-195067"></a></strong><span class="cmtt-10">{set,</span> <br /><span class="cmtt-10"> </span><span @@ -32724,41 +34252,41 @@ class="cmtt-10"> </span><span class="cmtt-10"> description</span><span class="cmtt-10"> =</span><span class="cmtt-10"> {A</span><span -class="cmtt-10"> </span><span id="textcolor638"><span +class="cmtt-10"> </span><span id="textcolor664"><span class="cmtt-10">\glspt</span></span><a - id="dx1-192068"></a><span -class="cmtt-10">{</span><span id="textcolor639"><span + id="dx1-195068"></a><span +class="cmtt-10">{</span><span id="textcolor665"><span class="cmtt-10">ext1.</span></span><span class="cmtt-10">set}}</span> <br /><span class="cmtt-10">}</span> </div> -</div> Now these <span id="textcolor640"><span +</div> Now these <span id="textcolor666"><span class="cmtt-10">@symbol</span></span><a - id="dx1-192069"></a> entries will be sorted according to their label. (The original label in the <span + id="dx1-195069"></a> entries will be sorted according to their label. (The original label in the <span class="cmtt-10">bib</span><a - id="dx1-192070"></a> file, not the + id="dx1-195070"></a> file, not the prefixed label.) This will put them in the same order as the original document. (See the “Examples” chapter of the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-192071"></a></a> user manual for examples of varying the sorting and also <a + id="dx1-195071"></a></a> user manual for examples of varying the sorting and also <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a>.) <a - id="x1-192072r16"></a> + id="x1-195072r16"></a> -<!--l. 16147--><p class="noindent" > +<!--l. 16570--><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. 16147--><p class="noindent" >This document illustrates how to define an entry that both appears in the list of acronyms and in the main +<!--l. 16570--><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. 16150--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16573--><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 @@ -32766,37 +34294,37 @@ glossary. To create the document do: <br /></span> This defines a custom command <span class="cmtt-10">\newdualentry</span><a - id="dx1-193001"></a> that defines two entries at once (a normal entry and + id="dx1-196001"></a> that defines two entries at once (a normal entry and an abbreviation). It uses <span class="cmtt-10">\glsadd</span><a - id="dx1-193002"></a> to ensure that if one is used then the other is automatically + id="dx1-196002"></a> to ensure that if one is used then the other is automatically indexed: </p> - <div class="verbatim" id="verbatim-431"> + <pre class="verbatim" id="verbatim-438"> \newcommand*{\newdualentry}[5][]{% - <br />  % main entry: - <br />  \newglossaryentry{main-#2}{name={#4},% - <br />  text={#3\glsadd{#2}},% - <br />  description={#5},% - <br />  #1% additional options for main entry - <br />  }% - <br />  % abbreviation: - <br />  \newacronym{#2}{#3\glsadd{main-#2}}{#4}% - <br />} -</div> -<!--l. 16169--><p class="nopar" > A sample dual entry is defined with this command: +  % main entry: +  \newglossaryentry{main-#2}{name={#4},% +  text={#3\glsadd{#2}},% +  description={#5},% +  #1% additional options for main entry +  }% +  % abbreviation: +  \newacronym{#2}{#3\glsadd{main-#2}}{#4}% +} +</pre> +<!--l. 16592--><p class="nopar" > A sample dual entry is defined with this command: </p> - <div class="verbatim" id="verbatim-432"> + <pre class="verbatim" id="verbatim-439"> \newdualentry{svm}% label - <br />  {SVM}% abbreviation - <br />  {support vector machine}% long form - <br />  {Statistical pattern recognition technique}% description -</div> -<!--l. 16176--><p class="nopar" > This defines an acronym with the label <span +  {SVM}% abbreviation +  {support vector machine}% long form +  {Statistical pattern recognition technique}% description +</pre> +<!--l. 16599--><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 @@ -32805,26 +34333,26 @@ 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. 16184--><p class="indent" > For this trivial document, this kind of dual entry is redundant and unnecessarily leads the +</p><!--l. 16607--><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. 16190--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 16613--><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 + id="dx1-196003"></a></a></span>If you want to switch over to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-193004"></a></a>, first change to <a + id="dx1-196004"></a></a>, first change to <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor641"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor667"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor642"><span +class="cmtt-10">,</span><span id="textcolor668"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor643"><span +class="cmtt-10">,</span><span id="textcolor669"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,acronym]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -32832,53 +34360,53 @@ class="cmtt-10">}</span> </div> </div> Next, the definition needs to be converted to the <span class="cmtt-10">bib</span><a - id="dx1-193005"></a> format required by <a + id="dx1-196005"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-193006"></a></a>. If you do: -<!--l. 16198--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-196006"></a></a>. If you do: +<!--l. 16621--><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> then <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-193007"></a></a> will report the following: + id="dx1-196007"></a></a> will report the following: </p> - <div class="verbatim" id="verbatim-433"> + <pre class="verbatim" id="verbatim-440"> 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. 16207--><p class="nopar" > This is because <a +definition. (Change \newcommand to \providecommand if you want +\newdualentry[options]{label}{short}{long}{description} +converted to @dualabbreviationentry.) +</pre> +<!--l. 16630--><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 + id="dx1-196008"></a></a> has its own internal definition of <span class="cmtt-10">\newdualentry</span>, but if it encounters a new definition that will override its default. If you want to retain <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-193009"></a>’s</a> definition + id="dx1-196009"></a>’s</a> definition (recommended) then just replace <span class="cmtt-10">\newcommand </span>with <span class="cmtt-10">\providecommand </span>in the document source and rerun <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-193010"></a></a>. -</p><!--l. 16215--><p class="indent" > With <span + id="dx1-196010"></a></a>. +</p><!--l. 16638--><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 class="cmtt-10">convertgls2bib</span><a - id="dx1-193011"></a></a> contains: </p><div class="alltt"> + id="dx1-196011"></a></a> contains: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor644"><span +<span id="textcolor670"><span class="cmtt-10">@dualabbreviationentry</span></span><a - id="dx1-193012"></a><span + id="dx1-196012"></a><span class="cmtt-10">{svm,</span> <br /><span class="cmtt-10"> </span><span @@ -32906,9 +34434,9 @@ class="cmtt-10">}</span> </div> If <span class="cmtt-10">\newcommand </span>is retained, it will instead contain: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor645"><span +<span id="textcolor671"><span class="cmtt-10">@entry</span></span><a - id="dx1-193013"></a><span + id="dx1-196013"></a><span class="cmtt-10">{main-svm,</span> <br /><span class="cmtt-10"> </span><span @@ -32933,9 +34461,9 @@ class="cmtt-10"> {SVM\glsadd{svm}}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor646"><span +<br /><span id="textcolor672"><span class="cmtt-10">@acronym</span></span><a - id="dx1-193014"></a><span + id="dx1-196014"></a><span class="cmtt-10">{svm,</span> <br /><span class="cmtt-10"> </span><span @@ -32955,75 +34483,75 @@ class="cmtt-10">}</span> </div> In the first case, <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-193015"></a></a> creates two linked entries using its primary-dual mechanism. In the second case, + id="dx1-196015"></a></a> creates two linked entries using its primary-dual mechanism. In the second case, <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. 16241--><p class="indent" > Assuming that your <span -class="cmtt-10">entries.bib </span>file just contains <span id="textcolor647"><span + id="dx1-196016"></a></a> creates two entries that simply reference each other. +<!--l. 16664--><p class="indent" > Assuming that your <span +class="cmtt-10">entries.bib </span>file just contains <span id="textcolor673"><span class="cmtt-10">@dualabbreviationentry</span></span><a - id="dx1-193017"></a>, now replace + id="dx1-196017"></a>, now replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\GlsXtrLoadResources[</span><span id="textcolor648"><span +class="cmtt-10">\GlsXtrLoadResources[</span><span id="textcolor674"><span class="cmtt-10">src</span></span><a - id="dx1-193018"></a><span + id="dx1-196018"></a><span class="cmtt-10">=entries,%</span><span class="cmtt-10"> entries.bib</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor649"><span +class="cmtt-10"> </span><span id="textcolor675"><span class="cmtt-10">type</span></span><a - id="dx1-193019"></a><span -class="cmtt-10">=acronym,</span><span id="textcolor650"><span + id="dx1-196019"></a><span +class="cmtt-10">=acronym,</span><span id="textcolor676"><span class="cmtt-10">dual-type</span></span><a - id="dx1-193020"></a><span -class="cmtt-10">=main,</span><span id="textcolor651"><span + id="dx1-196020"></a><span +class="cmtt-10">=main,</span><span id="textcolor677"><span class="cmtt-10">dual-prefix</span></span><a - id="dx1-193021"></a><span + id="dx1-196021"></a><span class="cmtt-10">={main-}]</span> </div> </div> -<!--l. 16249--><p class="indent" > Then remove the definition of <span +<!--l. 16672--><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 +with <span id="textcolor678"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-193022"></a>. The document build is: -</p><!--l. 16253--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-196022"></a>. The document build is: +</p><!--l. 16676--><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. 16259--><p class="indent" > If, instead, your <span -class="cmtt-10">entries.bib </span>file contains separate <span id="textcolor653"><span +</p><!--l. 16682--><p class="indent" > If, instead, your <span +class="cmtt-10">entries.bib </span>file contains separate <span id="textcolor679"><span class="cmtt-10">@entry</span></span><a - id="dx1-193023"></a> and <span id="textcolor654"><span + id="dx1-196023"></a> and <span id="textcolor680"><span class="cmtt-10">@acronym</span></span><a - id="dx1-193024"></a>, then you need: </p><div class="alltt"> + id="dx1-196024"></a>, then you need: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor655"><span +<span id="textcolor681"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-193025"></a><span + id="dx1-196025"></a><span class="cmtt-10">[acronym]{long-short}</span> -<br /><span id="textcolor656"><span +<br /><span id="textcolor682"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-193026"></a><span -class="cmtt-10">[</span><span id="textcolor657"><span + id="dx1-196026"></a><span +class="cmtt-10">[</span><span id="textcolor683"><span class="cmtt-10">src</span></span><a - id="dx1-193027"></a><span + id="dx1-196027"></a><span class="cmtt-10">=entries]</span> </div> </div> If you need <a href="#glo:numberlist">number list<a - id="dx1-193028"></a>s</a>, the document build is now -<!--l. 16266--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-196028"></a>s</a>, the document build is now +<!--l. 16689--><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 @@ -33034,40 +34562,40 @@ href="#glo:numberlist">number list<a and this time <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-193029"></a></a> complains about the use of <span + id="dx1-196029"></a></a> complains about the use of <span class="cmtt-10">\glsadd</span><a - id="dx1-193030"></a> within the <span + id="dx1-196030"></a> within the <span class="cmtt-10">short</span><a - id="dx1-193031"></a> and <span + id="dx1-196031"></a> and <span class="cmtt-10">text</span><a - id="dx1-193032"></a> fields as + id="dx1-196032"></a> fields as this can be problematic. (The extra <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-193033"></a></a> and LaTeX calls are to ensure the <a + id="dx1-196033"></a></a> and LaTeX calls are to ensure the <a href="#glo:numberlist">number list<a - id="dx1-193034"></a></a> is + id="dx1-196034"></a></a> is up to date for the <span 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. 16280--><p class="indent" > Dual entries make much more sense when one entry is for a glossary with the description displayed but +</p><!--l. 16703--><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 + id="dx1-196035"></a></a>, and the other is for the index without the description but with a <a href="#glo:numberlist">number list<a - id="dx1-193036"></a></a>. -This can be created with by replacing <span id="textcolor658"><span + id="dx1-196036"></a></a>. +This can be created with by replacing <span id="textcolor684"><span class="cmtt-10">@dualabbreviationentry</span></span><a - id="dx1-193037"></a> with <span id="textcolor659"><span + id="dx1-196037"></a> with <span id="textcolor685"><span class="cmtt-10">@dualindexabbreviation</span></span><a - id="dx1-193038"></a>: + id="dx1-196038"></a>: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor660"><span +<span id="textcolor686"><span class="cmtt-10">@dualindexabbreviation</span></span><a - id="dx1-193039"></a><span + id="dx1-196039"></a><span class="cmtt-10">{svm,</span> <br /><span class="cmtt-10"> </span><span @@ -33092,15 +34620,15 @@ class="cmtt-10"> machine}</span> <br /><span class="cmtt-10">}</span> </div> -</div> This can be mixed with <span id="textcolor661"><span +</div> This can be mixed with <span id="textcolor687"><span class="cmtt-10">@index</span></span><a - id="dx1-193040"></a> terms for example: <div class="alltt"> + id="dx1-196040"></a> terms for example: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor662"><span +<span id="textcolor688"><span class="cmtt-10">@index</span></span><a - id="dx1-193041"></a><span + id="dx1-196041"></a><span class="cmtt-10">{machlearn,</span> <br /><span class="cmtt-10"> </span><span @@ -33117,16 +34645,16 @@ class="cmtt-10">\documentclass{article}</span> <br /> <br /><span class="cmtt-10">\usepackage</span><a - id="dx1-193042"></a><span -class="cmtt-10">[</span><span id="textcolor663"><span + id="dx1-196042"></a><span +class="cmtt-10">[</span><span id="textcolor689"><span class="cmtt-10">record</span></span><span -class="cmtt-10">,</span><span id="textcolor664"><span +class="cmtt-10">,</span><span id="textcolor690"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">,</span> <br /><span -class="cmtt-10"> nostyles,</span><span id="textcolor665"><span +class="cmtt-10"> nostyles,</span><span id="textcolor691"><span class="cmtt-10">stylemods</span></span><span -class="cmtt-10">={</span><span id="textcolor666"><span +class="cmtt-10">={</span><span id="textcolor692"><span class="cmtt-10">bookindex</span></span><span class="cmtt-10">,list},%</span><span class="cmtt-10"> only</span><span @@ -33138,41 +34666,41 @@ class="cmtt-10"> styles</span> <br /><span class="cmtt-10"> acronym]{glossaries-extra}</span> <br /> -<br /><span id="textcolor667"><span +<br /><span id="textcolor693"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-193043"></a><span + id="dx1-196043"></a><span class="cmtt-10">{long-short-desc}</span> -<br /><span id="textcolor668"><span +<br /><span id="textcolor694"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-193044"></a><span -class="cmtt-10">[</span><span id="textcolor669"><span + id="dx1-196044"></a><span +class="cmtt-10">[</span><span id="textcolor695"><span class="cmtt-10">src</span></span><a - id="dx1-193045"></a><span + id="dx1-196045"></a><span class="cmtt-10">=entries,%</span><span class="cmtt-10"> entries.bib</span> <br /><span -class="cmtt-10"> </span><span id="textcolor670"><span +class="cmtt-10"> </span><span id="textcolor696"><span class="cmtt-10">dual-type</span></span><a - id="dx1-193046"></a><span + id="dx1-196046"></a><span class="cmtt-10">=acronym,</span> <br /><span -class="cmtt-10"> </span><span id="textcolor671"><span +class="cmtt-10"> </span><span id="textcolor697"><span class="cmtt-10">label-prefix</span></span><span class="cmtt-10">={</span><strong><span class="cmtt-10">idx.</span></strong><span -class="cmtt-10">},</span><span id="textcolor672"><span +class="cmtt-10">},</span><span id="textcolor698"><span class="cmtt-10">dual-prefix</span></span><a - id="dx1-193047"></a><span + id="dx1-196047"></a><span class="cmtt-10">={},</span> <br /><span -class="cmtt-10"> </span><span id="textcolor673"><span +class="cmtt-10"> </span><span id="textcolor699"><span class="cmtt-10">combine-dual-locations</span></span><a - id="dx1-193048"></a><span + id="dx1-196048"></a><span class="cmtt-10">={primary}]</span> <br /> -<br /><span id="textcolor674"><span +<br /><span id="textcolor700"><span class="cmtt-10">\glsxtrnewglslike</span></span><a - id="dx1-193049"></a><span + id="dx1-196049"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">idx.</span></strong><span class="cmtt-10">}{</span><strong><span @@ -33188,13 +34716,13 @@ class="cmtt-10"> </span><strong><span class="cmtt-10">\idx</span></strong><span class="cmtt-10">{machlearn}.</span> <br /> -<br /><span id="textcolor675"><span +<br /><span id="textcolor701"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-193050"></a><span + id="dx1-196050"></a><span class="cmtt-10">[type=main,style=altlist]</span> -<br /><span id="textcolor676"><span +<br /><span id="textcolor702"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-193051"></a><span + id="dx1-196051"></a><span class="cmtt-10">[style=bookindex,title={Index}]</span> <br /><span class="cmtt-10">\end{document}</span> @@ -33202,18 +34730,18 @@ class="cmtt-10">\end{document}</span> </div> See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-193052"></a></a> manual for further details. + id="dx1-196052"></a></a> manual for further details. <a - id="x1-193053r17"></a> -<!--l. 16323--><p class="noindent" > + id="x1-196053r17"></a> +<!--l. 16746--><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. 16323--><p class="noindent" >This document illustrates how to use the glossaries package to create English to French and French to English +<!--l. 16746--><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. 16327--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16750--><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 @@ -33223,22 +34751,22 @@ dictionaries. To create the document do: <br /></span> This example uses the <span class="cmss-10">nomain</span><a - id="dx1-194001"></a> package option to prevent the creation of the <span + id="dx1-197001"></a> package option to prevent the creation of the <span class="cmtt-10">main </span>glossary. This means that the document must provide its own glossaries: </p> - <div class="verbatim" id="verbatim-434"> + <pre class="verbatim" id="verbatim-441"> \newglossary[glg]{english}{gls}{glo}{English to French} - <br />\newglossary[flg]{french}{flx}{flo}{French to English} -</div> -<!--l. 16338--><p class="nopar" > This means that if you want to call <a +\newglossary[flg]{french}{flx}{flo}{French to English} +</pre> +<!--l. 16761--><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 + id="dx1-197002"></a></a> explicitly you need to take these new extensions into account: -</p><!--l. 16341--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16764--><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> @@ -33248,14 +34776,14 @@ entries: </p> - <div class="verbatim" id="verbatim-435"> + <pre class="verbatim" id="verbatim-442"> \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. 16353--><p class="nopar" > This has the syntax: </p><div class="alltt"> +  \newglossaryentry{en-#1}{type=english,name={#2},description={#3 #4}}% +  \newglossaryentry{fr-#1}{type=french,name={#3 #4},text={#4},sort={#4}, +    description={#2}}% +} +</pre> +<!--l. 16776--><p class="nopar" > This has the syntax: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newword{</span>⟨<span @@ -33277,20 +34805,20 @@ class="cmitt-10">label</span>⟩ (for the French term). So - <div class="verbatim" id="verbatim-436"> + <pre class="verbatim" id="verbatim-443"> \newword{cat}{cat}{le}{chat} -</div> -<!--l. 16364--><p class="nopar" > is equivalent to: +</pre> +<!--l. 16787--><p class="nopar" > is equivalent to: </p> - <div class="verbatim" id="verbatim-437"> + <pre class="verbatim" id="verbatim-444"> \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. 16370--><p class="nopar" > -</p><!--l. 16372--><p class="indent" > Unlike the previous example (<a +\newglossaryentry{fr-cat}{type=french,name={le chat},sort={chat}, +  description={cat}} +</pre> +<!--l. 16793--><p class="nopar" > +</p><!--l. 16795--><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 @@ -33300,30 +34828,30 @@ 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. 16378--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 16801--><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 + id="dx1-197003"></a></a></span>If you want to switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-194004"></a></a> then you first need to convert the document so that it + id="dx1-197004"></a></a> then you first need to convert the document so that it uses <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, but include the <span id="textcolor677"><span +class="cmss-10">glossaries-extra</span></a>, but include the <span id="textcolor703"><span class="cmss-10">prefix</span></span><a - id="dx1-194005"></a> option to ensure that <span + id="dx1-197005"></a> option to ensure that <span class="cmss-10">glossaries-prefix</span><a - id="dx1-194006"></a> is also loaded: + id="dx1-197006"></a> is also loaded: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor678"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor704"><span class="cmtt-10">record</span></span><span -class="cmtt-10">,</span><span id="textcolor679"><span +class="cmtt-10">,</span><span id="textcolor705"><span class="cmtt-10">prefix</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor680"><span +class="cmtt-10">,</span><span id="textcolor706"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor681"><span +class="cmtt-10">,</span><span id="textcolor707"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,nomain]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -33348,20 +34876,20 @@ class="cmtt-10"> English}</span> </div> </div> Next the entries need to be converted to the <span class="cmtt-10">bib</span><a - id="dx1-194007"></a> format required by <a + id="dx1-197007"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-194008"></a></a>: -<!--l. 16394--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-197008"></a></a>: +<!--l. 16817--><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> This creates the file <span class="cmtt-10">entries.bib </span>that contains entries defined like: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor682"><span +<span id="textcolor708"><span class="cmtt-10">@entry</span></span><a - id="dx1-194009"></a><span + id="dx1-197009"></a><span class="cmtt-10">{en-cat,</span> <br /><span class="cmtt-10"> </span><span @@ -33382,9 +34910,9 @@ class="cmtt-10"> {english}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor683"><span +<br /><span id="textcolor709"><span class="cmtt-10">@entry</span></span><a - id="dx1-194010"></a><span + id="dx1-197010"></a><span class="cmtt-10">{fr-cat,</span> <br /><span class="cmtt-10"> </span><span @@ -33414,18 +34942,18 @@ class="cmtt-10">}</span> </div> </div> (Note that the <span class="cmtt-10">sort</span><a - id="dx1-194011"></a> field has been omitted.) -<!--l. 16415--><p class="indent" > This would be more flexible, and much briefer, if these entries were defined using <a + id="dx1-197011"></a> field has been omitted.) +<!--l. 16838--><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 + id="dx1-197012"></a>’s</a> dual entry system combined with the <span class="cmss-10">glossaries-prefix</span><a - id="dx1-194013"></a> package: </p><div class="alltt"> + id="dx1-197013"></a> package: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor684"><span +<span id="textcolor710"><span class="cmtt-10">@dualentry</span></span><a - id="dx1-194014"></a><span + id="dx1-197014"></a><span class="cmtt-10">{cat,</span> <br /><span class="cmtt-10"> </span><span @@ -33440,13 +34968,13 @@ class="cmtt-10"> {cat},</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> prefix</span><a - id="dx1-194015"></a><span + id="dx1-197015"></a><span class="cmtt-10"> =</span><span class="cmtt-10"> {le},</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> prefixplural</span><a - id="dx1-194016"></a><span + id="dx1-197016"></a><span class="cmtt-10"> =</span><span class="cmtt-10"> {les}</span> <br /><span @@ -33454,9 +34982,9 @@ class="cmtt-10">}</span> </div> </div> Similarly for the “chair” entry: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor685"><span +<span id="textcolor711"><span class="cmtt-10">@dualentry</span></span><a - id="dx1-194017"></a><span + id="dx1-197017"></a><span class="cmtt-10">{chair,</span> <br /><span class="cmtt-10"> </span><span @@ -33471,78 +34999,78 @@ class="cmtt-10"> {chair},</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> prefix</span><a - id="dx1-194018"></a><span + id="dx1-197018"></a><span class="cmtt-10"> =</span><span class="cmtt-10"> {la},</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> prefixplural</span><a - id="dx1-194019"></a><span + id="dx1-197019"></a><span class="cmtt-10"> =</span><span class="cmtt-10"> {les}</span> <br /><span class="cmtt-10">}</span> </div> </div> -<!--l. 16436--><p class="indent" > With <span id="textcolor686"><span +<!--l. 16859--><p class="indent" > With <span id="textcolor712"><span class="cmtt-10">@dualentry</span></span><a - id="dx1-194020"></a>, the English and French terms are now automatically linked from <a + id="dx1-197020"></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. + id="dx1-197021"></a>’s</a> point of view. If only one is referenced in the document, the other will also be added by default. -</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 +</p><!--l. 16863--><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> <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor687"><span +<span id="textcolor713"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-194022"></a><span -class="cmtt-10">[</span><span id="textcolor688"><span + id="dx1-197022"></a><span +class="cmtt-10">[</span><span id="textcolor714"><span class="cmtt-10">src</span></span><a - id="dx1-194023"></a><span + id="dx1-197023"></a><span class="cmtt-10">=entries,%</span><span class="cmtt-10"> entries.bib</span> <br /><span -class="cmtt-10"> </span><span id="textcolor689"><span +class="cmtt-10"> </span><span id="textcolor715"><span class="cmtt-10">append-prefix-field</span></span><span class="cmtt-10">={space},</span> <br /><span -class="cmtt-10"> </span><span id="textcolor690"><span +class="cmtt-10"> </span><span id="textcolor716"><span class="cmtt-10">category</span></span><a - id="dx1-194024"></a><span + id="dx1-197024"></a><span class="cmtt-10">={same</span><span class="cmtt-10"> as</span><span -class="cmtt-10"> type},</span><span id="textcolor691"><span +class="cmtt-10"> type},</span><span id="textcolor717"><span class="cmtt-10">dual-category</span></span><a - id="dx1-194025"></a><span + id="dx1-197025"></a><span class="cmtt-10">={same</span><span class="cmtt-10"> as</span><span class="cmtt-10"> type},</span> <br /><span -class="cmtt-10"> </span><span id="textcolor692"><span +class="cmtt-10"> </span><span id="textcolor718"><span class="cmtt-10">label-prefix</span></span><span -class="cmtt-10">={en-},</span><span id="textcolor693"><span +class="cmtt-10">={en-},</span><span id="textcolor719"><span class="cmtt-10">dual-prefix</span></span><a - id="dx1-194026"></a><span + id="dx1-197026"></a><span class="cmtt-10">={fr-},</span> <br /><span -class="cmtt-10"> </span><span id="textcolor694"><span +class="cmtt-10"> </span><span id="textcolor720"><span class="cmtt-10">type</span></span><a - id="dx1-194027"></a><span -class="cmtt-10">=english,</span><span id="textcolor695"><span + id="dx1-197027"></a><span +class="cmtt-10">=english,</span><span id="textcolor721"><span class="cmtt-10">dual-type</span></span><a - id="dx1-194028"></a><span + id="dx1-197028"></a><span class="cmtt-10">=french,</span> <br /><span -class="cmtt-10"> </span><span id="textcolor696"><span +class="cmtt-10"> </span><span id="textcolor722"><span class="cmtt-10">sort</span></span><a - id="dx1-194029"></a><span -class="cmtt-10">=en,</span><span id="textcolor697"><span + id="dx1-197029"></a><span +class="cmtt-10">=en,</span><span id="textcolor723"><span class="cmtt-10">dual-sort</span></span><a - id="dx1-194030"></a><span + id="dx1-197030"></a><span class="cmtt-10">=fr]</span> @@ -33551,68 +35079,68 @@ class="cmtt-10">=fr]</span> class="cmtt-10">\newcommand{\FrEncap}[1]{%</span> <br /><span class="cmtt-10"> \foreignlanguage</span><a - id="dx1-194031"></a><span + id="dx1-197031"></a><span class="cmtt-10">{french}{\glsentryprefix</span><a - id="dx1-194032"></a><span + id="dx1-197032"></a><span class="cmtt-10">{\glscurrententrylabel</span><a - id="dx1-194033"></a><span + id="dx1-197033"></a><span class="cmtt-10">}#1}}</span> <br /><span class="cmtt-10">\newcommand{\EnEncap}[1]{\foreignlanguage</span><a - id="dx1-194034"></a><span + id="dx1-197034"></a><span class="cmtt-10">{english}{#1}}</span> <br /> -<br /><span id="textcolor698"><span +<br /><span id="textcolor724"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-194035"></a><span + id="dx1-197035"></a><span class="cmtt-10">{english}{glossnamefont}{EnEncap}</span> -<br /><span id="textcolor699"><span +<br /><span id="textcolor725"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-194036"></a><span + id="dx1-197036"></a><span class="cmtt-10">{english}{glossdescfont}{FrEncap}</span> -<br /><span id="textcolor700"><span +<br /><span id="textcolor726"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-194037"></a><span + id="dx1-197037"></a><span class="cmtt-10">{french}{glossnamefont}{FrEncap}</span> -<br /><span id="textcolor701"><span +<br /><span id="textcolor727"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-194038"></a><span + id="dx1-197038"></a><span class="cmtt-10">{french}{glossdescfont}{EnEncap}</span> </div> </div> -<!--l. 16463--><p class="indent" > Remember to remove <span +<!--l. 16886--><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 class="cmtt-10">\printglossary </span>with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor702"><span +<span id="textcolor728"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-194039"></a> + id="dx1-197039"></a> </div> </div> -<!--l. 16470--><p class="indent" > Other refinements that you might like to make include using <span id="textcolor703"><span +<!--l. 16893--><p class="indent" > Other refinements that you might like to make include using <span id="textcolor729"><span class="cmtt-10">\glsxtrnewglslike</span></span><a - id="dx1-194040"></a> so you don’t have to worry + id="dx1-197040"></a> so you don’t have to worry about the label prefix (“en-” and “fr-”). <a - id="x1-194041r18"></a> -</p><!--l. 16474--><p class="noindent" > + id="x1-197041r18"></a> +</p><!--l. 16897--><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. 16474--><p class="noindent" >This document uses the <span +<!--l. 16897--><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 class="cmtt-10">makeglossaries</span><a - id="dx1-195001"></a></a> (or <a + id="dx1-198001"></a></a> (or <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. 16479--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-198002"></a></a>) calls to ensure the document is up to date: +</p><!--l. 16902--><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 @@ -33620,24 +35148,24 @@ class="cmtt-10">makeglossaries-lite</span><a <br />pdflatex sample-index <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 16487--><p class="noindent" > +</p><!--l. 16910--><p class="noindent" > </p> -<!--l. 16487--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.5 </span> <a +<!--l. 16910--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.5 </span> <a id="sec:samplessort"></a>Sorting</h3> <a - id="x1-196001r19"></a> + id="x1-199001r19"></a> -<!--l. 16490--><p class="noindent" > +<!--l. 16913--><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. 16490--><p class="noindent" >This document illustrates how you can hook into the standard sort mechanism to adjust the way the sort key is +<!--l. 16913--><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. 16494--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 16917--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplePeople <br />makeglossaries samplePeople <br />pdflatex samplePeople @@ -33648,29 +35176,29 @@ This provides two commands for typesetting a name: </p> - <div class="verbatim" id="verbatim-438"> + <pre class="verbatim" id="verbatim-445"> \newcommand{\sortname}[2]{#2, #1} - <br />\newcommand{\textname}[2]{#1 #2} -</div> -<!--l. 16504--><p class="nopar" > where the first argument contains the forenames and the second is the surname. The first command is the one +\newcommand{\textname}[2]{#1 #2} +</pre> +<!--l. 16927--><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-439"> + <pre class="verbatim" id="verbatim-446"> \let\name\textname -</div> -<!--l. 16511--><p class="nopar" > This command defaults to the display name command (<span +</pre> +<!--l. 16934--><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 class="cmtt-10">sort</span><a - id="dx1-197001"></a> field assignment hook: </p><div class="alltt"> + id="dx1-200001"></a> field assignment hook: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\renewcommand{\glsprestandardsort</span><a - id="dx1-197002"></a><span + id="dx1-200002"></a><span class="cmtt-10">}[3]{%</span> <br /><span class="cmtt-10"> </span><strong><span @@ -33682,7 +35210,7 @@ class="cmtt-10"> </span><strong><span class="cmtt-10">\let\name\textname</span></strong> <br /><span class="cmtt-10"> \glsdosanitizesort</span><a - id="dx1-197003"></a> + id="dx1-200003"></a> <br /><span class="cmtt-10">}</span> </div> @@ -33699,25 +35227,25 @@ class="cmtt-10"> description={\nopostdesc}}</span> </div> Since <span 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 + id="dx1-200004"></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. 16532--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 16955--><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 + id="dx1-200005"></a></a></span>If you want to use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-197006"></a></a>, you first need to convert the document to use <a + id="dx1-200006"></a></a>, you first need to convert the document to use <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> but make -sure you include the <span id="textcolor704"><span +sure you include the <span id="textcolor730"><span class="cmss-10">record</span></span><a - id="dx1-197007"></a> option: </p><div class="alltt"> + id="dx1-200007"></a> option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor705"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor731"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor706"><span +class="cmtt-10">,</span><span id="textcolor732"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,style=listgroup]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -33725,12 +35253,12 @@ class="cmtt-10">}</span> </div> </div> Next it’s necessary to convert the entry definitions to the <span class="cmtt-10">bib</span><a - id="dx1-197008"></a> format required by <a + id="dx1-200008"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-197009"></a></a>. You can simply + id="dx1-200009"></a></a>. You can simply do: -<!--l. 16541--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16964--><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> @@ -33739,9 +35267,9 @@ class="cmtt-10">people.bib </span>that contains definitions like: </p><div class <div class="obeylines-v"> -<span id="textcolor707"><span +<span id="textcolor733"><span class="cmtt-10">@entry</span></span><a - id="dx1-197010"></a><span + id="dx1-200010"></a><span class="cmtt-10">{joebloggs,</span> <br /><span class="cmtt-10"> </span><span @@ -33753,7 +35281,7 @@ class="cmtt-10"> </span><span class="cmtt-10"> description</span><span class="cmtt-10"> =</span><span class="cmtt-10"> {\nopostdesc</span><a - id="dx1-197011"></a><span + id="dx1-200011"></a><span class="cmtt-10">}</span> <br /><span class="cmtt-10">}</span> @@ -33761,30 +35289,30 @@ 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. 16554--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 16977--><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> This will discard the <span class="cmtt-10">description</span><a - id="dx1-197012"></a> field and use <span id="textcolor708"><span + id="dx1-200012"></a> field and use <span id="textcolor734"><span class="cmtt-10">@index</span></span><a - id="dx1-197013"></a> instead of <span id="textcolor709"><span + id="dx1-200013"></a> instead of <span id="textcolor735"><span class="cmtt-10">@entry</span></span><a - id="dx1-197014"></a> if the <span + id="dx1-200014"></a> if the <span class="cmtt-10">description</span><a - id="dx1-197015"></a> is either empty or + id="dx1-200015"></a> is either empty or simply set to <span class="cmtt-10">\nopostdesc</span><a - id="dx1-197016"></a> or <span id="textcolor710"><span + id="dx1-200016"></a> or <span id="textcolor736"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-197017"></a>. The <span + id="dx1-200017"></a>. The <span class="cmtt-10">people.bib </span>file now contains definitions like: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor711"><span +<span id="textcolor737"><span class="cmtt-10">@index</span></span><a - id="dx1-197018"></a><span + id="dx1-200018"></a><span class="cmtt-10">{joebloggs,</span> <br /><span class="cmtt-10"> </span><span @@ -33796,26 +35324,26 @@ class="cmtt-10">}</span> </div> </div> Regardless of which approach you used to create the <span class="cmtt-10">bib</span><a - id="dx1-197019"></a> file, you now need to edit it to provide a definition of + id="dx1-200019"></a> file, you now need to edit it to provide a definition of the custom <span class="cmtt-10">\name </span>command for <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-197020"></a>’s</a> use: <div class="alltt"> + id="dx1-200020"></a>’s</a> use: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor712"><span +<span id="textcolor738"><span class="cmtt-10">@preamble</span></span><a - id="dx1-197021"></a><span + id="dx1-200021"></a><span class="cmtt-10">{"</span><strong><span class="cmtt-10">\providecommand</span><a - id="dx1-197022"></a></strong><span + id="dx1-200022"></a></strong><span class="cmtt-10">{\name}[2]{#2,</span><span class="cmtt-10"> #1}"}</span> </div> </div> Note the use of <span class="cmtt-10">\providecommand </span>instead of <span class="cmtt-10">\newcommand</span>. -<!--l. 16575--><p class="indent" > In the document (<span +<!--l. 16998--><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 @@ -33828,26 +35356,26 @@ the document preamble: </p><div class="alltt"> <span class="cmtt-10">\newcommand{\name}[2]{#1</span><span class="cmtt-10"> #2}</span> -<br /><span id="textcolor713"><span +<br /><span id="textcolor739"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-197023"></a><span -class="cmtt-10">[</span><span id="textcolor714"><span + id="dx1-200023"></a><span +class="cmtt-10">[</span><span id="textcolor740"><span class="cmtt-10">src</span></span><a - id="dx1-197024"></a><span + id="dx1-200024"></a><span class="cmtt-10">=people]</span> </div> </div> Next, use your text editor’s search and replace function to subsitute all instances of <span class="cmtt-10">\glsentrytext </span>in the -chapter headings with <span id="textcolor715"><span +chapter headings with <span id="textcolor741"><span class="cmtt-10">\glsfmttext</span></span><a - id="dx1-197025"></a>. For example: <div class="alltt"> + id="dx1-200025"></a>. For example: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\chapter</span><a - id="dx1-197026"></a><span -class="cmtt-10">{</span><strong><span id="textcolor716"><span + id="dx1-200026"></a><span +class="cmtt-10">{</span><strong><span id="textcolor742"><span class="cmtt-10">\glsfmttext</span></span><a - id="dx1-197027"></a></strong><span + id="dx1-200027"></a></strong><span class="cmtt-10">{joebloggs}}</span> </div> </div> Finally, replace <span @@ -33855,12 +35383,12 @@ class="cmtt-10">\printunsrtglossaries </span>with: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor717"><span +<span id="textcolor743"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-197028"></a> + id="dx1-200028"></a> </div> </div> The document build is now: -<!--l. 16594--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17017--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplePeople <br />bib2gls samplePeople <br />pdflatex samplePeople @@ -33871,44 +35399,44 @@ The third LaTeX call is required to ensure that the PDF bookmarks are up aren’t defined until after the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-197029"></a></a> run (which is why you have to use <span id="textcolor718"><span + id="dx1-200029"></a></a> run (which is why you have to use <span id="textcolor744"><span class="cmtt-10">\glsfmttext</span></span><a - id="dx1-197030"></a> instead of + id="dx1-200030"></a> instead of <span class="cmtt-10">\glsentrytext</span>). -</p><!--l. 16605--><p class="indent" > This again leads to a list sorted by surname. The reason this works is because <a +</p><!--l. 17028--><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 + id="dx1-200031"></a></a> only sees the definition of <span -class="cmtt-10">\name </span>provided in <span id="textcolor719"><span +class="cmtt-10">\name </span>provided in <span id="textcolor745"><span class="cmtt-10">@preamble</span></span><a - id="dx1-197032"></a>, but the document uses the definition of <span + id="dx1-200032"></a>, but the document uses the definition of <span class="cmtt-10">\name </span>provided before <span class="cmtt-10">\GlsXtrLoadResources</span>. The use of <span class="cmtt-10">\providecommand</span><a - id="dx1-197033"></a> in <span id="textcolor720"><span + id="dx1-200033"></a> in <span id="textcolor746"><span class="cmtt-10">@preamble</span></span><a - id="dx1-197034"></a> prevents <span + id="dx1-200034"></a> prevents <span class="cmtt-10">\name </span>from being redefined within the document. -</p><!--l. 16612--><p class="indent" > See also the “Examples” chapter of the <a +</p><!--l. 17035--><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” + id="dx1-200035"></a></a> user manual, which provides another “people” example. <a - id="x1-197036r20"></a> -</p><!--l. 16615--><p class="noindent" > + id="x1-200036r20"></a> +</p><!--l. 17038--><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. 16615--><p class="noindent" >This is another document that illustrates how to hook into the standard sort mechanism. An additional run is +<!--l. 17038--><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. 16618--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17041--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSort <br />makeglossaries sampleSort <br />pdflatex sampleSort @@ -33922,12 +35450,12 @@ class="cmtt-10">notation</span>), so if you want to use <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-198001"></a></a> explicitly you will need to have three <a + id="dx1-201001"></a></a> explicitly you will need to have three <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-198002"></a></a> calls with the appropriate file + id="dx1-201002"></a></a> calls with the appropriate file extensions: -</p><!--l. 16628--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17051--><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 @@ -33941,42 +35469,42 @@ extensions: It’s much simpler to just use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-198003"></a></a> or <a + id="dx1-201003"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-198004"></a></a>. -</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 + id="dx1-201004"></a></a>. +</p><!--l. 17061--><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-440"> + <pre class="verbatim" id="verbatim-447"> \newcounter{sortcount} -</div> -<!--l. 16643--><p class="nopar" > The sort hook is then redefined to increment this counter and assign the sort key to that numerical +</pre> +<!--l. 17066--><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-441"> + <pre class="verbatim" id="verbatim-448"> \renewcommand{\glsprestandardsort}[3]{% - <br />  \ifdefstring{#2}{notation}% - <br />  {% - <br />     \stepcounter{sortcount}% - <br />     \edef#1{\glssortnumberfmt{\arabic{sortcount}}}% - <br />  }% - <br />  {% - <br />     \glsdosanitizesort - <br />  }% - <br />} -</div> -<!--l. 16659--><p class="nopar" > This means that <a +  \ifdefstring{#2}{notation}% +  {% +     \stepcounter{sortcount}% +     \edef#1{\glssortnumberfmt{\arabic{sortcount}}}% +  }% +  {% +     \glsdosanitizesort +  }% +} +</pre> +<!--l. 17082--><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. 16662--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a + id="dx1-201005"></a></a> will sort the notation in numerical order. +</p><!--l. 17085--><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 @@ -33984,9 +35512,9 @@ class="cmss-10">glossaries-extra</span></a>, a much simpler approach is available with its hybrid method. First change the package loading line to: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><span id="textcolor721"><span +class="cmtt-10">\usepackage[</span><span id="textcolor747"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor722"><span +class="cmtt-10">,</span><span id="textcolor748"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,acronym]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -33994,24 +35522,24 @@ class="cmtt-10">}</span> </div> </div> Either remove <span class="cmtt-10">\setacronymstyle </span>and replace all instances of <span -class="cmtt-10">\newacronym </span>with <span id="textcolor723"><span +class="cmtt-10">\newacronym </span>with <span id="textcolor749"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-198006"></a> or + id="dx1-201006"></a> or replace: - <div class="verbatim" id="verbatim-442"> + <pre class="verbatim" id="verbatim-449"> \setacronymstyle{long-short} -</div> -<!--l. 16673--><p class="nopar" > with: </p><div class="alltt"> +</pre> +<!--l. 17096--><p class="nopar" > with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor724"><span +<span id="textcolor750"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-198007"></a><span + id="dx1-201007"></a><span class="cmtt-10">[acronym]{long-short}</span> </div> </div> -<!--l. 16679--><p class="indent" > The custom counter and redefinition of <span +<!--l. 17102--><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: @@ -34024,11 +35552,11 @@ class="cmtt-10">{notation}{Notation}</span> </div> </div> The <span class="cmtt-10">\makeglossaries</span><a - id="dx1-198008"></a> command now needs to be adjusted to indicate which glossaries need to be processed by + id="dx1-201008"></a> command now needs to be adjusted to indicate which glossaries need to be processed by <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-198009"></a></a>: <div class="alltt"> + id="dx1-201009"></a></a>: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\makeglossaries</span><strong><span @@ -34036,7 +35564,7 @@ class="cmtt-10">[main,acronym]</span></strong> </div> </div> Finally, <span class="cmtt-10">\printglossaries</span><a - id="dx1-198010"></a> needs to be replaced with: <div class="alltt"> + id="dx1-201010"></a> needs to be replaced with: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\printglossary</span> @@ -34054,22 +35582,22 @@ class="cmtt-10">notation </span>glossary, which hasn’t been listed in the class="cmtt-10">\makeglossaries</span>, must be displayed with <span class="cmtt-10">\printnoidxglossary</span><a - id="dx1-198011"></a>. -<!--l. 16700--><p class="indent" > This means that <a + id="dx1-201011"></a>. +<!--l. 17123--><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 + id="dx1-201012"></a></a> only needs to process the <span class="cmtt-10">main </span>and <span class="cmtt-10">acronym </span>glossaries. No actual sorting is performed for the <span class="cmtt-10">notation </span>glossary because, when used with <a - id="dx1-198013"></a><span + id="dx1-201013"></a><span 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. 16706--><p class="indent" > The document build doesn’t need the third LaTeX call now (since none of the glossaries extend beyond a +</p><!--l. 17129--><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. 16708--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17131--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleSort <br />makeglossaries sampleSort @@ -34080,44 +35608,44 @@ page break): This time <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-198014"></a></a> will include the message: + id="dx1-201014"></a></a> will include the message: </p> - <div class="verbatim" id="verbatim-443"> + <pre class="verbatim" id="verbatim-450"> only processing subset 'main,acronym' -</div> -<!--l. 16716--><p class="nopar" > This means that although <a +</pre> +<!--l. 17139--><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 + id="dx1-201015"></a></a> has noticed the <span class="cmtt-10">notation </span>glossary, it will be skipped. -</p><!--l. 16720--><p class="indent" > If you are explicitly calling <a +</p><!--l. 17143--><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 + id="dx1-201016"></a></a> then you need to drop the call for the <span class="cmtt-10">notation </span>glossary: -</p><!--l. 16722--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17145--><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. 16729--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 17152--><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 + id="dx1-201017"></a></a></span>If you prefer to use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-198018"></a></a>, the package loading line needs to be changed to: </p><div class="alltt"> + id="dx1-201018"></a></a>, the package loading line needs to be changed to: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor725"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor751"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor726"><span +class="cmtt-10">,</span><span id="textcolor752"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor727"><span +class="cmtt-10">,</span><span id="textcolor753"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,acronym]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -34125,30 +35653,31 @@ class="cmtt-10">}</span> </div> </div> Next the entry definitions need to be convert to the <span class="cmtt-10">bib</span><a - id="dx1-198019"></a> format required by <a + id="dx1-201019"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-198020"></a></a>. -<!--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 + id="dx1-201020"></a></a>. +<!--l. 17161--><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. 16741--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17164--><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> This will create three files: </p><dl class="description"><dt class="description"> + <!--l. 17169--><p class="noindent" > <span -class="cmtt-10">entries.bib</span> </dt><dd -class="description">which contains the entries that were defined with <span +class="cmtt-10">entries.bib</span> </p></dt><dd +class="description"> + <!--l. 17169--><p class="noindent" >which contains the entries that were defined with <span class="cmtt-10">\newglossaryentry</span><a - id="dx1-198021"></a>. For example: - <div class="alltt"> + id="dx1-201021"></a>. For example: </p><div class="alltt"> <div class="obeylines-v"> - <span id="textcolor728"><span + <span id="textcolor754"><span class="cmtt-10">@entry</span></span><a - id="dx1-198022"></a><span + id="dx1-201022"></a><span class="cmtt-10">{gls:set,</span> <br /><span class="cmtt-10"> </span><span @@ -34171,16 +35700,17 @@ class="cmtt-10">}</span> </dd><dt class="description"> + <!--l. 17178--><p class="noindent" > <span -class="cmtt-10">abbreviations.bib</span> </dt><dd -class="description">which contains the entries that were defined with <span +class="cmtt-10">abbreviations.bib</span> </p></dt><dd +class="description"> + <!--l. 17178--><p class="noindent" >which contains the entries that were defined with <span class="cmtt-10">\newacronym</span><a - id="dx1-198023"></a>. For example: - <div class="alltt"> + id="dx1-201023"></a>. For example: </p><div class="alltt"> <div class="obeylines-v"> - <span id="textcolor729"><span + <span id="textcolor755"><span class="cmtt-10">@acronym</span></span><a - id="dx1-198024"></a><span + id="dx1-201024"></a><span class="cmtt-10">{zfc,</span> <br /><span class="cmtt-10"> </span><span @@ -34199,16 +35729,16 @@ class="cmtt-10">}</span> </div> </div> If you changed <span class="cmtt-10">\newacronym</span><a - id="dx1-198025"></a> to <span id="textcolor730"><span + id="dx1-201025"></a> to <span id="textcolor756"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-198026"></a> then <span id="textcolor731"><span + id="dx1-201026"></a> then <span id="textcolor757"><span class="cmtt-10">@abbreviation</span></span><a - id="dx1-198027"></a> will be used instead: + id="dx1-201027"></a> will be used instead: <div class="alltt"> <div class="obeylines-v"> - <span id="textcolor732"><span + <span id="textcolor758"><span class="cmtt-10">@abbreviation</span></span><a - id="dx1-198028"></a><span + id="dx1-201028"></a><span class="cmtt-10">{zfc,</span> <br /><span class="cmtt-10"> </span><span @@ -34227,17 +35757,18 @@ class="cmtt-10">}</span> </div> </div> </dd><dt class="description"> + <!--l. 17195--><p class="noindent" > <span -class="cmtt-10">notation.bib</span> </dt><dd -class="description">which contains the entries that were defined with <span +class="cmtt-10">notation.bib</span> </p></dt><dd +class="description"> + <!--l. 17195--><p class="noindent" >which contains the entries that were defined with <span class="cmtt-10">type</span><a - id="dx1-198029"></a><span -class="cmtt-10">=notation</span>. For example: - <div class="alltt"> + id="dx1-201029"></a><span +class="cmtt-10">=notation</span>. For example: </p><div class="alltt"> <div class="obeylines-v"> - <span id="textcolor733"><span + <span id="textcolor759"><span class="cmtt-10">@entry</span></span><a - id="dx1-198030"></a><span + id="dx1-201030"></a><span class="cmtt-10">{not:set,</span> <br /><span class="cmtt-10"> </span><span @@ -34262,12 +35793,12 @@ class="cmtt-10"> {\mathcal{S}}</span> <br /><span class="cmtt-10">}</span> </div> - </div> You may prefer to replace <span id="textcolor734"><span + </div> You may prefer to replace <span id="textcolor760"><span class="cmtt-10">@entry</span></span><a - id="dx1-198031"></a> with <span id="textcolor735"><span + id="dx1-201031"></a> with <span id="textcolor761"><span class="cmtt-10">@symbol</span></span><a - id="dx1-198032"></a> in this file.</dd></dl> -<!--l. 16784--><p class="noindent" ><span + id="dx1-201032"></a> in this file.</dd></dl> +<!--l. 17207--><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"> @@ -34282,52 +35813,52 @@ class="cmtt-10"> must</span><span class="cmtt-10"> be</span><span class="cmtt-10"> set</span><span class="cmtt-10"> first:</span> -<br /><span id="textcolor736"><span +<br /><span id="textcolor762"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-198033"></a><span + id="dx1-201033"></a><span class="cmtt-10">[acronym]{long-short}</span> -<br /><span id="textcolor737"><span +<br /><span id="textcolor763"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-198034"></a><span -class="cmtt-10">[</span><span id="textcolor738"><span + id="dx1-201034"></a><span +class="cmtt-10">[</span><span id="textcolor764"><span class="cmtt-10">src</span></span><a - id="dx1-198035"></a><span + id="dx1-201035"></a><span class="cmtt-10">={entries,abbreviations}]</span> -<br /><span id="textcolor739"><span +<br /><span id="textcolor765"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-198036"></a><span -class="cmtt-10">[</span><span id="textcolor740"><span + id="dx1-201036"></a><span +class="cmtt-10">[</span><span id="textcolor766"><span class="cmtt-10">src</span></span><a - id="dx1-198037"></a><span + id="dx1-201037"></a><span class="cmtt-10">={notation},%</span><span class="cmtt-10"> notation.bib</span> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor741"><span +class="cmtt-10"> </span><strong><span id="textcolor767"><span class="cmtt-10">type</span></span><span class="cmtt-10">=notation</span></strong><span -class="cmtt-10">,</span><span id="textcolor742"><span +class="cmtt-10">,</span><span id="textcolor768"><span class="cmtt-10">sort</span></span><a - id="dx1-198038"></a><span + id="dx1-201038"></a><span class="cmtt-10">=</span><strong><span class="cmtt-10">unsrt</span></strong><span class="cmtt-10">]</span> </div> </div> Delete the remainder of the preamble (<span class="cmtt-10">\makeglossaries </span>and entry definitions). -<!--l. 16796--><p class="indent" > Finally, replace the lines that display the glossaries with: </p><div class="alltt"> +<!--l. 17219--><p class="indent" > Finally, replace the lines that display the glossaries with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor743"><span +<span id="textcolor769"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-198039"></a> + id="dx1-201039"></a> </div> </div> The build process is now: -<!--l. 16801--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 17224--><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. 16807--><p class="indent" > In this case, I have one resource command that processes two glossaries (<span +</p><!--l. 17230--><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 @@ -34335,39 +35866,39 @@ time. The entries in these glossaries are ordered alphabetically. The second res class="cmtt-10">notation </span>glossary but the entries in this glossary aren’t sorted (and so will appear in the order of definition within the <span class="cmtt-10">bib</span><a - id="dx1-198040"></a> file). -</p><!--l. 16814--><p class="indent" > See also <a + id="dx1-201040"></a> file). +</p><!--l. 17237--><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 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. 16817--><p class="noindent" > + id="dx1-201041"></a></a> user manual for more examples. +</p><!--l. 17240--><p class="noindent" > </p> -<!--l. 16817--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.6 </span> <a +<!--l. 17240--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.6 </span> <a id="sec:samplesparent"></a>Child Entries</h3> <a - id="x1-199001r21"></a> -<!--l. 16820--><p class="noindent" > + id="x1-202001r21"></a> +<!--l. 17243--><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. 16820--><p class="noindent" >This document illustrates some of the basics, including how to create child entries that use the same name as +<!--l. 17243--><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 + id="dx1-203001"></a>, so an 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 +</p><!--l. 17248--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample + <br />makeglossaries sample + <br />pdflatex sample <br />pdflatex sample <br /></pre><spacer type=vertical size=10> <br /></span> @@ -34375,21 +35906,21 @@ You can see the difference between word and letter ordering if you add the packa class="cmss-10">order</span><span class="cmtt-10">=</span><span class="cmss-10">letter</span><a - id="dx1-200002"></a>. (Note + id="dx1-203002"></a>. (Note that this will only have an effect if you use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-200003"></a></a> or <a + id="dx1-203003"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-200004"></a></a>. If you use <a + id="dx1-203004"></a></a>. If you use <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-200005"></a></a> + id="dx1-203005"></a></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. 16838--><p class="indent" > One of the entries has its name encapsulated with a semantic command: </p><div class="alltt"> + id="dx1-203006"></a> switch to indicate letter ordering.) +</p><!--l. 17261--><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 @@ -34408,41 +35939,41 @@ class="cmtt-10"> language}}</span> </div> </div> This means that this entry needs to have the <span class="cmtt-10">sort</span><a - id="dx1-200007"></a> key set otherwise <a + id="dx1-203007"></a> key set otherwise <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-200008"></a></a> will assign it + id="dx1-203008"></a></a> will assign it to the “symbol” letter group, since it starts with a backslash (which <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-200009"></a></a> simply treats as + id="dx1-203009"></a></a> simply treats as punctuation). -<!--l. 16850--><p class="indent" > The homograph entries “glossary” and “bravo” are defined as sub-entries that inherit the name from the +<!--l. 17273--><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 class="cmss-10">false</span><a - id="dx1-200010"></a> setting this will + id="dx1-203010"></a> setting this will 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 + id="dx1-203011"></a> to the description, which suppresses the post-description hook for that entry. -</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 +</p><!--l. 17280--><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"> + id="dx1-203012"></a> key: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{glossary}{name=glossary,</span> <br /><span class="cmtt-10"> description={</span><strong><span class="cmtt-10">\nopostdesc</span><a - id="dx1-200013"></a></strong><span + id="dx1-203013"></a></strong><span class="cmtt-10">},plural={glossaries}}</span> <br /> <br /><span class="cmtt-10">\newglossaryentry</span><a - id="dx1-200014"></a><span + id="dx1-203014"></a><span class="cmtt-10">{glossarycol}{</span> <br /><span class="cmtt-10"> description={collection</span><span @@ -34482,19 +36013,19 @@ 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. 16880--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a + + +<!--l. 17303--><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 class="cmss-10">glossaries-extra</span></a>, remember that the default package options are different: </p><div class="alltt"> - - <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor744"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor770"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor745"><span +class="cmtt-10">,</span><span id="textcolor771"><span class="cmtt-10">stylemods</span></span></strong><span class="cmtt-10">,style=treenonamegroup,order=word,</span> <br /><span @@ -34504,103 +36035,103 @@ class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> </div> -<!--l. 16888--><p class="indent" > You may now want to consider replacing <span +<!--l. 17311--><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 + id="dx1-203015"></a> in the descriptions with <span id="textcolor772"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-200016"></a> (using + id="dx1-203016"></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. 16894--><p class="indent" > You may have noticed that some of the descriptions include the plural form, but it’s not done very +</p><!--l. 17317--><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-444"> + <pre class="verbatim" id="verbatim-451"> \newglossaryentry{cow}{name=cow, - <br />  plural=cows,% not required as this is the default - <br />  user1=kine, - <br />  description={(\emph{pl.}\ cows, \emph{archaic} kine) an adult - <br />female of any bovine animal} - <br />} -</div> -<!--l. 16903--><p class="nopar" > which has the parenthetical material at the start of the description with emphasis, +  plural=cows,% not required as this is the default +  user1=kine, +  description={(\emph{pl.}\ cows, \emph{archaic} kine) an adult +female of any bovine animal} +} +</pre> +<!--l. 17326--><p class="nopar" > which has the parenthetical material at the start of the description with emphasis, </p> - <div class="verbatim" id="verbatim-445"> + <pre class="verbatim" id="verbatim-452"> \newglossaryentry{bravocry}{ - <br />  description={cry of approval (pl.\ bravos)}, - <br />  sort={1}, - <br />  parent={bravo} - <br />} -</div> -<!--l. 16912--><p class="nopar" > which has the parenthetical material at the end of the description without emphasis even though it’s a regular +  description={cry of approval (pl.\ bravos)}, +  sort={1}, +  parent={bravo} +} +</pre> +<!--l. 17335--><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-446"> + <pre class="verbatim" id="verbatim-453"> \newglossaryentry{bravoruffian}{ - <br />  description={hired ruffian or killer (pl.\ bravoes)}, - <br />  sort={2}, - <br />  plural={bravoes}, - <br />  parent=bravo} -</div> -<!--l. 16921--><p class="nopar" > which has the parenthetical material at the end of the description without emphasis, and +  description={hired ruffian or killer (pl.\ bravoes)}, +  sort={2}, +  plural={bravoes}, +  parent=bravo} +</pre> +<!--l. 17344--><p class="nopar" > which has the parenthetical material at the end of the description without emphasis, and </p> - <div class="verbatim" id="verbatim-447"> + <pre class="verbatim" id="verbatim-454"> \newglossaryentry{glossary}{name=glossary, - <br />  description={\nopostdesc}, - <br />  plural={glossaries}} -</div> -<!--l. 16928--><p class="nopar" > which doesn’t show the plural in the description. -</p><!--l. 16931--><p class="indent" > With <a +  description={\nopostdesc}, +  plural={glossaries}} +</pre> +<!--l. 17351--><p class="nopar" > which doesn’t show the plural in the description. +</p><!--l. 17354--><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-448"> + <pre class="verbatim" id="verbatim-455"> \newglossaryentry{cow}{name=cow, - <br />  user1=kine, - <br />  description={an adult female of any bovine animal} - <br />} - <br />\newglossaryentry{bravocry}{ - <br />  description={cry of approval}, - <br />  sort={1}, - <br />  parent={bravo} - <br />} - <br />\newglossaryentry{bravoruffian}{ - <br />  description={hired ruffian or killer}, - <br />  sort={2}, - <br />  plural={bravoes}, - <br />  parent=bravo} -</div> -<!--l. 16951--><p class="nopar" > </p><div class="alltt"> +  user1=kine, +  description={an adult female of any bovine animal} +} +\newglossaryentry{bravocry}{ +  description={cry of approval}, +  sort={1}, +  parent={bravo} +} +\newglossaryentry{bravoruffian}{ +  description={hired ruffian or killer}, +  sort={2}, +  plural={bravoes}, +  parent=bravo} +</pre> +<!--l. 17374--><p class="nopar" > </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{glossary}{name=glossary,</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> description={</span><strong><span id="textcolor747"><span +class="cmtt-10"> description={</span><strong><span id="textcolor773"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-200017"></a></strong><span + id="dx1-203017"></a></strong><span class="cmtt-10">},</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> plural={glossaries}}</span> </div> -</div> The post-description hook for the <span id="textcolor748"><span +</div> The post-description hook for the <span id="textcolor774"><span class="cmss-10">general</span></span><a - id="dx1-200018"></a> category can now be set: <div class="alltt"> + id="dx1-203018"></a> category can now be set: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor749"><span +<span id="textcolor775"><span class="cmtt-10">\glsdefpostdesc</span></span><a - id="dx1-200019"></a><span + id="dx1-203019"></a><span class="cmtt-10">{general}{%</span> <br /><span class="cmti-10">%</span><span @@ -34612,19 +36143,19 @@ class="cmti-10"> been</span><span class="cmti-10"> set?</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor750"><span +class="cmtt-10"> </span><span id="textcolor776"><span class="cmtt-10">\glsxtrifhasfield</span></span><a - id="dx1-200020"></a><span + id="dx1-203020"></a><span class="cmtt-10">{useri}{\glscurrententrylabel</span><a - id="dx1-200021"></a><span + id="dx1-203021"></a><span class="cmtt-10">}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> {\space(\emph{pl.}\</span><span class="cmtt-10"> \glsentryplural</span><a - id="dx1-200022"></a><span + id="dx1-203022"></a><span class="cmtt-10">{\glscurrententrylabel</span><a - id="dx1-200023"></a><span + id="dx1-203023"></a><span class="cmtt-10">},</span> <br /><span class="cmtt-10"> </span><span @@ -34632,7 +36163,7 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \emph{archaic}</span><span class="cmtt-10"> \glscurrentfieldvalue</span><a - id="dx1-200024"></a><span + id="dx1-203024"></a><span class="cmtt-10">)%</span> <br /><span class="cmtt-10"> </span><span @@ -34668,22 +36199,22 @@ class="cmti-10"> appended?</span> class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor751"><span +class="cmtt-10"> </span><span id="textcolor777"><span class="cmtt-10">\GlsXtrIfXpFieldEqXpStr</span></span><a - id="dx1-200025"></a><span + id="dx1-203025"></a><span class="cmtt-10">{plural}{\glscurrententrylabel</span><a - id="dx1-200026"></a><span + id="dx1-203026"></a><span class="cmtt-10">}%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> {\glsentrytext</span><a - id="dx1-200027"></a><span + id="dx1-203027"></a><span class="cmtt-10">{\glscurrententrylabel</span><a - id="dx1-200028"></a><span + id="dx1-203028"></a><span class="cmtt-10">}\glspluralsuffix</span><a - id="dx1-200029"></a><span + id="dx1-203029"></a><span class="cmtt-10">}%</span> <br /><span class="cmtt-10"> </span><span @@ -34698,7 +36229,7 @@ class="cmti-10"> with</span><span class="cmti-10"> </span><a href="#glo:bib2gls"><span class="cmitt-10">bib2gls</span><a - id="dx1-200030"></a></a><span + id="dx1-203030"></a></a><span class="cmti-10"> (see</span><span class="cmti-10"> below)</span> <br /><span @@ -34767,9 +36298,9 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor752"><span +class="cmtt-10"> </span><span id="textcolor778"><span class="cmtt-10">\GlsXtrIfXpFieldEqXpStr</span></span><a - id="dx1-200031"></a><span + id="dx1-203031"></a><span class="cmtt-10">{plural}{\glscurrententrylabel}%</span> <br /><span class="cmtt-10"> </span><span @@ -34841,9 +36372,9 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> {\space(\emph{pl.}\</span><span class="cmtt-10"> \glsentryplural</span><a - id="dx1-200032"></a><span + id="dx1-203032"></a><span class="cmtt-10">{\glscurrententrylabel</span><a - id="dx1-200033"></a><span + id="dx1-203033"></a><span class="cmtt-10">})}%</span> <br /><span class="cmtt-10"> </span><span @@ -34859,45 +36390,45 @@ class="cmtt-10">}</span> </div> (If you try this example out, notice the difference for the <span class="cmtt-10">glossary </span>entry if you use <span class="cmtt-10">\nopostdesc </span>and then -replace it with <span id="textcolor753"><span +replace it with <span id="textcolor779"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-200034"></a>.) See the <a + id="dx1-203034"></a>.) See the <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> user manual for further details and also <a 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. 16998--><p class="indent" > The “bravo” homographs are an oddity where the singular form is identical but the plural is different +<!--l. 17421--><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. 17007--><p class="indent" > While it’s straightforward to access an entry’s parent label (with <span +</p><!--l. 17430--><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 + id="dx1-203035"></a>) it’s much harder to access entry’s children or siblings. The <span class="cmtt-10">\ifglshaschildren</span><a - id="dx1-200036"></a> command has to iterate over all entries to determine + id="dx1-203036"></a> command has to iterate over all entries to determine 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. 17015--><p class="indent" > With <a +</p><!--l. 17438--><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 + id="dx1-203037"></a></a>, it’s possible to save this information with the <span id="textcolor780"><span class="cmtt-10">save-child-count</span></span><a - id="dx1-200038"></a> and <span id="textcolor755"><span + id="dx1-203038"></a> and <span id="textcolor781"><span class="cmtt-10">save-sibling-count</span></span><a - id="dx1-200039"></a>, + id="dx1-203039"></a>, which not only save the total but also save the child or sibling labels in an <span class="cmss-10">etoolbox</span><a - id="dx1-200040"></a> internal list. This makes the + id="dx1-203040"></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. 17022--><p class="indent" > In the above, the comment line: </p><div class="alltt"> +</p><!--l. 17445--><p class="indent" > In the above, the comment line: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmti-10">%</span><span @@ -34907,36 +36438,36 @@ class="cmti-10"> with</span><span class="cmti-10"> </span><a href="#glo:bib2gls"><span class="cmitt-10">bib2gls</span><a - id="dx1-200041"></a></a><span + id="dx1-203041"></a></a><span class="cmti-10"> (see</span><span class="cmti-10"> below)</span> </div> </div> indicates where to put the extra code. If you switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200042"></a></a> and make sure to use <span id="textcolor756"><span + id="dx1-203042"></a></a> and make sure to use <span id="textcolor782"><span class="cmtt-10">save-sibling-count</span></span><a - id="dx1-200043"></a> + id="dx1-203043"></a> then you can insert the following code in the block above where that comment is: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor757"><span +<span id="textcolor783"><span class="cmtt-10">\GlsXtrIfFieldNonZero</span></span><a - id="dx1-200044"></a><span + id="dx1-203044"></a><span class="cmtt-10">{siblingcount}{\glscurrententrylabel}%</span> <br /><span class="cmtt-10">{%</span><span -class="cmtt-10"> </span><span id="textcolor758"><span +class="cmtt-10"> </span><span id="textcolor784"><span class="cmitt-10">siblingcount</span></span><a - id="dx1-200045"></a><span + id="dx1-203045"></a><span class="cmti-10"> field</span><span class="cmti-10"> value</span><span class="cmti-10"> non-zero</span> <br /><span -class="cmtt-10"> </span><span id="textcolor759"><span +class="cmtt-10"> </span><span id="textcolor785"><span class="cmtt-10">\glsxtrfieldforlistloop</span></span><a - id="dx1-200046"></a><span + id="dx1-203046"></a><span class="cmtt-10"> %</span><span class="cmtt-10"> </span><span class="cmti-10">iterate</span><span @@ -34965,9 +36496,9 @@ class="cmti-10"> handler</span> class="cmtt-10">}%</span> <br /><span class="cmtt-10">{}%</span><span -class="cmtt-10"> </span><span id="textcolor760"><span +class="cmtt-10"> </span><span id="textcolor786"><span class="cmitt-10">siblingcount</span></span><a - id="dx1-200047"></a><span + id="dx1-203047"></a><span class="cmti-10"> field</span><span class="cmti-10"> value</span><span class="cmti-10"> 0</span><span @@ -34982,9 +36513,9 @@ class="cmti-10"> missing</span> class="cmtt-10">\newcommand{\siblinghandler}[1]{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor761"><span +class="cmtt-10"> </span><span id="textcolor787"><span class="cmtt-10">\GlsXtrIfXpFieldEqXpStr</span></span><a - id="dx1-200048"></a><span + id="dx1-203048"></a><span class="cmtt-10">*{plural}{\glscurrententrylabel}%</span> <br /><span class="cmtt-10"> </span><span @@ -35014,7 +36545,7 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \listbreak</span><a - id="dx1-200049"></a> + id="dx1-203049"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> }%</span> @@ -35024,46 +36555,46 @@ class="cmtt-10">}</span> </div> The <span class="cmtt-10">\listbreak </span>command is provided by <span class="cmss-10">etoolbox</span><a - id="dx1-200050"></a> and is used for prematurely exiting a loop. The handler + id="dx1-203050"></a> and is used for prematurely exiting a loop. The handler tests if the sibling’s <span class="cmtt-10">plural</span><a - id="dx1-200051"></a> field is identical to the current entry’s <span + id="dx1-203051"></a> field is identical to the current entry’s <span class="cmtt-10">plural</span><a - id="dx1-200052"></a> field. If they are the + id="dx1-203052"></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. 17058--><p class="indent" > Note that this assumes that the parent entry hasn’t had the plural form explicitly set to “bravoes” instead of +<!--l. 17481--><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. 17067--><p class="indent" > If you don’t use <a +</p><!--l. 17490--><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 + id="dx1-203053"></a></a> or if you use it without the <span id="textcolor788"><span class="cmtt-10">save-sibling-count</span></span><a - id="dx1-200054"></a> resource option then the sibling + id="dx1-203054"></a> resource option then the sibling information won’t be available. -</p><!--l. 17071--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 17494--><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 + id="dx1-203055"></a></a></span>In order to switch to using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200056"></a></a>, it’s first necessary to switch to using <a + id="dx1-203056"></a></a>, it’s first necessary to switch to using <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> (as above). -Remember that the <span id="textcolor763"><span +Remember that the <span id="textcolor789"><span class="cmss-10">record</span></span><a - id="dx1-200057"></a> option is required: </p><div class="alltt"> + id="dx1-203057"></a> option is required: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor764"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor790"><span class="cmtt-10">record</span></span><span -class="cmtt-10">,</span></strong><span id="textcolor765"><span +class="cmtt-10">,</span></strong><span id="textcolor791"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor766"><span +class="cmtt-10">,</span><span id="textcolor792"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,style=treenonamegroup,</span> <br /><span @@ -35071,14 +36602,14 @@ class="cmtt-10">subentrycounter]{glossaries-extra}</span> </div> </div> Next the entry definitions need to be converted to the <span class="cmtt-10">bib</span><a - id="dx1-200058"></a> format required by <a + id="dx1-203058"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200059"></a></a>. This can be done with + id="dx1-203059"></a></a>. This can be done with <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-200060"></a></a>: <div class="alltt"> + id="dx1-203060"></a></a>: <div class="alltt"> <div class="obeylines-v"> @@ -35090,44 +36621,44 @@ class="cmtt-10"> entries.</span> </div> </div> The semantic command may be moved to the <span class="cmtt-10">bib</span><a - id="dx1-200061"></a> file to ensure it’s defined: <div class="alltt"> + id="dx1-203061"></a> file to ensure it’s defined: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor767"><span +<span id="textcolor793"><span class="cmtt-10">@preamble</span></span><a - id="dx1-200062"></a><span + id="dx1-203062"></a><span class="cmtt-10">{"\providecommand{\scriptlang}[1]{\textsf{#1}}"}</span> </div> </div> -<!--l. 17091--><p class="indent" > The <span +<!--l. 17514--><p class="indent" > The <span class="cmtt-10">sort</span><a - id="dx1-200063"></a> field typically shouldn’t be set when using <a + id="dx1-203063"></a> field typically shouldn’t be set when using <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200064"></a></a>, so <a + id="dx1-203064"></a></a>, so <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-200065"></a></a> strips it. If the <span + id="dx1-203065"></a></a> strips it. If the <span class="cmtt-10">sort</span><a - id="dx1-200066"></a> field + id="dx1-203066"></a> field is missing, <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200067"></a></a> will obtain it from the sort fallback for that entry type. In this case, <span id="textcolor768"><span + id="dx1-203067"></a></a> will obtain it from the sort fallback for that entry type. In this case, <span id="textcolor794"><span class="cmtt-10">@entry</span></span><a - id="dx1-200068"></a> has the <span + id="dx1-203068"></a> has the <span class="cmtt-10">name</span><a - id="dx1-200069"></a> + id="dx1-203069"></a> field as the sort fallback. If this is also missing then its value is obtained from the parent’s <span class="cmtt-10">name</span><a - id="dx1-200070"></a> field (see + id="dx1-203070"></a> field (see <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. 17099--><p class="indent" > Therefore the “Perl” entry is simply defined as: </p><div class="alltt"> +</p><!--l. 17522--><p class="indent" > Therefore the “Perl” entry is simply defined as: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor769"><span +<span id="textcolor795"><span class="cmtt-10">@entry</span></span><a - id="dx1-200071"></a><span + id="dx1-203071"></a><span class="cmtt-10">{Perl,</span> <br /><span class="cmtt-10"> </span><span @@ -35147,32 +36678,32 @@ class="cmtt-10">}</span> </div> This isn’t a problem for <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200072"></a></a>. In this case, the command has been provided in the <span id="textcolor770"><span + id="dx1-203072"></a></a>. In this case, the command has been provided in the <span id="textcolor796"><span class="cmtt-10">@preamble</span></span><a - id="dx1-200073"></a>, but <a + id="dx1-203073"></a>, but <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200074"></a></a> + id="dx1-203074"></a></a> strips font information so the sort value becomes <span -class="cmtt-10">Perl</span>. If the definition isn’t placed in <span id="textcolor771"><span +class="cmtt-10">Perl</span>. If the definition isn’t placed in <span id="textcolor797"><span class="cmtt-10">@preamble</span></span><a - id="dx1-200075"></a> then + id="dx1-203075"></a> then <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200076"></a></a> will simply ignore the command (as <a + id="dx1-203076"></a></a> will simply ignore the command (as <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-200077"></a></a> does) so the sort value will still end up as + id="dx1-203077"></a></a> does) so the sort value will still end up as <span class="cmtt-10">Perl</span>. -<!--l. 17113--><p class="indent" > The homograph entries have also had their <span +<!--l. 17536--><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"> + id="dx1-203078"></a> fields omitted: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor772"><span +<span id="textcolor798"><span class="cmtt-10">@entry</span></span><a - id="dx1-200079"></a><span + id="dx1-203079"></a><span class="cmtt-10">{glossarycol,</span> <br /><span class="cmtt-10"> </span><span @@ -35189,9 +36720,9 @@ class="cmtt-10"> glosses}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor773"><span +<br /><span id="textcolor799"><span class="cmtt-10">@entry</span></span><a - id="dx1-200080"></a><span + id="dx1-203080"></a><span class="cmtt-10">{glossarylist,</span> <br /><span class="cmtt-10"> </span><span @@ -35212,100 +36743,100 @@ class="cmtt-10">}</span> </div> -<!--l. 17126--><p class="indent" > This means that the sort value for both these child entries is “glossary”. When <a +<!--l. 17549--><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 -sort values it acts according to its <span id="textcolor774"><span + id="dx1-203081"></a></a> encounters identical +sort values it acts according to its <span id="textcolor800"><span class="cmtt-10">identical-sort-action</span></span><a - id="dx1-200082"></a> setting. The default action is to sort by the label + id="dx1-203082"></a> setting. The default action is to sort by the label using a simple string comparison. In this case, it would put <span class="cmtt-10">glossarycol </span>before <span class="cmtt-10">glossarylist</span>. In the original document, the <span class="cmtt-10">sort</span><a - id="dx1-200083"></a> value was manually chosen to ensure that the entries are ordered according to <a + id="dx1-203083"></a> value was manually chosen to ensure that the entries are ordered according to <a href="#glo:firstuse">first use</a>. This ordering can easily be obtained by changing <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200084"></a>’s</a> identical sort action (requires at least <a + id="dx1-203084"></a>’s</a> identical sort action (requires at least <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200085"></a></a> + id="dx1-203085"></a></a> v2.0): </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor775"><span +<span id="textcolor801"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-200086"></a><span -class="cmtt-10">[</span><span id="textcolor776"><span + id="dx1-203086"></a><span +class="cmtt-10">[</span><span id="textcolor802"><span class="cmtt-10">src</span></span><a - id="dx1-200087"></a><span -class="cmtt-10">={entries},</span><strong><span id="textcolor777"><span + id="dx1-203087"></a><span +class="cmtt-10">={entries},</span><strong><span id="textcolor803"><span class="cmtt-10">identical-sort-action</span></span><span class="cmtt-10">=use</span></strong><span class="cmtt-10">]</span> </div> </div> This command should replace <span class="cmtt-10">\makeglossaries</span>. If you want the sibling information (see earlier), then you -need to remember to add <span id="textcolor778"><span +need to remember to add <span id="textcolor804"><span class="cmtt-10">save-sibling-count</span></span><a - id="dx1-200088"></a> to the list of options. -<!--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 + id="dx1-203088"></a> to the list of options. +<!--l. 17566--><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 + id="dx1-203089"></a> keys would need to be manually changed. -</p><!--l. 17148--><p class="indent" > The remainder of the preamble (that is, the definition of <span +</p><!--l. 17571--><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. 17152--><p class="indent" > Finally, replace <span -class="cmtt-10">\printglossaries </span>with <span id="textcolor779"><span +</p><!--l. 17575--><p class="indent" > Finally, replace <span +class="cmtt-10">\printglossaries </span>with <span id="textcolor805"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-200090"></a>. The document build is now: -</p><!--l. 17154--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-203090"></a>. The document build is now: +</p><!--l. 17577--><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 <br />pdflatex sample <br /></pre><spacer type=vertical size=10> <br /></span> -Note use of the <span id="textcolor780"><span +Note use of the <span id="textcolor806"><span class="cmtt-10">--group</span></span><a - id="dx1-200091"></a> (or <span id="textcolor781"><span + id="dx1-203091"></a> (or <span id="textcolor807"><span class="cmtt-10">-g</span></span><a - id="dx1-200092"></a>) switch, which is needed to support the <span + id="dx1-203092"></a>) switch, which is needed to support the <span class="cmss-10">treenonamegroup</span><a - id="dx1-200093"></a> style. The third + id="dx1-203093"></a> style. The third LaTeX call is needed because the document contains <span class="cmtt-10">\glsrefentry</span><a - id="dx1-200094"></a>. -</p><!--l. 17164--><p class="indent" > Note that you can’t use the <span + id="dx1-203094"></a>. +</p><!--l. 17587--><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 - id="dx1-200095"></a> package option with <a + id="dx1-203095"></a> package option with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-200096"></a></a>. Instead use the <span id="textcolor782"><span + id="dx1-203096"></a></a>. Instead use the <span id="textcolor808"><span class="cmtt-10">break-at</span></span><span class="cmtt-10">=none</span><a - id="dx1-200097"></a> + id="dx1-203097"></a> resource option: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor783"><span +<span id="textcolor809"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-200098"></a><span -class="cmtt-10">[</span><span id="textcolor784"><span + id="dx1-203098"></a><span +class="cmtt-10">[</span><span id="textcolor810"><span class="cmtt-10">src</span></span><a - id="dx1-200099"></a><span -class="cmtt-10">={entries},</span><span id="textcolor785"><span + id="dx1-203099"></a><span +class="cmtt-10">={entries},</span><span id="textcolor811"><span class="cmtt-10">identical-sort-action</span></span><span class="cmtt-10">=use,</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><strong><span id="textcolor786"><span +class="cmtt-10"> </span><strong><span id="textcolor812"><span class="cmtt-10">break-at</span></span><span class="cmtt-10">=none</span></strong> <br /><span @@ -35313,21 +36844,21 @@ class="cmtt-10">]</span> </div> </div> <a - id="x1-200100r22"></a> -<!--l. 17173--><p class="noindent" > + id="x1-203100r22"></a> +<!--l. 17596--><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. 17173--><p class="noindent" >This document is like <span +<!--l. 17596--><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. + id="dx1-204001"></a> glossary style to put the glossary in a footnote. The document build is: -</p><!--l. 17177--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17600--><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 @@ -35340,20 +36871,20 @@ class="cmss-10">glossaries-extra</span></a>, follow the same procedure as above. <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-201002"></a></a> then you don’t need the <span id="textcolor787"><span + id="dx1-204002"></a></a> then you don’t need the <span id="textcolor813"><span class="cmtt-10">--group</span></span><a - id="dx1-201003"></a> switch since no letter groups are required. + id="dx1-204003"></a> switch since no letter groups are required. <a - id="x1-201004r23"></a> -</p><!--l. 17188--><p class="noindent" > + id="x1-204004r23"></a> +</p><!--l. 17611--><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. 17188--><p class="noindent" >This document illustrates a hierarchical glossary structure where child entries have different names to their +<!--l. 17611--><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. 17192--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 17615--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampletree <br />makeglossaries sampletree <br />pdflatex sampletree @@ -35361,31 +36892,31 @@ corresponding parent entry. To create the document do: <br /></span> The document uses the <span class="cmss-10">alttreehypergroup</span><a - id="dx1-202001"></a> glossary style, which needs to know the widest name for each + id="dx1-205001"></a> glossary style, which needs to know the widest name for each hierarchical level. This has been assigned manually in the preamble with <span class="cmtt-10">\glssetwidest</span><a - id="dx1-202002"></a>: + id="dx1-205002"></a>: </p> - <div class="verbatim" id="verbatim-449"> + <pre class="verbatim" id="verbatim-456"> \glssetwidest{Roman letters} % level 0 widest name - <br />\glssetwidest[1]{Sigma}      % level 1 widest name -</div> -<!--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 +\glssetwidest[1]{Sigma}      % level 1 widest name +</pre> +<!--l. 17627--><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 - id="dx1-202003"></a> but this will iterate over all top-level + id="dx1-205003"></a> but this will iterate over all top-level 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. 17213--><p class="indent" > This sample document doesn’t require any of the tabular styles so I’ve prevented those packages from being +</p><!--l. 17636--><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 + id="dx1-205004"></a> and <span class="cmss-10">nosuper</span><a - id="dx1-202005"></a>. The reduces the overall package loading. </p><div class="alltt"> + id="dx1-205005"></a>. The reduces the overall package loading. </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\usepackage[style=alttreehypergroup,</span><strong><span @@ -35394,96 +36925,96 @@ class="cmtt-10">]</span> <br /><span class="cmtt-10">{glossaries}</span> </div> -</div> (This example glossary is actually better suited for one of the topic styles provided with <span id="textcolor788"><span +</div> (This example glossary is actually better suited for one of the topic styles provided with <span id="textcolor814"><span class="cmss-10">glossary-topic</span></span><a - id="dx1-202006"></a>, see + id="dx1-205006"></a>, see below.) -<!--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 +<!--l. 17646--><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 + id="dx1-205007"></a> with an entry that’s noticeably wider than the others in the same hierarchical level. A more sensible document would have the symbol in the <span class="cmtt-10">name</span><a - id="dx1-202008"></a> + id="dx1-205008"></a> key. -</p><!--l. 17230--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 17653--><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 class="cmss-10">glossaries-extra</span></a>, then you can instead use a combination of <span class="cmss-10">nostyles</span><a - id="dx1-202009"></a> -and <span id="textcolor789"><span + id="dx1-205009"></a> +and <span id="textcolor815"><span class="cmss-10">stylemods</span></span><a - id="dx1-202010"></a>: </p><div class="alltt"> + id="dx1-205010"></a>: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[style=alttreehypergroup,</span><span id="textcolor790"><span +class="cmtt-10">\usepackage[style=alttreehypergroup,</span><span id="textcolor816"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">,</span><strong><span class="cmtt-10">nostyles,</span> -<br /><span id="textcolor791"><span +<br /><span id="textcolor817"><span class="cmtt-10">stylemods=tree</span></span></strong><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> -</div> The <span id="textcolor792"><span +</div> The <span id="textcolor818"><span class="cmss-10">stylemods</span></span><a - id="dx1-202011"></a> package not only patches the original styles provided by the base <span + id="dx1-205011"></a> package not only patches the original styles provided by the base <span class="cmss-10">glossaries </span>package (such as <span class="cmss-10">glossary-tree</span><a - id="dx1-202012"></a> used in this example) but also provides extra helper commands. In this case, it + id="dx1-205012"></a> used in this example) but also provides extra helper commands. In this case, it provides additional commands to calculate the widest name. For example, instead of manually setting the widest entry with <span class="cmtt-10">\glssetwidest</span><a - id="dx1-202013"></a>, you could add the following before the glossary: + id="dx1-205013"></a>, you could add the following before the glossary: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor793"><span +<span id="textcolor819"><span class="cmtt-10">\glsFindWidestUsedTopLevelName</span></span><a - id="dx1-202014"></a> -<br /><span id="textcolor794"><span + id="dx1-205014"></a> +<br /><span id="textcolor820"><span class="cmtt-10">\glsFindWidestUsedLevelTwo</span></span><a - id="dx1-202015"></a> + id="dx1-205015"></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. 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 +<!--l. 17676--><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. 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 + id="dx1-205016"></a> file for the next run. </div> +</p><!--l. 17681--><p class="noindent" > +</p><!--l. 17683--><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 + id="dx1-205017"></a> to prevent the post-description punctuation from being automatically inserted. For example: </p> - <div class="verbatim" id="verbatim-450"> + <pre class="verbatim" id="verbatim-457"> \newglossaryentry{greekletter}{name={Greek letters}, - <br />text={Greek letter}, - <br />description={\nopostdesc}} -</div> -<!--l. 17268--><p class="nopar" > With <a +text={Greek letter}, +description={\nopostdesc}} +</pre> +<!--l. 17691--><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="cmss-10">glossaries-extra</span></a>, you can convert this to <span id="textcolor821"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-202018"></a> which will prevent the post-description + id="dx1-205018"></a> which will prevent the post-description punctuation without interfering with the category post-description hook. -</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 +</p><!--l. 17697--><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="textcolor822"><span class="cmss-10">general</span></span><a - id="dx1-202019"></a> -category, but the symbol entries can be assigned to a different category. The value of the <span id="textcolor797"><span id="textcolor798"><span + id="dx1-205019"></a> +category, but the symbol entries can be assigned to a different category. The value of the <span id="textcolor823"><span id="textcolor824"><span class="cmtt-10">category</span></span><a - id="dx1-202020"></a></span> key must be + id="dx1-205020"></a></span> key must be a label. For example: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -35491,39 +37022,39 @@ class="cmtt-10">\newglossaryentry{C}{name={C},</span> <br /><span class="cmtt-10">description={Euler's</span><span class="cmtt-10"> constant},</span> -<br /><strong><span id="textcolor799"><span +<br /><strong><span id="textcolor825"><span class="cmtt-10">category</span></span><span class="cmtt-10">=symbol,</span></strong> <br /><span class="cmtt-10">parent=romanletter}</span> </div> </div> -<!--l. 17287--><p class="indent" > There is some redundancy caused by a parenthetical note after the <a +<!--l. 17710--><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-451"> + <pre class="verbatim" id="verbatim-458"> \newglossaryentry{pi}{name={pi}, - <br />text={\ensuremath{\pi}}, - <br />first={\ensuremath{\pi} (lowercase pi)}, - <br />description={Transcendental number}, - <br />parent=greekletter} -</div> -<!--l. 17295--><p class="nopar" > With <a +text={\ensuremath{\pi}}, +first={\ensuremath{\pi} (lowercase pi)}, +description={Transcendental number}, +parent=greekletter} +</pre> +<!--l. 17718--><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"> -<span id="textcolor800"><span +<span id="textcolor826"><span class="cmtt-10">\glsdefpostlink</span></span><a - id="dx1-202021"></a><span + id="dx1-205021"></a><span class="cmtt-10">{symbol}{%</span> <br /><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor801"><span +class="cmtt-10"> </span><span id="textcolor827"><span class="cmtt-10">\glsxtrifwasfirstuse</span></span><a - id="dx1-202022"></a> + id="dx1-205022"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> {%</span><span @@ -35533,11 +37064,11 @@ class="cmtt-10"> use</span> class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor802"><span +class="cmtt-10"> </span><span id="textcolor828"><span class="cmtt-10">\glsxtrifhasfield</span></span><a - id="dx1-202023"></a><span + id="dx1-205023"></a><span class="cmtt-10">{useri}{\glslabel</span><a - id="dx1-202024"></a><span + id="dx1-205024"></a><span class="cmtt-10">}%</span> <br /><span class="cmtt-10"> </span><span @@ -35545,7 +37076,7 @@ class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> {</span><span class="cmtt-10"> (\glscurrentfieldvalue</span><a - id="dx1-202025"></a><span + id="dx1-205025"></a><span class="cmtt-10">)}{}%</span> <br /><span class="cmtt-10"> </span><span @@ -35561,7 +37092,7 @@ class="cmtt-10">}</span> </div> </div> The parenthetical material is now stored in the <span class="cmtt-10">user1</span><a - id="dx1-202026"></a> key. For example: <div class="alltt"> + id="dx1-205026"></a> key. For example: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{sigma}{name=Sigma,</span> @@ -35581,43 +37112,43 @@ class="cmtt-10">parent=greekletter}</span> </div> The category post-description link is also set to ensure that the symbol is displayed after the description in the glossary: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor803"><span +<span id="textcolor829"><span class="cmtt-10">\glsdefpostdesc</span></span><a - id="dx1-202027"></a><span + id="dx1-205027"></a><span class="cmtt-10">{symbol}{\space</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> (</span><span class="tctt-1000">$</span><span class="cmtt-10">\glsentrytext</span><a - id="dx1-202028"></a><span + id="dx1-205028"></a><span class="cmtt-10">{\glscurrententrylabel</span><a - id="dx1-202029"></a><span + id="dx1-205029"></a><span class="cmtt-10">}</span><span class="tctt-1000">$</span><span class="cmtt-10">)}</span> </div> -</div> These modifications only affect entries with the <span id="textcolor804"><span id="textcolor805"><span +</div> These modifications only affect entries with the <span id="textcolor830"><span id="textcolor831"><span class="cmtt-10">category</span></span><a - id="dx1-202030"></a></span> set to <span id="textcolor806"><span + id="dx1-205030"></a></span> set to <span id="textcolor832"><span class="cmss-10">symbol</span></span><a - id="dx1-202031"></a>. -<!--l. 17325--><p class="indent" > With <a + id="dx1-205031"></a>. +<!--l. 17748--><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">glossaries-extra</span></a>, it’s now possible to use the topic styles provided with the <span id="textcolor833"><span class="cmss-10">glossary-topic</span></span><a - id="dx1-202032"></a> package: + id="dx1-205032"></a> package: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[style=</span><strong><span id="textcolor808"><span +class="cmtt-10">\usepackage[style=</span><strong><span id="textcolor834"><span class="cmtt-10">topic</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor809"><span +class="cmtt-10">,</span><span id="textcolor835"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">,</span><strong><span -class="cmtt-10">nostyles,</span><span id="textcolor810"><span +class="cmtt-10">nostyles,</span><span id="textcolor836"><span class="cmtt-10">stylemods={tree</span><strong><span class="cmtt-10">,topic</span></strong><span class="cmtt-10">}</span></span></strong><span @@ -35627,14 +37158,14 @@ class="cmtt-10">{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> </div> -</div> The <span id="textcolor811"><span +</div> The <span id="textcolor837"><span class="cmss-10">topic</span></span><a - id="dx1-202033"></a> style is designed for this kind of hierarchy where all the top-level entries don’t have descriptions. This + id="dx1-205033"></a> style is designed for this kind of hierarchy where all the top-level entries don’t have descriptions. This means that the <span class="cmtt-10">\nopostdot</span><a - id="dx1-202034"></a> and <span id="textcolor812"><span + id="dx1-205034"></a> and <span id="textcolor838"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-202035"></a> commands aren’t required. The top-level entries can + id="dx1-205035"></a> commands aren’t required. The top-level entries can simply be defined as: <div class="alltt"> <div class="obeylines-v"> <span @@ -35655,64 +37186,64 @@ class="cmtt-10"> description={}}</span> </div> </div> I’ve now loaded both the <span class="cmss-10">glossary-tree</span><a - id="dx1-202036"></a> and <span + id="dx1-205036"></a> and <span class="cmss-10">glossary-topic</span><a - id="dx1-202037"></a> packages (via <span id="textcolor813"><span + id="dx1-205037"></a> packages (via <span id="textcolor839"><span class="cmss-10">stylemods</span></span><a - id="dx1-202038"></a><span + id="dx1-205038"></a><span class="cmtt-10">={tree,topic}</span>). The <span class="cmss-10">glossary-topic</span><a - id="dx1-202039"></a> package can be used without <span + id="dx1-205039"></a> package can be used without <span class="cmss-10">glossary-tree</span><a - id="dx1-202040"></a>, in which case it will behave more like the normal <span + id="dx1-205040"></a>, in which case it will behave more like the normal <span class="cmss-10">tree</span><a - id="dx1-202041"></a> + id="dx1-205041"></a> rather than <span class="cmss-10">alttree</span><a - id="dx1-202042"></a> styles (but with different indentation and no description in the top-level). However, + id="dx1-205042"></a> styles (but with different indentation and no description in the top-level). However, if you use <span class="cmtt-10">\glssetwidest</span><a - id="dx1-202043"></a> (provided by <span + id="dx1-205043"></a> (provided by <span class="cmss-10">glossary-tree</span><a - id="dx1-202044"></a>) then the <span id="textcolor814"><span + id="dx1-205044"></a>) then the <span id="textcolor840"><span class="cmss-10">topic</span></span><a - id="dx1-202045"></a> style will behave more like + id="dx1-205045"></a> style will behave more like <span class="cmss-10">alttree</span><a - id="dx1-202046"></a>. -<!--l. 17353--><p class="indent" > Since there’s no description for the top-level entries, the <span id="textcolor815"><span + id="dx1-205046"></a>. +<!--l. 17776--><p class="indent" > Since there’s no description for the top-level entries, the <span id="textcolor841"><span class="cmss-10">topic</span></span><a - id="dx1-202047"></a> style ignores the widest name setting for the + id="dx1-205047"></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-452"> + <pre class="verbatim" id="verbatim-459"> \glssetwidest[1]{Sigma} -</div> -<!--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 +</pre> +<!--l. 17781--><p class="nopar" > +</p><!--l. 17783--><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 + id="dx1-205048"></a></a></span>If you want to convert this document so that it uses <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-202049"></a></a>, you first need to convert it + id="dx1-205049"></a></a>, you first need to convert it to using <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a>, as described above, but remember that you now need the <span id="textcolor816"><span +class="cmss-10">glossaries-extra</span></a>, as described above, but remember that you now need the <span id="textcolor842"><span class="cmss-10">record</span></span><a - id="dx1-202050"></a> option. + id="dx1-205050"></a> option. </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor817"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor843"><span class="cmtt-10">record</span></span><span class="cmtt-10">,</span></strong><span -class="cmtt-10">style=topic,</span><span id="textcolor818"><span +class="cmtt-10">style=topic,</span><span id="textcolor844"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,nostyles,</span><span id="textcolor819"><span +class="cmtt-10">,nostyles,</span><span id="textcolor845"><span class="cmtt-10">stylemods={tree,topic}</span></span><span class="cmtt-10">]</span> <br /><span @@ -35722,67 +37253,67 @@ class="cmtt-10">}</span> </div> </div> Next convert the entries to the <span class="cmtt-10">bib</span><a - id="dx1-202051"></a> format required by <a + id="dx1-205051"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-202052"></a></a>: -<!--l. 17371--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-205052"></a></a>: +<!--l. 17794--><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> Now replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor820"><span +<span id="textcolor846"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-202053"></a><span -class="cmtt-10">[</span><span id="textcolor821"><span + id="dx1-205053"></a><span +class="cmtt-10">[</span><span id="textcolor847"><span class="cmtt-10">src</span></span><a - id="dx1-202054"></a><span -class="cmtt-10">=entries,</span><strong><span id="textcolor822"><span + id="dx1-205054"></a><span +class="cmtt-10">=entries,</span><strong><span id="textcolor848"><span class="cmtt-10">set-widest</span></span></strong><span class="cmtt-10">]</span> </div> -</div> I’ve used the <span id="textcolor823"><span +</div> I’ve used the <span id="textcolor849"><span class="cmtt-10">set-widest</span></span><a - id="dx1-202055"></a> option here to get <a + id="dx1-205055"></a> option here to get <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-202056"></a></a> to compute the widest name. (Obviously, it can only do + id="dx1-205056"></a></a> to compute the widest name. (Obviously, it can only do this if it can correctly interpret any commands contained in the <span class="cmtt-10">name</span><a - id="dx1-202057"></a> field.) -<!--l. 17383--><p class="indent" > This means that the <span + id="dx1-205057"></a> field.) +<!--l. 17806--><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 + id="dx1-205058"></a> commands can now be removed completely. All the <span class="cmtt-10">\newglossaryentry</span> commands also need to be removed from the preamble. Finally, <span class="cmtt-10">\printunsrtglossaries </span>needs to be replaced -with <span id="textcolor824"><span +with <span id="textcolor850"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-202059"></a>. The document build is now: -</p><!--l. 17387--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-205059"></a>. The document build is now: +</p><!--l. 17810--><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. 17393--><p class="indent" > This produces the same result as with just <a +</p><!--l. 17816--><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 class="cmtt-10">makeglossaries</span><a - id="dx1-202060"></a></a>. However, there are some + id="dx1-205060"></a></a>. However, there are some 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. 17397--><p class="indent" > The top-level entries are defined as: </p><div class="alltt"> + id="dx1-205061"></a> file to make it neater. +</p><!--l. 17820--><p class="indent" > The top-level entries are defined as: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor825"><span +<span id="textcolor851"><span class="cmtt-10">@entry</span></span><a - id="dx1-202062"></a><span + id="dx1-205062"></a><span class="cmtt-10">{greekletter,</span> <br /><span class="cmtt-10"> </span><span @@ -35804,9 +37335,9 @@ class="cmtt-10"> letter}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor826"><span +<br /><span id="textcolor852"><span class="cmtt-10">@entry</span></span><a - id="dx1-202063"></a><span + id="dx1-205063"></a><span class="cmtt-10">{romanletter,</span> <br /><span class="cmtt-10"> </span><span @@ -35829,14 +37360,14 @@ class="cmtt-10"> letter}</span> class="cmtt-10">}</span> </div> </div> This is a direct translation from the <span -class="cmtt-10">\newglossaryentry </span>commands (after switching to the <span id="textcolor827"><span +class="cmtt-10">\newglossaryentry </span>commands (after switching to the <span id="textcolor853"><span class="cmss-10">topic</span></span><a - id="dx1-202064"></a> style). There’s + id="dx1-205064"></a> style). There’s a more appropriate entry type: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor828"><span +<span id="textcolor854"><span class="cmtt-10">@indexplural</span></span><a - id="dx1-202065"></a><span + id="dx1-205065"></a><span class="cmtt-10">{greekletter,</span> <br /><span class="cmtt-10"> </span><span @@ -35847,9 +37378,9 @@ class="cmtt-10"> letter}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor829"><span +<br /><span id="textcolor855"><span class="cmtt-10">@indexplural</span></span><a - id="dx1-202066"></a><span + id="dx1-205066"></a><span class="cmtt-10">{romanletter,</span> <br /><span class="cmtt-10"> </span><span @@ -35860,29 +37391,29 @@ class="cmtt-10"> letter}</span> <br /><span class="cmtt-10">}</span> </div> -</div> The <span id="textcolor830"><span +</div> The <span id="textcolor856"><span class="cmtt-10">@indexplural</span></span><a - id="dx1-202067"></a> entry type doesn’t require the <span + id="dx1-205067"></a> entry type doesn’t require the <span class="cmtt-10">description</span><a - id="dx1-202068"></a> and will set the <span + id="dx1-205068"></a> and will set the <span class="cmtt-10">name</span><a - id="dx1-202069"></a> field to the same as the + id="dx1-205069"></a> field to the same as the <span class="cmtt-10">plural</span><a - id="dx1-202070"></a> field. Since the <span + id="dx1-205070"></a> field. Since the <span class="cmtt-10">plural</span><a - id="dx1-202071"></a> field hasn’t been set it’s obtained by appending “s” to the <span + id="dx1-205071"></a> field hasn’t been set it’s obtained by appending “s” to the <span class="cmtt-10">text</span><a - id="dx1-202072"></a> + id="dx1-205072"></a> field. -<!--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 +<!--l. 17852--><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"> + id="dx1-205073"></a> field. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor831"><span +<span id="textcolor857"><span class="cmtt-10">@entry</span></span><a - id="dx1-202074"></a><span + id="dx1-205074"></a><span class="cmtt-10">{sigma,</span> <br /><span class="cmtt-10"> </span><span @@ -35918,9 +37449,9 @@ class="cmtt-10"> {symbol}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor832"><span +<br /><span id="textcolor858"><span class="cmtt-10">@entry</span></span><a - id="dx1-202075"></a><span + id="dx1-205075"></a><span class="cmtt-10">{C,</span> <br /><span class="cmtt-10"> </span><span @@ -35948,61 +37479,61 @@ class="cmtt-10"> {symbol}</span> <br /><span class="cmtt-10">}</span> </div> -</div> The category post-description hook (provided with <span id="textcolor833"><span +</div> The category post-description hook (provided with <span id="textcolor859"><span class="cmtt-10">\glsdefpostdesc</span></span><a - id="dx1-202076"></a>) should now be removed from the + id="dx1-205076"></a>) should now be removed from the document. -<!--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 +<!--l. 17874--><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 href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-202077"></a></a> is obtaining the sort values from the <span + id="dx1-205077"></a></a> is obtaining the sort values from the <span class="cmtt-10">name</span><a - id="dx1-202078"></a> field, -which is the sort fallback for <span id="textcolor834"><span + id="dx1-205078"></a> field, +which is the sort fallback for <span id="textcolor860"><span class="cmtt-10">@entry</span></span><a - id="dx1-202079"></a>. This means that the sort values end up as Σ and <span + id="dx1-205079"></a>. This means that the sort values end up as Σ and <span class="cmmi-10">π </span>(<a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-202080"></a></a> + id="dx1-205080"></a></a> recognises the commands <span class="cmtt-10">\Sigma</span><a - id="dx1-202081"></a> and <span + id="dx1-205081"></a> and <span class="cmtt-10">\pi</span><a - id="dx1-202082"></a> and converts them to the Unicode characters 0x1D6F4 and + id="dx1-205082"></a> and converts them to the Unicode characters 0x1D6F4 and 0x1D70B). -</p><!--l. 17460--><p class="indent" > If you change <span id="textcolor835"><span +</p><!--l. 17883--><p class="indent" > If you change <span id="textcolor861"><span class="cmtt-10">@entry</span></span><a - id="dx1-202083"></a> to <span id="textcolor836"><span + id="dx1-205083"></a> to <span id="textcolor862"><span class="cmtt-10">@symbol</span></span><a - id="dx1-202084"></a> then you will once again get the order from the original example (<span + id="dx1-205084"></a> then you will once again get the order from the original example (<span class="cmtt-10">pi </span>before <span -class="cmtt-10">Sigma</span>). This is because the sort fallback for <span id="textcolor837"><span +class="cmtt-10">Sigma</span>). This is because the sort fallback for <span id="textcolor863"><span class="cmtt-10">@symbol</span></span><a - id="dx1-202085"></a> is the label not the <span + id="dx1-205085"></a> is the label not the <span class="cmtt-10">name</span><a - id="dx1-202086"></a>. (Remember that the sort + id="dx1-205086"></a>. (Remember that the sort fallback is only used if the <span class="cmtt-10">sort</span><a - id="dx1-202087"></a> field isn’t set. If you explicitly set the <span + id="dx1-205087"></a> field isn’t set. If you explicitly set the <span class="cmtt-10">sort</span><a - id="dx1-202088"></a> field then no fallback is required. See + id="dx1-205088"></a> field then no fallback is required. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting" ><span class="cmtt-10">bib2gls </span>gallery: sorting</a>.) -</p><!--l. 17468--><p class="indent" > You can further tidy the <span +</p><!--l. 17891--><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 + id="dx1-205089"></a> file by removing the <span id="textcolor864"><span id="textcolor865"><span class="cmtt-10">category</span></span><a - id="dx1-202090"></a></span> fields. For example: </p><div class="alltt"> + id="dx1-205090"></a></span> fields. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor840"><span +<span id="textcolor866"><span class="cmtt-10">@symbol</span></span><a - id="dx1-202091"></a><span + id="dx1-205091"></a><span class="cmtt-10">{sigma,</span> <br /><span class="cmtt-10"> </span><span @@ -36031,68 +37562,68 @@ class="cmtt-10"> {\ensuremath{\Sigma}}</span> <br /><span class="cmtt-10">}</span> </div> -</div> You can then assign the <span id="textcolor841"><span id="textcolor842"><span +</div> You can then assign the <span id="textcolor867"><span id="textcolor868"><span class="cmtt-10">category</span></span><a - id="dx1-202092"></a></span> in the resource set: <div class="alltt"> + id="dx1-205092"></a></span> in the resource set: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor843"><span +<span id="textcolor869"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-202093"></a><span -class="cmtt-10">[</span><span id="textcolor844"><span + id="dx1-205093"></a><span +class="cmtt-10">[</span><span id="textcolor870"><span class="cmtt-10">src</span></span><a - id="dx1-202094"></a><span -class="cmtt-10">=entries,</span><span id="textcolor845"><span + id="dx1-205094"></a><span +class="cmtt-10">=entries,</span><span id="textcolor871"><span class="cmtt-10">set-widest</span></span><span -class="cmtt-10">,</span><strong><span id="textcolor846"><span +class="cmtt-10">,</span><strong><span id="textcolor872"><span class="cmtt-10">category</span></span><span class="cmtt-10">={same</span><span class="cmtt-10"> as</span><span class="cmtt-10"> entry}</span></strong><span class="cmtt-10">]</span> </div> -</div> This means that all the entries defined with <span id="textcolor847"><span +</div> This means that all the entries defined with <span id="textcolor873"><span class="cmtt-10">@symbol</span></span><a - id="dx1-202095"></a> will have the <span id="textcolor848"><span id="textcolor849"><span + id="dx1-205095"></a> will have the <span id="textcolor874"><span id="textcolor875"><span class="cmtt-10">category</span></span><a - id="dx1-202096"></a></span> set to <span + id="dx1-205096"></a></span> set to <span class="cmtt-10">symbol </span>and all the entries -defined with <span id="textcolor850"><span +defined with <span id="textcolor876"><span class="cmtt-10">@indexplural</span></span><a - id="dx1-202097"></a> will have the <span id="textcolor851"><span id="textcolor852"><span + id="dx1-205097"></a> will have the <span id="textcolor877"><span id="textcolor878"><span class="cmtt-10">category</span></span><a - id="dx1-202098"></a></span> set to <span -class="cmtt-10">indexplural</span>. (Only the <span id="textcolor853"><span + id="dx1-205098"></a></span> set to <span +class="cmtt-10">indexplural</span>. (Only the <span id="textcolor879"><span class="cmss-10">symbol</span></span><a - id="dx1-202099"></a> category is significant + id="dx1-205099"></a> category is significant in this example.) -<!--l. 17488--><p class="indent" > You can make the <span +<!--l. 17911--><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 + id="dx1-205100"></a> files even more flexible by introducing field and entry aliases with <span id="textcolor880"><span class="cmtt-10">field-aliases</span></span><a - id="dx1-202101"></a> and -<span id="textcolor855"><span + id="dx1-205101"></a> and +<span id="textcolor881"><span class="cmtt-10">entry-type-aliases</span></span><a - id="dx1-202102"></a>. See the <a + id="dx1-205102"></a>. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-202103"></a></a> manual for further details. -</p><!--l. 17493--><p class="noindent" > + id="dx1-205103"></a></a> manual for further details. +</p><!--l. 17916--><p class="noindent" > </p> -<!--l. 17493--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.7 </span> <a +<!--l. 17916--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.7 </span> <a id="sec:samplescrossref"></a>Cross-Referencing</h3> <a - id="x1-203001r24"></a> + id="x1-206001r24"></a> -<!--l. 17496--><p class="noindent" > +<!--l. 17919--><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. 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"> +<!--l. 17920--><p class="noindent" >This document illustrates how to cross-reference entries in the glossary. +</p><!--l. 17922--><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 @@ -36100,43 +37631,43 @@ class="cmtt-10">sample-crossref.tex</span></a></h4> <br /></span> The document provides a command <span class="cmtt-10">\alsoname</span><a - id="dx1-204001"></a> to produce some fixed text, which can be changed as + id="dx1-207001"></a> to produce some fixed text, which can be changed as appropriate (usually within a language hook): </p> - <div class="verbatim" id="verbatim-453"> + <pre class="verbatim" id="verbatim-460"> \providecommand{\alsoname}{see also} -</div> -<!--l. 17508--><p class="nopar" > I’ve used <span +</pre> +<!--l. 17931--><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 - id="dx1-204002"></a> key: + id="dx1-207002"></a> key: </p> - <div class="verbatim" id="verbatim-454"> + <pre class="verbatim" id="verbatim-461"> \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. 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 +see=[\alsoname]{pear}} +\newglossaryentry{marrow}{name={marrow}, + description={long vegetable with thin green skin and white flesh}, + see={[\alsoname]courgette}} +</pre> +<!--l. 17942--><p class="nopar" > +</p><!--l. 17944--><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 + id="dx1-207003"></a> key automatically triggers <span class="cmtt-10">\glssee</span><a - id="dx1-204004"></a> which indexes the term. This behaviour is intended for + id="dx1-207004"></a> which indexes the term. This behaviour is intended for documents where only the terms that are actually required in the document are defined. It’s not suitable for a large database of terms shared across multiple documents that may or may not be 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. 17531--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +</p><!--l. 17954--><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 @@ -36145,56 +37676,56 @@ description, you need the <span class="cmss-10">nopostdot</span><span class="cmtt-10">=</span><span class="cmss-10">false</span><a - id="dx1-204005"></a> or <span id="textcolor856"><span + id="dx1-207005"></a> or <span id="textcolor882"><span class="cmss-10">postdot</span></span><a - id="dx1-204006"></a> package option. You may also want to consider using the -<span id="textcolor857"><span + id="dx1-207006"></a> package option. You may also want to consider using the +<span id="textcolor883"><span class="cmss-10">stylemods</span></span><a - id="dx1-204007"></a> option. -</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 + id="dx1-207007"></a> option. +</p><!--l. 17960--><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="textcolor884"><span class="cmss-10">autoseeindex</span><span class="cmtt-10">=</span><span class="cmss-10">false</span></span><a - id="dx1-204008"></a> to prevent the automatic indexing triggered by the <span + id="dx1-207008"></a> to prevent the automatic indexing triggered by the <span class="cmtt-10">see</span><a - id="dx1-204009"></a> key -(or the <span id="textcolor859"><span id="textcolor860"><span + id="dx1-207009"></a> key +(or the <span id="textcolor885"><span id="textcolor886"><span class="cmtt-10">seealso</span></span><a - id="dx1-204010"></a></span> key provided by <a + id="dx1-207010"></a></span> key provided by <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>). </p> <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor861"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor887"><span class="cmtt-10">autoseeindex</span></span><span class="cmtt-10">=false</span></strong><span -class="cmtt-10">,</span><span id="textcolor862"><span +class="cmtt-10">,</span><span id="textcolor888"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor863"><span +class="cmtt-10">,</span><span id="textcolor889"><span class="cmtt-10">stylemods</span></span><span 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. 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 +<!--l. 17972--><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 + id="dx1-207011"></a> not via the <span class="cmtt-10">see</span><a - id="dx1-204012"></a> key. -</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 + id="dx1-207012"></a> key. +</p><!--l. 17976--><p class="indent" > The entries that contains <span +class="cmtt-10">see=[\alsoname] </span>can be converted to use the <span id="textcolor890"><span id="textcolor891"><span class="cmtt-10">seealso</span></span><a - id="dx1-204013"></a></span> key: </p><div class="alltt"> + id="dx1-207013"></a></span> key: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{apple}{name=apple,description={firm,</span><span class="cmtt-10"> round</span><span class="cmtt-10"> fruit},</span> -<br /><strong><span id="textcolor866"><span +<br /><strong><span id="textcolor892"><span class="cmtt-10">seealso</span></span><span class="cmtt-10">={pear}</span></strong><span class="cmtt-10">}</span> @@ -36212,7 +37743,7 @@ class="cmtt-10"> and</span><span class="cmtt-10"> white</span><span class="cmtt-10"> flesh},</span> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor867"><span +class="cmtt-10"> </span><strong><span id="textcolor893"><span class="cmtt-10">seealso</span></span><span class="cmtt-10">={courgette}</span></strong><span class="cmtt-10">}</span> @@ -36221,15 +37752,15 @@ class="cmtt-10">}</span> </div> </div> (The provided <span class="cmtt-10">\alsoname </span>definition may be removed.) -<!--l. 17565--><p class="indent" > The original example redefines the cross-referencing format to use <a +<!--l. 17988--><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"> + id="dx1-207014"></a></a>: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\renewcommand{\glsseeitemformat</span><a - id="dx1-204015"></a><span + id="dx1-207015"></a><span class="cmtt-10">}[1]{\textsc{\glsentryname</span><a - id="dx1-204016"></a><span + id="dx1-207016"></a><span class="cmtt-10">{#1}}}</span> </div> </div> This will still produce the desired effect with <a @@ -36240,60 +37771,60 @@ 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. 17575--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +<!--l. 17998--><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 + id="dx1-207017"></a></a></span>If you want to switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-204018"></a></a> then you first need to switch to <a + id="dx1-207018"></a></a> then you first need to switch to <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, as -described above, but you now need the <span id="textcolor868"><span +described above, but you now need the <span id="textcolor894"><span class="cmss-10">record</span></span><a - id="dx1-204019"></a> option but no longer need the <span id="textcolor869"><span + id="dx1-207019"></a> option but no longer need the <span id="textcolor895"><span class="cmss-10">autoseeindex</span><span class="cmtt-10">=</span><span class="cmss-10">false</span></span><a - id="dx1-204020"></a> option: + id="dx1-207020"></a> option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor870"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor896"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor871"><span +class="cmtt-10">,</span><span id="textcolor897"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor872"><span +class="cmtt-10">,</span><span id="textcolor898"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">]{glossaries-extra}</span> </div> </div> Next the entry definitions need to be converted to the <span class="cmtt-10">bib</span><a - id="dx1-204021"></a> format required by <a + id="dx1-207021"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-204022"></a></a>. -<!--l. 17585--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-207022"></a></a>. +<!--l. 18008--><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> If you have at least v2.0 then <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-204023"></a></a> will absorb the cross-referencing information supplied + id="dx1-207023"></a></a> will absorb the cross-referencing information supplied by: </p> - <div class="verbatim" id="verbatim-455"> + <pre class="verbatim" id="verbatim-462"> \glssee{fruit}{pear,apple,banana} -</div> -<!--l. 17592--><p class="nopar" > into the <span +</pre> +<!--l. 18015--><p class="nopar" > into the <span class="cmtt-10">fruit </span>definition: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor873"><span +<span id="textcolor899"><span class="cmtt-10">@entry</span></span><a - id="dx1-204024"></a><span + id="dx1-207024"></a><span class="cmtt-10">{fruit,</span> <br /><span class="cmtt-10"> </span><span @@ -36324,19 +37855,19 @@ class="cmtt-10">\makeglossaries </span>and all the entry definition commands (in class="cmtt-10">\glssee </span>from the preamble) and add: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor874"><span +<span id="textcolor900"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-204025"></a><span -class="cmtt-10">[</span><span id="textcolor875"><span + id="dx1-207025"></a><span +class="cmtt-10">[</span><span id="textcolor901"><span class="cmtt-10">src</span></span><a - id="dx1-204026"></a><span + id="dx1-207026"></a><span class="cmtt-10">=entries.bib]</span> </div> </div> Finally, replace <span -class="cmtt-10">\printglossaries </span>with <span id="textcolor876"><span +class="cmtt-10">\printglossaries </span>with <span id="textcolor902"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-204027"></a>. The document build is now: -<!--l. 17608--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-207027"></a>. The document build is now: +<!--l. 18031--><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 @@ -36344,17 +37875,17 @@ 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. 17616--><p class="indent" > Now change the selection criteria: </p><div class="alltt"> +</p><!--l. 18039--><p class="indent" > Now change the selection criteria: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor877"><span +<span id="textcolor903"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-204028"></a><span -class="cmtt-10">[</span><span id="textcolor878"><span + id="dx1-207028"></a><span +class="cmtt-10">[</span><span id="textcolor904"><span class="cmtt-10">src</span></span><a - id="dx1-204029"></a><span + id="dx1-207029"></a><span class="cmtt-10">=entries.bib,</span> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor879"><span +class="cmtt-10"> </span><strong><span id="textcolor905"><span class="cmtt-10">selection</span></span><span class="cmtt-10">={recorded</span><span class="cmtt-10"> and</span><span @@ -36364,33 +37895,33 @@ class="cmtt-10"> see}</span></strong><span class="cmtt-10">]</span> </div> </div> The glossary now includes fruit, zucchini and marrow. -<!--l. 17623--><p class="indent" > The fruit and zucchini use the <span +<!--l. 18046--><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 + id="dx1-207030"></a> key which is a simple redirection for the reader. There’s no <a href="#glo:numberlist">number list<a - id="dx1-204031"></a></a> -for either of these entries. Whereas marrow uses the <span id="textcolor880"><span id="textcolor881"><span + id="dx1-207031"></a></a> +for either of these entries. Whereas marrow uses the <span id="textcolor906"><span id="textcolor907"><span class="cmtt-10">seealso</span></span><a - id="dx1-204032"></a></span> key, which is typically intended as a + id="dx1-207032"></a></span> key, which is typically intended as a 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 + id="dx1-207033"></a></a> but in this case there are no locations as marrow hasn’t been used in the text. -</p><!--l. 17630--><p class="indent" > With at least v2.0, there’s an alternative: </p><div class="alltt"> +</p><!--l. 18053--><p class="indent" > With at least v2.0, there’s an alternative: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor882"><span +<span id="textcolor908"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-204034"></a><span -class="cmtt-10">[</span><span id="textcolor883"><span + id="dx1-207034"></a><span +class="cmtt-10">[</span><span id="textcolor909"><span class="cmtt-10">src</span></span><a - id="dx1-204035"></a><span + id="dx1-207035"></a><span class="cmtt-10">=entries.bib,</span> <br /><span -class="cmtt-10"> </span><span id="textcolor884"><span +class="cmtt-10"> </span><span id="textcolor910"><span class="cmtt-10">selection</span></span><a - id="dx1-204036"></a><span + id="dx1-207036"></a><span class="cmtt-10">={recorded</span><span class="cmtt-10"> and</span><span class="cmtt-10"> deps</span><span @@ -36401,100 +37932,100 @@ 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. 17638--><p class="noindent" > +<!--l. 18061--><p class="noindent" > </p> -<!--l. 17638--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.8 </span> <a +<!--l. 18061--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.8 </span> <a id="sec:samplescustomkeys"></a>Custom Keys</h3> <a - id="x1-205001r25"></a> -<!--l. 17641--><p class="noindent" > + id="x1-208001r25"></a> +<!--l. 18064--><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. 17641--><p class="noindent" >This document illustrates how add custom keys (using <span +<!--l. 18064--><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 + id="dx1-209001"></a>). There are two custom keys <span class="cmtt-10">ed</span>, where the default value is the <span class="cmtt-10">text</span><a - id="dx1-206002"></a> field with “ed” appended, and <span + id="dx1-209002"></a> field with “ed” appended, and <span class="cmtt-10">ing</span>, where the default value is the <span class="cmtt-10">text</span><a - id="dx1-206003"></a> field with “ing” + id="dx1-209003"></a> field with “ing” appended. Since the default value in both cases references the <span class="cmtt-10">text</span><a - id="dx1-206004"></a> field, the starred version <span + id="dx1-209004"></a> field, the starred version <span 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. 17650--><p class="indent" > The entries are then defined as follows: +</p><!--l. 18073--><p class="indent" > The entries are then defined as follows: </p> - <div class="verbatim" id="verbatim-456"> + <pre class="verbatim" id="verbatim-463"> \newglossaryentry{jump}{name={jump},description={}} - <br />\newglossaryentry{run}{name={run},% - <br /> ed={ran},% - <br /> ing={running}, - <br /> description={}} - <br />\newglossaryentry{waddle}{name={waddle},% - <br /> ed={waddled},% - <br /> ing={waddling},% - <br /> description={}} -</div> -<!--l. 17663--><p class="nopar" > -</p><!--l. 17665--><p class="indent" > Each custom key is provided a set of commands analogous to <span +\newglossaryentry{run}{name={run},% + ed={ran},% + ing={running}, + description={}} +\newglossaryentry{waddle}{name={waddle},% + ed={waddled},% + ing={waddling},% + description={}} +</pre> +<!--l. 18086--><p class="nopar" > +</p><!--l. 18088--><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. 17670--><p class="indent" > If you find yourself wanting to create a lot of custom keys that produce minor variations of existing keys +</p><!--l. 18093--><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-457"> + <pre class="verbatim" id="verbatim-464"> The dog \glsdisp{jump}{jumped} over the duck. -</div> -<!--l. 17676--><p class="nopar" > than +</pre> +<!--l. 18099--><p class="nopar" > than </p> - <div class="verbatim" id="verbatim-458"> + <pre class="verbatim" id="verbatim-465"> The dog \glsed{jump} over the duck. -</div> -<!--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 +</pre> +<!--l. 18103--><p class="nopar" > +</p><!--l. 18105--><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 + id="dx1-209005"></a></a></span>If you want to convert this document to use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-206006"></a></a>, you first need to switch to <a + id="dx1-209006"></a></a>, you first need to switch to <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>, but -remember that you need the <span id="textcolor885"><span +remember that you need the <span id="textcolor911"><span class="cmss-10">record</span></span><a - id="dx1-206007"></a> option: </p><div class="alltt"> + id="dx1-209007"></a> option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor886"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor912"><span class="cmtt-10">record</span></span></strong><span class="cmtt-10">]</span><strong><span class="cmtt-10">glossaries-extra</span></strong> </div> </div> Next convert the entry definitions to the <span class="cmtt-10">bib</span><a - id="dx1-206008"></a> format required by <a + id="dx1-209008"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-206009"></a></a>: -<!--l. 17691--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-209009"></a></a>: +<!--l. 18114--><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> @@ -36502,19 +38033,19 @@ The <span class="cmtt-10">--index-conversion </span>switch requires at least v2.0 and will convert entries without a description (or where the description is simply <span class="cmtt-10">\nopostdesc</span><a - id="dx1-206010"></a> or <span id="textcolor887"><span + id="dx1-209010"></a> or <span id="textcolor913"><span class="cmtt-10">\glsxtrnopostpunc</span></span><a - id="dx1-206011"></a>) to <span id="textcolor888"><span + id="dx1-209011"></a>) to <span id="textcolor914"><span class="cmtt-10">@index</span></span><a - id="dx1-206012"></a> instead of <span id="textcolor889"><span + id="dx1-209012"></a> instead of <span id="textcolor915"><span class="cmtt-10">@entry</span></span><a - id="dx1-206013"></a>. This means that + id="dx1-209013"></a>. This means that the new <span class="cmtt-10">entries.bib </span>file will contain: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor890"><span +<span id="textcolor916"><span class="cmtt-10">@index</span></span><a - id="dx1-206014"></a><span + id="dx1-209014"></a><span class="cmtt-10">{jump,</span> <br /><span class="cmtt-10"> </span><span @@ -36524,9 +38055,9 @@ class="cmtt-10"> {jump}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor891"><span +<br /><span id="textcolor917"><span class="cmtt-10">@index</span></span><a - id="dx1-206015"></a><span + id="dx1-209015"></a><span class="cmtt-10">{run,</span> <br /><span class="cmtt-10"> </span><span @@ -36546,9 +38077,9 @@ class="cmtt-10"> {ran}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor892"><span +<br /><span id="textcolor918"><span class="cmtt-10">@index</span></span><a - id="dx1-206016"></a><span + id="dx1-209016"></a><span class="cmtt-10">{waddle,</span> <br /><span class="cmtt-10"> </span><span @@ -36571,23 +38102,23 @@ class="cmtt-10">}</span> </div> Now replace <span class="cmtt-10">\makeglossaries </span>with <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor893"><span +<span id="textcolor919"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-206017"></a><span -class="cmtt-10">[</span><span id="textcolor894"><span + id="dx1-209017"></a><span +class="cmtt-10">[</span><span id="textcolor920"><span class="cmtt-10">src</span></span><a - id="dx1-206018"></a><span + id="dx1-209018"></a><span class="cmtt-10">=entries]</span> </div> </div> and delete the <span class="cmtt-10">\newglossaryentry </span>commands. Finally replace <span -class="cmtt-10">\printglossaries </span>with <span id="textcolor895"><span +class="cmtt-10">\printglossaries </span>with <span id="textcolor921"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-206019"></a>. -<!--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"> + id="dx1-209019"></a>. +<!--l. 18146--><p class="indent" > The document build is now: +</p><!--l. 18147--><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 @@ -36595,30 +38126,30 @@ class="cmtt-10">\printunsrtglossaries</span></span><a <br /></span> Note that there’s no need for the <span class="cmss-10">nonumberlist</span><a - id="dx1-206020"></a> package option when you don’t use <a + id="dx1-209020"></a> package option when you don’t use <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-206021"></a>’s</a> <span + id="dx1-209021"></a>’s</a> <span class="cmtt-10">--group</span> switch. <a - id="x1-206022r26"></a> -</p><!--l. 17733--><p class="noindent" > + id="x1-209022r26"></a> +</p><!--l. 18156--><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. 17733--><p class="noindent" >This document illustrates how add custom storage keys (using <span +<!--l. 18156--><p class="noindent" >This document illustrates how add custom storage keys (using <span class="cmtt-10">\glsaddstoragekey</span>). The document build is: -</p><!--l. 17735--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18158--><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. 17741--><p class="indent" > The custom storage key is called <span +</p><!--l. 18164--><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 @@ -36626,27 +38157,27 @@ class="cmtt-10">\abbrtype</span>. </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glsaddstoragekey</span><a - id="dx1-207001"></a><span + id="dx1-210001"></a><span class="cmtt-10">{abbrtype}{word}{\abbrtype}</span> </div> </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. 17751--><p class="indent" > This essentially forms a very similar function to the <a +<!--l. 18174--><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="cmss-10">glossaries-extra</span></a> package’s <span id="textcolor922"><span id="textcolor923"><span class="cmtt-10">category</span></span><a - id="dx1-207002"></a></span> key, which is also + id="dx1-210002"></a></span> key, which is also defined as a storage key: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\glsaddstoragekey{category}{general}{</span><span id="textcolor898"><span +class="cmtt-10">\glsaddstoragekey{category}{general}{</span><span id="textcolor924"><span class="cmtt-10">\glscategory</span></span><a - id="dx1-207003"></a><span + id="dx1-210003"></a><span class="cmtt-10">}</span> </div> </div> -<!--l. 17758--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 18181--><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 @@ -36657,29 +38188,29 @@ class="cmss-10">glossaries-extra</span></a> package: </p><div class="alltt"> <span class="cmtt-10">\documentclass{article}</span> <br /><span -class="cmtt-10">\usepackage[</span><span id="textcolor899"><span +class="cmtt-10">\usepackage[</span><span id="textcolor925"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span class="cmtt-10">}</span> <br /><span class="cmtt-10">\makeglossaries</span> -<br /><span id="textcolor900"><span +<br /><span id="textcolor926"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-207004"></a><span + id="dx1-210004"></a><span class="cmtt-10">[</span><strong><span class="cmtt-10">acronym</span></strong><span class="cmtt-10">]{short-long}</span> <br /><span class="cmtt-10">\newacronym</span><a - id="dx1-207005"></a><span + id="dx1-210005"></a><span class="cmtt-10">{radar}{radar}{radio</span><span class="cmtt-10"> detecting</span><span class="cmtt-10"> and</span><span class="cmtt-10"> ranging}</span> <br /><span class="cmtt-10">\newacronym</span><a - id="dx1-207006"></a><span + id="dx1-210006"></a><span class="cmtt-10">{laser}{laser}{light</span><span class="cmtt-10"> amplification</span><span class="cmtt-10"> by</span><span @@ -36690,22 +38221,22 @@ class="cmtt-10"> of</span><span class="cmtt-10"> radiation}</span> <br /><span class="cmtt-10">\newacronym</span><a - id="dx1-207007"></a><span + id="dx1-210007"></a><span class="cmtt-10">{scuba}{scuba}{self-contained</span><span class="cmtt-10"> underwater</span><span class="cmtt-10"> breathing</span> <br /><span class="cmtt-10">apparatus}</span> <br /> -<br /><span id="textcolor901"><span +<br /><span id="textcolor927"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-207008"></a><span + id="dx1-210008"></a><span class="cmtt-10">{dsp}{DSP}{digital</span><span class="cmtt-10"> signal</span><span class="cmtt-10"> processing}</span> -<br /><span id="textcolor902"><span +<br /><span id="textcolor928"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-207009"></a><span + id="dx1-210009"></a><span class="cmtt-10">{atm}{ATM}{automated</span><span class="cmtt-10"> teller</span><span class="cmtt-10"> machine}</span> @@ -36740,23 +38271,23 @@ class="cmtt-10">\end{document}</span> </div> </div> <a - id="x1-207010r27"></a> -<!--l. 17787--><p class="noindent" > + id="x1-210010r27"></a> +<!--l. 18210--><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. 17787--><p class="noindent" >An extension of the previous example where the user needs to provide a description. +<!--l. 18210--><p class="noindent" >An extension of the previous example where the user needs to provide a description. <a - id="x1-208001r28"></a> -</p><!--l. 17790--><p class="noindent" > + id="x1-211001r28"></a> +</p><!--l. 18213--><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. 17790--><p class="noindent" >This document illustrates how to add a custom key using <span +<!--l. 18213--><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 @@ -36764,7 +38295,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. 17795--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18218--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample-chap-hyperfirst @@ -36777,7 +38308,7 @@ class="cmtt-10">chapter </span>used to store the chapter number. </p><div class= <div class="obeylines-v"> <span class="cmtt-10">\glsaddstoragekey</span><a - id="dx1-209001"></a><span + id="dx1-212001"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">chapter</span></strong><span class="cmtt-10">}{0}{</span><strong><span @@ -36786,7 +38317,7 @@ class="cmtt-10">}</span> </div> </div> It’s initialised to 0 and the <span class="cmtt-10">\glslinkpostsetkeys</span><a - id="dx1-209002"></a> hook is used to check this value against the current chapter + id="dx1-212002"></a> hook is used to check this value against the current chapter number. If the values are the same then the hyperlink is switched off, otherwise the key value is updated unless the hyperlink has been switched off (through the optional argument of commands like <span class="cmtt-10">\gls </span>and <span @@ -36795,7 +38326,7 @@ class="cmtt-10">\glstext</span>). <div class="obeylines-v"> <span class="cmtt-10">\renewcommand*{\glslinkpostsetkeys</span><a - id="dx1-209003"></a><span + id="dx1-212003"></a><span class="cmtt-10">}{%</span> <br /><span class="cmtt-10"> \edef\currentchap{\arabic{chapter}}%</span> @@ -36811,9 +38342,9 @@ class="cmtt-10"> \else</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \glsifhyperon</span><a - id="dx1-209004"></a><span + id="dx1-212004"></a><span class="cmtt-10">{\glsfieldxdef</span><a - id="dx1-209005"></a><span + id="dx1-212005"></a><span class="cmtt-10">{\glslabel}{</span><strong><span class="cmtt-10">chapter</span></strong><span class="cmtt-10">}{\currentchap}}{}%</span> @@ -36825,12 +38356,12 @@ class="cmtt-10">}</span> </div> Since this key isn’t intended for use when the entry is being defined, it would be more appropriate to simply use an internal field that doesn’t have an associated key or helper command, but <span class="cmtt-10">\glsfieldxdef</span><a - id="dx1-209006"></a> requires the + id="dx1-212006"></a> requires the 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. 17828--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 18251--><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 @@ -36838,7 +38369,7 @@ class="cmss-10">glossaries-extra</span></a> you need to change the package loadi </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><span id="textcolor903"><span +class="cmtt-10">\usepackage[</span><span id="textcolor929"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -36847,19 +38378,19 @@ class="cmtt-10">}</span> </div> The custom storage key (provided with <span class="cmtt-10">\glsaddstoragekey</span>) can be removed, and the <span class="cmtt-10">\glslinkpostsetkeys</span><a - id="dx1-209007"></a> + id="dx1-212007"></a> hook can be changed to: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\renewcommand*{\glslinkpostsetkeys</span><a - id="dx1-209008"></a><span + id="dx1-212008"></a><span class="cmtt-10">}{%</span> <br /><span class="cmtt-10"> \edef\currentchap{\arabic{chapter}}%</span> <br /><span -class="cmtt-10"> </span><strong><span id="textcolor904"><span +class="cmtt-10"> </span><strong><span id="textcolor930"><span class="cmtt-10">\GlsXtrIfFieldEqNum</span></span><a - id="dx1-209009"></a><span + id="dx1-212009"></a><span class="cmtt-10">*</span></strong><span class="cmtt-10">{</span><strong><span class="cmtt-10">chapter</span></strong><span @@ -36880,10 +38411,10 @@ class="cmtt-10"> {%</span> class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \glsifhyperon</span><a - id="dx1-209010"></a><span -class="cmtt-10">{</span><strong><span id="textcolor905"><span + id="dx1-212010"></a><span +class="cmtt-10">{</span><strong><span id="textcolor931"><span class="cmtt-10">\xGlsXtrSetField</span></span><a - id="dx1-209011"></a></strong><span + id="dx1-212011"></a></strong><span class="cmtt-10">{\glslabel}{</span><strong><span class="cmtt-10">chapter</span></strong><span class="cmtt-10">}{\currentchap}}{}%</span> @@ -36894,91 +38425,91 @@ 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. 17851--><p class="noindent" > +<!--l. 18274--><p class="noindent" > </p> -<!--l. 17851--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.9 </span> <a +<!--l. 18274--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.9 </span> <a id="sec:samplesxindy"></a>Xindy (Option 3)</h3> -<!--l. 17854--><p class="noindent" >Most of the earlier <a +<!--l. 18277--><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 + id="dx1-213001"></a></a> sample files can be adapted to use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-210002"></a></a> instead by adding the <span + id="dx1-213002"></a></a> instead by adding the <span class="cmss-10">xindy</span><a - id="dx1-210003"></a> package + id="dx1-213003"></a> package option. Situations that you need to be careful about are when the sort value (obtained from the <span class="cmtt-10">name</span><a - id="dx1-210004"></a> if the <span + id="dx1-213004"></a> if the <span class="cmtt-10">sort</span><a - id="dx1-210005"></a> + id="dx1-213005"></a> key is omitted) contains commands (such as <span class="obeylines-h"><span class="verb"><span class="cmtt-10">name={\pi}</span></span></span>) or is identical to another value (or is identical after <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-210006"></a></a> has stripped all commands and braces). This section describes sample documents that use features which + id="dx1-213006"></a></a> has stripped all commands and braces). This section describes sample documents that use features which are unavailable with <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-210007"></a></a>. + id="dx1-213007"></a></a>. <a - id="x1-210008r29"></a> -</p><!--l. 17863--><p class="noindent" > + id="x1-213008r29"></a> +</p><!--l. 18286--><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. 17863--><p class="noindent" >The document uses UTF8 encoding (with the <span +<!--l. 18286--><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 + id="dx1-214001"></a> package). This is information that needs to be passed to <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-211002"></a></a>, so the encoding is picked up by <a + id="dx1-214002"></a></a>, so the encoding is picked up by <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-211003"></a></a> from the <span + id="dx1-214003"></a></a> from the <span class="cmtt-10">aux</span><a - id="dx1-211004"></a> file. -</p><!--l. 17868--><p class="indent" > By default, this document will create a <a + id="dx1-214004"></a> file. +</p><!--l. 18291--><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 + id="dx1-214005"></a></a> style file called <span class="cmtt-10">samplexdy.xdy</span>, but if you uncomment the lines </p> - <div class="verbatim" id="verbatim-459"> + <pre class="verbatim" id="verbatim-466"> \setStyleFile{samplexdy-mc} - <br />\noist - <br />\GlsSetXdyLanguage{} -</div> -<!--l. 17874--><p class="nopar" > it will set the style file to <span +\noist +\GlsSetXdyLanguage{} +</pre> +<!--l. 18297--><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 class="cmtt-10">makeglossaries</span><a - id="dx1-211006"></a></a> or <a + id="dx1-214006"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-211007"></a></a>, you don’t need to supply + id="dx1-214007"></a></a>, you don’t need to supply any additional information. If you don’t use <span class="cmtt-10">makeglossaries</span><a - id="dx1-211008"></a>, you will need to specify the required + id="dx1-214008"></a>, you will need to specify the required information. Note that if you set the style file to <span class="cmtt-10">samplexdy-mc.xdy </span>you must also specify <span class="cmtt-10">\noist</span><a - id="dx1-211009"></a>, + id="dx1-214009"></a>, 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. 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"> +</p><!--l. 18310--><p class="indent" > To create the document do: +</p><!--l. 18311--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplexdy <br />makeglossaries samplexdy <br />pdflatex samplexdy @@ -36987,82 +38518,85 @@ group. If you don’t have Perl installed then you can’t use <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-211010"></a></a>, but you also can’t use <a + id="dx1-214010"></a></a>, but you also can’t use <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-211011"></a></a>! However, if + id="dx1-214011"></a></a>! However, if for some reason you want to call <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-211012"></a></a> explicitly instead of using <a + id="dx1-214012"></a></a> explicitly instead of using <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-211013"></a></a> (or <a + id="dx1-214013"></a></a> (or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-211014"></a></a>): + id="dx1-214014"></a></a>): </p> <ul class="itemize1"> - <li class="itemize">if you are using the default style file <span + <li class="itemize"> + <!--l. 18322--><p class="noindent" >if you are using the default style file <span class="cmtt-10">samplexdy.xdy</span>, then do (no line breaks): - <!--l. 17901--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 18324--><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 + <li class="itemize"> + <!--l. 18327--><p class="noindent" >if you are using <span class="cmtt-10">samplexdy-mc.xdy</span>, then do (no line breaks): - <!--l. 17906--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + </p><!--l. 18329--><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. 17911--><p class="indent" > This document creates a new command to use with the <span +<!--l. 18334--><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 + id="dx1-214015"></a> key in the optional argument of commands like <span class="cmtt-10">\gls </span>to format the location in the <a href="#glo:numberlist">number list<a - id="dx1-211016"></a></a>. The usual type of definition when a hyperlinked location is + id="dx1-214016"></a></a>. The usual type of definition when a hyperlinked location is required should use one of the <span class="cmtt-10">\hyper</span>⟨<span class="cmitt-10">xx</span>⟩<a - id="dx1-211017"></a> commands listed in <a -href="#tab:hyperxx">table 6.1</a>: + id="dx1-214017"></a> commands listed in <a +href="#tab:hyperxx">table <span +class="cmbx-10">??</span>tab:hyperxx</a>: </p> - <div class="verbatim" id="verbatim-460"> + <pre class="verbatim" id="verbatim-467"> \newcommand*{\hyperbfit}[1]{\textit{\hyperbf{#1}}} -</div> -<!--l. 17919--><p class="nopar" > Unfortunately, this definition doesn’t work for this particular document and some adjustments are needed (see +</pre> +<!--l. 18342--><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 + id="dx1-214018"></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 + id="dx1-214019"></a></a> can recognise it: </p> - <div class="verbatim" id="verbatim-461"> + <pre class="verbatim" id="verbatim-468"> \GlsAddXdyAttribute{hyperbfit} -</div> -<!--l. 17928--><p class="nopar" > This will add information to the <span +</pre> +<!--l. 18351--><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 + id="dx1-214020"></a> file when it’s created by <span class="cmtt-10">\makeglossaries</span>. If you prevent the creation of this file with <span class="cmtt-10">\noist</span><a - id="dx1-211021"></a> then you will need to add the attribute to your custom <span + id="dx1-214021"></a> then you will need to add the attribute to your custom <span class="cmtt-10">xdy</span><a - id="dx1-211022"></a> file (see the provided + id="dx1-214022"></a> file (see the provided <span class="cmtt-10">samplexdy-mc.xdy </span>file). -</p><!--l. 17935--><p class="indent" > In order to illustrate unusual location formats, this sample document provides a command called +</p><!--l. 18358--><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 @@ -37072,25 +38606,25 @@ class="cmti-10">n</span>⟩: </p> - <div class="verbatim" id="verbatim-462"> + <pre class="verbatim" id="verbatim-469"> \newrobustcmd*{\tallynum}[1]{% - <br /> \ifnum\number#1<7 - <br />  $\csname dice\romannumeral#1\endcsname$% - <br /> \else - <br />  $\dicevi$% - <br />  \expandafter\tallynum\expandafter{\numexpr#1-6}% - <br /> \fi - <br />} -</div> -<!--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 + \ifnum\number#1<7 +  $\csname dice\romannumeral#1\endcsname$% + \else +  $\dicevi$% +  \expandafter\tallynum\expandafter{\numexpr#1-6}% + \fi +} +</pre> +<!--l. 18370--><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 + id="dx1-214023"></a>, …, <span 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 + id="dx1-214024"></a> package, so that needs to be loaded. -</p><!--l. 17953--><p class="indent" > An associated command <span +</p><!--l. 18376--><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 @@ -37100,49 +38634,49 @@ class="cmtt-10">\tallynum</span>: </p> - <div class="verbatim" id="verbatim-463"> + <pre class="verbatim" id="verbatim-470"> \newcommand*{\tally}[1]{\tallynum{\arabic{#1}}} -</div> -<!--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 +</pre> +<!--l. 18381--><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. 17962--><p class="indent" > This custom location format also needs to be identified in the <span + id="dx1-214025"></a>). +</p><!--l. 18385--><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 + id="dx1-214026"></a> file so that <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-211027"></a></a> can recognise it and + id="dx1-214027"></a></a> can recognise it and determine how to form ranges if required. </p> - <div class="verbatim" id="verbatim-464"> + <pre class="verbatim" id="verbatim-471"> \GlsAddXdyLocation{tally}{% tally location format - <br /> :sep "\string\tallynum\space\glsopenbrace" - <br /> "arabic-numbers" - <br /> :sep "\glsclosebrace" - <br />} -</div> -<!--l. 17971--><p class="nopar" > Again this information is written to the <span + :sep "\string\tallynum\space\glsopenbrace" + "arabic-numbers" + :sep "\glsclosebrace" +} +</pre> +<!--l. 18394--><p class="nopar" > Again this information is written to the <span class="cmtt-10">xdy</span><a - id="dx1-211028"></a> file by <span + id="dx1-214028"></a> file by <span class="cmtt-10">\makeglossaries </span>so if you use <span 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. 17976--><p class="indent" > When <a + id="dx1-214029"></a> file. +</p><!--l. 18399--><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"> + id="dx1-214030"></a></a> creates the associated glossary files, the locations will be written using: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\glsX</span>⟨<span class="cmitt-10">counter</span>⟩<span class="cmtt-10">X</span>⟨<span class="cmitt-10">format</span>⟩<a - id="dx1-211031"></a><span + id="dx1-214031"></a><span class="cmtt-10">{</span>⟨<span class="cmitt-10">hyper-prefix</span>⟩<span class="cmtt-10">}{</span>⟨<span @@ -37172,7 +38706,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. 17998--><p class="indent" > Remember that in both cases, the second argument <span class="obeylines-h"><span class="verb"><span +<!--l. 18421--><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 @@ -37180,72 +38714,72 @@ class="cmtt-10">}</span>: </p> - <div class="verbatim" id="verbatim-465"> + <pre class="verbatim" id="verbatim-472"> \renewcommand{\glsXpageXglsnumberformat}[2]{% - <br /> \linkpagenumber#2% - <br />} - <br />\renewcommand{\glsXpageXhyperbfit}[2]{% - <br /> \textbf{\em\linkpagenumber#2}% - <br />} -</div> -<!--l. 18007--><p class="nopar" > These need a command that can grab the actual number and correctly encapsulate it: + \linkpagenumber#2% +} +\renewcommand{\glsXpageXhyperbfit}[2]{% + \textbf{\em\linkpagenumber#2}% +} +</pre> +<!--l. 18430--><p class="nopar" > These need a command that can grab the actual number and correctly encapsulate it: </p> - <div class="verbatim" id="verbatim-466"> + <pre class="verbatim" id="verbatim-473"> \newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} -</div> -<!--l. 18012--><p class="nopar" > -</p><!--l. 18014--><p class="indent" > If you want to try out the <span +</pre> +<!--l. 18435--><p class="nopar" > +</p><!--l. 18437--><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 - id="dx1-211032"></a> (and not + id="dx1-214032"></a> (and not require a custom <span class="cmtt-10">xdy</span><a - id="dx1-211033"></a> file) but unfortunately the “M” letter group will have already been defined and take + id="dx1-214033"></a> file) but unfortunately the “M” letter group will have already been defined and take precedence over “Mc”, which is why a custom file is required and the normal language module must be suppressed: </p> - <div class="verbatim" id="verbatim-467"> + <pre class="verbatim" id="verbatim-474"> \setStyleFile{samplexdy-mc} - <br />\noist - <br />\GlsSetXdyLanguage{} -</div> -<!--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 +\noist +\GlsSetXdyLanguage{} +</pre> +<!--l. 18449--><p class="nopar" > +</p><!--l. 18451--><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 + id="dx1-214034"></a> key for that value is set to lower case: </p> - <div class="verbatim" id="verbatim-468"> + <pre class="verbatim" id="verbatim-475"> \newglossaryentry{mach}{name={Mach, Ernst}, - <br />first={Ernst Mach},text={Mach}, - <br />sort={mach, Ernst}, - <br />description={Czech/Austrian physicist and philosopher}} -</div> -<!--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 +first={Ernst Mach},text={Mach}, +sort={mach, Ernst}, +description={Czech/Austrian physicist and philosopher}} +</pre> +<!--l. 18459--><p class="nopar" > +</p><!--l. 18461--><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 + id="dx1-214035"></a></a></span>If you want to convert this document so that it uses <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-211036"></a></a>, you first need to switch to + id="dx1-214036"></a></a>, you first need to switch to <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> and use the <span id="textcolor906"><span +class="cmss-10">glossaries-extra</span></a> and use the <span id="textcolor932"><span class="cmss-10">record</span></span><a - id="dx1-211037"></a> package option: </p><div class="alltt"> + id="dx1-214037"></a> package option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor907"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor933"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor908"><span +class="cmtt-10">,</span><span id="textcolor934"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -37254,7 +38788,7 @@ class="cmtt-10">}</span> </div> The <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-211038"></a></a>-only commands can now all be removed (attribute <span + id="dx1-214038"></a></a>-only commands can now all be removed (attribute <span class="cmtt-10">\GlsAddXdyAttribute</span>, location <span class="cmtt-10">\GlsAddXdyLocation</span>, language <span @@ -37263,59 +38797,59 @@ class="cmtt-10">\glsX</span>⟨<span class="cmitt-10">counter</span>⟩<span class="cmtt-10">X</span>⟨<span class="cmitt-10">format</span>⟩<a - id="dx1-211039"></a> and the + id="dx1-214039"></a> and the custom helper <span class="cmtt-10">\linkpagenumber</span>). Also <span class="cmtt-10">\noist </span>and <span class="cmtt-10">\setStyleFile </span>aren’t relevant with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-211040"></a></a> and so should + id="dx1-214040"></a></a> and so should be removed. -<!--l. 18053--><p class="indent" > The definitions of <span +<!--l. 18476--><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. 18056--><p class="indent" > The entries all need to be converted to the <span +</p><!--l. 18479--><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 + id="dx1-214041"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-211042"></a></a>. -</p><!--l. 18058--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-214042"></a></a>. +</p><!--l. 18481--><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> Next replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor909"><span +<span id="textcolor935"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-211043"></a><span -class="cmtt-10">[</span><span id="textcolor910"><span + id="dx1-214043"></a><span +class="cmtt-10">[</span><span id="textcolor936"><span class="cmtt-10">src</span></span><a - id="dx1-211044"></a><span + id="dx1-214044"></a><span class="cmtt-10">=entries]</span> </div> </div> and remove all the entry definitions from the preamble. Use the search and replace function on your text editor to replace all instances of <span class="cmtt-10">\glsentryfirst</span><a - id="dx1-211045"></a> with <span id="textcolor911"><span + id="dx1-214045"></a> with <span id="textcolor937"><span class="cmtt-10">\glsfmtfirst</span></span><a - id="dx1-211046"></a>, and all instances of <span + id="dx1-214046"></a>, and all instances of <span class="cmtt-10">\glsentryname</span><a - id="dx1-211047"></a> with -<span id="textcolor912"><span + id="dx1-214047"></a> with +<span id="textcolor938"><span class="cmtt-10">\glsfmtname</span></span><a - id="dx1-211048"></a>. -<!--l. 18070--><p class="indent" > Finally, replace <span + id="dx1-214048"></a>. +<!--l. 18493--><p class="indent" > Finally, replace <span class="cmtt-10">\printglossaries</span><a - id="dx1-211049"></a> with <span id="textcolor913"><span + id="dx1-214049"></a> with <span id="textcolor939"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-211050"></a>. The document build is now: -</p><!--l. 18072--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-214050"></a>. The document build is now: +</p><!--l. 18495--><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 @@ -37323,81 +38857,81 @@ class="cmtt-10">\printunsrtglossaries</span></span><a <br /></span> -</p><!--l. 18078--><p class="indent" > This results in a slightly different ordering from the original document (without the “Mc” letter group). In +</p><!--l. 18501--><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 class="cmtt-10">bib2gls</span><a - id="dx1-211051"></a>’s</a> default <span id="textcolor914"><span + id="dx1-214051"></a>’s</a> default <span id="textcolor940"><span class="cmtt-10">break-at</span></span><span class="cmtt-10">=word</span><a - id="dx1-211052"></a> setting, + id="dx1-214052"></a> setting, which marks word boundaries with the pipe (<span class="cmtt-10">|</span>) character, so the sort values for <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-211053"></a></a> are <span + id="dx1-214053"></a></a> are <span class="cmtt-10">Mach|Earnest|</span> and <span class="cmtt-10">Mach|number|</span>. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-211054"></a></a> manual for further details of this option, and also see the + id="dx1-214054"></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. 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"> +</p><!--l. 18513--><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 +<span id="textcolor941"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-211055"></a><span -class="cmtt-10">[</span><span id="textcolor916"><span + id="dx1-214055"></a><span +class="cmtt-10">[</span><span id="textcolor942"><span class="cmtt-10">src</span></span><a - id="dx1-211056"></a><span + id="dx1-214056"></a><span class="cmtt-10">=entries,</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor917"><span +class="cmtt-10"> </span><span id="textcolor943"><span class="cmtt-10">sort</span></span><a - id="dx1-211057"></a><span + id="dx1-214057"></a><span class="cmtt-10">=</span><strong><span class="cmtt-10">custom</span></strong><span class="cmtt-10">,</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><strong><span id="textcolor918"><span +class="cmtt-10"> </span><strong><span id="textcolor944"><span class="cmtt-10">sort-rule</span></span></strong><span -class="cmtt-10">={</span><span id="textcolor919"><span +class="cmtt-10">={</span><span id="textcolor945"><span class="cmtt-10">\glsxtrcontrolrules</span></span><a - id="dx1-211058"></a> + id="dx1-214058"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> ;</span><span id="textcolor920"><span +class="cmtt-10"> ;</span><span id="textcolor946"><span class="cmtt-10">\glsxtrspacerules</span></span><a - id="dx1-211059"></a><span -class="cmtt-10">;</span><span id="textcolor921"><span + id="dx1-214059"></a><span +class="cmtt-10">;</span><span id="textcolor947"><span class="cmtt-10">\glsxtrnonprintablerules</span></span><a - id="dx1-211060"></a> + id="dx1-214060"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> ;</span><span id="textcolor922"><span +class="cmtt-10"> ;</span><span id="textcolor948"><span class="cmtt-10">\glsxtrcombiningdiacriticrules</span></span><a - id="dx1-211061"></a><span -class="cmtt-10">,</span><span id="textcolor923"><span + id="dx1-214061"></a><span +class="cmtt-10">,</span><span id="textcolor949"><span class="cmtt-10">\glsxtrhyphenrules</span></span><a - id="dx1-211062"></a> + id="dx1-214062"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> <</span><span id="textcolor924"><span +class="cmtt-10"> <</span><span id="textcolor950"><span class="cmtt-10">\glsxtrgeneralpuncrules</span></span><a - id="dx1-211063"></a><span -class="cmtt-10"><</span><span id="textcolor925"><span + id="dx1-214063"></a><span +class="cmtt-10"><</span><span id="textcolor951"><span class="cmtt-10">\glsxtrdigitrules</span></span><a - id="dx1-211064"></a> + id="dx1-214064"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span @@ -37418,13 +38952,13 @@ class="cmtt-10">]</span> </div> Unfortunately, as with <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-211065"></a></a>, this puts “Mach” into the “Mc” letter group. -<!--l. 18107--><p class="indent" > One way to get around this problem is to define a custom command to help identify genuine “Mc”/“Mac” + id="dx1-214065"></a></a>, this puts “Mach” into the “Mc” letter group. +<!--l. 18530--><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 +<span id="textcolor952"><span class="cmtt-10">@entry</span></span><a - id="dx1-211066"></a><span + id="dx1-214066"></a><span class="cmtt-10">{mcadam,</span> <br /><span class="cmtt-10"> </span><span @@ -37456,9 +38990,9 @@ class="cmtt-10"> McAdam}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor927"><span +<br /><span id="textcolor953"><span class="cmtt-10">@entry</span></span><a - id="dx1-211067"></a><span + id="dx1-214067"></a><span class="cmtt-10">{maclaurin,</span> <br /><span class="cmtt-10"> </span><span @@ -37497,9 +39031,9 @@ class="cmtt-10">}</span> <div class="obeylines-v"> -<span id="textcolor928"><span +<span id="textcolor954"><span class="cmtt-10">@entry</span></span><a - id="dx1-211068"></a><span + id="dx1-214068"></a><span class="cmtt-10">{mach,</span> <br /><span class="cmtt-10"> </span><span @@ -37532,102 +39066,102 @@ class="cmtt-10">}</span> </div> With LaTeX, this command should simply do its argument: - <div class="verbatim" id="verbatim-469"> + <pre class="verbatim" id="verbatim-476"> \newcommand{\Mac}[1]{#1} -</div> -<!--l. 18138--><p class="nopar" > However, when <a +</pre> +<!--l. 18561--><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 + id="dx1-214069"></a></a> works out the <span class="cmtt-10">sort</span><a - id="dx1-211070"></a> value, it needs to be defined with something unique that won’t + id="dx1-214070"></a> value, it needs to be defined with something unique that won’t happen to occur at the start of another term. For example: </p> - <div class="verbatim" id="verbatim-470"> + <pre class="verbatim" id="verbatim-477"> \providecommand{\Mac}[1]{MC} -</div> -<!--l. 18144--><p class="nopar" > (Remember that <span id="textcolor929"><span +</pre> +<!--l. 18567--><p class="nopar" > (Remember that <span id="textcolor955"><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 -<span id="textcolor930"><span + id="dx1-214071"></a> will strip spaces and punctuation so don’t include them unless you switch to +<span id="textcolor956"><span class="cmtt-10">break-at</span></span><span class="cmtt-10">=none</span><a - id="dx1-211072"></a>.) -</p><!--l. 18149--><p class="indent" > So add the first definition of <span + id="dx1-214072"></a>.) +</p><!--l. 18572--><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 + id="dx1-214073"></a> file and modify <span class="cmtt-10">entries.bib </span>so that it includes the second definition: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor931"><span +<span id="textcolor957"><span class="cmtt-10">@preamble</span></span><a - id="dx1-211074"></a><span + id="dx1-214074"></a><span 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. 18157--><p class="indent" > The custom sort rule needs to be modified: </p><div class="alltt"> +<!--l. 18580--><p class="indent" > The custom sort rule needs to be modified: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor932"><span +<span id="textcolor958"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-211075"></a><span -class="cmtt-10">[</span><span id="textcolor933"><span + id="dx1-214075"></a><span +class="cmtt-10">[</span><span id="textcolor959"><span class="cmtt-10">src</span></span><a - id="dx1-211076"></a><span + id="dx1-214076"></a><span class="cmtt-10">=entries,</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><strong><span id="textcolor934"><span +class="cmtt-10"> </span><strong><span id="textcolor960"><span class="cmtt-10">write-preamble</span></span><span class="cmtt-10">=false,</span></strong> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor935"><span +class="cmtt-10"> </span><span id="textcolor961"><span class="cmtt-10">sort</span></span><a - id="dx1-211077"></a><span + id="dx1-214077"></a><span class="cmtt-10">=custom,</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> </span><span id="textcolor936"><span +class="cmtt-10"> </span><span id="textcolor962"><span class="cmtt-10">sort-rule</span></span><a - id="dx1-211078"></a><span -class="cmtt-10">={</span><span id="textcolor937"><span + id="dx1-214078"></a><span +class="cmtt-10">={</span><span id="textcolor963"><span class="cmtt-10">\glsxtrcontrolrules</span></span><a - id="dx1-211079"></a> + id="dx1-214079"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> ;</span><span id="textcolor938"><span +class="cmtt-10"> ;</span><span id="textcolor964"><span class="cmtt-10">\glsxtrspacerules</span></span><a - id="dx1-211080"></a><span -class="cmtt-10">;</span><span id="textcolor939"><span + id="dx1-214080"></a><span +class="cmtt-10">;</span><span id="textcolor965"><span class="cmtt-10">\glsxtrnonprintablerules</span></span><a - id="dx1-211081"></a> + id="dx1-214081"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> ;</span><span id="textcolor940"><span +class="cmtt-10"> ;</span><span id="textcolor966"><span class="cmtt-10">\glsxtrcombiningdiacriticrules</span></span><a - id="dx1-211082"></a><span -class="cmtt-10">,</span><span id="textcolor941"><span + id="dx1-214082"></a><span +class="cmtt-10">,</span><span id="textcolor967"><span class="cmtt-10">\glsxtrhyphenrules</span></span><a - id="dx1-211083"></a> + id="dx1-214083"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span -class="cmtt-10"> <</span><span id="textcolor942"><span +class="cmtt-10"> <</span><span id="textcolor968"><span class="cmtt-10">\glsxtrgeneralpuncrules</span></span><a - id="dx1-211084"></a><span -class="cmtt-10"><</span><span id="textcolor943"><span + id="dx1-214084"></a><span +class="cmtt-10"><</span><span id="textcolor969"><span class="cmtt-10">\glsxtrdigitrules</span></span><a - id="dx1-211085"></a> + id="dx1-214085"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span @@ -37648,33 +39182,33 @@ 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. 18174--><p class="indent" > Other alternatives include moving <span id="textcolor944"><span +<!--l. 18597--><p class="indent" > Other alternatives include moving <span id="textcolor970"><span class="cmtt-10">@preamble</span></span><a - id="dx1-211086"></a> into a separate <span + id="dx1-214086"></a> into a separate <span class="cmtt-10">bib</span><a - id="dx1-211087"></a> file, so that you can choose + id="dx1-214087"></a> file, so that you can choose whether or not to include it. See the “Examples” chapter of the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-211088"></a></a> user manual for further + id="dx1-214088"></a></a> user manual for further examples. <a - id="x1-211089r30"></a> -</p><!--l. 18179--><p class="noindent" > + id="x1-214089r30"></a> +</p><!--l. 18602--><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. 18179--><p class="noindent" >This document illustrates how to use the <span +<!--l. 18602--><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 class="cmtt-10">xindy</span><a - id="dx1-212001"></a></a>. To create the document do: + id="dx1-215001"></a></a>. To create the document do: -</p><!--l. 18183--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18606--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex samplexdy2 <br />makeglossaries samplexdy2 <br />pdflatex samplexdy2 @@ -37683,8 +39217,8 @@ class="cmtt-10">xindy</span><a The explicit <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-212002"></a></a> call is: -</p><!--l. 18189--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-215002"></a></a> call is: +</p><!--l. 18612--><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> @@ -37692,77 +39226,77 @@ This example uses the <span class="cmtt-10">section </span>counter with <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-212003"></a></a>: + id="dx1-215003"></a></a>: </p> - <div class="verbatim" id="verbatim-471"> + <pre class="verbatim" id="verbatim-478"> \usepackage[xindy,counter=section]{glossaries} -</div> -<!--l. 18195--><p class="nopar" > The document employs an eccentric section numbering system for illustrative purposes. The section numbers +</pre> +<!--l. 18618--><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-472"> + <pre class="verbatim" id="verbatim-479"> \renewcommand*{\thesection}{[\thechapter]\arabic{section}} -</div> -<!--l. 18201--><p class="nopar" > Parts use Roman numerals: +</pre> +<!--l. 18624--><p class="nopar" > Parts use Roman numerals: </p> - <div class="verbatim" id="verbatim-473"> + <pre class="verbatim" id="verbatim-480"> \renewcommand*{\thepart}{\Roman{part}} -</div> -<!--l. 18205--><p class="nopar" > The section hyperlink name includes the part: +</pre> +<!--l. 18628--><p class="nopar" > The section hyperlink name includes the part: </p> - <div class="verbatim" id="verbatim-474"> + <pre class="verbatim" id="verbatim-481"> \renewcommand*{\theHsection}{\thepart.\thesection} -</div> -<!--l. 18209--><p class="nopar" > This custom numbering scheme needs to be identified in the <span +</pre> +<!--l. 18632--><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: + id="dx1-215004"></a> file: </p> - <div class="verbatim" id="verbatim-475"> + <pre class="verbatim" id="verbatim-482"> \GlsAddXdyLocation["roman-numbers-uppercase"]{section}{:sep "[" - <br />  "arabic-numbers" :sep "]" "arabic-numbers" - <br />} -</div> -<!--l. 18216--><p class="nopar" > If the part is 0 then <span +  "arabic-numbers" :sep "]" "arabic-numbers" +} +</pre> +<!--l. 18639--><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-476"> + <pre class="verbatim" id="verbatim-483"> \GlsAddXdyLocation{zero.section}{:sep "[" - <br />  "arabic-numbers" :sep "]" "arabic-numbers" - <br />} -</div> -<!--l. 18223--><p class="nopar" > Note that this will stop xindy giving a warning, but the location hyperlinks will be invalid if no <span +  "arabic-numbers" :sep "]" "arabic-numbers" +} +</pre> +<!--l. 18646--><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. 18227--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 18650--><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 + id="dx1-215005"></a></a></span>If you want to switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-212006"></a></a>, you first need to switch to <a + id="dx1-215006"></a></a>, you first need to switch to <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> but remember to use -<span id="textcolor945"><span +<span id="textcolor971"><span class="cmss-10">record</span></span><a - id="dx1-212007"></a> instead of <span + id="dx1-215007"></a> instead of <span class="cmss-10">xindy</span><a - id="dx1-212008"></a>: </p><div class="alltt"> + id="dx1-215008"></a>: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor946"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor972"><span class="cmtt-10">record</span></span></strong><span class="cmtt-10">,counter=section]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -37771,47 +39305,47 @@ class="cmtt-10">}</span> </div> Next remove the <span class="cmtt-10">\GlsAddXdyLocation </span>commands and convert the entry definitions to the <span class="cmtt-10">bib</span><a - id="dx1-212009"></a> format required + id="dx1-215009"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-212010"></a></a>: -<!--l. 18237--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-215010"></a></a>: +<!--l. 18660--><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> Now replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor947"><span +<span id="textcolor973"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-212011"></a><span -class="cmtt-10">[</span><span id="textcolor948"><span + id="dx1-215011"></a><span +class="cmtt-10">[</span><span id="textcolor974"><span class="cmtt-10">src</span></span><a - id="dx1-212012"></a><span + id="dx1-215012"></a><span class="cmtt-10">=entries]</span> </div> </div> and remove the <span class="cmtt-10">\newglossaryentry </span>commands. Finally, replace <span class="cmtt-10">\printglossaries </span>with -<span id="textcolor949"><span +<span id="textcolor975"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-212013"></a>. -<!--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"> + id="dx1-215013"></a>. +<!--l. 18670--><p class="indent" > The document build is: +</p><!--l. 18671--><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. 18254--><p class="indent" > With unusual numbering systems, it’s sometimes better to use <span id="textcolor950"><span +</p><!--l. 18677--><p class="indent" > With unusual numbering systems, it’s sometimes better to use <span id="textcolor976"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-212014"></a>: </p><div class="alltt"> + id="dx1-215014"></a>: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor951"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor977"><span class="cmtt-10">record</span></span><span class="cmtt-10">=nameref</span></strong><span class="cmtt-10">,counter=section]{</span><strong><span @@ -37824,9 +39358,9 @@ class="cmtt-10">}</span> the number appear instead you need to define: <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\newcommand*{</span><span id="textcolor952"><span +class="cmtt-10">\newcommand*{</span><span id="textcolor978"><span class="cmtt-10">\glsxtrsectionlocfmt</span></span><a - id="dx1-212015"></a><span + id="dx1-215015"></a><span class="cmtt-10">}[2]{#1}</span> </div> </div> (Make sure you have at least v1.42 of <a @@ -37835,44 +39369,45 @@ class="cmss-10">glossaries-extra</span></a>.) See also the earlier <a href="#ex:sampleSec"><span class="cmtt-10">sampleSec.tex</span></a>. <a - id="x1-212016r31"></a> -<!--l. 18267--><p class="noindent" > + id="x1-215016r31"></a> +<!--l. 18690--><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. 18267--><p class="noindent" >This document is very similar to <a +<!--l. 18690--><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 <span class="cmss-10">fmtcount</span><a - id="dx1-213001"></a> package to format the page numbers instead of the <span + id="dx1-216001"></a> package to format the page numbers instead of the <span class="cmtt-10">\tally </span>command from the earlier example. <a - id="x1-213002r32"></a> -</p><!--l. 18272--><p class="noindent" > + id="x1-216002r32"></a> +</p><!--l. 18695--><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. 18272--><p class="noindent" >This is another example that uses <a +<!--l. 18695--><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 + id="dx1-217001"></a></a>. Unlike <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-214002"></a></a>, <a + id="dx1-217002"></a></a>, <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-214003"></a></a> can cope with <a + id="dx1-217003"></a></a> can cope with <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. 18276--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-217004"></a>s</a>. This +document uses <a +href="#glo:UTF-8">UTF-8</a> encoding. To create the document do: +</p><!--l. 18699--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sampleutf8 <br />makeglossaries sampleutf8 <br />pdflatex sampleutf8 @@ -37881,8 +39416,8 @@ document uses UTF-8 encoding. To create the document do: 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. 18283--><p class="indent" > + id="dx1-217005"></a></a> call is (no line breaks): +</p><!--l. 18706--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />xindy -L @@ -37902,18 +39437,18 @@ sampleutf8.gls sampleutf8.glo <br /></pre><spacer type=vertical size=10> <br /></span> -</p><!--l. 18287--><p class="indent" > If you remove the <span +</p><!--l. 18710--><p class="indent" > If you remove the <span class="cmss-10">xindy</span><a - id="dx1-214006"></a> option from <span + id="dx1-217006"></a> option from <span class="cmtt-10">sampleutf8.tex </span>and do: -</p><!--l. 18289--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18712--><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. 18295--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18718--><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 @@ -37921,37 +39456,37 @@ or <br /></span> you will see that the entries that start with an <a href="#glo:exlatinchar">extended Latin character<a - id="dx1-214007"></a></a> now appear in the symbols group, and + id="dx1-217007"></a></a> now appear in the symbols group, and the word “manœuvre” is now after “manor” instead of before it. If you want to explicitly call <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-214008"></a></a> (no + id="dx1-217008"></a></a> (no line breaks): -</p><!--l. 18304--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18727--><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. 18308--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 18731--><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 + id="dx1-217009"></a></a></span>If you want to switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214010"></a></a>, you first need to switch to <a + id="dx1-217010"></a></a>, you first need to switch to <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> but replace <span class="cmss-10">xindy</span><a - id="dx1-214011"></a> with -<span id="textcolor953"><span + id="dx1-217011"></a> with +<span id="textcolor979"><span class="cmss-10">record</span></span><a - id="dx1-214012"></a>: </p><div class="alltt"> + id="dx1-217012"></a>: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor954"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor980"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor955"><span +class="cmtt-10">,</span><span id="textcolor981"><span class="cmtt-10">postdot</span></span><span -class="cmtt-10">,</span><span id="textcolor956"><span +class="cmtt-10">,</span><span id="textcolor982"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,style=listgroup]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -37959,24 +39494,24 @@ class="cmtt-10">}</span> </div> </div> Note that you don’t need the <span class="cmss-10">nonumberlist</span><a - id="dx1-214013"></a> option with <a + id="dx1-217013"></a> option with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214014"></a></a>. You can instruct <a + id="dx1-217014"></a></a>. You can instruct <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214015"></a></a> to + id="dx1-217015"></a></a> to 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 + id="dx1-217016"></a>s</a>, but in this case there won’t be any locations as there’s no actual indexing. -<!--l. 18320--><p class="indent" > The entries need to be converted to the <span +<!--l. 18743--><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 + id="dx1-217017"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214018"></a></a>: -</p><!--l. 18322--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-217018"></a></a>: +</p><!--l. 18745--><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> @@ -37992,77 +39527,77 @@ class="cmtt-10"> UTF-8</span> </div> </div> This is the encoding of the <span class="cmtt-10">bib</span><a - id="dx1-214019"></a> file. It doesn’t have to match the encoding of the <span + id="dx1-217019"></a> file. It doesn’t have to match the encoding of the <span class="cmtt-10">tex</span><a - id="dx1-214020"></a> file, but it’s generally + id="dx1-217020"></a> file, but it’s generally better to be consistent. When <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214021"></a></a> parses this file, it will look for this encoding line. (If the <span + id="dx1-217021"></a></a> parses this file, it will look for this encoding line. (If the <span class="cmtt-10">--texenc </span>and <span class="cmtt-10">--bibenc </span>switches aren’t used, <a href="#glo:convertgls2bib"><span class="cmtt-10">convertgls2bib</span><a - id="dx1-214022"></a></a> will assume your system’s default encoding. See the <a + id="dx1-217022"></a></a> will assume your system’s default encoding. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214023"></a></a> + id="dx1-217023"></a></a> manual for further details.) -<!--l. 18337--><p class="indent" > Next replace <span +<!--l. 18760--><p class="indent" > Next replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor957"><span +<span id="textcolor983"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-214024"></a><span -class="cmtt-10">[</span><span id="textcolor958"><span + id="dx1-217024"></a><span +class="cmtt-10">[</span><span id="textcolor984"><span class="cmtt-10">src</span></span><a - id="dx1-214025"></a><span -class="cmtt-10">=entries,</span><span id="textcolor959"><span + id="dx1-217025"></a><span +class="cmtt-10">=entries,</span><span id="textcolor985"><span class="cmtt-10">selection</span></span><a - id="dx1-214026"></a><span + id="dx1-217026"></a><span class="cmtt-10">=</span><strong><span class="cmtt-10">all</span></strong><span class="cmtt-10">]</span> </div> </div> and remove all the <span class="cmtt-10">\newglossaryentry </span>commands. -<!--l. 18343--><p class="indent" > Iterative commands like <span +<!--l. 18766--><p class="indent" > Iterative commands like <span class="cmtt-10">\glsaddall</span><a - id="dx1-214027"></a> don’t work with <a + id="dx1-217027"></a> don’t work with <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214028"></a></a>. Instead, you can select all entries using the -<span id="textcolor960"><span + id="dx1-217028"></a></a>. Instead, you can select all entries using the +<span id="textcolor986"><span class="cmtt-10">selection</span></span><span class="cmtt-10">=all</span><a - id="dx1-214029"></a> option. This is actually better than <span + id="dx1-217029"></a> option. This is actually better than <span class="cmtt-10">\glsaddall</span>, which enforces the selection of all entries by indexing each entry. As a result, with <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-214030"></a></a> and <a + id="dx1-217030"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-214031"></a></a> (and <a + id="dx1-217031"></a></a> (and <a href="#option1">Option 1</a>), every entry will have the same location (which is the location of the <span -class="cmtt-10">\glsaddall </span>command, in this case page 1). With <span id="textcolor961"><span +class="cmtt-10">\glsaddall </span>command, in this case page 1). With <span id="textcolor987"><span class="cmtt-10">selection</span></span><span class="cmtt-10">=all</span><a - id="dx1-214032"></a>, + id="dx1-217032"></a>, <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214033"></a></a> will automatically selection all entries even if they don’t have any records (indexing information) so in + id="dx1-217033"></a></a> will automatically selection all entries even if they don’t have any records (indexing information) so in this case there are no <a href="#glo:numberlist">number list<a - id="dx1-214034"></a>s</a>. -</p><!--l. 18355--><p class="indent" > Finally, replace <span -class="cmtt-10">\printglossaries </span>with <span id="textcolor962"><span + id="dx1-217034"></a>s</a>. +</p><!--l. 18778--><p class="indent" > Finally, replace <span +class="cmtt-10">\printglossaries </span>with <span id="textcolor988"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-214035"></a>. The build process is now: -</p><!--l. 18357--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-217035"></a>. The build process is now: +</p><!--l. 18780--><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 @@ -38071,111 +39606,111 @@ class="cmtt-10">\printunsrtglossaries</span></span><a <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214036"></a></a> picks up the encoding of the <span + id="dx1-217036"></a></a> picks up the encoding of the <span class="cmtt-10">tex</span><a - id="dx1-214037"></a> file from the <span + id="dx1-217037"></a> file from the <span class="cmtt-10">aux</span><a - id="dx1-214038"></a> file: </p><div class="alltt"> + id="dx1-217038"></a> file: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor963"><span +<span id="textcolor989"><span class="cmtt-10">\glsxtr@texencoding</span></span><a - id="dx1-214039"></a><span + id="dx1-217039"></a><span class="cmtt-10">{utf8}</span> </div> </div> If you experience any encoding issues, check the <span class="cmtt-10">aux</span><a - id="dx1-214040"></a> file for this command and check the <span + id="dx1-217040"></a> file for this command and check the <span class="cmtt-10">bib</span><a - id="dx1-214041"></a> file for the + id="dx1-217041"></a> file for the encoding comment line. Also check <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214042"></a>’s</a> <span + id="dx1-217042"></a>’s</a> <span class="cmtt-10">glg</span><a - id="dx1-214043"></a> transcript file for encoding messages, which should look + id="dx1-217043"></a> transcript file for encoding messages, which should look like: - <div class="verbatim" id="verbatim-477"> + <pre class="verbatim" id="verbatim-484"> TeX character encoding: UTF-8 -</div> -<!--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 +</pre> +<!--l. 18796--><p class="nopar" > +</p><!--l. 18798--><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 + id="dx1-217044"></a> file when the <span class="cmss-10">record</span><a - id="dx1-214045"></a> option is used. In + id="dx1-217045"></a> option is used. In this case, no language package has been used, so <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-214046"></a></a> will fallback on the system’s default locale. If no sort + id="dx1-217046"></a></a> will fallback on the system’s default locale. If no sort method is set, the entries will be sorted according to the document language, if set, or the default -locale. You can specify a specific locale using the <span id="textcolor964"><span +locale. You can specify a specific locale using the <span id="textcolor990"><span class="cmtt-10">sort</span></span><a - id="dx1-214047"></a> key with a locale tag identifier. For example: + id="dx1-217047"></a> key with a locale tag identifier. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor965"><span +<span id="textcolor991"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-214048"></a><span -class="cmtt-10">[</span><span id="textcolor966"><span + id="dx1-217048"></a><span +class="cmtt-10">[</span><span id="textcolor992"><span class="cmtt-10">src</span></span><a - id="dx1-214049"></a><span -class="cmtt-10">=entries,</span><span id="textcolor967"><span + id="dx1-217049"></a><span +class="cmtt-10">=entries,</span><span id="textcolor993"><span class="cmtt-10">selection</span></span><a - id="dx1-214050"></a><span + id="dx1-217050"></a><span class="cmtt-10">=</span><strong><span class="cmtt-10">all</span></strong><span -class="cmtt-10">,</span><strong><span id="textcolor968"><span +class="cmtt-10">,</span><strong><span id="textcolor994"><span class="cmtt-10">sort</span></span><span class="cmtt-10">=de-CH-1996</span></strong><span class="cmtt-10">]</span> </div> </div> (Swiss German new orthography) or: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor969"><span +<span id="textcolor995"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-214051"></a><span -class="cmtt-10">[</span><span id="textcolor970"><span + id="dx1-217051"></a><span +class="cmtt-10">[</span><span id="textcolor996"><span class="cmtt-10">src</span></span><a - id="dx1-214052"></a><span -class="cmtt-10">=entries,</span><span id="textcolor971"><span + id="dx1-217052"></a><span +class="cmtt-10">=entries,</span><span id="textcolor997"><span class="cmtt-10">selection</span></span><a - id="dx1-214053"></a><span + id="dx1-217053"></a><span class="cmtt-10">=</span><strong><span class="cmtt-10">all</span></strong><span -class="cmtt-10">,</span><strong><span id="textcolor972"><span +class="cmtt-10">,</span><strong><span id="textcolor998"><span class="cmtt-10">sort</span></span><span class="cmtt-10">=is</span></strong><span class="cmtt-10">]</span> </div> </div> (Icelandic). -<!--l. 18391--><p class="noindent" > +<!--l. 18814--><p class="noindent" > </p> -<!--l. 18391--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.10 </span> <a +<!--l. 18814--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.10 </span> <a id="sec:samplesnoidx"></a>No Indexing Application (Option 1)</h3> <a - id="x1-215001r33"></a> -<!--l. 18394--><p class="noindent" > + id="x1-218001r33"></a> +<!--l. 18817--><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. 18394--><p class="noindent" >This document illustrates how to use the <span +<!--l. 18817--><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. 18397--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18820--><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> <br /></span> Note the need to group the accent command that occurs at the start of the <span class="cmtt-10">name</span><a - id="dx1-216001"></a>: </p><div class="alltt"> + id="dx1-219001"></a>: </p><div class="alltt"> <div class="obeylines-v"> @@ -38185,7 +39720,7 @@ class="cmtt-10">\newglossaryentry{elite}{%</span> class="cmtt-10"> </span><span class="cmtt-10"> name={</span><strong><span class="cmtt-10">{\'</span><a - id="dx1-216002"></a><span + id="dx1-219002"></a><span class="cmtt-10">e}</span></strong><span class="cmtt-10">lite},</span> <br /><span @@ -38199,9 +39734,9 @@ class="cmtt-10">}</span> </div> </div> This is necessary to allow the term to work with <span class="cmtt-10">\Gls</span><a - id="dx1-216003"></a>. Notice also how the <a + id="dx1-219003"></a>. Notice also how the <a href="#glo:numberlist">number list<a - id="dx1-216004"></a>s</a> can’t be compacted + id="dx1-219004"></a>s</a> can’t be compacted into ranges. For example, the list “1, 2, 3” would be converted to “1–3” with a proper indexing application (Options <a href="#option2">2</a> or <a @@ -38209,22 +39744,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. 18415--><p class="indent" > The larger the list of entries, the longer the document build time. This method is very inefficient for large +<!--l. 18838--><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. 18419--><p class="noindent" > + id="x1-219005r34"></a> +</p><!--l. 18842--><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. 18419--><p class="noindent" >As the previous example, except that it uses the <span +<!--l. 18842--><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 + id="dx1-220001"></a> package. To create the complete document, you need to do: -</p><!--l. 18422--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18845--><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> @@ -38235,22 +39770,22 @@ href="#glo:nonlatinalph">non-Latin alphabets</a>. Use Options <a href="#option3">3</a> or <a href="#option4">4</a> instead. -</p><!--l. 18429--><p class="noindent" > +</p><!--l. 18852--><p class="noindent" > </p> -<!--l. 18429--><p class="noindent" ><a -href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">19.11 </span> <a +<!--l. 18852--><p class="noindent" ><a +href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">18.11 </span> <a id="sec:samplesother"></a>Other</h3> <a - id="x1-218001r35"></a> -<!--l. 18432--><p class="noindent" > + id="x1-221001r35"></a> +<!--l. 18855--><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. 18432--><p class="noindent" >This document illustrates a four column glossary where the entries have a symbol in addition to the name and +<!--l. 18855--><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. 18436--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18859--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> <br />pdflatex sample4col <br />makeglossaries sample4col <br />pdflatex sample4col @@ -38259,7 +39794,7 @@ description. To create the complete document, you need to do: <br /></pre><spacer type=vertical size=10> <br /></span> or -</p><!--l. 18442--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18865--><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 @@ -38268,28 +39803,28 @@ or The vertical gap between entries is the gap created at the start of each group. This can be suppressed using the <span class="cmss-10">nogroupskip</span><a - id="dx1-219001"></a> package option. (If you switch to <a + id="dx1-222001"></a> package option. (If you switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-219002"></a></a>, simply omit the <span + id="dx1-222002"></a></a>, simply omit the <span class="cmtt-10">--group </span>command line option.) -</p><!--l. 18452--><p class="indent" > This example uses the <span +</p><!--l. 18875--><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 + id="dx1-222003"></a>. This style doesn’t allow multi-line descriptions. You may prefer to use <span class="cmss-10">altlong4colheaderborder</span><a - id="dx1-219004"></a> with long descriptions. However, in either case a style that uses <span + id="dx1-222004"></a> with long descriptions. However, in either case a style that uses <span class="cmss-10">booktabs</span><a - id="dx1-219005"></a> is + id="dx1-222005"></a> is preferable. For example, <span class="cmss-10">long4col-booktabs</span><a - id="dx1-219006"></a> or <span + id="dx1-222006"></a> or <span class="cmss-10">altlongragged4col-booktabs</span><a - id="dx1-219007"></a>. Note that this requires + id="dx1-222007"></a>. Note that this requires <span class="cmss-10">glossary-longbooktabs</span><a - id="dx1-219008"></a>, which needs to be explicitly loaded. The style can only be set once this package has been + id="dx1-222008"></a>, which needs to be explicitly loaded. The style can only be set once this package has been loaded: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -38300,17 +39835,17 @@ class="cmtt-10">\usepackage{glossary-longbooktabs}</span> class="cmtt-10">\setglossarystyle{altlongragged4col-booktabs}</span> </div> </div> -<!--l. 18466--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 18889--><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 -class="cmss-10">glossaries-extra</span></a> package provides a more compact way of doing this with the <span id="textcolor973"><span +class="cmss-10">glossaries-extra</span></a> package provides a more compact way of doing this with the <span id="textcolor999"><span class="cmss-10">stylemods</span></span><a - id="dx1-219009"></a> + id="dx1-222009"></a> option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[style=altlongragged4col-booktabs,</span><span id="textcolor974"><span +class="cmtt-10">\usepackage[style=altlongragged4col-booktabs,</span><span id="textcolor1000"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">=</span><strong><span class="cmtt-10">longbooktabs</span></strong><span @@ -38322,17 +39857,17 @@ class="cmtt-10">}</span> </div> </div> The <a href="#glo:glossaries-extra"><span -class="cmss-10">glossaries-extra</span></a> package provides additional styles, including more “long” styles with the <span id="textcolor975"><span +class="cmss-10">glossaries-extra</span></a> package provides additional styles, including more “long” styles with the <span id="textcolor1001"><span class="cmss-10">glossary-longextra</span></span><a - id="dx1-219010"></a> -package. For example, the <span id="textcolor976"><span + id="dx1-222010"></a> +package. For example, the <span id="textcolor1002"><span class="cmss-10">long-name-desc-sym-loc</span></span><a - id="dx1-219011"></a> style: <div class="alltt"> + id="dx1-222011"></a> style: <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[style=</span><strong><span id="textcolor977"><span +class="cmtt-10">\usepackage[style=</span><strong><span id="textcolor1003"><span class="cmtt-10">long-name-desc-sym-loc</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor978"><span +class="cmtt-10">,</span><span id="textcolor1004"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">=</span><strong><span class="cmtt-10">longextra</span></strong><span @@ -38340,21 +39875,21 @@ class="cmtt-10">]</span> <br /><span class="cmtt-10">{glossaries-extra}</span> </div> -</div> If you use the <span id="textcolor979"><span +</div> If you use the <span id="textcolor1005"><span class="cmss-10">stylemods</span></span><a - id="dx1-219012"></a> option with an argument, you may prefer to use it with <span + id="dx1-222012"></a> option with an argument, you may prefer to use it with <span class="cmss-10">nostyles</span><a - id="dx1-219013"></a> to prevent unwanted + id="dx1-222013"></a> to prevent unwanted styles from being automatically loaded. For example: <div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[style=</span><span id="textcolor980"><span +class="cmtt-10">\usepackage[style=</span><span id="textcolor1006"><span class="cmtt-10">long-name-desc-sym-loc</span></span><span -class="cmtt-10">,</span><strong><span id="textcolor981"><span +class="cmtt-10">,</span><strong><span id="textcolor1007"><span class="cmtt-10">nostyles</span></span><span -class="cmtt-10">,</span></strong><span id="textcolor982"><span +class="cmtt-10">,</span></strong><span id="textcolor1008"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">=longextra]</span> <br /><span @@ -38363,18 +39898,18 @@ class="cmtt-10">{glossaries-extra}</span> </div> See also the <a href="https://www.dickimaw-books.com/gallery/glossaries-styles/" >gallery of predefined styles</a>. <a - id="x1-219014r36"></a> -<!--l. 18491--><p class="noindent" > + id="x1-222014r36"></a> +<!--l. 18914--><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. 18491--><p class="noindent" >This document illustrates how to reference the <a +<!--l. 18914--><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 + id="dx1-223001"></a></a> in the document text. This requires an additional LaTeX run: -</p><!--l. 18494--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18917--><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 @@ -38383,39 +39918,39 @@ LaTeX run: <br /></span> This uses the <span class="cmss-10">savenumberlist</span><a - id="dx1-220002"></a> package option, which enables <span + id="dx1-223002"></a> package option, which enables <span class="cmtt-10">\glsentrynumberlist</span><a - id="dx1-220003"></a> and <span + id="dx1-223003"></a> and <span class="cmtt-10">\glsdisplaynumberlist</span><a - id="dx1-220004"></a> + id="dx1-223004"></a> (with limitations). The location counter is set to <span class="cmtt-10">chapter</span>, so the <a href="#glo:numberlist">number list<a - id="dx1-220005"></a></a> refers to the chapter + id="dx1-223005"></a></a> refers to the chapter numbers. </p> - <div class="verbatim" id="verbatim-478"> + <pre class="verbatim" id="verbatim-485"> \usepackage[savenumberlist,counter=chapter]{glossaries} -</div> -<!--l. 18507--><p class="nopar" > The <a +</pre> +<!--l. 18930--><p class="nopar" > The <a href="#glo:numberlist">number list<a - id="dx1-220006"></a></a> can’t be obtained until <a + id="dx1-223006"></a></a> can’t be obtained until <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-220007"></a></a> (or <a + id="dx1-223007"></a></a> (or <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-220008"></a></a>) has created the glossary file. The <a + id="dx1-223008"></a></a>) has created the glossary file. The <a href="#glo:numberlist">number list<a - id="dx1-220009"></a></a> is + id="dx1-223009"></a></a> is 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 + id="dx1-223010"></a> file so that it’s available on the next LaTeX run. -</p><!--l. 18514--><p class="indent" > This document contains both commands: </p><div class="alltt"> +</p><!--l. 18937--><p class="indent" > This document contains both commands: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">This</span><span @@ -38430,68 +39965,68 @@ class="cmtt-10"> discussed</span><span class="cmtt-10"> in</span><span class="cmtt-10"> chapters~</span><strong><span class="cmtt-10">\glsdisplaynumberlist</span><a - id="dx1-220011"></a></strong><span + id="dx1-223011"></a></strong><span class="cmtt-10">{sample}</span> <br /><span class="cmtt-10">(or</span><span class="cmtt-10"> </span><strong><span class="cmtt-10">\glsentrynumberlist</span><a - id="dx1-220012"></a></strong><span + id="dx1-223012"></a></strong><span class="cmtt-10">{sample}).</span> </div> </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. 18523--><p class="indent" > Note that you can’t use <span + id="dx1-223013"></a>, the first list shows as “1–3, 5 & 6” and the second list shows as “1–3, 5, 6”. +<!--l. 18946--><p class="indent" > Note that you can’t use <span class="cmtt-10">\glsdisplaynumberlist</span><a - id="dx1-220014"></a> with <span + id="dx1-223014"></a> with <span class="cmss-10">hyperref</span><a - id="dx1-220015"></a> and Options <a + id="dx1-223015"></a> and Options <a href="#option2">2</a> or <a href="#option3">3</a>. If you do, you will get the warning: </p> - <div class="verbatim" id="verbatim-479"> + <pre class="verbatim" id="verbatim-486"> Package glossaries Warning: \glsdisplaynumberlist doesn't work with - <br />hyperref. - <br />Using \glsentrynumberlist instead -</div> -<!--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 +hyperref. +Using \glsentrynumberlist instead +</pre> +<!--l. 18952--><p class="nopar" > Now both lists show as “1–3, 5, 6”. +</p><!--l. 18955--><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. 18535--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 18958--><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> <br /></span> Now <span class="cmtt-10">\glsdisplaynumberlist</span><a - id="dx1-220016"></a> works with <span + id="dx1-223016"></a> works with <span class="cmss-10">hyperref</span><a - id="dx1-220017"></a>, however there are no ranges, so the first list shows as “1, 2, + id="dx1-223017"></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. 18543--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a +</p><!--l. 18966--><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 + id="dx1-223018"></a></a></span>If you want to switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-220019"></a></a>, you first need to switch to <a + id="dx1-223019"></a></a>, you first need to switch to <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> (at least v1.42) but remember to include the <span class="cmss-10">record</span><a - id="dx1-220020"></a> option: </p><div class="alltt"> + id="dx1-223020"></a> option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor983"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor1009"><span class="cmtt-10">record</span></span></strong><span class="cmtt-10">,counter=chapter]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -38499,35 +40034,35 @@ class="cmtt-10">}</span> </div> </div> Note that the <span class="cmss-10">savenumberlist</span><a - id="dx1-220021"></a> option is no longer required. Next convert the entry to the <span + id="dx1-223021"></a> option is no longer required. Next convert the entry to the <span class="cmtt-10">bib</span><a - id="dx1-220022"></a> format required by + id="dx1-223022"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-220023"></a></a>: -<!--l. 18553--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-223023"></a></a>: +<!--l. 18976--><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> Replace <span class="cmtt-10">\makeglossaries </span>with: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor984"><span +<span id="textcolor1010"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-220024"></a><span -class="cmtt-10">[</span><span id="textcolor985"><span + id="dx1-223024"></a><span +class="cmtt-10">[</span><span id="textcolor1011"><span class="cmtt-10">src</span></span><a - id="dx1-220025"></a><span + id="dx1-223025"></a><span class="cmtt-10">=entries.bib]</span> </div> </div> and remove the <span class="cmtt-10">\newglossaryentry </span>command from the document preamble. Finally, replace <span -class="cmtt-10">\printglossaries </span>with <span id="textcolor986"><span +class="cmtt-10">\printglossaries </span>with <span id="textcolor1012"><span class="cmtt-10">\printunsrtglossaries</span></span><a - id="dx1-220026"></a>. The build process is now: -<!--l. 18563--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-223026"></a>. The build process is now: +<!--l. 18986--><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 @@ -38538,95 +40073,95 @@ You can also use: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor987"><span +<span id="textcolor1013"><span class="cmtt-10">\glsxtrfieldformatlist</span></span><a - id="dx1-220027"></a><span + id="dx1-223027"></a><span class="cmtt-10">{sample}{loclist}</span> </div> </div> which will show the complete list without ranges “1, 2, 3, 5 & 6”. -<!--l. 18577--><p class="indent" > This method works much better than using the <span +<!--l. 19000--><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 + id="dx1-223028"></a> option because <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-220029"></a></a> saves the formatted + id="dx1-223029"></a></a> saves the formatted <a href="#glo:numberlist">number list<a - id="dx1-220030"></a></a> in the <span id="textcolor988"><span + id="dx1-223030"></a></a> in the <span id="textcolor1014"><span class="cmtt-10">location</span></span><a - id="dx1-220031"></a> field (which is an internal field provided by <a + id="dx1-223031"></a> field (which is an internal field provided by <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> for the benefit of <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-220032"></a></a>) and the unformatted <a + id="dx1-223032"></a></a>) and the unformatted <a href="#glo:numberlist">number list<a - id="dx1-220033"></a></a> in the <span + id="dx1-223033"></a></a> in the <span class="cmtt-10">loclist</span><a - id="dx1-220034"></a> internal field (which is also used by + id="dx1-223034"></a> internal field (which is also used by <a href="#option1">Option 1</a>). -</p><!--l. 18584--><p class="indent" > With Options <a +</p><!--l. 19007--><p class="indent" > With Options <a href="#option2">2</a> and <a href="#option3">3</a>, both <a href="#glo:makeindex"><span class="cmtt-10">makeindex</span><a - id="dx1-220035"></a></a> and <a + id="dx1-223035"></a></a> and <a href="#glo:xindy"><span class="cmtt-10">xindy</span><a - id="dx1-220036"></a></a> simply create a file containing the commands to typeset + id="dx1-223036"></a></a> simply create a file containing the commands to typeset 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. 18589--><p class="indent" > <a +</p><!--l. 19012--><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 + id="dx1-223037"></a></a>, on the other hand, doesn’t write a file containing the glossary. It writes a file containing the entry definitions and uses internal fields to save the indexing information. The glossary is then displayed with -<span id="textcolor989"><span +<span id="textcolor1015"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-220038"></a>, which simply iterates over all defined entries and fetches the required information from + id="dx1-223038"></a>, which simply iterates over all defined entries and fetches the required information from those internal fields. -</p><!--l. 18596--><p class="indent" > The <span +</p><!--l. 19019--><p class="indent" > The <span class="cmtt-10">\glsdisplaynumberlist</span><a - id="dx1-220039"></a> and <span + id="dx1-223039"></a> and <span class="cmtt-10">\glsentrynumberlist</span><a - id="dx1-220040"></a> commands are redefined by <span + id="dx1-223040"></a> commands are redefined by <span class="cmss-10">glossaries-extra-bib2gls</span><a - id="dx1-220041"></a> -to simply access the <span id="textcolor990"><span + id="dx1-223041"></a> +to simply access the <span id="textcolor1016"><span class="cmtt-10">location</span></span><a - id="dx1-220042"></a> field. However, if you want a complete list without ranges you can use: + id="dx1-223042"></a> field. However, if you want a complete list without ranges you can use: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor991"><span +<span id="textcolor1017"><span class="cmtt-10">\glsxtrfieldformatlist</span></span><a - id="dx1-220043"></a><span + id="dx1-223043"></a><span class="cmtt-10">{sample}{loclist}</span> </div> </div> In this example, this produces “1, 2, 3, 5 & 6”. -<!--l. 18605--><p class="indent" > Note the difference if you use the <span id="textcolor992"><span +<!--l. 19028--><p class="indent" > Note the difference if you use the <span id="textcolor1018"><span class="cmss-10">record</span><span class="cmtt-10">=</span><span class="cmss-10">nameref</span></span><a - id="dx1-220044"></a> package option instead of just <span id="textcolor993"><span + id="dx1-223044"></a> package option instead of just <span id="textcolor1019"><span class="cmss-10">record</span></span><a - id="dx1-220045"></a>. + id="dx1-223045"></a>. <a - id="x1-220046r37"></a> -</p><!--l. 18608--><p class="noindent" > + id="x1-223046r37"></a> +</p><!--l. 19031--><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. 18608--><p class="noindent" >This document illustrates how to selectively enable and disable entry hyperlinks in <span +<!--l. 19031--><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 + id="dx1-224001"></a>. The document build is: -</p><!--l. 18611--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 19034--><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 @@ -38636,7 +40171,7 @@ This disables the hyperlinks for the main glossary with: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\GlsDeclareNoHyperList</span><a - id="dx1-221002"></a><span + id="dx1-224002"></a><span class="cmtt-10">{main}</span> @@ -38645,9 +40180,9 @@ class="cmtt-10">{main}</span> class="cmtt-10">\glsentryfmt </span>so that it adds a hyperlink if not in maths mode and the hyperlinks haven’t been forced off (with the <span class="cmtt-10">hyper</span><a - id="dx1-221003"></a><span + id="dx1-224003"></a><span class="cmtt-10">=false </span>key). -<!--l. 18624--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 19047--><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 @@ -38663,9 +40198,9 @@ class="cmtt-10">}</span> class="cmtt-10">\makeglossaries</span> <br /> <br /><span -class="cmtt-10">\renewcommand{</span><strong><span id="textcolor994"><span +class="cmtt-10">\renewcommand{</span><strong><span id="textcolor1020"><span class="cmtt-10">\glslinkpresetkeys</span></span><a - id="dx1-221004"></a></strong><span + id="dx1-224004"></a></strong><span class="cmtt-10">}{%</span> <br /><span class="cmtt-10"> \ifmmode</span><span @@ -38680,19 +40215,19 @@ class="cmtt-10"> definition</span> </div> </div> <a - id="x1-221005r38"></a> -<!--l. 18640--><p class="noindent" > + id="x1-224005r38"></a> +<!--l. 19063--><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. 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. +<!--l. 19063--><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 + id="dx1-225001"></a> package to typeset units.) The document build is: -</p><!--l. 18644--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 19067--><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 @@ -38700,7 +40235,7 @@ is: <br /></span> This redefines <span class="cmtt-10">\glsentryfmt</span><a - id="dx1-222002"></a> to add the symbol on <a + id="dx1-225002"></a> to add the symbol on <a href="#glo:firstuse">first use</a>: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -38708,15 +40243,15 @@ class="cmtt-10">\renewcommand*{\glsentryfmt}{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \glsgenentryfmt</span><a - id="dx1-222003"></a> + id="dx1-225003"></a> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \ifglsused</span><a - id="dx1-222004"></a><span + id="dx1-225004"></a><span class="cmtt-10">{\glslabel}{}{\space</span><span class="cmtt-10"> (</span><strong><span class="cmtt-10">\glsentrysymbol</span><a - id="dx1-222005"></a></strong><span + id="dx1-225005"></a></strong><span class="cmtt-10">{\glslabel})}%</span> <br /><span class="cmtt-10">}</span> @@ -38726,8 +40261,8 @@ class="cmtt-10">\glsentrysymbol </span><span 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. 18660--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a + id="dx1-225006"></a></a>). +<!--l. 19083--><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 @@ -38737,7 +40272,7 @@ post-link hook instead: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><span id="textcolor995"><span +class="cmtt-10">\usepackage[</span><span id="textcolor1021"><span class="cmtt-10">stylemods</span></span><span class="cmtt-10">,style=tree]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -38746,19 +40281,19 @@ class="cmtt-10">}</span> <br /><span class="cmtt-10">\makeglossaries</span> <br /> -<br /><span id="textcolor996"><span +<br /><span id="textcolor1022"><span class="cmtt-10">\glsdefpostlink</span></span><a - id="dx1-222007"></a><span + id="dx1-225007"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">unit</span></strong><span -class="cmtt-10">}{</span><span id="textcolor997"><span +class="cmtt-10">}{</span><span id="textcolor1023"><span class="cmtt-10">\glsxtrpostlinkAddSymbolOnFirstUse</span></span><a - id="dx1-222008"></a><span + id="dx1-225008"></a><span class="cmtt-10">}</span> <br /> <br /><span class="cmtt-10">\newglossaryentry{distance}{</span> -<br /><span id="textcolor998"><span +<br /><span id="textcolor1024"><span class="cmtt-10">category</span></span><span class="cmtt-10">={</span><strong><span class="cmtt-10">unit</span></strong><span @@ -38776,18 +40311,18 @@ class="cmtt-10">symbol={km}}</span> </div> </div> Note that in this case the symbol is now outside of the hyperlink. <a - id="x1-222009r39"></a> -<!--l. 18678--><p class="noindent" > + id="x1-225009r39"></a> +<!--l. 19101--><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. 18678--><p class="noindent" >This document illustrates the use of the <span +<!--l. 19101--><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 + id="dx1-226001"></a> package. An additional run is required to ensure the table of contents is up-to-date: -</p><!--l. 18681--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 19104--><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 @@ -38798,7 +40333,7 @@ Remember that the default separator between the prefix and <span class="cmtt-10">\gls </span>(or one of its variants) is empty, so if a space is required it must be inserted at the end of the prefix. However, the <span class="cmss-10">xkeyval</span><a - id="dx1-223002"></a> package (which is used to parse the + id="dx1-226002"></a> package (which is used to parse the ⟨<span class="cmti-10">key</span>⟩<span class="cmtt-10">=</span>⟨<span @@ -38844,19 +40379,19 @@ class="cmtt-10">\space</span></strong><span class="cmtt-10">}}</span> </div> </div> -<!--l. 18707--><p class="indent" > <br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a +<!--l. 19130--><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 class="cmss-10">glossaries-extra</span></a>, then (as from v1.42) you can use -the <span id="textcolor999"><span +the <span id="textcolor1025"><span class="cmss-10">prefix</span></span><a - id="dx1-223003"></a> option: </p><div class="alltt"> + id="dx1-226003"></a> option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor1000"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor1026"><span class="cmtt-10">prefix</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor1001"><span +class="cmtt-10">,</span><span id="textcolor1027"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">,acronym]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -38864,59 +40399,59 @@ class="cmtt-10">}</span> </div> </div> (Alternatively load <span class="cmss-10">glossaries-prefix</span><a - id="dx1-223004"></a> after <a + id="dx1-226004"></a> after <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>.) The rest of the document is the same as for the base <span 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. 18718--><p class="indent" > <span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a + id="dx1-226005"></a></a>. +<!--l. 19141--><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 + id="dx1-226006"></a></a></span>If you want to switch to <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-223007"></a></a>, first switch to <a + id="dx1-226007"></a></a>, first switch to <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> (as above) but make sure you -include the <span id="textcolor1002"><span +include the <span id="textcolor1028"><span class="cmss-10">record</span></span><a - id="dx1-223008"></a> package option: </p><div class="alltt"> + id="dx1-226008"></a> package option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><strong><span id="textcolor1003"><span +class="cmtt-10">\usepackage[</span><strong><span id="textcolor1029"><span class="cmtt-10">record</span></span></strong><span -class="cmtt-10">,</span><span id="textcolor1004"><span +class="cmtt-10">,</span><span id="textcolor1030"><span class="cmtt-10">prefix</span></span><span -class="cmtt-10">,</span><span id="textcolor1005"><span +class="cmtt-10">,</span><span id="textcolor1031"><span class="cmtt-10">postdot</span></span><span class="cmtt-10">,acronym]{glossaries-extra}</span> </div> </div> Next convert the entries into the <span class="cmtt-10">bib</span><a - id="dx1-223009"></a> format required by <a + id="dx1-226009"></a> format required by <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-223010"></a></a>: -<!--l. 18727--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-226010"></a></a>: +<!--l. 19150--><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> Replace <span class="cmtt-10">\makeglossaries </span>with </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor1006"><span +<span id="textcolor1032"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-223011"></a><span + id="dx1-226011"></a><span class="cmtt-10">[acronym]{long-short}</span> -<br /><span id="textcolor1007"><span +<br /><span id="textcolor1033"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-223012"></a><span -class="cmtt-10">[</span><span id="textcolor1008"><span + id="dx1-226012"></a><span +class="cmtt-10">[</span><span id="textcolor1034"><span class="cmtt-10">src</span></span><a - id="dx1-223013"></a><span + id="dx1-226013"></a><span class="cmtt-10">=entries]</span> </div> </div> remove the entry definitions from the preamble, and replace <div class="alltt"> @@ -38928,39 +40463,39 @@ class="cmtt-10">\printacronyms</span> </div> </div> with <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor1009"><span +<span id="textcolor1035"><span class="cmtt-10">\printunsrtglossary</span></span><a - id="dx1-223014"></a><span + id="dx1-226014"></a><span class="cmtt-10">[style=plist]</span> -<br /><span id="textcolor1010"><span +<br /><span id="textcolor1036"><span class="cmtt-10">\printunsrtacronyms</span></span><a - id="dx1-223015"></a> + id="dx1-226015"></a> </div> </div> The document build is now: -<!--l. 18746--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +<!--l. 19169--><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. 18752--><p class="indent" > With <a +</p><!--l. 19175--><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 + id="dx1-226016"></a></a> v2.0+, you don’t need to manually insert the spaces at the end of the prefixes. Instead you can instruct <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-223017"></a></a> to insert them. To try this out, remove the trailing <span class="obeylines-h"><span class="verb"><span + id="dx1-226017"></a></a> to insert them. To try this out, remove the trailing <span class="obeylines-h"><span class="verb"><span class="cmtt-10">~</span></span></span> and <span class="cmtt-10">\space </span>from the <span class="cmtt-10">entries.bib</span> file: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor1011"><span +<span id="textcolor1037"><span class="cmtt-10">@entry</span></span><a - id="dx1-223018"></a><span + id="dx1-226018"></a><span class="cmtt-10">{sample,</span> <br /><span class="cmtt-10"> </span><span @@ -38986,9 +40521,9 @@ class="cmtt-10"> {the}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor1012"><span +<br /><span id="textcolor1038"><span class="cmtt-10">@entry</span></span><a - id="dx1-223019"></a><span + id="dx1-226019"></a><span class="cmtt-10">{oeil,</span> <br /><span class="cmtt-10"> </span><span @@ -39018,9 +40553,9 @@ class="cmtt-10"> {les}</span> <br /><span class="cmtt-10">}</span> <br /> -<br /><span id="textcolor1013"><span +<br /><span id="textcolor1039"><span class="cmtt-10">@acronym</span></span><a - id="dx1-223020"></a><span + id="dx1-226020"></a><span class="cmtt-10">{svm,</span> <br /><span class="cmtt-10"> </span><span @@ -39047,18 +40582,18 @@ class="cmtt-10"> machine}</span> <br /><span class="cmtt-10">}</span> </div> -</div> Now add the <span id="textcolor1014"><span +</div> Now add the <span id="textcolor1040"><span class="cmtt-10">append-prefix-field</span></span><span class="cmtt-10">={space or nbsp}</span><a - id="dx1-223021"></a> resource option: <div class="alltt"> + id="dx1-226021"></a> resource option: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor1015"><span +<span id="textcolor1041"><span class="cmtt-10">\GlsXtrLoadResources</span></span><a - id="dx1-223022"></a><span -class="cmtt-10">[</span><span id="textcolor1016"><span + id="dx1-226022"></a><span +class="cmtt-10">[</span><span id="textcolor1042"><span class="cmtt-10">src</span></span><a - id="dx1-223023"></a><span -class="cmtt-10">=entries,</span><strong><span id="textcolor1017"><span + id="dx1-226023"></a><span +class="cmtt-10">=entries,</span><strong><span id="textcolor1043"><span class="cmtt-10">append-prefix-field</span></span><span class="cmtt-10">={space</span><span class="cmtt-10"> or</span><span @@ -39068,98 +40603,99 @@ class="cmtt-10">]</span> </div> See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-223024"></a></a> manual for further details. + id="dx1-226024"></a></a> manual for further details. <a - id="x1-223025r40"></a> + id="x1-226025r40"></a> -<!--l. 18786--><p class="noindent" > +<!--l. 19209--><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. 18786--><p class="noindent" >This document uses the <span +<!--l. 19209--><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 -href="#sec:accsupp">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a>). That package automatically -loads <span -class="cmss-10">glossaries </span>and passes all options to the base package. So you can load both packages at once with -just: + id="dx1-227001"></a> package (see <a +href="#sec:accsupp">§<span +class="cmbx-10">??</span>sec:accsupp </a><a +href="#sec:accsupp">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a>). That package +automatically loads <span +class="cmss-10">glossaries </span>and passes all options to the base package. So you can load both packages at once +with just: </p> - <div class="verbatim" id="verbatim-480"> + <pre class="verbatim" id="verbatim-487"> \usepackage[acronym]{glossaries-accsupp} -</div> -<!--l. 18792--><p class="nopar" > This provides additional keys that aren’t available with just the base package, which may be used to provide +</pre> +<!--l. 19215--><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 + id="dx1-227002"></a>’s <span class="cmtt-10">\BeginAccSupp</span><a - id="dx1-224003"></a> and <span + id="dx1-227003"></a> and <span class="cmtt-10">\EndAccSupp</span><a - id="dx1-224004"></a> + id="dx1-227004"></a> commands. See the <span class="cmss-10">accsupp</span><a - id="dx1-224005"></a> package for further details of those commands. -</p><!--l. 18799--><p class="indent" > Note that this example document is provided to demonstrate <span + id="dx1-227005"></a> package for further details of those commands. +</p><!--l. 19222--><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 + id="dx1-227006"></a> as succinctly as possible. The resulting document isn’t fully accessible as it’s not tagged. See the <span class="cmss-10">accessibility</span><a - id="dx1-224007"></a> and <span + id="dx1-227007"></a> and <span class="cmss-10">tagpdf</span><a - id="dx1-224008"></a> packages for further + id="dx1-227008"></a> packages for further information about tagging documents. -</p><!--l. 18805--><p class="indent" > It’s not essential to use <span +</p><!--l. 19228--><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 + id="dx1-227009"></a>. You can simply insert the replacement text directly into the field values. For example: </p> - <div class="verbatim" id="verbatim-481"> + <pre class="verbatim" id="verbatim-488"> \newglossaryentry{Drive}{ - <br /> name={\BeginAccSupp{Actual=Drive}Dr.\EndAccSupp{}}, - <br /> description={Drive} - <br />} - <br />\newglossaryentry{image}{name={sample image}, - <br /> description={an example image}, - <br /> user1={\protect\BeginAccSupp{Alt={a boilerplate image used in - <br />  examples}}\protect\includegraphics - <br />  [height=20pt]{example-image}\protect\EndAccSupp{}} - <br />} -</div> -<!--l. 18818--><p class="nopar" > However, this can cause interference (especially with case-changing). With <span + name={\BeginAccSupp{Actual=Drive}Dr.\EndAccSupp{}}, + description={Drive} +} +\newglossaryentry{image}{name={sample image}, + description={an example image}, + user1={\protect\BeginAccSupp{Alt={a boilerplate image used in +  examples}}\protect\includegraphics +  [height=20pt]{example-image}\protect\EndAccSupp{}} +} +</pre> +<!--l. 19241--><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 + id="dx1-227010"></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 TeX code.) -</p><!--l. 18827--><p class="indent" > The acronym style is set using: +</p><!--l. 19250--><p class="indent" > The acronym style is set using: </p> - <div class="verbatim" id="verbatim-482"> + <pre class="verbatim" id="verbatim-489"> \setacronymstyle{long-short} -</div> -<!--l. 18830--><p class="nopar" > The first abbreviation is straightforward: +</pre> +<!--l. 19253--><p class="nopar" > The first abbreviation is straightforward: </p> - <div class="verbatim" id="verbatim-483"> + <pre class="verbatim" id="verbatim-490"> \newacronym{eg}{e.g.}{for example} -</div> -<!--l. 18834--><p class="nopar" > The <span +</pre> +<!--l. 19257--><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 + id="dx1-227011"></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 the <span class="cmtt-10">shortaccess</span><a - id="dx1-224012"></a> key must be supplied: </p><div class="alltt"> + id="dx1-227012"></a> key must be supplied: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newacronym[</span><strong><span @@ -39176,14 +40712,14 @@ 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. 18846--><p class="indent" > By way of comparison, there are some entries that are technically abbreviations but are defined using +<!--l. 19269--><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 + id="dx1-227013"></a> instead of <span class="cmtt-10">\newacronym</span><a - id="dx1-224014"></a>. The replacement text is provided in the <span + id="dx1-227014"></a>. The replacement text is provided in the <span class="cmtt-10">access</span><a - id="dx1-224015"></a> key: + id="dx1-227015"></a> key: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -39199,61 +40735,62 @@ class="cmtt-10">access</span></strong><span class="cmtt-10">={Drive}}</span> </div> </div> These will use PDF’s “ActualText” element (not “E”). -<!--l. 18857--><p class="indent" > The next entry is a symbol (the integration symbol <span +<!--l. 19280--><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-484"> + <pre class="verbatim" id="verbatim-491"> \newglossaryentry{int}{name={int},description={integral}, - <br /> symbol={\ensuremath{\int}}} -</div> -<!--l. 18862--><p class="nopar" > and then referenced in the text like this: + symbol={\ensuremath{\int}}} +</pre> +<!--l. 19285--><p class="nopar" > and then referenced in the text like this: </p> - <div class="verbatim" id="verbatim-485"> + <pre class="verbatim" id="verbatim-492"> Symbol: \gls{int} (\glssymbol{int}). -</div> -<!--l. 18866--><p class="nopar" > This results in the text “Symbol: integral (<span +</pre> +<!--l. 19289--><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. 18872--><p class="indent" > It would be better if the actual text was the Unicode character 0x222B. This would not only assist the +</p><!--l. 19295--><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 + id="dx1-227016"></a> command needs to have the options adjusted. -</p><!--l. 18878--><p class="indent" > In order to determine whether to use “E”, “ActualText” or “Alt” for a particular field, <span +</p><!--l. 19301--><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 + id="dx1-227017"></a> will check if the command <span class="cmtt-10">\gls</span>⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">accsupp</span><a - id="dx1-224018"></a> exists (where ⟨<span + id="dx1-227018"></a> exists (where ⟨<span class="cmti-10">field</span>⟩ is the internal field label, see <a -href="#tab:fieldmap">table 4.1</a>). Only two -of these commands are predefined: <span +href="#tab:fieldmap">table <span +class="cmbx-10">??</span>tab:fieldmap</a>). +Only two of these commands are predefined: <span class="cmtt-10">\glsshortaccsupp</span><a - id="dx1-224019"></a> and <span + id="dx1-227019"></a> and <span class="cmtt-10">\glsshortplaccsupp</span><a - id="dx1-224020"></a>, which is why the + id="dx1-227020"></a>, which is why the <span class="cmtt-10">shortaccess</span><a - id="dx1-224021"></a> field uses “E”. If the given command doesn’t exist then the generic <span + id="dx1-227021"></a> field uses “E”. If the given command doesn’t exist then the generic <span class="cmtt-10">\glsaccsupp</span><a - id="dx1-224022"></a> command is used + id="dx1-227022"></a> command is used instead. -</p><!--l. 18887--><p class="indent" > This means that in order to simply set <span +</p><!--l. 19310--><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 + id="dx1-227023"></a> to the hexadecimal character code, I need to provide a command called <span class="cmtt-10">\glssymbolaccsupp</span><a - id="dx1-224024"></a>: </p><div class="alltt"> + id="dx1-227024"></a>: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newcommand{\gls</span><strong><span @@ -39261,7 +40798,7 @@ class="cmtt-10">symbol</span></strong><span class="cmtt-10">accsupp}[2]{%</span> <br /><span class="cmtt-10"> \glsaccessibility</span><a - id="dx1-224025"></a><span + id="dx1-227025"></a><span class="cmtt-10">[</span><strong><span class="cmtt-10">method=hex,unicode</span></strong><span class="cmtt-10">]{</span><strong><span @@ -39283,14 +40820,14 @@ class="cmtt-10">symbolaccess={222B}</span></strong> class="cmtt-10">}</span> </div> </div> -<!--l. 18902--><p class="indent" > The final entry has an image stored in the <span +<!--l. 19325--><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 + id="dx1-227026"></a> key. (The image file is provided with the <span class="cmss-10">mwe</span><a - id="dx1-224027"></a> + id="dx1-227027"></a> package.) This should use “Alt” instead of “ActualText” so I need to define <span class="cmtt-10">\glsuseriaccsupp</span><a - id="dx1-224028"></a>: + id="dx1-227028"></a>: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -39300,7 +40837,7 @@ class="cmtt-10">accsupp}[2]{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \glsaccessibility</span><a - id="dx1-224029"></a><span + id="dx1-227029"></a><span class="cmtt-10">{</span><strong><span class="cmtt-10">Alt</span></strong><span class="cmtt-10">}{#1}{#2}%</span> @@ -39311,7 +40848,7 @@ class="cmtt-10">}</span> </div> </div> The image description is provided in the <span class="cmtt-10">user1access</span><a - id="dx1-224030"></a> key: <div class="alltt"> + id="dx1-227030"></a> key: <div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newglossaryentry{sampleimage}{name={sample</span><span @@ -39322,7 +40859,7 @@ class="cmtt-10"> example</span><span class="cmtt-10"> image},</span> <br /><span class="cmtt-10"> user1={\protect\includegraphics</span><a - id="dx1-224031"></a><span + id="dx1-227031"></a><span class="cmtt-10">[height=20pt]{example-image}},</span> <br /><span class="cmtt-10"> </span><strong><span @@ -39338,29 +40875,30 @@ class="cmtt-10">}</span> </div> </div> (Note the need to protect the fragile <span class="cmtt-10">\includegraphics</span><a - id="dx1-224032"></a>. The alternative is to use <span + id="dx1-227032"></a>. The alternative is to use <span class="cmtt-10">\glsnoexpandfields </span>before defining the command. See <a -href="#sec:expansion">§4.4 </a><a +href="#sec:expansion">§<span +class="cmbx-10">??</span>sec:expansion </a><a href="#sec:expansion">Expansion<!--tex4ht:ref: sec:expansion --></a>.) -<!--l. 18923--><p class="indent" > If you try this example and inspect the +<!--l. 19346--><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 +href="#fn4x18" id="fn4x18-bk"><sup class="textsuperscript">18.4</sup></a></span><a + id="x1-227033f4"></a> then you will find content like: </p> - <div class="verbatim" id="verbatim-486"> + <pre class="verbatim" id="verbatim-493"> /Span << /ActualText (Doctor) >> BDC - <br />  BT - <br />    /F8 9.9626 Tf - <br />    73.102 697.123 Td - <br />    [ (Dr) ] TJ - <br />  ET - <br />EMC -</div> -<!--l. 18936--><p class="nopar" > This shows that “ActualText” was used for <span class="obeylines-h"><span class="verb"><span +  BT +    /F8 9.9626 Tf +    73.102 697.123 Td +    [ (Dr) ] TJ +  ET +EMC +</pre> +<!--l. 19359--><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 @@ -39369,104 +40907,104 @@ class="cmtt-10">\glssymbol{int}</span></span></span> is: </p> - <div class="verbatim" id="verbatim-487"> + <pre class="verbatim" id="verbatim-494"> /Span << /ActualText (\376\377"+) >> BDC - <br />  BT - <br />    /F1 9.9626 Tf - <br />    97.732 650.382 Td - <br />    [ (R) ] TJ - <br />  ET - <br />EMC -</div> -<!--l. 18947--><p class="nopar" > Again, “ActualText” has been used, but the character code has been supplied. The image created with +  BT +    /F1 9.9626 Tf +    97.732 650.382 Td +    [ (R) ] TJ +  ET +EMC +</pre> +<!--l. 19370--><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-488"> + <pre class="verbatim" id="verbatim-495"> /Span << /Alt (a boilerplate image used in examples) >> BDC - <br />  1 0 0 1 106.588 618.391 cm - <br />  q - <br />    0.08301 0 0 0.08301 0 0 cm - <br />    q - <br />      1 0 0 1 0 0 cm - <br />      /Im1 Do - <br />    Q - <br />  Q - <br />EMC -</div> -<!--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 +  1 0 0 1 106.588 618.391 cm +  q +    0.08301 0 0 0.08301 0 0 cm +    q +      1 0 0 1 0 0 cm +      /Im1 Do +    Q +  Q +EMC +</pre> +<!--l. 19384--><p class="nopar" > This shows that “Alt” has been used. +</p><!--l. 19387--><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-489"> + <pre class="verbatim" id="verbatim-496"> /Span << /E (for example) >> BDC - <br />  BT - <br />    /F8 9.9626 Tf - <br />    161.687 563.624 Td - <br />    [ (e.g.) ] TJ - <br />  ET - <br />EMC -</div> -<!--l. 18974--><p class="nopar" > The subsequent use also has the “E” element: +  BT +    /F8 9.9626 Tf +    161.687 563.624 Td +    [ (e.g.) ] TJ +  ET +EMC +</pre> +<!--l. 19397--><p class="nopar" > The subsequent use also has the “E” element: </p> - <div class="verbatim" id="verbatim-490"> + <pre class="verbatim" id="verbatim-497"> /Span << /E (for example) >> BDC - <br />  BT - <br />    /F8 9.9626 Tf - <br />    118.543 551.669 Td - <br />    [ (e.g.) ] TJ - <br />  ET - <br />EMC -</div> -<!--l. 18984--><p class="nopar" > Similarly for <span class="obeylines-h"><span class="verb"><span +  BT +    /F8 9.9626 Tf +    118.543 551.669 Td +    [ (e.g.) ] TJ +  ET +EMC +</pre> +<!--l. 19407--><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 class="cmss-10">showaccsupp</span><a - id="dx1-224034"></a> package option. This will show + id="dx1-227034"></a> package option. This will show 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. 18990--><p class="indent" > If the <span +</p><!--l. 19413--><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 + id="dx1-227035"></a> command is removed (or commented out) then the result would be different. The <a href="#glo:firstuse">first use</a> of <span class="cmtt-10">\gls </span>uses “E” for the short form but the subsequent use has “ActualText” instead. This is because without <span class="cmtt-10">\setacronymstyle</span><a - id="dx1-224036"></a> the original acronym mechanism is used, which is less sophisticated than the newer + id="dx1-227036"></a> the original acronym mechanism is used, which is less sophisticated than the newer acronym mechanism that’s triggered with <span class="cmtt-10">\setacronymstyle</span><a - id="dx1-224037"></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 + id="dx1-227037"></a>. +</p><!--l. 19420--><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. 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 +</p><!--l. 19424--><p class="noindent" > +</p><!--l. 19426--><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 class="cmss-10">glossaries-extra</span></a>, you need to replace the explicit loading of <span class="cmss-10">glossaries-accsupp</span><a - id="dx1-224038"></a> with an implicit load through the <span id="textcolor1018"><span + id="dx1-227038"></a> with an implicit load through the <span id="textcolor1044"><span class="cmss-10">accsupp</span></span><a - id="dx1-224039"></a> package option: + id="dx1-227039"></a> package option: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\usepackage[</span><span id="textcolor1019"><span +class="cmtt-10">\usepackage[</span><span id="textcolor1045"><span class="cmtt-10">abbreviations</span></span><span -class="cmtt-10">,</span><strong><span id="textcolor1020"><span +class="cmtt-10">,</span><strong><span id="textcolor1046"><span class="cmtt-10">accsupp</span></span></strong><span class="cmtt-10">]{</span><strong><span class="cmtt-10">glossaries-extra</span></strong><span @@ -39474,39 +41012,39 @@ class="cmtt-10">}</span> </div> </div> I’m switching from <span class="cmtt-10">\newacronym</span><a - id="dx1-224040"></a> to <span id="textcolor1021"><span + id="dx1-227040"></a> to <span id="textcolor1047"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-224041"></a>, which means that the default category is <span id="textcolor1022"><span + id="dx1-227041"></a>, which means that the default category is <span id="textcolor1048"><span class="cmss-10">abbreviation</span></span><a - id="dx1-224042"></a> + id="dx1-227042"></a> and also the file extensions are different. If you are using <a href="#glo:makeglossaries"><span class="cmtt-10">makeglossaries</span><a - id="dx1-224043"></a></a> or <a + id="dx1-227043"></a></a> or <a href="#glo:makeglossaries-lite.lua"><span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-224044"></a></a> you don’t + id="dx1-227044"></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. 19018--><p class="indent" > The style command <span +<!--l. 19441--><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 class="cmtt-10">\setabbreviationstyle</span><a - id="dx1-224045"></a><span + id="dx1-227045"></a><span class="cmtt-10">{long-short}</span> </div> </div> This is actually the default so you can simply delete the <span class="cmtt-10">\setacronymstyle </span>line. Substitute the two instances of <span class="cmtt-10">\newacronym</span><a - id="dx1-224046"></a> with <span id="textcolor1023"><span + id="dx1-227046"></a> with <span id="textcolor1049"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-224047"></a>. For example: <div class="alltt"> + id="dx1-227047"></a>. For example: <div class="alltt"> <div class="obeylines-v"> -<strong><span id="textcolor1024"><span +<strong><span id="textcolor1050"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-224048"></a></strong><span + id="dx1-227048"></a></strong><span class="cmtt-10">{eg}{e.g.}{for</span><span class="cmtt-10"> example}</span> @@ -39515,15 +41053,15 @@ class="cmtt-10"> example}</span> </div> Note that for the <span class="cmtt-10">tikz </span>entry you can now remove the explicit assignment of <span class="cmtt-10">shortaccess</span><a - id="dx1-224049"></a> with <a + id="dx1-227049"></a> with <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> v1.42 as it will strip formatting commands like <span class="cmtt-10">\emph</span>: <div class="alltt"> <div class="obeylines-v"> -<span id="textcolor1025"><span +<span id="textcolor1051"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-224050"></a> + id="dx1-227050"></a> <br /><span class="cmtt-10"> {tikz}{Ti\emph{k}Z}{Ti\emph{k}Z</span><span class="cmtt-10"> ist</span><span @@ -39533,17 +41071,17 @@ class="cmtt-10"> Zeichenprogramm}</span> </div> It’s also necessary to replace <span class="cmtt-10">\acrshort</span>, <span class="cmtt-10">\acrlong </span>and <span -class="cmtt-10">\acrfull </span>with <span id="textcolor1026"><span +class="cmtt-10">\acrfull </span>with <span id="textcolor1052"><span class="cmtt-10">\glsxtrshort</span></span><a - id="dx1-224051"></a>, <span id="textcolor1027"><span + id="dx1-227051"></a>, <span id="textcolor1053"><span class="cmtt-10">\glsxtrlong</span></span><a - id="dx1-224052"></a> and -<span id="textcolor1028"><span + id="dx1-227052"></a> and +<span id="textcolor1054"><span class="cmtt-10">\glsxtrfull</span></span><a - id="dx1-224053"></a>. -<!--l. 19039--><p class="indent" > You may notice a slight difference from the original example. The <span + id="dx1-227053"></a>. +<!--l. 19462--><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 + id="dx1-227054"></a> field now shows ⟨<span class="cmti-10">long</span>⟩ (⟨<span class="cmti-10">short</span>⟩) instead of just ⟨<span @@ -39551,22 +41089,22 @@ class="cmti-10">long</span>⟩. This is because <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a> redefines <span class="cmtt-10">\glsdefaultshortaccess</span><a - id="dx1-224055"></a> to include the short + id="dx1-227055"></a> to include the short form. -</p><!--l. 19044--><p class="indent" > Now that the extension package is being used, there are some other modifications that would tidy up the +</p><!--l. 19467--><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. 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 +</p><!--l. 19470--><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="textcolor1055"><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 -for the <span id="textcolor1030"><span + id="dx1-227056"></a> style can achieve this and it happens to be the default style +for the <span id="textcolor1056"><span class="cmss-10">acronym</span></span><a - id="dx1-224057"></a> category. This means that you can simply replace the “Doctor” definition with: + id="dx1-227057"></a> category. This means that you can simply replace the “Doctor” definition with: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newacronym</span><a - id="dx1-224058"></a><span + id="dx1-227058"></a><span class="cmtt-10">{Doctor}{Dr}{Doctor}</span> </div> </div> The <a @@ -39574,145 +41112,145 @@ 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. 19060--><p class="indent" > The “Drive” entry can be similarly defined but it has the awkward terminating full stop. This means that I +<!--l. 19483--><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-491"> + <pre class="verbatim" id="verbatim-498"> \gls{Doctor} Smith lives at 2, Blueberry \gls{Drive} -</div> -<!--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 +</pre> +<!--l. 19488--><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="cmtt-10">sample-dot-abbr.tex</span></a> example. I can again use the <span id="textcolor1057"><span class="cmss-10">discardperiod</span></span><a - id="dx1-224059"></a> attribute, but I need to assign a + id="dx1-227059"></a> attribute, but I need to assign a different category so that it doesn’t interfere with the “Doctor” entry. -</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 +</p><!--l. 19495--><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="textcolor1058"><span class="cmss-10">general</span></span><a - id="dx1-224060"></a>, <span id="textcolor1033"><span + id="dx1-227060"></a>, <span id="textcolor1059"><span class="cmss-10">abbreviation</span></span><a - id="dx1-224061"></a>, <span id="textcolor1034"><span + id="dx1-227061"></a>, <span id="textcolor1060"><span class="cmss-10">acronym</span></span><a - id="dx1-224062"></a>, <span id="textcolor1035"><span + id="dx1-227062"></a>, <span id="textcolor1061"><span class="cmss-10">index</span></span><a - id="dx1-224063"></a>, -<span id="textcolor1036"><span + id="dx1-227063"></a>, +<span id="textcolor1062"><span class="cmss-10">symbol</span></span><a - id="dx1-224064"></a> and <span id="textcolor1037"><span + id="dx1-227064"></a> and <span id="textcolor1063"><span class="cmss-10">number</span></span><a - id="dx1-224065"></a> are used by various commands provided by <a + id="dx1-227065"></a> are used by various commands provided by <a href="#glo:glossaries-extra"><span class="cmss-10">glossaries-extra</span></a>). -</p><!--l. 19079--><p class="indent" > In this case, I’ve decided to have a category called <span +</p><!--l. 19502--><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"> <div class="obeylines-v"> -<span id="textcolor1038"><span +<span id="textcolor1064"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-224066"></a><span + id="dx1-227066"></a><span class="cmtt-10">[shortdotted]{short-nolong-noreg}</span> -<br /><span id="textcolor1039"><span +<br /><span id="textcolor1065"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-224067"></a><span + id="dx1-227067"></a><span class="cmtt-10">{shortdotted}{discardperiod}{true}</span> -<br /><span id="textcolor1040"><span +<br /><span id="textcolor1066"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-224068"></a><span + id="dx1-227068"></a><span class="cmtt-10">[category=shortdotted]{Drive}{Dr.\@}{Drive}</span> </div> </div> In the <a href="#ex:sample-dot-abbr"><span -class="cmtt-10">sample-dot-abbr.tex</span></a> example, I also used the <span id="textcolor1041"><span +class="cmtt-10">sample-dot-abbr.tex</span></a> example, I also used the <span id="textcolor1067"><span class="cmss-10">insertdots</span></span><a - id="dx1-224069"></a> attribute to automatically insert the dots and -add the space factor (which is adjusted if <span id="textcolor1042"><span + id="dx1-227069"></a> attribute to automatically insert the dots and +add the space factor (which is adjusted if <span id="textcolor1068"><span class="cmss-10">discardperiod</span></span><a - id="dx1-224070"></a> discards a period). In this case I’m inserting the dot + id="dx1-227070"></a> discards a period). In this case I’m inserting the dot manually so I’ve also added the space factor with <span class="cmtt-10">\@</span><a - id="dx1-224071"></a> in case the abbreviation is used mid-sentence. For + id="dx1-227071"></a> in case the abbreviation is used mid-sentence. For example: - <div class="verbatim" id="verbatim-492"> + <pre class="verbatim" id="verbatim-499"> \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. 19097--><p class="nopar" > (The spacing is more noticeable if you first switch to a monospaced font with <span +\gls{Doctor} Smith lives at 2, Blueberry \gls{Drive} end of sentence. +</pre> +<!--l. 19520--><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. 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 +</p><!--l. 19524--><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 style. For example: </p><div class="alltt"> <div class="obeylines-v"> -<span id="textcolor1043"><span +<span id="textcolor1069"><span class="cmtt-10">\setabbreviationstyle</span></span><a - id="dx1-224072"></a><span + id="dx1-227072"></a><span class="cmtt-10">[longshortdotted]{long-short}</span> -<br /><span id="textcolor1044"><span +<br /><span id="textcolor1070"><span class="cmtt-10">\glssetcategoryattribute</span></span><a - id="dx1-224073"></a><span + id="dx1-227073"></a><span class="cmtt-10">{longshortdotted}{discardperiod}{true}</span> -<br /><span id="textcolor1045"><span +<br /><span id="textcolor1071"><span class="cmtt-10">\newabbreviation</span></span><a - id="dx1-224074"></a><span + id="dx1-227074"></a><span class="cmtt-10">[category=longshortdotted]{e.g.}{e.g.\@}{for</span> <br /><span class="cmtt-10">example}</span> </div> </div> -<!--l. 19114--><p class="indent" > To further illustrate categories, let’s suppose the symbol and image should be in the <span +<!--l. 19537--><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 + id="dx1-227075"></a> field instead of the <span class="cmtt-10">symbol</span><a - id="dx1-224076"></a> and <span + id="dx1-227076"></a> and <span class="cmtt-10">user1</span><a - id="dx1-224077"></a> fields. Now the <span + id="dx1-227077"></a> fields. Now the <span 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. 19121--><p class="indent" > I could provide category-field versions, such as <span id="textcolor1046"><span +</p><!--l. 19544--><p class="indent" > I could provide category-field versions, such as <span id="textcolor1072"><span class="cmtt-10">\glsxtrsymbolnameaccsupp</span></span>, but remember that this only covers accessing the <span class="cmtt-10">name</span><a - id="dx1-224078"></a> field, which is typically only done in the glossary. I would also need similar commands + id="dx1-227078"></a> field, which is typically only done in the glossary. I would also need similar commands for the <span class="cmtt-10">first</span><a - id="dx1-224079"></a>, <span + id="dx1-227079"></a>, <span class="cmtt-10">firstplural</span><a - id="dx1-224080"></a>, <span + id="dx1-227080"></a>, <span class="cmtt-10">text</span><a - id="dx1-224081"></a> and <span + id="dx1-227081"></a> and <span class="cmtt-10">plural</span><a - id="dx1-224082"></a> keys. This is quite complicated, but since I don’t need to worry -about any of the other fields it’s simpler to just provide the <span id="textcolor1047"><span + id="dx1-227082"></a> keys. This is quite complicated, but since I don’t need to worry +about any of the other fields it’s simpler to just provide the <span id="textcolor1073"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">category</span>⟩<span class="cmtt-10">accsupp</span></span><a - id="dx1-224083"></a> version: + id="dx1-227083"></a> version: </p><div class="alltt"> <div class="obeylines-v"> <span -class="cmtt-10">\newcommand{</span><span id="textcolor1048"><span +class="cmtt-10">\newcommand{</span><span id="textcolor1074"><span class="cmtt-10">\glsxtr</span><strong><span class="cmtt-10">symbol</span></strong><span class="cmtt-10">accsupp</span></span><span class="cmtt-10">}[2]{%</span> <br /><span class="cmtt-10"> \glsaccessibility</span><a - id="dx1-224084"></a><span + id="dx1-227084"></a><span class="cmtt-10">[method=hex,unicode]{ActualText}{#1}{#2}%</span> <br /><span class="cmtt-10">}</span> <br /><span -class="cmtt-10">\newcommand{</span><span id="textcolor1049"><span +class="cmtt-10">\newcommand{</span><span id="textcolor1075"><span class="cmtt-10">\glsxtr</span><strong><span class="cmtt-10">image</span></strong><span class="cmtt-10">accsupp</span></span><span @@ -39720,13 +41258,13 @@ class="cmtt-10">}[2]{%</span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \glsaccessibility</span><a - id="dx1-224085"></a><span + id="dx1-227085"></a><span class="cmtt-10">{Alt}{#1}{#2}%</span> <br /><span class="cmtt-10">}</span> <br /> <br /><span -class="cmtt-10">\newglossaryentry{int}{</span><strong><span id="textcolor1050"><span +class="cmtt-10">\newglossaryentry{int}{</span><strong><span id="textcolor1076"><span class="cmtt-10">category</span></span><span class="cmtt-10">=symbol</span></strong><span class="cmtt-10">,</span> @@ -39744,7 +41282,7 @@ class="cmtt-10"> description={integral}</span> class="cmtt-10">}</span> <br /> <br /><span -class="cmtt-10">\newglossaryentry{sampleimage}{</span><strong><span id="textcolor1051"><span +class="cmtt-10">\newglossaryentry{sampleimage}{</span><strong><span id="textcolor1077"><span class="cmtt-10">category</span></span><span class="cmtt-10">=image</span></strong><span class="cmtt-10">,</span> @@ -39771,28 +41309,28 @@ class="cmtt-10"> examples}</span> class="cmtt-10">}</span> </div> </div> If it’s necessary to provide support for additional fields, then the category-field command -<span id="textcolor1052"><span +<span id="textcolor1078"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">category</span>⟩⟨<span class="cmitt-10">field</span>⟩<span class="cmtt-10">accsupp</span></span><a - id="dx1-224086"></a> could be used to override the more general category command -<span id="textcolor1053"><span + id="dx1-227086"></a> could be used to override the more general category command +<span id="textcolor1079"><span class="cmtt-10">\glsxtr</span>⟨<span class="cmitt-10">category</span>⟩<span class="cmtt-10">accsupp</span></span><a - id="dx1-224087"></a>. + id="dx1-227087"></a>. <a - id="x1-224088r41"></a> -<!--l. 19152--><p class="noindent" > + id="x1-227088r41"></a> +<!--l. 19575--><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. 19152--><p class="noindent" >This document defines an ignored glossary for common terms that don’t need a definition. The document build +<!--l. 19575--><p class="noindent" >This document defines an ignored glossary for common terms that don’t need a definition. The document build is: -</p><!--l. 19154--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> +</p><!--l. 19577--><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 @@ -39802,39 +41340,40 @@ A new “ignored” glossary is defined with: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">\newignoredglossary</span><a - id="dx1-225001"></a><span + id="dx1-228001"></a><span class="cmtt-10">{common}</span> </div> </div> There are no associated files with an ignored glossary. An entry is defined with this as its glossary type: - <div class="verbatim" id="verbatim-493"> + <pre class="verbatim" id="verbatim-500"> \newglossaryentry{commonex}{type=common,name={common term}} -</div> -<!--l. 19167--><p class="nopar" > Note that the <span +</pre> +<!--l. 19590--><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 + id="dx1-228002"></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. 19172--><p class="noindent" > + id="x1-228003r42"></a> +</p><!--l. 19595--><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. 19172--><p class="noindent" >This document uses <span +<!--l. 19595--><p class="noindent" >This document uses <span class="cmtt-10">\glsenableentrycount</span><a - id="dx1-226001"></a> and <span + id="dx1-229001"></a> and <span class="cmtt-10">\cgls</span><a - id="dx1-226002"></a> (described in <a -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. 19176--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h"> + id="dx1-229002"></a> (described in <a +href="#sec:enableentrycount">§<span +class="cmbx-10">??</span>sec:enableentrycount </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. 19599--><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 @@ -39844,39 +41383,40 @@ acronyms. The document build is: 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 LaTeX call is required at the + id="dx1-229003"></a></a>, and then a final LaTeX call is required at the end. -</p><!--l. 19185--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a +</p><!--l. 19608--><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. 19188--><p class="noindent" > -</p><!--l. 19190--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you switch to <a +</p><!--l. 19611--><p class="noindent" > +</p><!--l. 19613--><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 + id="dx1-229004"></a></a> you can use record counting instead. See the <a href="#glo:bib2gls"><span class="cmtt-10">bib2gls</span><a - id="dx1-226005"></a></a> manual for further details. + id="dx1-229005"></a></a> manual for further details. </div> -</p><!--l. 19193--><p class="noindent" > +</p><!--l. 19616--><p class="noindent" > </p> -<!--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 +<!--l. 19618--><p class="indent" > </div> +</p><!--l. 19618--><p class="noindent" ><a +href="#top">Top</a><div class="chapter"><h2 class="chapterHead">19. <a id="sec:trouble"></a>Troubleshooting</h2> -</p><!--l. 19198--><p class="indent" > In addition to the sample files listed in <a -href="#sec:samples">§19 </a><a +</p><!--l. 19621--><p class="indent" > In addition to the sample files listed in <a +href="#sec:samples">§<span +class="cmbx-10">??</span>sec:samples </a><a href="#sec:samples">Sample Documents<!--tex4ht:ref: sec:samples --></a>, the <span -class="cmss-10">glossaries </span>package comes with some -minimal example files, <span +class="cmss-10">glossaries </span>package comes with +some minimal example files, <span class="cmtt-10">minimalgls.tex</span>, <span class="cmtt-10">mwe-gls.tex</span>, <span class="cmtt-10">mwe-acr.tex </span>and <span -class="cmtt-10">mwe-acr-desc.tex</span>, which can be -used for testing. These should be located in the <span +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 TeX installation. For example, on my @@ -39885,38 +41425,38 @@ class="cmtt-10">/usr/local/texlive/2014/texmf-dist/doc/latex/glossaries/</span>. <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 + id="dx1-230001"></a></a> application can also be used to test for various problems. Further information on 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. 19213--><p class="indent" > If you have any problems, please first consult the <a +</p><!--l. 19636--><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/" >LaTeX Community Forum</a> or <a -href="http://tex.stackexchange.com/" >TeX on StackExchange</a>. +href="https://latex.org/forum/" >LaTeX Community Forum</a> or <a +href="https://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>. +href="https://www.dickimaw-books.com/bug-report.html" >my package bug report form</a>. </p> <!--l. 2--><p class="indent" > </div> </p><!--l. 2--><p class="noindent" ><a href="#top">Top</a></p><h2 class="likechapterHead"><a - id="x1-22800020"></a>Index</h2> + id="x1-23100019"></a>Index</h2> <span class="cmbx-10">Symbols</span> <div class="theindex"><span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\’</span></span></span>  <a -href="glossaries-user.html#dx1-216002" >1</a> <br /></span> +href="glossaries-user.html#dx1-219002" >1</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\@</span></span></span>  <a -href="glossaries-user.html#dx1-186026" >2</a>, <a -href="glossaries-user.html#dx1-186027" >3</a>, <a -href="glossaries-user.html#dx1-186033" >4</a>, <a -href="glossaries-user.html#dx1-186034" >5</a>, <a -href="glossaries-user.html#dx1-224071" >6</a> <br /></span> +href="glossaries-user.html#dx1-189026" >2</a>, <a +href="glossaries-user.html#dx1-189027" >3</a>, <a +href="glossaries-user.html#dx1-189033" >4</a>, <a +href="glossaries-user.html#dx1-189034" >5</a>, <a +href="glossaries-user.html#dx1-227071" >6</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\@gls@codepage</span></span></span>  <a href="glossaries-user.html#dx1-22020" ><span @@ -39962,7820 +41502,7930 @@ href="glossaries-user.html#dx1-5007" >16</a> <br /></span> class="tcrm-0900">†</span></sup>abbreviation styles:<br /></span> <span class="index-subitem">    <span class="cmtt-10">footnote</span>  <a -href="glossaries-user.html#dx1-181006" >17</a> <br /></span> +href="glossaries-user.html#dx1-184006" >17</a> <br /></span> +<span class="index-subitem">    <span +class="cmtt-10">long-noshort</span>  <a +href="glossaries-user.html#dx1-137002" >18</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-short</span>  <a -href="glossaries-user.html#dx1-175029" >18</a>, <a -href="glossaries-user.html#dx1-185011" >19</a>, <a -href="glossaries-user.html#dx1-186011" >20</a> <br /></span> +href="glossaries-user.html#dx1-178029" >19</a>, <a +href="glossaries-user.html#dx1-188011" >20</a>, <a +href="glossaries-user.html#dx1-189011" >21</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-short-sc</span>  <a -href="glossaries-user.html#dx1-178026" >21</a> <br /></span> +href="glossaries-user.html#dx1-181026" >22</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-short-sc-desc</span>  <a -href="glossaries-user.html#dx1-179013" >22</a> <br /></span> +href="glossaries-user.html#dx1-182013" >23</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">postfootnote</span>  <a -href="glossaries-user.html#dx1-181005" >23</a> <br /></span> +href="glossaries-user.html#dx1-184005" >24</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">short-nolong</span>  <a -href="glossaries-user.html#dx1-175032" >24</a>, <a -href="glossaries-user.html#dx1-224056" >25</a> <br /></span> +href="glossaries-user.html#dx1-135008" >25</a>, <a +href="glossaries-user.html#dx1-178032" >26</a>, <a +href="glossaries-user.html#dx1-227056" >27</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">short-sc-footnote</span>  <a -href="glossaries-user.html#dx1-181007" >26</a> <br /></span> +href="glossaries-user.html#dx1-184007" >28</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">short-sc-footnote-desc</span>  <a -href="glossaries-user.html#dx1-181002" >27</a>, <a -href="glossaries-user.html#dx1-182003" >28</a>, <a -href="glossaries-user.html#dx1-184004" >29</a>, <a -href="glossaries-user.html#dx1-184006" >30</a> <br /></span> +href="glossaries-user.html#dx1-184002" >29</a>, <a +href="glossaries-user.html#dx1-185003" >30</a>, <a +href="glossaries-user.html#dx1-187004" >31</a>, <a +href="glossaries-user.html#dx1-187006" >32</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">short-sc-postfootnote-desc</span>  <a -href="glossaries-user.html#dx1-181004" >31</a>, <a -href="glossaries-user.html#dx1-182005" >32</a>, <a -href="glossaries-user.html#dx1-184005" >33</a>, <a -href="glossaries-user.html#dx1-184007" >34</a> <br /></span> +href="glossaries-user.html#dx1-184004" >33</a>, <a +href="glossaries-user.html#dx1-185005" >34</a>, <a +href="glossaries-user.html#dx1-187005" >35</a>, <a +href="glossaries-user.html#dx1-187007" >36</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Ac</span></span></span>  <a -href="glossaries-user.html#dx1-147112" >35</a> <br /></span> +href="glossaries-user.html#dx1-136065" >37</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ac</span></span></span>  <a -href="glossaries-user.html#dx1-147110" >36</a> <br /></span> +href="glossaries-user.html#dx1-136063" >38</a> <br /></span> <span class="index-item"><span class="cmss-10">accessibility </span>package  <a -href="glossaries-user.html#dx1-172057" >37</a>, <a -href="glossaries-user.html#dx1-172087" >38</a>, <a -href="glossaries-user.html#dx1-224007" >39</a> <br /></span> +href="glossaries-user.html#dx1-175057" >39</a>, <a +href="glossaries-user.html#dx1-175087" >40</a>, <a +href="glossaries-user.html#dx1-227007" >41</a> <br /></span> <span class="index-item"><span class="cmss-10">accsupp </span>package  <a -href="glossaries-user.html#dx1-172002" >40</a>, <a -href="glossaries-user.html#dx1-172059" >41</a>, <a -href="glossaries-user.html#dx1-172086" >42</a>, <a -href="glossaries-user.html#dx1-224002" >43</a>, <a -href="glossaries-user.html#dx1-224005" >44</a> <br /></span> +href="glossaries-user.html#dx1-175002" >42</a>, <a +href="glossaries-user.html#dx1-175059" >43</a>, <a +href="glossaries-user.html#dx1-175086" >44</a>, <a +href="glossaries-user.html#dx1-227002" >45</a>, <a +href="glossaries-user.html#dx1-227005" >46</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acf</span></span></span>  <a -href="glossaries-user.html#dx1-147104" >45</a> <br /></span> +href="glossaries-user.html#dx1-136057" >47</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acf</span></span></span>  <a -href="glossaries-user.html#dx1-147102" >46</a> <br /></span> +href="glossaries-user.html#dx1-136055" >48</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acfp</span></span></span>  <a -href="glossaries-user.html#dx1-147108" >47</a> <br /></span> -<span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\acfp</span></span></span>  <a -href="glossaries-user.html#dx1-147106" >48</a> <br /></span> +href="glossaries-user.html#dx1-136061" >49</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\acfp</span></span></span>  <a +href="glossaries-user.html#dx1-136059" >50</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acl</span></span></span>  <a -href="glossaries-user.html#dx1-147096" >49</a> <br /></span> +href="glossaries-user.html#dx1-136049" >51</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acl</span></span></span>  <a -href="glossaries-user.html#dx1-147094" >50</a> <br /></span> +href="glossaries-user.html#dx1-136047" >52</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Aclp</span></span></span>  <a -href="glossaries-user.html#dx1-147100" >51</a> <br /></span> +href="glossaries-user.html#dx1-136053" >53</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\aclp</span></span></span>  <a -href="glossaries-user.html#dx1-147098" >52</a> <br /></span> +href="glossaries-user.html#dx1-136051" >54</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acp</span></span></span>  <a -href="glossaries-user.html#dx1-147116" >53</a> <br /></span> +href="glossaries-user.html#dx1-136069" >55</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acp</span></span></span>  <a -href="glossaries-user.html#dx1-147114" >54</a> <br /></span> +href="glossaries-user.html#dx1-136067" >56</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ACRfull</span></span></span>  <a -href="glossaries-user.html#dx1-147080" ><span -class="cmti-10">55</span></a> <br /></span> +href="glossaries-user.html#dx1-136033" ><span +class="cmti-10">57</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acrfull</span></span></span>  <a -href="glossaries-user.html#dx1-147079" ><span -class="cmti-10">56</span></a>, <a -href="glossaries-user.html#dx1-147105" >57</a> <br /></span> +href="glossaries-user.html#dx1-136032" ><span +class="cmti-10">58</span></a>, <a +href="glossaries-user.html#dx1-136058" >59</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrfull</span></span></span>  <a -href="glossaries-user.html#dx1-147076" ><span -class="cmti-10">58</span></a>, <a -href="glossaries-user.html#dx1-147103" >59</a>, <a -href="glossaries-user.html#dx1-149017" >60</a>, <a -href="glossaries-user.html#dx1-149055" >61</a>, <a -href="glossaries-user.html#dx1-149068" >62</a>, <a -href="glossaries-user.html#dx1-150054" >63</a>, <a -href="glossaries-user.html#dx1-153015" >64</a>, <a -href="glossaries-user.html#dx1-178037" >65</a>, <a -href="glossaries-user.html#dx1-179038" >66</a> <br /></span> +href="glossaries-user.html#dx1-136029" ><span +class="cmti-10">60</span></a>, <a +href="glossaries-user.html#dx1-136056" >61</a>, <a +href="glossaries-user.html#dx1-138017" >62</a>, <a +href="glossaries-user.html#dx1-138055" >63</a>, <a +href="glossaries-user.html#dx1-138068" >64</a>, <a +href="glossaries-user.html#dx1-139054" >65</a>, <a +href="glossaries-user.html#dx1-142017" >66</a>, <a +href="glossaries-user.html#dx1-181037" >67</a>, <a +href="glossaries-user.html#dx1-182038" >68</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrfullfmt</span></span></span>  <a -href="glossaries-user.html#dx1-147077" ><span -class="cmti-10">67</span></a>, <a -href="glossaries-user.html#dx1-150018" >68</a>, <a -href="glossaries-user.html#dx1-150055" >69</a> <br /></span> +href="glossaries-user.html#dx1-136030" ><span +class="cmti-10">69</span></a>, <a +href="glossaries-user.html#dx1-139018" >70</a>, <a +href="glossaries-user.html#dx1-139055" >71</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrfullformat</span></span></span>  <a -href="glossaries-user.html#dx1-147078" ><span -class="cmti-10">70</span></a>, <a -href="glossaries-user.html#dx1-147132" >71</a> <br /></span> +href="glossaries-user.html#dx1-136031" ><span +class="cmti-10">72</span></a>, <a +href="glossaries-user.html#dx1-136085" >73</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ACRfullpl</span></span></span>  <a -href="glossaries-user.html#dx1-147083" ><span -class="cmti-10">72</span></a> <br /></span> +href="glossaries-user.html#dx1-136036" ><span +class="cmti-10">74</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acrfullpl</span></span></span>  <a -href="glossaries-user.html#dx1-147082" ><span -class="cmti-10">73</span></a>, <a -href="glossaries-user.html#dx1-147109" >74</a> <br /></span> +href="glossaries-user.html#dx1-136035" ><span +class="cmti-10">75</span></a>, <a +href="glossaries-user.html#dx1-136062" >76</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrfullpl</span></span></span>  <a -href="glossaries-user.html#dx1-147081" ><span -class="cmti-10">75</span></a>, <a -href="glossaries-user.html#dx1-147107" >76</a> <br /></span> +href="glossaries-user.html#dx1-136034" ><span +class="cmti-10">77</span></a>, <a +href="glossaries-user.html#dx1-136060" >78</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ACRlong</span></span></span>  <a -href="glossaries-user.html#dx1-147069" ><span -class="cmti-10">77</span></a> <br /></span> +href="glossaries-user.html#dx1-136022" ><span +class="cmti-10">79</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acrlong</span></span></span>  <a -href="glossaries-user.html#dx1-147068" ><span -class="cmti-10">78</span></a>, <a -href="glossaries-user.html#dx1-147097" >79</a> <br /></span> +href="glossaries-user.html#dx1-136021" ><span +class="cmti-10">80</span></a>, <a +href="glossaries-user.html#dx1-136050" >81</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrlong</span></span></span>  <a -href="glossaries-user.html#dx1-147064" ><span -class="cmti-10">80</span></a>, <a -href="glossaries-user.html#dx1-147095" >81</a>, <a -href="glossaries-user.html#dx1-178036" >82</a>, <a -href="glossaries-user.html#dx1-179037" >83</a>, <a -href="glossaries-user.html#dx1-186015" >84</a> <br /></span> +href="glossaries-user.html#dx1-136017" ><span +class="cmti-10">82</span></a>, <a +href="glossaries-user.html#dx1-136048" >83</a>, <a +href="glossaries-user.html#dx1-181036" >84</a>, <a +href="glossaries-user.html#dx1-182037" >85</a>, <a +href="glossaries-user.html#dx1-189015" >86</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ACRlongpl</span></span></span>  <a -href="glossaries-user.html#dx1-147072" ><span -class="cmti-10">85</span></a> <br /></span> +href="glossaries-user.html#dx1-136025" ><span +class="cmti-10">87</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acrlongpl</span></span></span>  <a -href="glossaries-user.html#dx1-147071" ><span -class="cmti-10">86</span></a>, <a -href="glossaries-user.html#dx1-147101" >87</a> <br /></span> +href="glossaries-user.html#dx1-136024" ><span +class="cmti-10">88</span></a>, <a +href="glossaries-user.html#dx1-136054" >89</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrlongpl</span></span></span>  <a -href="glossaries-user.html#dx1-147070" ><span -class="cmti-10">88</span></a>, <a -href="glossaries-user.html#dx1-147099" >89</a> <br /></span> +href="glossaries-user.html#dx1-136023" ><span +class="cmti-10">90</span></a>, <a +href="glossaries-user.html#dx1-136052" >91</a> <br /></span> <span class="index-item">acronym styles:<br /></span> <span class="index-subitem">    <span class="cmtt-10">dua</span>  <a -href="glossaries-user.html#dx1-149019" >90</a>, <a -href="glossaries-user.html#dx1-149053" >91</a>, <a -href="glossaries-user.html#dx1-149057" >92</a>, <a -href="glossaries-user.html#dx1-150021" >93</a> <br /></span> +href="glossaries-user.html#dx1-137003" >92</a>, <a +href="glossaries-user.html#dx1-138019" >93</a>, <a +href="glossaries-user.html#dx1-138053" >94</a>, <a +href="glossaries-user.html#dx1-138057" >95</a>, <a +href="glossaries-user.html#dx1-139021" >96</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">dua-desc</span>  <a -href="glossaries-user.html#dx1-149054" >94</a>, <a -href="glossaries-user.html#dx1-149060" >95</a> <br /></span> +href="glossaries-user.html#dx1-138054" >97</a>, <a +href="glossaries-user.html#dx1-138060" >98</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">footnote</span>  <a -href="glossaries-user.html#dx1-149020" >96</a>, <a -href="glossaries-user.html#dx1-149064" >97</a>, <a -href="glossaries-user.html#dx1-150020" >98</a> <br /></span> +href="glossaries-user.html#dx1-138020" >99</a>, <a +href="glossaries-user.html#dx1-138064" >100</a>, <a +href="glossaries-user.html#dx1-139020" >101</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">footnote-desc</span>  <a -href="glossaries-user.html#dx1-149074" >99</a> <br /></span> +href="glossaries-user.html#dx1-138074" >102</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">footnote-sc</span>  <a -href="glossaries-user.html#dx1-149065" >100</a> <br /></span> +href="glossaries-user.html#dx1-138065" >103</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">footnote-sc-desc</span>  <a -href="glossaries-user.html#dx1-149075" >101</a>, <a -href="glossaries-user.html#dx1-149084" >102</a>, <a -href="glossaries-user.html#dx1-149087" >103</a>, <a -href="glossaries-user.html#dx1-181001" >104</a>, <a -href="glossaries-user.html#dx1-182002" >105</a> <br /></span> +href="glossaries-user.html#dx1-138075" >104</a>, <a +href="glossaries-user.html#dx1-138084" >105</a>, <a +href="glossaries-user.html#dx1-138087" >106</a>, <a +href="glossaries-user.html#dx1-184001" >107</a>, <a +href="glossaries-user.html#dx1-185002" >108</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">footnote-sm</span>  <a -href="glossaries-user.html#dx1-149066" >106</a> <br /></span> +href="glossaries-user.html#dx1-138066" >109</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">footnote-sm-desc</span>  <a -href="glossaries-user.html#dx1-149076" >107</a> <br /></span> +href="glossaries-user.html#dx1-138076" >110</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-sc-short</span>  <a -href="glossaries-user.html#dx1-149007" >108</a>, <a -href="glossaries-user.html#dx1-149022" >109</a>, <a -href="glossaries-user.html#dx1-149041" >110</a>, <a -href="glossaries-user.html#dx1-150033" >111</a>, <a -href="glossaries-user.html#dx1-178027" >112</a> <br /></span> +href="glossaries-user.html#dx1-138007" >111</a>, <a +href="glossaries-user.html#dx1-138022" >112</a>, <a +href="glossaries-user.html#dx1-138041" >113</a>, <a +href="glossaries-user.html#dx1-139033" >114</a>, <a +href="glossaries-user.html#dx1-181027" >115</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-sc-short-desc</span>  <a -href="glossaries-user.html#dx1-149037" >113</a>, <a -href="glossaries-user.html#dx1-179014" >114</a> <br /></span> +href="glossaries-user.html#dx1-138037" >116</a>, <a +href="glossaries-user.html#dx1-182014" >117</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-short</span>  <a -href="glossaries-user.html#dx1-135069" >115</a>, <a -href="glossaries-user.html#dx1-149021" >116</a>, <a -href="glossaries-user.html#dx1-149040" >117</a>, <a -href="glossaries-user.html#dx1-150011" >118</a>, <a -href="glossaries-user.html#dx1-150028" >119</a>, <a -href="glossaries-user.html#dx1-150034" >120</a> <br /></span> +href="glossaries-user.html#dx1-132069" >118</a>, <a +href="glossaries-user.html#dx1-138021" >119</a>, <a +href="glossaries-user.html#dx1-138040" >120</a>, <a +href="glossaries-user.html#dx1-139011" >121</a>, <a +href="glossaries-user.html#dx1-139028" >122</a>, <a +href="glossaries-user.html#dx1-139034" >123</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-short-desc</span>  <a -href="glossaries-user.html#dx1-149036" >121</a>, <a -href="glossaries-user.html#dx1-149052" >122</a>, <a -href="glossaries-user.html#dx1-150030" >123</a> <br /></span> +href="glossaries-user.html#dx1-138036" >124</a>, <a +href="glossaries-user.html#dx1-138052" >125</a>, <a +href="glossaries-user.html#dx1-139030" >126</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-sm-short</span>  <a -href="glossaries-user.html#dx1-149012" >124</a>, <a -href="glossaries-user.html#dx1-149023" >125</a>, <a -href="glossaries-user.html#dx1-149042" >126</a> <br /></span> +href="glossaries-user.html#dx1-138012" >127</a>, <a +href="glossaries-user.html#dx1-138023" >128</a>, <a +href="glossaries-user.html#dx1-138042" >129</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-sm-short-desc</span>  <a -href="glossaries-user.html#dx1-149038" >127</a> <br /></span> +href="glossaries-user.html#dx1-138038" >130</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-sp-short</span>  <a -href="glossaries-user.html#dx1-149024" >128</a>, <a -href="glossaries-user.html#dx1-149028" >129</a>, <a -href="glossaries-user.html#dx1-149043" >130</a> <br /></span> +href="glossaries-user.html#dx1-138024" >131</a>, <a +href="glossaries-user.html#dx1-138028" >132</a>, <a +href="glossaries-user.html#dx1-138043" >133</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-sp-short-desc</span>  <a -href="glossaries-user.html#dx1-149039" >131</a> <br /></span> +href="glossaries-user.html#dx1-138039" >134</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">sc-short-long</span>  <a -href="glossaries-user.html#dx1-149031" >132</a> <br /></span> +href="glossaries-user.html#dx1-138031" >135</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">sc-short-long-desc</span>  <a -href="glossaries-user.html#dx1-149050" >133</a> <br /></span> +href="glossaries-user.html#dx1-138050" >136</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">short-long</span>  <a -href="glossaries-user.html#dx1-149030" >134</a> <br /></span> +href="glossaries-user.html#dx1-138030" >137</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">short-long-desc</span>  <a -href="glossaries-user.html#dx1-149049" >135</a> <br /></span> +href="glossaries-user.html#dx1-138049" >138</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">sm-short-long</span>  <a -href="glossaries-user.html#dx1-149032" >136</a> <br /></span> +href="glossaries-user.html#dx1-138032" >139</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">sm-short-long-desc</span>  <a -href="glossaries-user.html#dx1-149051" >137</a> <br /></span> +href="glossaries-user.html#dx1-138051" >140</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acronymentry</span></span></span>  <a -href="glossaries-user.html#dx1-148010" ><span -class="cmti-10">138</span></a>, <a -href="glossaries-user.html#dx1-149035" >139</a>, <a -href="glossaries-user.html#dx1-149046" >140</a>, <a -href="glossaries-user.html#dx1-149089" >141</a>, <a -href="glossaries-user.html#dx1-150060" >142</a>, <a -href="glossaries-user.html#dx1-150063" >143</a> <br /></span> +href="glossaries-user.html#dx1-137013" ><span +class="cmti-10">141</span></a>, <a +href="glossaries-user.html#dx1-138035" >142</a>, <a +href="glossaries-user.html#dx1-138046" >143</a>, <a +href="glossaries-user.html#dx1-138089" >144</a>, <a +href="glossaries-user.html#dx1-139060" >145</a>, <a +href="glossaries-user.html#dx1-139063" >146</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acronymfont</span></span></span>  <a -href="glossaries-user.html#dx1-98004" >144</a>, <a -href="glossaries-user.html#dx1-147054" >145</a>, <a -href="glossaries-user.html#dx1-149002" ><span -class="cmti-10">146</span></a>, <a -href="glossaries-user.html#dx1-149005" >147</a>, <a -href="glossaries-user.html#dx1-149015" >148</a>, <a -href="glossaries-user.html#dx1-149026" >149</a>, <a -href="glossaries-user.html#dx1-149091" >150</a>, <a -href="glossaries-user.html#dx1-150014" >151</a>, <a -href="glossaries-user.html#dx1-150076" >152</a>, <a -href="glossaries-user.html#dx1-179020" >153</a>, <a -href="glossaries-user.html#dx1-179023" >154</a> <br /></span> -<span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\acronymname</span></span></span>  <a -href="glossaries-user.html#dx1-14025" >155</a>, <a -href="glossaries-user.html#dx1-147001" >156</a> <br /></span> +href="glossaries-user.html#dx1-99004" >147</a>, <a +href="glossaries-user.html#dx1-136007" >148</a>, <a +href="glossaries-user.html#dx1-138002" ><span +class="cmti-10">149</span></a>, <a +href="glossaries-user.html#dx1-138005" >150</a>, <a +href="glossaries-user.html#dx1-138015" >151</a>, <a +href="glossaries-user.html#dx1-138026" >152</a>, <a +href="glossaries-user.html#dx1-138091" >153</a>, <a +href="glossaries-user.html#dx1-139014" >154</a>, <a +href="glossaries-user.html#dx1-139076" >155</a>, <a +href="glossaries-user.html#dx1-182020" >156</a>, <a +href="glossaries-user.html#dx1-182023" >157</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\acronymname</span></span></span>  <a +href="glossaries-user.html#dx1-14025" >158</a>, <a +href="glossaries-user.html#dx1-135001" >159</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acronymsort</span></span></span>  <a -href="glossaries-user.html#dx1-148012" ><span -class="cmti-10">157</span></a>, <a -href="glossaries-user.html#dx1-149034" >158</a>, <a -href="glossaries-user.html#dx1-149047" >159</a>, <a -href="glossaries-user.html#dx1-149088" >160</a>, <a -href="glossaries-user.html#dx1-150057" >161</a> <br /></span> +href="glossaries-user.html#dx1-137015" ><span +class="cmti-10">160</span></a>, <a +href="glossaries-user.html#dx1-138034" >161</a>, <a +href="glossaries-user.html#dx1-138047" >162</a>, <a +href="glossaries-user.html#dx1-138088" >163</a>, <a +href="glossaries-user.html#dx1-139057" >164</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acronymtype</span></span></span>  <a -href="glossaries-user.html#dx1-43007" >162</a>, <a -href="glossaries-user.html#dx1-83002" >163</a>, <a -href="glossaries-user.html#dx1-90006" >164</a>, <a -href="glossaries-user.html#dx1-90014" >165</a>, <a -href="glossaries-user.html#dx1-90019" >166</a>, <a -href="glossaries-user.html#dx1-137005" >167</a>, <a -href="glossaries-user.html#dx1-146018" ><span -class="cmti-10">168</span></a>, <a -href="glossaries-user.html#dx1-147008" >169</a>, <a -href="glossaries-user.html#dx1-151002" >170</a>, <a -href="glossaries-user.html#dx1-151004" >171</a>, <a -href="glossaries-user.html#dx1-151008" >172</a>, <a -href="glossaries-user.html#dx1-90008" >173</a>, <a -href="glossaries-user.html#dx1-122022" >174</a> <br /></span> +href="glossaries-user.html#dx1-44007" >165</a>, <a +href="glossaries-user.html#dx1-84002" >166</a>, <a +href="glossaries-user.html#dx1-91006" >167</a>, <a +href="glossaries-user.html#dx1-91014" >168</a>, <a +href="glossaries-user.html#dx1-91019" >169</a>, <a +href="glossaries-user.html#dx1-135010" >170</a>, <a +href="glossaries-user.html#dx1-140002" >171</a>, <a +href="glossaries-user.html#dx1-140004" >172</a>, <a +href="glossaries-user.html#dx1-140008" >173</a>, <a +href="glossaries-user.html#dx1-145018" ><span +class="cmti-10">174</span></a>, <a +href="glossaries-user.html#dx1-146006" >175</a>, <a +href="glossaries-user.html#dx1-91008" >176</a>, <a +href="glossaries-user.html#dx1-123022" >177</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ACRshort</span></span></span>  <a -href="glossaries-user.html#dx1-147058" ><span -class="cmti-10">175</span></a> <br /></span> +href="glossaries-user.html#dx1-136011" ><span +class="cmti-10">178</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acrshort</span></span></span>  <a -href="glossaries-user.html#dx1-147057" ><span -class="cmti-10">176</span></a>, <a -href="glossaries-user.html#dx1-147089" >177</a> <br /></span> +href="glossaries-user.html#dx1-136010" ><span +class="cmti-10">179</span></a>, <a +href="glossaries-user.html#dx1-136042" >180</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrshort</span></span></span>  <a -href="glossaries-user.html#dx1-147052" ><span -class="cmti-10">178</span></a>, <a -href="glossaries-user.html#dx1-147087" >179</a>, <a -href="glossaries-user.html#dx1-150075" >180</a>, <a -href="glossaries-user.html#dx1-178035" >181</a>, <a -href="glossaries-user.html#dx1-179036" >182</a>, <a -href="glossaries-user.html#dx1-186014" >183</a>, <a -href="glossaries-user.html#dx1-4004" >184</a> <br /></span> +href="glossaries-user.html#dx1-136005" ><span +class="cmti-10">181</span></a>, <a +href="glossaries-user.html#dx1-136040" >182</a>, <a +href="glossaries-user.html#dx1-139075" >183</a>, <a +href="glossaries-user.html#dx1-181035" >184</a>, <a +href="glossaries-user.html#dx1-182036" >185</a>, <a +href="glossaries-user.html#dx1-189014" >186</a>, <a +href="glossaries-user.html#dx1-4004" >187</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ACRshortpl</span></span></span>  <a -href="glossaries-user.html#dx1-147061" ><span -class="cmti-10">185</span></a> <br /></span> +href="glossaries-user.html#dx1-136014" ><span +class="cmti-10">188</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acrshortpl</span></span></span>  <a -href="glossaries-user.html#dx1-147060" ><span -class="cmti-10">186</span></a>, <a -href="glossaries-user.html#dx1-147093" >187</a> <br /></span> +href="glossaries-user.html#dx1-136013" ><span +class="cmti-10">189</span></a>, <a +href="glossaries-user.html#dx1-136046" >190</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acrshortpl</span></span></span>  <a -href="glossaries-user.html#dx1-147059" ><span -class="cmti-10">188</span></a>, <a -href="glossaries-user.html#dx1-147091" >189</a> <br /></span> +href="glossaries-user.html#dx1-136012" ><span +class="cmti-10">191</span></a>, <a +href="glossaries-user.html#dx1-136044" >192</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acs</span></span></span>  <a -href="glossaries-user.html#dx1-147088" >190</a> <br /></span> +href="glossaries-user.html#dx1-136041" >193</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acs</span></span></span>  <a -href="glossaries-user.html#dx1-147086" >191</a> <br /></span> +href="glossaries-user.html#dx1-136039" >194</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Acsp</span></span></span>  <a -href="glossaries-user.html#dx1-147092" >192</a> <br /></span> +href="glossaries-user.html#dx1-136045" >195</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\acsp</span></span></span>  <a -href="glossaries-user.html#dx1-147090" >193</a> <br /></span> +href="glossaries-user.html#dx1-136043" >196</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\addcontentsline</span></span></span>  <a -href="glossaries-user.html#dx1-40003" >194</a> <br /></span> +href="glossaries-user.html#dx1-41003" >197</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\alsoname</span></span></span>  <a -href="glossaries-user.html#dx1-204001" >195</a> <br /></span> +href="glossaries-user.html#dx1-207001" >198</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\altnewglossary</span></span></span>  <a -href="glossaries-user.html#dx1-146008" ><span -class="cmti-10">196</span></a> <br /></span> +href="glossaries-user.html#dx1-145008" ><span +class="cmti-10">199</span></a> <br /></span> <span class="index-item"><span class="cmss-10">amsgen </span>package  <a -href="glossaries-user.html#dx1-13" >197</a>, <a -href="glossaries-user.html#dx1-14" >198</a>, <a -href="glossaries-user.html#dx1-15" >199</a>, <a -href="glossaries-user.html#dx1-150081" >200</a>, <a -href="glossaries-user.html#dx1-150082" >201</a> <br /></span> +href="glossaries-user.html#dx1-13" >200</a>, <a +href="glossaries-user.html#dx1-14" >201</a>, <a +href="glossaries-user.html#dx1-15" >202</a>, <a +href="glossaries-user.html#dx1-139081" >203</a>, <a +href="glossaries-user.html#dx1-139082" >204</a> <br /></span> <span class="index-item"><span class="cmss-10">amsmath </span>package  <a -href="glossaries-user.html#dx1-133006" >202</a>, <a -href="glossaries-user.html#dx1-153021" >203</a> <br /></span> +href="glossaries-user.html#dx1-130006" >205</a>, <a +href="glossaries-user.html#dx1-142023" >206</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\andname</span></span></span>  <a -href="glossaries-user.html#dx1-139010" >204</a> <br /></span> +href="glossaries-user.html#dx1-148010" >207</a> <br /></span> <span class="index-item"><span class="cmtt-10">arara</span>  <a -href="glossaries-user.html#dx1-4018" >205</a>, <a -href="glossaries-user.html#dx1-7041" >206</a>, <a -href="glossaries-user.html#dx1-9034" >207</a>, <a -href="glossaries-user.html#dx1-11083" >208</a>, <a -href="glossaries-user.html#dx1-16020" >209</a>, <a -href="glossaries-user.html#dx1-16021" >210</a>, <a -href="glossaries-user.html#dx1-22010" >211</a>, <a -href="glossaries-user.html#dx1-24007" >212</a>, <a -href="glossaries-user.html#dx1-190039" >213</a> <br /></span> +href="glossaries-user.html#dx1-4018" >208</a>, <a +href="glossaries-user.html#dx1-7041" >209</a>, <a +href="glossaries-user.html#dx1-9034" >210</a>, <a +href="glossaries-user.html#dx1-11083" >211</a>, <a +href="glossaries-user.html#dx1-16020" >212</a>, <a +href="glossaries-user.html#dx1-16021" >213</a>, <a +href="glossaries-user.html#dx1-22010" >214</a>, <a +href="glossaries-user.html#dx1-24007" >215</a>, <a +href="glossaries-user.html#dx1-193039" >216</a> <br /></span> <span class="index-item"><span class="cmss-10">array </span>package  <a -href="glossaries-user.html#dx1-159006" >214</a>, <a -href="glossaries-user.html#dx1-162006" >215</a> <br /></span> +href="glossaries-user.html#dx1-158006" >217</a>, <a +href="glossaries-user.html#dx1-161006" >218</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\AtBeginDocument</span></span></span>  <a -href="glossaries-user.html#dx1-122010" >216</a> <br /></span> +href="glossaries-user.html#dx1-123010" >219</a> <br /></span> <span class="index-item"><span class="cmtt-10">atom</span>  <a -href="glossaries-user.html#dx1-37006" >217</a> <br /></span> +href="glossaries-user.html#dx1-38006" >220</a> <br /></span> <span class="index-item">auto-completion  <a -href="glossaries-user.html#dx1-35002" >218</a> <br /></span> +href="glossaries-user.html#dx1-35002" >221</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">B</span> -<span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\babel</span></span></span>  <a -href="glossaries-user.html#dx1-79019" >219</a> <br /></span> <span class="index-item"><span class="cmss-10">babel </span>package  <a -href="glossaries-user.html#dx1-7018" >220</a>, <a -href="glossaries-user.html#dx1-13031" >221</a>, <a -href="glossaries-user.html#dx1-13042" >222</a>, <a -href="glossaries-user.html#dx1-13046" >223</a>, <a -href="glossaries-user.html#dx1-14001" >224</a>, <a -href="glossaries-user.html#dx1-14003" >225</a>, <a -href="glossaries-user.html#dx1-14005" >226</a>, <a -href="glossaries-user.html#dx1-14007" >227</a>, <a -href="glossaries-user.html#dx1-14016" >228</a>, <a -href="glossaries-user.html#dx1-14018" >229</a>, <a -href="glossaries-user.html#dx1-14019" >230</a>, <a -href="glossaries-user.html#dx1-14022" >231</a>, <a -href="glossaries-user.html#dx1-14034" >232</a>, <a -href="glossaries-user.html#dx1-14037" >233</a>, <a -href="glossaries-user.html#dx1-14040" >234</a>, <a -href="glossaries-user.html#dx1-14042" >235</a>, <a -href="glossaries-user.html#dx1-14049" >236</a>, <a -href="glossaries-user.html#dx1-32002" >237</a>, <a -href="glossaries-user.html#dx1-32007" >238</a>, <a -href="glossaries-user.html#dx1-32012" >239</a>, <a -href="glossaries-user.html#dx1-32014" >240</a>, <a -href="glossaries-user.html#dx1-32016" >241</a>, <a -href="glossaries-user.html#dx1-32021" >242</a>, <a -href="glossaries-user.html#dx1-32027" >243</a>, <a -href="glossaries-user.html#dx1-32031" >244</a>, <a -href="glossaries-user.html#dx1-112009" >245</a>, <a -href="glossaries-user.html#dx1-122012" >246</a>, <a -href="glossaries-user.html#dx1-125007" >247</a>, <a -href="glossaries-user.html#dx1-146025" >248</a>, <a -href="glossaries-user.html#dx1-192017" >249</a> <br /></span> +href="glossaries-user.html#dx1-7018" >222</a>, <a +href="glossaries-user.html#dx1-13031" >223</a>, <a +href="glossaries-user.html#dx1-13042" >224</a>, <a +href="glossaries-user.html#dx1-13046" >225</a>, <a +href="glossaries-user.html#dx1-14001" >226</a>, <a +href="glossaries-user.html#dx1-14003" >227</a>, <a +href="glossaries-user.html#dx1-14005" >228</a>, <a +href="glossaries-user.html#dx1-14007" >229</a>, <a +href="glossaries-user.html#dx1-14016" >230</a>, <a +href="glossaries-user.html#dx1-14018" >231</a>, <a +href="glossaries-user.html#dx1-14019" >232</a>, <a +href="glossaries-user.html#dx1-14022" >233</a>, <a +href="glossaries-user.html#dx1-14034" >234</a>, <a +href="glossaries-user.html#dx1-14037" >235</a>, <a +href="glossaries-user.html#dx1-14040" >236</a>, <a +href="glossaries-user.html#dx1-14042" >237</a>, <a +href="glossaries-user.html#dx1-14049" >238</a>, <a +href="glossaries-user.html#dx1-32002" >239</a>, <a +href="glossaries-user.html#dx1-32007" >240</a>, <a +href="glossaries-user.html#dx1-32012" >241</a>, <a +href="glossaries-user.html#dx1-32014" >242</a>, <a +href="glossaries-user.html#dx1-32016" >243</a>, <a +href="glossaries-user.html#dx1-32021" >244</a>, <a +href="glossaries-user.html#dx1-32027" >245</a>, <a +href="glossaries-user.html#dx1-32031" >246</a>, <a +href="glossaries-user.html#dx1-80019" >247</a>, <a +href="glossaries-user.html#dx1-113014" >248</a>, <a +href="glossaries-user.html#dx1-123012" >249</a>, <a +href="glossaries-user.html#dx1-126009" >250</a>, <a +href="glossaries-user.html#dx1-145025" >251</a>, <a +href="glossaries-user.html#dx1-195017" >252</a> <br /></span> <span class="index-item"><span class="cmss-10">beamer </span>class  <a -href="glossaries-user.html#dx1-133004" >250</a>, <a -href="glossaries-user.html#dx1-133010" >251</a>, <a -href="glossaries-user.html#dx1-153014" >252</a>, <a -href="glossaries-user.html#dx1-153016" >253</a> <br /></span> +href="glossaries-user.html#dx1-130004" >253</a>, <a +href="glossaries-user.html#dx1-130010" >254</a>, <a +href="glossaries-user.html#dx1-142016" >255</a>, <a +href="glossaries-user.html#dx1-142018" >256</a> <br /></span> <span class="index-item"><span class="cmss-10">beamer </span>package  <a -href="glossaries-user.html#dx1-14048" >254</a> <br /></span> +href="glossaries-user.html#dx1-14048" >257</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\BeginAccSupp</span></span></span>  <a -href="glossaries-user.html#dx1-172072" >255</a>, <a -href="glossaries-user.html#dx1-172074" >256</a>, <a -href="glossaries-user.html#dx1-224003" >257</a>, <a -href="glossaries-user.html#dx1-224016" >258</a> <br /></span> +href="glossaries-user.html#dx1-175072" >258</a>, <a +href="glossaries-user.html#dx1-175074" >259</a>, <a +href="glossaries-user.html#dx1-227003" >260</a>, <a +href="glossaries-user.html#dx1-227016" >261</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">bib2gls</span>  <a -href="glossaries-user.html#dx1-2" >259</a>, <a +href="glossaries-user.html#dx1-2" >262</a>, <a href="glossaries-user.html#dx1-3001" ><span -class="cmbx-10">260</span></a>, <a -href="glossaries-user.html#dx1-3007" >261</a>, <a -href="glossaries-user.html#dx1-3010" >262</a>, <a -href="glossaries-user.html#dx1-3012" >263</a>, <a -href="glossaries-user.html#dx1-9001" >264</a>, <a -href="glossaries-user.html#dx1-9010" >265</a>, <a -href="glossaries-user.html#dx1-9019" >266</a>, <a -href="glossaries-user.html#dx1-9030" >267</a>, <a -href="glossaries-user.html#dx1-9039" >268</a>, <a -href="glossaries-user.html#dx1-9040" >269</a>, <a -href="glossaries-user.html#dx1-10007" >270</a>, <a -href="glossaries-user.html#dx1-11008" >271</a>, <a -href="glossaries-user.html#dx1-11020" >272</a>, <a -href="glossaries-user.html#dx1-11024" >273</a>, <a -href="glossaries-user.html#dx1-11029" >274</a>, <a -href="glossaries-user.html#dx1-11031" >275</a>, <a -href="glossaries-user.html#dx1-11032" >276</a>, <a -href="glossaries-user.html#dx1-11044" >277</a>, <a -href="glossaries-user.html#dx1-11047" >278</a>, <a -href="glossaries-user.html#dx1-11057" >279</a>, <a -href="glossaries-user.html#dx1-11069" >280</a>, <a -href="glossaries-user.html#dx1-11071" >281</a>, <a -href="glossaries-user.html#dx1-11094" >282</a>, <a -href="glossaries-user.html#dx1-12005" >283</a>, <a -href="glossaries-user.html#dx1-13004" >284</a>, <a -href="glossaries-user.html#dx1-13009" >285</a>, <a -href="glossaries-user.html#dx1-13012" >286</a>, <a -href="glossaries-user.html#dx1-13020" >287</a>, <a -href="glossaries-user.html#dx1-13024" >288</a>, <a -href="glossaries-user.html#dx1-14053" >289</a>, <a -href="glossaries-user.html#dx1-14057" >290</a>, <a -href="glossaries-user.html#dx1-16003" >291</a>, <a -href="glossaries-user.html#dx1-16011" >292</a>, <a -href="glossaries-user.html#dx1-16012" >293</a>, <a -href="glossaries-user.html#dx1-16014" >294</a>, <a -href="glossaries-user.html#dx1-16017" >295</a>, <a -href="glossaries-user.html#dx1-16073" >296</a>, <a -href="glossaries-user.html#dx1-16074" >297</a>, <a -href="glossaries-user.html#dx1-16075" >298</a>, <a -href="glossaries-user.html#dx1-21003" >299</a>, <a -href="glossaries-user.html#dx1-24001" >300</a>, <a -href="glossaries-user.html#dx1-24005" >301</a>, <a -href="glossaries-user.html#dx1-24008" >302</a>, <a -href="glossaries-user.html#dx1-24011" >303</a>, <a -href="glossaries-user.html#dx1-24013" >304</a>, <a -href="glossaries-user.html#dx1-24021" >305</a>, <a -href="glossaries-user.html#dx1-31008" >306</a>, <a -href="glossaries-user.html#dx1-31011" >307</a>, <a -href="glossaries-user.html#dx1-35004" >308</a>, <a -href="glossaries-user.html#dx1-35005" >309</a>, <a -href="glossaries-user.html#dx1-45008" >310</a>, <a -href="glossaries-user.html#dx1-59002" >311</a>, <a -href="glossaries-user.html#dx1-63004" >312</a>, <a -href="glossaries-user.html#dx1-67001" >313</a>, <a -href="glossaries-user.html#dx1-67002" >314</a>, <a -href="glossaries-user.html#dx1-67003" >315</a>, <a -href="glossaries-user.html#dx1-67006" >316</a>, <a -href="glossaries-user.html#dx1-70001" >317</a>, <a -href="glossaries-user.html#dx1-71006" >318</a>, <a -href="glossaries-user.html#dx1-74007" >319</a>, <a -href="glossaries-user.html#dx1-109001" >320</a>, <a -href="glossaries-user.html#dx1-112081" >321</a>, <a -href="glossaries-user.html#dx1-112082" >322</a>, <a -href="glossaries-user.html#dx1-112135" >323</a>, <a -href="glossaries-user.html#dx1-112143" >324</a>, <a -href="glossaries-user.html#dx1-112144" >325</a>, <a -href="glossaries-user.html#dx1-122009" >326</a>, <a -href="glossaries-user.html#dx1-127013" >327</a>, <a -href="glossaries-user.html#dx1-127015" >328</a>, <a -href="glossaries-user.html#dx1-128008" >329</a>, <a -href="glossaries-user.html#dx1-128009" >330</a>, <a -href="glossaries-user.html#dx1-128018" >331</a>, <a -href="glossaries-user.html#dx1-128019" >332</a>, <a -href="glossaries-user.html#dx1-130016" >333</a>, <a -href="glossaries-user.html#dx1-130017" >334</a>, <a -href="glossaries-user.html#dx1-137006" >335</a>, <a -href="glossaries-user.html#dx1-137011" >336</a>, <a -href="glossaries-user.html#dx1-137013" >337</a>, <a -href="glossaries-user.html#dx1-137018" >338</a>, <a -href="glossaries-user.html#dx1-137019" >339</a>, <a -href="glossaries-user.html#dx1-141044" >340</a>, <a -href="glossaries-user.html#dx1-141045" >341</a>, <a -href="glossaries-user.html#dx1-146012" >342</a>, <a -href="glossaries-user.html#dx1-154019" >343</a>, <a -href="glossaries-user.html#dx1-154020" >344</a>, <a -href="glossaries-user.html#dx1-173001" >345</a>, <a -href="glossaries-user.html#dx1-175046" >346</a>, <a -href="glossaries-user.html#dx1-175047" >347</a>, <a -href="glossaries-user.html#dx1-175050" >348</a>, <a -href="glossaries-user.html#dx1-176003" >349</a>, <a -href="glossaries-user.html#dx1-176012" >350</a>, <a -href="glossaries-user.html#dx1-176013" >351</a>, <a -href="glossaries-user.html#dx1-176028" >352</a>, <a -href="glossaries-user.html#dx1-176029" >353</a>, <a -href="glossaries-user.html#dx1-176032" >354</a>, <a -href="glossaries-user.html#dx1-176034" >355</a>, <a -href="glossaries-user.html#dx1-179042" >356</a>, <a -href="glossaries-user.html#dx1-179043" >357</a>, <a -href="glossaries-user.html#dx1-179046" >358</a>, <a -href="glossaries-user.html#dx1-179069" >359</a>, <a -href="glossaries-user.html#dx1-179070" >360</a>, <a -href="glossaries-user.html#dx1-179078" >361</a>, <a -href="glossaries-user.html#dx1-179079" >362</a>, <a -href="glossaries-user.html#dx1-184071" >363</a>, <a -href="glossaries-user.html#dx1-188011" >364</a>, <a -href="glossaries-user.html#dx1-188012" >365</a>, <a -href="glossaries-user.html#dx1-188020" >366</a>, <a -href="glossaries-user.html#dx1-189062" >367</a>, <a -href="glossaries-user.html#dx1-189063" >368</a>, <a -href="glossaries-user.html#dx1-189065" >369</a>, <a -href="glossaries-user.html#dx1-189071" >370</a>, <a -href="glossaries-user.html#dx1-190021" >371</a>, <a -href="glossaries-user.html#dx1-190022" >372</a>, <a -href="glossaries-user.html#dx1-190023" >373</a>, <a -href="glossaries-user.html#dx1-190025" >374</a>, <a -href="glossaries-user.html#dx1-190032" >375</a>, <a -href="glossaries-user.html#dx1-190036" >376</a>, <a -href="glossaries-user.html#dx1-192029" >377</a>, <a -href="glossaries-user.html#dx1-192030" >378</a>, <a -href="glossaries-user.html#dx1-192032" >379</a>, <a -href="glossaries-user.html#dx1-192036" >380</a>, <a -href="glossaries-user.html#dx1-192050" >381</a>, <a -href="glossaries-user.html#dx1-192060" >382</a>, <a -href="glossaries-user.html#dx1-192071" >383</a>, <a -href="glossaries-user.html#dx1-193003" >384</a>, <a -href="glossaries-user.html#dx1-193004" >385</a>, <a -href="glossaries-user.html#dx1-193006" >386</a>, <a -href="glossaries-user.html#dx1-193015" >387</a>, <a -href="glossaries-user.html#dx1-193016" >388</a>, <a -href="glossaries-user.html#dx1-193029" >389</a>, <a -href="glossaries-user.html#dx1-193033" >390</a>, <a -href="glossaries-user.html#dx1-193052" >391</a>, <a -href="glossaries-user.html#dx1-194003" >392</a>, <a -href="glossaries-user.html#dx1-194004" >393</a>, <a -href="glossaries-user.html#dx1-194008" >394</a>, <a -href="glossaries-user.html#dx1-194012" >395</a>, <a -href="glossaries-user.html#dx1-194021" >396</a>, <a -href="glossaries-user.html#dx1-197005" >397</a>, <a -href="glossaries-user.html#dx1-197006" >398</a>, <a -href="glossaries-user.html#dx1-197009" >399</a>, <a -href="glossaries-user.html#dx1-197020" >400</a>, <a -href="glossaries-user.html#dx1-197029" >401</a>, <a -href="glossaries-user.html#dx1-197031" >402</a>, <a -href="glossaries-user.html#dx1-197035" >403</a>, <a -href="glossaries-user.html#dx1-198017" >404</a>, <a -href="glossaries-user.html#dx1-198018" >405</a>, <a -href="glossaries-user.html#dx1-198020" >406</a>, <a -href="glossaries-user.html#dx1-198041" >407</a>, <a -href="glossaries-user.html#dx1-200030" >408</a>, <a -href="glossaries-user.html#dx1-200037" >409</a>, <a -href="glossaries-user.html#dx1-200041" >410</a>, <a -href="glossaries-user.html#dx1-200042" >411</a>, <a -href="glossaries-user.html#dx1-200053" >412</a>, <a -href="glossaries-user.html#dx1-200055" >413</a>, <a -href="glossaries-user.html#dx1-200056" >414</a>, <a -href="glossaries-user.html#dx1-200059" >415</a>, <a -href="glossaries-user.html#dx1-200064" >416</a>, <a -href="glossaries-user.html#dx1-200067" >417</a>, <a -href="glossaries-user.html#dx1-200072" >418</a>, <a -href="glossaries-user.html#dx1-200074" >419</a>, <a -href="glossaries-user.html#dx1-200076" >420</a>, <a -href="glossaries-user.html#dx1-200081" >421</a>, <a -href="glossaries-user.html#dx1-200084" >422</a>, <a -href="glossaries-user.html#dx1-200085" >423</a>, <a -href="glossaries-user.html#dx1-200096" >424</a>, <a -href="glossaries-user.html#dx1-201002" >425</a>, <a -href="glossaries-user.html#dx1-202048" >426</a>, <a -href="glossaries-user.html#dx1-202049" >427</a>, <a -href="glossaries-user.html#dx1-202052" >428</a>, <a -href="glossaries-user.html#dx1-202056" >429</a>, <a -href="glossaries-user.html#dx1-202077" >430</a>, <a -href="glossaries-user.html#dx1-202080" >431</a>, <a -href="glossaries-user.html#dx1-202103" >432</a>, <a -href="glossaries-user.html#dx1-204017" >433</a>, <a -href="glossaries-user.html#dx1-204018" >434</a>, <a -href="glossaries-user.html#dx1-204022" >435</a>, <a -href="glossaries-user.html#dx1-206005" >436</a>, <a -href="glossaries-user.html#dx1-206006" >437</a>, <a -href="glossaries-user.html#dx1-206009" >438</a>, <a -href="glossaries-user.html#dx1-206021" >439</a>, <a -href="glossaries-user.html#dx1-211035" >440</a>, <a -href="glossaries-user.html#dx1-211036" >441</a>, <a -href="glossaries-user.html#dx1-211040" >442</a>, <a -href="glossaries-user.html#dx1-211042" >443</a>, <a -href="glossaries-user.html#dx1-211051" >444</a>, <a -href="glossaries-user.html#dx1-211053" >445</a>, <a -href="glossaries-user.html#dx1-211054" >446</a>, <a -href="glossaries-user.html#dx1-211069" >447</a>, <a -href="glossaries-user.html#dx1-211088" >448</a>, <a -href="glossaries-user.html#dx1-212005" >449</a>, <a -href="glossaries-user.html#dx1-212006" >450</a>, <a -href="glossaries-user.html#dx1-212010" >451</a>, <a -href="glossaries-user.html#dx1-214009" >452</a>, <a -href="glossaries-user.html#dx1-214010" >453</a>, <a -href="glossaries-user.html#dx1-214014" >454</a>, <a -href="glossaries-user.html#dx1-214015" >455</a>, <a -href="glossaries-user.html#dx1-214018" >456</a>, <a -href="glossaries-user.html#dx1-214021" >457</a>, <a -href="glossaries-user.html#dx1-214023" >458</a>, <a -href="glossaries-user.html#dx1-214028" >459</a>, <a -href="glossaries-user.html#dx1-214033" >460</a>, <a -href="glossaries-user.html#dx1-214036" >461</a>, <a -href="glossaries-user.html#dx1-214042" >462</a>, <a -href="glossaries-user.html#dx1-214046" >463</a>, <a -href="glossaries-user.html#dx1-219002" >464</a>, <a -href="glossaries-user.html#dx1-220018" >465</a>, <a -href="glossaries-user.html#dx1-220019" >466</a>, <a -href="glossaries-user.html#dx1-220023" >467</a>, <a -href="glossaries-user.html#dx1-220029" >468</a>, <a -href="glossaries-user.html#dx1-220032" >469</a>, <a -href="glossaries-user.html#dx1-220037" >470</a>, <a -href="glossaries-user.html#dx1-223005" >471</a>, <a -href="glossaries-user.html#dx1-223006" >472</a>, <a -href="glossaries-user.html#dx1-223007" >473</a>, <a -href="glossaries-user.html#dx1-223010" >474</a>, <a -href="glossaries-user.html#dx1-223016" >475</a>, <a -href="glossaries-user.html#dx1-223017" >476</a>, <a -href="glossaries-user.html#dx1-223024" >477</a>, <a -href="glossaries-user.html#dx1-226004" >478</a>, <a -href="glossaries-user.html#dx1-226005" >479</a>, <a -href="glossaries-user.html#dx1-192042" >480</a> <br /></span> +class="cmbx-10">263</span></a>, <a +href="glossaries-user.html#dx1-3007" >264</a>, <a +href="glossaries-user.html#dx1-3010" >265</a>, <a +href="glossaries-user.html#dx1-3012" >266</a>, <a +href="glossaries-user.html#dx1-9001" >267</a>, <a +href="glossaries-user.html#dx1-9010" >268</a>, <a +href="glossaries-user.html#dx1-9019" >269</a>, <a +href="glossaries-user.html#dx1-9030" >270</a>, <a +href="glossaries-user.html#dx1-9039" >271</a>, <a +href="glossaries-user.html#dx1-9046" >272</a>, <a +href="glossaries-user.html#dx1-9053" >273</a>, <a +href="glossaries-user.html#dx1-9056" >274</a>, <a +href="glossaries-user.html#dx1-10007" >275</a>, <a +href="glossaries-user.html#dx1-11008" >276</a>, <a +href="glossaries-user.html#dx1-11020" >277</a>, <a +href="glossaries-user.html#dx1-11024" >278</a>, <a +href="glossaries-user.html#dx1-11029" >279</a>, <a +href="glossaries-user.html#dx1-11031" >280</a>, <a +href="glossaries-user.html#dx1-11032" >281</a>, <a +href="glossaries-user.html#dx1-11044" >282</a>, <a +href="glossaries-user.html#dx1-11047" >283</a>, <a +href="glossaries-user.html#dx1-11057" >284</a>, <a +href="glossaries-user.html#dx1-11069" >285</a>, <a +href="glossaries-user.html#dx1-11071" >286</a>, <a +href="glossaries-user.html#dx1-11094" >287</a>, <a +href="glossaries-user.html#dx1-12005" >288</a>, <a +href="glossaries-user.html#dx1-13004" >289</a>, <a +href="glossaries-user.html#dx1-13009" >290</a>, <a +href="glossaries-user.html#dx1-13012" >291</a>, <a +href="glossaries-user.html#dx1-13020" >292</a>, <a +href="glossaries-user.html#dx1-13024" >293</a>, <a +href="glossaries-user.html#dx1-14053" >294</a>, <a +href="glossaries-user.html#dx1-14057" >295</a>, <a +href="glossaries-user.html#dx1-16003" >296</a>, <a +href="glossaries-user.html#dx1-16011" >297</a>, <a +href="glossaries-user.html#dx1-16012" >298</a>, <a +href="glossaries-user.html#dx1-16014" >299</a>, <a +href="glossaries-user.html#dx1-16017" >300</a>, <a +href="glossaries-user.html#dx1-16073" >301</a>, <a +href="glossaries-user.html#dx1-16074" >302</a>, <a +href="glossaries-user.html#dx1-16075" >303</a>, <a +href="glossaries-user.html#dx1-21003" >304</a>, <a +href="glossaries-user.html#dx1-24001" >305</a>, <a +href="glossaries-user.html#dx1-24005" >306</a>, <a +href="glossaries-user.html#dx1-24008" >307</a>, <a +href="glossaries-user.html#dx1-24011" >308</a>, <a +href="glossaries-user.html#dx1-24013" >309</a>, <a +href="glossaries-user.html#dx1-24021" >310</a>, <a +href="glossaries-user.html#dx1-31008" >311</a>, <a +href="glossaries-user.html#dx1-31011" >312</a>, <a +href="glossaries-user.html#dx1-35005" >313</a>, <a +href="glossaries-user.html#dx1-35006" >314</a>, <a +href="glossaries-user.html#dx1-46008" >315</a>, <a +href="glossaries-user.html#dx1-60002" >316</a>, <a +href="glossaries-user.html#dx1-64004" >317</a>, <a +href="glossaries-user.html#dx1-66002" >318</a>, <a +href="glossaries-user.html#dx1-67004" >319</a>, <a +href="glossaries-user.html#dx1-68001" >320</a>, <a +href="glossaries-user.html#dx1-68002" >321</a>, <a +href="glossaries-user.html#dx1-68003" >322</a>, <a +href="glossaries-user.html#dx1-68006" >323</a>, <a +href="glossaries-user.html#dx1-71001" >324</a>, <a +href="glossaries-user.html#dx1-72006" >325</a>, <a +href="glossaries-user.html#dx1-75007" >326</a>, <a +href="glossaries-user.html#dx1-110001" >327</a>, <a +href="glossaries-user.html#dx1-113001" >328</a>, <a +href="glossaries-user.html#dx1-113003" >329</a>, <a +href="glossaries-user.html#dx1-113094" >330</a>, <a +href="glossaries-user.html#dx1-113095" >331</a>, <a +href="glossaries-user.html#dx1-113146" >332</a>, <a +href="glossaries-user.html#dx1-113155" >333</a>, <a +href="glossaries-user.html#dx1-113163" >334</a>, <a +href="glossaries-user.html#dx1-113164" >335</a>, <a +href="glossaries-user.html#dx1-123009" >336</a>, <a +href="glossaries-user.html#dx1-142012" >337</a>, <a +href="glossaries-user.html#dx1-143019" >338</a>, <a +href="glossaries-user.html#dx1-143020" >339</a>, <a +href="glossaries-user.html#dx1-144010" >340</a>, <a +href="glossaries-user.html#dx1-144015" >341</a>, <a +href="glossaries-user.html#dx1-144022" >342</a>, <a +href="glossaries-user.html#dx1-144051" >343</a>, <a +href="glossaries-user.html#dx1-144052" >344</a>, <a +href="glossaries-user.html#dx1-145012" >345</a>, <a +href="glossaries-user.html#dx1-146007" >346</a>, <a +href="glossaries-user.html#dx1-146012" >347</a>, <a +href="glossaries-user.html#dx1-146014" >348</a>, <a +href="glossaries-user.html#dx1-146019" >349</a>, <a +href="glossaries-user.html#dx1-146020" >350</a>, <a +href="glossaries-user.html#dx1-147030" >351</a>, <a +href="glossaries-user.html#dx1-149013" >352</a>, <a +href="glossaries-user.html#dx1-149015" >353</a>, <a +href="glossaries-user.html#dx1-150007" >354</a>, <a +href="glossaries-user.html#dx1-150008" >355</a>, <a +href="glossaries-user.html#dx1-150017" >356</a>, <a +href="glossaries-user.html#dx1-150018" >357</a>, <a +href="glossaries-user.html#dx1-152016" >358</a>, <a +href="glossaries-user.html#dx1-152017" >359</a>, <a +href="glossaries-user.html#dx1-165001" >360</a>, <a +href="glossaries-user.html#dx1-172013" >361</a>, <a +href="glossaries-user.html#dx1-176001" >362</a>, <a +href="glossaries-user.html#dx1-178046" >363</a>, <a +href="glossaries-user.html#dx1-178047" >364</a>, <a +href="glossaries-user.html#dx1-178050" >365</a>, <a +href="glossaries-user.html#dx1-179003" >366</a>, <a +href="glossaries-user.html#dx1-179012" >367</a>, <a +href="glossaries-user.html#dx1-179013" >368</a>, <a +href="glossaries-user.html#dx1-179028" >369</a>, <a +href="glossaries-user.html#dx1-179029" >370</a>, <a +href="glossaries-user.html#dx1-179032" >371</a>, <a +href="glossaries-user.html#dx1-179034" >372</a>, <a +href="glossaries-user.html#dx1-182042" >373</a>, <a +href="glossaries-user.html#dx1-182043" >374</a>, <a +href="glossaries-user.html#dx1-182046" >375</a>, <a +href="glossaries-user.html#dx1-182069" >376</a>, <a +href="glossaries-user.html#dx1-182070" >377</a>, <a +href="glossaries-user.html#dx1-182078" >378</a>, <a +href="glossaries-user.html#dx1-182079" >379</a>, <a +href="glossaries-user.html#dx1-187071" >380</a>, <a +href="glossaries-user.html#dx1-191011" >381</a>, <a +href="glossaries-user.html#dx1-191012" >382</a>, <a +href="glossaries-user.html#dx1-191020" >383</a>, <a +href="glossaries-user.html#dx1-192062" >384</a>, <a +href="glossaries-user.html#dx1-192063" >385</a>, <a +href="glossaries-user.html#dx1-192065" >386</a>, <a +href="glossaries-user.html#dx1-192071" >387</a>, <a +href="glossaries-user.html#dx1-193021" >388</a>, <a +href="glossaries-user.html#dx1-193022" >389</a>, <a +href="glossaries-user.html#dx1-193023" >390</a>, <a +href="glossaries-user.html#dx1-193025" >391</a>, <a +href="glossaries-user.html#dx1-193032" >392</a>, <a +href="glossaries-user.html#dx1-193036" >393</a>, <a +href="glossaries-user.html#dx1-195029" >394</a>, <a +href="glossaries-user.html#dx1-195030" >395</a>, <a +href="glossaries-user.html#dx1-195032" >396</a>, <a +href="glossaries-user.html#dx1-195036" >397</a>, <a +href="glossaries-user.html#dx1-195050" >398</a>, <a +href="glossaries-user.html#dx1-195060" >399</a>, <a +href="glossaries-user.html#dx1-195071" >400</a>, <a +href="glossaries-user.html#dx1-196003" >401</a>, <a +href="glossaries-user.html#dx1-196004" >402</a>, <a +href="glossaries-user.html#dx1-196006" >403</a>, <a +href="glossaries-user.html#dx1-196015" >404</a>, <a +href="glossaries-user.html#dx1-196016" >405</a>, <a +href="glossaries-user.html#dx1-196029" >406</a>, <a +href="glossaries-user.html#dx1-196033" >407</a>, <a +href="glossaries-user.html#dx1-196052" >408</a>, <a +href="glossaries-user.html#dx1-197003" >409</a>, <a +href="glossaries-user.html#dx1-197004" >410</a>, <a +href="glossaries-user.html#dx1-197008" >411</a>, <a +href="glossaries-user.html#dx1-197012" >412</a>, <a +href="glossaries-user.html#dx1-197021" >413</a>, <a +href="glossaries-user.html#dx1-200005" >414</a>, <a +href="glossaries-user.html#dx1-200006" >415</a>, <a +href="glossaries-user.html#dx1-200009" >416</a>, <a +href="glossaries-user.html#dx1-200020" >417</a>, <a +href="glossaries-user.html#dx1-200029" >418</a>, <a +href="glossaries-user.html#dx1-200031" >419</a>, <a +href="glossaries-user.html#dx1-200035" >420</a>, <a +href="glossaries-user.html#dx1-201017" >421</a>, <a +href="glossaries-user.html#dx1-201018" >422</a>, <a +href="glossaries-user.html#dx1-201020" >423</a>, <a +href="glossaries-user.html#dx1-201041" >424</a>, <a +href="glossaries-user.html#dx1-203030" >425</a>, <a +href="glossaries-user.html#dx1-203037" >426</a>, <a +href="glossaries-user.html#dx1-203041" >427</a>, <a +href="glossaries-user.html#dx1-203042" >428</a>, <a +href="glossaries-user.html#dx1-203053" >429</a>, <a +href="glossaries-user.html#dx1-203055" >430</a>, <a +href="glossaries-user.html#dx1-203056" >431</a>, <a +href="glossaries-user.html#dx1-203059" >432</a>, <a +href="glossaries-user.html#dx1-203064" >433</a>, <a +href="glossaries-user.html#dx1-203067" >434</a>, <a +href="glossaries-user.html#dx1-203072" >435</a>, <a +href="glossaries-user.html#dx1-203074" >436</a>, <a +href="glossaries-user.html#dx1-203076" >437</a>, <a +href="glossaries-user.html#dx1-203081" >438</a>, <a +href="glossaries-user.html#dx1-203084" >439</a>, <a +href="glossaries-user.html#dx1-203085" >440</a>, <a +href="glossaries-user.html#dx1-203096" >441</a>, <a +href="glossaries-user.html#dx1-204002" >442</a>, <a +href="glossaries-user.html#dx1-205048" >443</a>, <a +href="glossaries-user.html#dx1-205049" >444</a>, <a +href="glossaries-user.html#dx1-205052" >445</a>, <a +href="glossaries-user.html#dx1-205056" >446</a>, <a +href="glossaries-user.html#dx1-205077" >447</a>, <a +href="glossaries-user.html#dx1-205080" >448</a>, <a +href="glossaries-user.html#dx1-205103" >449</a>, <a +href="glossaries-user.html#dx1-207017" >450</a>, <a +href="glossaries-user.html#dx1-207018" >451</a>, <a +href="glossaries-user.html#dx1-207022" >452</a>, <a +href="glossaries-user.html#dx1-209005" >453</a>, <a +href="glossaries-user.html#dx1-209006" >454</a>, <a +href="glossaries-user.html#dx1-209009" >455</a>, <a +href="glossaries-user.html#dx1-209021" >456</a>, <a +href="glossaries-user.html#dx1-214035" >457</a>, <a +href="glossaries-user.html#dx1-214036" >458</a>, <a +href="glossaries-user.html#dx1-214040" >459</a>, <a +href="glossaries-user.html#dx1-214042" >460</a>, <a +href="glossaries-user.html#dx1-214051" >461</a>, <a +href="glossaries-user.html#dx1-214053" >462</a>, <a +href="glossaries-user.html#dx1-214054" >463</a>, <a +href="glossaries-user.html#dx1-214069" >464</a>, <a +href="glossaries-user.html#dx1-214088" >465</a>, <a +href="glossaries-user.html#dx1-215005" >466</a>, <a +href="glossaries-user.html#dx1-215006" >467</a>, <a +href="glossaries-user.html#dx1-215010" >468</a>, <a +href="glossaries-user.html#dx1-217009" >469</a>, <a +href="glossaries-user.html#dx1-217010" >470</a>, <a +href="glossaries-user.html#dx1-217014" >471</a>, <a +href="glossaries-user.html#dx1-217015" >472</a>, <a +href="glossaries-user.html#dx1-217018" >473</a>, <a +href="glossaries-user.html#dx1-217021" >474</a>, <a +href="glossaries-user.html#dx1-217023" >475</a>, <a +href="glossaries-user.html#dx1-217028" >476</a>, <a +href="glossaries-user.html#dx1-217033" >477</a>, <a +href="glossaries-user.html#dx1-217036" >478</a>, <a +href="glossaries-user.html#dx1-217042" >479</a>, <a +href="glossaries-user.html#dx1-217046" >480</a>, <a +href="glossaries-user.html#dx1-222002" >481</a>, <a +href="glossaries-user.html#dx1-223018" >482</a>, <a +href="glossaries-user.html#dx1-223019" >483</a>, <a +href="glossaries-user.html#dx1-223023" >484</a>, <a +href="glossaries-user.html#dx1-223029" >485</a>, <a +href="glossaries-user.html#dx1-223032" >486</a>, <a +href="glossaries-user.html#dx1-223037" >487</a>, <a +href="glossaries-user.html#dx1-226005" >488</a>, <a +href="glossaries-user.html#dx1-226006" >489</a>, <a +href="glossaries-user.html#dx1-226007" >490</a>, <a +href="glossaries-user.html#dx1-226010" >491</a>, <a +href="glossaries-user.html#dx1-226016" >492</a>, <a +href="glossaries-user.html#dx1-226017" >493</a>, <a +href="glossaries-user.html#dx1-226024" >494</a>, <a +href="glossaries-user.html#dx1-229004" >495</a>, <a +href="glossaries-user.html#dx1-229005" >496</a>, <a +href="glossaries-user.html#dx1-195042" >497</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">--group</span>  <a -href="glossaries-user.html#dx1-9033" >481</a>, <a -href="glossaries-user.html#dx1-11082" >482</a>, <a -href="glossaries-user.html#dx1-176033" >483</a>, <a -href="glossaries-user.html#dx1-200091" >484</a>, <a -href="glossaries-user.html#dx1-201003" >485</a> <br /></span> +href="glossaries-user.html#dx1-9033" >498</a>, <a +href="glossaries-user.html#dx1-11082" >499</a>, <a +href="glossaries-user.html#dx1-179033" >500</a>, <a +href="glossaries-user.html#dx1-203091" >501</a>, <a +href="glossaries-user.html#dx1-204003" >502</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">--map-format</span>  <a -href="glossaries-user.html#dx1-190037" >486</a> <br /></span> +href="glossaries-user.html#dx1-193037" >503</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-g</span>  <a -href="glossaries-user.html#dx1-200092" >487</a> <br /></span> +href="glossaries-user.html#dx1-203092" >504</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-m</span>  <a -href="glossaries-user.html#dx1-190038" >488</a> <br /></span> +href="glossaries-user.html#dx1-193038" >505</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">bib2gls </span>entry types<br /></span> <span class="index-subitem">    <span class="cmtt-10">@abbreviation</span>  <a -href="glossaries-user.html#dx1-9008" >489</a>, <a -href="glossaries-user.html#dx1-9014" >490</a>, <a -href="glossaries-user.html#dx1-179051" >491</a>, <a -href="glossaries-user.html#dx1-179056" >492</a>, <a -href="glossaries-user.html#dx1-179066" >493</a>, <a -href="glossaries-user.html#dx1-198027" >494</a>, <a -href="glossaries-user.html#dx1-198028" >495</a> <br /></span> +href="glossaries-user.html#dx1-9008" >506</a>, <a +href="glossaries-user.html#dx1-9014" >507</a>, <a +href="glossaries-user.html#dx1-182051" >508</a>, <a +href="glossaries-user.html#dx1-182056" >509</a>, <a +href="glossaries-user.html#dx1-182066" >510</a>, <a +href="glossaries-user.html#dx1-201027" >511</a>, <a +href="glossaries-user.html#dx1-201028" >512</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@acronym</span>  <a -href="glossaries-user.html#dx1-179048" >496</a>, <a -href="glossaries-user.html#dx1-179049" >497</a>, <a -href="glossaries-user.html#dx1-179055" >498</a>, <a -href="glossaries-user.html#dx1-179065" >499</a>, <a -href="glossaries-user.html#dx1-193014" >500</a>, <a -href="glossaries-user.html#dx1-193024" >501</a>, <a -href="glossaries-user.html#dx1-198024" >502</a>, <a -href="glossaries-user.html#dx1-223020" >503</a> <br /></span> +href="glossaries-user.html#dx1-182048" >513</a>, <a +href="glossaries-user.html#dx1-182049" >514</a>, <a +href="glossaries-user.html#dx1-182055" >515</a>, <a +href="glossaries-user.html#dx1-182065" >516</a>, <a +href="glossaries-user.html#dx1-196014" >517</a>, <a +href="glossaries-user.html#dx1-196024" >518</a>, <a +href="glossaries-user.html#dx1-201024" >519</a>, <a +href="glossaries-user.html#dx1-226020" >520</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@dualabbreviationentry</span>  <a -href="glossaries-user.html#dx1-193012" >504</a>, <a -href="glossaries-user.html#dx1-193017" >505</a>, <a -href="glossaries-user.html#dx1-193037" >506</a> <br /></span> +href="glossaries-user.html#dx1-196012" >521</a>, <a +href="glossaries-user.html#dx1-196017" >522</a>, <a +href="glossaries-user.html#dx1-196037" >523</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@dualentry</span>  <a -href="glossaries-user.html#dx1-194014" >507</a>, <a -href="glossaries-user.html#dx1-194017" >508</a>, <a -href="glossaries-user.html#dx1-194020" >509</a> <br /></span> +href="glossaries-user.html#dx1-197014" >524</a>, <a +href="glossaries-user.html#dx1-197017" >525</a>, <a +href="glossaries-user.html#dx1-197020" >526</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@dualindexabbreviation</span>  <a -href="glossaries-user.html#dx1-193038" >510</a>, <a -href="glossaries-user.html#dx1-193039" >511</a> <br /></span> +href="glossaries-user.html#dx1-196038" >527</a>, <a +href="glossaries-user.html#dx1-196039" >528</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@entry</span>  <a -href="glossaries-user.html#dx1-9006" >512</a>, <a -href="glossaries-user.html#dx1-9012" >513</a>, <a -href="glossaries-user.html#dx1-11017" >514</a>, <a -href="glossaries-user.html#dx1-11018" >515</a>, <a -href="glossaries-user.html#dx1-188022" >516</a>, <a -href="glossaries-user.html#dx1-188023" >517</a>, <a -href="glossaries-user.html#dx1-188026" >518</a>, <a -href="glossaries-user.html#dx1-188028" >519</a>, <a -href="glossaries-user.html#dx1-188032" >520</a>, <a -href="glossaries-user.html#dx1-192044" >521</a>, <a -href="glossaries-user.html#dx1-192046" >522</a>, <a -href="glossaries-user.html#dx1-192051" >523</a>, <a -href="glossaries-user.html#dx1-192053" >524</a>, <a -href="glossaries-user.html#dx1-192064" >525</a>, <a -href="glossaries-user.html#dx1-192065" >526</a>, <a -href="glossaries-user.html#dx1-193013" >527</a>, <a -href="glossaries-user.html#dx1-193023" >528</a>, <a -href="glossaries-user.html#dx1-194009" >529</a>, <a -href="glossaries-user.html#dx1-194010" >530</a>, <a -href="glossaries-user.html#dx1-197010" >531</a>, <a -href="glossaries-user.html#dx1-197014" >532</a>, <a -href="glossaries-user.html#dx1-198022" >533</a>, <a -href="glossaries-user.html#dx1-198030" >534</a>, <a -href="glossaries-user.html#dx1-198031" >535</a>, <a -href="glossaries-user.html#dx1-200068" >536</a>, <a -href="glossaries-user.html#dx1-200071" >537</a>, <a -href="glossaries-user.html#dx1-200079" >538</a>, <a -href="glossaries-user.html#dx1-200080" >539</a>, <a -href="glossaries-user.html#dx1-202062" >540</a>, <a -href="glossaries-user.html#dx1-202063" >541</a>, <a -href="glossaries-user.html#dx1-202074" >542</a>, <a -href="glossaries-user.html#dx1-202075" >543</a>, <a -href="glossaries-user.html#dx1-202079" >544</a>, <a -href="glossaries-user.html#dx1-202083" >545</a>, <a -href="glossaries-user.html#dx1-204024" >546</a>, <a -href="glossaries-user.html#dx1-206013" >547</a>, <a -href="glossaries-user.html#dx1-211066" >548</a>, <a -href="glossaries-user.html#dx1-211067" >549</a>, <a -href="glossaries-user.html#dx1-211068" >550</a>, <a -href="glossaries-user.html#dx1-223018" >551</a>, <a -href="glossaries-user.html#dx1-223019" >552</a> <br /></span> - - +href="glossaries-user.html#dx1-9006" >529</a>, <a +href="glossaries-user.html#dx1-9012" >530</a>, <a +href="glossaries-user.html#dx1-11017" >531</a>, <a +href="glossaries-user.html#dx1-11018" >532</a>, <a +href="glossaries-user.html#dx1-191022" >533</a>, <a +href="glossaries-user.html#dx1-191023" >534</a>, <a +href="glossaries-user.html#dx1-191026" >535</a>, <a +href="glossaries-user.html#dx1-191028" >536</a>, <a +href="glossaries-user.html#dx1-191032" >537</a>, <a +href="glossaries-user.html#dx1-195044" >538</a>, <a +href="glossaries-user.html#dx1-195046" >539</a>, <a +href="glossaries-user.html#dx1-195051" >540</a>, <a +href="glossaries-user.html#dx1-195053" >541</a>, <a +href="glossaries-user.html#dx1-195064" >542</a>, <a +href="glossaries-user.html#dx1-195065" >543</a>, <a +href="glossaries-user.html#dx1-196013" >544</a>, <a +href="glossaries-user.html#dx1-196023" >545</a>, <a +href="glossaries-user.html#dx1-197009" >546</a>, <a +href="glossaries-user.html#dx1-197010" >547</a>, <a +href="glossaries-user.html#dx1-200010" >548</a>, <a +href="glossaries-user.html#dx1-200014" >549</a>, <a +href="glossaries-user.html#dx1-201022" >550</a>, <a +href="glossaries-user.html#dx1-201030" >551</a>, <a +href="glossaries-user.html#dx1-201031" >552</a>, <a +href="glossaries-user.html#dx1-203068" >553</a>, <a +href="glossaries-user.html#dx1-203071" >554</a>, <a +href="glossaries-user.html#dx1-203079" >555</a>, <a +href="glossaries-user.html#dx1-203080" >556</a>, <a +href="glossaries-user.html#dx1-205062" >557</a>, <a +href="glossaries-user.html#dx1-205063" >558</a>, <a +href="glossaries-user.html#dx1-205074" >559</a>, <a +href="glossaries-user.html#dx1-205075" >560</a>, <a +href="glossaries-user.html#dx1-205079" >561</a>, <a +href="glossaries-user.html#dx1-205083" >562</a>, <a +href="glossaries-user.html#dx1-207024" >563</a>, <a +href="glossaries-user.html#dx1-209013" >564</a>, <a +href="glossaries-user.html#dx1-214066" >565</a>, <a +href="glossaries-user.html#dx1-214067" >566</a>, <a +href="glossaries-user.html#dx1-214068" >567</a>, <a +href="glossaries-user.html#dx1-226018" >568</a>, <a +href="glossaries-user.html#dx1-226019" >569</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@index</span>  <a -href="glossaries-user.html#dx1-11089" >553</a>, <a -href="glossaries-user.html#dx1-11091" >554</a>, <a -href="glossaries-user.html#dx1-11092" >555</a>, <a -href="glossaries-user.html#dx1-193040" >556</a>, <a -href="glossaries-user.html#dx1-193041" >557</a>, <a -href="glossaries-user.html#dx1-197013" >558</a>, <a -href="glossaries-user.html#dx1-197018" >559</a>, <a -href="glossaries-user.html#dx1-206012" >560</a>, <a -href="glossaries-user.html#dx1-206014" >561</a>, <a -href="glossaries-user.html#dx1-206015" >562</a>, <a -href="glossaries-user.html#dx1-206016" >563</a> <br /></span> +href="glossaries-user.html#dx1-11089" >570</a>, <a +href="glossaries-user.html#dx1-11091" >571</a>, <a +href="glossaries-user.html#dx1-11092" >572</a>, <a +href="glossaries-user.html#dx1-196040" >573</a>, <a +href="glossaries-user.html#dx1-196041" >574</a>, <a +href="glossaries-user.html#dx1-200013" >575</a>, <a +href="glossaries-user.html#dx1-200018" >576</a>, <a +href="glossaries-user.html#dx1-209012" >577</a>, <a +href="glossaries-user.html#dx1-209014" >578</a>, <a +href="glossaries-user.html#dx1-209015" >579</a>, <a +href="glossaries-user.html#dx1-209016" >580</a> <br /></span> + + <span class="index-subitem">    <span class="cmtt-10">@indexplural</span>  <a -href="glossaries-user.html#dx1-202065" >564</a>, <a -href="glossaries-user.html#dx1-202066" >565</a>, <a -href="glossaries-user.html#dx1-202067" >566</a>, <a -href="glossaries-user.html#dx1-202097" >567</a> <br /></span> +href="glossaries-user.html#dx1-205065" >581</a>, <a +href="glossaries-user.html#dx1-205066" >582</a>, <a +href="glossaries-user.html#dx1-205067" >583</a>, <a +href="glossaries-user.html#dx1-205097" >584</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@preamble</span>  <a -href="glossaries-user.html#dx1-197021" >568</a>, <a -href="glossaries-user.html#dx1-197032" >569</a>, <a -href="glossaries-user.html#dx1-197034" >570</a>, <a -href="glossaries-user.html#dx1-200062" >571</a>, <a -href="glossaries-user.html#dx1-200073" >572</a>, <a -href="glossaries-user.html#dx1-200075" >573</a>, <a -href="glossaries-user.html#dx1-211074" >574</a>, <a -href="glossaries-user.html#dx1-211086" >575</a> <br /></span> +href="glossaries-user.html#dx1-200021" >585</a>, <a +href="glossaries-user.html#dx1-200032" >586</a>, <a +href="glossaries-user.html#dx1-200034" >587</a>, <a +href="glossaries-user.html#dx1-203062" >588</a>, <a +href="glossaries-user.html#dx1-203073" >589</a>, <a +href="glossaries-user.html#dx1-203075" >590</a>, <a +href="glossaries-user.html#dx1-214074" >591</a>, <a +href="glossaries-user.html#dx1-214086" >592</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">@symbol</span>  <a -href="glossaries-user.html#dx1-9007" >576</a>, <a -href="glossaries-user.html#dx1-9013" >577</a>, <a -href="glossaries-user.html#dx1-188024" >578</a>, <a -href="glossaries-user.html#dx1-188027" >579</a>, <a -href="glossaries-user.html#dx1-188030" >580</a>, <a -href="glossaries-user.html#dx1-188033" >581</a>, <a -href="glossaries-user.html#dx1-192066" >582</a>, <a -href="glossaries-user.html#dx1-192067" >583</a>, <a -href="glossaries-user.html#dx1-192069" >584</a>, <a -href="glossaries-user.html#dx1-198032" >585</a>, <a -href="glossaries-user.html#dx1-202084" >586</a>, <a -href="glossaries-user.html#dx1-202085" >587</a>, <a -href="glossaries-user.html#dx1-202091" >588</a>, <a -href="glossaries-user.html#dx1-202095" >589</a> <br /></span> +href="glossaries-user.html#dx1-9007" >593</a>, <a +href="glossaries-user.html#dx1-9013" >594</a>, <a +href="glossaries-user.html#dx1-191024" >595</a>, <a +href="glossaries-user.html#dx1-191027" >596</a>, <a +href="glossaries-user.html#dx1-191030" >597</a>, <a +href="glossaries-user.html#dx1-191033" >598</a>, <a +href="glossaries-user.html#dx1-195066" >599</a>, <a +href="glossaries-user.html#dx1-195067" >600</a>, <a +href="glossaries-user.html#dx1-195069" >601</a>, <a +href="glossaries-user.html#dx1-201032" >602</a>, <a +href="glossaries-user.html#dx1-205084" >603</a>, <a +href="glossaries-user.html#dx1-205085" >604</a>, <a +href="glossaries-user.html#dx1-205091" >605</a>, <a +href="glossaries-user.html#dx1-205095" >606</a> <br /></span> <span class="index-item"><span class="cmss-10">booktabs </span>package  <a -href="glossaries-user.html#dx1-158006" >590</a>, <a -href="glossaries-user.html#dx1-159009" >591</a>, <a -href="glossaries-user.html#dx1-160011" >592</a>, <a -href="glossaries-user.html#dx1-219005" >593</a> <br /></span> +href="glossaries-user.html#dx1-157006" >607</a>, <a +href="glossaries-user.html#dx1-158009" >608</a>, <a +href="glossaries-user.html#dx1-159011" >609</a>, <a +href="glossaries-user.html#dx1-222005" >610</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\bottomrule</span></span></span>  <a -href="glossaries-user.html#dx1-160014" >594</a> <br /></span> +href="glossaries-user.html#dx1-159014" >611</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">C</span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup>categories<br /></span> <span class="index-subitem">    <span class="cmtt-10">abbreviation</span>  <a -href="glossaries-user.html#dx1-175026" >595</a>, <a -href="glossaries-user.html#dx1-175030" >596</a>, <a -href="glossaries-user.html#dx1-178034" >597</a>, <a -href="glossaries-user.html#dx1-179061" >598</a>, <a -href="glossaries-user.html#dx1-182033" >599</a>, <a -href="glossaries-user.html#dx1-184050" >600</a>, <a -href="glossaries-user.html#dx1-186010" >601</a>, <a -href="glossaries-user.html#dx1-224042" >602</a>, <a -href="glossaries-user.html#dx1-224061" >603</a> <br /></span> +href="glossaries-user.html#dx1-178026" >612</a>, <a +href="glossaries-user.html#dx1-178030" >613</a>, <a +href="glossaries-user.html#dx1-181034" >614</a>, <a +href="glossaries-user.html#dx1-182061" >615</a>, <a +href="glossaries-user.html#dx1-185033" >616</a>, <a +href="glossaries-user.html#dx1-187050" >617</a>, <a +href="glossaries-user.html#dx1-189010" >618</a>, <a +href="glossaries-user.html#dx1-227042" >619</a>, <a +href="glossaries-user.html#dx1-227061" >620</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">acronym</span>  <a -href="glossaries-user.html#dx1-175022" >604</a>, <a -href="glossaries-user.html#dx1-175024" >605</a>, <a -href="glossaries-user.html#dx1-175031" >606</a>, <a -href="glossaries-user.html#dx1-175034" >607</a>, <a -href="glossaries-user.html#dx1-178028" >608</a>, <a -href="glossaries-user.html#dx1-179015" >609</a>, <a -href="glossaries-user.html#dx1-179062" >610</a>, <a -href="glossaries-user.html#dx1-182034" >611</a>, <a -href="glossaries-user.html#dx1-184051" >612</a>, <a -href="glossaries-user.html#dx1-186012" >613</a>, <a -href="glossaries-user.html#dx1-186028" >614</a>, <a -href="glossaries-user.html#dx1-224057" >615</a>, <a -href="glossaries-user.html#dx1-224062" >616</a> <br /></span> +href="glossaries-user.html#dx1-178022" >621</a>, <a +href="glossaries-user.html#dx1-178024" >622</a>, <a +href="glossaries-user.html#dx1-178031" >623</a>, <a +href="glossaries-user.html#dx1-178034" >624</a>, <a +href="glossaries-user.html#dx1-181028" >625</a>, <a +href="glossaries-user.html#dx1-182015" >626</a>, <a +href="glossaries-user.html#dx1-182062" >627</a>, <a +href="glossaries-user.html#dx1-185034" >628</a>, <a +href="glossaries-user.html#dx1-187051" >629</a>, <a +href="glossaries-user.html#dx1-189012" >630</a>, <a +href="glossaries-user.html#dx1-189028" >631</a>, <a +href="glossaries-user.html#dx1-227057" >632</a>, <a +href="glossaries-user.html#dx1-227062" >633</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">general</span>  <a -href="glossaries-user.html#dx1-183018" >617</a>, <a -href="glossaries-user.html#dx1-200018" >618</a>, <a -href="glossaries-user.html#dx1-202019" >619</a>, <a -href="glossaries-user.html#dx1-224060" >620</a> <br /></span> +href="glossaries-user.html#dx1-186018" >634</a>, <a +href="glossaries-user.html#dx1-203018" >635</a>, <a +href="glossaries-user.html#dx1-205019" >636</a>, <a +href="glossaries-user.html#dx1-227060" >637</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">index</span>  <a -href="glossaries-user.html#dx1-224063" >621</a> <br /></span> +href="glossaries-user.html#dx1-227063" >638</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">number</span>  <a -href="glossaries-user.html#dx1-224065" >622</a> <br /></span> +href="glossaries-user.html#dx1-227065" >639</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">symbol</span>  <a -href="glossaries-user.html#dx1-202031" >623</a>, <a -href="glossaries-user.html#dx1-202099" >624</a>, <a -href="glossaries-user.html#dx1-224064" >625</a> <br /></span> +href="glossaries-user.html#dx1-205031" >640</a>, <a +href="glossaries-user.html#dx1-205099" >641</a>, <a +href="glossaries-user.html#dx1-227064" >642</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup>category attributes  <a -href="glossaries-user.html#dx1-147033" >626</a> <br /></span> +href="glossaries-user.html#dx1-135038" >643</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">discardperiod</span>  <a -href="glossaries-user.html#dx1-185006" >627</a>, <a -href="glossaries-user.html#dx1-186021" >628</a>, <a -href="glossaries-user.html#dx1-186024" >629</a>, <a -href="glossaries-user.html#dx1-224059" >630</a>, <a -href="glossaries-user.html#dx1-224070" >631</a> <br /></span> +href="glossaries-user.html#dx1-188006" >644</a>, <a +href="glossaries-user.html#dx1-189021" >645</a>, <a +href="glossaries-user.html#dx1-189024" >646</a>, <a +href="glossaries-user.html#dx1-227059" >647</a>, <a +href="glossaries-user.html#dx1-227070" >648</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">glossdesc</span>  <a -href="glossaries-user.html#dx1-11039" >632</a>, <a -href="glossaries-user.html#dx1-182026" >633</a>, <a -href="glossaries-user.html#dx1-183029" >634</a>, <a -href="glossaries-user.html#dx1-189012" >635</a>, <a -href="glossaries-user.html#dx1-189014" >636</a> <br /></span> +href="glossaries-user.html#dx1-11039" >649</a>, <a +href="glossaries-user.html#dx1-185026" >650</a>, <a +href="glossaries-user.html#dx1-186029" >651</a>, <a +href="glossaries-user.html#dx1-192012" >652</a>, <a +href="glossaries-user.html#dx1-192014" >653</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">glossdescfont</span>  <a -href="glossaries-user.html#dx1-11040" >637</a> <br /></span> +href="glossaries-user.html#dx1-11040" >654</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">glossname</span>  <a -href="glossaries-user.html#dx1-11054" >638</a> <br /></span> +href="glossaries-user.html#dx1-11054" >655</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">glosssymbolfont</span>  <a -href="glossaries-user.html#dx1-189050" >639</a> <br /></span> +href="glossaries-user.html#dx1-192050" >656</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">hyperoutside</span>  <a -href="glossaries-user.html#dx1-29" >640</a> <br /></span> +href="glossaries-user.html#dx1-28" >657</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">indexonlyfirst</span>  <a -href="glossaries-user.html#dx1-64007" >641</a> <br /></span> +href="glossaries-user.html#dx1-65007" >658</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">insertdots</span>  <a -href="glossaries-user.html#dx1-185013" >642</a>, <a -href="glossaries-user.html#dx1-185016" >643</a>, <a -href="glossaries-user.html#dx1-186019" >644</a>, <a -href="glossaries-user.html#dx1-186020" >645</a>, <a -href="glossaries-user.html#dx1-224069" >646</a> <br /></span> +href="glossaries-user.html#dx1-188013" >659</a>, <a +href="glossaries-user.html#dx1-188016" >660</a>, <a +href="glossaries-user.html#dx1-189019" >661</a>, <a +href="glossaries-user.html#dx1-189020" >662</a>, <a +href="glossaries-user.html#dx1-227069" >663</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nohyperfirst</span>  <a -href="glossaries-user.html#dx1-34024" >647</a> <br /></span> +href="glossaries-user.html#dx1-34024" >664</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">noshortplural</span>  <a -href="glossaries-user.html#dx1-185008" >648</a> <br /></span> +href="glossaries-user.html#dx1-188008" >665</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">pluraldiscardperiod</span>  <a -href="glossaries-user.html#dx1-185009" >649</a> <br /></span> +href="glossaries-user.html#dx1-188009" >666</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">retainfirstuseperiod</span>  <a -href="glossaries-user.html#dx1-185010" >650</a> <br /></span> +href="glossaries-user.html#dx1-188010" >667</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">textformat</span>  <a -href="glossaries-user.html#dx1-30" >651</a> <br /></span> +href="glossaries-user.html#dx1-29" >668</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cGls</span></span></span>  <a -href="glossaries-user.html#dx1-154011" ><span -class="cmti-10">652</span></a> <br /></span> +href="glossaries-user.html#dx1-143011" ><span +class="cmti-10">669</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cgls</span></span></span>  <a -href="glossaries-user.html#dx1-154009" ><span -class="cmti-10">653</span></a>, <a -href="glossaries-user.html#dx1-226002" >654</a> <br /></span> +href="glossaries-user.html#dx1-143009" ><span +class="cmti-10">670</span></a>, <a +href="glossaries-user.html#dx1-229002" >671</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cGlsformat</span></span></span>  <a -href="glossaries-user.html#dx1-154015" ><span -class="cmti-10">655</span></a> <br /></span> +href="glossaries-user.html#dx1-143015" ><span +class="cmti-10">672</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cglsformat</span></span></span>  <a -href="glossaries-user.html#dx1-154013" ><span -class="cmti-10">656</span></a> <br /></span> +href="glossaries-user.html#dx1-143013" ><span +class="cmti-10">673</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cGlspl</span></span></span>  <a -href="glossaries-user.html#dx1-154012" ><span -class="cmti-10">657</span></a> <br /></span> +href="glossaries-user.html#dx1-143012" ><span +class="cmti-10">674</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cglspl</span></span></span>  <a -href="glossaries-user.html#dx1-154010" ><span -class="cmti-10">658</span></a> <br /></span> +href="glossaries-user.html#dx1-143010" ><span +class="cmti-10">675</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cGlsplformat</span></span></span>  <a -href="glossaries-user.html#dx1-154016" ><span -class="cmti-10">659</span></a> <br /></span> +href="glossaries-user.html#dx1-143016" ><span +class="cmti-10">676</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\cglsplformat</span></span></span>  <a -href="glossaries-user.html#dx1-154014" ><span -class="cmti-10">660</span></a> <br /></span> +href="glossaries-user.html#dx1-143014" ><span +class="cmti-10">677</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\chapter</span></span></span>  <a -href="glossaries-user.html#dx1-141067" >661</a>, <a -href="glossaries-user.html#dx1-197026" >662</a> <br /></span> +href="glossaries-user.html#dx1-144077" >678</a>, <a +href="glossaries-user.html#dx1-200026" >679</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\chapter*</span></span></span>  <a -href="glossaries-user.html#dx1-43012" >663</a>, <a -href="glossaries-user.html#dx1-141065" >664</a> <br /></span> +href="glossaries-user.html#dx1-44012" >680</a>, <a +href="glossaries-user.html#dx1-144075" >681</a> <br /></span> <span class="index-item"><span class="cmss-10">classicthesis </span>package  <a -href="glossaries-user.html#dx1-49002" >665</a>, <a -href="glossaries-user.html#dx1-52004" >666</a>, <a -href="glossaries-user.html#dx1-53003" >667</a>, <a -href="glossaries-user.html#dx1-157007" >668</a>, <a -href="glossaries-user.html#dx1-157046" >669</a> <br /></span> +href="glossaries-user.html#dx1-50002" >682</a>, <a +href="glossaries-user.html#dx1-53004" >683</a>, <a +href="glossaries-user.html#dx1-54003" >684</a>, <a +href="glossaries-user.html#dx1-156007" >685</a>, <a +href="glossaries-user.html#dx1-156046" >686</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">convertgls2bib</span>  <a href="glossaries-user.html#dx1-3006" ><span -class="cmbx-10">670</span></a>, <a -href="glossaries-user.html#dx1-3011" >671</a>, <a -href="glossaries-user.html#dx1-175051" >672</a>, <a -href="glossaries-user.html#dx1-176015" >673</a>, <a -href="glossaries-user.html#dx1-188021" >674</a>, <a -href="glossaries-user.html#dx1-189064" >675</a>, <a -href="glossaries-user.html#dx1-190027" >676</a>, <a -href="glossaries-user.html#dx1-192039" >677</a>, <a -href="glossaries-user.html#dx1-192062" >678</a>, <a -href="glossaries-user.html#dx1-193007" >679</a>, <a -href="glossaries-user.html#dx1-193008" >680</a>, <a -href="glossaries-user.html#dx1-193009" >681</a>, <a -href="glossaries-user.html#dx1-193010" >682</a>, <a -href="glossaries-user.html#dx1-193011" >683</a>, <a -href="glossaries-user.html#dx1-200060" >684</a>, <a -href="glossaries-user.html#dx1-200065" >685</a>, <a -href="glossaries-user.html#dx1-204023" >686</a>, <a -href="glossaries-user.html#dx1-214022" >687</a> <br /></span> +class="cmbx-10">687</span></a>, <a +href="glossaries-user.html#dx1-3011" >688</a>, <a +href="glossaries-user.html#dx1-178051" >689</a>, <a +href="glossaries-user.html#dx1-179015" >690</a>, <a +href="glossaries-user.html#dx1-191021" >691</a>, <a +href="glossaries-user.html#dx1-192064" >692</a>, <a +href="glossaries-user.html#dx1-193027" >693</a>, <a +href="glossaries-user.html#dx1-195039" >694</a>, <a +href="glossaries-user.html#dx1-195062" >695</a>, <a +href="glossaries-user.html#dx1-196007" >696</a>, <a +href="glossaries-user.html#dx1-196008" >697</a>, <a +href="glossaries-user.html#dx1-196009" >698</a>, <a +href="glossaries-user.html#dx1-196010" >699</a>, <a +href="glossaries-user.html#dx1-196011" >700</a>, <a +href="glossaries-user.html#dx1-203060" >701</a>, <a +href="glossaries-user.html#dx1-203065" >702</a>, <a +href="glossaries-user.html#dx1-207023" >703</a>, <a +href="glossaries-user.html#dx1-217022" >704</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\currentglossary</span></span></span>  <a -href="glossaries-user.html#dx1-166070" ><span -class="cmti-10">688</span></a> <br /></span> +href="glossaries-user.html#dx1-165071" ><span +class="cmti-10">705</span></a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">D</span> <span class="index-item"><span class="cmss-10">datatool </span>package  <a -href="glossaries-user.html#dx1-12" >689</a>, <a -href="glossaries-user.html#dx1-141047" >690</a>, <a -href="glossaries-user.html#dx1-141050" >691</a>, <a -href="glossaries-user.html#dx1-141052" >692</a>, <a -href="glossaries-user.html#dx1-141054" >693</a> <br /></span> +href="glossaries-user.html#dx1-12" >706</a>, <a +href="glossaries-user.html#dx1-144054" >707</a>, <a +href="glossaries-user.html#dx1-144057" >708</a>, <a +href="glossaries-user.html#dx1-144059" >709</a>, <a +href="glossaries-user.html#dx1-144061" >710</a> <br /></span> <span class="index-item"><span class="cmss-10">datatool-base </span>package  <a -href="glossaries-user.html#dx1-11" >694</a> <br /></span> +href="glossaries-user.html#dx1-11" >711</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\DeclareAcronymList</span></span></span>  <a -href="glossaries-user.html#dx1-93003" ><span -class="cmti-10">695</span></a>, <a -href="glossaries-user.html#dx1-135011" >696</a>, <a -href="glossaries-user.html#dx1-147016" >697</a>, <a -href="glossaries-user.html#dx1-168003" >698</a> <br /></span> +href="glossaries-user.html#dx1-94003" ><span +class="cmti-10">712</span></a>, <a +href="glossaries-user.html#dx1-132011" >713</a>, <a +href="glossaries-user.html#dx1-135022" >714</a>, <a +href="glossaries-user.html#dx1-171003" >715</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\defentryfmt</span></span></span>  <a -href="glossaries-user.html#dx1-147048" >699</a> <br /></span> +href="glossaries-user.html#dx1-136001" >716</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\defglsentry</span></span></span>  <a -href="glossaries-user.html#dx1-3035" >700</a>, <a -href="glossaries-user.html#dx1-134024" >701</a> <br /></span> +href="glossaries-user.html#dx1-3035" >717</a>, <a +href="glossaries-user.html#dx1-131024" >718</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\defglsentryfmt</span></span></span>  <a -href="glossaries-user.html#dx1-132027" >702</a>, <a -href="glossaries-user.html#dx1-133002" >703</a>, <a -href="glossaries-user.html#dx1-134002" >704</a>, <a -href="glossaries-user.html#dx1-135007" ><span -class="cmti-10">705</span></a>, <a -href="glossaries-user.html#dx1-135009" >706</a>, <a -href="glossaries-user.html#dx1-147017" >707</a>, <a -href="glossaries-user.html#dx1-147018" >708</a>, <a -href="glossaries-user.html#dx1-148004" >709</a>, <a -href="glossaries-user.html#dx1-150002" >710</a> <br /></span> +href="glossaries-user.html#dx1-129025" >719</a>, <a +href="glossaries-user.html#dx1-130002" >720</a>, <a +href="glossaries-user.html#dx1-131002" >721</a>, <a +href="glossaries-user.html#dx1-132007" ><span +class="cmti-10">722</span></a>, <a +href="glossaries-user.html#dx1-132009" >723</a>, <a +href="glossaries-user.html#dx1-135023" >724</a>, <a +href="glossaries-user.html#dx1-135024" >725</a>, <a +href="glossaries-user.html#dx1-137007" >726</a>, <a +href="glossaries-user.html#dx1-139002" >727</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\DefineAcronymSynonyms</span></span></span>  <a -href="glossaries-user.html#dx1-94001" ><span -class="cmti-10">711</span></a> <br /></span> +href="glossaries-user.html#dx1-95001" ><span +class="cmti-10">728</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\delimN</span></span></span>  <a -href="glossaries-user.html#dx1-166054" >712</a> <br /></span> +href="glossaries-user.html#dx1-165055" >729</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\delimR</span></span></span>  <a -href="glossaries-user.html#dx1-166055" >713</a> <br /></span> +href="glossaries-user.html#dx1-165056" >730</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\descriptionname</span></span></span>  <a -href="glossaries-user.html#dx1-14028" >714</a> <br /></span> +href="glossaries-user.html#dx1-14028" >731</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">\dgls</span></span></span>  <a -href="glossaries-user.html#dx1-24025" >715</a> <br /></span> +href="glossaries-user.html#dx1-24025" >732</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\dicei</span></span></span>  <a -href="glossaries-user.html#dx1-211023" >716</a> <br /></span> +href="glossaries-user.html#dx1-214023" >733</a> <br /></span> <span class="index-item"><span class="cmss-10">doc </span>package  <a -href="glossaries-user.html#dx1-20" >717</a>, <a -href="glossaries-user.html#dx1-21" >718</a>, <a -href="glossaries-user.html#dx1-25" >719</a>, <a -href="glossaries-user.html#dx1-107010" >720</a> <br /></span> +href="glossaries-user.html#dx1-19" >734</a>, <a +href="glossaries-user.html#dx1-20" >735</a>, <a +href="glossaries-user.html#dx1-24" >736</a>, <a +href="glossaries-user.html#dx1-108010" >737</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\dtlcompare</span></span></span>  <a -href="glossaries-user.html#dx1-141053" >721</a> <br /></span> +href="glossaries-user.html#dx1-144060" >738</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\dtlicompare</span></span></span>  <a -href="glossaries-user.html#dx1-141051" >722</a> <br /></span> +href="glossaries-user.html#dx1-144058" >739</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\dtlletterindexcompare</span></span></span>  <a -href="glossaries-user.html#dx1-141049" >723</a> <br /></span> +href="glossaries-user.html#dx1-144056" >740</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\dtlwordindexcompare</span></span></span>  <a -href="glossaries-user.html#dx1-141048" >724</a> <br /></span> +href="glossaries-user.html#dx1-144055" >741</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">E</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\edef</span></span></span>  <a -href="glossaries-user.html#dx1-135014" >725</a> <br /></span> +href="glossaries-user.html#dx1-132014" >742</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\emph</span></span></span>  <a -href="glossaries-user.html#dx1-132047" >726</a> <br /></span> +href="glossaries-user.html#dx1-129045" >743</a> <br /></span> <span class="index-item">encap  <a -href="glossaries-user.html#dx1-128002" >727</a> <br /></span> +href="glossaries-user.html#dx1-150002" >744</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\EndAccSupp</span></span></span>  <a -href="glossaries-user.html#dx1-172075" >728</a>, <a -href="glossaries-user.html#dx1-224004" >729</a> <br /></span> +href="glossaries-user.html#dx1-175075" >745</a>, <a +href="glossaries-user.html#dx1-227004" >746</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ensuremath</span></span></span>  <a -href="glossaries-user.html#dx1-189047" >730</a>, <a -href="glossaries-user.html#dx1-189048" >731</a> <br /></span> +href="glossaries-user.html#dx1-192047" >747</a>, <a +href="glossaries-user.html#dx1-192048" >748</a> <br /></span> <span class="index-item">entry location  <a href="glossaries-user.html#dx1-3013" ><span -class="cmbx-10">732</span></a> <br /></span> +class="cmbx-10">749</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\entryname</span></span></span>  <a -href="glossaries-user.html#dx1-14027" >733</a> <br /></span> +href="glossaries-user.html#dx1-14027" >750</a> <br /></span> <span class="index-item">environments:<br /></span> <span class="index-subitem">    <span class="cmtt-10">theglossary</span>  <a -href="glossaries-user.html#dx1-166003" ><span -class="cmti-10">734</span></a> <br /></span> +href="glossaries-user.html#dx1-165004" ><span +class="cmti-10">751</span></a> <br /></span> <span class="index-item"><span 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-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> +href="glossaries-user.html#dx1-7" >752</a>, <a +href="glossaries-user.html#dx1-74041" >753</a>, <a +href="glossaries-user.html#dx1-132018" >754</a>, <a +href="glossaries-user.html#dx1-172034" >755</a>, <a +href="glossaries-user.html#dx1-172037" >756</a>, <a +href="glossaries-user.html#dx1-172039" >757</a>, <a +href="glossaries-user.html#dx1-203040" >758</a>, <a +href="glossaries-user.html#dx1-203050" >759</a> <br /></span> <span class="index-item">Extended Latin Alphabet  <a href="glossaries-user.html#dx1-3014" ><span -class="cmbx-10">743</span></a> <br /></span> +class="cmbx-10">760</span></a> <br /></span> <span class="index-item">extended Latin character  <a -href="glossaries-user.html#dx1-3016" >744</a>, <a +href="glossaries-user.html#dx1-3016" >761</a>, <a href="glossaries-user.html#dx1-3017" ><span -class="cmbx-10">745</span></a>, <a -href="glossaries-user.html#dx1-3041" >746</a>, <a -href="glossaries-user.html#dx1-3057" >747</a>, <a -href="glossaries-user.html#dx1-3068" >748</a>, <a -href="glossaries-user.html#dx1-112007" >749</a>, <a -href="glossaries-user.html#dx1-214007" >750</a> <br /></span> +class="cmbx-10">762</span></a>, <a +href="glossaries-user.html#dx1-3041" >763</a>, <a +href="glossaries-user.html#dx1-3057" >764</a>, <a +href="glossaries-user.html#dx1-3068" >765</a>, <a +href="glossaries-user.html#dx1-113012" >766</a>, <a +href="glossaries-user.html#dx1-217007" >767</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">F</span> <span class="index-item">file types<br /></span> <span class="index-subitem">    <span class="cmtt-10">alg</span>  <a -href="glossaries-user.html#dx1-16082" >751</a> <br /></span> +href="glossaries-user.html#dx1-16082" >768</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">aux</span>  <a -href="glossaries-user.html#dx1-3003" >752</a>, <a -href="glossaries-user.html#dx1-7039" >753</a>, <a -href="glossaries-user.html#dx1-8038" >754</a>, <a -href="glossaries-user.html#dx1-11045" >755</a>, <a -href="glossaries-user.html#dx1-13022" >756</a>, <a -href="glossaries-user.html#dx1-17002" >757</a>, <a -href="glossaries-user.html#dx1-17018" >758</a>, <a -href="glossaries-user.html#dx1-21004" >759</a>, <a -href="glossaries-user.html#dx1-22022" >760</a>, <a -href="glossaries-user.html#dx1-24002" >761</a>, <a -href="glossaries-user.html#dx1-24014" >762</a>, <a -href="glossaries-user.html#dx1-24020" >763</a>, <a -href="glossaries-user.html#dx1-31003" >764</a>, <a -href="glossaries-user.html#dx1-63010" >765</a>, <a -href="glossaries-user.html#dx1-129001" >766</a>, <a -href="glossaries-user.html#dx1-132008" >767</a>, <a -href="glossaries-user.html#dx1-143004" >768</a>, <a -href="glossaries-user.html#dx1-154004" >769</a>, <a -href="glossaries-user.html#dx1-192012" >770</a>, <a -href="glossaries-user.html#dx1-192031" >771</a>, <a -href="glossaries-user.html#dx1-202016" >772</a>, <a -href="glossaries-user.html#dx1-211004" >773</a>, <a -href="glossaries-user.html#dx1-214038" >774</a>, <a -href="glossaries-user.html#dx1-214040" >775</a>, <a -href="glossaries-user.html#dx1-214044" >776</a>, <a -href="glossaries-user.html#dx1-220010" >777</a> <br /></span> +href="glossaries-user.html#dx1-3003" >769</a>, <a +href="glossaries-user.html#dx1-7039" >770</a>, <a +href="glossaries-user.html#dx1-8038" >771</a>, <a +href="glossaries-user.html#dx1-11045" >772</a>, <a +href="glossaries-user.html#dx1-13022" >773</a>, <a +href="glossaries-user.html#dx1-17002" >774</a>, <a +href="glossaries-user.html#dx1-17018" >775</a>, <a +href="glossaries-user.html#dx1-21004" >776</a>, <a +href="glossaries-user.html#dx1-22022" >777</a>, <a +href="glossaries-user.html#dx1-24002" >778</a>, <a +href="glossaries-user.html#dx1-24014" >779</a>, <a +href="glossaries-user.html#dx1-24020" >780</a>, <a +href="glossaries-user.html#dx1-31003" >781</a>, <a +href="glossaries-user.html#dx1-64010" >782</a>, <a +href="glossaries-user.html#dx1-129006" >783</a>, <a +href="glossaries-user.html#dx1-143004" >784</a>, <a +href="glossaries-user.html#dx1-151001" >785</a>, <a +href="glossaries-user.html#dx1-167004" >786</a>, <a +href="glossaries-user.html#dx1-195012" >787</a>, <a +href="glossaries-user.html#dx1-195031" >788</a>, <a +href="glossaries-user.html#dx1-205016" >789</a>, <a +href="glossaries-user.html#dx1-214004" >790</a>, <a +href="glossaries-user.html#dx1-217038" >791</a>, <a +href="glossaries-user.html#dx1-217040" >792</a>, <a +href="glossaries-user.html#dx1-217044" >793</a>, <a +href="glossaries-user.html#dx1-223010" >794</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">bib</span>  <a -href="glossaries-user.html#dx1-3002" >778</a>, <a -href="glossaries-user.html#dx1-3009" >779</a>, <a -href="glossaries-user.html#dx1-5010" >780</a>, <a -href="glossaries-user.html#dx1-9002" >781</a>, <a -href="glossaries-user.html#dx1-9009" >782</a>, <a -href="glossaries-user.html#dx1-9026" >783</a>, <a -href="glossaries-user.html#dx1-11090" >784</a>, <a -href="glossaries-user.html#dx1-12004" >785</a>, <a -href="glossaries-user.html#dx1-13011" >786</a>, <a -href="glossaries-user.html#dx1-24006" >787</a>, <a -href="glossaries-user.html#dx1-35006" >788</a>, <a -href="glossaries-user.html#dx1-67004" >789</a>, <a -href="glossaries-user.html#dx1-67007" >790</a>, <a -href="glossaries-user.html#dx1-112002" >791</a>, <a -href="glossaries-user.html#dx1-137007" >792</a>, <a -href="glossaries-user.html#dx1-175049" >793</a>, <a -href="glossaries-user.html#dx1-176014" >794</a>, <a -href="glossaries-user.html#dx1-179045" >795</a>, <a -href="glossaries-user.html#dx1-188019" >796</a>, <a -href="glossaries-user.html#dx1-188037" >797</a>, <a -href="glossaries-user.html#dx1-190026" >798</a>, <a -href="glossaries-user.html#dx1-192033" >799</a>, <a -href="glossaries-user.html#dx1-192040" >800</a>, <a -href="glossaries-user.html#dx1-192049" >801</a>, <a -href="glossaries-user.html#dx1-192070" >802</a>, <a -href="glossaries-user.html#dx1-193005" >803</a>, <a -href="glossaries-user.html#dx1-194007" >804</a>, <a -href="glossaries-user.html#dx1-197008" >805</a>, <a -href="glossaries-user.html#dx1-197019" >806</a>, <a -href="glossaries-user.html#dx1-198019" >807</a>, <a -href="glossaries-user.html#dx1-198040" >808</a>, <a -href="glossaries-user.html#dx1-200058" >809</a>, <a -href="glossaries-user.html#dx1-200061" >810</a>, <a -href="glossaries-user.html#dx1-202051" >811</a>, <a -href="glossaries-user.html#dx1-202061" >812</a>, <a -href="glossaries-user.html#dx1-202089" >813</a>, <a -href="glossaries-user.html#dx1-202100" >814</a>, <a -href="glossaries-user.html#dx1-204021" >815</a>, <a -href="glossaries-user.html#dx1-206008" >816</a>, <a -href="glossaries-user.html#dx1-211041" >817</a>, <a -href="glossaries-user.html#dx1-211087" >818</a>, <a -href="glossaries-user.html#dx1-212009" >819</a>, <a -href="glossaries-user.html#dx1-214017" >820</a>, <a -href="glossaries-user.html#dx1-214019" >821</a>, <a -href="glossaries-user.html#dx1-214041" >822</a>, <a -href="glossaries-user.html#dx1-220022" >823</a>, <a -href="glossaries-user.html#dx1-223009" >824</a> <br /></span> +href="glossaries-user.html#dx1-3002" >795</a>, <a +href="glossaries-user.html#dx1-3009" >796</a>, <a +href="glossaries-user.html#dx1-5010" >797</a>, <a +href="glossaries-user.html#dx1-9002" >798</a>, <a +href="glossaries-user.html#dx1-9009" >799</a>, <a +href="glossaries-user.html#dx1-9026" >800</a>, <a +href="glossaries-user.html#dx1-9045" >801</a>, <a +href="glossaries-user.html#dx1-11090" >802</a>, <a +href="glossaries-user.html#dx1-12004" >803</a>, <a +href="glossaries-user.html#dx1-13011" >804</a>, <a +href="glossaries-user.html#dx1-24006" >805</a>, <a +href="glossaries-user.html#dx1-35007" >806</a>, <a +href="glossaries-user.html#dx1-66003" >807</a>, <a +href="glossaries-user.html#dx1-68004" >808</a>, <a +href="glossaries-user.html#dx1-68007" >809</a>, <a +href="glossaries-user.html#dx1-113002" >810</a>, <a +href="glossaries-user.html#dx1-113007" >811</a>, <a +href="glossaries-user.html#dx1-146008" >812</a>, <a +href="glossaries-user.html#dx1-178049" >813</a>, <a +href="glossaries-user.html#dx1-179014" >814</a>, <a +href="glossaries-user.html#dx1-182045" >815</a>, <a +href="glossaries-user.html#dx1-191019" >816</a>, <a +href="glossaries-user.html#dx1-191037" >817</a>, <a +href="glossaries-user.html#dx1-193026" >818</a>, <a +href="glossaries-user.html#dx1-195033" >819</a>, <a +href="glossaries-user.html#dx1-195040" >820</a>, <a +href="glossaries-user.html#dx1-195049" >821</a>, <a +href="glossaries-user.html#dx1-195070" >822</a>, <a +href="glossaries-user.html#dx1-196005" >823</a>, <a +href="glossaries-user.html#dx1-197007" >824</a>, <a +href="glossaries-user.html#dx1-200008" >825</a>, <a +href="glossaries-user.html#dx1-200019" >826</a>, <a +href="glossaries-user.html#dx1-201019" >827</a>, <a +href="glossaries-user.html#dx1-201040" >828</a>, <a +href="glossaries-user.html#dx1-203058" >829</a>, <a +href="glossaries-user.html#dx1-203061" >830</a>, <a +href="glossaries-user.html#dx1-205051" >831</a>, <a +href="glossaries-user.html#dx1-205061" >832</a>, <a +href="glossaries-user.html#dx1-205089" >833</a>, <a +href="glossaries-user.html#dx1-205100" >834</a>, <a +href="glossaries-user.html#dx1-207021" >835</a>, <a +href="glossaries-user.html#dx1-209008" >836</a>, <a +href="glossaries-user.html#dx1-214041" >837</a>, <a +href="glossaries-user.html#dx1-214087" >838</a>, <a +href="glossaries-user.html#dx1-215009" >839</a>, <a +href="glossaries-user.html#dx1-217017" >840</a>, <a +href="glossaries-user.html#dx1-217019" >841</a>, <a +href="glossaries-user.html#dx1-217041" >842</a>, <a +href="glossaries-user.html#dx1-223022" >843</a>, <a +href="glossaries-user.html#dx1-226009" >844</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">dict</span>  <a -href="glossaries-user.html#dx1-15004" >825</a> <br /></span> +href="glossaries-user.html#dx1-15004" >845</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">docdefs</span>  <a -href="glossaries-user.html#dx1-31002" >826</a>, <a -href="glossaries-user.html#dx1-37005" >827</a>, <a -href="glossaries-user.html#dx1-37010" >828</a> <br /></span> +href="glossaries-user.html#dx1-31002" >846</a>, <a +href="glossaries-user.html#dx1-38005" >847</a>, <a +href="glossaries-user.html#dx1-38010" >848</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glg</span>  <a -href="glossaries-user.html#dx1-16081" >829</a>, <a -href="glossaries-user.html#dx1-19016" >830</a>, <a -href="glossaries-user.html#dx1-20013" >831</a>, <a -href="glossaries-user.html#dx1-214043" >832</a> <br /></span> +href="glossaries-user.html#dx1-16081" >849</a>, <a +href="glossaries-user.html#dx1-19016" >850</a>, <a +href="glossaries-user.html#dx1-20013" >851</a>, <a +href="glossaries-user.html#dx1-217043" >852</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glg2</span>  <a -href="glossaries-user.html#dx1-24" >833</a> <br /></span> +href="glossaries-user.html#dx1-23" >853</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glo</span>  <a -href="glossaries-user.html#dx1-7025" >834</a>, <a -href="glossaries-user.html#dx1-8026" >835</a>, <a -href="glossaries-user.html#dx1-17019" >836</a>, <a -href="glossaries-user.html#dx1-19018" >837</a>, <a -href="glossaries-user.html#dx1-20015" >838</a>, <a -href="glossaries-user.html#dx1-84001" >839</a>, <a -href="glossaries-user.html#dx1-190007" >840</a> <br /></span> +href="glossaries-user.html#dx1-7025" >854</a>, <a +href="glossaries-user.html#dx1-8026" >855</a>, <a +href="glossaries-user.html#dx1-17019" >856</a>, <a +href="glossaries-user.html#dx1-19018" >857</a>, <a +href="glossaries-user.html#dx1-20015" >858</a>, <a +href="glossaries-user.html#dx1-85001" >859</a>, <a +href="glossaries-user.html#dx1-193007" >860</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glo2</span>  <a -href="glossaries-user.html#dx1-23" >841</a> <br /></span> - - +href="glossaries-user.html#dx1-22" >861</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">gls</span>  <a -href="glossaries-user.html#dx1-19017" >842</a>, <a -href="glossaries-user.html#dx1-20014" >843</a> <br /></span> +href="glossaries-user.html#dx1-19017" >862</a>, <a +href="glossaries-user.html#dx1-20014" >863</a> <br /></span> + + <span class="index-subitem">    <span class="cmtt-10">gls2</span>  <a -href="glossaries-user.html#dx1-22" >844</a> <br /></span> +href="glossaries-user.html#dx1-21" >864</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glsdefs</span>  <a -href="glossaries-user.html#dx1-23003" >845</a>, <a -href="glossaries-user.html#dx1-122013" >846</a>, <a -href="glossaries-user.html#dx1-125013" >847</a>, <a -href="glossaries-user.html#dx1-125017" >848</a>, <a -href="glossaries-user.html#dx1-125018" >849</a> <br /></span> +href="glossaries-user.html#dx1-23004" >865</a>, <a +href="glossaries-user.html#dx1-123013" >866</a>, <a +href="glossaries-user.html#dx1-126015" >867</a>, <a +href="glossaries-user.html#dx1-126016" >868</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glslabels</span>  <a -href="glossaries-user.html#dx1-35001" >850</a> <br /></span> +href="glossaries-user.html#dx1-35001" >869</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glstex</span>  <a -href="glossaries-user.html#dx1-24004" >851</a>, <a -href="glossaries-user.html#dx1-24012" >852</a> <br /></span> +href="glossaries-user.html#dx1-24004" >870</a>, <a +href="glossaries-user.html#dx1-24012" >871</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">ist</span>  <a -href="glossaries-user.html#dx1-7026" >853</a>, <a -href="glossaries-user.html#dx1-20005" >854</a>, <a -href="glossaries-user.html#dx1-20007" >855</a>, <a -href="glossaries-user.html#dx1-22007" >856</a>, <a -href="glossaries-user.html#dx1-75007" >857</a>, <a -href="glossaries-user.html#dx1-111003" >858</a>, <a -href="glossaries-user.html#dx1-111012" >859</a> <br /></span> +href="glossaries-user.html#dx1-7026" >872</a>, <a +href="glossaries-user.html#dx1-20005" >873</a>, <a +href="glossaries-user.html#dx1-20007" >874</a>, <a +href="glossaries-user.html#dx1-22007" >875</a>, <a +href="glossaries-user.html#dx1-76007" >876</a>, <a +href="glossaries-user.html#dx1-112003" >877</a>, <a +href="glossaries-user.html#dx1-112012" >878</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">ldf</span>  <a -href="glossaries-user.html#dx1-15003" >860</a> <br /></span> +href="glossaries-user.html#dx1-15003" >879</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">lua</span>  <a -href="glossaries-user.html#dx1-18005" >861</a> <br /></span> +href="glossaries-user.html#dx1-18005" >880</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">tex</span>  <a -href="glossaries-user.html#dx1-3008" >862</a>, <a -href="glossaries-user.html#dx1-13014" >863</a>, <a -href="glossaries-user.html#dx1-13021" >864</a>, <a -href="glossaries-user.html#dx1-19010" >865</a>, <a -href="glossaries-user.html#dx1-20004" >866</a>, <a -href="glossaries-user.html#dx1-179071" >867</a>, <a -href="glossaries-user.html#dx1-211073" >868</a>, <a -href="glossaries-user.html#dx1-214020" >869</a>, <a -href="glossaries-user.html#dx1-214037" >870</a> <br /></span> +href="glossaries-user.html#dx1-3008" >881</a>, <a +href="glossaries-user.html#dx1-13014" >882</a>, <a +href="glossaries-user.html#dx1-13021" >883</a>, <a +href="glossaries-user.html#dx1-19010" >884</a>, <a +href="glossaries-user.html#dx1-20004" >885</a>, <a +href="glossaries-user.html#dx1-182071" >886</a>, <a +href="glossaries-user.html#dx1-214073" >887</a>, <a +href="glossaries-user.html#dx1-217020" >888</a>, <a +href="glossaries-user.html#dx1-217037" >889</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">toc</span>  <a -href="glossaries-user.html#dx1-178016" >871</a>, <a -href="glossaries-user.html#dx1-181008" >872</a> <br /></span> +href="glossaries-user.html#dx1-181016" >890</a>, <a +href="glossaries-user.html#dx1-184008" >891</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">xdy</span>  <a -href="glossaries-user.html#dx1-8027" >873</a>, <a -href="glossaries-user.html#dx1-19012" >874</a>, <a -href="glossaries-user.html#dx1-19013" >875</a>, <a -href="glossaries-user.html#dx1-22009" >876</a>, <a -href="glossaries-user.html#dx1-76007" >877</a>, <a -href="glossaries-user.html#dx1-111005" >878</a>, <a -href="glossaries-user.html#dx1-111009" >879</a>, <a -href="glossaries-user.html#dx1-111014" >880</a>, <a -href="glossaries-user.html#dx1-142005" >881</a>, <a -href="glossaries-user.html#dx1-211020" >882</a>, <a -href="glossaries-user.html#dx1-211022" >883</a>, <a -href="glossaries-user.html#dx1-211026" >884</a>, <a -href="glossaries-user.html#dx1-211028" >885</a>, <a -href="glossaries-user.html#dx1-211029" >886</a>, <a -href="glossaries-user.html#dx1-211033" >887</a>, <a -href="glossaries-user.html#dx1-212004" >888</a> <br /></span> +href="glossaries-user.html#dx1-8027" >892</a>, <a +href="glossaries-user.html#dx1-19012" >893</a>, <a +href="glossaries-user.html#dx1-19013" >894</a>, <a +href="glossaries-user.html#dx1-22009" >895</a>, <a +href="glossaries-user.html#dx1-77007" >896</a>, <a +href="glossaries-user.html#dx1-112005" >897</a>, <a +href="glossaries-user.html#dx1-112009" >898</a>, <a +href="glossaries-user.html#dx1-112014" >899</a>, <a +href="glossaries-user.html#dx1-166005" >900</a>, <a +href="glossaries-user.html#dx1-214020" >901</a>, <a +href="glossaries-user.html#dx1-214022" >902</a>, <a +href="glossaries-user.html#dx1-214026" >903</a>, <a +href="glossaries-user.html#dx1-214028" >904</a>, <a +href="glossaries-user.html#dx1-214029" >905</a>, <a +href="glossaries-user.html#dx1-214033" >906</a>, <a +href="glossaries-user.html#dx1-215004" >907</a> <br /></span> <span class="index-item">first use  <a -href="glossaries-user.html#dx1-3021" >889</a> <br /></span> +href="glossaries-user.html#dx1-3021" >908</a> <br /></span> <span class="index-subitem">    flag  <a -href="glossaries-user.html#dx1-3029" >890</a> <br /></span> +href="glossaries-user.html#dx1-3029" >909</a> <br /></span> <span class="index-subitem">    text  <a -href="glossaries-user.html#dx1-3030" >891</a> <br /></span> +href="glossaries-user.html#dx1-3030" >910</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\firstacronymfont</span></span></span>  <a -href="glossaries-user.html#dx1-135064" >892</a>, <a -href="glossaries-user.html#dx1-149001" ><span -class="cmti-10">893</span></a>, <a -href="glossaries-user.html#dx1-149003" >894</a>, <a -href="glossaries-user.html#dx1-149004" >895</a>, <a -href="glossaries-user.html#dx1-149006" >896</a>, <a -href="glossaries-user.html#dx1-149025" >897</a>, <a -href="glossaries-user.html#dx1-149033" >898</a> <br /></span> +href="glossaries-user.html#dx1-132064" >911</a>, <a +href="glossaries-user.html#dx1-138001" ><span +class="cmti-10">912</span></a>, <a +href="glossaries-user.html#dx1-138003" >913</a>, <a +href="glossaries-user.html#dx1-138004" >914</a>, <a +href="glossaries-user.html#dx1-138006" >915</a>, <a +href="glossaries-user.html#dx1-138025" >916</a>, <a +href="glossaries-user.html#dx1-138033" >917</a> <br /></span> <span class="index-item"><span class="cmss-10">flowfram </span>package  <a -href="glossaries-user.html#dx1-161011" >899</a> <br /></span> +href="glossaries-user.html#dx1-160011" >918</a> <br /></span> <span class="index-item"><span class="cmss-10">fmtcount </span>package  <a -href="glossaries-user.html#dx1-144050" >900</a>, <a -href="glossaries-user.html#dx1-144052" >901</a>, <a -href="glossaries-user.html#dx1-144053" >902</a>, <a -href="glossaries-user.html#dx1-213001" >903</a> <br /></span> +href="glossaries-user.html#dx1-168050" >919</a>, <a +href="glossaries-user.html#dx1-168052" >920</a>, <a +href="glossaries-user.html#dx1-168053" >921</a>, <a +href="glossaries-user.html#dx1-216001" >922</a> <br /></span> <span class="index-item"><span class="cmss-10">fontspec </span>package  <a -href="glossaries-user.html#dx1-112155" >904</a>, <a -href="glossaries-user.html#dx1-145006" >905</a> <br /></span> +href="glossaries-user.html#dx1-169006" >923</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\footnote</span></span></span>  <a -href="glossaries-user.html#dx1-149067" >906</a>, <a -href="glossaries-user.html#dx1-182018" >907</a>, <a -href="glossaries-user.html#dx1-182021" >908</a>, <a -href="glossaries-user.html#dx1-183004" >909</a>, <a -href="glossaries-user.html#dx1-183010" >910</a>, <a -href="glossaries-user.html#dx1-183015" >911</a>, <a -href="glossaries-user.html#dx1-183024" >912</a>, <a -href="glossaries-user.html#dx1-183036" >913</a>, <a -href="glossaries-user.html#dx1-184054" >914</a>, <a -href="glossaries-user.html#dx1-184057" >915</a> <br /></span> +href="glossaries-user.html#dx1-138067" >924</a>, <a +href="glossaries-user.html#dx1-185018" >925</a>, <a +href="glossaries-user.html#dx1-185021" >926</a>, <a +href="glossaries-user.html#dx1-186004" >927</a>, <a +href="glossaries-user.html#dx1-186010" >928</a>, <a +href="glossaries-user.html#dx1-186015" >929</a>, <a +href="glossaries-user.html#dx1-186024" >930</a>, <a +href="glossaries-user.html#dx1-186036" >931</a>, <a +href="glossaries-user.html#dx1-187054" >932</a>, <a +href="glossaries-user.html#dx1-187057" >933</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">\forallabbreviationlists</span></span></span>  <a +href="glossaries-user.html#dx1-171005" >934</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\forallacronyms</span></span></span>  <a -href="glossaries-user.html#dx1-168002" ><span -class="cmti-10">916</span></a> <br /></span> +href="glossaries-user.html#dx1-171002" ><span +class="cmti-10">935</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\forallglossaries</span></span></span>  <a -href="glossaries-user.html#dx1-168001" ><span -class="cmti-10">917</span></a> <br /></span> +href="glossaries-user.html#dx1-171001" ><span +class="cmti-10">936</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\forallglsentries</span></span></span>  <a -href="glossaries-user.html#dx1-168007" ><span -class="cmti-10">918</span></a> <br /></span> +href="glossaries-user.html#dx1-171008" ><span +class="cmti-10">937</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\foreignlanguage</span></span></span>  <a -href="glossaries-user.html#dx1-194031" >919</a>, <a -href="glossaries-user.html#dx1-194034" >920</a> <br /></span> +href="glossaries-user.html#dx1-197031" >938</a>, <a +href="glossaries-user.html#dx1-197034" >939</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\forglsentries</span></span></span>  <a -href="glossaries-user.html#dx1-168005" ><span -class="cmti-10">921</span></a> <br /></span> +href="glossaries-user.html#dx1-171006" ><span +class="cmti-10">940</span></a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">G</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Genacrfullformat</span></span></span>  <a -href="glossaries-user.html#dx1-135065" ><span -class="cmti-10">922</span></a> <br /></span> +href="glossaries-user.html#dx1-132065" ><span +class="cmti-10">941</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\genacrfullformat</span></span></span>  <a -href="glossaries-user.html#dx1-135059" ><span -class="cmti-10">923</span></a>, <a -href="glossaries-user.html#dx1-135070" >924</a>, <a -href="glossaries-user.html#dx1-148008" >925</a>, <a -href="glossaries-user.html#dx1-150015" >926</a>, <a -href="glossaries-user.html#dx1-150019" >927</a>, <a -href="glossaries-user.html#dx1-150048" >928</a> <br /></span> +href="glossaries-user.html#dx1-132059" ><span +class="cmti-10">942</span></a>, <a +href="glossaries-user.html#dx1-132070" >943</a>, <a +href="glossaries-user.html#dx1-137011" >944</a>, <a +href="glossaries-user.html#dx1-139015" >945</a>, <a +href="glossaries-user.html#dx1-139019" >946</a>, <a +href="glossaries-user.html#dx1-139048" >947</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GenericAcronymFields</span></span></span>  <a -href="glossaries-user.html#dx1-150022" ><span -class="cmti-10">929</span></a>, <a -href="glossaries-user.html#dx1-150064" >930</a>, <a -href="glossaries-user.html#dx1-150068" >931</a> <br /></span> +href="glossaries-user.html#dx1-139022" ><span +class="cmti-10">948</span></a>, <a +href="glossaries-user.html#dx1-139064" >949</a>, <a +href="glossaries-user.html#dx1-139068" >950</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Genplacrfullformat</span></span></span>  <a -href="glossaries-user.html#dx1-135066" ><span -class="cmti-10">932</span></a> <br /></span> +href="glossaries-user.html#dx1-132066" ><span +class="cmti-10">951</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\genplacrfullformat</span></span></span>  <a -href="glossaries-user.html#dx1-135061" ><span -class="cmti-10">933</span></a>, <a -href="glossaries-user.html#dx1-135071" >934</a> <br /></span> +href="glossaries-user.html#dx1-132061" ><span +class="cmti-10">952</span></a>, <a +href="glossaries-user.html#dx1-132071" >953</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glolinkprefix</span></span></span>  <a -href="glossaries-user.html#dx1-132088" >935</a>, <a -href="glossaries-user.html#dx1-141062" >936</a> <br /></span> +href="glossaries-user.html#dx1-129086" >954</a>, <a +href="glossaries-user.html#dx1-144069" >955</a> <br /></span> <span class="index-item"><span class="cmss-10">glossaries </span>package  <a -href="glossaries-user.html#dx1-12001" >937</a>, <a -href="glossaries-user.html#dx1-14008" >938</a>, <a -href="glossaries-user.html#dx1-32033" >939</a>, <a -href="glossaries-user.html#dx1-80005" >940</a>, <a -href="glossaries-user.html#dx1-107004" >941</a>, <a -href="glossaries-user.html#dx1-107007" >942</a>, <a -href="glossaries-user.html#dx1-122011" >943</a>, <a -href="glossaries-user.html#dx1-129008" >944</a>, <a -href="glossaries-user.html#dx1-129015" >945</a>, <a -href="glossaries-user.html#dx1-132021" >946</a>, <a -href="glossaries-user.html#dx1-132040" >947</a>, <a -href="glossaries-user.html#dx1-137012" >948</a>, <a -href="glossaries-user.html#dx1-172003" >949</a>, <a -href="glossaries-user.html#dx1-172004" >950</a>, <a -href="glossaries-user.html#dx1-172005" >951</a>, <a -href="glossaries-user.html#dx1-172010" >952</a>, <a -href="glossaries-user.html#dx1-178017" >953</a> <br /></span> +href="glossaries-user.html#dx1-12001" >956</a>, <a +href="glossaries-user.html#dx1-14008" >957</a>, <a +href="glossaries-user.html#dx1-32033" >958</a>, <a +href="glossaries-user.html#dx1-81005" >959</a>, <a +href="glossaries-user.html#dx1-108004" >960</a>, <a +href="glossaries-user.html#dx1-108007" >961</a>, <a +href="glossaries-user.html#dx1-123011" >962</a>, <a +href="glossaries-user.html#dx1-129019" >963</a>, <a +href="glossaries-user.html#dx1-129038" >964</a>, <a +href="glossaries-user.html#dx1-146013" >965</a>, <a +href="glossaries-user.html#dx1-151008" >966</a>, <a +href="glossaries-user.html#dx1-151015" >967</a>, <a +href="glossaries-user.html#dx1-175003" >968</a>, <a +href="glossaries-user.html#dx1-175004" >969</a>, <a +href="glossaries-user.html#dx1-175005" >970</a>, <a +href="glossaries-user.html#dx1-175010" >971</a>, <a +href="glossaries-user.html#dx1-181017" >972</a> <br /></span> <span class="index-item"><span class="cmss-10">glossaries-accsupp </span>package  <a -href="glossaries-user.html#dx1-30014" >954</a>, <a -href="glossaries-user.html#dx1-102001" >955</a>, <a -href="glossaries-user.html#dx1-112015" >956</a>, <a -href="glossaries-user.html#dx1-172001" >957</a>, <a -href="glossaries-user.html#dx1-172007" >958</a>, <a -href="glossaries-user.html#dx1-172011" >959</a>, <a -href="glossaries-user.html#dx1-172012" >960</a>, <a -href="glossaries-user.html#dx1-172056" >961</a>, <a -href="glossaries-user.html#dx1-172060" >962</a>, <a -href="glossaries-user.html#dx1-172064" >963</a>, <a -href="glossaries-user.html#dx1-224001" >964</a>, <a -href="glossaries-user.html#dx1-224006" >965</a>, <a -href="glossaries-user.html#dx1-224009" >966</a>, <a -href="glossaries-user.html#dx1-224010" >967</a>, <a -href="glossaries-user.html#dx1-224017" >968</a>, <a -href="glossaries-user.html#dx1-224038" >969</a> <br /></span> +href="glossaries-user.html#dx1-30014" >973</a>, <a +href="glossaries-user.html#dx1-103001" >974</a>, <a +href="glossaries-user.html#dx1-113020" >975</a>, <a +href="glossaries-user.html#dx1-175001" >976</a>, <a +href="glossaries-user.html#dx1-175007" >977</a>, <a +href="glossaries-user.html#dx1-175011" >978</a>, <a +href="glossaries-user.html#dx1-175012" >979</a>, <a +href="glossaries-user.html#dx1-175056" >980</a>, <a +href="glossaries-user.html#dx1-175060" >981</a>, <a +href="glossaries-user.html#dx1-175064" >982</a>, <a +href="glossaries-user.html#dx1-227001" >983</a>, <a +href="glossaries-user.html#dx1-227006" >984</a>, <a +href="glossaries-user.html#dx1-227009" >985</a>, <a +href="glossaries-user.html#dx1-227010" >986</a>, <a +href="glossaries-user.html#dx1-227017" >987</a>, <a +href="glossaries-user.html#dx1-227038" >988</a> <br /></span> <span class="index-item"><span class="cmss-10">glossaries-babel </span>package  <a -href="glossaries-user.html#dx1-32008" >970</a>, <a -href="glossaries-user.html#dx1-32019" >971</a> <br /></span> +href="glossaries-user.html#dx1-32008" >989</a>, <a +href="glossaries-user.html#dx1-32019" >990</a> <br /></span> <span class="index-item"><span class="cmss-10">glossaries-extra-bib2gls </span>package  <a -href="glossaries-user.html#dx1-220041" >972</a> <br /></span> +href="glossaries-user.html#dx1-223041" >991</a> <br /></span> <span class="index-item"><span class="cmss-10">glossaries-extra-stylemods </span>package  <a -href="glossaries-user.html#dx1-60001" >973</a>, <a -href="glossaries-user.html#dx1-155006" >974</a>, <a -href="glossaries-user.html#dx1-156043" >975</a> <br /></span> +href="glossaries-user.html#dx1-61001" >992</a>, <a +href="glossaries-user.html#dx1-154006" >993</a>, <a +href="glossaries-user.html#dx1-155044" >994</a> <br /></span> <span class="index-item"><span class="cmss-10">glossaries-polyglossia </span>package  <a -href="glossaries-user.html#dx1-32010" >976</a> <br /></span> +href="glossaries-user.html#dx1-32010" >995</a> <br /></span> <span class="index-item"><span class="cmss-10">glossaries-prefix </span>package  <a -href="glossaries-user.html#dx1-103001" >977</a>, <a -href="glossaries-user.html#dx1-112014" >978</a>, <a -href="glossaries-user.html#dx1-171001" >979</a>, <a -href="glossaries-user.html#dx1-171018" >980</a>, <a -href="glossaries-user.html#dx1-178005" >981</a>, <a -href="glossaries-user.html#dx1-178013" >982</a>, <a -href="glossaries-user.html#dx1-194006" >983</a>, <a -href="glossaries-user.html#dx1-194013" >984</a>, <a -href="glossaries-user.html#dx1-223001" >985</a>, <a -href="glossaries-user.html#dx1-223004" >986</a> <br /></span> +href="glossaries-user.html#dx1-104001" >996</a>, <a +href="glossaries-user.html#dx1-113019" >997</a>, <a +href="glossaries-user.html#dx1-174001" >998</a>, <a +href="glossaries-user.html#dx1-174018" >999</a>, <a +href="glossaries-user.html#dx1-181005" >1000</a>, <a +href="glossaries-user.html#dx1-181013" >1001</a>, <a +href="glossaries-user.html#dx1-197006" >1002</a>, <a +href="glossaries-user.html#dx1-197013" >1003</a>, <a +href="glossaries-user.html#dx1-226001" >1004</a>, <a +href="glossaries-user.html#dx1-226004" >1005</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">\glossariesextrasetup</span></span></span>  <a +href="glossaries-user.html#dx1-109019" >1006</a> <br /></span> <span class="index-item">glossary counters:<br /></span> <span class="index-subitem">    <span class="cmtt-10">glossaryentry</span>  <a -href="glossaries-user.html#dx1-46003" ><span -class="cmti-10">987</span></a> <br /></span> +href="glossaries-user.html#dx1-47003" ><span +class="cmti-10">1007</span></a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">glossarysubentry</span>  <a -href="glossaries-user.html#dx1-48003" ><span -class="cmti-10">988</span></a> <br /></span> +href="glossaries-user.html#dx1-49003" ><span +class="cmti-10">1008</span></a> <br /></span> <span class="index-item"><span class="cmss-10">glossary </span>package  <a -href="glossaries-user.html#dx1-16" >989</a>, <a -href="glossaries-user.html#dx1-107001" >990</a>, <a -href="glossaries-user.html#dx1-152001" >991</a>, <a -href="glossaries-user.html#dx1-152002" >992</a>, <a -href="glossaries-user.html#dx1-152005" >993</a> <br /></span> +href="glossaries-user.html#dx1-108001" >1009</a>, <a +href="glossaries-user.html#dx1-141001" >1010</a>, <a +href="glossaries-user.html#dx1-141002" >1011</a>, <a +href="glossaries-user.html#dx1-141005" >1012</a> <br /></span> <span class="index-item">glossary styles:<br /></span> -<span class="index-subitem">    <span -class="cmtt-10">altlist</span>  <a -href="glossaries-user.html#dx1-149048" >994</a>, <a -href="glossaries-user.html#dx1-149081" >995</a>, <a -href="glossaries-user.html#dx1-150069" >996</a>, <a -href="glossaries-user.html#dx1-157025" >997</a>, <a -href="glossaries-user.html#dx1-157031" >998</a>, <a -href="glossaries-user.html#dx1-179005" >999</a> <br /></span> <span class="index-subitem">    <span +class="cmtt-10">altlist</span>  <a +href="glossaries-user.html#dx1-138048" >1013</a>, <a +href="glossaries-user.html#dx1-138081" >1014</a>, <a +href="glossaries-user.html#dx1-139069" >1015</a>, <a +href="glossaries-user.html#dx1-156025" >1016</a>, <a +href="glossaries-user.html#dx1-156031" >1017</a>, <a +href="glossaries-user.html#dx1-182005" >1018</a> <br /></span> +<span class="index-subitem">    <span class="cmtt-10">altlistgroup</span>  <a -href="glossaries-user.html#dx1-157030" >1000</a>, <a -href="glossaries-user.html#dx1-157033" >1001</a> <br /></span> +href="glossaries-user.html#dx1-156030" >1019</a>, <a +href="glossaries-user.html#dx1-156033" >1020</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlisthypergroup</span>  <a -href="glossaries-user.html#dx1-157032" >1002</a> <br /></span> +href="glossaries-user.html#dx1-156032" >1021</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlong4col</span>  <a -href="glossaries-user.html#dx1-156024" >1003</a>, <a -href="glossaries-user.html#dx1-158032" >1004</a>, <a -href="glossaries-user.html#dx1-158039" >1005</a> <br /></span> +href="glossaries-user.html#dx1-155025" >1022</a>, <a +href="glossaries-user.html#dx1-157032" >1023</a>, <a +href="glossaries-user.html#dx1-157039" >1024</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlong4col-booktabs</span>  <a -href="glossaries-user.html#dx1-160031" >1006</a> <br /></span> +href="glossaries-user.html#dx1-159031" >1025</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlong4colborder</span>  <a -href="glossaries-user.html#dx1-158043" >1007</a> <br /></span> +href="glossaries-user.html#dx1-157043" >1026</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlong4colheader</span>  <a -href="glossaries-user.html#dx1-158045" >1008</a>, <a -href="glossaries-user.html#dx1-160032" >1009</a> <br /></span> +href="glossaries-user.html#dx1-157045" >1027</a>, <a +href="glossaries-user.html#dx1-159032" >1028</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlong4colheaderborder</span>  <a -href="glossaries-user.html#dx1-158047" >1010</a>, <a -href="glossaries-user.html#dx1-219004" >1011</a> <br /></span> +href="glossaries-user.html#dx1-157047" >1029</a>, <a +href="glossaries-user.html#dx1-222004" >1030</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlongragged4col</span>  <a -href="glossaries-user.html#dx1-159030" >1012</a>, <a -href="glossaries-user.html#dx1-159035" >1013</a>, <a -href="glossaries-user.html#dx1-159037" >1014</a> <br /></span> +href="glossaries-user.html#dx1-158030" >1031</a>, <a +href="glossaries-user.html#dx1-158035" >1032</a>, <a +href="glossaries-user.html#dx1-158037" >1033</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlongragged4col-booktabs</span>  <a -href="glossaries-user.html#dx1-160037" >1015</a>, <a -href="glossaries-user.html#dx1-219007" >1016</a> <br /></span> +href="glossaries-user.html#dx1-159037" >1034</a>, <a +href="glossaries-user.html#dx1-222007" >1035</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlongragged4colborder</span>  <a -href="glossaries-user.html#dx1-159034" >1017</a> <br /></span> +href="glossaries-user.html#dx1-158034" >1036</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlongragged4colheader</span>  <a -href="glossaries-user.html#dx1-159036" >1018</a>, <a -href="glossaries-user.html#dx1-159039" >1019</a>, <a -href="glossaries-user.html#dx1-160038" >1020</a> <br /></span> +href="glossaries-user.html#dx1-158036" >1037</a>, <a +href="glossaries-user.html#dx1-158039" >1038</a>, <a +href="glossaries-user.html#dx1-159038" >1039</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altlongragged4colheaderborder</span>  <a -href="glossaries-user.html#dx1-159038" >1021</a> <br /></span> +href="glossaries-user.html#dx1-158038" >1040</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuper4col</span>  <a -href="glossaries-user.html#dx1-156025" >1022</a>, <a -href="glossaries-user.html#dx1-161037" >1023</a>, <a -href="glossaries-user.html#dx1-161044" >1024</a> <br /></span> +href="glossaries-user.html#dx1-155026" >1041</a>, <a +href="glossaries-user.html#dx1-160037" >1042</a>, <a +href="glossaries-user.html#dx1-160044" >1043</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuper4colborder</span>  <a -href="glossaries-user.html#dx1-161048" >1025</a> <br /></span> +href="glossaries-user.html#dx1-160048" >1044</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuper4colheader</span>  <a -href="glossaries-user.html#dx1-161050" >1026</a> <br /></span> +href="glossaries-user.html#dx1-160050" >1045</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuper4colheaderborder</span>  <a -href="glossaries-user.html#dx1-161052" >1027</a> <br /></span> +href="glossaries-user.html#dx1-160052" >1046</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuperragged4col</span>  <a -href="glossaries-user.html#dx1-162031" >1028</a>, <a -href="glossaries-user.html#dx1-162034" >1029</a>, <a -href="glossaries-user.html#dx1-162036" >1030</a> <br /></span> +href="glossaries-user.html#dx1-161031" >1047</a>, <a +href="glossaries-user.html#dx1-161034" >1048</a>, <a +href="glossaries-user.html#dx1-161036" >1049</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuperragged4colborder</span>  <a -href="glossaries-user.html#dx1-162033" >1031</a> <br /></span> +href="glossaries-user.html#dx1-161033" >1050</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuperragged4colheader</span>  <a -href="glossaries-user.html#dx1-162035" >1032</a> <br /></span> +href="glossaries-user.html#dx1-161035" >1051</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">altsuperragged4colheaderborder</span>  <a -href="glossaries-user.html#dx1-162037" >1033</a> <br /></span> +href="glossaries-user.html#dx1-161037" >1052</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">alttree</span>  <a -href="glossaries-user.html#dx1-156028" >1034</a>, <a -href="glossaries-user.html#dx1-163010" >1035</a>, <a -href="glossaries-user.html#dx1-163013" >1036</a>, <a -href="glossaries-user.html#dx1-163034" >1037</a>, <a -href="glossaries-user.html#dx1-163047" >1038</a>, <a -href="glossaries-user.html#dx1-163052" >1039</a>, <a -href="glossaries-user.html#dx1-163056" >1040</a>, <a -href="glossaries-user.html#dx1-164040" >1041</a>, <a -href="glossaries-user.html#dx1-202042" >1042</a>, <a -href="glossaries-user.html#dx1-202046" >1043</a> <br /></span> +href="glossaries-user.html#dx1-155029" >1053</a>, <a +href="glossaries-user.html#dx1-162010" >1054</a>, <a +href="glossaries-user.html#dx1-162013" >1055</a>, <a +href="glossaries-user.html#dx1-162034" >1056</a>, <a +href="glossaries-user.html#dx1-162047" >1057</a>, <a +href="glossaries-user.html#dx1-162052" >1058</a>, <a +href="glossaries-user.html#dx1-162056" >1059</a>, <a +href="glossaries-user.html#dx1-163040" >1060</a>, <a +href="glossaries-user.html#dx1-205042" >1061</a>, <a +href="glossaries-user.html#dx1-205046" >1062</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">alttreegroup</span>  <a -href="glossaries-user.html#dx1-163055" >1044</a>, <a -href="glossaries-user.html#dx1-163058" >1045</a>, <a -href="glossaries-user.html#dx1-164042" >1046</a> <br /></span> +href="glossaries-user.html#dx1-162055" >1063</a>, <a +href="glossaries-user.html#dx1-162058" >1064</a>, <a +href="glossaries-user.html#dx1-163042" >1065</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">alttreehypergroup</span>  <a -href="glossaries-user.html#dx1-163057" >1047</a>, <a -href="glossaries-user.html#dx1-164045" >1048</a>, <a -href="glossaries-user.html#dx1-202001" >1049</a>, <a -href="glossaries-user.html#dx1-202007" >1050</a> <br /></span> +href="glossaries-user.html#dx1-162057" >1066</a>, <a +href="glossaries-user.html#dx1-163045" >1067</a>, <a +href="glossaries-user.html#dx1-205001" >1068</a>, <a +href="glossaries-user.html#dx1-205007" >1069</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">bookindex</span>  <a -href="glossaries-user.html#dx1-11072" >1051</a>, <a -href="glossaries-user.html#dx1-11084" >1052</a>, <a -href="glossaries-user.html#dx1-11085" >1053</a> <br /></span> +href="glossaries-user.html#dx1-11072" >1070</a>, <a +href="glossaries-user.html#dx1-11084" >1071</a>, <a +href="glossaries-user.html#dx1-11085" >1072</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">index</span>  <a -href="glossaries-user.html#dx1-53004" >1054</a>, <a -href="glossaries-user.html#dx1-157016" >1055</a>, <a -href="glossaries-user.html#dx1-157029" >1056</a>, <a -href="glossaries-user.html#dx1-157040" >1057</a>, <a -href="glossaries-user.html#dx1-163016" >1058</a>, <a -href="glossaries-user.html#dx1-163017" >1059</a>, <a -href="glossaries-user.html#dx1-163022" >1060</a>, <a -href="glossaries-user.html#dx1-163023" >1061</a>, <a -href="glossaries-user.html#dx1-163025" >1062</a>, <a -href="glossaries-user.html#dx1-163030" >1063</a>, <a -href="glossaries-user.html#dx1-164006" >1064</a>, <a -href="glossaries-user.html#dx1-164019" >1065</a> <br /></span> +href="glossaries-user.html#dx1-54004" >1073</a>, <a +href="glossaries-user.html#dx1-156016" >1074</a>, <a +href="glossaries-user.html#dx1-156029" >1075</a>, <a +href="glossaries-user.html#dx1-156040" >1076</a>, <a +href="glossaries-user.html#dx1-162016" >1077</a>, <a +href="glossaries-user.html#dx1-162017" >1078</a>, <a +href="glossaries-user.html#dx1-162022" >1079</a>, <a +href="glossaries-user.html#dx1-162023" >1080</a>, <a +href="glossaries-user.html#dx1-162025" >1081</a>, <a +href="glossaries-user.html#dx1-162030" >1082</a>, <a +href="glossaries-user.html#dx1-163006" >1083</a>, <a +href="glossaries-user.html#dx1-163019" >1084</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">indexgroup</span>  <a -href="glossaries-user.html#dx1-163024" >1066</a>, <a -href="glossaries-user.html#dx1-163027" >1067</a>, <a -href="glossaries-user.html#dx1-164021" >1068</a> <br /></span> +href="glossaries-user.html#dx1-144101" >1085</a>, <a +href="glossaries-user.html#dx1-162024" >1086</a>, <a +href="glossaries-user.html#dx1-162027" >1087</a>, <a +href="glossaries-user.html#dx1-163021" >1088</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">indexhypergroup</span>  <a -href="glossaries-user.html#dx1-163007" >1069</a>, <a -href="glossaries-user.html#dx1-163026" >1070</a>, <a -href="glossaries-user.html#dx1-164024" >1071</a> <br /></span> +href="glossaries-user.html#dx1-162007" >1089</a>, <a +href="glossaries-user.html#dx1-162026" >1090</a>, <a +href="glossaries-user.html#dx1-163024" >1091</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">inline</span>  <a -href="glossaries-user.html#dx1-165002" >1072</a>, <a -href="glossaries-user.html#dx1-165007" >1073</a>, <a -href="glossaries-user.html#dx1-201001" >1074</a> <br /></span> +href="glossaries-user.html#dx1-164002" >1092</a>, <a +href="glossaries-user.html#dx1-164007" >1093</a>, <a +href="glossaries-user.html#dx1-204001" >1094</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">list</span>  <a -href="glossaries-user.html#dx1-52003" >1075</a>, <a -href="glossaries-user.html#dx1-157010" >1076</a>, <a -href="glossaries-user.html#dx1-157018" >1077</a>, <a -href="glossaries-user.html#dx1-157026" >1078</a>, <a -href="glossaries-user.html#dx1-157027" >1079</a>, <a -href="glossaries-user.html#dx1-157028" >1080</a>, <a -href="glossaries-user.html#dx1-166008" >1081</a>, <a -href="glossaries-user.html#dx1-166017" >1082</a>, <a -href="glossaries-user.html#dx1-166035" >1083</a>, <a -href="glossaries-user.html#dx1-166051" >1084</a>, <a -href="glossaries-user.html#dx1-166093" >1085</a>, <a -href="glossaries-user.html#dx1-166095" >1086</a>, <a -href="glossaries-user.html#dx1-171064" >1087</a> <br /></span> +href="glossaries-user.html#dx1-53003" >1095</a>, <a +href="glossaries-user.html#dx1-156010" >1096</a>, <a +href="glossaries-user.html#dx1-156018" >1097</a>, <a +href="glossaries-user.html#dx1-156026" >1098</a>, <a +href="glossaries-user.html#dx1-156027" >1099</a>, <a +href="glossaries-user.html#dx1-156028" >1100</a>, <a +href="glossaries-user.html#dx1-165009" >1101</a>, <a +href="glossaries-user.html#dx1-165018" >1102</a>, <a +href="glossaries-user.html#dx1-165036" >1103</a>, <a +href="glossaries-user.html#dx1-165052" >1104</a>, <a +href="glossaries-user.html#dx1-165094" >1105</a>, <a +href="glossaries-user.html#dx1-165096" >1106</a>, <a +href="glossaries-user.html#dx1-174064" >1107</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">listdotted</span>  <a -href="glossaries-user.html#dx1-156038" >1088</a>, <a -href="glossaries-user.html#dx1-157006" >1089</a>, <a -href="glossaries-user.html#dx1-157043" >1090</a>, <a -href="glossaries-user.html#dx1-157044" >1091</a>, <a -href="glossaries-user.html#dx1-157045" >1092</a> <br /></span> +href="glossaries-user.html#dx1-155039" >1108</a>, <a +href="glossaries-user.html#dx1-156006" >1109</a>, <a +href="glossaries-user.html#dx1-156043" >1110</a>, <a +href="glossaries-user.html#dx1-156044" >1111</a>, <a +href="glossaries-user.html#dx1-156045" >1112</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">listgroup</span>  <a -href="glossaries-user.html#dx1-73020" >1093</a>, <a -href="glossaries-user.html#dx1-156006" >1094</a>, <a -href="glossaries-user.html#dx1-157017" >1095</a>, <a -href="glossaries-user.html#dx1-157020" >1096</a> <br /></span> +href="glossaries-user.html#dx1-74020" >1113</a>, <a +href="glossaries-user.html#dx1-155007" >1114</a>, <a +href="glossaries-user.html#dx1-156017" >1115</a>, <a +href="glossaries-user.html#dx1-156020" >1116</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">listhypergroup</span>  <a -href="glossaries-user.html#dx1-157019" >1097</a>, <a -href="glossaries-user.html#dx1-157034" >1098</a>, <a -href="glossaries-user.html#dx1-163009" >1099</a>, <a -href="glossaries-user.html#dx1-163028" >1100</a>, <a -href="glossaries-user.html#dx1-163039" >1101</a>, <a -href="glossaries-user.html#dx1-163046" >1102</a>, <a -href="glossaries-user.html#dx1-163059" >1103</a>, <a -href="glossaries-user.html#dx1-166032" >1104</a> <br /></span> +href="glossaries-user.html#dx1-156019" >1117</a>, <a +href="glossaries-user.html#dx1-156034" >1118</a>, <a +href="glossaries-user.html#dx1-162009" >1119</a>, <a +href="glossaries-user.html#dx1-162028" >1120</a>, <a +href="glossaries-user.html#dx1-162039" >1121</a>, <a +href="glossaries-user.html#dx1-162046" >1122</a>, <a +href="glossaries-user.html#dx1-162059" >1123</a>, <a +href="glossaries-user.html#dx1-165033" >1124</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long</span>  <a -href="glossaries-user.html#dx1-156027" >1105</a>, <a -href="glossaries-user.html#dx1-156034" >1106</a>, <a -href="glossaries-user.html#dx1-158007" >1107</a>, <a -href="glossaries-user.html#dx1-158014" >1108</a>, <a -href="glossaries-user.html#dx1-158016" >1109</a>, <a -href="glossaries-user.html#dx1-158020" >1110</a> <br /></span> +href="glossaries-user.html#dx1-155028" >1125</a>, <a +href="glossaries-user.html#dx1-155035" >1126</a>, <a +href="glossaries-user.html#dx1-157007" >1127</a>, <a +href="glossaries-user.html#dx1-157014" >1128</a>, <a +href="glossaries-user.html#dx1-157016" >1129</a>, <a +href="glossaries-user.html#dx1-157020" >1130</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long-booktabs</span>  <a -href="glossaries-user.html#dx1-160024" >1111</a>, <a -href="glossaries-user.html#dx1-160028" >1112</a> <br /></span> +href="glossaries-user.html#dx1-159024" >1131</a>, <a +href="glossaries-user.html#dx1-159028" >1132</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">long-name-desc-sym-loc</span>  <a -href="glossaries-user.html#dx1-219011" >1113</a> <br /></span> +href="glossaries-user.html#dx1-222011" >1133</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long3col</span>  <a -href="glossaries-user.html#dx1-156011" >1114</a>, <a -href="glossaries-user.html#dx1-158019" >1115</a>, <a -href="glossaries-user.html#dx1-158025" >1116</a>, <a -href="glossaries-user.html#dx1-158027" >1117</a>, <a -href="glossaries-user.html#dx1-158031" >1118</a> <br /></span> +href="glossaries-user.html#dx1-155012" >1134</a>, <a +href="glossaries-user.html#dx1-157019" >1135</a>, <a +href="glossaries-user.html#dx1-157025" >1136</a>, <a +href="glossaries-user.html#dx1-157027" >1137</a>, <a +href="glossaries-user.html#dx1-157031" >1138</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long3col-booktabs</span>  <a -href="glossaries-user.html#dx1-160026" >1119</a> <br /></span> +href="glossaries-user.html#dx1-159026" >1139</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long3colborder</span>  <a -href="glossaries-user.html#dx1-156013" >1120</a>, <a -href="glossaries-user.html#dx1-158024" >1121</a> <br /></span> +href="glossaries-user.html#dx1-155014" >1140</a>, <a +href="glossaries-user.html#dx1-157024" >1141</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long3colheader</span>  <a -href="glossaries-user.html#dx1-156012" >1122</a>, <a -href="glossaries-user.html#dx1-158026" >1123</a>, <a -href="glossaries-user.html#dx1-158029" >1124</a>, <a -href="glossaries-user.html#dx1-160027" >1125</a> <br /></span> +href="glossaries-user.html#dx1-155013" >1142</a>, <a +href="glossaries-user.html#dx1-157026" >1143</a>, <a +href="glossaries-user.html#dx1-157029" >1144</a>, <a +href="glossaries-user.html#dx1-159027" >1145</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long3colheaderborder</span>  <a -href="glossaries-user.html#dx1-156014" >1126</a>, <a -href="glossaries-user.html#dx1-158028" >1127</a> <br /></span> +href="glossaries-user.html#dx1-155015" >1146</a>, <a +href="glossaries-user.html#dx1-157028" >1147</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long4col</span>  <a -href="glossaries-user.html#dx1-156022" >1128</a>, <a -href="glossaries-user.html#dx1-158030" >1129</a>, <a -href="glossaries-user.html#dx1-158034" >1130</a>, <a -href="glossaries-user.html#dx1-158036" >1131</a>, <a -href="glossaries-user.html#dx1-158040" >1132</a> <br /></span> +href="glossaries-user.html#dx1-155023" >1148</a>, <a +href="glossaries-user.html#dx1-157030" >1149</a>, <a +href="glossaries-user.html#dx1-157034" >1150</a>, <a +href="glossaries-user.html#dx1-157036" >1151</a>, <a +href="glossaries-user.html#dx1-157040" >1152</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long4col-booktabs</span>  <a -href="glossaries-user.html#dx1-160029" >1133</a>, <a -href="glossaries-user.html#dx1-219006" >1134</a> <br /></span> +href="glossaries-user.html#dx1-159029" >1153</a>, <a +href="glossaries-user.html#dx1-222006" >1154</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long4colborder</span>  <a -href="glossaries-user.html#dx1-158033" >1135</a>, <a -href="glossaries-user.html#dx1-158044" >1136</a> <br /></span> +href="glossaries-user.html#dx1-157033" >1155</a>, <a +href="glossaries-user.html#dx1-157044" >1156</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long4colheader</span>  <a -href="glossaries-user.html#dx1-158035" >1137</a>, <a -href="glossaries-user.html#dx1-158038" >1138</a>, <a -href="glossaries-user.html#dx1-158046" >1139</a>, <a -href="glossaries-user.html#dx1-160030" >1140</a> <br /></span> +href="glossaries-user.html#dx1-157035" >1157</a>, <a +href="glossaries-user.html#dx1-157038" >1158</a>, <a +href="glossaries-user.html#dx1-157046" >1159</a>, <a +href="glossaries-user.html#dx1-159030" >1160</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long4colheaderborder</span>  <a -href="glossaries-user.html#dx1-158037" >1141</a>, <a -href="glossaries-user.html#dx1-158048" >1142</a>, <a -href="glossaries-user.html#dx1-219003" >1143</a> <br /></span> -<span class="index-subitem">    <span -class="cmtt-10">longborder</span>  <a -href="glossaries-user.html#dx1-158013" >1144</a> <br /></span> +href="glossaries-user.html#dx1-157037" >1161</a>, <a +href="glossaries-user.html#dx1-157048" >1162</a>, <a +href="glossaries-user.html#dx1-222003" >1163</a> <br /></span> <span class="index-subitem">    <span +class="cmtt-10">longborder</span>  <a +href="glossaries-user.html#dx1-157013" >1164</a> <br /></span> +<span class="index-subitem">    <span class="cmtt-10">longheader</span>  <a -href="glossaries-user.html#dx1-158015" >1145</a>, <a -href="glossaries-user.html#dx1-158018" >1146</a>, <a -href="glossaries-user.html#dx1-160025" >1147</a>, <a -href="glossaries-user.html#dx1-166019" >1148</a> <br /></span> +href="glossaries-user.html#dx1-157015" >1165</a>, <a +href="glossaries-user.html#dx1-157018" >1166</a>, <a +href="glossaries-user.html#dx1-159025" >1167</a>, <a +href="glossaries-user.html#dx1-165020" >1168</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longheaderborder</span>  <a -href="glossaries-user.html#dx1-158017" >1149</a>, <a -href="glossaries-user.html#dx1-141081" >1150</a> <br /></span> +href="glossaries-user.html#dx1-157017" >1169</a>, <a +href="glossaries-user.html#dx1-144091" >1170</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longragged</span>  <a -href="glossaries-user.html#dx1-159010" >1151</a>, <a -href="glossaries-user.html#dx1-159014" >1152</a>, <a -href="glossaries-user.html#dx1-159016" >1153</a>, <a -href="glossaries-user.html#dx1-159020" >1154</a> <br /></span> +href="glossaries-user.html#dx1-158010" >1171</a>, <a +href="glossaries-user.html#dx1-158014" >1172</a>, <a +href="glossaries-user.html#dx1-158016" >1173</a>, <a +href="glossaries-user.html#dx1-158020" >1174</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longragged-booktabs</span>  <a -href="glossaries-user.html#dx1-160033" >1155</a> <br /></span> +href="glossaries-user.html#dx1-159033" >1175</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longragged3col</span>  <a -href="glossaries-user.html#dx1-159019" >1156</a>, <a -href="glossaries-user.html#dx1-159025" >1157</a>, <a -href="glossaries-user.html#dx1-159027" >1158</a>, <a -href="glossaries-user.html#dx1-159031" >1159</a> <br /></span> +href="glossaries-user.html#dx1-158019" >1176</a>, <a +href="glossaries-user.html#dx1-158025" >1177</a>, <a +href="glossaries-user.html#dx1-158027" >1178</a>, <a +href="glossaries-user.html#dx1-158031" >1179</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longragged3col-booktabs</span>  <a -href="glossaries-user.html#dx1-160035" >1160</a> <br /></span> +href="glossaries-user.html#dx1-159035" >1180</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longragged3colborder</span>  <a -href="glossaries-user.html#dx1-159024" >1161</a> <br /></span> +href="glossaries-user.html#dx1-158024" >1181</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longragged3colheader</span>  <a -href="glossaries-user.html#dx1-159026" >1162</a>, <a -href="glossaries-user.html#dx1-159029" >1163</a>, <a -href="glossaries-user.html#dx1-160036" >1164</a> <br /></span> +href="glossaries-user.html#dx1-158026" >1182</a>, <a +href="glossaries-user.html#dx1-158029" >1183</a>, <a +href="glossaries-user.html#dx1-159036" >1184</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longragged3colheaderborder</span>  <a -href="glossaries-user.html#dx1-159028" >1165</a> <br /></span> +href="glossaries-user.html#dx1-158028" >1185</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longraggedborder</span>  <a -href="glossaries-user.html#dx1-159013" >1166</a> <br /></span> +href="glossaries-user.html#dx1-158013" >1186</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longraggedheader</span>  <a -href="glossaries-user.html#dx1-159015" >1167</a>, <a -href="glossaries-user.html#dx1-159018" >1168</a>, <a -href="glossaries-user.html#dx1-160034" >1169</a> <br /></span> +href="glossaries-user.html#dx1-158015" >1187</a>, <a +href="glossaries-user.html#dx1-158018" >1188</a>, <a +href="glossaries-user.html#dx1-159034" >1189</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longraggedheaderborder</span>  <a -href="glossaries-user.html#dx1-159017" >1170</a> <br /></span> +href="glossaries-user.html#dx1-158017" >1190</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolalttree</span>  <a -href="glossaries-user.html#dx1-164039" >1171</a> <br /></span> +href="glossaries-user.html#dx1-163039" >1191</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolalttreegroup</span>  <a -href="glossaries-user.html#dx1-164041" >1172</a> <br /></span> +href="glossaries-user.html#dx1-163041" >1192</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolalttreehypergroup</span>  <a -href="glossaries-user.html#dx1-164043" >1173</a> <br /></span> +href="glossaries-user.html#dx1-163043" >1193</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolalttreespannav</span>  <a -href="glossaries-user.html#dx1-164044" >1174</a> <br /></span> +href="glossaries-user.html#dx1-163044" >1194</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolindex</span>  <a -href="glossaries-user.html#dx1-164005" >1175</a>, <a -href="glossaries-user.html#dx1-164018" >1176</a> <br /></span> +href="glossaries-user.html#dx1-163005" >1195</a>, <a +href="glossaries-user.html#dx1-163018" >1196</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolindexgroup</span>  <a -href="glossaries-user.html#dx1-164020" >1177</a> <br /></span> +href="glossaries-user.html#dx1-163020" >1197</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolindexhypergroup</span>  <a -href="glossaries-user.html#dx1-164022" >1178</a> <br /></span> +href="glossaries-user.html#dx1-163022" >1198</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcolindexspannav</span>  <a -href="glossaries-user.html#dx1-164023" >1179</a> <br /></span> +href="glossaries-user.html#dx1-163023" >1199</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltree</span>  <a -href="glossaries-user.html#dx1-164025" >1180</a> <br /></span> +href="glossaries-user.html#dx1-163025" >1200</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltreegroup</span>  <a -href="glossaries-user.html#dx1-164027" >1181</a> <br /></span> +href="glossaries-user.html#dx1-163027" >1201</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltreehypergroup</span>  <a -href="glossaries-user.html#dx1-164029" >1182</a>, <a -href="glossaries-user.html#dx1-164046" >1183</a> <br /></span> +href="glossaries-user.html#dx1-163029" >1202</a>, <a +href="glossaries-user.html#dx1-163046" >1203</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltreenoname</span>  <a -href="glossaries-user.html#dx1-164032" >1184</a> <br /></span> +href="glossaries-user.html#dx1-163032" >1204</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltreenonamegroup</span>  <a -href="glossaries-user.html#dx1-164034" >1185</a> <br /></span> +href="glossaries-user.html#dx1-163034" >1205</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltreenonamehypergroup</span>  <a -href="glossaries-user.html#dx1-164036" >1186</a> <br /></span> +href="glossaries-user.html#dx1-163036" >1206</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltreenonamespannav</span>  <a -href="glossaries-user.html#dx1-164037" >1187</a> <br /></span> +href="glossaries-user.html#dx1-163037" >1207</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">mcoltreespannav</span>  <a -href="glossaries-user.html#dx1-164030" >1188</a> <br /></span> +href="glossaries-user.html#dx1-163030" >1208</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super</span>  <a -href="glossaries-user.html#dx1-161012" >1189</a>, <a -href="glossaries-user.html#dx1-161019" >1190</a>, <a -href="glossaries-user.html#dx1-161021" >1191</a>, <a -href="glossaries-user.html#dx1-161025" >1192</a> <br /></span> +href="glossaries-user.html#dx1-160012" >1209</a>, <a +href="glossaries-user.html#dx1-160019" >1210</a>, <a +href="glossaries-user.html#dx1-160021" >1211</a>, <a +href="glossaries-user.html#dx1-160025" >1212</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super3col</span>  <a -href="glossaries-user.html#dx1-161024" >1193</a>, <a -href="glossaries-user.html#dx1-161030" >1194</a>, <a -href="glossaries-user.html#dx1-161032" >1195</a>, <a -href="glossaries-user.html#dx1-161036" >1196</a> <br /></span> +href="glossaries-user.html#dx1-160024" >1213</a>, <a +href="glossaries-user.html#dx1-160030" >1214</a>, <a +href="glossaries-user.html#dx1-160032" >1215</a>, <a +href="glossaries-user.html#dx1-160036" >1216</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super3colborder</span>  <a -href="glossaries-user.html#dx1-161029" >1197</a> <br /></span> +href="glossaries-user.html#dx1-160029" >1217</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super3colheader</span>  <a -href="glossaries-user.html#dx1-161031" >1198</a>, <a -href="glossaries-user.html#dx1-161034" >1199</a> <br /></span> +href="glossaries-user.html#dx1-160031" >1218</a>, <a +href="glossaries-user.html#dx1-160034" >1219</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super3colheaderborder</span>  <a -href="glossaries-user.html#dx1-161033" >1200</a> <br /></span> +href="glossaries-user.html#dx1-160033" >1220</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super4col</span>  <a -href="glossaries-user.html#dx1-156023" >1201</a>, <a -href="glossaries-user.html#dx1-161035" >1202</a>, <a -href="glossaries-user.html#dx1-161039" >1203</a>, <a -href="glossaries-user.html#dx1-161041" >1204</a>, <a -href="glossaries-user.html#dx1-161045" >1205</a> <br /></span> +href="glossaries-user.html#dx1-155024" >1221</a>, <a +href="glossaries-user.html#dx1-160035" >1222</a>, <a +href="glossaries-user.html#dx1-160039" >1223</a>, <a +href="glossaries-user.html#dx1-160041" >1224</a>, <a +href="glossaries-user.html#dx1-160045" >1225</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super4colborder</span>  <a -href="glossaries-user.html#dx1-161038" >1206</a>, <a -href="glossaries-user.html#dx1-161049" >1207</a> <br /></span> +href="glossaries-user.html#dx1-160038" >1226</a>, <a +href="glossaries-user.html#dx1-160049" >1227</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super4colheader</span>  <a -href="glossaries-user.html#dx1-161040" >1208</a>, <a -href="glossaries-user.html#dx1-161043" >1209</a>, <a -href="glossaries-user.html#dx1-161051" >1210</a> <br /></span> +href="glossaries-user.html#dx1-160040" >1228</a>, <a +href="glossaries-user.html#dx1-160043" >1229</a>, <a +href="glossaries-user.html#dx1-160051" >1230</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">super4colheaderborder</span>  <a -href="glossaries-user.html#dx1-161042" >1211</a>, <a -href="glossaries-user.html#dx1-161053" >1212</a> <br /></span> +href="glossaries-user.html#dx1-160042" >1231</a>, <a +href="glossaries-user.html#dx1-160053" >1232</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superborder</span>  <a -href="glossaries-user.html#dx1-161018" >1213</a> <br /></span> +href="glossaries-user.html#dx1-160018" >1233</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superheader</span>  <a -href="glossaries-user.html#dx1-161020" >1214</a>, <a -href="glossaries-user.html#dx1-161023" >1215</a> <br /></span> +href="glossaries-user.html#dx1-160020" >1234</a>, <a +href="glossaries-user.html#dx1-160023" >1235</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superheaderborder</span>  <a -href="glossaries-user.html#dx1-141079" >1216</a>, <a -href="glossaries-user.html#dx1-161022" >1217</a> <br /></span> +href="glossaries-user.html#dx1-144089" >1236</a>, <a +href="glossaries-user.html#dx1-160022" >1237</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superragged</span>  <a -href="glossaries-user.html#dx1-162009" >1218</a>, <a -href="glossaries-user.html#dx1-162016" >1219</a>, <a -href="glossaries-user.html#dx1-162018" >1220</a>, <a -href="glossaries-user.html#dx1-162022" >1221</a> <br /></span> +href="glossaries-user.html#dx1-161009" >1238</a>, <a +href="glossaries-user.html#dx1-161016" >1239</a>, <a +href="glossaries-user.html#dx1-161018" >1240</a>, <a +href="glossaries-user.html#dx1-161022" >1241</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superragged3col</span>  <a -href="glossaries-user.html#dx1-162021" >1222</a>, <a -href="glossaries-user.html#dx1-162027" >1223</a>, <a -href="glossaries-user.html#dx1-162029" >1224</a>, <a -href="glossaries-user.html#dx1-162032" >1225</a> <br /></span> +href="glossaries-user.html#dx1-161021" >1242</a>, <a +href="glossaries-user.html#dx1-161027" >1243</a>, <a +href="glossaries-user.html#dx1-161029" >1244</a>, <a +href="glossaries-user.html#dx1-161032" >1245</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superragged3colborder</span>  <a -href="glossaries-user.html#dx1-162026" >1226</a> <br /></span> +href="glossaries-user.html#dx1-161026" >1246</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superragged3colheader</span>  <a -href="glossaries-user.html#dx1-162028" >1227</a> <br /></span> +href="glossaries-user.html#dx1-161028" >1247</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superragged3colheaderborder</span>  <a -href="glossaries-user.html#dx1-162030" >1228</a> <br /></span> -<span class="index-subitem">    <span -class="cmtt-10">superraggedborder</span>  <a -href="glossaries-user.html#dx1-162015" >1229</a> <br /></span> +href="glossaries-user.html#dx1-161030" >1248</a> <br /></span> <span class="index-subitem">    <span +class="cmtt-10">superraggedborder</span>  <a +href="glossaries-user.html#dx1-161015" >1249</a> <br /></span> +<span class="index-subitem">    <span class="cmtt-10">superraggedheader</span>  <a -href="glossaries-user.html#dx1-162017" >1230</a>, <a -href="glossaries-user.html#dx1-162020" >1231</a> <br /></span> +href="glossaries-user.html#dx1-161017" >1250</a>, <a +href="glossaries-user.html#dx1-161020" >1251</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">superraggedheaderborder</span>  <a -href="glossaries-user.html#dx1-162019" >1232</a> <br /></span> +href="glossaries-user.html#dx1-161019" >1252</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">topic</span>  <a -href="glossaries-user.html#dx1-202033" >1233</a>, <a -href="glossaries-user.html#dx1-202045" >1234</a>, <a -href="glossaries-user.html#dx1-202047" >1235</a>, <a -href="glossaries-user.html#dx1-202064" >1236</a> <br /></span> +href="glossaries-user.html#dx1-205033" >1253</a>, <a +href="glossaries-user.html#dx1-205045" >1254</a>, <a +href="glossaries-user.html#dx1-205047" >1255</a>, <a +href="glossaries-user.html#dx1-205064" >1256</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">tree</span>  <a -href="glossaries-user.html#dx1-150067" >1237</a>, <a -href="glossaries-user.html#dx1-163015" >1238</a>, <a -href="glossaries-user.html#dx1-163029" >1239</a>, <a -href="glossaries-user.html#dx1-163036" >1240</a>, <a -href="glossaries-user.html#dx1-163041" >1241</a>, <a -href="glossaries-user.html#dx1-163048" >1242</a>, <a -href="glossaries-user.html#dx1-164026" >1243</a>, <a -href="glossaries-user.html#dx1-202041" >1244</a> <br /></span> +href="glossaries-user.html#dx1-139067" >1257</a>, <a +href="glossaries-user.html#dx1-162015" >1258</a>, <a +href="glossaries-user.html#dx1-162029" >1259</a>, <a +href="glossaries-user.html#dx1-162036" >1260</a>, <a +href="glossaries-user.html#dx1-162041" >1261</a>, <a +href="glossaries-user.html#dx1-162048" >1262</a>, <a +href="glossaries-user.html#dx1-163026" >1263</a>, <a +href="glossaries-user.html#dx1-205041" >1264</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">treegroup</span>  <a -href="glossaries-user.html#dx1-163035" >1245</a>, <a -href="glossaries-user.html#dx1-163038" >1246</a>, <a -href="glossaries-user.html#dx1-164028" >1247</a> <br /></span> +href="glossaries-user.html#dx1-162035" >1265</a>, <a +href="glossaries-user.html#dx1-162038" >1266</a>, <a +href="glossaries-user.html#dx1-163028" >1267</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">treehypergroup</span>  <a -href="glossaries-user.html#dx1-157024" >1248</a>, <a -href="glossaries-user.html#dx1-163037" >1249</a>, <a -href="glossaries-user.html#dx1-164031" >1250</a> <br /></span> +href="glossaries-user.html#dx1-156024" >1268</a>, <a +href="glossaries-user.html#dx1-162037" >1269</a>, <a +href="glossaries-user.html#dx1-163031" >1270</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">treenoname</span>  <a -href="glossaries-user.html#dx1-163012" >1251</a>, <a -href="glossaries-user.html#dx1-163040" >1252</a>, <a -href="glossaries-user.html#dx1-163043" >1253</a>, <a -href="glossaries-user.html#dx1-164033" >1254</a> <br /></span> +href="glossaries-user.html#dx1-162012" >1271</a>, <a +href="glossaries-user.html#dx1-162040" >1272</a>, <a +href="glossaries-user.html#dx1-162043" >1273</a>, <a +href="glossaries-user.html#dx1-163033" >1274</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">treenonamegroup</span>  <a -href="glossaries-user.html#dx1-163042" >1255</a>, <a -href="glossaries-user.html#dx1-163045" >1256</a>, <a -href="glossaries-user.html#dx1-164035" >1257</a>, <a -href="glossaries-user.html#dx1-200093" >1258</a> <br /></span> +href="glossaries-user.html#dx1-162042" >1275</a>, <a +href="glossaries-user.html#dx1-162045" >1276</a>, <a +href="glossaries-user.html#dx1-163035" >1277</a>, <a +href="glossaries-user.html#dx1-203093" >1278</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">treenonamehypergroup</span>  <a -href="glossaries-user.html#dx1-163044" >1259</a>, <a -href="glossaries-user.html#dx1-164038" >1260</a> <br /></span> +href="glossaries-user.html#dx1-162044" >1279</a>, <a +href="glossaries-user.html#dx1-163038" >1280</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-bookindex </span>package  <a -href="glossaries-user.html#dx1-11073" >1261</a>, <a -href="glossaries-user.html#dx1-11075" >1262</a>, <a -href="glossaries-user.html#dx1-156004" >1263</a> <br /></span> +href="glossaries-user.html#dx1-11073" >1281</a>, <a +href="glossaries-user.html#dx1-11075" >1282</a>, <a +href="glossaries-user.html#dx1-155004" >1283</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-inline </span>package  <a -href="glossaries-user.html#dx1-165001" >1264</a>, <a -href="glossaries-user.html#dx1-165005" >1265</a> <br /></span> +href="glossaries-user.html#dx1-164001" >1284</a>, <a +href="glossaries-user.html#dx1-164005" >1285</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-list </span>package  <a -href="glossaries-user.html#dx1-49004" >1266</a>, <a -href="glossaries-user.html#dx1-52001" >1267</a>, <a -href="glossaries-user.html#dx1-52002" >1268</a>, <a -href="glossaries-user.html#dx1-141085" >1269</a>, <a -href="glossaries-user.html#dx1-157001" >1270</a>, <a -href="glossaries-user.html#dx1-179006" >1271</a> <br /></span> +href="glossaries-user.html#dx1-50004" >1286</a>, <a +href="glossaries-user.html#dx1-53001" >1287</a>, <a +href="glossaries-user.html#dx1-53002" >1288</a>, <a +href="glossaries-user.html#dx1-144095" >1289</a>, <a +href="glossaries-user.html#dx1-156001" >1290</a>, <a +href="glossaries-user.html#dx1-182006" >1291</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-long </span>package  <a -href="glossaries-user.html#dx1-49005" >1272</a>, <a -href="glossaries-user.html#dx1-50001" >1273</a>, <a -href="glossaries-user.html#dx1-50003" >1274</a>, <a -href="glossaries-user.html#dx1-141086" >1275</a>, <a -href="glossaries-user.html#dx1-158001" >1276</a>, <a -href="glossaries-user.html#dx1-159002" >1277</a>, <a -href="glossaries-user.html#dx1-160005" >1278</a>, <a -href="glossaries-user.html#dx1-160009" >1279</a>, <a -href="glossaries-user.html#dx1-178009" >1280</a> <br /></span> +href="glossaries-user.html#dx1-50005" >1292</a>, <a +href="glossaries-user.html#dx1-51001" >1293</a>, <a +href="glossaries-user.html#dx1-51003" >1294</a>, <a +href="glossaries-user.html#dx1-144096" >1295</a>, <a +href="glossaries-user.html#dx1-157001" >1296</a>, <a +href="glossaries-user.html#dx1-158002" >1297</a>, <a +href="glossaries-user.html#dx1-159005" >1298</a>, <a +href="glossaries-user.html#dx1-159009" >1299</a>, <a +href="glossaries-user.html#dx1-181009" >1300</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-longbooktabs </span>package  <a -href="glossaries-user.html#dx1-160001" >1281</a>, <a -href="glossaries-user.html#dx1-160004" >1282</a>, <a -href="glossaries-user.html#dx1-160007" >1283</a>, <a -href="glossaries-user.html#dx1-219008" >1284</a> <br /></span> +href="glossaries-user.html#dx1-159001" >1301</a>, <a +href="glossaries-user.html#dx1-159004" >1302</a>, <a +href="glossaries-user.html#dx1-159007" >1303</a>, <a +href="glossaries-user.html#dx1-222008" >1304</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">glossary-longextra </span>package  <a -href="glossaries-user.html#dx1-178012" >1285</a>, <a -href="glossaries-user.html#dx1-219010" >1286</a> <br /></span> +href="glossaries-user.html#dx1-181012" >1305</a>, <a +href="glossaries-user.html#dx1-222010" >1306</a> <br /></span> <span class="index-item"><span -class="cmss-10">glossary-longnoloc </span>package  <a -href="glossaries-user.html#dx1-156005" >1287</a> <br /></span> +class="cmss-10">glossary-longextra </span>package  <a +href="glossaries-user.html#dx1-155006" >1307</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-longragged </span>package  <a -href="glossaries-user.html#dx1-159001" >1288</a>, <a -href="glossaries-user.html#dx1-159005" >1289</a>, <a -href="glossaries-user.html#dx1-159007" >1290</a>, <a -href="glossaries-user.html#dx1-160006" >1291</a> <br /></span> +href="glossaries-user.html#dx1-158001" >1308</a>, <a +href="glossaries-user.html#dx1-158005" >1309</a>, <a +href="glossaries-user.html#dx1-158007" >1310</a>, <a +href="glossaries-user.html#dx1-159006" >1311</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-mcols </span>package  <a -href="glossaries-user.html#dx1-54001" >1292</a>, <a -href="glossaries-user.html#dx1-163053" >1293</a>, <a -href="glossaries-user.html#dx1-164001" >1294</a>, <a -href="glossaries-user.html#dx1-164010" >1295</a>, <a -href="glossaries-user.html#dx1-164012" >1296</a>, <a -href="glossaries-user.html#dx1-164013" >1297</a>, <a -href="glossaries-user.html#dx1-164017" >1298</a> <br /></span> +href="glossaries-user.html#dx1-55001" >1312</a>, <a +href="glossaries-user.html#dx1-162053" >1313</a>, <a +href="glossaries-user.html#dx1-163001" >1314</a>, <a +href="glossaries-user.html#dx1-163010" >1315</a>, <a +href="glossaries-user.html#dx1-163012" >1316</a>, <a +href="glossaries-user.html#dx1-163013" >1317</a>, <a +href="glossaries-user.html#dx1-163017" >1318</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-ragged </span>package  <a -href="glossaries-user.html#dx1-160010" >1299</a> <br /></span> +href="glossaries-user.html#dx1-159010" >1319</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-super </span>package  <a -href="glossaries-user.html#dx1-49006" >1300</a>, <a -href="glossaries-user.html#dx1-51001" >1301</a>, <a -href="glossaries-user.html#dx1-51003" >1302</a>, <a -href="glossaries-user.html#dx1-141087" >1303</a>, <a -href="glossaries-user.html#dx1-161001" >1304</a>, <a -href="glossaries-user.html#dx1-162002" >1305</a> <br /></span> +href="glossaries-user.html#dx1-50006" >1320</a>, <a +href="glossaries-user.html#dx1-52001" >1321</a>, <a +href="glossaries-user.html#dx1-52003" >1322</a>, <a +href="glossaries-user.html#dx1-144097" >1323</a>, <a +href="glossaries-user.html#dx1-160001" >1324</a>, <a +href="glossaries-user.html#dx1-161002" >1325</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-superragged </span>package  <a -href="glossaries-user.html#dx1-162001" >1306</a>, <a -href="glossaries-user.html#dx1-162005" >1307</a>, <a -href="glossaries-user.html#dx1-162007" >1308</a> <br /></span> +href="glossaries-user.html#dx1-161001" >1326</a>, <a +href="glossaries-user.html#dx1-161005" >1327</a>, <a +href="glossaries-user.html#dx1-161007" >1328</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmss-10">glossary-topic </span>package  <a -href="glossaries-user.html#dx1-202006" >1309</a>, <a -href="glossaries-user.html#dx1-202032" >1310</a> <br /></span> +href="glossaries-user.html#dx1-205006" >1329</a>, <a +href="glossaries-user.html#dx1-205032" >1330</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-topic </span>package  <a -href="glossaries-user.html#dx1-202037" >1311</a>, <a -href="glossaries-user.html#dx1-202039" >1312</a> <br /></span> +href="glossaries-user.html#dx1-155005" >1331</a>, <a +href="glossaries-user.html#dx1-205037" >1332</a>, <a +href="glossaries-user.html#dx1-205039" >1333</a> <br /></span> <span class="index-item"><span class="cmss-10">glossary-tree </span>package  <a -href="glossaries-user.html#dx1-49007" >1313</a>, <a -href="glossaries-user.html#dx1-53001" >1314</a>, <a -href="glossaries-user.html#dx1-53002" >1315</a>, <a -href="glossaries-user.html#dx1-53005" >1316</a>, <a -href="glossaries-user.html#dx1-141088" >1317</a>, <a -href="glossaries-user.html#dx1-163001" >1318</a>, <a -href="glossaries-user.html#dx1-163050" >1319</a>, <a -href="glossaries-user.html#dx1-164009" >1320</a>, <a -href="glossaries-user.html#dx1-202012" >1321</a>, <a -href="glossaries-user.html#dx1-202036" >1322</a>, <a -href="glossaries-user.html#dx1-202040" >1323</a>, <a -href="glossaries-user.html#dx1-202044" >1324</a> <br /></span> +href="glossaries-user.html#dx1-50007" >1334</a>, <a +href="glossaries-user.html#dx1-54001" >1335</a>, <a +href="glossaries-user.html#dx1-54002" >1336</a>, <a +href="glossaries-user.html#dx1-54005" >1337</a>, <a +href="glossaries-user.html#dx1-144098" >1338</a>, <a +href="glossaries-user.html#dx1-162001" >1339</a>, <a +href="glossaries-user.html#dx1-162050" >1340</a>, <a +href="glossaries-user.html#dx1-163009" >1341</a>, <a +href="glossaries-user.html#dx1-205012" >1342</a>, <a +href="glossaries-user.html#dx1-205036" >1343</a>, <a +href="glossaries-user.html#dx1-205040" >1344</a>, <a +href="glossaries-user.html#dx1-205044" >1345</a> <br /></span> <span class="index-item"><span class="cmtt-10">glossaryentry </span>(counter)  <a -href="glossaries-user.html#dx1-46002" ><span -class="cmti-10">1325</span></a>, <a -href="glossaries-user.html#dx1-47002" >1326</a>, <a -href="glossaries-user.html#dx1-47003" >1327</a>, <a -href="glossaries-user.html#dx1-47007" >1328</a> <br /></span> +href="glossaries-user.html#dx1-47002" ><span +class="cmti-10">1346</span></a>, <a +href="glossaries-user.html#dx1-48002" >1347</a>, <a +href="glossaries-user.html#dx1-48003" >1348</a>, <a +href="glossaries-user.html#dx1-48007" >1349</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossaryentrynumbers</span></span></span>  <a -href="glossaries-user.html#dx1-166052" >1329</a>, <a -href="glossaries-user.html#dx1-166057" >1330</a>, <a -href="glossaries-user.html#dx1-166058" >1331</a>, <a -href="glossaries-user.html#dx1-166060" >1332</a> <br /></span> +href="glossaries-user.html#dx1-165053" >1350</a>, <a +href="glossaries-user.html#dx1-165058" >1351</a>, <a +href="glossaries-user.html#dx1-165059" >1352</a>, <a +href="glossaries-user.html#dx1-165061" >1353</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossaryheader</span></span></span>  <a -href="glossaries-user.html#dx1-166015" ><span -class="cmti-10">1333</span></a>, <a -href="glossaries-user.html#dx1-166018" >1334</a>, <a -href="glossaries-user.html#dx1-166079" >1335</a> <br /></span> +href="glossaries-user.html#dx1-165016" ><span +class="cmti-10">1354</span></a>, <a +href="glossaries-user.html#dx1-165019" >1355</a>, <a +href="glossaries-user.html#dx1-165080" >1356</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossaryname</span></span></span>  <a -href="glossaries-user.html#dx1-14024" >1336</a>, <a -href="glossaries-user.html#dx1-32015" >1337</a> <br /></span> +href="glossaries-user.html#dx1-14024" >1357</a>, <a +href="glossaries-user.html#dx1-32015" >1358</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossarypostamble</span></span></span>  <a -href="glossaries-user.html#dx1-141076" ><span -class="cmti-10">1338</span></a>, <a -href="glossaries-user.html#dx1-166007" >1339</a> <br /></span> +href="glossaries-user.html#dx1-144086" ><span +class="cmti-10">1359</span></a>, <a +href="glossaries-user.html#dx1-165008" >1360</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossarypreamble</span></span></span>  <a -href="glossaries-user.html#dx1-47005" >1340</a>, <a -href="glossaries-user.html#dx1-141074" ><span -class="cmti-10">1341</span></a>, <a -href="glossaries-user.html#dx1-166006" >1342</a>, <a -href="glossaries-user.html#dx1-166016" >1343</a> <br /></span> +href="glossaries-user.html#dx1-48005" >1361</a>, <a +href="glossaries-user.html#dx1-144084" ><span +class="cmti-10">1362</span></a>, <a +href="glossaries-user.html#dx1-165007" >1363</a>, <a +href="glossaries-user.html#dx1-165017" >1364</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossarysection</span></span></span>  <a -href="glossaries-user.html#dx1-165004" >1344</a> <br /></span> +href="glossaries-user.html#dx1-164004" >1365</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossarystyle</span></span></span>  <a -href="glossaries-user.html#dx1-141027" >1345</a> <br /></span> +href="glossaries-user.html#dx1-144034" >1366</a> <br /></span> <span class="index-item"><span class="cmtt-10">glossarysubentry </span>(counter)  <a -href="glossaries-user.html#dx1-48002" ><span -class="cmti-10">1346</span></a> <br /></span> +href="glossaries-user.html#dx1-49002" ><span +class="cmti-10">1367</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossentry</span></span></span>  <a -href="glossaries-user.html#dx1-166038" ><span -class="cmti-10">1347</span></a>, <a -href="glossaries-user.html#dx1-166040" >1348</a>, <a -href="glossaries-user.html#dx1-166063" >1349</a> <br /></span> +href="glossaries-user.html#dx1-165039" ><span +class="cmti-10">1368</span></a>, <a +href="glossaries-user.html#dx1-165041" >1369</a>, <a +href="glossaries-user.html#dx1-165064" >1370</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glossentrydesc</span></span></span>  <a -href="glossaries-user.html#dx1-140028" ><span -class="cmti-10">1350</span></a>, <a -href="glossaries-user.html#dx1-189010" >1351</a> <br /></span> +href="glossaries-user.html#dx1-134028" ><span +class="cmti-10">1371</span></a>, <a +href="glossaries-user.html#dx1-192010" >1372</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossentrydesc</span></span></span>  <a -href="glossaries-user.html#dx1-11038" >1352</a>, <a -href="glossaries-user.html#dx1-140027" ><span -class="cmti-10">1353</span></a>, <a -href="glossaries-user.html#dx1-166042" >1354</a>, <a -href="glossaries-user.html#dx1-183027" >1355</a>, <a -href="glossaries-user.html#dx1-183037" >1356</a>, <a -href="glossaries-user.html#dx1-189011" >1357</a> <br /></span> +href="glossaries-user.html#dx1-11038" >1373</a>, <a +href="glossaries-user.html#dx1-134027" ><span +class="cmti-10">1374</span></a>, <a +href="glossaries-user.html#dx1-165043" >1375</a>, <a +href="glossaries-user.html#dx1-186027" >1376</a>, <a +href="glossaries-user.html#dx1-186037" >1377</a>, <a +href="glossaries-user.html#dx1-192011" >1378</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glossentryname</span></span></span>  <a -href="glossaries-user.html#dx1-140012" ><span -class="cmti-10">1358</span></a>, <a -href="glossaries-user.html#dx1-166086" >1359</a> <br /></span> +href="glossaries-user.html#dx1-134012" ><span +class="cmti-10">1379</span></a>, <a +href="glossaries-user.html#dx1-165087" >1380</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossentryname</span></span></span>  <a -href="glossaries-user.html#dx1-140011" ><span -class="cmti-10">1360</span></a>, <a -href="glossaries-user.html#dx1-166041" >1361</a>, <a -href="glossaries-user.html#dx1-166087" >1362</a> <br /></span> +href="glossaries-user.html#dx1-134011" ><span +class="cmti-10">1381</span></a>, <a +href="glossaries-user.html#dx1-165042" >1382</a>, <a +href="glossaries-user.html#dx1-165088" >1383</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">\glossentrynameother</span></span></span>  <a -href="glossaries-user.html#dx1-11088" >1363</a> <br /></span> +href="glossaries-user.html#dx1-11088" >1384</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glossentrysymbol</span></span></span>  <a -href="glossaries-user.html#dx1-140035" ><span -class="cmti-10">1364</span></a> <br /></span> +href="glossaries-user.html#dx1-134035" ><span +class="cmti-10">1385</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glossentrysymbol</span></span></span>  <a -href="glossaries-user.html#dx1-11014" >1365</a>, <a -href="glossaries-user.html#dx1-11042" >1366</a>, <a -href="glossaries-user.html#dx1-11043" >1367</a>, <a -href="glossaries-user.html#dx1-11046" >1368</a>, <a -href="glossaries-user.html#dx1-140034" ><span -class="cmti-10">1369</span></a>, <a -href="glossaries-user.html#dx1-166043" >1370</a> <br /></span> +href="glossaries-user.html#dx1-11014" >1386</a>, <a +href="glossaries-user.html#dx1-11042" >1387</a>, <a +href="glossaries-user.html#dx1-11043" >1388</a>, <a +href="glossaries-user.html#dx1-11046" >1389</a>, <a +href="glossaries-user.html#dx1-134034" ><span +class="cmti-10">1390</span></a>, <a +href="glossaries-user.html#dx1-165044" >1391</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLS</span></span></span>  <a -href="glossaries-user.html#dx1-3024" >1371</a>, <a -href="glossaries-user.html#dx1-112055" >1372</a>, <a -href="glossaries-user.html#dx1-133022" ><span -class="cmti-10">1373</span></a>, <a -href="glossaries-user.html#dx1-171029" >1374</a> <br /></span> +href="glossaries-user.html#dx1-3024" >1392</a>, <a +href="glossaries-user.html#dx1-113065" >1393</a>, <a +href="glossaries-user.html#dx1-130022" ><span +class="cmti-10">1394</span></a>, <a +href="glossaries-user.html#dx1-174029" >1395</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Gls</span></span></span>  <a -href="glossaries-user.html#dx1-3023" >1375</a>, <a -href="glossaries-user.html#dx1-13017" >1376</a>, <a -href="glossaries-user.html#dx1-112054" >1377</a>, <a -href="glossaries-user.html#dx1-112152" >1378</a>, <a -href="glossaries-user.html#dx1-133021" ><span -class="cmti-10">1379</span></a>, <a -href="glossaries-user.html#dx1-147046" >1380</a>, <a -href="glossaries-user.html#dx1-147113" >1381</a>, <a -href="glossaries-user.html#dx1-152009" >1382</a>, <a -href="glossaries-user.html#dx1-152011" >1383</a>, <a -href="glossaries-user.html#dx1-152013" >1384</a>, <a -href="glossaries-user.html#dx1-171027" >1385</a>, <a -href="glossaries-user.html#dx1-216003" >1386</a> <br /></span> -<span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\gls</span></span></span>  <a -href="glossaries-user.html#dx1-3022" >1387</a>, <a -href="glossaries-user.html#dx1-3043" >1388</a>, <a -href="glossaries-user.html#dx1-11027" >1389</a>, <a -href="glossaries-user.html#dx1-11068" >1390</a>, <a -href="glossaries-user.html#dx1-34006" >1391</a>, <a -href="glossaries-user.html#dx1-34016" >1392</a>, <a -href="glossaries-user.html#dx1-83001" >1393</a>, <a -href="glossaries-user.html#dx1-84009" >1394</a>, <a -href="glossaries-user.html#dx1-112029" >1395</a>, <a -href="glossaries-user.html#dx1-112032" >1396</a>, <a -href="glossaries-user.html#dx1-112038" >1397</a>, <a -href="glossaries-user.html#dx1-112040" >1398</a>, <a -href="glossaries-user.html#dx1-112053" >1399</a>, <a -href="glossaries-user.html#dx1-133011" ><span +href="glossaries-user.html#dx1-3023" >1396</a>, <a +href="glossaries-user.html#dx1-13017" >1397</a>, <a +href="glossaries-user.html#dx1-113064" >1398</a>, <a +href="glossaries-user.html#dx1-113172" >1399</a>, <a +href="glossaries-user.html#dx1-130021" ><span class="cmti-10">1400</span></a>, <a -href="glossaries-user.html#dx1-134020" >1401</a>, <a -href="glossaries-user.html#dx1-134023" >1402</a>, <a -href="glossaries-user.html#dx1-135016" >1403</a>, <a -href="glossaries-user.html#dx1-135039" >1404</a>, <a -href="glossaries-user.html#dx1-135063" >1405</a>, <a -href="glossaries-user.html#dx1-135085" >1406</a>, <a -href="glossaries-user.html#dx1-138005" >1407</a>, <a -href="glossaries-user.html#dx1-144023" >1408</a>, <a -href="glossaries-user.html#dx1-147037" >1409</a>, <a -href="glossaries-user.html#dx1-147111" >1410</a>, <a -href="glossaries-user.html#dx1-150041" >1411</a>, <a -href="glossaries-user.html#dx1-150074" >1412</a>, <a -href="glossaries-user.html#dx1-152008" >1413</a>, <a -href="glossaries-user.html#dx1-152010" >1414</a>, <a -href="glossaries-user.html#dx1-152012" >1415</a>, <a -href="glossaries-user.html#dx1-152020" >1416</a>, <a -href="glossaries-user.html#dx1-152022" >1417</a>, <a -href="glossaries-user.html#dx1-171019" >1418</a>, <a -href="glossaries-user.html#dx1-16069" >1419</a> <br /></span> +href="glossaries-user.html#dx1-135047" >1401</a>, <a +href="glossaries-user.html#dx1-136066" >1402</a>, <a +href="glossaries-user.html#dx1-141009" >1403</a>, <a +href="glossaries-user.html#dx1-141011" >1404</a>, <a +href="glossaries-user.html#dx1-141013" >1405</a>, <a +href="glossaries-user.html#dx1-174027" >1406</a>, <a +href="glossaries-user.html#dx1-219003" >1407</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\gls*</span></span></span>  <a -href="glossaries-user.html#dx1-34002" >1420</a> <br /></span> +class="cmtt-10">\gls</span></span></span>  <a +href="glossaries-user.html#dx1-3022" >1408</a>, <a +href="glossaries-user.html#dx1-3043" >1409</a>, <a +href="glossaries-user.html#dx1-11027" >1410</a>, <a +href="glossaries-user.html#dx1-11068" >1411</a>, <a +href="glossaries-user.html#dx1-34006" >1412</a>, <a +href="glossaries-user.html#dx1-34016" >1413</a>, <a +href="glossaries-user.html#dx1-84001" >1414</a>, <a +href="glossaries-user.html#dx1-85009" >1415</a>, <a +href="glossaries-user.html#dx1-113034" >1416</a>, <a +href="glossaries-user.html#dx1-113038" >1417</a>, <a +href="glossaries-user.html#dx1-113044" >1418</a>, <a +href="glossaries-user.html#dx1-113046" >1419</a>, <a +href="glossaries-user.html#dx1-113063" >1420</a>, <a +href="glossaries-user.html#dx1-130011" ><span +class="cmti-10">1421</span></a>, <a +href="glossaries-user.html#dx1-131020" >1422</a>, <a +href="glossaries-user.html#dx1-131023" >1423</a>, <a +href="glossaries-user.html#dx1-132016" >1424</a>, <a +href="glossaries-user.html#dx1-132039" >1425</a>, <a +href="glossaries-user.html#dx1-132063" >1426</a>, <a +href="glossaries-user.html#dx1-132085" >1427</a>, <a +href="glossaries-user.html#dx1-135006" >1428</a>, <a +href="glossaries-user.html#dx1-136064" >1429</a>, <a +href="glossaries-user.html#dx1-139041" >1430</a>, <a +href="glossaries-user.html#dx1-139074" >1431</a>, <a +href="glossaries-user.html#dx1-141008" >1432</a>, <a +href="glossaries-user.html#dx1-141010" >1433</a>, <a +href="glossaries-user.html#dx1-141012" >1434</a>, <a +href="glossaries-user.html#dx1-141020" >1435</a>, <a +href="glossaries-user.html#dx1-141022" >1436</a>, <a +href="glossaries-user.html#dx1-147005" >1437</a>, <a +href="glossaries-user.html#dx1-168023" >1438</a>, <a +href="glossaries-user.html#dx1-174019" >1439</a>, <a +href="glossaries-user.html#dx1-16069" >1440</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\gls*</span></span></span>  <a +href="glossaries-user.html#dx1-34002" >1441</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">\glsabbrvfont</span></span></span>  <a -href="glossaries-user.html#dx1-182012" >1421</a> <br /></span> +href="glossaries-user.html#dx1-185012" >1442</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsaccessibility</span></span></span>  <a -href="glossaries-user.html#dx1-172073" ><span -class="cmti-10">1422</span></a>, <a -href="glossaries-user.html#dx1-224025" >1423</a>, <a -href="glossaries-user.html#dx1-224029" >1424</a>, <a -href="glossaries-user.html#dx1-224084" >1425</a>, <a -href="glossaries-user.html#dx1-224085" >1426</a> <br /></span> +href="glossaries-user.html#dx1-175073" ><span +class="cmti-10">1443</span></a>, <a +href="glossaries-user.html#dx1-227025" >1444</a>, <a +href="glossaries-user.html#dx1-227029" >1445</a>, <a +href="glossaries-user.html#dx1-227084" >1446</a>, <a +href="glossaries-user.html#dx1-227085" >1447</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">\Glsaccesslong</span></span></span>  <a -href="glossaries-user.html#dx1-184031" >1427</a> <br /></span> +href="glossaries-user.html#dx1-187031" >1448</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">\glsaccesslong</span></span></span>  <a -href="glossaries-user.html#dx1-184013" >1428</a> <br /></span> +href="glossaries-user.html#dx1-187013" >1449</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">\Glsaccesslongpl</span></span></span>  <a -href="glossaries-user.html#dx1-184040" >1429</a> <br /></span> +href="glossaries-user.html#dx1-187040" >1450</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">\glsaccesslongpl</span></span></span>  <a -href="glossaries-user.html#dx1-184022" >1430</a> <br /></span> +href="glossaries-user.html#dx1-187022" >1451</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">\glsaccessshort</span></span></span>  <a -href="glossaries-user.html#dx1-184019" >1431</a>, <a -href="glossaries-user.html#dx1-184037" >1432</a> <br /></span> +href="glossaries-user.html#dx1-187019" >1452</a>, <a +href="glossaries-user.html#dx1-187037" >1453</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">\glsaccessshortpl</span></span></span>  <a -href="glossaries-user.html#dx1-184028" >1433</a>, <a -href="glossaries-user.html#dx1-184046" >1434</a> <br /></span> +href="glossaries-user.html#dx1-187028" >1454</a>, <a +href="glossaries-user.html#dx1-187046" >1455</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsaccsupp</span></span></span>  <a -href="glossaries-user.html#dx1-172065" ><span -class="cmti-10">1435</span></a>, <a -href="glossaries-user.html#dx1-224022" >1436</a> <br /></span> +href="glossaries-user.html#dx1-175065" ><span +class="cmti-10">1456</span></a>, <a +href="glossaries-user.html#dx1-227022" >1457</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsacrpluralsuffix</span></span></span>  <a -href="glossaries-user.html#dx1-147032" >1437</a> <br /></span> +href="glossaries-user.html#dx1-135037" >1458</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsacspace</span></span></span>  <a -href="glossaries-user.html#dx1-149029" ><span -class="cmti-10">1438</span></a> <br /></span> +href="glossaries-user.html#dx1-138029" ><span +class="cmti-10">1459</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsadd</span></span></span>  <a -href="glossaries-user.html#dx1-11015" >1439</a>, <a -href="glossaries-user.html#dx1-11028" >1440</a>, <a -href="glossaries-user.html#dx1-30015" >1441</a>, <a -href="glossaries-user.html#dx1-64002" >1442</a>, <a -href="glossaries-user.html#dx1-137001" ><span -class="cmti-10">1443</span></a>, <a -href="glossaries-user.html#dx1-193002" >1444</a>, <a -href="glossaries-user.html#dx1-193030" >1445</a> <br /></span> +href="glossaries-user.html#dx1-11015" >1460</a>, <a +href="glossaries-user.html#dx1-11028" >1461</a>, <a +href="glossaries-user.html#dx1-30015" >1462</a>, <a +href="glossaries-user.html#dx1-65002" >1463</a>, <a +href="glossaries-user.html#dx1-66001" >1464</a>, <a +href="glossaries-user.html#dx1-146001" ><span +class="cmti-10">1465</span></a>, <a +href="glossaries-user.html#dx1-196002" >1466</a>, <a +href="glossaries-user.html#dx1-196030" >1467</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsaddall</span></span></span>  <a -href="glossaries-user.html#dx1-127010" >1446</a>, <a -href="glossaries-user.html#dx1-137003" ><span -class="cmti-10">1447</span></a>, <a -href="glossaries-user.html#dx1-176002" >1448</a>, <a -href="glossaries-user.html#dx1-214027" >1449</a> <br /></span> +href="glossaries-user.html#dx1-146004" ><span +class="cmti-10">1468</span></a>, <a +href="glossaries-user.html#dx1-149010" >1469</a>, <a +href="glossaries-user.html#dx1-179002" >1470</a>, <a +href="glossaries-user.html#dx1-217027" >1471</a> <br /></span> <span class="index-item"><span class="cmtt-10">\glsaddall </span>options<br /></span> <span class="index-subitem">    <span class="cmtt-10">types</span>  <a -href="glossaries-user.html#dx1-137004" >1450</a> <br /></span> +href="glossaries-user.html#dx1-146005" >1472</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsaddallunused</span></span></span>  <a -href="glossaries-user.html#dx1-137010" ><span -class="cmti-10">1451</span></a> <br /></span> +href="glossaries-user.html#dx1-146011" ><span +class="cmti-10">1473</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsaddkey</span></span></span>  <a -href="glossaries-user.html#dx1-112108" >1452</a>, <a -href="glossaries-user.html#dx1-113003" >1453</a>, <a -href="glossaries-user.html#dx1-114001" >1454</a>, <a -href="glossaries-user.html#dx1-116001" ><span -class="cmti-10">1455</span></a>, <a -href="glossaries-user.html#dx1-206001" >1456</a> <br /></span> +href="glossaries-user.html#dx1-113121" >1474</a>, <a +href="glossaries-user.html#dx1-114003" >1475</a>, <a +href="glossaries-user.html#dx1-115001" >1476</a>, <a +href="glossaries-user.html#dx1-117001" ><span +class="cmti-10">1477</span></a>, <a +href="glossaries-user.html#dx1-209001" >1478</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsAddLetterGroup</span></span></span>  <a -href="glossaries-user.html#dx1-211032" >1457</a> <br /></span> +href="glossaries-user.html#dx1-214032" >1479</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsaddprotectedpagefmt</span></span></span>  <a -href="glossaries-user.html#dx1-129016" ><span -class="cmti-10">1458</span></a> <br /></span> +href="glossaries-user.html#dx1-151016" ><span +class="cmti-10">1480</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsaddstoragekey</span></span></span>  <a -href="glossaries-user.html#dx1-112109" >1459</a>, <a -href="glossaries-user.html#dx1-117001" ><span -class="cmti-10">1460</span></a>, <a -href="glossaries-user.html#dx1-136028" >1461</a>, <a -href="glossaries-user.html#dx1-150072" >1462</a>, <a -href="glossaries-user.html#dx1-185002" >1463</a>, <a -href="glossaries-user.html#dx1-186001" >1464</a>, <a -href="glossaries-user.html#dx1-207001" >1465</a>, <a -href="glossaries-user.html#dx1-209001" >1466</a> <br /></span> +href="glossaries-user.html#dx1-113122" >1481</a>, <a +href="glossaries-user.html#dx1-118001" ><span +class="cmti-10">1482</span></a>, <a +href="glossaries-user.html#dx1-133028" >1483</a>, <a +href="glossaries-user.html#dx1-139072" >1484</a>, <a +href="glossaries-user.html#dx1-188002" >1485</a>, <a +href="glossaries-user.html#dx1-189001" >1486</a>, <a +href="glossaries-user.html#dx1-210001" >1487</a>, <a +href="glossaries-user.html#dx1-212001" >1488</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsAddXdyAttribute</span></span></span>  <a -href="glossaries-user.html#dx1-132051" >1467</a>, <a -href="glossaries-user.html#dx1-144015" ><span -class="cmti-10">1468</span></a>, <a -href="glossaries-user.html#dx1-190018" >1469</a> <br /></span> +href="glossaries-user.html#dx1-129049" >1489</a>, <a +href="glossaries-user.html#dx1-168015" ><span +class="cmti-10">1490</span></a>, <a +href="glossaries-user.html#dx1-193018" >1491</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsAddXdyCounters</span></span></span>  <a -href="glossaries-user.html#dx1-144009" ><span -class="cmti-10">1470</span></a>, <a -href="glossaries-user.html#dx1-144043" >1471</a> <br /></span> +href="glossaries-user.html#dx1-168009" ><span +class="cmti-10">1492</span></a>, <a +href="glossaries-user.html#dx1-168043" >1493</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsAddXdyLocation</span></span></span>  <a -href="glossaries-user.html#dx1-144027" ><span -class="cmti-10">1472</span></a>, <a -href="glossaries-user.html#dx1-144059" >1473</a> <br /></span> +href="glossaries-user.html#dx1-168027" ><span +class="cmti-10">1494</span></a>, <a +href="glossaries-user.html#dx1-168059" >1495</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsautoprefix</span></span></span>  <a -href="glossaries-user.html#dx1-43006" ><span -class="cmti-10">1474</span></a> <br /></span> +href="glossaries-user.html#dx1-44006" ><span +class="cmti-10">1496</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsbackslash</span></span></span>  <a -href="glossaries-user.html#dx1-142012" ><span -class="cmti-10">1475</span></a> <br /></span> +href="glossaries-user.html#dx1-166012" ><span +class="cmti-10">1497</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glscapscase</span></span></span>  <a -href="glossaries-user.html#dx1-135021" ><span -class="cmti-10">1476</span></a>, <a -href="glossaries-user.html#dx1-135034" >1477</a>, <a -href="glossaries-user.html#dx1-150006" >1478</a> <br /></span> +href="glossaries-user.html#dx1-132021" ><span +class="cmti-10">1498</span></a>, <a +href="glossaries-user.html#dx1-132034" >1499</a>, <a +href="glossaries-user.html#dx1-139006" >1500</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">\glscategory</span></span></span>  <a -href="glossaries-user.html#dx1-207003" >1479</a> <br /></span> +href="glossaries-user.html#dx1-210003" >1501</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsclearpage</span></span></span>  <a -href="glossaries-user.html#dx1-41008" ><span -class="cmti-10">1480</span></a> <br /></span> +href="glossaries-user.html#dx1-42008" ><span +class="cmti-10">1502</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsclosebrace</span></span></span>  <a -href="glossaries-user.html#dx1-142008" ><span -class="cmti-10">1481</span></a> <br /></span> +href="glossaries-user.html#dx1-166008" ><span +class="cmti-10">1503</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glscurrententrylabel</span></span></span>  <a -href="glossaries-user.html#dx1-194033" >1482</a>, <a -href="glossaries-user.html#dx1-200021" >1483</a>, <a -href="glossaries-user.html#dx1-200023" >1484</a>, <a -href="glossaries-user.html#dx1-200026" >1485</a>, <a -href="glossaries-user.html#dx1-200028" >1486</a>, <a -href="glossaries-user.html#dx1-200033" >1487</a>, <a -href="glossaries-user.html#dx1-202029" >1488</a> <br /></span> +href="glossaries-user.html#dx1-197033" >1504</a>, <a +href="glossaries-user.html#dx1-203021" >1505</a>, <a +href="glossaries-user.html#dx1-203023" >1506</a>, <a +href="glossaries-user.html#dx1-203026" >1507</a>, <a +href="glossaries-user.html#dx1-203028" >1508</a>, <a +href="glossaries-user.html#dx1-203033" >1509</a>, <a +href="glossaries-user.html#dx1-205029" >1510</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-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> +href="glossaries-user.html#dx1-172031" ><span +class="cmti-10">1511</span></a>, <a +href="glossaries-user.html#dx1-203024" >1512</a>, <a +href="glossaries-user.html#dx1-205025" >1513</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glscustomtext</span></span></span>  <a -href="glossaries-user.html#dx1-135015" ><span -class="cmti-10">1492</span></a>, <a -href="glossaries-user.html#dx1-135036" >1493</a>, <a -href="glossaries-user.html#dx1-147049" >1494</a> <br /></span> +href="glossaries-user.html#dx1-132015" ><span +class="cmti-10">1514</span></a>, <a +href="glossaries-user.html#dx1-132036" >1515</a>, <a +href="glossaries-user.html#dx1-136002" >1516</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsDeclareNoHyperList</span></span></span>  <a -href="glossaries-user.html#dx1-83003" >1495</a>, <a -href="glossaries-user.html#dx1-87014" >1496</a>, <a -href="glossaries-user.html#dx1-221002" >1497</a> <br /></span> +href="glossaries-user.html#dx1-84003" >1517</a>, <a +href="glossaries-user.html#dx1-88014" >1518</a>, <a +href="glossaries-user.html#dx1-224002" >1519</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdefaultshortaccess</span></span></span>  <a -href="glossaries-user.html#dx1-172063" ><span -class="cmti-10">1498</span></a>, <a -href="glossaries-user.html#dx1-224055" >1499</a> <br /></span> +href="glossaries-user.html#dx1-175063" ><span +class="cmti-10">1520</span></a>, <a +href="glossaries-user.html#dx1-227055" >1521</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdefaulttype</span></span></span>  <a -href="glossaries-user.html#dx1-122005" >1500</a>, <a -href="glossaries-user.html#dx1-135008" >1501</a>, <a -href="glossaries-user.html#dx1-168006" >1502</a>, <a -href="glossaries-user.html#dx1-90009" >1503</a>, <a -href="glossaries-user.html#dx1-90011" >1504</a>, <a -href="glossaries-user.html#dx1-122023" >1505</a> <br /></span> +href="glossaries-user.html#dx1-123005" >1522</a>, <a +href="glossaries-user.html#dx1-132008" >1523</a>, <a +href="glossaries-user.html#dx1-171007" >1524</a>, <a +href="glossaries-user.html#dx1-91009" >1525</a>, <a +href="glossaries-user.html#dx1-91011" >1526</a>, <a +href="glossaries-user.html#dx1-123023" >1527</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">\glsdefpostdesc</span></span></span>  <a -href="glossaries-user.html#dx1-200019" >1506</a>, <a -href="glossaries-user.html#dx1-202027" >1507</a>, <a -href="glossaries-user.html#dx1-202076" >1508</a> <br /></span> +href="glossaries-user.html#dx1-203019" >1528</a>, <a +href="glossaries-user.html#dx1-205027" >1529</a>, <a +href="glossaries-user.html#dx1-205076" >1530</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">\glsdefpostlink</span></span></span>  <a -href="glossaries-user.html#dx1-183013" >1509</a>, <a -href="glossaries-user.html#dx1-183021" >1510</a>, <a -href="glossaries-user.html#dx1-183033" >1511</a>, <a -href="glossaries-user.html#dx1-202021" >1512</a>, <a -href="glossaries-user.html#dx1-222007" >1513</a> <br /></span> +href="glossaries-user.html#dx1-113047" >1531</a>, <a +href="glossaries-user.html#dx1-186013" >1532</a>, <a +href="glossaries-user.html#dx1-186021" >1533</a>, <a +href="glossaries-user.html#dx1-186033" >1534</a>, <a +href="glossaries-user.html#dx1-205021" >1535</a>, <a +href="glossaries-user.html#dx1-225007" >1536</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSdesc</span></span></span>  <a -href="glossaries-user.html#dx1-134054" ><span -class="cmti-10">1514</span></a> <br /></span> +href="glossaries-user.html#dx1-131054" ><span +class="cmti-10">1537</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsdesc</span></span></span>  <a -href="glossaries-user.html#dx1-134053" ><span -class="cmti-10">1515</span></a> <br /></span> +href="glossaries-user.html#dx1-131053" ><span +class="cmti-10">1538</span></a>, <a +href="glossaries-user.html#dx1-147009" >1539</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdesc</span></span></span>  <a -href="glossaries-user.html#dx1-134050" ><span -class="cmti-10">1516</span></a>, <a -href="glossaries-user.html#dx1-189008" >1517</a>, <a -href="glossaries-user.html#dx1-189016" >1518</a>, <a -href="glossaries-user.html#dx1-189019" >1519</a>, <a -href="glossaries-user.html#dx1-189020" >1520</a>, <a -href="glossaries-user.html#dx1-189021" >1521</a>, <a -href="glossaries-user.html#dx1-189024" >1522</a>, <a -href="glossaries-user.html#dx1-192018" >1523</a>, <a -href="glossaries-user.html#dx1-192026" >1524</a> <br /></span> +href="glossaries-user.html#dx1-131050" ><span +class="cmti-10">1540</span></a>, <a +href="glossaries-user.html#dx1-147008" >1541</a>, <a +href="glossaries-user.html#dx1-192008" >1542</a>, <a +href="glossaries-user.html#dx1-192016" >1543</a>, <a +href="glossaries-user.html#dx1-192019" >1544</a>, <a +href="glossaries-user.html#dx1-192020" >1545</a>, <a +href="glossaries-user.html#dx1-192021" >1546</a>, <a +href="glossaries-user.html#dx1-192024" >1547</a>, <a +href="glossaries-user.html#dx1-195018" >1548</a>, <a +href="glossaries-user.html#dx1-195026" >1549</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdescwidth</span></span></span>  <a -href="glossaries-user.html#dx1-156016" ><span -class="cmti-10">1525</span></a>, <a -href="glossaries-user.html#dx1-158012" >1526</a>, <a -href="glossaries-user.html#dx1-158022" >1527</a>, <a -href="glossaries-user.html#dx1-158041" >1528</a>, <a -href="glossaries-user.html#dx1-159012" >1529</a>, <a -href="glossaries-user.html#dx1-159022" >1530</a>, <a -href="glossaries-user.html#dx1-159032" >1531</a>, <a -href="glossaries-user.html#dx1-161017" >1532</a>, <a -href="glossaries-user.html#dx1-161027" >1533</a>, <a -href="glossaries-user.html#dx1-161046" >1534</a>, <a -href="glossaries-user.html#dx1-162014" >1535</a>, <a -href="glossaries-user.html#dx1-162024" >1536</a> <br /></span> +href="glossaries-user.html#dx1-155017" ><span +class="cmti-10">1550</span></a>, <a +href="glossaries-user.html#dx1-157012" >1551</a>, <a +href="glossaries-user.html#dx1-157022" >1552</a>, <a +href="glossaries-user.html#dx1-157041" >1553</a>, <a +href="glossaries-user.html#dx1-158012" >1554</a>, <a +href="glossaries-user.html#dx1-158022" >1555</a>, <a +href="glossaries-user.html#dx1-158032" >1556</a>, <a +href="glossaries-user.html#dx1-160017" >1557</a>, <a +href="glossaries-user.html#dx1-160027" >1558</a>, <a +href="glossaries-user.html#dx1-160046" >1559</a>, <a +href="glossaries-user.html#dx1-161014" >1560</a>, <a +href="glossaries-user.html#dx1-161024" >1561</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdisablehyper</span></span></span>  <a -href="glossaries-user.html#dx1-132038" >1537</a>, <a -href="glossaries-user.html#dx1-135025" >1538</a>, <a -href="glossaries-user.html#dx1-136005" ><span -class="cmti-10">1539</span></a>, <a -href="glossaries-user.html#dx1-136020" >1540</a>, <a -href="glossaries-user.html#dx1-140056" >1541</a> <br /></span> +href="glossaries-user.html#dx1-129036" >1562</a>, <a +href="glossaries-user.html#dx1-132025" >1563</a>, <a +href="glossaries-user.html#dx1-133005" ><span +class="cmti-10">1564</span></a>, <a +href="glossaries-user.html#dx1-133020" >1565</a>, <a +href="glossaries-user.html#dx1-134056" >1566</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdisp</span></span></span>  <a -href="glossaries-user.html#dx1-3028" >1542</a>, <a -href="glossaries-user.html#dx1-3034" >1543</a>, <a -href="glossaries-user.html#dx1-34007" >1544</a>, <a -href="glossaries-user.html#dx1-112037" >1545</a>, <a -href="glossaries-user.html#dx1-133003" >1546</a>, <a -href="glossaries-user.html#dx1-133056" ><span -class="cmti-10">1547</span></a> <br /></span> +href="glossaries-user.html#dx1-3028" >1567</a>, <a +href="glossaries-user.html#dx1-3034" >1568</a>, <a +href="glossaries-user.html#dx1-34007" >1569</a>, <a +href="glossaries-user.html#dx1-113043" >1570</a>, <a +href="glossaries-user.html#dx1-130003" >1571</a>, <a +href="glossaries-user.html#dx1-130056" ><span +class="cmti-10">1572</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdisplay</span></span></span>  <a -href="glossaries-user.html#dx1-112066" >1548</a>, <a -href="glossaries-user.html#dx1-135004" >1549</a> <br /></span> +href="glossaries-user.html#dx1-113079" >1573</a>, <a +href="glossaries-user.html#dx1-132004" >1574</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdisplayfirst</span></span></span>  <a -href="glossaries-user.html#dx1-112067" >1550</a>, <a -href="glossaries-user.html#dx1-135003" >1551</a> <br /></span> -<span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\glsdisplaynumberlist</span></span></span>  <a -href="glossaries-user.html#dx1-5002" >1552</a>, <a -href="glossaries-user.html#dx1-45004" >1553</a>, <a -href="glossaries-user.html#dx1-140060" ><span -class="cmti-10">1554</span></a>, <a -href="glossaries-user.html#dx1-220004" >1555</a>, <a -href="glossaries-user.html#dx1-220011" >1556</a>, <a -href="glossaries-user.html#dx1-220014" >1557</a>, <a -href="glossaries-user.html#dx1-220016" >1558</a>, <a -href="glossaries-user.html#dx1-220039" >1559</a> <br /></span> +href="glossaries-user.html#dx1-113080" >1575</a>, <a +href="glossaries-user.html#dx1-132003" >1576</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\glsdisplaynumberlist</span></span></span>  <a +href="glossaries-user.html#dx1-5002" >1577</a>, <a +href="glossaries-user.html#dx1-46004" >1578</a>, <a +href="glossaries-user.html#dx1-134060" ><span +class="cmti-10">1579</span></a>, <a +href="glossaries-user.html#dx1-223004" >1580</a>, <a +href="glossaries-user.html#dx1-223011" >1581</a>, <a +href="glossaries-user.html#dx1-223014" >1582</a>, <a +href="glossaries-user.html#dx1-223016" >1583</a>, <a +href="glossaries-user.html#dx1-223039" >1584</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-169006" ><span -class="cmti-10">1560</span></a> <br /></span> +href="glossaries-user.html#dx1-172006" ><span +class="cmti-10">1585</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-169009" ><span -class="cmti-10">1561</span></a> <br /></span> +href="glossaries-user.html#dx1-172009" ><span +class="cmti-10">1586</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-169008" ><span -class="cmti-10">1562</span></a> <br /></span> +href="glossaries-user.html#dx1-172008" ><span +class="cmti-10">1587</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-169007" ><span -class="cmti-10">1563</span></a> <br /></span> +href="glossaries-user.html#dx1-172007" ><span +class="cmti-10">1588</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-169010" ><span -class="cmti-10">1564</span></a> <br /></span> +href="glossaries-user.html#dx1-172010" ><span +class="cmti-10">1589</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsdosanitizesort</span></span></span>  <a -href="glossaries-user.html#dx1-73029" ><span -class="cmti-10">1565</span></a>, <a -href="glossaries-user.html#dx1-197003" >1566</a> <br /></span> +href="glossaries-user.html#dx1-74029" ><span +class="cmti-10">1590</span></a>, <a +href="glossaries-user.html#dx1-200003" >1591</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsenableentrycount</span></span></span>  <a -href="glossaries-user.html#dx1-154003" ><span -class="cmti-10">1567</span></a>, <a -href="glossaries-user.html#dx1-226001" >1568</a> <br /></span> +href="glossaries-user.html#dx1-143003" ><span +class="cmti-10">1592</span></a>, <a +href="glossaries-user.html#dx1-229001" >1593</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsenablehyper</span></span></span>  <a -href="glossaries-user.html#dx1-136006" ><span -class="cmti-10">1569</span></a> <br /></span> +href="glossaries-user.html#dx1-133006" ><span +class="cmti-10">1594</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrycounterlabel</span></span></span>  <a -href="glossaries-user.html#dx1-166048" ><span -class="cmti-10">1570</span></a> <br /></span> +href="glossaries-user.html#dx1-165049" ><span +class="cmti-10">1595</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsEntryCounterLabelPrefix</span></span></span>  <a -href="glossaries-user.html#dx1-46005" ><span -class="cmti-10">1571</span></a> <br /></span> +href="glossaries-user.html#dx1-47005" ><span +class="cmti-10">1596</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrycurrcount</span></span></span>  <a -href="glossaries-user.html#dx1-154007" ><span -class="cmti-10">1572</span></a> <br /></span> +href="glossaries-user.html#dx1-143007" ><span +class="cmti-10">1597</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentrydesc</span></span></span>  <a -href="glossaries-user.html#dx1-11007" >1573</a>, <a -href="glossaries-user.html#dx1-11016" >1574</a>, <a -href="glossaries-user.html#dx1-11037" >1575</a>, <a -href="glossaries-user.html#dx1-140026" ><span -class="cmti-10">1576</span></a>, <a -href="glossaries-user.html#dx1-183040" >1577</a> <br /></span> +href="glossaries-user.html#dx1-11007" >1598</a>, <a +href="glossaries-user.html#dx1-11016" >1599</a>, <a +href="glossaries-user.html#dx1-11037" >1600</a>, <a +href="glossaries-user.html#dx1-134026" ><span +class="cmti-10">1601</span></a>, <a +href="glossaries-user.html#dx1-186040" >1602</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrydesc</span></span></span>  <a -href="glossaries-user.html#dx1-11036" >1578</a>, <a -href="glossaries-user.html#dx1-140025" ><span -class="cmti-10">1579</span></a>, <a -href="glossaries-user.html#dx1-182019" >1580</a>, <a -href="glossaries-user.html#dx1-182024" >1581</a>, <a -href="glossaries-user.html#dx1-183011" >1582</a>, <a -href="glossaries-user.html#dx1-183016" >1583</a>, <a -href="glossaries-user.html#dx1-183025" >1584</a>, <a -href="glossaries-user.html#dx1-183028" >1585</a>, <a -href="glossaries-user.html#dx1-184055" >1586</a>, <a -href="glossaries-user.html#dx1-184059" >1587</a> <br /></span> +href="glossaries-user.html#dx1-11036" >1603</a>, <a +href="glossaries-user.html#dx1-134025" ><span +class="cmti-10">1604</span></a>, <a +href="glossaries-user.html#dx1-147007" >1605</a>, <a +href="glossaries-user.html#dx1-185019" >1606</a>, <a +href="glossaries-user.html#dx1-185024" >1607</a>, <a +href="glossaries-user.html#dx1-186011" >1608</a>, <a +href="glossaries-user.html#dx1-186016" >1609</a>, <a +href="glossaries-user.html#dx1-186025" >1610</a>, <a +href="glossaries-user.html#dx1-186028" >1611</a>, <a +href="glossaries-user.html#dx1-187055" >1612</a>, <a +href="glossaries-user.html#dx1-187059" >1613</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentrydescplural</span></span></span>  <a -href="glossaries-user.html#dx1-140030" ><span -class="cmti-10">1588</span></a> <br /></span> +href="glossaries-user.html#dx1-134030" ><span +class="cmti-10">1614</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrydescplural</span></span></span>  <a -href="glossaries-user.html#dx1-140029" ><span -class="cmti-10">1589</span></a> <br /></span> +href="glossaries-user.html#dx1-134029" ><span +class="cmti-10">1615</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryfirst</span></span></span>  <a -href="glossaries-user.html#dx1-140020" ><span -class="cmti-10">1590</span></a> <br /></span> +href="glossaries-user.html#dx1-134020" ><span +class="cmti-10">1616</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryfirst</span></span></span>  <a -href="glossaries-user.html#dx1-140019" ><span -class="cmti-10">1591</span></a>, <a -href="glossaries-user.html#dx1-211045" >1592</a> <br /></span> +href="glossaries-user.html#dx1-134019" ><span +class="cmti-10">1617</span></a>, <a +href="glossaries-user.html#dx1-214045" >1618</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-140023" ><span -class="cmti-10">1593</span></a> <br /></span> +href="glossaries-user.html#dx1-134023" ><span +class="cmti-10">1619</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-140022" ><span -class="cmti-10">1594</span></a> <br /></span> +href="glossaries-user.html#dx1-134022" ><span +class="cmti-10">1620</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryfmt</span></span></span>  <a -href="glossaries-user.html#dx1-132028" >1595</a>, <a -href="glossaries-user.html#dx1-133001" >1596</a>, <a -href="glossaries-user.html#dx1-134001" >1597</a>, <a -href="glossaries-user.html#dx1-135006" ><span -class="cmti-10">1598</span></a>, <a -href="glossaries-user.html#dx1-135078" >1599</a>, <a -href="glossaries-user.html#dx1-136014" >1600</a>, <a -href="glossaries-user.html#dx1-136021" >1601</a>, <a -href="glossaries-user.html#dx1-136025" >1602</a>, <a -href="glossaries-user.html#dx1-147019" >1603</a>, <a -href="glossaries-user.html#dx1-183006" >1604</a>, <a -href="glossaries-user.html#dx1-221001" >1605</a>, <a -href="glossaries-user.html#dx1-222002" >1606</a> <br /></span> +href="glossaries-user.html#dx1-129026" >1621</a>, <a +href="glossaries-user.html#dx1-130001" >1622</a>, <a +href="glossaries-user.html#dx1-131001" >1623</a>, <a +href="glossaries-user.html#dx1-132006" ><span +class="cmti-10">1624</span></a>, <a +href="glossaries-user.html#dx1-132078" >1625</a>, <a +href="glossaries-user.html#dx1-133014" >1626</a>, <a +href="glossaries-user.html#dx1-133021" >1627</a>, <a +href="glossaries-user.html#dx1-133025" >1628</a>, <a +href="glossaries-user.html#dx1-135025" >1629</a>, <a +href="glossaries-user.html#dx1-186006" >1630</a>, <a +href="glossaries-user.html#dx1-224001" >1631</a>, <a +href="glossaries-user.html#dx1-225002" >1632</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryfull</span></span></span>  <a -href="glossaries-user.html#dx1-147129" ><span -class="cmti-10">1607</span></a> <br /></span> +href="glossaries-user.html#dx1-136082" ><span +class="cmti-10">1633</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryfull</span></span></span>  <a -href="glossaries-user.html#dx1-147128" ><span -class="cmti-10">1608</span></a>, <a -href="glossaries-user.html#dx1-149018" >1609</a>, <a -href="glossaries-user.html#dx1-149056" >1610</a>, <a -href="glossaries-user.html#dx1-149069" >1611</a>, <a -href="glossaries-user.html#dx1-150017" >1612</a>, <a -href="glossaries-user.html#dx1-150053" >1613</a> <br /></span> +href="glossaries-user.html#dx1-136081" ><span +class="cmti-10">1634</span></a>, <a +href="glossaries-user.html#dx1-138018" >1635</a>, <a +href="glossaries-user.html#dx1-138056" >1636</a>, <a +href="glossaries-user.html#dx1-138069" >1637</a>, <a +href="glossaries-user.html#dx1-139017" >1638</a>, <a +href="glossaries-user.html#dx1-139053" >1639</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryfullpl</span></span></span>  <a -href="glossaries-user.html#dx1-147131" ><span -class="cmti-10">1614</span></a> <br /></span> +href="glossaries-user.html#dx1-136084" ><span +class="cmti-10">1640</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryfullpl</span></span></span>  <a -href="glossaries-user.html#dx1-147130" ><span -class="cmti-10">1615</span></a> <br /></span> +href="glossaries-user.html#dx1-136083" ><span +class="cmti-10">1641</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryitem</span></span></span>  <a -href="glossaries-user.html#dx1-166045" ><span -class="cmti-10">1616</span></a>, <a -href="glossaries-user.html#dx1-166081" >1617</a> <br /></span> +href="glossaries-user.html#dx1-165046" ><span +class="cmti-10">1642</span></a>, <a +href="glossaries-user.html#dx1-165082" >1643</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentrylong</span></span></span>  <a -href="glossaries-user.html#dx1-135068" >1618</a>, <a -href="glossaries-user.html#dx1-147121" ><span -class="cmti-10">1619</span></a>, <a -href="glossaries-user.html#dx1-150049" >1620</a>, <a -href="glossaries-user.html#dx1-150061" >1621</a> <br /></span> +href="glossaries-user.html#dx1-132068" >1644</a>, <a +href="glossaries-user.html#dx1-136074" ><span +class="cmti-10">1645</span></a>, <a +href="glossaries-user.html#dx1-139049" >1646</a>, <a +href="glossaries-user.html#dx1-139061" >1647</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrylong</span></span></span>  <a -href="glossaries-user.html#dx1-147120" ><span -class="cmti-10">1622</span></a>, <a -href="glossaries-user.html#dx1-150051" >1623</a>, <a -href="glossaries-user.html#dx1-150062" >1624</a> <br /></span> +href="glossaries-user.html#dx1-136073" ><span +class="cmti-10">1648</span></a>, <a +href="glossaries-user.html#dx1-139051" >1649</a>, <a +href="glossaries-user.html#dx1-139062" >1650</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentrylongpl</span></span></span>  <a -href="glossaries-user.html#dx1-147123" ><span -class="cmti-10">1625</span></a>, <a -href="glossaries-user.html#dx1-150050" >1626</a> <br /></span> +href="glossaries-user.html#dx1-136076" ><span +class="cmti-10">1651</span></a>, <a +href="glossaries-user.html#dx1-139050" >1652</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrylongpl</span></span></span>  <a -href="glossaries-user.html#dx1-147122" ><span -class="cmti-10">1627</span></a>, <a -href="glossaries-user.html#dx1-150052" >1628</a> <br /></span> +href="glossaries-user.html#dx1-136075" ><span +class="cmti-10">1653</span></a>, <a +href="glossaries-user.html#dx1-139052" >1654</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryname</span></span></span>  <a -href="glossaries-user.html#dx1-140007" ><span -class="cmti-10">1629</span></a>, <a -href="glossaries-user.html#dx1-11003" >1630</a> <br /></span> +href="glossaries-user.html#dx1-134007" ><span +class="cmti-10">1655</span></a>, <a +href="glossaries-user.html#dx1-11003" >1656</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryname</span></span></span>  <a -href="glossaries-user.html#dx1-140006" ><span -class="cmti-10">1631</span></a>, <a -href="glossaries-user.html#dx1-204016" >1632</a>, <a -href="glossaries-user.html#dx1-211047" >1633</a>, <a -href="glossaries-user.html#dx1-11002" >1634</a>, <a -href="glossaries-user.html#dx1-140053" >1635</a> <br /></span> +href="glossaries-user.html#dx1-134006" ><span +class="cmti-10">1657</span></a>, <a +href="glossaries-user.html#dx1-207016" >1658</a>, <a +href="glossaries-user.html#dx1-214047" >1659</a>, <a +href="glossaries-user.html#dx1-11002" >1660</a>, <a +href="glossaries-user.html#dx1-134053" >1661</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrynumberlist</span></span></span>  <a -href="glossaries-user.html#dx1-45003" >1636</a>, <a -href="glossaries-user.html#dx1-140059" ><span -class="cmti-10">1637</span></a>, <a -href="glossaries-user.html#dx1-220003" >1638</a>, <a -href="glossaries-user.html#dx1-220012" >1639</a>, <a -href="glossaries-user.html#dx1-220040" >1640</a> <br /></span> +href="glossaries-user.html#dx1-46003" >1662</a>, <a +href="glossaries-user.html#dx1-134059" ><span +class="cmti-10">1663</span></a>, <a +href="glossaries-user.html#dx1-223003" >1664</a>, <a +href="glossaries-user.html#dx1-223012" >1665</a>, <a +href="glossaries-user.html#dx1-223040" >1666</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryparent</span></span></span>  <a -href="glossaries-user.html#dx1-170002" ><span -class="cmti-10">1641</span></a>, <a -href="glossaries-user.html#dx1-200035" >1642</a> <br /></span> +href="glossaries-user.html#dx1-173002" ><span +class="cmti-10">1667</span></a>, <a +href="glossaries-user.html#dx1-203035" >1668</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryplural</span></span></span>  <a -href="glossaries-user.html#dx1-140017" ><span -class="cmti-10">1643</span></a> <br /></span> +href="glossaries-user.html#dx1-134017" ><span +class="cmti-10">1669</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryplural</span></span></span>  <a -href="glossaries-user.html#dx1-140016" ><span -class="cmti-10">1644</span></a>, <a -href="glossaries-user.html#dx1-200022" >1645</a>, <a -href="glossaries-user.html#dx1-200032" >1646</a> <br /></span> +href="glossaries-user.html#dx1-134016" ><span +class="cmti-10">1670</span></a>, <a +href="glossaries-user.html#dx1-203022" >1671</a>, <a +href="glossaries-user.html#dx1-203032" >1672</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryprefix</span></span></span>  <a -href="glossaries-user.html#dx1-171057" ><span -class="cmti-10">1647</span></a> <br /></span> +href="glossaries-user.html#dx1-174057" ><span +class="cmti-10">1673</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryprefix</span></span></span>  <a -href="glossaries-user.html#dx1-171048" ><span -class="cmti-10">1648</span></a>, <a -href="glossaries-user.html#dx1-194032" >1649</a> <br /></span> +href="glossaries-user.html#dx1-174048" ><span +class="cmti-10">1674</span></a>, <a +href="glossaries-user.html#dx1-197032" >1675</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryprefixfirst</span></span></span>  <a -href="glossaries-user.html#dx1-171058" ><span -class="cmti-10">1650</span></a> <br /></span> +href="glossaries-user.html#dx1-174058" ><span +class="cmti-10">1676</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryprefixfirst</span></span></span>  <a -href="glossaries-user.html#dx1-171050" ><span -class="cmti-10">1651</span></a> <br /></span> +href="glossaries-user.html#dx1-174050" ><span +class="cmti-10">1677</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryprefixfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-171060" ><span -class="cmti-10">1652</span></a> <br /></span> +href="glossaries-user.html#dx1-174060" ><span +class="cmti-10">1678</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryprefixfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-171054" ><span -class="cmti-10">1653</span></a> <br /></span> +href="glossaries-user.html#dx1-174054" ><span +class="cmti-10">1679</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryprefixplural</span></span></span>  <a -href="glossaries-user.html#dx1-171059" ><span -class="cmti-10">1654</span></a> <br /></span> +href="glossaries-user.html#dx1-174059" ><span +class="cmti-10">1680</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryprefixplural</span></span></span>  <a -href="glossaries-user.html#dx1-171052" ><span -class="cmti-10">1655</span></a> <br /></span> +href="glossaries-user.html#dx1-174052" ><span +class="cmti-10">1681</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryprevcount</span></span></span>  <a -href="glossaries-user.html#dx1-154008" ><span -class="cmti-10">1656</span></a> <br /></span> +href="glossaries-user.html#dx1-143008" ><span +class="cmti-10">1682</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryshort</span></span></span>  <a -href="glossaries-user.html#dx1-147125" ><span -class="cmti-10">1657</span></a> <br /></span> -<span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\glsentryshort</span></span></span>  <a -href="glossaries-user.html#dx1-147124" ><span -class="cmti-10">1658</span></a> <br /></span> +href="glossaries-user.html#dx1-136078" ><span +class="cmti-10">1683</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\glsentryshort</span></span></span>  <a +href="glossaries-user.html#dx1-136077" ><span +class="cmti-10">1684</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryshortpl</span></span></span>  <a -href="glossaries-user.html#dx1-147127" ><span -class="cmti-10">1659</span></a> <br /></span> +href="glossaries-user.html#dx1-136080" ><span +class="cmti-10">1685</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryshortpl</span></span></span>  <a -href="glossaries-user.html#dx1-147126" ><span -class="cmti-10">1660</span></a> <br /></span> +href="glossaries-user.html#dx1-136079" ><span +class="cmti-10">1686</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrysort</span></span></span>  <a -href="glossaries-user.html#dx1-170003" ><span -class="cmti-10">1661</span></a> <br /></span> +href="glossaries-user.html#dx1-173003" ><span +class="cmti-10">1687</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentrysymbol</span></span></span>  <a -href="glossaries-user.html#dx1-140032" ><span -class="cmti-10">1662</span></a> <br /></span> +href="glossaries-user.html#dx1-134032" ><span +class="cmti-10">1688</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrysymbol</span></span></span>  <a -href="glossaries-user.html#dx1-11006" >1663</a>, <a -href="glossaries-user.html#dx1-11041" >1664</a>, <a -href="glossaries-user.html#dx1-135079" >1665</a>, <a -href="glossaries-user.html#dx1-140031" ><span -class="cmti-10">1666</span></a>, <a -href="glossaries-user.html#dx1-189039" >1667</a>, <a -href="glossaries-user.html#dx1-222005" >1668</a> <br /></span> +href="glossaries-user.html#dx1-11006" >1689</a>, <a +href="glossaries-user.html#dx1-11041" >1690</a>, <a +href="glossaries-user.html#dx1-132079" >1691</a>, <a +href="glossaries-user.html#dx1-134031" ><span +class="cmti-10">1692</span></a>, <a +href="glossaries-user.html#dx1-192039" >1693</a>, <a +href="glossaries-user.html#dx1-225005" >1694</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentrysymbolplural</span></span></span>  <a -href="glossaries-user.html#dx1-140037" ><span -class="cmti-10">1669</span></a> <br /></span> +href="glossaries-user.html#dx1-134037" ><span +class="cmti-10">1695</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrysymbolplural</span></span></span>  <a -href="glossaries-user.html#dx1-140036" ><span -class="cmti-10">1670</span></a> <br /></span> +href="glossaries-user.html#dx1-134036" ><span +class="cmti-10">1696</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentrytext</span></span></span>  <a -href="glossaries-user.html#dx1-116005" >1671</a>, <a -href="glossaries-user.html#dx1-132012" >1672</a>, <a -href="glossaries-user.html#dx1-140014" ><span -class="cmti-10">1673</span></a>, <a -href="glossaries-user.html#dx1-147119" >1674</a>, <a -href="glossaries-user.html#dx1-171061" >1675</a> <br /></span> +href="glossaries-user.html#dx1-117005" >1697</a>, <a +href="glossaries-user.html#dx1-129010" >1698</a>, <a +href="glossaries-user.html#dx1-134014" ><span +class="cmti-10">1699</span></a>, <a +href="glossaries-user.html#dx1-136072" >1700</a>, <a +href="glossaries-user.html#dx1-174061" >1701</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrytext</span></span></span>  <a -href="glossaries-user.html#dx1-116004" >1676</a>, <a -href="glossaries-user.html#dx1-132011" >1677</a>, <a -href="glossaries-user.html#dx1-139012" >1678</a>, <a -href="glossaries-user.html#dx1-140013" ><span -class="cmti-10">1679</span></a>, <a -href="glossaries-user.html#dx1-140051" >1680</a>, <a -href="glossaries-user.html#dx1-147118" >1681</a>, <a -href="glossaries-user.html#dx1-179021" >1682</a>, <a -href="glossaries-user.html#dx1-200027" >1683</a>, <a -href="glossaries-user.html#dx1-202028" >1684</a> <br /></span> +href="glossaries-user.html#dx1-117004" >1702</a>, <a +href="glossaries-user.html#dx1-129009" >1703</a>, <a +href="glossaries-user.html#dx1-134013" ><span +class="cmti-10">1704</span></a>, <a +href="glossaries-user.html#dx1-134051" >1705</a>, <a +href="glossaries-user.html#dx1-136071" >1706</a>, <a +href="glossaries-user.html#dx1-148012" >1707</a>, <a +href="glossaries-user.html#dx1-182021" >1708</a>, <a +href="glossaries-user.html#dx1-203027" >1709</a>, <a +href="glossaries-user.html#dx1-205028" >1710</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrytitlecase</span></span></span>  <a -href="glossaries-user.html#dx1-134012" >1685</a>, <a -href="glossaries-user.html#dx1-140005" ><span -class="cmti-10">1686</span></a> <br /></span> +href="glossaries-user.html#dx1-131012" >1711</a>, <a +href="glossaries-user.html#dx1-134005" ><span +class="cmti-10">1712</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentrytype</span></span></span>  <a -href="glossaries-user.html#dx1-170001" ><span -class="cmti-10">1687</span></a> <br /></span> +href="glossaries-user.html#dx1-173001" ><span +class="cmti-10">1713</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryuseri</span></span></span>  <a -href="glossaries-user.html#dx1-140039" ><span -class="cmti-10">1688</span></a> <br /></span> +href="glossaries-user.html#dx1-134039" ><span +class="cmti-10">1714</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryuseri</span></span></span>  <a -href="glossaries-user.html#dx1-140038" ><span -class="cmti-10">1689</span></a>, <a -href="glossaries-user.html#dx1-166044" >1690</a> <br /></span> +href="glossaries-user.html#dx1-134038" ><span +class="cmti-10">1715</span></a>, <a +href="glossaries-user.html#dx1-165045" >1716</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryuserii</span></span></span>  <a -href="glossaries-user.html#dx1-140041" ><span -class="cmti-10">1691</span></a> <br /></span> +href="glossaries-user.html#dx1-134041" ><span +class="cmti-10">1717</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryuserii</span></span></span>  <a -href="glossaries-user.html#dx1-140040" ><span -class="cmti-10">1692</span></a> <br /></span> +href="glossaries-user.html#dx1-134040" ><span +class="cmti-10">1718</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryuseriii</span></span></span>  <a -href="glossaries-user.html#dx1-140043" ><span -class="cmti-10">1693</span></a> <br /></span> +href="glossaries-user.html#dx1-134043" ><span +class="cmti-10">1719</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryuseriii</span></span></span>  <a -href="glossaries-user.html#dx1-140042" ><span -class="cmti-10">1694</span></a> <br /></span> +href="glossaries-user.html#dx1-134042" ><span +class="cmti-10">1720</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryuseriv</span></span></span>  <a -href="glossaries-user.html#dx1-140045" ><span -class="cmti-10">1695</span></a> <br /></span> +href="glossaries-user.html#dx1-134045" ><span +class="cmti-10">1721</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryuseriv</span></span></span>  <a -href="glossaries-user.html#dx1-140044" ><span -class="cmti-10">1696</span></a> <br /></span> +href="glossaries-user.html#dx1-134044" ><span +class="cmti-10">1722</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryuserv</span></span></span>  <a -href="glossaries-user.html#dx1-140047" ><span -class="cmti-10">1697</span></a> <br /></span> +href="glossaries-user.html#dx1-134047" ><span +class="cmti-10">1723</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryuserv</span></span></span>  <a -href="glossaries-user.html#dx1-140046" ><span -class="cmti-10">1698</span></a> <br /></span> +href="glossaries-user.html#dx1-134046" ><span +class="cmti-10">1724</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsentryuservi</span></span></span>  <a -href="glossaries-user.html#dx1-140049" ><span -class="cmti-10">1699</span></a> <br /></span> +href="glossaries-user.html#dx1-134049" ><span +class="cmti-10">1725</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsentryuservi</span></span></span>  <a -href="glossaries-user.html#dx1-140048" ><span -class="cmti-10">1700</span></a> <br /></span> +href="glossaries-user.html#dx1-134048" ><span +class="cmti-10">1726</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsexpandfields</span></span></span>  <a -href="glossaries-user.html#dx1-118022" ><span -class="cmti-10">1701</span></a> <br /></span> +href="glossaries-user.html#dx1-119022" ><span +class="cmti-10">1727</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfieldaccsupp</span></span></span>  <a -href="glossaries-user.html#dx1-172066" ><span -class="cmti-10">1702</span></a> <br /></span> +href="glossaries-user.html#dx1-175066" ><span +class="cmti-10">1728</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfielddef</span></span></span>  <a -href="glossaries-user.html#dx1-170009" ><span -class="cmti-10">1703</span></a> <br /></span> +href="glossaries-user.html#dx1-173009" ><span +class="cmti-10">1729</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfieldedef</span></span></span>  <a -href="glossaries-user.html#dx1-170010" ><span -class="cmti-10">1704</span></a> <br /></span> +href="glossaries-user.html#dx1-173010" ><span +class="cmti-10">1730</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfieldfetch</span></span></span>  <a -href="glossaries-user.html#dx1-170004" ><span -class="cmti-10">1705</span></a> <br /></span> +href="glossaries-user.html#dx1-173004" ><span +class="cmti-10">1731</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfieldgdef</span></span></span>  <a -href="glossaries-user.html#dx1-170011" ><span -class="cmti-10">1706</span></a> <br /></span> +href="glossaries-user.html#dx1-173011" ><span +class="cmti-10">1732</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfieldxdef</span></span></span>  <a -href="glossaries-user.html#dx1-136031" >1707</a>, <a -href="glossaries-user.html#dx1-170012" ><span -class="cmti-10">1708</span></a>, <a -href="glossaries-user.html#dx1-209005" >1709</a>, <a -href="glossaries-user.html#dx1-209006" >1710</a> <br /></span> +href="glossaries-user.html#dx1-133031" >1733</a>, <a +href="glossaries-user.html#dx1-173012" ><span +class="cmti-10">1734</span></a>, <a +href="glossaries-user.html#dx1-212005" >1735</a>, <a +href="glossaries-user.html#dx1-212006" >1736</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfindwidesttoplevelname</span></span></span>  <a -href="glossaries-user.html#dx1-163051" ><span -class="cmti-10">1711</span></a>, <a -href="glossaries-user.html#dx1-202003" >1712</a> <br /></span> +href="glossaries-user.html#dx1-162051" ><span +class="cmti-10">1737</span></a>, <a +href="glossaries-user.html#dx1-205003" >1738</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">\glsFindWidestUsedLevelTwo</span></span></span>  <a -href="glossaries-user.html#dx1-202015" >1713</a> <br /></span> +href="glossaries-user.html#dx1-205015" >1739</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">\glsFindWidestUsedTopLevelName</span></span></span>  <a -href="glossaries-user.html#dx1-202014" >1714</a> <br /></span> +href="glossaries-user.html#dx1-205014" >1740</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSfirst</span></span></span>  <a -href="glossaries-user.html#dx1-134017" ><span -class="cmti-10">1715</span></a> <br /></span> +href="glossaries-user.html#dx1-131017" ><span +class="cmti-10">1741</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsfirst</span></span></span>  <a -href="glossaries-user.html#dx1-134016" ><span -class="cmti-10">1716</span></a> <br /></span> +href="glossaries-user.html#dx1-131016" ><span +class="cmti-10">1742</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfirst</span></span></span>  <a -href="glossaries-user.html#dx1-134013" ><span -class="cmti-10">1717</span></a> <br /></span> +href="glossaries-user.html#dx1-131013" ><span +class="cmti-10">1743</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">\glsfirstabbrvscfont</span></span></span>  <a -href="glossaries-user.html#dx1-184018" >1718</a>, <a -href="glossaries-user.html#dx1-184027" >1719</a>, <a -href="glossaries-user.html#dx1-184036" >1720</a>, <a -href="glossaries-user.html#dx1-184045" >1721</a> <br /></span> +href="glossaries-user.html#dx1-187018" >1744</a>, <a +href="glossaries-user.html#dx1-187027" >1745</a>, <a +href="glossaries-user.html#dx1-187036" >1746</a>, <a +href="glossaries-user.html#dx1-187045" >1747</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">\glsfirstlongfootnotefont</span></span></span>  <a -href="glossaries-user.html#dx1-184012" >1722</a>, <a -href="glossaries-user.html#dx1-184021" >1723</a>, <a -href="glossaries-user.html#dx1-184030" >1724</a>, <a -href="glossaries-user.html#dx1-184039" >1725</a>, <a -href="glossaries-user.html#dx1-184063" >1726</a> <br /></span> +href="glossaries-user.html#dx1-187012" >1748</a>, <a +href="glossaries-user.html#dx1-187021" >1749</a>, <a +href="glossaries-user.html#dx1-187030" >1750</a>, <a +href="glossaries-user.html#dx1-187039" >1751</a>, <a +href="glossaries-user.html#dx1-187063" >1752</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-134037" ><span -class="cmti-10">1727</span></a> <br /></span> +href="glossaries-user.html#dx1-131037" ><span +class="cmti-10">1753</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-134036" ><span -class="cmti-10">1728</span></a> <br /></span> +href="glossaries-user.html#dx1-131036" ><span +class="cmti-10">1754</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-134033" ><span -class="cmti-10">1729</span></a> <br /></span> +href="glossaries-user.html#dx1-131033" ><span +class="cmti-10">1755</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">\glsfmtfirst</span></span></span>  <a -href="glossaries-user.html#dx1-211046" >1730</a> <br /></span> +href="glossaries-user.html#dx1-214046" >1756</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">\Glsfmtlong</span></span></span>  <a -href="glossaries-user.html#dx1-182022" >1731</a>, <a -href="glossaries-user.html#dx1-184058" >1732</a> <br /></span> +href="glossaries-user.html#dx1-185022" >1757</a>, <a +href="glossaries-user.html#dx1-187058" >1758</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">\glsfmtname</span></span></span>  <a -href="glossaries-user.html#dx1-179028" >1733</a>, <a -href="glossaries-user.html#dx1-179030" >1734</a>, <a -href="glossaries-user.html#dx1-211048" >1735</a> <br /></span> +href="glossaries-user.html#dx1-182028" >1759</a>, <a +href="glossaries-user.html#dx1-182030" >1760</a>, <a +href="glossaries-user.html#dx1-214048" >1761</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">\glsfmtshort</span></span></span>  <a -href="glossaries-user.html#dx1-182023" >1736</a> <br /></span> +href="glossaries-user.html#dx1-185023" >1762</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">\glsfmttext</span></span></span>  <a -href="glossaries-user.html#dx1-179027" >1737</a>, <a -href="glossaries-user.html#dx1-197025" >1738</a>, <a -href="glossaries-user.html#dx1-197027" >1739</a>, <a -href="glossaries-user.html#dx1-197030" >1740</a> <br /></span> - - +href="glossaries-user.html#dx1-182027" >1763</a>, <a +href="glossaries-user.html#dx1-200025" >1764</a>, <a +href="glossaries-user.html#dx1-200027" >1765</a>, <a +href="glossaries-user.html#dx1-200030" >1766</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsgenacfmt</span></span></span>  <a -href="glossaries-user.html#dx1-135050" ><span -class="cmti-10">1741</span></a>, <a -href="glossaries-user.html#dx1-135072" >1742</a>, <a -href="glossaries-user.html#dx1-148007" >1743</a>, <a -href="glossaries-user.html#dx1-150003" >1744</a>, <a -href="glossaries-user.html#dx1-150009" >1745</a>, <a -href="glossaries-user.html#dx1-150046" >1746</a>, <a -href="glossaries-user.html#dx1-150073" >1747</a> <br /></span> +href="glossaries-user.html#dx1-132050" ><span +class="cmti-10">1767</span></a>, <a +href="glossaries-user.html#dx1-132072" >1768</a>, <a +href="glossaries-user.html#dx1-137010" >1769</a>, <a +href="glossaries-user.html#dx1-139003" >1770</a>, <a +href="glossaries-user.html#dx1-139009" >1771</a>, <a +href="glossaries-user.html#dx1-139046" >1772</a>, <a +href="glossaries-user.html#dx1-139073" >1773</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsgenentryfmt</span></span></span>  <a -href="glossaries-user.html#dx1-135044" ><span -class="cmti-10">1748</span></a>, <a -href="glossaries-user.html#dx1-150010" >1749</a>, <a -href="glossaries-user.html#dx1-150045" >1750</a>, <a -href="glossaries-user.html#dx1-183007" >1751</a>, <a -href="glossaries-user.html#dx1-222003" >1752</a> <br /></span> +href="glossaries-user.html#dx1-132044" ><span +class="cmti-10">1774</span></a>, <a +href="glossaries-user.html#dx1-139010" >1775</a>, <a +href="glossaries-user.html#dx1-139045" >1776</a>, <a +href="glossaries-user.html#dx1-186007" >1777</a>, <a +href="glossaries-user.html#dx1-225003" >1778</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsgetgrouptitle</span></span></span>  <a -href="glossaries-user.html#dx1-166026" ><span -class="cmti-10">1753</span></a> <br /></span> +href="glossaries-user.html#dx1-165027" ><span +class="cmti-10">1779</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsglossarymark</span></span></span>  <a -href="glossaries-user.html#dx1-41003" ><span -class="cmti-10">1754</span></a>, <a -href="glossaries-user.html#dx1-42004" >1755</a>, <a -href="glossaries-user.html#dx1-141071" ><span -class="cmti-10">1756</span></a>, <a -href="glossaries-user.html#dx1-141072" >1757</a>, <a -href="glossaries-user.html#dx1-141073" >1758</a> <br /></span> +href="glossaries-user.html#dx1-42003" ><span +class="cmti-10">1780</span></a>, <a +href="glossaries-user.html#dx1-43004" >1781</a>, <a +href="glossaries-user.html#dx1-144081" ><span +class="cmti-10">1782</span></a>, <a +href="glossaries-user.html#dx1-144082" >1783</a>, <a +href="glossaries-user.html#dx1-144083" >1784</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsgroupheading</span></span></span>  <a -href="glossaries-user.html#dx1-166020" ><span -class="cmti-10">1759</span></a>, <a -href="glossaries-user.html#dx1-166077" >1760</a> <br /></span> +href="glossaries-user.html#dx1-165021" ><span +class="cmti-10">1785</span></a>, <a +href="glossaries-user.html#dx1-165078" >1786</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsgroupskip</span></span></span>  <a -href="glossaries-user.html#dx1-156032" >1761</a>, <a -href="glossaries-user.html#dx1-166034" ><span -class="cmti-10">1762</span></a>, <a -href="glossaries-user.html#dx1-166078" >1763</a> <br /></span> +href="glossaries-user.html#dx1-155033" >1787</a>, <a +href="glossaries-user.html#dx1-165035" ><span +class="cmti-10">1788</span></a>, <a +href="glossaries-user.html#dx1-165079" >1789</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glshyperlink</span></span></span>  <a -href="glossaries-user.html#dx1-136022" >1764</a>, <a -href="glossaries-user.html#dx1-140002" >1765</a>, <a -href="glossaries-user.html#dx1-140050" ><span -class="cmti-10">1766</span></a> <br /></span> +href="glossaries-user.html#dx1-133022" >1790</a>, <a +href="glossaries-user.html#dx1-134002" >1791</a>, <a +href="glossaries-user.html#dx1-134050" ><span +class="cmti-10">1792</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glshypernavsep</span></span></span>  <a -href="glossaries-user.html#dx1-157021" ><span -class="cmti-10">1767</span></a> <br /></span> +href="glossaries-user.html#dx1-156021" ><span +class="cmti-10">1793</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsifhyper</span></span></span>  <a -href="glossaries-user.html#dx1-135027" >1768</a> <br /></span> +href="glossaries-user.html#dx1-132027" >1794</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsifhyperon</span></span></span>  <a -href="glossaries-user.html#dx1-135022" ><span -class="cmti-10">1769</span></a>, <a -href="glossaries-user.html#dx1-209004" >1770</a>, <a -href="glossaries-user.html#dx1-209010" >1771</a> <br /></span> +href="glossaries-user.html#dx1-132022" ><span +class="cmti-10">1795</span></a>, <a +href="glossaries-user.html#dx1-212004" >1796</a>, <a +href="glossaries-user.html#dx1-212010" >1797</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsIfListOfAcronyms</span></span></span>  <a -href="glossaries-user.html#dx1-93006" ><span -class="cmti-10">1772</span></a> <br /></span> +href="glossaries-user.html#dx1-94006" ><span +class="cmti-10">1798</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsifplural</span></span></span>  <a -href="glossaries-user.html#dx1-135020" ><span -class="cmti-10">1773</span></a>, <a -href="glossaries-user.html#dx1-135033" >1774</a>, <a -href="glossaries-user.html#dx1-150005" >1775</a>, <a -href="glossaries-user.html#dx1-150092" >1776</a> <br /></span> -<span class="index-item"><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\glsignore</span></span></span>  <a -href="glossaries-user.html#dx1-128005" >1777</a> <br /></span> +href="glossaries-user.html#dx1-132020" ><span +class="cmti-10">1799</span></a>, <a +href="glossaries-user.html#dx1-132033" >1800</a>, <a +href="glossaries-user.html#dx1-139005" >1801</a>, <a +href="glossaries-user.html#dx1-139092" >1802</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlinedescformat</span></span></span>  <a -href="glossaries-user.html#dx1-165020" ><span -class="cmti-10">1778</span></a> <br /></span> +href="glossaries-user.html#dx1-164020" ><span +class="cmti-10">1803</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlineemptydescformat</span></span></span>  <a -href="glossaries-user.html#dx1-165019" ><span -class="cmti-10">1779</span></a> <br /></span> +href="glossaries-user.html#dx1-164019" ><span +class="cmti-10">1804</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlinenameformat</span></span></span>  <a -href="glossaries-user.html#dx1-165016" ><span -class="cmti-10">1780</span></a> <br /></span> +href="glossaries-user.html#dx1-164016" ><span +class="cmti-10">1805</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlineparentchildseparator</span></span></span>  <a -href="glossaries-user.html#dx1-165012" ><span -class="cmti-10">1781</span></a>, <a -href="glossaries-user.html#dx1-165013" >1782</a> <br /></span> +href="glossaries-user.html#dx1-164012" ><span +class="cmti-10">1806</span></a>, <a +href="glossaries-user.html#dx1-164013" >1807</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlineseparator</span></span></span>  <a -href="glossaries-user.html#dx1-165008" ><span -class="cmti-10">1783</span></a>, <a -href="glossaries-user.html#dx1-165009" >1784</a> <br /></span> +href="glossaries-user.html#dx1-164008" ><span +class="cmti-10">1808</span></a>, <a +href="glossaries-user.html#dx1-164009" >1809</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlinesubdescformat</span></span></span>  <a -href="glossaries-user.html#dx1-165021" ><span -class="cmti-10">1785</span></a> <br /></span> +href="glossaries-user.html#dx1-164021" ><span +class="cmti-10">1810</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlinesubnameformat</span></span></span>  <a -href="glossaries-user.html#dx1-165018" ><span -class="cmti-10">1786</span></a> <br /></span> +href="glossaries-user.html#dx1-164018" ><span +class="cmti-10">1811</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinlinesubseparator</span></span></span>  <a -href="glossaries-user.html#dx1-165010" ><span -class="cmti-10">1787</span></a>, <a -href="glossaries-user.html#dx1-165011" >1788</a> <br /></span> +href="glossaries-user.html#dx1-164010" ><span +class="cmti-10">1812</span></a>, <a +href="glossaries-user.html#dx1-164011" >1813</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsinsert</span></span></span>  <a -href="glossaries-user.html#dx1-135019" ><span -class="cmti-10">1789</span></a>, <a -href="glossaries-user.html#dx1-135035" >1790</a> <br /></span> +href="glossaries-user.html#dx1-132019" ><span +class="cmti-10">1814</span></a>, <a +href="glossaries-user.html#dx1-132035" >1815</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslabel</span></span></span>  <a -href="glossaries-user.html#dx1-34017" >1791</a>, <a -href="glossaries-user.html#dx1-135012" ><span -class="cmti-10">1792</span></a>, <a -href="glossaries-user.html#dx1-135031" >1793</a>, <a -href="glossaries-user.html#dx1-147047" >1794</a>, <a -href="glossaries-user.html#dx1-150077" >1795</a>, <a -href="glossaries-user.html#dx1-150084" >1796</a>, <a -href="glossaries-user.html#dx1-183009" >1797</a>, <a -href="glossaries-user.html#dx1-183012" >1798</a>, <a -href="glossaries-user.html#dx1-183017" >1799</a>, <a -href="glossaries-user.html#dx1-183026" >1800</a>, <a -href="glossaries-user.html#dx1-183038" >1801</a>, <a -href="glossaries-user.html#dx1-189040" >1802</a>, <a -href="glossaries-user.html#dx1-189042" >1803</a>, <a -href="glossaries-user.html#dx1-202024" >1804</a> <br /></span> +href="glossaries-user.html#dx1-34017" >1816</a>, <a +href="glossaries-user.html#dx1-132012" ><span +class="cmti-10">1817</span></a>, <a +href="glossaries-user.html#dx1-132031" >1818</a>, <a +href="glossaries-user.html#dx1-135048" >1819</a>, <a +href="glossaries-user.html#dx1-139077" >1820</a>, <a +href="glossaries-user.html#dx1-139084" >1821</a>, <a +href="glossaries-user.html#dx1-186009" >1822</a>, <a +href="glossaries-user.html#dx1-186012" >1823</a>, <a +href="glossaries-user.html#dx1-186017" >1824</a>, <a +href="glossaries-user.html#dx1-186026" >1825</a>, <a +href="glossaries-user.html#dx1-186038" >1826</a>, <a +href="glossaries-user.html#dx1-192040" >1827</a>, <a +href="glossaries-user.html#dx1-192042" >1828</a>, <a +href="glossaries-user.html#dx1-205024" >1829</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslabeltok</span></span></span>  <a -href="glossaries-user.html#dx1-150024" ><span -class="cmti-10">1805</span></a>, <a -href="glossaries-user.html#dx1-182010" >1806</a> <br /></span> +href="glossaries-user.html#dx1-139024" ><span +class="cmti-10">1830</span></a>, <a +href="glossaries-user.html#dx1-185010" >1831</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsletentryfield</span></span></span>  <a -href="glossaries-user.html#dx1-140033" ><span -class="cmti-10">1807</span></a> <br /></span> +href="glossaries-user.html#dx1-134033" ><span +class="cmti-10">1832</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslink</span></span></span>  <a -href="glossaries-user.html#dx1-34008" >1808</a>, <a -href="glossaries-user.html#dx1-134003" >1809</a>, <a -href="glossaries-user.html#dx1-134004" ><span -class="cmti-10">1810</span></a>, <a -href="glossaries-user.html#dx1-144007" >1811</a>, <a -href="glossaries-user.html#dx1-150056" >1812</a>, <a -href="glossaries-user.html#dx1-189009" >1813</a>, <a -href="glossaries-user.html#dx1-189017" >1814</a>, <a -href="glossaries-user.html#dx1-189022" >1815</a>, <a -href="glossaries-user.html#dx1-189025" >1816</a>, <a -href="glossaries-user.html#dx1-189026" >1817</a> <br /></span> +href="glossaries-user.html#dx1-34008" >1833</a>, <a +href="glossaries-user.html#dx1-131003" >1834</a>, <a +href="glossaries-user.html#dx1-131004" ><span +class="cmti-10">1835</span></a>, <a +href="glossaries-user.html#dx1-139056" >1836</a>, <a +href="glossaries-user.html#dx1-168007" >1837</a>, <a +href="glossaries-user.html#dx1-192009" >1838</a>, <a +href="glossaries-user.html#dx1-192017" >1839</a>, <a +href="glossaries-user.html#dx1-192022" >1840</a>, <a +href="glossaries-user.html#dx1-192025" >1841</a>, <a +href="glossaries-user.html#dx1-192026" >1842</a> <br /></span> <span class="index-item"><span class="cmtt-10">\glslink </span>options<br /></span> <span class="index-subitem">    <span class="cmtt-10">counter</span>  <a -href="glossaries-user.html#dx1-132077" >1818</a>, <a -href="glossaries-user.html#dx1-144006" >1819</a> <br /></span> +href="glossaries-user.html#dx1-129075" >1843</a>, <a +href="glossaries-user.html#dx1-168006" >1844</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">format</span>  <a -href="glossaries-user.html#dx1-128004" >1820</a>, <a -href="glossaries-user.html#dx1-128011" >1821</a>, <a -href="glossaries-user.html#dx1-132041" >1822</a>, <a -href="glossaries-user.html#dx1-132050" >1823</a>, <a -href="glossaries-user.html#dx1-132070" >1824</a>, <a -href="glossaries-user.html#dx1-140067" >1825</a>, <a -href="glossaries-user.html#dx1-144011" >1826</a>, <a -href="glossaries-user.html#dx1-144016" >1827</a>, <a -href="glossaries-user.html#dx1-144018" >1828</a>, <a -href="glossaries-user.html#dx1-189003" >1829</a>, <a -href="glossaries-user.html#dx1-190004" >1830</a>, <a -href="glossaries-user.html#dx1-190019" >1831</a>, <a -href="glossaries-user.html#dx1-211015" >1832</a>, <a -href="glossaries-user.html#dx1-211018" >1833</a> <br /></span> +href="glossaries-user.html#dx1-129039" >1845</a>, <a +href="glossaries-user.html#dx1-129048" >1846</a>, <a +href="glossaries-user.html#dx1-129068" >1847</a>, <a +href="glossaries-user.html#dx1-134067" >1848</a>, <a +href="glossaries-user.html#dx1-150004" >1849</a>, <a +href="glossaries-user.html#dx1-150010" >1850</a>, <a +href="glossaries-user.html#dx1-168011" >1851</a>, <a +href="glossaries-user.html#dx1-168016" >1852</a>, <a +href="glossaries-user.html#dx1-168018" >1853</a>, <a +href="glossaries-user.html#dx1-192003" >1854</a>, <a +href="glossaries-user.html#dx1-193004" >1855</a>, <a +href="glossaries-user.html#dx1-193019" >1856</a>, <a +href="glossaries-user.html#dx1-214015" >1857</a>, <a +href="glossaries-user.html#dx1-214018" >1858</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">hyper</span>  <a -href="glossaries-user.html#dx1-34013" >1834</a>, <a -href="glossaries-user.html#dx1-132030" >1835</a>, <a -href="glossaries-user.html#dx1-132036" >1836</a>, <a -href="glossaries-user.html#dx1-135023" >1837</a>, <a -href="glossaries-user.html#dx1-135029" >1838</a>, <a -href="glossaries-user.html#dx1-136003" >1839</a>, <a -href="glossaries-user.html#dx1-137002" >1840</a>, <a -href="glossaries-user.html#dx1-221003" >1841</a> <br /></span> +href="glossaries-user.html#dx1-34013" >1859</a>, <a +href="glossaries-user.html#dx1-129028" >1860</a>, <a +href="glossaries-user.html#dx1-129034" >1861</a>, <a +href="glossaries-user.html#dx1-132023" >1862</a>, <a +href="glossaries-user.html#dx1-132029" >1863</a>, <a +href="glossaries-user.html#dx1-133003" >1864</a>, <a +href="glossaries-user.html#dx1-146002" >1865</a>, <a +href="glossaries-user.html#dx1-224003" >1866</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">hyperoutside</span>  <a -href="glossaries-user.html#dx1-132080" >1842</a> <br /></span> +href="glossaries-user.html#dx1-129078" >1867</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">local</span>  <a -href="glossaries-user.html#dx1-132078" >1843</a> <br /></span> +href="glossaries-user.html#dx1-129076" >1868</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">noindex</span>  <a -href="glossaries-user.html#dx1-132079" >1844</a> <br /></span> +href="glossaries-user.html#dx1-129077" >1869</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-132087" >1845</a> <br /></span> +href="glossaries-user.html#dx1-129085" >1870</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">textformat</span>  <a -href="glossaries-user.html#dx1-132084" >1846</a> <br /></span> +href="glossaries-user.html#dx1-129082" >1871</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">theHvalue</span>  <a -href="glossaries-user.html#dx1-132090" >1847</a> <br /></span> +href="glossaries-user.html#dx1-129088" >1872</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">thevalue</span>  <a -href="glossaries-user.html#dx1-132089" >1848</a> <br /></span> +href="glossaries-user.html#dx1-129087" >1873</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">wrgloss</span>  <a -href="glossaries-user.html#dx1-132082" >1849</a> <br /></span> +href="glossaries-user.html#dx1-129080" >1874</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslinkcheckfirsthyperhook</span></span></span>  <a href="glossaries-user.html#dx1-34015" ><span -class="cmti-10">1850</span></a> <br /></span> +class="cmti-10">1875</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslinkpostsetkeys</span></span></span>  <a -href="glossaries-user.html#dx1-34023" >1851</a>, <a -href="glossaries-user.html#dx1-135038" >1852</a>, <a -href="glossaries-user.html#dx1-135073" ><span -class="cmti-10">1853</span></a>, <a -href="glossaries-user.html#dx1-136029" >1854</a>, <a -href="glossaries-user.html#dx1-150090" >1855</a>, <a -href="glossaries-user.html#dx1-209002" >1856</a>, <a -href="glossaries-user.html#dx1-209003" >1857</a>, <a -href="glossaries-user.html#dx1-209007" >1858</a>, <a -href="glossaries-user.html#dx1-209008" >1859</a> <br /></span> +href="glossaries-user.html#dx1-34023" >1876</a>, <a +href="glossaries-user.html#dx1-132038" >1877</a>, <a +href="glossaries-user.html#dx1-132073" ><span +class="cmti-10">1878</span></a>, <a +href="glossaries-user.html#dx1-133029" >1879</a>, <a +href="glossaries-user.html#dx1-139090" >1880</a>, <a +href="glossaries-user.html#dx1-212002" >1881</a>, <a +href="glossaries-user.html#dx1-212003" >1882</a>, <a +href="glossaries-user.html#dx1-212007" >1883</a>, <a +href="glossaries-user.html#dx1-212008" >1884</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslinkprefix</span></span></span>  <a -href="glossaries-user.html#dx1-141064" >1860</a> <br /></span> +href="glossaries-user.html#dx1-144071" >1885</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">\glslinkpresetkeys</span></span></span>  <a -href="glossaries-user.html#dx1-221004" >1861</a> <br /></span> +href="glossaries-user.html#dx1-224004" >1886</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslinkvar</span></span></span>  <a -href="glossaries-user.html#dx1-135028" ><span -class="cmti-10">1862</span></a> <br /></span> +href="glossaries-user.html#dx1-132028" ><span +class="cmti-10">1887</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslistdottedwidth</span></span></span>  <a -href="glossaries-user.html#dx1-157039" ><span -class="cmti-10">1863</span></a> <br /></span> +href="glossaries-user.html#dx1-156039" ><span +class="cmti-10">1888</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslistnavigationitem</span></span></span>  <a -href="glossaries-user.html#dx1-157023" ><span -class="cmti-10">1864</span></a> <br /></span> +href="glossaries-user.html#dx1-156023" ><span +class="cmti-10">1889</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslocalreset</span></span></span>  <a -href="glossaries-user.html#dx1-153004" ><span -class="cmti-10">1865</span></a> <br /></span> +href="glossaries-user.html#dx1-142004" ><span +class="cmti-10">1890</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslocalresetall</span></span></span>  <a -href="glossaries-user.html#dx1-153008" ><span -class="cmti-10">1866</span></a> <br /></span> +href="glossaries-user.html#dx1-142008" ><span +class="cmti-10">1891</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslocalunset</span></span></span>  <a -href="glossaries-user.html#dx1-153006" ><span -class="cmti-10">1867</span></a> <br /></span> +href="glossaries-user.html#dx1-142006" ><span +class="cmti-10">1892</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslocalunsetall</span></span></span>  <a -href="glossaries-user.html#dx1-153010" ><span -class="cmti-10">1868</span></a> <br /></span> +href="glossaries-user.html#dx1-142010" ><span +class="cmti-10">1893</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">\glslongfont</span></span></span>  <a -href="glossaries-user.html#dx1-182007" >1869</a> <br /></span> +href="glossaries-user.html#dx1-185007" >1894</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glslongtok</span></span></span>  <a -href="glossaries-user.html#dx1-150025" ><span -class="cmti-10">1870</span></a>, <a -href="glossaries-user.html#dx1-182008" >1871</a>, <a -href="glossaries-user.html#dx1-182015" >1872</a>, <a -href="glossaries-user.html#dx1-184065" >1873</a>, <a -href="glossaries-user.html#dx1-184070" >1874</a> <br /></span> +href="glossaries-user.html#dx1-139025" ><span +class="cmti-10">1895</span></a>, <a +href="glossaries-user.html#dx1-185008" >1896</a>, <a +href="glossaries-user.html#dx1-185015" >1897</a>, <a +href="glossaries-user.html#dx1-187065" >1898</a>, <a +href="glossaries-user.html#dx1-187070" >1899</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsmcols</span></span></span>  <a -href="glossaries-user.html#dx1-164015" ><span -class="cmti-10">1875</span></a> <br /></span> +href="glossaries-user.html#dx1-163015" ><span +class="cmti-10">1900</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsmoveentry</span></span></span>  <a -href="glossaries-user.html#dx1-123001" ><span -class="cmti-10">1876</span></a> <br /></span> +href="glossaries-user.html#dx1-124001" ><span +class="cmti-10">1901</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSname</span></span></span>  <a -href="glossaries-user.html#dx1-134044" ><span -class="cmti-10">1877</span></a> <br /></span> +href="glossaries-user.html#dx1-131044" ><span +class="cmti-10">1902</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsname</span></span></span>  <a -href="glossaries-user.html#dx1-134043" ><span -class="cmti-10">1878</span></a> <br /></span> +href="glossaries-user.html#dx1-131043" ><span +class="cmti-10">1903</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsname</span></span></span>  <a -href="glossaries-user.html#dx1-134038" ><span -class="cmti-10">1879</span></a> <br /></span> +href="glossaries-user.html#dx1-131038" ><span +class="cmti-10">1904</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnamefont</span></span></span>  <a -href="glossaries-user.html#dx1-141084" ><span -class="cmti-10">1880</span></a>, <a -href="glossaries-user.html#dx1-149010" >1881</a>, <a -href="glossaries-user.html#dx1-163005" >1882</a> <br /></span> +href="glossaries-user.html#dx1-138010" >1905</a>, <a +href="glossaries-user.html#dx1-144094" ><span +class="cmti-10">1906</span></a>, <a +href="glossaries-user.html#dx1-162005" >1907</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnavhypertarget</span></span></span>  <a -href="glossaries-user.html#dx1-166030" ><span -class="cmti-10">1883</span></a> <br /></span> +href="glossaries-user.html#dx1-165031" ><span +class="cmti-10">1908</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnavigation</span></span></span>  <a -href="glossaries-user.html#dx1-166031" ><span -class="cmti-10">1884</span></a> <br /></span> +href="glossaries-user.html#dx1-165032" ><span +class="cmti-10">1909</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnoexpandfields</span></span></span>  <a -href="glossaries-user.html#dx1-118023" ><span -class="cmti-10">1885</span></a> <br /></span> +href="glossaries-user.html#dx1-119023" ><span +class="cmti-10">1910</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnoidxdisplayloc</span></span></span>  <a -href="glossaries-user.html#dx1-130022" ><span -class="cmti-10">1886</span></a> <br /></span> +href="glossaries-user.html#dx1-152022" ><span +class="cmti-10">1911</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnumberformat</span></span></span>  <a -href="glossaries-user.html#dx1-128003" >1887</a>, <a -href="glossaries-user.html#dx1-129025" >1888</a>, <a -href="glossaries-user.html#dx1-144046" >1889</a>, <a -href="glossaries-user.html#dx1-190008" >1890</a>, <a -href="glossaries-user.html#dx1-190016" >1891</a>, <a -href="glossaries-user.html#dx1-190034" >1892</a> <br /></span> +href="glossaries-user.html#dx1-150003" >1912</a>, <a +href="glossaries-user.html#dx1-151025" >1913</a>, <a +href="glossaries-user.html#dx1-168046" >1914</a>, <a +href="glossaries-user.html#dx1-193008" >1915</a>, <a +href="glossaries-user.html#dx1-193016" >1916</a>, <a +href="glossaries-user.html#dx1-193034" >1917</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnumberlistloop</span></span></span>  <a -href="glossaries-user.html#dx1-130019" ><span -class="cmti-10">1893</span></a> <br /></span> +href="glossaries-user.html#dx1-152019" ><span +class="cmti-10">1918</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnumbersgroupname</span></span></span>  <a -href="glossaries-user.html#dx1-14032" >1894</a> <br /></span> +href="glossaries-user.html#dx1-14032" >1919</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnumbersgrouptitle</span></span></span>  <a -href="glossaries-user.html#dx1-166028" >1895</a> <br /></span> +href="glossaries-user.html#dx1-165029" >1920</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnumlistlastsep</span></span></span>  <a -href="glossaries-user.html#dx1-140066" ><span -class="cmti-10">1896</span></a> <br /></span> +href="glossaries-user.html#dx1-134066" ><span +class="cmti-10">1921</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsnumlistsep</span></span></span>  <a -href="glossaries-user.html#dx1-140065" ><span -class="cmti-10">1897</span></a> <br /></span> +href="glossaries-user.html#dx1-134065" ><span +class="cmti-10">1922</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsopenbrace</span></span></span>  <a -href="glossaries-user.html#dx1-142007" ><span -class="cmti-10">1898</span></a> <br /></span> +href="glossaries-user.html#dx1-166007" ><span +class="cmti-10">1923</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspagelistwidth</span></span></span>  <a -href="glossaries-user.html#dx1-156017" ><span -class="cmti-10">1899</span></a>, <a -href="glossaries-user.html#dx1-158023" >1900</a>, <a -href="glossaries-user.html#dx1-158042" >1901</a>, <a -href="glossaries-user.html#dx1-159023" >1902</a>, <a -href="glossaries-user.html#dx1-159033" >1903</a>, <a -href="glossaries-user.html#dx1-161028" >1904</a>, <a -href="glossaries-user.html#dx1-161047" >1905</a>, <a -href="glossaries-user.html#dx1-162025" >1906</a> <br /></span> +href="glossaries-user.html#dx1-155018" ><span +class="cmti-10">1924</span></a>, <a +href="glossaries-user.html#dx1-157023" >1925</a>, <a +href="glossaries-user.html#dx1-157042" >1926</a>, <a +href="glossaries-user.html#dx1-158023" >1927</a>, <a +href="glossaries-user.html#dx1-158033" >1928</a>, <a +href="glossaries-user.html#dx1-160028" >1929</a>, <a +href="glossaries-user.html#dx1-160047" >1930</a>, <a +href="glossaries-user.html#dx1-161025" >1931</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspar</span></span></span>  <a -href="glossaries-user.html#dx1-112022" ><span -class="cmti-10">1907</span></a> <br /></span> +href="glossaries-user.html#dx1-113027" ><span +class="cmti-10">1932</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspatchtabularx</span></span></span>  <a -href="glossaries-user.html#dx1-133008" ><span -class="cmti-10">1908</span></a> <br /></span> +href="glossaries-user.html#dx1-130008" ><span +class="cmti-10">1933</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspercentchar</span></span></span>  <a -href="glossaries-user.html#dx1-142009" ><span -class="cmti-10">1909</span></a> <br /></span> +href="glossaries-user.html#dx1-166009" ><span +class="cmti-10">1934</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSpl</span></span></span>  <a -href="glossaries-user.html#dx1-3027" >1910</a>, <a -href="glossaries-user.html#dx1-112036" >1911</a>, <a -href="glossaries-user.html#dx1-112070" >1912</a>, <a -href="glossaries-user.html#dx1-133049" ><span -class="cmti-10">1913</span></a>, <a -href="glossaries-user.html#dx1-171038" >1914</a> <br /></span> +href="glossaries-user.html#dx1-3027" >1935</a>, <a +href="glossaries-user.html#dx1-113042" >1936</a>, <a +href="glossaries-user.html#dx1-113083" >1937</a>, <a +href="glossaries-user.html#dx1-130049" ><span +class="cmti-10">1938</span></a>, <a +href="glossaries-user.html#dx1-174038" >1939</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glspl</span></span></span>  <a -href="glossaries-user.html#dx1-3026" >1915</a>, <a -href="glossaries-user.html#dx1-112035" >1916</a>, <a -href="glossaries-user.html#dx1-112069" >1917</a>, <a -href="glossaries-user.html#dx1-112153" >1918</a>, <a -href="glossaries-user.html#dx1-133048" ><span -class="cmti-10">1919</span></a>, <a -href="glossaries-user.html#dx1-147117" >1920</a>, <a -href="glossaries-user.html#dx1-171036" >1921</a> <br /></span> +href="glossaries-user.html#dx1-3026" >1940</a>, <a +href="glossaries-user.html#dx1-113041" >1941</a>, <a +href="glossaries-user.html#dx1-113082" >1942</a>, <a +href="glossaries-user.html#dx1-113173" >1943</a>, <a +href="glossaries-user.html#dx1-130048" ><span +class="cmti-10">1944</span></a>, <a +href="glossaries-user.html#dx1-136070" >1945</a>, <a +href="glossaries-user.html#dx1-174036" >1946</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspl</span></span></span>  <a -href="glossaries-user.html#dx1-3025" >1922</a>, <a -href="glossaries-user.html#dx1-112034" >1923</a>, <a -href="glossaries-user.html#dx1-112042" >1924</a>, <a -href="glossaries-user.html#dx1-112047" >1925</a>, <a -href="glossaries-user.html#dx1-112056" >1926</a>, <a -href="glossaries-user.html#dx1-112058" >1927</a>, <a -href="glossaries-user.html#dx1-112068" >1928</a>, <a -href="glossaries-user.html#dx1-133047" ><span -class="cmti-10">1929</span></a>, <a -href="glossaries-user.html#dx1-134021" >1930</a>, <a -href="glossaries-user.html#dx1-135017" >1931</a>, <a -href="glossaries-user.html#dx1-147115" >1932</a> <br /></span> +href="glossaries-user.html#dx1-3025" >1947</a>, <a +href="glossaries-user.html#dx1-113040" >1948</a>, <a +href="glossaries-user.html#dx1-113050" >1949</a>, <a +href="glossaries-user.html#dx1-113057" >1950</a>, <a +href="glossaries-user.html#dx1-113066" >1951</a>, <a +href="glossaries-user.html#dx1-113068" >1952</a>, <a +href="glossaries-user.html#dx1-113081" >1953</a>, <a +href="glossaries-user.html#dx1-130047" ><span +class="cmti-10">1954</span></a>, <a +href="glossaries-user.html#dx1-131021" >1955</a>, <a +href="glossaries-user.html#dx1-132017" >1956</a>, <a +href="glossaries-user.html#dx1-135007" >1957</a>, <a +href="glossaries-user.html#dx1-136068" >1958</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSplural</span></span></span>  <a -href="glossaries-user.html#dx1-134032" ><span -class="cmti-10">1933</span></a> <br /></span> +href="glossaries-user.html#dx1-131032" ><span +class="cmti-10">1959</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsplural</span></span></span>  <a -href="glossaries-user.html#dx1-134031" ><span -class="cmti-10">1934</span></a> <br /></span> +href="glossaries-user.html#dx1-131031" ><span +class="cmti-10">1960</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsplural</span></span></span>  <a -href="glossaries-user.html#dx1-134028" ><span -class="cmti-10">1935</span></a> <br /></span> +href="glossaries-user.html#dx1-131028" ><span +class="cmti-10">1961</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspluralsuffix</span></span></span>  <a -href="glossaries-user.html#dx1-112043" >1936</a>, <a -href="glossaries-user.html#dx1-112045" >1937</a>, <a -href="glossaries-user.html#dx1-112050" >1938</a>, <a -href="glossaries-user.html#dx1-113001" ><span -class="cmti-10">1939</span></a>, <a -href="glossaries-user.html#dx1-147030" >1940</a>, <a -href="glossaries-user.html#dx1-200029" >1941</a> <br /></span> +href="glossaries-user.html#dx1-113051" >1962</a>, <a +href="glossaries-user.html#dx1-113053" >1963</a>, <a +href="glossaries-user.html#dx1-113060" >1964</a>, <a +href="glossaries-user.html#dx1-114001" ><span +class="cmti-10">1965</span></a>, <a +href="glossaries-user.html#dx1-135035" >1966</a>, <a +href="glossaries-user.html#dx1-203029" >1967</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspostdescription</span></span></span>  <a -href="glossaries-user.html#dx1-156039" ><span -class="cmti-10">1942</span></a>, <a -href="glossaries-user.html#dx1-183030" >1943</a>, <a -href="glossaries-user.html#dx1-183039" >1944</a> <br /></span> +href="glossaries-user.html#dx1-155040" ><span +class="cmti-10">1968</span></a>, <a +href="glossaries-user.html#dx1-186030" >1969</a>, <a +href="glossaries-user.html#dx1-186039" >1970</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspostinline</span></span></span>  <a -href="glossaries-user.html#dx1-165014" ><span -class="cmti-10">1945</span></a>, <a -href="glossaries-user.html#dx1-165015" >1946</a> <br /></span> +href="glossaries-user.html#dx1-164014" ><span +class="cmti-10">1971</span></a>, <a +href="glossaries-user.html#dx1-164015" >1972</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glspostlinkhook</span></span></span>  <a -href="glossaries-user.html#dx1-135037" >1947</a>, <a -href="glossaries-user.html#dx1-135074" ><span -class="cmti-10">1948</span></a>, <a -href="glossaries-user.html#dx1-150080" >1949</a>, <a -href="glossaries-user.html#dx1-150088" >1950</a>, <a -href="glossaries-user.html#dx1-150091" >1951</a> <br /></span> +href="glossaries-user.html#dx1-132037" >1973</a>, <a +href="glossaries-user.html#dx1-132074" ><span +class="cmti-10">1974</span></a>, <a +href="glossaries-user.html#dx1-139080" >1975</a>, <a +href="glossaries-user.html#dx1-139088" >1976</a>, <a +href="glossaries-user.html#dx1-139091" >1977</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsprefixsep</span></span></span>  <a -href="glossaries-user.html#dx1-171017" ><span -class="cmti-10">1952</span></a> <br /></span> +href="glossaries-user.html#dx1-174017" ><span +class="cmti-10">1978</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsprestandardsort</span></span></span>  <a -href="glossaries-user.html#dx1-73024" ><span -class="cmti-10">1953</span></a>, <a -href="glossaries-user.html#dx1-112079" >1954</a>, <a -href="glossaries-user.html#dx1-197002" >1955</a> <br /></span> +href="glossaries-user.html#dx1-74024" ><span +class="cmti-10">1979</span></a>, <a +href="glossaries-user.html#dx1-113092" >1980</a>, <a +href="glossaries-user.html#dx1-200002" >1981</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">\glsps</span></span></span>  <a -href="glossaries-user.html#dx1-192021" >1956</a> <br /></span> +href="glossaries-user.html#dx1-195021" >1982</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">\glspt</span></span></span>  <a -href="glossaries-user.html#dx1-192023" >1957</a>, <a -href="glossaries-user.html#dx1-192025" >1958</a>, <a -href="glossaries-user.html#dx1-192047" >1959</a>, <a -href="glossaries-user.html#dx1-192052" >1960</a>, <a -href="glossaries-user.html#dx1-192068" >1961</a> <br /></span> +href="glossaries-user.html#dx1-195023" >1983</a>, <a +href="glossaries-user.html#dx1-195025" >1984</a>, <a +href="glossaries-user.html#dx1-195047" >1985</a>, <a +href="glossaries-user.html#dx1-195052" >1986</a>, <a +href="glossaries-user.html#dx1-195068" >1987</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsquote</span></span></span>  <a -href="glossaries-user.html#dx1-142014" ><span -class="cmti-10">1962</span></a> <br /></span> +href="glossaries-user.html#dx1-166014" ><span +class="cmti-10">1988</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsrefentry</span></span></span>  <a -href="glossaries-user.html#dx1-46004" ><span -class="cmti-10">1963</span></a>, <a -href="glossaries-user.html#dx1-48005" >1964</a>, <a -href="glossaries-user.html#dx1-141035" >1965</a>, <a -href="glossaries-user.html#dx1-141040" >1966</a>, <a -href="glossaries-user.html#dx1-200001" >1967</a>, <a -href="glossaries-user.html#dx1-200094" >1968</a> <br /></span> +href="glossaries-user.html#dx1-47004" ><span +class="cmti-10">1989</span></a>, <a +href="glossaries-user.html#dx1-49005" >1990</a>, <a +href="glossaries-user.html#dx1-144042" >1991</a>, <a +href="glossaries-user.html#dx1-144047" >1992</a>, <a +href="glossaries-user.html#dx1-203001" >1993</a>, <a +href="glossaries-user.html#dx1-203094" >1994</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsreset</span></span></span>  <a -href="glossaries-user.html#dx1-64004" >1969</a>, <a -href="glossaries-user.html#dx1-147038" >1970</a>, <a -href="glossaries-user.html#dx1-153003" ><span -class="cmti-10">1971</span></a> <br /></span> +href="glossaries-user.html#dx1-65004" >1995</a>, <a +href="glossaries-user.html#dx1-135020" >1996</a>, <a +href="glossaries-user.html#dx1-142003" ><span +class="cmti-10">1997</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsresetall</span></span></span>  <a -href="glossaries-user.html#dx1-153007" ><span -class="cmti-10">1972</span></a> <br /></span> +href="glossaries-user.html#dx1-142007" ><span +class="cmti-10">1998</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsresetentrycounter</span></span></span>  <a -href="glossaries-user.html#dx1-47006" ><span -class="cmti-10">1973</span></a> <br /></span> +href="glossaries-user.html#dx1-48006" ><span +class="cmti-10">1999</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsrestoreLToutput</span></span></span>  <a -href="glossaries-user.html#dx1-160023" ><span -class="cmti-10">1974</span></a> <br /></span> +href="glossaries-user.html#dx1-159023" ><span +class="cmti-10">2000</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssee</span></span></span>  <a -href="glossaries-user.html#dx1-56005" >1975</a>, <a -href="glossaries-user.html#dx1-138017" ><span -class="cmti-10">1976</span></a>, <a -href="glossaries-user.html#dx1-138024" >1977</a>, <a -href="glossaries-user.html#dx1-204004" >1978</a>, <a -href="glossaries-user.html#dx1-204011" >1979</a>, <a -href="glossaries-user.html#dx1-4002" >1980</a> <br /></span> +href="glossaries-user.html#dx1-57005" >2001</a>, <a +href="glossaries-user.html#dx1-63002" >2002</a>, <a +href="glossaries-user.html#dx1-67003" >2003</a>, <a +href="glossaries-user.html#dx1-147020" ><span +class="cmti-10">2004</span></a>, <a +href="glossaries-user.html#dx1-147027" >2005</a>, <a +href="glossaries-user.html#dx1-207004" >2006</a>, <a +href="glossaries-user.html#dx1-207011" >2007</a>, <a +href="glossaries-user.html#dx1-4002" >2008</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsseeformat</span></span></span>  <a -href="glossaries-user.html#dx1-139002" ><span -class="cmti-10">1981</span></a>, <a -href="glossaries-user.html#dx1-139016" >1982</a> <br /></span> +href="glossaries-user.html#dx1-148002" ><span +class="cmti-10">2009</span></a>, <a +href="glossaries-user.html#dx1-148017" >2010</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsseeitemformat</span></span></span>  <a -href="glossaries-user.html#dx1-139011" ><span -class="cmti-10">1983</span></a>, <a -href="glossaries-user.html#dx1-179019" >1984</a>, <a -href="glossaries-user.html#dx1-179024" >1985</a>, <a -href="glossaries-user.html#dx1-179025" >1986</a>, <a -href="glossaries-user.html#dx1-179029" >1987</a>, <a -href="glossaries-user.html#dx1-182025" >1988</a>, <a -href="glossaries-user.html#dx1-204015" >1989</a> <br /></span> +href="glossaries-user.html#dx1-148011" ><span +class="cmti-10">2011</span></a>, <a +href="glossaries-user.html#dx1-182019" >2012</a>, <a +href="glossaries-user.html#dx1-182024" >2013</a>, <a +href="glossaries-user.html#dx1-182025" >2014</a>, <a +href="glossaries-user.html#dx1-182029" >2015</a>, <a +href="glossaries-user.html#dx1-185025" >2016</a>, <a +href="glossaries-user.html#dx1-207015" >2017</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsseelastsep</span></span></span>  <a -href="glossaries-user.html#dx1-139009" ><span -class="cmti-10">1990</span></a> <br /></span> +href="glossaries-user.html#dx1-148009" ><span +class="cmti-10">2018</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsseelist</span></span></span>  <a -href="glossaries-user.html#dx1-139017" >1991</a> <br /></span> +href="glossaries-user.html#dx1-148018" >2019</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsseesep</span></span></span>  <a -href="glossaries-user.html#dx1-139008" ><span -class="cmti-10">1992</span></a> <br /></span> +href="glossaries-user.html#dx1-148008" ><span +class="cmti-10">2020</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsSetAlphaCompositor</span></span></span>  <a -href="glossaries-user.html#dx1-111019" ><span -class="cmti-10">1993</span></a>, <a -href="glossaries-user.html#dx1-144058" >1994</a> <br /></span> +href="glossaries-user.html#dx1-112019" ><span +class="cmti-10">2021</span></a>, <a +href="glossaries-user.html#dx1-168058" >2022</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">\glssetcategoryattribute</span></span></span>  <a -href="glossaries-user.html#dx1-11055" >1995</a>, <a -href="glossaries-user.html#dx1-11056" >1996</a>, <a -href="glossaries-user.html#dx1-182027" >1997</a>, <a -href="glossaries-user.html#dx1-182035" >1998</a>, <a -href="glossaries-user.html#dx1-183032" >1999</a>, <a -href="glossaries-user.html#dx1-185007" >2000</a>, <a -href="glossaries-user.html#dx1-185012" >2001</a>, <a -href="glossaries-user.html#dx1-185014" >2002</a>, <a -href="glossaries-user.html#dx1-186022" >2003</a>, <a -href="glossaries-user.html#dx1-186023" >2004</a>, <a -href="glossaries-user.html#dx1-186025" >2005</a>, <a -href="glossaries-user.html#dx1-186031" >2006</a>, <a -href="glossaries-user.html#dx1-186032" >2007</a>, <a -href="glossaries-user.html#dx1-189015" >2008</a>, <a -href="glossaries-user.html#dx1-194035" >2009</a>, <a -href="glossaries-user.html#dx1-194036" >2010</a>, <a -href="glossaries-user.html#dx1-194037" >2011</a>, <a -href="glossaries-user.html#dx1-194038" >2012</a>, <a -href="glossaries-user.html#dx1-224067" >2013</a>, <a -href="glossaries-user.html#dx1-224073" >2014</a> <br /></span> +href="glossaries-user.html#dx1-11055" >2023</a>, <a +href="glossaries-user.html#dx1-11056" >2024</a>, <a +href="glossaries-user.html#dx1-185027" >2025</a>, <a +href="glossaries-user.html#dx1-185035" >2026</a>, <a +href="glossaries-user.html#dx1-186032" >2027</a>, <a +href="glossaries-user.html#dx1-188007" >2028</a>, <a +href="glossaries-user.html#dx1-188012" >2029</a>, <a +href="glossaries-user.html#dx1-188014" >2030</a>, <a +href="glossaries-user.html#dx1-189022" >2031</a>, <a +href="glossaries-user.html#dx1-189023" >2032</a>, <a +href="glossaries-user.html#dx1-189025" >2033</a>, <a +href="glossaries-user.html#dx1-189031" >2034</a>, <a +href="glossaries-user.html#dx1-189032" >2035</a>, <a +href="glossaries-user.html#dx1-192015" >2036</a>, <a +href="glossaries-user.html#dx1-197035" >2037</a>, <a +href="glossaries-user.html#dx1-197036" >2038</a>, <a +href="glossaries-user.html#dx1-197037" >2039</a>, <a +href="glossaries-user.html#dx1-197038" >2040</a>, <a +href="glossaries-user.html#dx1-227067" >2041</a>, <a +href="glossaries-user.html#dx1-227073" >2042</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsSetCompositor</span></span></span>  <a -href="glossaries-user.html#dx1-111018" ><span -class="cmti-10">2015</span></a>, <a -href="glossaries-user.html#dx1-144056" >2016</a> <br /></span> +href="glossaries-user.html#dx1-112018" ><span +class="cmti-10">2043</span></a>, <a +href="glossaries-user.html#dx1-168056" >2044</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssetexpandfield</span></span></span>  <a -href="glossaries-user.html#dx1-118007" ><span -class="cmti-10">2017</span></a> <br /></span> +href="glossaries-user.html#dx1-119007" ><span +class="cmti-10">2045</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssetnoexpandfield</span></span></span>  <a -href="glossaries-user.html#dx1-118008" ><span -class="cmti-10">2018</span></a> <br /></span> +href="glossaries-user.html#dx1-119008" ><span +class="cmti-10">2046</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetQuote</span></span></span>  <a -href="glossaries-user.html#dx1-7017" >2019</a>, <a +href="glossaries-user.html#dx1-7017" >2047</a>, <a href="glossaries-user.html#dx1-13035" ><span -class="cmti-10">2020</span></a> <br /></span> +class="cmti-10">2048</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsSetSuffixF</span></span></span>  <a -href="glossaries-user.html#dx1-130009" ><span -class="cmti-10">2021</span></a> <br /></span> +href="glossaries-user.html#dx1-152009" ><span +class="cmti-10">2049</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsSetSuffixFF</span></span></span>  <a -href="glossaries-user.html#dx1-130010" ><span -class="cmti-10">2022</span></a> <br /></span> +href="glossaries-user.html#dx1-152010" ><span +class="cmti-10">2050</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssetwidest</span></span></span>  <a -href="glossaries-user.html#dx1-163049" ><span -class="cmti-10">2023</span></a>, <a -href="glossaries-user.html#dx1-202002" >2024</a>, <a -href="glossaries-user.html#dx1-202013" >2025</a>, <a -href="glossaries-user.html#dx1-202043" >2026</a>, <a -href="glossaries-user.html#dx1-202058" >2027</a> <br /></span> +href="glossaries-user.html#dx1-162049" ><span +class="cmti-10">2051</span></a>, <a +href="glossaries-user.html#dx1-205002" >2052</a>, <a +href="glossaries-user.html#dx1-205013" >2053</a>, <a +href="glossaries-user.html#dx1-205043" >2054</a>, <a +href="glossaries-user.html#dx1-205058" >2055</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetWriteIstHook</span></span></span>  <a -href="glossaries-user.html#dx1-131002" ><span -class="cmti-10">2028</span></a> <br /></span> +href="glossaries-user.html#dx1-153002" ><span +class="cmti-10">2056</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetXdyCodePage</span></span></span>  <a -href="glossaries-user.html#dx1-16097" >2029</a>, <a -href="glossaries-user.html#dx1-77003" >2030</a>, <a -href="glossaries-user.html#dx1-143010" ><span -class="cmti-10">2031</span></a> <br /></span> +href="glossaries-user.html#dx1-16097" >2057</a>, <a +href="glossaries-user.html#dx1-78003" >2058</a>, <a +href="glossaries-user.html#dx1-167010" ><span +class="cmti-10">2059</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetXdyFirstLetterAfterDigits</span></span></span>  <a -href="glossaries-user.html#dx1-145004" ><span -class="cmti-10">2032</span></a> <br /></span> +href="glossaries-user.html#dx1-169004" ><span +class="cmti-10">2060</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetXdyLanguage</span></span></span>  <a -href="glossaries-user.html#dx1-16095" >2033</a>, <a -href="glossaries-user.html#dx1-77002" >2034</a>, <a -href="glossaries-user.html#dx1-108017" >2035</a>, <a -href="glossaries-user.html#dx1-143007" ><span -class="cmti-10">2036</span></a> <br /></span> +href="glossaries-user.html#dx1-16095" >2061</a>, <a +href="glossaries-user.html#dx1-78002" >2062</a>, <a +href="glossaries-user.html#dx1-109017" >2063</a>, <a +href="glossaries-user.html#dx1-167007" ><span +class="cmti-10">2064</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetXdyLocationClassOrder</span></span></span>  <a -href="glossaries-user.html#dx1-144061" ><span -class="cmti-10">2037</span></a> <br /></span> +href="glossaries-user.html#dx1-168061" ><span +class="cmti-10">2065</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetXdyMinRangeLength</span></span></span>  <a -href="glossaries-user.html#dx1-130004" >2038</a>, <a -href="glossaries-user.html#dx1-144066" ><span -class="cmti-10">2039</span></a> <br /></span> +href="glossaries-user.html#dx1-152004" >2066</a>, <a +href="glossaries-user.html#dx1-168066" ><span +class="cmti-10">2067</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsSetXdyNumberGroupOrder</span></span></span>  <a -href="glossaries-user.html#dx1-145007" ><span -class="cmti-10">2040</span></a> <br /></span> +href="glossaries-user.html#dx1-169007" ><span +class="cmti-10">2068</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsshortaccsupp</span></span></span>  <a -href="glossaries-user.html#dx1-172070" ><span -class="cmti-10">2041</span></a>, <a -href="glossaries-user.html#dx1-224019" >2042</a> <br /></span> +href="glossaries-user.html#dx1-175070" ><span +class="cmti-10">2069</span></a>, <a +href="glossaries-user.html#dx1-227019" >2070</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsshortplaccsupp</span></span></span>  <a -href="glossaries-user.html#dx1-172071" ><span -class="cmti-10">2043</span></a>, <a -href="glossaries-user.html#dx1-224020" >2044</a> <br /></span> +href="glossaries-user.html#dx1-175071" ><span +class="cmti-10">2071</span></a>, <a +href="glossaries-user.html#dx1-227020" >2072</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsshorttok</span></span></span>  <a -href="glossaries-user.html#dx1-150026" ><span -class="cmti-10">2045</span></a>, <a -href="glossaries-user.html#dx1-182013" >2046</a>, <a -href="glossaries-user.html#dx1-184067" >2047</a> <br /></span> +href="glossaries-user.html#dx1-139026" ><span +class="cmti-10">2073</span></a>, <a +href="glossaries-user.html#dx1-185013" >2074</a>, <a +href="glossaries-user.html#dx1-187067" >2075</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsshowaccsupp</span></span></span>  <a href="glossaries-user.html#dx1-30012" ><span -class="cmti-10">2048</span></a> <br /></span> +class="cmti-10">2076</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsshowtarget</span></span></span>  <a href="glossaries-user.html#dx1-30008" ><span -class="cmti-10">2049</span></a>, <a -href="glossaries-user.html#dx1-30013" >2050</a> <br /></span> +class="cmti-10">2077</span></a>, <a +href="glossaries-user.html#dx1-30013" >2078</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsshowtargetfont</span></span></span>  <a href="glossaries-user.html#dx1-30010" ><span -class="cmti-10">2051</span></a> <br /></span> +class="cmti-10">2079</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsshowtargetouter</span></span></span>  <a href="glossaries-user.html#dx1-30009" ><span -class="cmti-10">2052</span></a> <br /></span> +class="cmti-10">2080</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssortnumberfmt</span></span></span>  <a -href="glossaries-user.html#dx1-73016" ><span -class="cmti-10">2053</span></a> <br /></span> +href="glossaries-user.html#dx1-74016" ><span +class="cmti-10">2081</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssubentrycounterlabel</span></span></span>  <a -href="glossaries-user.html#dx1-166067" ><span -class="cmti-10">2054</span></a> <br /></span> +href="glossaries-user.html#dx1-165068" ><span +class="cmti-10">2082</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssubentryitem</span></span></span>  <a -href="glossaries-user.html#dx1-166064" ><span -class="cmti-10">2055</span></a>, <a -href="glossaries-user.html#dx1-166082" >2056</a> <br /></span> +href="glossaries-user.html#dx1-165065" ><span +class="cmti-10">2083</span></a>, <a +href="glossaries-user.html#dx1-165083" >2084</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSsymbol</span></span></span>  <a -href="glossaries-user.html#dx1-134049" ><span -class="cmti-10">2057</span></a> <br /></span> +href="glossaries-user.html#dx1-131049" ><span +class="cmti-10">2085</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glssymbol</span></span></span>  <a -href="glossaries-user.html#dx1-134048" ><span -class="cmti-10">2058</span></a> <br /></span> +href="glossaries-user.html#dx1-131048" ><span +class="cmti-10">2086</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssymbol</span></span></span>  <a -href="glossaries-user.html#dx1-134045" ><span -class="cmti-10">2059</span></a>, <a -href="glossaries-user.html#dx1-135080" >2060</a>, <a -href="glossaries-user.html#dx1-189030" >2061</a>, <a -href="glossaries-user.html#dx1-189032" >2062</a>, <a -href="glossaries-user.html#dx1-189051" >2063</a>, <a -href="glossaries-user.html#dx1-189060" >2064</a> <br /></span> +href="glossaries-user.html#dx1-131045" ><span +class="cmti-10">2087</span></a>, <a +href="glossaries-user.html#dx1-132080" >2088</a>, <a +href="glossaries-user.html#dx1-192030" >2089</a>, <a +href="glossaries-user.html#dx1-192032" >2090</a>, <a +href="glossaries-user.html#dx1-192051" >2091</a>, <a +href="glossaries-user.html#dx1-192060" >2092</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssymbolaccsupp</span></span></span>  <a -href="glossaries-user.html#dx1-224024" >2065</a> <br /></span> +href="glossaries-user.html#dx1-227024" >2093</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glssymbolsgroupname</span></span></span>  <a -href="glossaries-user.html#dx1-14031" >2066</a>, <a -href="glossaries-user.html#dx1-166027" >2067</a> <br /></span> +href="glossaries-user.html#dx1-14031" >2094</a>, <a +href="glossaries-user.html#dx1-144102" >2095</a>, <a +href="glossaries-user.html#dx1-165028" >2096</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstarget</span></span></span>  <a -href="glossaries-user.html#dx1-166049" ><span -class="cmti-10">2068</span></a>, <a -href="glossaries-user.html#dx1-166066" >2069</a> <br /></span> +href="glossaries-user.html#dx1-165050" ><span +class="cmti-10">2097</span></a>, <a +href="glossaries-user.html#dx1-165067" >2098</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLStext</span></span></span>  <a -href="glossaries-user.html#dx1-116008" >2070</a>, <a -href="glossaries-user.html#dx1-134011" ><span -class="cmti-10">2071</span></a> <br /></span> +href="glossaries-user.html#dx1-117008" >2099</a>, <a +href="glossaries-user.html#dx1-131011" ><span +class="cmti-10">2100</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glstext</span></span></span>  <a -href="glossaries-user.html#dx1-116007" >2072</a>, <a -href="glossaries-user.html#dx1-134010" ><span -class="cmti-10">2073</span></a> <br /></span> +href="glossaries-user.html#dx1-117007" >2101</a>, <a +href="glossaries-user.html#dx1-131010" ><span +class="cmti-10">2102</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstext</span></span></span>  <a -href="glossaries-user.html#dx1-34009" >2074</a>, <a -href="glossaries-user.html#dx1-34022" >2075</a>, <a -href="glossaries-user.html#dx1-116006" >2076</a>, <a -href="glossaries-user.html#dx1-134007" ><span -class="cmti-10">2077</span></a> <br /></span> +href="glossaries-user.html#dx1-34009" >2103</a>, <a +href="glossaries-user.html#dx1-34022" >2104</a>, <a +href="glossaries-user.html#dx1-117006" >2105</a>, <a +href="glossaries-user.html#dx1-131007" ><span +class="cmti-10">2106</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstextformat</span></span></span>  <a -href="glossaries-user.html#dx1-132025" ><span -class="cmti-10">2078</span></a>, <a -href="glossaries-user.html#dx1-132081" >2079</a>, <a -href="glossaries-user.html#dx1-132086" >2080</a>, <a -href="glossaries-user.html#dx1-135082" >2081</a>, <a -href="glossaries-user.html#dx1-140001" >2082</a>, <a -href="glossaries-user.html#dx1-147051" >2083</a> <br /></span> +href="glossaries-user.html#dx1-129023" ><span +class="cmti-10">2107</span></a>, <a +href="glossaries-user.html#dx1-129079" >2108</a>, <a +href="glossaries-user.html#dx1-129084" >2109</a>, <a +href="glossaries-user.html#dx1-132082" >2110</a>, <a +href="glossaries-user.html#dx1-134001" >2111</a>, <a +href="glossaries-user.html#dx1-136004" >2112</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstextup</span></span></span>  <a -href="glossaries-user.html#dx1-150035" ><span -class="cmti-10">2084</span></a> <br /></span> +href="glossaries-user.html#dx1-139035" ><span +class="cmti-10">2113</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstildechar</span></span></span>  <a -href="glossaries-user.html#dx1-142010" ><span -class="cmti-10">2085</span></a> <br /></span> +href="glossaries-user.html#dx1-166010" ><span +class="cmti-10">2114</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstocfalse</span></span></span>  <a -href="glossaries-user.html#dx1-39002" ><span -class="cmti-10">2086</span></a> <br /></span> +href="glossaries-user.html#dx1-40002" ><span +class="cmti-10">2115</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstoctrue</span></span></span>  <a -href="glossaries-user.html#dx1-39001" ><span -class="cmti-10">2087</span></a> <br /></span> +href="glossaries-user.html#dx1-40001" ><span +class="cmti-10">2116</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreechildpredesc</span></span></span>  <a -href="glossaries-user.html#dx1-163014" ><span -class="cmti-10">2088</span></a> <br /></span> +href="glossaries-user.html#dx1-162014" ><span +class="cmti-10">2117</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreegroupheaderfmt</span></span></span>  <a -href="glossaries-user.html#dx1-163006" ><span -class="cmti-10">2089</span></a> <br /></span> +href="glossaries-user.html#dx1-162006" ><span +class="cmti-10">2118</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreeindent</span></span></span>  <a -href="glossaries-user.html#dx1-163033" ><span -class="cmti-10">2090</span></a> <br /></span> +href="glossaries-user.html#dx1-162033" ><span +class="cmti-10">2119</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreeitem</span></span></span>  <a -href="glossaries-user.html#dx1-163019" ><span -class="cmti-10">2091</span></a> <br /></span> +href="glossaries-user.html#dx1-162019" ><span +class="cmti-10">2120</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreenamebox</span></span></span>  <a -href="glossaries-user.html#dx1-163054" ><span -class="cmti-10">2092</span></a> <br /></span> +href="glossaries-user.html#dx1-162054" ><span +class="cmti-10">2121</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreenamefmt</span></span></span>  <a -href="glossaries-user.html#dx1-163004" ><span -class="cmti-10">2093</span></a> <br /></span> +href="glossaries-user.html#dx1-162004" ><span +class="cmti-10">2122</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreenavigationfmt</span></span></span>  <a -href="glossaries-user.html#dx1-163008" ><span -class="cmti-10">2094</span></a> <br /></span> +href="glossaries-user.html#dx1-162008" ><span +class="cmti-10">2123</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreepredesc</span></span></span>  <a -href="glossaries-user.html#dx1-163011" ><span -class="cmti-10">2095</span></a> <br /></span> +href="glossaries-user.html#dx1-162011" ><span +class="cmti-10">2124</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreesubitem</span></span></span>  <a -href="glossaries-user.html#dx1-163020" ><span -class="cmti-10">2096</span></a> <br /></span> +href="glossaries-user.html#dx1-162020" ><span +class="cmti-10">2125</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstreesubsubitem</span></span></span>  <a -href="glossaries-user.html#dx1-163021" ><span -class="cmti-10">2097</span></a> <br /></span> +href="glossaries-user.html#dx1-162021" ><span +class="cmti-10">2126</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glstype</span></span></span>  <a -href="glossaries-user.html#dx1-34018" >2098</a>, <a -href="glossaries-user.html#dx1-135013" ><span -class="cmti-10">2099</span></a>, <a -href="glossaries-user.html#dx1-135032" >2100</a> <br /></span> +href="glossaries-user.html#dx1-34018" >2127</a>, <a +href="glossaries-user.html#dx1-132013" ><span +class="cmti-10">2128</span></a>, <a +href="glossaries-user.html#dx1-132032" >2129</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsunset</span></span></span>  <a -href="glossaries-user.html#dx1-153005" ><span -class="cmti-10">2101</span></a> <br /></span> +href="glossaries-user.html#dx1-142005" ><span +class="cmti-10">2130</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsunsetall</span></span></span>  <a -href="glossaries-user.html#dx1-136016" >2102</a>, <a -href="glossaries-user.html#dx1-153009" ><span -class="cmti-10">2103</span></a> <br /></span> +href="glossaries-user.html#dx1-133016" >2131</a>, <a +href="glossaries-user.html#dx1-142009" ><span +class="cmti-10">2132</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsUseAcrEntryDispStyle</span></span></span>  <a -href="glossaries-user.html#dx1-150031" ><span -class="cmti-10">2104</span></a> <br /></span> +href="glossaries-user.html#dx1-139031" ><span +class="cmti-10">2133</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GlsUseAcrStyleDefs</span></span></span>  <a -href="glossaries-user.html#dx1-150032" ><span -class="cmti-10">2105</span></a> <br /></span> +href="glossaries-user.html#dx1-139032" ><span +class="cmti-10">2134</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSuseri</span></span></span>  <a -href="glossaries-user.html#dx1-134059" ><span -class="cmti-10">2106</span></a> <br /></span> +href="glossaries-user.html#dx1-131059" ><span +class="cmti-10">2135</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsuseri</span></span></span>  <a -href="glossaries-user.html#dx1-134058" ><span -class="cmti-10">2107</span></a> <br /></span> +href="glossaries-user.html#dx1-131058" ><span +class="cmti-10">2136</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuseri</span></span></span>  <a -href="glossaries-user.html#dx1-134055" ><span -class="cmti-10">2108</span></a> <br /></span> +href="glossaries-user.html#dx1-131055" ><span +class="cmti-10">2137</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuseriaccsupp</span></span></span>  <a -href="glossaries-user.html#dx1-224028" >2109</a> <br /></span> +href="glossaries-user.html#dx1-227028" >2138</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSuserii</span></span></span>  <a -href="glossaries-user.html#dx1-134064" ><span -class="cmti-10">2110</span></a> <br /></span> +href="glossaries-user.html#dx1-131064" ><span +class="cmti-10">2139</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsuserii</span></span></span>  <a -href="glossaries-user.html#dx1-134063" ><span -class="cmti-10">2111</span></a> <br /></span> +href="glossaries-user.html#dx1-131063" ><span +class="cmti-10">2140</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuserii</span></span></span>  <a -href="glossaries-user.html#dx1-134060" ><span -class="cmti-10">2112</span></a> <br /></span> +href="glossaries-user.html#dx1-131060" ><span +class="cmti-10">2141</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSuseriii</span></span></span>  <a -href="glossaries-user.html#dx1-134069" ><span -class="cmti-10">2113</span></a> <br /></span> +href="glossaries-user.html#dx1-131069" ><span +class="cmti-10">2142</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsuseriii</span></span></span>  <a -href="glossaries-user.html#dx1-134068" ><span -class="cmti-10">2114</span></a> <br /></span> +href="glossaries-user.html#dx1-131068" ><span +class="cmti-10">2143</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuseriii</span></span></span>  <a -href="glossaries-user.html#dx1-134065" ><span -class="cmti-10">2115</span></a> <br /></span> +href="glossaries-user.html#dx1-131065" ><span +class="cmti-10">2144</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSuseriv</span></span></span>  <a -href="glossaries-user.html#dx1-134074" ><span -class="cmti-10">2116</span></a> <br /></span> +href="glossaries-user.html#dx1-131074" ><span +class="cmti-10">2145</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsuseriv</span></span></span>  <a -href="glossaries-user.html#dx1-134073" ><span -class="cmti-10">2117</span></a> <br /></span> +href="glossaries-user.html#dx1-131073" ><span +class="cmti-10">2146</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuseriv</span></span></span>  <a -href="glossaries-user.html#dx1-134070" ><span -class="cmti-10">2118</span></a> <br /></span> +href="glossaries-user.html#dx1-131070" ><span +class="cmti-10">2147</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSuserv</span></span></span>  <a -href="glossaries-user.html#dx1-134079" ><span -class="cmti-10">2119</span></a> <br /></span> +href="glossaries-user.html#dx1-131079" ><span +class="cmti-10">2148</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsuserv</span></span></span>  <a -href="glossaries-user.html#dx1-134078" ><span -class="cmti-10">2120</span></a> <br /></span> +href="glossaries-user.html#dx1-131078" ><span +class="cmti-10">2149</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuserv</span></span></span>  <a -href="glossaries-user.html#dx1-134075" ><span -class="cmti-10">2121</span></a> <br /></span> +href="glossaries-user.html#dx1-131075" ><span +class="cmti-10">2150</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\GLSuservi</span></span></span>  <a -href="glossaries-user.html#dx1-134084" ><span -class="cmti-10">2122</span></a> <br /></span> +href="glossaries-user.html#dx1-131084" ><span +class="cmti-10">2151</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\Glsuservi</span></span></span>  <a -href="glossaries-user.html#dx1-134083" ><span -class="cmti-10">2123</span></a> <br /></span> +href="glossaries-user.html#dx1-131083" ><span +class="cmti-10">2152</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glsuservi</span></span></span>  <a -href="glossaries-user.html#dx1-134080" ><span -class="cmti-10">2124</span></a> <br /></span> +href="glossaries-user.html#dx1-131080" ><span +class="cmti-10">2153</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glswrallowprimitivemodsfalse</span></span></span>  <a -href="glossaries-user.html#dx1-129028" ><span -class="cmti-10">2125</span></a> <br /></span> +href="glossaries-user.html#dx1-151028" ><span +class="cmti-10">2154</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glswrite</span></span></span>  <a -href="glossaries-user.html#dx1-131003" ><span -class="cmti-10">2126</span></a> <br /></span> +href="glossaries-user.html#dx1-153003" ><span +class="cmti-10">2155</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\glswriteentry</span></span></span>  <a -href="glossaries-user.html#dx1-64005" ><span -class="cmti-10">2127</span></a> <br /></span> +href="glossaries-user.html#dx1-65005" ><span +class="cmti-10">2156</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">\glsxtr@makeglossaries</span></span></span>  <a -href="glossaries-user.html#dx1-22004" >2128</a> <br /></span> +href="glossaries-user.html#dx1-22004" >2157</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">\glsxtr@record</span></span></span>  <a -href="glossaries-user.html#dx1-24015" >2129</a> <br /></span> +href="glossaries-user.html#dx1-24015" >2158</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">\glsxtr@record@nameref</span></span></span>  <a -href="glossaries-user.html#dx1-24017" >2130</a> <br /></span> +href="glossaries-user.html#dx1-24017" >2159</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">\glsxtr@recordsee</span></span></span>  <a -href="glossaries-user.html#dx1-24018" >2131</a> <br /></span> +href="glossaries-user.html#dx1-24018" >2160</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">\glsxtr@resource</span></span></span>  <a -href="glossaries-user.html#dx1-24003" >2132</a>, <a -href="glossaries-user.html#dx1-24009" >2133</a> <br /></span> +href="glossaries-user.html#dx1-24003" >2161</a>, <a +href="glossaries-user.html#dx1-24009" >2162</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">\glsxtr@texencoding</span></span></span>  <a -href="glossaries-user.html#dx1-214039" >2134</a> <br /></span> +href="glossaries-user.html#dx1-217039" >2163</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">\glsxtrabbrvfootnote</span></span></span>  <a -href="glossaries-user.html#dx1-182016" >2135</a>, <a -href="glossaries-user.html#dx1-182017" >2136</a>, <a -href="glossaries-user.html#dx1-182020" >2137</a>, <a -href="glossaries-user.html#dx1-184053" >2138</a>, <a -href="glossaries-user.html#dx1-184056" >2139</a> <br /></span> +href="glossaries-user.html#dx1-185016" >2164</a>, <a +href="glossaries-user.html#dx1-185017" >2165</a>, <a +href="glossaries-user.html#dx1-185020" >2166</a>, <a +href="glossaries-user.html#dx1-187053" >2167</a>, <a +href="glossaries-user.html#dx1-187056" >2168</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">\glsxtrabbrvtype</span></span></span>  <a -href="glossaries-user.html#dx1-90017" >2140</a>, <a -href="glossaries-user.html#dx1-90020" >2141</a>, <a -href="glossaries-user.html#dx1-92001" >2142</a> <br /></span> +href="glossaries-user.html#dx1-91017" >2169</a>, <a +href="glossaries-user.html#dx1-91020" >2170</a>, <a +href="glossaries-user.html#dx1-93001" >2171</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">\glsxtrbookindexname</span></span></span>  <a -href="glossaries-user.html#dx1-11087" >2143</a> <br /></span> +href="glossaries-user.html#dx1-11087" >2172</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">\glsxtrcombiningdiacriticrules</span></span></span>  <a -href="glossaries-user.html#dx1-211061" >2144</a>, <a -href="glossaries-user.html#dx1-211082" >2145</a> <br /></span> +href="glossaries-user.html#dx1-214061" >2173</a>, <a +href="glossaries-user.html#dx1-214082" >2174</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">\glsxtrcontrolrules</span></span></span>  <a -href="glossaries-user.html#dx1-211058" >2146</a>, <a -href="glossaries-user.html#dx1-211079" >2147</a> <br /></span> +href="glossaries-user.html#dx1-214058" >2175</a>, <a +href="glossaries-user.html#dx1-214079" >2176</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">\glsxtrdigitrules</span></span></span>  <a -href="glossaries-user.html#dx1-211064" >2148</a>, <a -href="glossaries-user.html#dx1-211085" >2149</a> <br /></span> +href="glossaries-user.html#dx1-214064" >2177</a>, <a +href="glossaries-user.html#dx1-214085" >2178</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">\glsxtrdopostpunc</span></span></span>  <a -href="glossaries-user.html#dx1-183023" >2150</a>, <a -href="glossaries-user.html#dx1-183035" >2151</a> <br /></span> +href="glossaries-user.html#dx1-186023" >2179</a>, <a +href="glossaries-user.html#dx1-186035" >2180</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">\glsxtrequationlocfmt</span></span></span>  <a -href="glossaries-user.html#dx1-190046" >2152</a> <br /></span> +href="glossaries-user.html#dx1-193046" >2181</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">\glsxtrfieldforlistloop</span></span></span>  <a -href="glossaries-user.html#dx1-200046" >2153</a> <br /></span> +href="glossaries-user.html#dx1-203046" >2182</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">\glsxtrfieldformatlist</span></span></span>  <a -href="glossaries-user.html#dx1-220027" >2154</a>, <a -href="glossaries-user.html#dx1-220043" >2155</a> <br /></span> +href="glossaries-user.html#dx1-223027" >2183</a>, <a +href="glossaries-user.html#dx1-223043" >2184</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">\glsxtrfmt</span></span></span>  <a -href="glossaries-user.html#dx1-188041" >2156</a>, <a -href="glossaries-user.html#dx1-189054" >2157</a>, <a -href="glossaries-user.html#dx1-189055" >2158</a>, <a -href="glossaries-user.html#dx1-189056" >2159</a>, <a -href="glossaries-user.html#dx1-189057" >2160</a>, <a -href="glossaries-user.html#dx1-189059" >2161</a>, <a -href="glossaries-user.html#dx1-189061" >2162</a> <br /></span> +href="glossaries-user.html#dx1-191041" >2185</a>, <a +href="glossaries-user.html#dx1-192054" >2186</a>, <a +href="glossaries-user.html#dx1-192055" >2187</a>, <a +href="glossaries-user.html#dx1-192056" >2188</a>, <a +href="glossaries-user.html#dx1-192057" >2189</a>, <a +href="glossaries-user.html#dx1-192059" >2190</a>, <a +href="glossaries-user.html#dx1-192061" >2191</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">\GlsXtrFmtField</span></span></span>  <a -href="glossaries-user.html#dx1-189034" >2163</a> <br /></span> +href="glossaries-user.html#dx1-192034" >2192</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">\glsxtrfootnotedescname</span></span></span>  <a -href="glossaries-user.html#dx1-182006" >2164</a>, <a -href="glossaries-user.html#dx1-184062" >2165</a> <br /></span> +href="glossaries-user.html#dx1-185006" >2193</a>, <a +href="glossaries-user.html#dx1-187062" >2194</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">\glsxtrfootnotedescsort</span></span></span>  <a -href="glossaries-user.html#dx1-182014" >2166</a>, <a -href="glossaries-user.html#dx1-184069" >2167</a> <br /></span> +href="glossaries-user.html#dx1-185014" >2195</a>, <a +href="glossaries-user.html#dx1-187069" >2196</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">\glsxtrfull</span></span></span>  <a -href="glossaries-user.html#dx1-178040" >2168</a>, <a -href="glossaries-user.html#dx1-179041" >2169</a>, <a -href="glossaries-user.html#dx1-186018" >2170</a>, <a -href="glossaries-user.html#dx1-224053" >2171</a> <br /></span> +href="glossaries-user.html#dx1-181040" >2197</a>, <a +href="glossaries-user.html#dx1-182041" >2198</a>, <a +href="glossaries-user.html#dx1-189018" >2199</a>, <a +href="glossaries-user.html#dx1-227053" >2200</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">\glsxtrfullsep</span></span></span>  <a -href="glossaries-user.html#dx1-182009" >2172</a>, <a -href="glossaries-user.html#dx1-184016" >2173</a>, <a -href="glossaries-user.html#dx1-184025" >2174</a>, <a -href="glossaries-user.html#dx1-184034" >2175</a>, <a -href="glossaries-user.html#dx1-184043" >2176</a> <br /></span> +href="glossaries-user.html#dx1-185009" >2201</a>, <a +href="glossaries-user.html#dx1-187016" >2202</a>, <a +href="glossaries-user.html#dx1-187025" >2203</a>, <a +href="glossaries-user.html#dx1-187034" >2204</a>, <a +href="glossaries-user.html#dx1-187043" >2205</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">\glsxtrgeneralpuncrules</span></span></span>  <a -href="glossaries-user.html#dx1-211063" >2177</a>, <a -href="glossaries-user.html#dx1-211084" >2178</a> <br /></span> +href="glossaries-user.html#dx1-214063" >2206</a>, <a +href="glossaries-user.html#dx1-214084" >2207</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">\glsxtrglossentry</span></span></span>  <a -href="glossaries-user.html#dx1-11005" >2179</a>, <a -href="glossaries-user.html#dx1-11013" >2180</a>, <a -href="glossaries-user.html#dx1-11033" >2181</a> <br /></span> +href="glossaries-user.html#dx1-11005" >2208</a>, <a +href="glossaries-user.html#dx1-11013" >2209</a>, <a +href="glossaries-user.html#dx1-11033" >2210</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">\glsxtrhiername</span></span></span>  <a +href="glossaries-user.html#dx1-148016" >2211</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">\glsxtrhyphenrules</span></span></span>  <a -href="glossaries-user.html#dx1-211062" >2182</a>, <a -href="glossaries-user.html#dx1-211083" >2183</a> <br /></span> +href="glossaries-user.html#dx1-214062" >2212</a>, <a +href="glossaries-user.html#dx1-214083" >2213</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">\GlsXtrIfFieldEqNum</span></span></span>  <a -href="glossaries-user.html#dx1-209009" >2184</a> <br /></span> +href="glossaries-user.html#dx1-212009" >2214</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">\GlsXtrIfFieldNonZero</span></span></span>  <a -href="glossaries-user.html#dx1-200044" >2185</a> <br /></span> +href="glossaries-user.html#dx1-203044" >2215</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">\glsxtrifhasfield</span></span></span>  <a -href="glossaries-user.html#dx1-200020" >2186</a>, <a -href="glossaries-user.html#dx1-202023" >2187</a> <br /></span> +href="glossaries-user.html#dx1-203020" >2216</a>, <a +href="glossaries-user.html#dx1-205023" >2217</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">\GlsXtrIfUnusedOrUndefined</span></span></span>  <a +href="glossaries-user.html#dx1-142013" >2218</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">\glsxtrifwasfirstuse</span></span></span>  <a -href="glossaries-user.html#dx1-183014" >2188</a>, <a -href="glossaries-user.html#dx1-183022" >2189</a>, <a -href="glossaries-user.html#dx1-183034" >2190</a>, <a -href="glossaries-user.html#dx1-202022" >2191</a> <br /></span> +href="glossaries-user.html#dx1-186014" >2219</a>, <a +href="glossaries-user.html#dx1-186022" >2220</a>, <a +href="glossaries-user.html#dx1-186034" >2221</a>, <a +href="glossaries-user.html#dx1-205022" >2222</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">\GlsXtrIfXpFieldEqXpStr</span></span></span>  <a -href="glossaries-user.html#dx1-200025" >2192</a>, <a -href="glossaries-user.html#dx1-200031" >2193</a>, <a -href="glossaries-user.html#dx1-200048" >2194</a> <br /></span> +href="glossaries-user.html#dx1-203025" >2223</a>, <a +href="glossaries-user.html#dx1-203031" >2224</a>, <a +href="glossaries-user.html#dx1-203048" >2225</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">\Glsxtrinlinefullformat</span></span></span>  <a -href="glossaries-user.html#dx1-184029" >2195</a> <br /></span> +href="glossaries-user.html#dx1-187029" >2226</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">\glsxtrinlinefullformat</span></span></span>  <a -href="glossaries-user.html#dx1-184011" >2196</a> <br /></span> +href="glossaries-user.html#dx1-187011" >2227</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">\Glsxtrinlinefullplformat</span></span></span>  <a -href="glossaries-user.html#dx1-184038" >2197</a> <br /></span> +href="glossaries-user.html#dx1-187038" >2228</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">\glsxtrinlinefullplformat</span></span></span>  <a -href="glossaries-user.html#dx1-184020" >2198</a> <br /></span> +href="glossaries-user.html#dx1-187020" >2229</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">\GlsXtrLoadResources</span></span></span>  <a -href="glossaries-user.html#dx1-9003" >2199</a>, <a -href="glossaries-user.html#dx1-9022" >2200</a>, <a -href="glossaries-user.html#dx1-9023" >2201</a>, <a -href="glossaries-user.html#dx1-11009" >2202</a>, <a -href="glossaries-user.html#dx1-11025" >2203</a>, <a -href="glossaries-user.html#dx1-11076" >2204</a>, <a -href="glossaries-user.html#dx1-71007" >2205</a>, <a -href="glossaries-user.html#dx1-74009" >2206</a>, <a -href="glossaries-user.html#dx1-175052" >2207</a>, <a -href="glossaries-user.html#dx1-175054" >2208</a>, <a -href="glossaries-user.html#dx1-175056" >2209</a>, <a -href="glossaries-user.html#dx1-176017" >2210</a>, <a -href="glossaries-user.html#dx1-176020" >2211</a>, <a -href="glossaries-user.html#dx1-179053" >2212</a>, <a -href="glossaries-user.html#dx1-179058" >2213</a>, <a -href="glossaries-user.html#dx1-179074" >2214</a>, <a -href="glossaries-user.html#dx1-188034" >2215</a>, <a -href="glossaries-user.html#dx1-190029" >2216</a>, <a -href="glossaries-user.html#dx1-192054" >2217</a>, <a -href="glossaries-user.html#dx1-192056" >2218</a>, <a -href="glossaries-user.html#dx1-193026" >2219</a>, <a -href="glossaries-user.html#dx1-193044" >2220</a>, <a -href="glossaries-user.html#dx1-194022" >2221</a>, <a -href="glossaries-user.html#dx1-197023" >2222</a>, <a -href="glossaries-user.html#dx1-198034" >2223</a>, <a -href="glossaries-user.html#dx1-198036" >2224</a>, <a -href="glossaries-user.html#dx1-200086" >2225</a>, <a -href="glossaries-user.html#dx1-200098" >2226</a>, <a -href="glossaries-user.html#dx1-202053" >2227</a>, <a -href="glossaries-user.html#dx1-202093" >2228</a>, <a -href="glossaries-user.html#dx1-204025" >2229</a>, <a -href="glossaries-user.html#dx1-204028" >2230</a>, <a -href="glossaries-user.html#dx1-204034" >2231</a>, <a -href="glossaries-user.html#dx1-206017" >2232</a>, <a -href="glossaries-user.html#dx1-211043" >2233</a>, <a -href="glossaries-user.html#dx1-211055" >2234</a>, <a -href="glossaries-user.html#dx1-211075" >2235</a>, <a -href="glossaries-user.html#dx1-212011" >2236</a>, <a -href="glossaries-user.html#dx1-214024" >2237</a>, <a -href="glossaries-user.html#dx1-214048" >2238</a>, <a -href="glossaries-user.html#dx1-214051" >2239</a>, <a -href="glossaries-user.html#dx1-220024" >2240</a>, <a -href="glossaries-user.html#dx1-223012" >2241</a>, <a -href="glossaries-user.html#dx1-223022" >2242</a> <br /></span> +href="glossaries-user.html#dx1-9003" >2230</a>, <a +href="glossaries-user.html#dx1-9022" >2231</a>, <a +href="glossaries-user.html#dx1-9023" >2232</a>, <a +href="glossaries-user.html#dx1-11009" >2233</a>, <a +href="glossaries-user.html#dx1-11025" >2234</a>, <a +href="glossaries-user.html#dx1-11076" >2235</a>, <a +href="glossaries-user.html#dx1-66004" >2236</a>, <a +href="glossaries-user.html#dx1-67005" >2237</a>, <a +href="glossaries-user.html#dx1-72007" >2238</a>, <a +href="glossaries-user.html#dx1-75009" >2239</a>, <a +href="glossaries-user.html#dx1-178052" >2240</a>, <a +href="glossaries-user.html#dx1-178054" >2241</a>, <a +href="glossaries-user.html#dx1-178056" >2242</a>, <a +href="glossaries-user.html#dx1-179017" >2243</a>, <a +href="glossaries-user.html#dx1-179020" >2244</a>, <a +href="glossaries-user.html#dx1-182053" >2245</a>, <a +href="glossaries-user.html#dx1-182058" >2246</a>, <a +href="glossaries-user.html#dx1-182074" >2247</a>, <a +href="glossaries-user.html#dx1-191034" >2248</a>, <a +href="glossaries-user.html#dx1-193029" >2249</a>, <a +href="glossaries-user.html#dx1-195054" >2250</a>, <a +href="glossaries-user.html#dx1-195056" >2251</a>, <a +href="glossaries-user.html#dx1-196026" >2252</a>, <a +href="glossaries-user.html#dx1-196044" >2253</a>, <a +href="glossaries-user.html#dx1-197022" >2254</a>, <a +href="glossaries-user.html#dx1-200023" >2255</a>, <a +href="glossaries-user.html#dx1-201034" >2256</a>, <a +href="glossaries-user.html#dx1-201036" >2257</a>, <a +href="glossaries-user.html#dx1-203086" >2258</a>, <a +href="glossaries-user.html#dx1-203098" >2259</a>, <a +href="glossaries-user.html#dx1-205053" >2260</a>, <a +href="glossaries-user.html#dx1-205093" >2261</a>, <a +href="glossaries-user.html#dx1-207025" >2262</a>, <a +href="glossaries-user.html#dx1-207028" >2263</a>, <a +href="glossaries-user.html#dx1-207034" >2264</a>, <a +href="glossaries-user.html#dx1-209017" >2265</a>, <a +href="glossaries-user.html#dx1-214043" >2266</a>, <a +href="glossaries-user.html#dx1-214055" >2267</a>, <a +href="glossaries-user.html#dx1-214075" >2268</a>, <a +href="glossaries-user.html#dx1-215011" >2269</a>, <a +href="glossaries-user.html#dx1-217024" >2270</a>, <a +href="glossaries-user.html#dx1-217048" >2271</a>, <a +href="glossaries-user.html#dx1-217051" >2272</a>, <a +href="glossaries-user.html#dx1-223024" >2273</a>, <a +href="glossaries-user.html#dx1-226012" >2274</a>, <a +href="glossaries-user.html#dx1-226022" >2275</a> <br /></span> <span class="index-item"><sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">\GlsXtrLoadResources </span>options<br /></span> <span class="index-subitem">    <span class="cmtt-10">abbreviation-sort-fallback</span>  <a -href="glossaries-user.html#dx1-179060" >2243</a> <br /></span> +href="glossaries-user.html#dx1-182060" >2276</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">append-prefix-field</span>  <a -href="glossaries-user.html#dx1-223021" >2244</a> <br /></span> +href="glossaries-user.html#dx1-226021" >2277</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">break-at</span>  <a -href="glossaries-user.html#dx1-74008" >2245</a>, <a -href="glossaries-user.html#dx1-200097" >2246</a>, <a -href="glossaries-user.html#dx1-211052" >2247</a>, <a -href="glossaries-user.html#dx1-211071" >2248</a>, <a -href="glossaries-user.html#dx1-211072" >2249</a> <br /></span> +href="glossaries-user.html#dx1-75008" >2278</a>, <a +href="glossaries-user.html#dx1-203097" >2279</a>, <a +href="glossaries-user.html#dx1-214052" >2280</a>, <a +href="glossaries-user.html#dx1-214071" >2281</a>, <a +href="glossaries-user.html#dx1-214072" >2282</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">category</span>  <a -href="glossaries-user.html#dx1-194024" >2250</a> <br /></span> +href="glossaries-user.html#dx1-197024" >2283</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">combine-dual-locations</span>  <a -href="glossaries-user.html#dx1-193048" >2251</a> <br /></span> +href="glossaries-user.html#dx1-196048" >2284</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">dual-category</span>  <a -href="glossaries-user.html#dx1-194025" >2252</a> <br /></span> +href="glossaries-user.html#dx1-197025" >2285</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">dual-prefix</span>  <a -href="glossaries-user.html#dx1-193021" >2253</a>, <a -href="glossaries-user.html#dx1-193047" >2254</a>, <a -href="glossaries-user.html#dx1-194026" >2255</a> <br /></span> +href="glossaries-user.html#dx1-196021" >2286</a>, <a +href="glossaries-user.html#dx1-196047" >2287</a>, <a +href="glossaries-user.html#dx1-197026" >2288</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">dual-sort</span>  <a -href="glossaries-user.html#dx1-194030" >2256</a> <br /></span> +href="glossaries-user.html#dx1-197030" >2289</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">dual-type</span>  <a -href="glossaries-user.html#dx1-193020" >2257</a>, <a -href="glossaries-user.html#dx1-193046" >2258</a>, <a -href="glossaries-user.html#dx1-194028" >2259</a> <br /></span> +href="glossaries-user.html#dx1-196020" >2290</a>, <a +href="glossaries-user.html#dx1-196046" >2291</a>, <a +href="glossaries-user.html#dx1-197028" >2292</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">entry-type-aliases</span>  <a -href="glossaries-user.html#dx1-202102" >2260</a> <br /></span> +href="glossaries-user.html#dx1-205102" >2293</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">ext-prefixes</span>  <a -href="glossaries-user.html#dx1-192035" >2261</a> <br /></span> +href="glossaries-user.html#dx1-195035" >2294</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">field-aliases</span>  <a -href="glossaries-user.html#dx1-202101" >2262</a> <br /></span> +href="glossaries-user.html#dx1-205101" >2295</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">identical-sort-action</span>  <a -href="glossaries-user.html#dx1-200082" >2263</a> <br /></span> +href="glossaries-user.html#dx1-203082" >2296</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">ignore-fields</span>  <a -href="glossaries-user.html#dx1-179076" >2264</a> <br /></span> +href="glossaries-user.html#dx1-182076" >2297</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">label-prefix</span>  <a -href="glossaries-user.html#dx1-192034" >2265</a> <br /></span> +href="glossaries-user.html#dx1-195034" >2298</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">loc-counters</span>  <a -href="glossaries-user.html#dx1-189067" >2266</a> <br /></span> +href="glossaries-user.html#dx1-192067" >2299</a> <br /></span> + + <span class="index-subitem">    <span class="cmtt-10">name-case-change</span>  <a -href="glossaries-user.html#dx1-11062" >2267</a> <br /></span> +href="glossaries-user.html#dx1-11062" >2300</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">primary-location-formats</span>  <a -href="glossaries-user.html#dx1-189069" >2268</a> <br /></span> - - +href="glossaries-user.html#dx1-192069" >2301</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">replicate-fields</span>  <a -href="glossaries-user.html#dx1-11061" >2269</a>, <a -href="glossaries-user.html#dx1-11079" >2270</a> <br /></span> +href="glossaries-user.html#dx1-11061" >2302</a>, <a +href="glossaries-user.html#dx1-11079" >2303</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">save-child-count</span>  <a -href="glossaries-user.html#dx1-200038" >2271</a> <br /></span> +href="glossaries-user.html#dx1-172014" >2304</a>, <a +href="glossaries-user.html#dx1-203038" >2305</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">save-locations</span>  <a -href="glossaries-user.html#dx1-11030" >2272</a>, <a -href="glossaries-user.html#dx1-11070" >2273</a>, <a -href="glossaries-user.html#dx1-45010" >2274</a> <br /></span> +href="glossaries-user.html#dx1-11030" >2306</a>, <a +href="glossaries-user.html#dx1-11070" >2307</a>, <a +href="glossaries-user.html#dx1-46010" >2308</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">save-loclist</span>  <a -href="glossaries-user.html#dx1-45011" >2275</a> <br /></span> +href="glossaries-user.html#dx1-46011" >2309</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">save-sibling-count</span>  <a -href="glossaries-user.html#dx1-200039" >2276</a>, <a -href="glossaries-user.html#dx1-200043" >2277</a>, <a -href="glossaries-user.html#dx1-200054" >2278</a>, <a -href="glossaries-user.html#dx1-200088" >2279</a> <br /></span> +href="glossaries-user.html#dx1-203039" >2310</a>, <a +href="glossaries-user.html#dx1-203043" >2311</a>, <a +href="glossaries-user.html#dx1-203054" >2312</a>, <a +href="glossaries-user.html#dx1-203088" >2313</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">save-locations</span>  <a -href="glossaries-user.html#dx1-11012" >2280</a>, <a -href="glossaries-user.html#dx1-11060" >2281</a> <br /></span> +href="glossaries-user.html#dx1-11012" >2314</a>, <a +href="glossaries-user.html#dx1-11060" >2315</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">selection</span>  <a -href="glossaries-user.html#dx1-9029" >2282</a>, <a -href="glossaries-user.html#dx1-204036" >2283</a>, <a -href="glossaries-user.html#dx1-214026" >2284</a>, <a -href="glossaries-user.html#dx1-214029" >2285</a>, <a -href="glossaries-user.html#dx1-214032" >2286</a>, <a -href="glossaries-user.html#dx1-214050" >2287</a>, <a -href="glossaries-user.html#dx1-214053" >2288</a> <br /></span> +href="glossaries-user.html#dx1-9029" >2316</a>, <a +href="glossaries-user.html#dx1-113149" >2317</a>, <a +href="glossaries-user.html#dx1-207036" >2318</a>, <a +href="glossaries-user.html#dx1-217026" >2319</a>, <a +href="glossaries-user.html#dx1-217029" >2320</a>, <a +href="glossaries-user.html#dx1-217032" >2321</a>, <a +href="glossaries-user.html#dx1-217050" >2322</a>, <a +href="glossaries-user.html#dx1-217053" >2323</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">set-widest</span>  <a -href="glossaries-user.html#dx1-202055" >2289</a> <br /></span> +href="glossaries-user.html#dx1-205055" >2324</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">sort</span>  <a -href="glossaries-user.html#dx1-9025" >2290</a>, <a -href="glossaries-user.html#dx1-9028" >2291</a>, <a -href="glossaries-user.html#dx1-11011" >2292</a>, <a -href="glossaries-user.html#dx1-11059" >2293</a>, <a -href="glossaries-user.html#dx1-11078" >2294</a>, <a -href="glossaries-user.html#dx1-176019" >2295</a>, <a -href="glossaries-user.html#dx1-176022" >2296</a>, <a -href="glossaries-user.html#dx1-194029" >2297</a>, <a -href="glossaries-user.html#dx1-198038" >2298</a>, <a -href="glossaries-user.html#dx1-211057" >2299</a>, <a -href="glossaries-user.html#dx1-211077" >2300</a>, <a -href="glossaries-user.html#dx1-214047" >2301</a> <br /></span> +href="glossaries-user.html#dx1-9025" >2325</a>, <a +href="glossaries-user.html#dx1-9028" >2326</a>, <a +href="glossaries-user.html#dx1-11011" >2327</a>, <a +href="glossaries-user.html#dx1-11059" >2328</a>, <a +href="glossaries-user.html#dx1-11078" >2329</a>, <a +href="glossaries-user.html#dx1-179019" >2330</a>, <a +href="glossaries-user.html#dx1-179022" >2331</a>, <a +href="glossaries-user.html#dx1-197029" >2332</a>, <a +href="glossaries-user.html#dx1-201038" >2333</a>, <a +href="glossaries-user.html#dx1-214057" >2334</a>, <a +href="glossaries-user.html#dx1-214077" >2335</a>, <a +href="glossaries-user.html#dx1-217047" >2336</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">sort-rule</span>  <a -href="glossaries-user.html#dx1-211078" >2302</a> <br /></span> +href="glossaries-user.html#dx1-214078" >2337</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">src</span>  <a -href="glossaries-user.html#dx1-9004" >2303</a>, <a -href="glossaries-user.html#dx1-9024" >2304</a>, <a -href="glossaries-user.html#dx1-9027" >2305</a>, <a -href="glossaries-user.html#dx1-11010" >2306</a>, <a -href="glossaries-user.html#dx1-11026" >2307</a>, <a -href="glossaries-user.html#dx1-11058" >2308</a>, <a -href="glossaries-user.html#dx1-11077" >2309</a>, <a -href="glossaries-user.html#dx1-175053" >2310</a>, <a -href="glossaries-user.html#dx1-175057" >2311</a>, <a -href="glossaries-user.html#dx1-176018" >2312</a>, <a -href="glossaries-user.html#dx1-176021" >2313</a>, <a -href="glossaries-user.html#dx1-179054" >2314</a>, <a -href="glossaries-user.html#dx1-179059" >2315</a>, <a -href="glossaries-user.html#dx1-179075" >2316</a>, <a -href="glossaries-user.html#dx1-188035" >2317</a>, <a -href="glossaries-user.html#dx1-192055" >2318</a>, <a -href="glossaries-user.html#dx1-192057" >2319</a>, <a -href="glossaries-user.html#dx1-193018" >2320</a>, <a -href="glossaries-user.html#dx1-193027" >2321</a>, <a -href="glossaries-user.html#dx1-193045" >2322</a>, <a -href="glossaries-user.html#dx1-194023" >2323</a>, <a -href="glossaries-user.html#dx1-197024" >2324</a>, <a -href="glossaries-user.html#dx1-198035" >2325</a>, <a -href="glossaries-user.html#dx1-198037" >2326</a>, <a -href="glossaries-user.html#dx1-200087" >2327</a>, <a -href="glossaries-user.html#dx1-200099" >2328</a>, <a -href="glossaries-user.html#dx1-202054" >2329</a>, <a -href="glossaries-user.html#dx1-202094" >2330</a>, <a -href="glossaries-user.html#dx1-204026" >2331</a>, <a -href="glossaries-user.html#dx1-204029" >2332</a>, <a -href="glossaries-user.html#dx1-204035" >2333</a>, <a -href="glossaries-user.html#dx1-206018" >2334</a>, <a -href="glossaries-user.html#dx1-211044" >2335</a>, <a -href="glossaries-user.html#dx1-211056" >2336</a>, <a -href="glossaries-user.html#dx1-211076" >2337</a>, <a -href="glossaries-user.html#dx1-212012" >2338</a>, <a -href="glossaries-user.html#dx1-214025" >2339</a>, <a -href="glossaries-user.html#dx1-214049" >2340</a>, <a -href="glossaries-user.html#dx1-214052" >2341</a>, <a -href="glossaries-user.html#dx1-220025" >2342</a>, <a -href="glossaries-user.html#dx1-223013" >2343</a>, <a -href="glossaries-user.html#dx1-223023" >2344</a> <br /></span> +href="glossaries-user.html#dx1-9004" >2338</a>, <a +href="glossaries-user.html#dx1-9024" >2339</a>, <a +href="glossaries-user.html#dx1-9027" >2340</a>, <a +href="glossaries-user.html#dx1-11010" >2341</a>, <a +href="glossaries-user.html#dx1-11026" >2342</a>, <a +href="glossaries-user.html#dx1-11058" >2343</a>, <a +href="glossaries-user.html#dx1-11077" >2344</a>, <a +href="glossaries-user.html#dx1-178053" >2345</a>, <a +href="glossaries-user.html#dx1-178057" >2346</a>, <a +href="glossaries-user.html#dx1-179018" >2347</a>, <a +href="glossaries-user.html#dx1-179021" >2348</a>, <a +href="glossaries-user.html#dx1-182054" >2349</a>, <a +href="glossaries-user.html#dx1-182059" >2350</a>, <a +href="glossaries-user.html#dx1-182075" >2351</a>, <a +href="glossaries-user.html#dx1-191035" >2352</a>, <a +href="glossaries-user.html#dx1-195055" >2353</a>, <a +href="glossaries-user.html#dx1-195057" >2354</a>, <a +href="glossaries-user.html#dx1-196018" >2355</a>, <a +href="glossaries-user.html#dx1-196027" >2356</a>, <a +href="glossaries-user.html#dx1-196045" >2357</a>, <a +href="glossaries-user.html#dx1-197023" >2358</a>, <a +href="glossaries-user.html#dx1-200024" >2359</a>, <a +href="glossaries-user.html#dx1-201035" >2360</a>, <a +href="glossaries-user.html#dx1-201037" >2361</a>, <a +href="glossaries-user.html#dx1-203087" >2362</a>, <a +href="glossaries-user.html#dx1-203099" >2363</a>, <a +href="glossaries-user.html#dx1-205054" >2364</a>, <a +href="glossaries-user.html#dx1-205094" >2365</a>, <a +href="glossaries-user.html#dx1-207026" >2366</a>, <a +href="glossaries-user.html#dx1-207029" >2367</a>, <a +href="glossaries-user.html#dx1-207035" >2368</a>, <a +href="glossaries-user.html#dx1-209018" >2369</a>, <a +href="glossaries-user.html#dx1-214044" >2370</a>, <a +href="glossaries-user.html#dx1-214056" >2371</a>, <a +href="glossaries-user.html#dx1-214076" >2372</a>, <a +href="glossaries-user.html#dx1-215012" >2373</a>, <a +href="glossaries-user.html#dx1-217025" >2374</a>, <a +href="glossaries-user.html#dx1-217049" >2375</a>, <a +href="glossaries-user.html#dx1-217052" >2376</a>, <a +href="glossaries-user.html#dx1-223025" >2377</a>, <a +href="glossaries-user.html#dx1-226013" >2378</a>, <a +href="glossaries-user.html#dx1-226023" >2379</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">type</span>  <a -href="glossaries-user.html#dx1-192058" >2345</a>, <a -href="glossaries-user.html#dx1-193019" >2346</a>, <a -href="glossaries-user.html#dx1-194027" >2347</a> <br /></span> +href="glossaries-user.html#dx1-195058" >2380</a>, <a +href="glossaries-user.html#dx1-196019" >2381</a>, <a +href="glossaries-user.html#dx1-197027" >2382</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">\glsxtrlocalsetgrouptitle</span></span></span>  <a +href="glossaries-user.html#dx1-144104" >2383</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">\glsxtrlong</span></span></span>  <a -href="glossaries-user.html#dx1-178039" >2348</a>, <a -href="glossaries-user.html#dx1-179040" >2349</a>, <a -href="glossaries-user.html#dx1-186017" >2350</a>, <a -href="glossaries-user.html#dx1-224052" >2351</a> <br /></span> +href="glossaries-user.html#dx1-181039" >2384</a>, <a +href="glossaries-user.html#dx1-182040" >2385</a>, <a +href="glossaries-user.html#dx1-189017" >2386</a>, <a +href="glossaries-user.html#dx1-227052" >2387</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">\glsxtrnewgls</span></span></span>  <a -href="glossaries-user.html#dx1-192027" >2352</a> <br /></span> +href="glossaries-user.html#dx1-195027" >2388</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">\glsxtrnewglslike</span></span></span>  <a -href="glossaries-user.html#dx1-24019" >2353</a>, <a -href="glossaries-user.html#dx1-192028" >2354</a>, <a -href="glossaries-user.html#dx1-193049" >2355</a>, <a -href="glossaries-user.html#dx1-194040" >2356</a> <br /></span> +href="glossaries-user.html#dx1-24019" >2389</a>, <a +href="glossaries-user.html#dx1-195028" >2390</a>, <a +href="glossaries-user.html#dx1-196049" >2391</a>, <a +href="glossaries-user.html#dx1-197040" >2392</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">\glsxtrnewnumber</span></span></span>  <a -href="glossaries-user.html#dx1-86005" >2357</a> <br /></span> +href="glossaries-user.html#dx1-87005" >2393</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">\glsxtrnewsymbol</span></span></span>  <a -href="glossaries-user.html#dx1-4009" >2358</a>, <a -href="glossaries-user.html#dx1-6014" >2359</a>, <a -href="glossaries-user.html#dx1-8016" >2360</a>, <a -href="glossaries-user.html#dx1-85005" >2361</a> <br /></span> +href="glossaries-user.html#dx1-4009" >2394</a>, <a +href="glossaries-user.html#dx1-6014" >2395</a>, <a +href="glossaries-user.html#dx1-8016" >2396</a>, <a +href="glossaries-user.html#dx1-86005" >2397</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">\glsxtrnonprintablerules</span></span></span>  <a -href="glossaries-user.html#dx1-211060" >2362</a>, <a -href="glossaries-user.html#dx1-211081" >2363</a> <br /></span> +href="glossaries-user.html#dx1-214060" >2398</a>, <a +href="glossaries-user.html#dx1-214081" >2399</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">\glsxtrnopostpunc</span></span></span>  <a -href="glossaries-user.html#dx1-112024" >2364</a>, <a -href="glossaries-user.html#dx1-197017" >2365</a>, <a -href="glossaries-user.html#dx1-200016" >2366</a>, <a -href="glossaries-user.html#dx1-200017" >2367</a>, <a -href="glossaries-user.html#dx1-200034" >2368</a>, <a -href="glossaries-user.html#dx1-202018" >2369</a>, <a -href="glossaries-user.html#dx1-202035" >2370</a>, <a -href="glossaries-user.html#dx1-206011" >2371</a> <br /></span> +href="glossaries-user.html#dx1-113029" >2400</a>, <a +href="glossaries-user.html#dx1-200017" >2401</a>, <a +href="glossaries-user.html#dx1-203016" >2402</a>, <a +href="glossaries-user.html#dx1-203017" >2403</a>, <a +href="glossaries-user.html#dx1-203034" >2404</a>, <a +href="glossaries-user.html#dx1-205018" >2405</a>, <a +href="glossaries-user.html#dx1-205035" >2406</a>, <a +href="glossaries-user.html#dx1-209011" >2407</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">\glsxtrp</span></span></span>  <a -href="glossaries-user.html#dx1-192020" >2372</a> <br /></span> +href="glossaries-user.html#dx1-195020" >2408</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">\glsxtrparen</span></span></span>  <a -href="glossaries-user.html#dx1-182011" >2373</a>, <a -href="glossaries-user.html#dx1-184017" >2374</a>, <a -href="glossaries-user.html#dx1-184026" >2375</a>, <a -href="glossaries-user.html#dx1-184035" >2376</a>, <a -href="glossaries-user.html#dx1-184044" >2377</a> <br /></span> +href="glossaries-user.html#dx1-185011" >2409</a>, <a +href="glossaries-user.html#dx1-187017" >2410</a>, <a +href="glossaries-user.html#dx1-187026" >2411</a>, <a +href="glossaries-user.html#dx1-187035" >2412</a>, <a +href="glossaries-user.html#dx1-187044" >2413</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">\glsxtrpostlinkAddSymbolOnFirstUse</span></span></span>  <a -href="glossaries-user.html#dx1-222008" >2378</a> <br /></span> +href="glossaries-user.html#dx1-225008" >2414</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">\glsxtrsectionlocfmt</span></span></span>  <a -href="glossaries-user.html#dx1-190043" >2379</a>, <a -href="glossaries-user.html#dx1-190044" >2380</a>, <a -href="glossaries-user.html#dx1-212015" >2381</a> <br /></span> +href="glossaries-user.html#dx1-193043" >2415</a>, <a +href="glossaries-user.html#dx1-193044" >2416</a>, <a +href="glossaries-user.html#dx1-215015" >2417</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">\GlsXtrSetAltModifier</span></span></span>  <a -href="glossaries-user.html#dx1-24023" >2382</a>, <a -href="glossaries-user.html#dx1-189018" >2383</a> <br /></span> +href="glossaries-user.html#dx1-24023" >2418</a>, <a +href="glossaries-user.html#dx1-192018" >2419</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">\glsxtrsetgrouptitle</span></span></span>  <a +href="glossaries-user.html#dx1-144103" >2420</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">\glsxtrshort</span></span></span>  <a -href="glossaries-user.html#dx1-178038" >2384</a>, <a -href="glossaries-user.html#dx1-179039" >2385</a>, <a -href="glossaries-user.html#dx1-186016" >2386</a>, <a -href="glossaries-user.html#dx1-224051" >2387</a>, <a -href="glossaries-user.html#dx1-4005" >2388</a> <br /></span> +href="glossaries-user.html#dx1-181038" >2421</a>, <a +href="glossaries-user.html#dx1-182039" >2422</a>, <a +href="glossaries-user.html#dx1-189016" >2423</a>, <a +href="glossaries-user.html#dx1-227051" >2424</a>, <a +href="glossaries-user.html#dx1-4005" >2425</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">\glsxtrspacerules</span></span></span>  <a -href="glossaries-user.html#dx1-211059" >2389</a>, <a -href="glossaries-user.html#dx1-211080" >2390</a> <br /></span> +href="glossaries-user.html#dx1-214059" >2426</a>, <a +href="glossaries-user.html#dx1-214080" >2427</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">\GlsXtrUseAbbrStyleFmts</span></span></span>  <a -href="glossaries-user.html#dx1-184010" >2391</a> <br /></span> +href="glossaries-user.html#dx1-187010" >2428</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">\GlsXtrUseAbbrStyleSetup</span></span></span>  <a -href="glossaries-user.html#dx1-184009" >2392</a> <br /></span> +href="glossaries-user.html#dx1-187009" >2429</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">H</span> <span class="index-item"><span class="cmss-10">html </span>package  <a -href="glossaries-user.html#dx1-136002" >2393</a> <br /></span> +href="glossaries-user.html#dx1-133002" >2430</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperbf</span></span></span>  <a -href="glossaries-user.html#dx1-132061" >2394</a>, <a -href="glossaries-user.html#dx1-188004" >2395</a>, <a -href="glossaries-user.html#dx1-189004" >2396</a>, <a -href="glossaries-user.html#dx1-189005" >2397</a>, <a -href="glossaries-user.html#dx1-189068" >2398</a>, <a -href="glossaries-user.html#dx1-190012" >2399</a> <br /></span> +href="glossaries-user.html#dx1-129059" >2431</a>, <a +href="glossaries-user.html#dx1-191004" >2432</a>, <a +href="glossaries-user.html#dx1-192004" >2433</a>, <a +href="glossaries-user.html#dx1-192005" >2434</a>, <a +href="glossaries-user.html#dx1-192068" >2435</a>, <a +href="glossaries-user.html#dx1-193012" >2436</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperbfit</span></span></span>  <a -href="glossaries-user.html#dx1-190035" >2400</a> <br /></span> +href="glossaries-user.html#dx1-193035" >2437</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperbsf</span></span></span>  <a -href="glossaries-user.html#dx1-132069" >2401</a> <br /></span> +href="glossaries-user.html#dx1-129067" >2438</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperemph</span></span></span>  <a -href="glossaries-user.html#dx1-132067" >2402</a> <br /></span> +href="glossaries-user.html#dx1-129065" >2439</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperit</span></span></span>  <a -href="glossaries-user.html#dx1-132063" >2403</a>, <a -href="glossaries-user.html#dx1-190013" >2404</a>, <a -href="glossaries-user.html#dx1-190017" >2405</a> <br /></span> +href="glossaries-user.html#dx1-129061" >2440</a>, <a +href="glossaries-user.html#dx1-193013" >2441</a>, <a +href="glossaries-user.html#dx1-193017" >2442</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperlink</span></span></span>  <a -href="glossaries-user.html#dx1-132068" >2406</a>, <a -href="glossaries-user.html#dx1-136007" >2407</a> <br /></span> +href="glossaries-user.html#dx1-129066" >2443</a>, <a +href="glossaries-user.html#dx1-133007" >2444</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hypermd</span></span></span>  <a -href="glossaries-user.html#dx1-132062" >2408</a> <br /></span> +href="glossaries-user.html#dx1-129060" >2445</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperpage</span></span></span>  <a -href="glossaries-user.html#dx1-132053" >2409</a> <br /></span> +href="glossaries-user.html#dx1-129051" >2446</a> <br /></span> <span class="index-item"><span class="cmss-10">hyperref </span>package  <a -href="glossaries-user.html#dx1-17" >2410</a>, <a -href="glossaries-user.html#dx1-18" >2411</a>, <a -href="glossaries-user.html#dx1-19" >2412</a>, <a -href="glossaries-user.html#dx1-26" >2413</a>, <a -href="glossaries-user.html#dx1-11034" >2414</a>, <a -href="glossaries-user.html#dx1-11049" >2415</a>, <a -href="glossaries-user.html#dx1-70002" >2416</a>, <a -href="glossaries-user.html#dx1-130012" >2417</a>, <a -href="glossaries-user.html#dx1-130020" >2418</a>, <a -href="glossaries-user.html#dx1-132010" >2419</a>, <a -href="glossaries-user.html#dx1-132013" >2420</a>, <a -href="glossaries-user.html#dx1-132016" >2421</a>, <a -href="glossaries-user.html#dx1-132018" >2422</a>, <a -href="glossaries-user.html#dx1-132039" >2423</a>, <a -href="glossaries-user.html#dx1-132054" >2424</a>, <a -href="glossaries-user.html#dx1-133055" >2425</a>, <a -href="glossaries-user.html#dx1-135024" >2426</a>, <a -href="glossaries-user.html#dx1-136001" >2427</a>, <a -href="glossaries-user.html#dx1-136009" >2428</a>, <a -href="glossaries-user.html#dx1-140003" >2429</a>, <a -href="glossaries-user.html#dx1-140004" >2430</a>, <a -href="glossaries-user.html#dx1-140057" >2431</a>, <a -href="glossaries-user.html#dx1-140068" >2432</a>, <a -href="glossaries-user.html#dx1-140069" >2433</a>, <a -href="glossaries-user.html#dx1-144034" >2434</a>, <a -href="glossaries-user.html#dx1-144044" >2435</a>, <a -href="glossaries-user.html#dx1-166050" >2436</a>, <a -href="glossaries-user.html#dx1-173002" >2437</a>, <a -href="glossaries-user.html#dx1-188006" >2438</a>, <a -href="glossaries-user.html#dx1-220013" >2439</a>, <a -href="glossaries-user.html#dx1-220015" >2440</a>, <a -href="glossaries-user.html#dx1-220017" >2441</a>, <a -href="glossaries-user.html#dx1-31010" >2442</a> <br /></span> +href="glossaries-user.html#dx1-16" >2447</a>, <a +href="glossaries-user.html#dx1-17" >2448</a>, <a +href="glossaries-user.html#dx1-18" >2449</a>, <a +href="glossaries-user.html#dx1-25" >2450</a>, <a +href="glossaries-user.html#dx1-11034" >2451</a>, <a +href="glossaries-user.html#dx1-11049" >2452</a>, <a +href="glossaries-user.html#dx1-71002" >2453</a>, <a +href="glossaries-user.html#dx1-129008" >2454</a>, <a +href="glossaries-user.html#dx1-129011" >2455</a>, <a +href="glossaries-user.html#dx1-129014" >2456</a>, <a +href="glossaries-user.html#dx1-129016" >2457</a>, <a +href="glossaries-user.html#dx1-129037" >2458</a>, <a +href="glossaries-user.html#dx1-129052" >2459</a>, <a +href="glossaries-user.html#dx1-130055" >2460</a>, <a +href="glossaries-user.html#dx1-132024" >2461</a>, <a +href="glossaries-user.html#dx1-133001" >2462</a>, <a +href="glossaries-user.html#dx1-133009" >2463</a>, <a +href="glossaries-user.html#dx1-134003" >2464</a>, <a +href="glossaries-user.html#dx1-134004" >2465</a>, <a +href="glossaries-user.html#dx1-134057" >2466</a>, <a +href="glossaries-user.html#dx1-134068" >2467</a>, <a +href="glossaries-user.html#dx1-134069" >2468</a>, <a +href="glossaries-user.html#dx1-152012" >2469</a>, <a +href="glossaries-user.html#dx1-152020" >2470</a>, <a +href="glossaries-user.html#dx1-165051" >2471</a>, <a +href="glossaries-user.html#dx1-168034" >2472</a>, <a +href="glossaries-user.html#dx1-168044" >2473</a>, <a +href="glossaries-user.html#dx1-176002" >2474</a>, <a +href="glossaries-user.html#dx1-191006" >2475</a>, <a +href="glossaries-user.html#dx1-223013" >2476</a>, <a +href="glossaries-user.html#dx1-223015" >2477</a>, <a +href="glossaries-user.html#dx1-223017" >2478</a>, <a +href="glossaries-user.html#dx1-31010" >2479</a> <br /></span> + + <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperrm</span></span></span>  <a -href="glossaries-user.html#dx1-132058" >2443</a>, <a -href="glossaries-user.html#dx1-144013" >2444</a>, <a -href="glossaries-user.html#dx1-188003" >2445</a> <br /></span> +href="glossaries-user.html#dx1-129056" >2480</a>, <a +href="glossaries-user.html#dx1-168013" >2481</a>, <a +href="glossaries-user.html#dx1-191003" >2482</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hypersc</span></span></span>  <a -href="glossaries-user.html#dx1-132066" >2446</a> <br /></span> +href="glossaries-user.html#dx1-129064" >2483</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hypersf</span></span></span>  <a -href="glossaries-user.html#dx1-132059" >2447</a> <br /></span> - - +href="glossaries-user.html#dx1-129057" >2484</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hypersl</span></span></span>  <a -href="glossaries-user.html#dx1-132064" >2448</a> <br /></span> +href="glossaries-user.html#dx1-129062" >2485</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hypertarget</span></span></span>  <a -href="glossaries-user.html#dx1-136008" >2449</a> <br /></span> +href="glossaries-user.html#dx1-133008" >2486</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hypertt</span></span></span>  <a -href="glossaries-user.html#dx1-132060" >2450</a> <br /></span> +href="glossaries-user.html#dx1-129058" >2487</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\hyperup</span></span></span>  <a -href="glossaries-user.html#dx1-132065" >2451</a> <br /></span> +href="glossaries-user.html#dx1-129063" >2488</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">I</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglossaryexists</span></span></span>  <a -href="glossaries-user.html#dx1-169001" ><span -class="cmti-10">2452</span></a> <br /></span> +href="glossaries-user.html#dx1-172001" ><span +class="cmti-10">2489</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-169024" ><span -class="cmti-10">2453</span></a> <br /></span> +href="glossaries-user.html#dx1-172027" ><span +class="cmti-10">2490</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-169003" ><span -class="cmti-10">2454</span></a> <br /></span> +href="glossaries-user.html#dx1-172003" ><span +class="cmti-10">2491</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-169035" ><span -class="cmti-10">2455</span></a> <br /></span> +href="glossaries-user.html#dx1-172038" ><span +class="cmti-10">2492</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-169033" ><span -class="cmti-10">2456</span></a> <br /></span> +href="glossaries-user.html#dx1-172036" ><span +class="cmti-10">2493</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-169030" ><span -class="cmti-10">2458</span></a> <br /></span> +href="glossaries-user.html#dx1-139085" >2494</a>, <a +href="glossaries-user.html#dx1-172033" ><span +class="cmti-10">2495</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-169012" ><span -class="cmti-10">2459</span></a>, <a -href="glossaries-user.html#dx1-200036" >2460</a> <br /></span> +href="glossaries-user.html#dx1-172012" ><span +class="cmti-10">2496</span></a>, <a +href="glossaries-user.html#dx1-203036" >2497</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-169022" ><span -class="cmti-10">2461</span></a> <br /></span> +href="glossaries-user.html#dx1-172025" ><span +class="cmti-10">2498</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-169027" ><span -class="cmti-10">2462</span></a> <br /></span> +href="glossaries-user.html#dx1-172030" ><span +class="cmti-10">2499</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshaslong</span></span></span>  <a -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-169016" ><span -class="cmti-10">2467</span></a> <br /></span> +href="glossaries-user.html#dx1-34021" >2500</a>, <a +href="glossaries-user.html#dx1-118009" >2501</a>, <a +href="glossaries-user.html#dx1-118010" >2502</a>, <a +href="glossaries-user.html#dx1-139013" >2503</a>, <a +href="glossaries-user.html#dx1-172019" ><span +class="cmti-10">2504</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-169013" ><span -class="cmti-10">2468</span></a> <br /></span> +href="glossaries-user.html#dx1-172016" ><span +class="cmti-10">2505</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasprefix</span></span></span>  <a -href="glossaries-user.html#dx1-171041" ><span -class="cmti-10">2469</span></a> <br /></span> +href="glossaries-user.html#dx1-174041" ><span +class="cmti-10">2506</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasprefixfirst</span></span></span>  <a -href="glossaries-user.html#dx1-171045" ><span -class="cmti-10">2470</span></a> <br /></span> +href="glossaries-user.html#dx1-174045" ><span +class="cmti-10">2507</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasprefixfirstplural</span></span></span>  <a -href="glossaries-user.html#dx1-171047" ><span -class="cmti-10">2471</span></a> <br /></span> +href="glossaries-user.html#dx1-174047" ><span +class="cmti-10">2508</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglshasprefixplural</span></span></span>  <a -href="glossaries-user.html#dx1-171043" ><span -class="cmti-10">2472</span></a> <br /></span> +href="glossaries-user.html#dx1-174043" ><span +class="cmti-10">2509</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-169019" ><span -class="cmti-10">2474</span></a>, <a -href="glossaries-user.html#dx1-179026" >2475</a> <br /></span> +href="glossaries-user.html#dx1-139012" >2510</a>, <a +href="glossaries-user.html#dx1-172022" ><span +class="cmti-10">2511</span></a>, <a +href="glossaries-user.html#dx1-182026" >2512</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-169014" ><span -class="cmti-10">2478</span></a> <br /></span> +href="glossaries-user.html#dx1-11052" >2513</a>, <a +href="glossaries-user.html#dx1-165089" >2514</a>, <a +href="glossaries-user.html#dx1-172017" ><span +class="cmti-10">2515</span></a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsucmark</span></span></span>  <a -href="glossaries-user.html#dx1-42011" >2479</a> <br /></span> +href="glossaries-user.html#dx1-43011" >2516</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifglsused</span></span></span>  <a -href="glossaries-user.html#dx1-34019" >2480</a>, <a -href="glossaries-user.html#dx1-135030" >2481</a>, <a -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-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 -href="glossaries-user.html#dx1-183008" >2488</a>, <a -href="glossaries-user.html#dx1-222004" >2489</a> <br /></span> +href="glossaries-user.html#dx1-34019" >2517</a>, <a +href="glossaries-user.html#dx1-132030" >2518</a>, <a +href="glossaries-user.html#dx1-139004" >2519</a>, <a +href="glossaries-user.html#dx1-139089" >2520</a>, <a +href="glossaries-user.html#dx1-142011" ><span +class="cmti-10">2521</span></a>, <a +href="glossaries-user.html#dx1-172011" ><span +class="cmti-10">2522</span></a>, <a +href="glossaries-user.html#dx1-181003" >2523</a>, <a +href="glossaries-user.html#dx1-181004" >2524</a>, <a +href="glossaries-user.html#dx1-186008" >2525</a>, <a +href="glossaries-user.html#dx1-225004" >2526</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">\ifglsxtrinsertinside</span></span></span>  <a -href="glossaries-user.html#dx1-184014" >2490</a>, <a -href="glossaries-user.html#dx1-184015" >2491</a>, <a -href="glossaries-user.html#dx1-184023" >2492</a>, <a -href="glossaries-user.html#dx1-184024" >2493</a>, <a -href="glossaries-user.html#dx1-184032" >2494</a>, <a -href="glossaries-user.html#dx1-184033" >2495</a>, <a -href="glossaries-user.html#dx1-184041" >2496</a>, <a -href="glossaries-user.html#dx1-184042" >2497</a> <br /></span> +href="glossaries-user.html#dx1-187014" >2527</a>, <a +href="glossaries-user.html#dx1-187015" >2528</a>, <a +href="glossaries-user.html#dx1-187023" >2529</a>, <a +href="glossaries-user.html#dx1-187024" >2530</a>, <a +href="glossaries-user.html#dx1-187032" >2531</a>, <a +href="glossaries-user.html#dx1-187033" >2532</a>, <a +href="glossaries-user.html#dx1-187041" >2533</a>, <a +href="glossaries-user.html#dx1-187042" >2534</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\ifignoredglossary</span></span></span>  <a -href="glossaries-user.html#dx1-146014" ><span -class="cmti-10">2498</span></a> <br /></span> +href="glossaries-user.html#dx1-145014" ><span +class="cmti-10">2535</span></a> <br /></span> <span class="index-item"><span class="cmss-10">imakeidx </span>package  <a -href="glossaries-user.html#dx1-87011" >2499</a> <br /></span> +href="glossaries-user.html#dx1-88011" >2536</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\include</span></span></span>  <a -href="glossaries-user.html#dx1-122008" >2500</a> <br /></span> +href="glossaries-user.html#dx1-123008" >2537</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\includegraphics</span></span></span>  <a -href="glossaries-user.html#dx1-224031" >2501</a>, <a -href="glossaries-user.html#dx1-224032" >2502</a> <br /></span> +href="glossaries-user.html#dx1-227031" >2538</a>, <a +href="glossaries-user.html#dx1-227032" >2539</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\index</span></span></span>  <a -href="glossaries-user.html#dx1-87008" >2503</a>, <a -href="glossaries-user.html#dx1-132043" >2504</a>, <a -href="glossaries-user.html#dx1-132044" >2505</a>, <a -href="glossaries-user.html#dx1-132045" >2506</a> <br /></span> +href="glossaries-user.html#dx1-88008" >2540</a>, <a +href="glossaries-user.html#dx1-129041" >2541</a>, <a +href="glossaries-user.html#dx1-129042" >2542</a>, <a +href="glossaries-user.html#dx1-129043" >2543</a> <br /></span> <span class="index-item"><span class="cmss-10">index </span>package  <a -href="glossaries-user.html#dx1-87010" >2507</a> <br /></span> +href="glossaries-user.html#dx1-88010" >2544</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\indexname</span></span></span>  <a -href="glossaries-user.html#dx1-146027" >2508</a> <br /></span> +href="glossaries-user.html#dx1-145027" >2545</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\indexspace</span></span></span>  <a -href="glossaries-user.html#dx1-157015" >2509</a>, <a -href="glossaries-user.html#dx1-163018" >2510</a>, <a -href="glossaries-user.html#dx1-166036" >2511</a>, <a -href="glossaries-user.html#dx1-166094" >2512</a> <br /></span> +href="glossaries-user.html#dx1-156015" >2546</a>, <a +href="glossaries-user.html#dx1-162018" >2547</a>, <a +href="glossaries-user.html#dx1-165037" >2548</a>, <a +href="glossaries-user.html#dx1-165095" >2549</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\input</span></span></span>  <a -href="glossaries-user.html#dx1-12002" >2513</a>, <a -href="glossaries-user.html#dx1-122007" >2514</a> <br /></span> +href="glossaries-user.html#dx1-12002" >2550</a>, <a +href="glossaries-user.html#dx1-123007" >2551</a> <br /></span> <span class="index-item"><span class="cmss-10">inputenc </span>package  <a -href="glossaries-user.html#dx1-13015" >2515</a>, <a -href="glossaries-user.html#dx1-112086" >2516</a>, <a -href="glossaries-user.html#dx1-112154" >2517</a>, <a -href="glossaries-user.html#dx1-143008" >2518</a>, <a -href="glossaries-user.html#dx1-145005" >2519</a>, <a -href="glossaries-user.html#dx1-211001" >2520</a>, <a -href="glossaries-user.html#dx1-217001" >2521</a> <br /></span> +href="glossaries-user.html#dx1-13015" >2552</a>, <a +href="glossaries-user.html#dx1-113099" >2553</a>, <a +href="glossaries-user.html#dx1-113174" >2554</a>, <a +href="glossaries-user.html#dx1-167008" >2555</a>, <a +href="glossaries-user.html#dx1-169005" >2556</a>, <a +href="glossaries-user.html#dx1-214001" >2557</a>, <a +href="glossaries-user.html#dx1-220001" >2558</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\inputencodingname</span></span></span>  <a -href="glossaries-user.html#dx1-143009" >2522</a> <br /></span> +href="glossaries-user.html#dx1-167009" >2559</a> <br /></span> <span class="index-item">internal fields:<br /></span> +<span class="index-subitem">    <span +class="cmtt-10">childcount</span>  <a +href="glossaries-user.html#dx1-172015" >2560</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">location</span>  <a -href="glossaries-user.html#dx1-5009" >2523</a>, <a -href="glossaries-user.html#dx1-220031" >2524</a>, <a -href="glossaries-user.html#dx1-220042" >2525</a> <br /></span> +href="glossaries-user.html#dx1-5009" >2561</a>, <a +href="glossaries-user.html#dx1-223031" >2562</a>, <a +href="glossaries-user.html#dx1-223042" >2563</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">loclist</span>  <a -href="glossaries-user.html#dx1-220034" >2526</a> <br /></span> +href="glossaries-user.html#dx1-223034" >2564</a> <br /></span> + + <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">siblingcount</span>  <a -href="glossaries-user.html#dx1-200045" >2527</a>, <a -href="glossaries-user.html#dx1-200047" >2528</a> <br /></span> +href="glossaries-user.html#dx1-203045" >2565</a>, <a +href="glossaries-user.html#dx1-203047" >2566</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">useri</span>  <a -href="glossaries-user.html#dx1-189035" >2529</a> <br /></span> +href="glossaries-user.html#dx1-192035" >2567</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\item</span></span></span>  <a -href="glossaries-user.html#dx1-157013" >2530</a>, <a -href="glossaries-user.html#dx1-157022" >2531</a> <br /></span> +href="glossaries-user.html#dx1-156013" >2568</a>, <a +href="glossaries-user.html#dx1-156022" >2569</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">J</span> - - <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\jobname</span></span></span>  <a -href="glossaries-user.html#dx1-111011" >2532</a>, <a -href="glossaries-user.html#dx1-111013" >2533</a> <br /></span> +href="glossaries-user.html#dx1-112011" >2570</a>, <a +href="glossaries-user.html#dx1-112013" >2571</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">L</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\label</span></span></span>  <a -href="glossaries-user.html#dx1-43005" >2534</a> <br /></span> +href="glossaries-user.html#dx1-44005" >2572</a> <br /></span> <span class="index-item"><span class="cmtt-10">latex</span>  <a -href="glossaries-user.html#dx1-28" >2535</a>, <a -href="glossaries-user.html#dx1-132020" >2536</a> <br /></span> +href="glossaries-user.html#dx1-27" >2573</a>, <a +href="glossaries-user.html#dx1-129018" >2574</a> <br /></span> <span class="index-item"><span class="cmtt-10">latexmk</span>  <a -href="glossaries-user.html#dx1-16019" >2537</a>, <a -href="glossaries-user.html#dx1-16022" >2538</a>, <a -href="glossaries-user.html#dx1-16028" >2539</a> <br /></span> +href="glossaries-user.html#dx1-16019" >2575</a>, <a +href="glossaries-user.html#dx1-16022" >2576</a>, <a +href="glossaries-user.html#dx1-16028" >2577</a> <br /></span> <span class="index-item">Latin alphabet  <a href="glossaries-user.html#dx1-3038" ><span -class="cmbx-10">2540</span></a>, <a -href="glossaries-user.html#dx1-7006" >2541</a>, <a -href="glossaries-user.html#dx1-13006" >2542</a> <br /></span> +class="cmbx-10">2578</span></a>, <a +href="glossaries-user.html#dx1-7006" >2579</a>, <a +href="glossaries-user.html#dx1-13006" >2580</a> <br /></span> <span class="index-item">Latin character  <a -href="glossaries-user.html#dx1-3015" >2543</a>, <a -href="glossaries-user.html#dx1-3018" >2544</a>, <a -href="glossaries-user.html#dx1-3019" >2545</a>, <a -href="glossaries-user.html#dx1-3039" >2546</a>, <a +href="glossaries-user.html#dx1-3015" >2581</a>, <a +href="glossaries-user.html#dx1-3018" >2582</a>, <a +href="glossaries-user.html#dx1-3019" >2583</a>, <a +href="glossaries-user.html#dx1-3039" >2584</a>, <a href="glossaries-user.html#dx1-3040" ><span -class="cmbx-10">2547</span></a>, <a -href="glossaries-user.html#dx1-3058" >2548</a>, <a -href="glossaries-user.html#dx1-146006" >2549</a> <br /></span> +class="cmbx-10">2585</span></a>, <a +href="glossaries-user.html#dx1-3058" >2586</a>, <a +href="glossaries-user.html#dx1-145006" >2587</a> <br /></span> <span class="index-item">link text  <a href="glossaries-user.html#dx1-3042" ><span -class="cmbx-10">2550</span></a>, <a -href="glossaries-user.html#dx1-11035" >2551</a>, <a -href="glossaries-user.html#dx1-11067" >2552</a>, <a -href="glossaries-user.html#dx1-132003" >2553</a>, <a -href="glossaries-user.html#dx1-132015" >2554</a>, <a -href="glossaries-user.html#dx1-132017" >2555</a>, <a -href="glossaries-user.html#dx1-132023" >2556</a>, <a -href="glossaries-user.html#dx1-132024" >2557</a>, <a -href="glossaries-user.html#dx1-132026" >2558</a>, <a -href="glossaries-user.html#dx1-132083" >2559</a>, <a -href="glossaries-user.html#dx1-132085" >2560</a>, <a -href="glossaries-user.html#dx1-132091" >2561</a>, <a -href="glossaries-user.html#dx1-132092" >2562</a>, <a -href="glossaries-user.html#dx1-133012" >2563</a>, <a -href="glossaries-user.html#dx1-133018" >2564</a>, <a -href="glossaries-user.html#dx1-133024" >2565</a>, <a -href="glossaries-user.html#dx1-133025" >2566</a>, <a -href="glossaries-user.html#dx1-133027" >2567</a>, <a -href="glossaries-user.html#dx1-133028" >2568</a>, <a -href="glossaries-user.html#dx1-133032" >2569</a>, <a -href="glossaries-user.html#dx1-133033" >2570</a>, <a -href="glossaries-user.html#dx1-133035" >2571</a>, <a -href="glossaries-user.html#dx1-133036" >2572</a>, <a -href="glossaries-user.html#dx1-133037" >2573</a>, <a -href="glossaries-user.html#dx1-133038" >2574</a>, <a -href="glossaries-user.html#dx1-133039" >2575</a>, <a -href="glossaries-user.html#dx1-133040" >2576</a>, <a -href="glossaries-user.html#dx1-133044" >2577</a>, <a -href="glossaries-user.html#dx1-133045" >2578</a>, <a -href="glossaries-user.html#dx1-134005" >2579</a>, <a -href="glossaries-user.html#dx1-134006" >2580</a>, <a -href="glossaries-user.html#dx1-134009" >2581</a>, <a -href="glossaries-user.html#dx1-134015" >2582</a>, <a -href="glossaries-user.html#dx1-134022" >2583</a>, <a -href="glossaries-user.html#dx1-134027" >2584</a>, <a -href="glossaries-user.html#dx1-134030" >2585</a>, <a -href="glossaries-user.html#dx1-134035" >2586</a>, <a -href="glossaries-user.html#dx1-134040" >2587</a>, <a -href="glossaries-user.html#dx1-134047" >2588</a>, <a -href="glossaries-user.html#dx1-134052" >2589</a>, <a -href="glossaries-user.html#dx1-134057" >2590</a>, <a -href="glossaries-user.html#dx1-134062" >2591</a>, <a -href="glossaries-user.html#dx1-134067" >2592</a>, <a -href="glossaries-user.html#dx1-134072" >2593</a>, <a -href="glossaries-user.html#dx1-134077" >2594</a>, <a -href="glossaries-user.html#dx1-134082" >2595</a>, <a -href="glossaries-user.html#dx1-135001" >2596</a>, <a -href="glossaries-user.html#dx1-135081" >2597</a>, <a -href="glossaries-user.html#dx1-147050" >2598</a>, <a -href="glossaries-user.html#dx1-147053" >2599</a>, <a -href="glossaries-user.html#dx1-147065" >2600</a>, <a -href="glossaries-user.html#dx1-147075" >2601</a>, <a -href="glossaries-user.html#dx1-171020" >2602</a>, <a -href="glossaries-user.html#dx1-172055" >2603</a>, <a -href="glossaries-user.html#dx1-183002" >2604</a>, <a -href="glossaries-user.html#dx1-183003" >2605</a>, <a -href="glossaries-user.html#dx1-183020" >2606</a>, <a -href="glossaries-user.html#dx1-189007" >2607</a>, <a -href="glossaries-user.html#dx1-189023" >2608</a>, <a -href="glossaries-user.html#dx1-189027" >2609</a>, <a -href="glossaries-user.html#dx1-189031" >2610</a>, <a -href="glossaries-user.html#dx1-189033" >2611</a>, <a -href="glossaries-user.html#dx1-189038" >2612</a>, <a -href="glossaries-user.html#dx1-189041" >2613</a>, <a -href="glossaries-user.html#dx1-189058" >2614</a>, <a -href="glossaries-user.html#dx1-192019" >2615</a>, <a -href="glossaries-user.html#dx1-222006" >2616</a> <br /></span> +class="cmbx-10">2588</span></a>, <a +href="glossaries-user.html#dx1-11035" >2589</a>, <a +href="glossaries-user.html#dx1-11067" >2590</a>, <a +href="glossaries-user.html#dx1-129001" >2591</a>, <a +href="glossaries-user.html#dx1-129013" >2592</a>, <a +href="glossaries-user.html#dx1-129015" >2593</a>, <a +href="glossaries-user.html#dx1-129021" >2594</a>, <a +href="glossaries-user.html#dx1-129022" >2595</a>, <a +href="glossaries-user.html#dx1-129024" >2596</a>, <a +href="glossaries-user.html#dx1-129081" >2597</a>, <a +href="glossaries-user.html#dx1-129083" >2598</a>, <a +href="glossaries-user.html#dx1-129089" >2599</a>, <a +href="glossaries-user.html#dx1-129090" >2600</a>, <a +href="glossaries-user.html#dx1-130012" >2601</a>, <a +href="glossaries-user.html#dx1-130018" >2602</a>, <a +href="glossaries-user.html#dx1-130024" >2603</a>, <a +href="glossaries-user.html#dx1-130025" >2604</a>, <a +href="glossaries-user.html#dx1-130027" >2605</a>, <a +href="glossaries-user.html#dx1-130028" >2606</a>, <a +href="glossaries-user.html#dx1-130032" >2607</a>, <a +href="glossaries-user.html#dx1-130033" >2608</a>, <a +href="glossaries-user.html#dx1-130035" >2609</a>, <a +href="glossaries-user.html#dx1-130036" >2610</a>, <a +href="glossaries-user.html#dx1-130037" >2611</a>, <a +href="glossaries-user.html#dx1-130038" >2612</a>, <a +href="glossaries-user.html#dx1-130039" >2613</a>, <a +href="glossaries-user.html#dx1-130040" >2614</a>, <a +href="glossaries-user.html#dx1-130044" >2615</a>, <a +href="glossaries-user.html#dx1-130045" >2616</a>, <a +href="glossaries-user.html#dx1-131005" >2617</a>, <a +href="glossaries-user.html#dx1-131006" >2618</a>, <a +href="glossaries-user.html#dx1-131009" >2619</a>, <a +href="glossaries-user.html#dx1-131015" >2620</a>, <a +href="glossaries-user.html#dx1-131022" >2621</a>, <a +href="glossaries-user.html#dx1-131027" >2622</a>, <a +href="glossaries-user.html#dx1-131030" >2623</a>, <a +href="glossaries-user.html#dx1-131035" >2624</a>, <a +href="glossaries-user.html#dx1-131040" >2625</a>, <a +href="glossaries-user.html#dx1-131047" >2626</a>, <a +href="glossaries-user.html#dx1-131052" >2627</a>, <a +href="glossaries-user.html#dx1-131057" >2628</a>, <a +href="glossaries-user.html#dx1-131062" >2629</a>, <a +href="glossaries-user.html#dx1-131067" >2630</a>, <a +href="glossaries-user.html#dx1-131072" >2631</a>, <a +href="glossaries-user.html#dx1-131077" >2632</a>, <a +href="glossaries-user.html#dx1-131082" >2633</a>, <a +href="glossaries-user.html#dx1-132001" >2634</a>, <a +href="glossaries-user.html#dx1-132081" >2635</a>, <a +href="glossaries-user.html#dx1-136003" >2636</a>, <a +href="glossaries-user.html#dx1-136006" >2637</a>, <a +href="glossaries-user.html#dx1-136018" >2638</a>, <a +href="glossaries-user.html#dx1-136028" >2639</a>, <a +href="glossaries-user.html#dx1-174020" >2640</a>, <a +href="glossaries-user.html#dx1-175055" >2641</a>, <a +href="glossaries-user.html#dx1-186002" >2642</a>, <a +href="glossaries-user.html#dx1-186003" >2643</a>, <a +href="glossaries-user.html#dx1-186020" >2644</a>, <a +href="glossaries-user.html#dx1-192007" >2645</a>, <a +href="glossaries-user.html#dx1-192023" >2646</a>, <a +href="glossaries-user.html#dx1-192027" >2647</a>, <a +href="glossaries-user.html#dx1-192031" >2648</a>, <a +href="glossaries-user.html#dx1-192033" >2649</a>, <a +href="glossaries-user.html#dx1-192038" >2650</a>, <a +href="glossaries-user.html#dx1-192041" >2651</a>, <a +href="glossaries-user.html#dx1-192058" >2652</a>, <a +href="glossaries-user.html#dx1-195019" >2653</a>, <a +href="glossaries-user.html#dx1-225006" >2654</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\listbreak</span></span></span>  <a -href="glossaries-user.html#dx1-200049" >2617</a> <br /></span> +href="glossaries-user.html#dx1-203049" >2655</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\loadglsentries</span></span></span>  <a -href="glossaries-user.html#dx1-6003" >2618</a>, <a -href="glossaries-user.html#dx1-7003" >2619</a>, <a -href="glossaries-user.html#dx1-8003" >2620</a>, <a -href="glossaries-user.html#dx1-10003" >2621</a>, <a -href="glossaries-user.html#dx1-11004" >2622</a>, <a -href="glossaries-user.html#dx1-11019" >2623</a>, <a -href="glossaries-user.html#dx1-12003" >2624</a>, <a -href="glossaries-user.html#dx1-122001" ><span -class="cmti-10">2625</span></a>, <a -href="glossaries-user.html#dx1-147039" >2626</a> <br /></span> +href="glossaries-user.html#dx1-6003" >2656</a>, <a +href="glossaries-user.html#dx1-7003" >2657</a>, <a +href="glossaries-user.html#dx1-8003" >2658</a>, <a +href="glossaries-user.html#dx1-10003" >2659</a>, <a +href="glossaries-user.html#dx1-11004" >2660</a>, <a +href="glossaries-user.html#dx1-11019" >2661</a>, <a +href="glossaries-user.html#dx1-12003" >2662</a>, <a +href="glossaries-user.html#dx1-123001" ><span +class="cmti-10">2663</span></a>, <a +href="glossaries-user.html#dx1-135040" >2664</a> <br /></span> <span class="index-item">location list  <span class="cmti-10">see </span><a -href="glossaries-user.html#dx1-127004" >number list</a> <br /></span> +href="glossaries-user.html#dx1-149004" >number list</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\longnewglossaryentry</span></span></span>  <a -href="glossaries-user.html#dx1-112004" ><span -class="cmti-10">2628</span></a>, <a -href="glossaries-user.html#dx1-116003" >2629</a>, <a -href="glossaries-user.html#dx1-122003" >2630</a>, <a -href="glossaries-user.html#dx1-156041" >2631</a> <br /></span> +href="glossaries-user.html#dx1-113009" ><span +class="cmti-10">2666</span></a>, <a +href="glossaries-user.html#dx1-117003" >2667</a>, <a +href="glossaries-user.html#dx1-123003" >2668</a>, <a +href="glossaries-user.html#dx1-155042" >2669</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\longprovideglossaryentry</span></span></span>  <a -href="glossaries-user.html#dx1-112006" ><span -class="cmti-10">2632</span></a> <br /></span> +href="glossaries-user.html#dx1-113011" ><span +class="cmti-10">2670</span></a> <br /></span> <span class="index-item"><span class="cmss-10">longtable </span>package  <a -href="glossaries-user.html#dx1-50002" >2633</a>, <a -href="glossaries-user.html#dx1-158010" >2634</a> <br /></span> +href="glossaries-user.html#dx1-51002" >2671</a>, <a +href="glossaries-user.html#dx1-157010" >2672</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">M</span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\makeatletter</span></span></span>  <a -href="glossaries-user.html#dx1-150086" >2635</a> <br /></span> +href="glossaries-user.html#dx1-139086" >2673</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\makeatother</span></span></span>  <a -href="glossaries-user.html#dx1-150087" >2636</a> <br /></span> +href="glossaries-user.html#dx1-139087" >2674</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\makefirstuc</span></span></span>  <a -href="glossaries-user.html#dx1-133023" >2637</a>, <a -href="glossaries-user.html#dx1-135067" >2638</a>, <a -href="glossaries-user.html#dx1-184064" >2639</a>, <a -href="glossaries-user.html#dx1-42009" >2640</a> <br /></span> +href="glossaries-user.html#dx1-130023" >2675</a>, <a +href="glossaries-user.html#dx1-132067" >2676</a>, <a +href="glossaries-user.html#dx1-187064" >2677</a>, <a +href="glossaries-user.html#dx1-43009" >2678</a> <br /></span> <span class="index-item"><span class="cmtt-10">makeglossaries</span>  <a href="glossaries-user.html#dx1-3044" ><span -class="cmbx-10">2641</span></a>, <a -href="glossaries-user.html#dx1-3048" >2642</a>, <a -href="glossaries-user.html#dx1-3052" >2643</a>, <a -href="glossaries-user.html#dx1-7036" >2644</a>, <a -href="glossaries-user.html#dx1-7037" >2645</a>, <a -href="glossaries-user.html#dx1-7045" >2646</a>, <a -href="glossaries-user.html#dx1-8037" >2647</a>, <a -href="glossaries-user.html#dx1-8044" >2648</a>, <a -href="glossaries-user.html#dx1-8045" >2649</a>, <a -href="glossaries-user.html#dx1-8048" >2650</a>, <a -href="glossaries-user.html#dx1-8050" >2651</a>, <a -href="glossaries-user.html#dx1-13023" >2652</a>, <a -href="glossaries-user.html#dx1-13026" >2653</a>, <a -href="glossaries-user.html#dx1-13039" >2654</a>, <a -href="glossaries-user.html#dx1-16004" >2655</a>, <a -href="glossaries-user.html#dx1-16023" >2656</a>, <a -href="glossaries-user.html#dx1-16029" >2657</a>, <a -href="glossaries-user.html#dx1-16031" >2658</a>, <a -href="glossaries-user.html#dx1-16034" >2659</a>, <a -href="glossaries-user.html#dx1-16037" >2660</a>, <a -href="glossaries-user.html#dx1-16043" >2661</a>, <a -href="glossaries-user.html#dx1-16046" >2662</a>, <a -href="glossaries-user.html#dx1-16051" >2663</a>, <a -href="glossaries-user.html#dx1-16053" >2664</a>, <a -href="glossaries-user.html#dx1-16056" >2665</a>, <a -href="glossaries-user.html#dx1-16058" >2666</a>, <a -href="glossaries-user.html#dx1-16062" >2667</a>, <a -href="glossaries-user.html#dx1-16065" >2668</a>, <a -href="glossaries-user.html#dx1-16070" >2669</a>, <a -href="glossaries-user.html#dx1-16076" >2670</a>, <a -href="glossaries-user.html#dx1-16078" >2671</a>, <a -href="glossaries-user.html#dx1-17001" >2672</a>, <a -href="glossaries-user.html#dx1-17005" >2673</a>, <a -href="glossaries-user.html#dx1-17006" >2674</a>, <a -href="glossaries-user.html#dx1-17007" >2675</a>, <a -href="glossaries-user.html#dx1-17009" >2676</a>, <a -href="glossaries-user.html#dx1-17012" >2677</a>, <a -href="glossaries-user.html#dx1-17013" >2678</a>, <a -href="glossaries-user.html#dx1-17016" >2679</a>, <a -href="glossaries-user.html#dx1-17020" >2680</a>, <a -href="glossaries-user.html#dx1-17027" >2681</a>, <a -href="glossaries-user.html#dx1-17031" >2682</a>, <a -href="glossaries-user.html#dx1-17034" >2683</a>, <a -href="glossaries-user.html#dx1-18001" >2684</a>, <a -href="glossaries-user.html#dx1-18003" >2685</a>, <a -href="glossaries-user.html#dx1-18007" >2686</a>, <a -href="glossaries-user.html#dx1-18008" >2687</a>, <a -href="glossaries-user.html#dx1-19005" >2688</a>, <a -href="glossaries-user.html#dx1-19021" >2689</a>, <a -href="glossaries-user.html#dx1-19023" >2690</a>, <a -href="glossaries-user.html#dx1-19025" >2691</a>, <a -href="glossaries-user.html#dx1-20018" >2692</a>, <a -href="glossaries-user.html#dx1-20020" >2693</a>, <a -href="glossaries-user.html#dx1-20022" >2694</a>, <a -href="glossaries-user.html#dx1-22011" >2695</a>, <a -href="glossaries-user.html#dx1-22016" >2696</a>, <a -href="glossaries-user.html#dx1-46006" >2697</a>, <a -href="glossaries-user.html#dx1-74004" >2698</a>, <a -href="glossaries-user.html#dx1-75002" >2699</a>, <a -href="glossaries-user.html#dx1-75004" >2700</a>, <a -href="glossaries-user.html#dx1-76002" >2701</a>, <a -href="glossaries-user.html#dx1-76004" >2702</a>, <a -href="glossaries-user.html#dx1-79020" >2703</a>, <a -href="glossaries-user.html#dx1-84008" >2704</a>, <a -href="glossaries-user.html#dx1-128016" >2705</a>, <a -href="glossaries-user.html#dx1-138006" >2706</a>, <a -href="glossaries-user.html#dx1-140062" >2707</a>, <a -href="glossaries-user.html#dx1-141005" >2708</a>, <a -href="glossaries-user.html#dx1-143003" >2709</a>, <a -href="glossaries-user.html#dx1-143005" >2710</a>, <a -href="glossaries-user.html#dx1-143013" >2711</a>, <a -href="glossaries-user.html#dx1-143015" >2712</a>, <a -href="glossaries-user.html#dx1-146005" >2713</a>, <a -href="glossaries-user.html#dx1-175005" >2714</a>, <a -href="glossaries-user.html#dx1-175013" >2715</a>, <a -href="glossaries-user.html#dx1-175017" >2716</a>, <a -href="glossaries-user.html#dx1-175039" >2717</a>, <a -href="glossaries-user.html#dx1-176009" >2718</a>, <a -href="glossaries-user.html#dx1-176027" >2719</a>, <a -href="glossaries-user.html#dx1-178002" >2720</a>, <a -href="glossaries-user.html#dx1-179010" >2721</a>, <a -href="glossaries-user.html#dx1-190005" >2722</a>, <a -href="glossaries-user.html#dx1-190014" >2723</a>, <a -href="glossaries-user.html#dx1-190033" >2724</a>, <a -href="glossaries-user.html#dx1-192002" >2725</a>, <a -href="glossaries-user.html#dx1-192013" >2726</a>, <a -href="glossaries-user.html#dx1-195001" >2727</a>, <a -href="glossaries-user.html#dx1-198003" >2728</a>, <a -href="glossaries-user.html#dx1-198014" >2729</a>, <a -href="glossaries-user.html#dx1-198015" >2730</a>, <a -href="glossaries-user.html#dx1-200003" >2731</a>, <a -href="glossaries-user.html#dx1-202060" >2732</a>, <a -href="glossaries-user.html#dx1-211003" >2733</a>, <a -href="glossaries-user.html#dx1-211006" >2734</a>, <a -href="glossaries-user.html#dx1-211008" >2735</a>, <a -href="glossaries-user.html#dx1-211010" >2736</a>, <a -href="glossaries-user.html#dx1-211013" >2737</a>, <a -href="glossaries-user.html#dx1-224043" >2738</a>, <a -href="glossaries-user.html#dx1-226003" >2739</a>, <a -href="glossaries-user.html#dx1-16045" >2740</a> <br /></span> +class="cmbx-10">2679</span></a>, <a +href="glossaries-user.html#dx1-3048" >2680</a>, <a +href="glossaries-user.html#dx1-3052" >2681</a>, <a +href="glossaries-user.html#dx1-7036" >2682</a>, <a +href="glossaries-user.html#dx1-7037" >2683</a>, <a +href="glossaries-user.html#dx1-7045" >2684</a>, <a +href="glossaries-user.html#dx1-8037" >2685</a>, <a +href="glossaries-user.html#dx1-8044" >2686</a>, <a +href="glossaries-user.html#dx1-8045" >2687</a>, <a +href="glossaries-user.html#dx1-8048" >2688</a>, <a +href="glossaries-user.html#dx1-8050" >2689</a>, <a +href="glossaries-user.html#dx1-13023" >2690</a>, <a +href="glossaries-user.html#dx1-13026" >2691</a>, <a +href="glossaries-user.html#dx1-13039" >2692</a>, <a +href="glossaries-user.html#dx1-16004" >2693</a>, <a +href="glossaries-user.html#dx1-16023" >2694</a>, <a +href="glossaries-user.html#dx1-16029" >2695</a>, <a +href="glossaries-user.html#dx1-16031" >2696</a>, <a +href="glossaries-user.html#dx1-16034" >2697</a>, <a +href="glossaries-user.html#dx1-16037" >2698</a>, <a +href="glossaries-user.html#dx1-16043" >2699</a>, <a +href="glossaries-user.html#dx1-16046" >2700</a>, <a +href="glossaries-user.html#dx1-16051" >2701</a>, <a +href="glossaries-user.html#dx1-16053" >2702</a>, <a +href="glossaries-user.html#dx1-16056" >2703</a>, <a +href="glossaries-user.html#dx1-16058" >2704</a>, <a +href="glossaries-user.html#dx1-16062" >2705</a>, <a +href="glossaries-user.html#dx1-16065" >2706</a>, <a +href="glossaries-user.html#dx1-16070" >2707</a>, <a +href="glossaries-user.html#dx1-16076" >2708</a>, <a +href="glossaries-user.html#dx1-16078" >2709</a>, <a +href="glossaries-user.html#dx1-17001" >2710</a>, <a +href="glossaries-user.html#dx1-17005" >2711</a>, <a +href="glossaries-user.html#dx1-17006" >2712</a>, <a +href="glossaries-user.html#dx1-17007" >2713</a>, <a +href="glossaries-user.html#dx1-17009" >2714</a>, <a +href="glossaries-user.html#dx1-17012" >2715</a>, <a +href="glossaries-user.html#dx1-17013" >2716</a>, <a +href="glossaries-user.html#dx1-17016" >2717</a>, <a +href="glossaries-user.html#dx1-17020" >2718</a>, <a +href="glossaries-user.html#dx1-17027" >2719</a>, <a +href="glossaries-user.html#dx1-17031" >2720</a>, <a +href="glossaries-user.html#dx1-17034" >2721</a>, <a +href="glossaries-user.html#dx1-18001" >2722</a>, <a +href="glossaries-user.html#dx1-18003" >2723</a>, <a +href="glossaries-user.html#dx1-18007" >2724</a>, <a +href="glossaries-user.html#dx1-18008" >2725</a>, <a +href="glossaries-user.html#dx1-19005" >2726</a>, <a +href="glossaries-user.html#dx1-19021" >2727</a>, <a +href="glossaries-user.html#dx1-19023" >2728</a>, <a +href="glossaries-user.html#dx1-19025" >2729</a>, <a +href="glossaries-user.html#dx1-20018" >2730</a>, <a +href="glossaries-user.html#dx1-20020" >2731</a>, <a +href="glossaries-user.html#dx1-20022" >2732</a>, <a +href="glossaries-user.html#dx1-22011" >2733</a>, <a +href="glossaries-user.html#dx1-22016" >2734</a>, <a +href="glossaries-user.html#dx1-47006" >2735</a>, <a +href="glossaries-user.html#dx1-75004" >2736</a>, <a +href="glossaries-user.html#dx1-76002" >2737</a>, <a +href="glossaries-user.html#dx1-76004" >2738</a>, <a +href="glossaries-user.html#dx1-77002" >2739</a>, <a +href="glossaries-user.html#dx1-77004" >2740</a>, <a +href="glossaries-user.html#dx1-80020" >2741</a>, <a +href="glossaries-user.html#dx1-85008" >2742</a>, <a +href="glossaries-user.html#dx1-134062" >2743</a>, <a +href="glossaries-user.html#dx1-144006" >2744</a>, <a +href="glossaries-user.html#dx1-145005" >2745</a>, <a +href="glossaries-user.html#dx1-147006" >2746</a>, <a +href="glossaries-user.html#dx1-150015" >2747</a>, <a +href="glossaries-user.html#dx1-167003" >2748</a>, <a +href="glossaries-user.html#dx1-167005" >2749</a>, <a +href="glossaries-user.html#dx1-167013" >2750</a>, <a +href="glossaries-user.html#dx1-167015" >2751</a>, <a +href="glossaries-user.html#dx1-178005" >2752</a>, <a +href="glossaries-user.html#dx1-178013" >2753</a>, <a +href="glossaries-user.html#dx1-178017" >2754</a>, <a +href="glossaries-user.html#dx1-178039" >2755</a>, <a +href="glossaries-user.html#dx1-179009" >2756</a>, <a +href="glossaries-user.html#dx1-179027" >2757</a>, <a +href="glossaries-user.html#dx1-181002" >2758</a>, <a +href="glossaries-user.html#dx1-182010" >2759</a>, <a +href="glossaries-user.html#dx1-193005" >2760</a>, <a +href="glossaries-user.html#dx1-193014" >2761</a>, <a +href="glossaries-user.html#dx1-193033" >2762</a>, <a +href="glossaries-user.html#dx1-195002" >2763</a>, <a +href="glossaries-user.html#dx1-195013" >2764</a>, <a +href="glossaries-user.html#dx1-198001" >2765</a>, <a +href="glossaries-user.html#dx1-201003" >2766</a>, <a +href="glossaries-user.html#dx1-201014" >2767</a>, <a +href="glossaries-user.html#dx1-201015" >2768</a>, <a +href="glossaries-user.html#dx1-203003" >2769</a>, <a +href="glossaries-user.html#dx1-205060" >2770</a>, <a +href="glossaries-user.html#dx1-214003" >2771</a>, <a +href="glossaries-user.html#dx1-214006" >2772</a>, <a +href="glossaries-user.html#dx1-214008" >2773</a>, <a +href="glossaries-user.html#dx1-214010" >2774</a>, <a +href="glossaries-user.html#dx1-214013" >2775</a>, <a +href="glossaries-user.html#dx1-227043" >2776</a>, <a +href="glossaries-user.html#dx1-229003" >2777</a>, <a +href="glossaries-user.html#dx1-16045" >2778</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-d</span>  <a -href="glossaries-user.html#dx1-18004" >2741</a> <br /></span> +href="glossaries-user.html#dx1-18004" >2779</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-k</span>  <a -href="glossaries-user.html#dx1-17015" >2742</a> <br /></span> +href="glossaries-user.html#dx1-17015" >2780</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-m</span>  <a -href="glossaries-user.html#dx1-17023" >2743</a> <br /></span> +href="glossaries-user.html#dx1-17023" >2781</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-Q</span>  <a -href="glossaries-user.html#dx1-17014" >2744</a> <br /></span> +href="glossaries-user.html#dx1-17014" >2782</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-q</span>  <a -href="glossaries-user.html#dx1-17017" >2745</a> <br /></span> +href="glossaries-user.html#dx1-17017" >2783</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-x</span>  <a -href="glossaries-user.html#dx1-17025" >2746</a> <br /></span> +href="glossaries-user.html#dx1-17025" >2784</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\makeglossaries</span></span></span>  <a -href="glossaries-user.html#dx1-7001" >2747</a>, <a -href="glossaries-user.html#dx1-7004" >2748</a>, <a -href="glossaries-user.html#dx1-8001" >2749</a>, <a -href="glossaries-user.html#dx1-8004" >2750</a>, <a -href="glossaries-user.html#dx1-13036" >2751</a>, <a -href="glossaries-user.html#dx1-16026" >2752</a>, <a -href="glossaries-user.html#dx1-27001" >2753</a>, <a -href="glossaries-user.html#dx1-30016" >2754</a>, <a -href="glossaries-user.html#dx1-30017" >2755</a>, <a -href="glossaries-user.html#dx1-62003" >2756</a>, <a -href="glossaries-user.html#dx1-79008" >2757</a>, <a -href="glossaries-user.html#dx1-80001" >2758</a>, <a -href="glossaries-user.html#dx1-80003" >2759</a>, <a -href="glossaries-user.html#dx1-80006" >2760</a>, <a -href="glossaries-user.html#dx1-81002" >2761</a>, <a -href="glossaries-user.html#dx1-111001" ><span -class="cmti-10">2762</span></a>, <a -href="glossaries-user.html#dx1-112121" >2763</a>, <a -href="glossaries-user.html#dx1-130005" >2764</a>, <a -href="glossaries-user.html#dx1-130014" >2765</a>, <a -href="glossaries-user.html#dx1-132007" >2766</a>, <a -href="glossaries-user.html#dx1-138001" >2767</a>, <a -href="glossaries-user.html#dx1-141003" >2768</a>, <a -href="glossaries-user.html#dx1-141017" >2769</a>, <a -href="glossaries-user.html#dx1-144008" >2770</a>, <a -href="glossaries-user.html#dx1-144025" >2771</a>, <a -href="glossaries-user.html#dx1-144026" >2772</a>, <a -href="glossaries-user.html#dx1-144030" >2773</a>, <a -href="glossaries-user.html#dx1-144031" >2774</a>, <a -href="glossaries-user.html#dx1-144063" >2775</a>, <a -href="glossaries-user.html#dx1-144064" >2776</a>, <a -href="glossaries-user.html#dx1-144069" >2777</a>, <a -href="glossaries-user.html#dx1-144070" >2778</a>, <a -href="glossaries-user.html#dx1-145009" >2779</a>, <a -href="glossaries-user.html#dx1-145010" >2780</a>, <a -href="glossaries-user.html#dx1-146024" >2781</a>, <a -href="glossaries-user.html#dx1-190028" >2782</a>, <a -href="glossaries-user.html#dx1-198008" >2783</a> <br /></span> +href="glossaries-user.html#dx1-7001" >2785</a>, <a +href="glossaries-user.html#dx1-7004" >2786</a>, <a +href="glossaries-user.html#dx1-8001" >2787</a>, <a +href="glossaries-user.html#dx1-8004" >2788</a>, <a +href="glossaries-user.html#dx1-13036" >2789</a>, <a +href="glossaries-user.html#dx1-16026" >2790</a>, <a +href="glossaries-user.html#dx1-27001" >2791</a>, <a +href="glossaries-user.html#dx1-30016" >2792</a>, <a +href="glossaries-user.html#dx1-30017" >2793</a>, <a +href="glossaries-user.html#dx1-63004" >2794</a>, <a +href="glossaries-user.html#dx1-80008" >2795</a>, <a +href="glossaries-user.html#dx1-81001" >2796</a>, <a +href="glossaries-user.html#dx1-81003" >2797</a>, <a +href="glossaries-user.html#dx1-81006" >2798</a>, <a +href="glossaries-user.html#dx1-82002" >2799</a>, <a +href="glossaries-user.html#dx1-112001" ><span +class="cmti-10">2800</span></a>, <a +href="glossaries-user.html#dx1-113137" >2801</a>, <a +href="glossaries-user.html#dx1-129005" >2802</a>, <a +href="glossaries-user.html#dx1-144003" >2803</a>, <a +href="glossaries-user.html#dx1-144020" >2804</a>, <a +href="glossaries-user.html#dx1-145024" >2805</a>, <a +href="glossaries-user.html#dx1-147001" >2806</a>, <a +href="glossaries-user.html#dx1-152005" >2807</a>, <a +href="glossaries-user.html#dx1-152014" >2808</a>, <a +href="glossaries-user.html#dx1-168008" >2809</a>, <a +href="glossaries-user.html#dx1-168025" >2810</a>, <a +href="glossaries-user.html#dx1-168026" >2811</a>, <a +href="glossaries-user.html#dx1-168030" >2812</a>, <a +href="glossaries-user.html#dx1-168031" >2813</a>, <a +href="glossaries-user.html#dx1-168063" >2814</a>, <a +href="glossaries-user.html#dx1-168064" >2815</a>, <a +href="glossaries-user.html#dx1-168069" >2816</a>, <a +href="glossaries-user.html#dx1-168070" >2817</a>, <a +href="glossaries-user.html#dx1-169009" >2818</a>, <a +href="glossaries-user.html#dx1-169010" >2819</a>, <a +href="glossaries-user.html#dx1-193028" >2820</a>, <a +href="glossaries-user.html#dx1-201008" >2821</a> <br /></span> <span class="index-item"><span class="cmtt-10">makeglossaries-lite</span>  <a href="glossaries-user.html#dx1-3049" ><span -class="cmbx-10">2784</span></a>, <a -href="glossaries-user.html#dx1-7038" >2785</a>, <a -href="glossaries-user.html#dx1-7046" >2786</a>, <a -href="glossaries-user.html#dx1-8040" >2787</a>, <a -href="glossaries-user.html#dx1-16050" >2788</a>, <a -href="glossaries-user.html#dx1-16052" >2789</a>, <a -href="glossaries-user.html#dx1-16057" >2790</a>, <a -href="glossaries-user.html#dx1-16059" >2791</a>, <a -href="glossaries-user.html#dx1-18002" >2792</a>, <a -href="glossaries-user.html#dx1-18006" >2793</a>, <a -href="glossaries-user.html#dx1-18009" >2794</a>, <a -href="glossaries-user.html#dx1-141006" >2795</a>, <a -href="glossaries-user.html#dx1-175014" >2796</a>, <a -href="glossaries-user.html#dx1-175018" >2797</a>, <a -href="glossaries-user.html#dx1-175040" >2798</a>, <a -href="glossaries-user.html#dx1-176010" >2799</a>, <a -href="glossaries-user.html#dx1-178001" >2800</a>, <a -href="glossaries-user.html#dx1-179011" >2801</a>, <a -href="glossaries-user.html#dx1-190009" >2802</a>, <a -href="glossaries-user.html#dx1-192003" >2803</a>, <a -href="glossaries-user.html#dx1-192014" >2804</a>, <a -href="glossaries-user.html#dx1-195002" >2805</a>, <a -href="glossaries-user.html#dx1-198004" >2806</a>, <a -href="glossaries-user.html#dx1-200004" >2807</a>, <a -href="glossaries-user.html#dx1-211007" >2808</a>, <a -href="glossaries-user.html#dx1-211014" >2809</a>, <a -href="glossaries-user.html#dx1-224044" >2810</a> <br /></span> +class="cmbx-10">2822</span></a>, <a +href="glossaries-user.html#dx1-7038" >2823</a>, <a +href="glossaries-user.html#dx1-7046" >2824</a>, <a +href="glossaries-user.html#dx1-8040" >2825</a>, <a +href="glossaries-user.html#dx1-16050" >2826</a>, <a +href="glossaries-user.html#dx1-16052" >2827</a>, <a +href="glossaries-user.html#dx1-16057" >2828</a>, <a +href="glossaries-user.html#dx1-16059" >2829</a>, <a +href="glossaries-user.html#dx1-18002" >2830</a>, <a +href="glossaries-user.html#dx1-18006" >2831</a>, <a +href="glossaries-user.html#dx1-18009" >2832</a>, <a +href="glossaries-user.html#dx1-144007" >2833</a>, <a +href="glossaries-user.html#dx1-178014" >2834</a>, <a +href="glossaries-user.html#dx1-178018" >2835</a>, <a +href="glossaries-user.html#dx1-178040" >2836</a>, <a +href="glossaries-user.html#dx1-179010" >2837</a>, <a +href="glossaries-user.html#dx1-181001" >2838</a>, <a +href="glossaries-user.html#dx1-182011" >2839</a>, <a +href="glossaries-user.html#dx1-193009" >2840</a>, <a +href="glossaries-user.html#dx1-195003" >2841</a>, <a +href="glossaries-user.html#dx1-195014" >2842</a>, <a +href="glossaries-user.html#dx1-198002" >2843</a>, <a +href="glossaries-user.html#dx1-201004" >2844</a>, <a +href="glossaries-user.html#dx1-203004" >2845</a>, <a +href="glossaries-user.html#dx1-214007" >2846</a>, <a +href="glossaries-user.html#dx1-214014" >2847</a>, <a +href="glossaries-user.html#dx1-227044" >2848</a> <br /></span> <span class="index-item"><span class="cmtt-10">makeglossariesgui</span>  <a href="glossaries-user.html#dx1-3047" ><span -class="cmbx-10">2811</span></a>, <a -href="glossaries-user.html#dx1-16055" >2812</a>, <a -href="glossaries-user.html#dx1-227001" >2813</a> <br /></span> +class="cmbx-10">2849</span></a>, <a +href="glossaries-user.html#dx1-16055" >2850</a>, <a +href="glossaries-user.html#dx1-230001" >2851</a> <br /></span> <span class="index-item"><span class="cmss-10">makeidx </span>package  <a -href="glossaries-user.html#dx1-87009" >2814</a> <br /></span> +href="glossaries-user.html#dx1-88009" >2852</a> <br /></span> <span class="index-item"><span class="cmtt-10">makeindex</span>  <a -href="glossaries-user.html#dx1-3004" >2815</a>, <a -href="glossaries-user.html#dx1-3036" >2816</a>, <a -href="glossaries-user.html#dx1-3046" >2817</a>, <a -href="glossaries-user.html#dx1-3051" >2818</a>, <a +href="glossaries-user.html#dx1-3004" >2853</a>, <a +href="glossaries-user.html#dx1-3036" >2854</a>, <a +href="glossaries-user.html#dx1-3046" >2855</a>, <a +href="glossaries-user.html#dx1-3051" >2856</a>, <a href="glossaries-user.html#dx1-3053" ><span -class="cmbx-10">2819</span></a>, <a -href="glossaries-user.html#dx1-7005" >2820</a>, <a -href="glossaries-user.html#dx1-7007" >2821</a>, <a -href="glossaries-user.html#dx1-7008" >2822</a>, <a -href="glossaries-user.html#dx1-7009" >2823</a>, <a -href="glossaries-user.html#dx1-7012" >2824</a>, <a -href="glossaries-user.html#dx1-7015" >2825</a>, <a -href="glossaries-user.html#dx1-7030" >2826</a>, <a -href="glossaries-user.html#dx1-7032" >2827</a>, <a -href="glossaries-user.html#dx1-7033" >2828</a>, <a -href="glossaries-user.html#dx1-7034" >2829</a>, <a -href="glossaries-user.html#dx1-7035" >2830</a>, <a -href="glossaries-user.html#dx1-7040" >2831</a>, <a -href="glossaries-user.html#dx1-7043" >2832</a>, <a -href="glossaries-user.html#dx1-7044" >2833</a>, <a -href="glossaries-user.html#dx1-8056" >2834</a>, <a -href="glossaries-user.html#dx1-13002" >2835</a>, <a -href="glossaries-user.html#dx1-13005" >2836</a>, <a -href="glossaries-user.html#dx1-13032" >2837</a>, <a -href="glossaries-user.html#dx1-13034" >2838</a>, <a -href="glossaries-user.html#dx1-13037" >2839</a>, <a -href="glossaries-user.html#dx1-13041" >2840</a>, <a -href="glossaries-user.html#dx1-13043" >2841</a>, <a -href="glossaries-user.html#dx1-13048" >2842</a>, <a -href="glossaries-user.html#dx1-14054" >2843</a>, <a -href="glossaries-user.html#dx1-16005" >2844</a>, <a -href="glossaries-user.html#dx1-16008" >2845</a>, <a -href="glossaries-user.html#dx1-16010" >2846</a>, <a -href="glossaries-user.html#dx1-16015" >2847</a>, <a -href="glossaries-user.html#dx1-16024" >2848</a>, <a -href="glossaries-user.html#dx1-16032" >2849</a>, <a -href="glossaries-user.html#dx1-16035" >2850</a>, <a -href="glossaries-user.html#dx1-16038" >2851</a>, <a -href="glossaries-user.html#dx1-16040" >2852</a>, <a -href="glossaries-user.html#dx1-16042" >2853</a>, <a -href="glossaries-user.html#dx1-16047" >2854</a>, <a -href="glossaries-user.html#dx1-16054" >2855</a>, <a -href="glossaries-user.html#dx1-16060" >2856</a>, <a -href="glossaries-user.html#dx1-16063" >2857</a>, <a -href="glossaries-user.html#dx1-16066" >2858</a>, <a -href="glossaries-user.html#dx1-16071" >2859</a>, <a -href="glossaries-user.html#dx1-16080" >2860</a>, <a -href="glossaries-user.html#dx1-16085" >2861</a>, <a -href="glossaries-user.html#dx1-16086" >2862</a>, <a -href="glossaries-user.html#dx1-17004" >2863</a>, <a -href="glossaries-user.html#dx1-17010" >2864</a>, <a -href="glossaries-user.html#dx1-17021" >2865</a>, <a -href="glossaries-user.html#dx1-17024" >2866</a>, <a -href="glossaries-user.html#dx1-17028" >2867</a>, <a -href="glossaries-user.html#dx1-17029" >2868</a>, <a -href="glossaries-user.html#dx1-17030" >2869</a>, <a -href="glossaries-user.html#x1-200001.4.4" >2870</a>, <a -href="glossaries-user.html#dx1-20001" >2871</a>, <a -href="glossaries-user.html#dx1-20003" >2872</a>, <a -href="glossaries-user.html#dx1-20006" >2873</a>, <a -href="glossaries-user.html#dx1-20010" >2874</a>, <a -href="glossaries-user.html#dx1-20012" >2875</a>, <a -href="glossaries-user.html#dx1-20019" >2876</a>, <a -href="glossaries-user.html#dx1-20021" >2877</a>, <a -href="glossaries-user.html#dx1-21002" >2878</a>, <a -href="glossaries-user.html#dx1-22002" >2879</a>, <a -href="glossaries-user.html#dx1-22006" >2880</a>, <a -href="glossaries-user.html#dx1-22012" >2881</a>, <a -href="glossaries-user.html#dx1-22014" >2882</a>, <a -href="glossaries-user.html#dx1-22021" >2883</a>, <a -href="glossaries-user.html#dx1-31013" >2884</a>, <a -href="glossaries-user.html#dx1-31016" >2885</a>, <a -href="glossaries-user.html#dx1-46007" >2886</a>, <a -href="glossaries-user.html#dx1-55002" >2887</a>, <a -href="glossaries-user.html#dx1-55005" >2888</a>, <a -href="glossaries-user.html#dx1-63005" >2889</a>, <a -href="glossaries-user.html#dx1-63007" >2890</a>, <a -href="glossaries-user.html#dx1-67008" >2891</a>, <a -href="glossaries-user.html#dx1-73027" >2892</a>, <a -href="glossaries-user.html#dx1-75001" >2893</a>, <a -href="glossaries-user.html#dx1-75003" >2894</a>, <a -href="glossaries-user.html#dx1-75005" >2895</a>, <a -href="glossaries-user.html#dx1-76006" >2896</a>, <a -href="glossaries-user.html#dx1-79002" >2897</a>, <a -href="glossaries-user.html#dx1-79006" >2898</a>, <a -href="glossaries-user.html#dx1-79012" >2899</a>, <a -href="glossaries-user.html#dx1-79015" >2900</a>, <a -href="glossaries-user.html#dx1-111002" >2901</a>, <a -href="glossaries-user.html#dx1-111007" >2902</a>, <a -href="glossaries-user.html#dx1-119003" >2903</a>, <a -href="glossaries-user.html#dx1-127006" >2904</a>, <a -href="glossaries-user.html#dx1-128014" >2905</a>, <a -href="glossaries-user.html#dx1-128017" >2906</a>, <a -href="glossaries-user.html#dx1-129003" >2907</a>, <a -href="glossaries-user.html#dx1-129005" >2908</a>, <a -href="glossaries-user.html#dx1-129006" >2909</a>, <a -href="glossaries-user.html#dx1-129017" >2910</a>, <a -href="glossaries-user.html#dx1-129019" >2911</a>, <a -href="glossaries-user.html#dx1-129023" >2912</a>, <a -href="glossaries-user.html#dx1-130001" >2913</a>, <a -href="glossaries-user.html#dx1-130007" >2914</a>, <a -href="glossaries-user.html#dx1-131004" >2915</a>, <a -href="glossaries-user.html#dx1-131006" >2916</a>, <a -href="glossaries-user.html#dx1-132005" >2917</a>, <a -href="glossaries-user.html#dx1-132042" >2918</a>, <a -href="glossaries-user.html#dx1-132049" >2919</a>, <a -href="glossaries-user.html#dx1-132055" >2920</a>, <a -href="glossaries-user.html#dx1-140063" >2921</a>, <a -href="glossaries-user.html#dx1-141007" >2922</a>, <a -href="glossaries-user.html#dx1-141011" >2923</a>, <a -href="glossaries-user.html#dx1-146003" >2924</a>, <a -href="glossaries-user.html#dx1-156015" >2925</a>, <a -href="glossaries-user.html#dx1-163031" >2926</a>, <a -href="glossaries-user.html#dx1-166021" >2927</a>, <a -href="glossaries-user.html#dx1-175006" >2928</a>, <a -href="glossaries-user.html#dx1-175007" >2929</a>, <a -href="glossaries-user.html#dx1-175008" >2930</a>, <a -href="glossaries-user.html#dx1-175012" >2931</a>, <a -href="glossaries-user.html#dx1-175015" >2932</a>, <a -href="glossaries-user.html#dx1-175041" >2933</a>, <a -href="glossaries-user.html#dx1-176004" >2934</a>, <a -href="glossaries-user.html#dx1-176011" >2935</a>, <a -href="glossaries-user.html#dx1-176025" >2936</a>, <a -href="glossaries-user.html#dx1-176030" >2937</a>, <a -href="glossaries-user.html#dx1-188007" >2938</a>, <a -href="glossaries-user.html#dx1-190001" >2939</a>, <a -href="glossaries-user.html#dx1-190006" >2940</a>, <a -href="glossaries-user.html#dx1-190010" >2941</a>, <a -href="glossaries-user.html#dx1-192001" >2942</a>, <a -href="glossaries-user.html#dx1-192004" >2943</a>, <a -href="glossaries-user.html#dx1-192010" >2944</a>, <a -href="glossaries-user.html#dx1-194002" >2945</a>, <a -href="glossaries-user.html#dx1-198001" >2946</a>, <a -href="glossaries-user.html#dx1-198002" >2947</a>, <a -href="glossaries-user.html#dx1-198005" >2948</a>, <a -href="glossaries-user.html#dx1-198009" >2949</a>, <a -href="glossaries-user.html#dx1-198012" >2950</a>, <a -href="glossaries-user.html#dx1-198016" >2951</a>, <a -href="glossaries-user.html#dx1-200005" >2952</a>, <a -href="glossaries-user.html#dx1-200008" >2953</a>, <a -href="glossaries-user.html#dx1-200009" >2954</a>, <a -href="glossaries-user.html#dx1-210001" >2955</a>, <a -href="glossaries-user.html#dx1-210007" >2956</a>, <a -href="glossaries-user.html#dx1-214002" >2957</a>, <a -href="glossaries-user.html#dx1-214008" >2958</a>, <a -href="glossaries-user.html#dx1-214030" >2959</a>, <a -href="glossaries-user.html#dx1-220007" >2960</a>, <a -href="glossaries-user.html#dx1-220035" >2961</a>, <a -href="glossaries-user.html#dx1-139004" >2962</a>, <a -href="glossaries-user.html#dx1-190003" >2963</a> <br /></span> +class="cmbx-10">2857</span></a>, <a +href="glossaries-user.html#dx1-7005" >2858</a>, <a +href="glossaries-user.html#dx1-7007" >2859</a>, <a +href="glossaries-user.html#dx1-7008" >2860</a>, <a +href="glossaries-user.html#dx1-7009" >2861</a>, <a +href="glossaries-user.html#dx1-7012" >2862</a>, <a +href="glossaries-user.html#dx1-7015" >2863</a>, <a +href="glossaries-user.html#dx1-7030" >2864</a>, <a +href="glossaries-user.html#dx1-7032" >2865</a>, <a +href="glossaries-user.html#dx1-7033" >2866</a>, <a +href="glossaries-user.html#dx1-7034" >2867</a>, <a +href="glossaries-user.html#dx1-7035" >2868</a>, <a +href="glossaries-user.html#dx1-7040" >2869</a>, <a +href="glossaries-user.html#dx1-7043" >2870</a>, <a +href="glossaries-user.html#dx1-7044" >2871</a>, <a +href="glossaries-user.html#dx1-8056" >2872</a>, <a +href="glossaries-user.html#dx1-13002" >2873</a>, <a +href="glossaries-user.html#dx1-13005" >2874</a>, <a +href="glossaries-user.html#dx1-13032" >2875</a>, <a +href="glossaries-user.html#dx1-13034" >2876</a>, <a +href="glossaries-user.html#dx1-13037" >2877</a>, <a +href="glossaries-user.html#dx1-13041" >2878</a>, <a +href="glossaries-user.html#dx1-13043" >2879</a>, <a +href="glossaries-user.html#dx1-13048" >2880</a>, <a +href="glossaries-user.html#dx1-14054" >2881</a>, <a +href="glossaries-user.html#dx1-16005" >2882</a>, <a +href="glossaries-user.html#dx1-16008" >2883</a>, <a +href="glossaries-user.html#dx1-16010" >2884</a>, <a +href="glossaries-user.html#dx1-16015" >2885</a>, <a +href="glossaries-user.html#dx1-16024" >2886</a>, <a +href="glossaries-user.html#dx1-16032" >2887</a>, <a +href="glossaries-user.html#dx1-16035" >2888</a>, <a +href="glossaries-user.html#dx1-16038" >2889</a>, <a +href="glossaries-user.html#dx1-16040" >2890</a>, <a +href="glossaries-user.html#dx1-16042" >2891</a>, <a +href="glossaries-user.html#dx1-16047" >2892</a>, <a +href="glossaries-user.html#dx1-16054" >2893</a>, <a +href="glossaries-user.html#dx1-16060" >2894</a>, <a +href="glossaries-user.html#dx1-16063" >2895</a>, <a +href="glossaries-user.html#dx1-16066" >2896</a>, <a +href="glossaries-user.html#dx1-16071" >2897</a>, <a +href="glossaries-user.html#dx1-16080" >2898</a>, <a +href="glossaries-user.html#dx1-16085" >2899</a>, <a +href="glossaries-user.html#dx1-16086" >2900</a>, <a +href="glossaries-user.html#dx1-17004" >2901</a>, <a +href="glossaries-user.html#dx1-17010" >2902</a>, <a +href="glossaries-user.html#dx1-17021" >2903</a>, <a +href="glossaries-user.html#dx1-17024" >2904</a>, <a +href="glossaries-user.html#dx1-17028" >2905</a>, <a +href="glossaries-user.html#dx1-17029" >2906</a>, <a +href="glossaries-user.html#dx1-17030" >2907</a>, <a +href="glossaries-user.html#x1-200001.4.4" >2908</a>, <a +href="glossaries-user.html#dx1-20001" >2909</a>, <a +href="glossaries-user.html#dx1-20003" >2910</a>, <a +href="glossaries-user.html#dx1-20006" >2911</a>, <a +href="glossaries-user.html#dx1-20010" >2912</a>, <a +href="glossaries-user.html#dx1-20012" >2913</a>, <a +href="glossaries-user.html#dx1-20019" >2914</a>, <a +href="glossaries-user.html#dx1-20021" >2915</a>, <a +href="glossaries-user.html#dx1-21002" >2916</a>, <a +href="glossaries-user.html#dx1-22002" >2917</a>, <a +href="glossaries-user.html#dx1-22006" >2918</a>, <a +href="glossaries-user.html#dx1-22012" >2919</a>, <a +href="glossaries-user.html#dx1-22014" >2920</a>, <a +href="glossaries-user.html#dx1-22021" >2921</a>, <a +href="glossaries-user.html#dx1-31013" >2922</a>, <a +href="glossaries-user.html#dx1-31016" >2923</a>, <a +href="glossaries-user.html#dx1-47007" >2924</a>, <a +href="glossaries-user.html#dx1-56002" >2925</a>, <a +href="glossaries-user.html#dx1-56005" >2926</a>, <a +href="glossaries-user.html#dx1-64005" >2927</a>, <a +href="glossaries-user.html#dx1-64007" >2928</a>, <a +href="glossaries-user.html#dx1-68008" >2929</a>, <a +href="glossaries-user.html#dx1-74027" >2930</a>, <a +href="glossaries-user.html#dx1-76001" >2931</a>, <a +href="glossaries-user.html#dx1-76003" >2932</a>, <a +href="glossaries-user.html#dx1-76005" >2933</a>, <a +href="glossaries-user.html#dx1-77006" >2934</a>, <a +href="glossaries-user.html#dx1-80002" >2935</a>, <a +href="glossaries-user.html#dx1-80006" >2936</a>, <a +href="glossaries-user.html#dx1-80012" >2937</a>, <a +href="glossaries-user.html#dx1-80015" >2938</a>, <a +href="glossaries-user.html#dx1-112002" >2939</a>, <a +href="glossaries-user.html#dx1-112007" >2940</a>, <a +href="glossaries-user.html#dx1-120003" >2941</a>, <a +href="glossaries-user.html#dx1-129003" >2942</a>, <a +href="glossaries-user.html#dx1-129040" >2943</a>, <a +href="glossaries-user.html#dx1-129047" >2944</a>, <a +href="glossaries-user.html#dx1-129053" >2945</a>, <a +href="glossaries-user.html#dx1-134063" >2946</a>, <a +href="glossaries-user.html#dx1-144008" >2947</a>, <a +href="glossaries-user.html#dx1-144013" >2948</a>, <a +href="glossaries-user.html#dx1-145003" >2949</a>, <a +href="glossaries-user.html#dx1-149006" >2950</a>, <a +href="glossaries-user.html#dx1-150013" >2951</a>, <a +href="glossaries-user.html#dx1-150016" >2952</a>, <a +href="glossaries-user.html#dx1-151003" >2953</a>, <a +href="glossaries-user.html#dx1-151005" >2954</a>, <a +href="glossaries-user.html#dx1-151006" >2955</a>, <a +href="glossaries-user.html#dx1-151017" >2956</a>, <a +href="glossaries-user.html#dx1-151019" >2957</a>, <a +href="glossaries-user.html#dx1-151023" >2958</a>, <a +href="glossaries-user.html#dx1-152001" >2959</a>, <a +href="glossaries-user.html#dx1-152007" >2960</a>, <a +href="glossaries-user.html#dx1-153004" >2961</a>, <a +href="glossaries-user.html#dx1-153006" >2962</a>, <a +href="glossaries-user.html#dx1-155016" >2963</a>, <a +href="glossaries-user.html#dx1-162031" >2964</a>, <a +href="glossaries-user.html#dx1-165022" >2965</a>, <a +href="glossaries-user.html#dx1-178006" >2966</a>, <a +href="glossaries-user.html#dx1-178007" >2967</a>, <a +href="glossaries-user.html#dx1-178008" >2968</a>, <a +href="glossaries-user.html#dx1-178012" >2969</a>, <a +href="glossaries-user.html#dx1-178015" >2970</a>, <a +href="glossaries-user.html#dx1-178041" >2971</a>, <a +href="glossaries-user.html#dx1-179004" >2972</a>, <a +href="glossaries-user.html#dx1-179011" >2973</a>, <a +href="glossaries-user.html#dx1-179025" >2974</a>, <a +href="glossaries-user.html#dx1-179030" >2975</a>, <a +href="glossaries-user.html#dx1-191007" >2976</a>, <a +href="glossaries-user.html#dx1-193001" >2977</a>, <a +href="glossaries-user.html#dx1-193006" >2978</a>, <a +href="glossaries-user.html#dx1-193010" >2979</a>, <a +href="glossaries-user.html#dx1-195001" >2980</a>, <a +href="glossaries-user.html#dx1-195004" >2981</a>, <a +href="glossaries-user.html#dx1-195010" >2982</a>, <a +href="glossaries-user.html#dx1-197002" >2983</a>, <a +href="glossaries-user.html#dx1-201001" >2984</a>, <a +href="glossaries-user.html#dx1-201002" >2985</a>, <a +href="glossaries-user.html#dx1-201005" >2986</a>, <a +href="glossaries-user.html#dx1-201009" >2987</a>, <a +href="glossaries-user.html#dx1-201012" >2988</a>, <a +href="glossaries-user.html#dx1-201016" >2989</a>, <a +href="glossaries-user.html#dx1-203005" >2990</a>, <a +href="glossaries-user.html#dx1-203008" >2991</a>, <a +href="glossaries-user.html#dx1-203009" >2992</a>, <a +href="glossaries-user.html#dx1-213001" >2993</a>, <a +href="glossaries-user.html#dx1-213007" >2994</a>, <a +href="glossaries-user.html#dx1-217002" >2995</a>, <a +href="glossaries-user.html#dx1-217008" >2996</a>, <a +href="glossaries-user.html#dx1-217030" >2997</a>, <a +href="glossaries-user.html#dx1-223007" >2998</a>, <a +href="glossaries-user.html#dx1-223035" >2999</a>, <a +href="glossaries-user.html#dx1-148004" >3000</a>, <a +href="glossaries-user.html#dx1-193003" >3001</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-g</span>  <a -href="glossaries-user.html#dx1-7016" >2964</a>, <a -href="glossaries-user.html#dx1-13033" >2965</a>, <a -href="glossaries-user.html#dx1-13040" >2966</a> <br /></span> +href="glossaries-user.html#dx1-7016" >3002</a>, <a +href="glossaries-user.html#dx1-13033" >3003</a>, <a +href="glossaries-user.html#dx1-13040" >3004</a> <br /></span> + + <span class="index-subitem">    <span class="cmtt-10">-l</span>  <a -href="glossaries-user.html#dx1-7042" >2967</a>, <a -href="glossaries-user.html#dx1-7048" >2968</a>, <a -href="glossaries-user.html#dx1-16089" >2969</a>, <a -href="glossaries-user.html#dx1-20009" >2970</a>, <a -href="glossaries-user.html#dx1-200006" >2971</a> <br /></span> +href="glossaries-user.html#dx1-7042" >3005</a>, <a +href="glossaries-user.html#dx1-7048" >3006</a>, <a +href="glossaries-user.html#dx1-16089" >3007</a>, <a +href="glossaries-user.html#dx1-20009" >3008</a>, <a +href="glossaries-user.html#dx1-203006" >3009</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\makenoidxglossaries</span></span></span>  <a -href="glossaries-user.html#dx1-6001" >2972</a>, <a -href="glossaries-user.html#dx1-6004" >2973</a>, <a -href="glossaries-user.html#dx1-63002" >2974</a>, <a -href="glossaries-user.html#dx1-80002" >2975</a>, <a -href="glossaries-user.html#dx1-80004" >2976</a>, <a -href="glossaries-user.html#dx1-80007" >2977</a>, <a -href="glossaries-user.html#dx1-81003" >2978</a>, <a -href="glossaries-user.html#dx1-110001" ><span -class="cmti-10">2979</span></a>, <a -href="glossaries-user.html#dx1-138002" >2980</a>, <a -href="glossaries-user.html#dx1-141001" >2981</a>, <a -href="glossaries-user.html#dx1-141015" >2982</a> <br /></span> +href="glossaries-user.html#dx1-6001" >3010</a>, <a +href="glossaries-user.html#dx1-6004" >3011</a>, <a +href="glossaries-user.html#dx1-64002" >3012</a>, <a +href="glossaries-user.html#dx1-81002" >3013</a>, <a +href="glossaries-user.html#dx1-81004" >3014</a>, <a +href="glossaries-user.html#dx1-81007" >3015</a>, <a +href="glossaries-user.html#dx1-82003" >3016</a>, <a +href="glossaries-user.html#dx1-111001" ><span +class="cmti-10">3017</span></a>, <a +href="glossaries-user.html#dx1-144001" >3018</a>, <a +href="glossaries-user.html#dx1-144018" >3019</a>, <a +href="glossaries-user.html#dx1-147002" >3020</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\MakeTextUppercase</span></span></span>  <a -href="glossaries-user.html#dx1-42005" >2983</a>, <a -href="glossaries-user.html#dx1-184066" >2984</a> <br /></span> +href="glossaries-user.html#dx1-43005" >3021</a>, <a +href="glossaries-user.html#dx1-187066" >3022</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\markboth</span></span></span>  <a -href="glossaries-user.html#dx1-41006" >2985</a> <br /></span> - - +href="glossaries-user.html#dx1-42006" >3023</a> <br /></span> <span class="index-item"><span class="cmss-10">memoir </span>class  <a -href="glossaries-user.html#dx1-42002" >2986</a>, <a -href="glossaries-user.html#dx1-42012" >2987</a>, <a -href="glossaries-user.html#dx1-42014" >2988</a>, <a -href="glossaries-user.html#dx1-41005" >2989</a> <br /></span> +href="glossaries-user.html#dx1-43002" >3024</a>, <a +href="glossaries-user.html#dx1-43012" >3025</a>, <a +href="glossaries-user.html#dx1-43014" >3026</a>, <a +href="glossaries-user.html#dx1-42005" >3027</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\memUChead</span></span></span>  <a -href="glossaries-user.html#dx1-42015" >2990</a> <br /></span> +href="glossaries-user.html#dx1-43015" >3028</a> <br /></span> <span class="index-item"><span class="cmss-10">mfirstuc </span>package  <a -href="glossaries-user.html#dx1-6" >2991</a>, <a -href="glossaries-user.html#dx1-13018" >2992</a>, <a -href="glossaries-user.html#dx1-112156" >2993</a>, <a -href="glossaries-user.html#dx1-133029" >2994</a>, <a -href="glossaries-user.html#dx1-133031" >2995</a>, <a -href="glossaries-user.html#dx1-133034" >2996</a>, <a -href="glossaries-user.html#dx1-133046" >2997</a> <br /></span> +href="glossaries-user.html#dx1-6" >3029</a>, <a +href="glossaries-user.html#dx1-13018" >3030</a>, <a +href="glossaries-user.html#dx1-113175" >3031</a>, <a +href="glossaries-user.html#dx1-130029" >3032</a>, <a +href="glossaries-user.html#dx1-130031" >3033</a>, <a +href="glossaries-user.html#dx1-130034" >3034</a>, <a +href="glossaries-user.html#dx1-130046" >3035</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\mfirstucMakeUppercase</span></span></span>  <a -href="glossaries-user.html#dx1-42007" >2998</a> <br /></span> +href="glossaries-user.html#dx1-43007" >3036</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\midrule</span></span></span>  <a -href="glossaries-user.html#dx1-160013" >2999</a> <br /></span> +href="glossaries-user.html#dx1-159013" >3037</a> <br /></span> <span class="index-item"><span class="cmss-10">multicol </span>package  <a -href="glossaries-user.html#dx1-164004" >3000</a> <br /></span> +href="glossaries-user.html#dx1-163004" >3038</a> <br /></span> <span class="index-item"><span class="cmss-10">mwe </span>package  <a -href="glossaries-user.html#dx1-12010" >3001</a>, <a -href="glossaries-user.html#dx1-224027" >3002</a> <br /></span> +href="glossaries-user.html#dx1-12010" >3039</a>, <a +href="glossaries-user.html#dx1-12025" >3040</a>, <a +href="glossaries-user.html#dx1-227027" >3041</a> <br /></span> </p><p class="theindex"> <span class="cmbx-10">N</span> <span class="index-item"><span class="cmss-10">nameref </span>package  <a -href="glossaries-user.html#dx1-43014" >3003</a> <br /></span> +href="glossaries-user.html#dx1-44014" >3042</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">\newabbreviation</span></span></span>  <a -href="glossaries-user.html#dx1-4008" >3004</a>, <a -href="glossaries-user.html#dx1-12012" >3005</a>, <a -href="glossaries-user.html#dx1-12016" >3006</a>, <a -href="glossaries-user.html#dx1-12020" >3007</a>, <a -href="glossaries-user.html#dx1-90022" >3008</a>, <a -href="glossaries-user.html#dx1-112138" >3009</a>, <a -href="glossaries-user.html#dx1-175023" >3010</a>, <a -href="glossaries-user.html#dx1-175025" >3011</a>, <a -href="glossaries-user.html#dx1-175036" >3012</a>, <a -href="glossaries-user.html#dx1-175038" >3013</a>, <a -href="glossaries-user.html#dx1-175045" >3014</a>, <a -href="glossaries-user.html#dx1-178030" >3015</a>, <a -href="glossaries-user.html#dx1-178032" >3016</a>, <a -href="glossaries-user.html#dx1-179016" >3017</a>, <a -href="glossaries-user.html#dx1-179050" >3018</a>, <a -href="glossaries-user.html#dx1-180006" >3019</a>, <a -href="glossaries-user.html#dx1-182031" >3020</a>, <a -href="glossaries-user.html#dx1-184048" >3021</a>, <a -href="glossaries-user.html#dx1-185015" >3022</a>, <a -href="glossaries-user.html#dx1-186005" >3023</a>, <a -href="glossaries-user.html#dx1-186006" >3024</a>, <a -href="glossaries-user.html#dx1-186030" >3025</a>, <a -href="glossaries-user.html#dx1-198006" >3026</a>, <a -href="glossaries-user.html#dx1-198026" >3027</a>, <a -href="glossaries-user.html#dx1-207008" >3028</a>, <a -href="glossaries-user.html#dx1-207009" >3029</a>, <a -href="glossaries-user.html#dx1-224041" >3030</a>, <a -href="glossaries-user.html#dx1-224047" >3031</a>, <a -href="glossaries-user.html#dx1-224048" >3032</a>, <a -href="glossaries-user.html#dx1-224050" >3033</a>, <a -href="glossaries-user.html#dx1-224068" >3034</a>, <a -href="glossaries-user.html#dx1-224074" >3035</a> <br /></span> +href="glossaries-user.html#dx1-4008" >3043</a>, <a +href="glossaries-user.html#dx1-12012" >3044</a>, <a +href="glossaries-user.html#dx1-12016" >3045</a>, <a +href="glossaries-user.html#dx1-12020" >3046</a>, <a +href="glossaries-user.html#dx1-91022" >3047</a>, <a +href="glossaries-user.html#dx1-113158" >3048</a>, <a +href="glossaries-user.html#dx1-178023" >3049</a>, <a +href="glossaries-user.html#dx1-178025" >3050</a>, <a +href="glossaries-user.html#dx1-178036" >3051</a>, <a +href="glossaries-user.html#dx1-178038" >3052</a>, <a +href="glossaries-user.html#dx1-178045" >3053</a>, <a +href="glossaries-user.html#dx1-181030" >3054</a>, <a +href="glossaries-user.html#dx1-181032" >3055</a>, <a +href="glossaries-user.html#dx1-182016" >3056</a>, <a +href="glossaries-user.html#dx1-182050" >3057</a>, <a +href="glossaries-user.html#dx1-183006" >3058</a>, <a +href="glossaries-user.html#dx1-185031" >3059</a>, <a +href="glossaries-user.html#dx1-187048" >3060</a>, <a +href="glossaries-user.html#dx1-188015" >3061</a>, <a +href="glossaries-user.html#dx1-189005" >3062</a>, <a +href="glossaries-user.html#dx1-189006" >3063</a>, <a +href="glossaries-user.html#dx1-189030" >3064</a>, <a +href="glossaries-user.html#dx1-201006" >3065</a>, <a +href="glossaries-user.html#dx1-201026" >3066</a>, <a +href="glossaries-user.html#dx1-210008" >3067</a>, <a +href="glossaries-user.html#dx1-210009" >3068</a>, <a +href="glossaries-user.html#dx1-227041" >3069</a>, <a +href="glossaries-user.html#dx1-227047" >3070</a>, <a +href="glossaries-user.html#dx1-227048" >3071</a>, <a +href="glossaries-user.html#dx1-227050" >3072</a>, <a +href="glossaries-user.html#dx1-227068" >3073</a>, <a +href="glossaries-user.html#dx1-227074" >3074</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">\newabbreviationstyle</span></span></span>  <a -href="glossaries-user.html#dx1-184008" >3036</a> <br /></span> +href="glossaries-user.html#dx1-187008" >3075</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newacronym</span></span></span>  <a -href="glossaries-user.html#dx1-12011" >3037</a>, <a -href="glossaries-user.html#dx1-12015" >3038</a>, <a -href="glossaries-user.html#dx1-12019" >3039</a>, <a -href="glossaries-user.html#dx1-90013" >3040</a>, <a -href="glossaries-user.html#dx1-90021" >3041</a>, <a -href="glossaries-user.html#dx1-96001" >3042</a>, <a -href="glossaries-user.html#dx1-97001" >3043</a>, <a -href="glossaries-user.html#dx1-98001" >3044</a>, <a -href="glossaries-user.html#dx1-99001" >3045</a>, <a -href="glossaries-user.html#dx1-100001" >3046</a>, <a -href="glossaries-user.html#dx1-112101" >3047</a>, <a -href="glossaries-user.html#dx1-112137" >3048</a>, <a -href="glossaries-user.html#dx1-117004" >3049</a>, <a -href="glossaries-user.html#dx1-122018" >3050</a>, <a -href="glossaries-user.html#dx1-124002" >3051</a>, <a -href="glossaries-user.html#dx1-132002" >3052</a>, <a -href="glossaries-user.html#dx1-133016" >3053</a>, <a -href="glossaries-user.html#dx1-135049" >3054</a>, <a -href="glossaries-user.html#dx1-138013" >3055</a>, <a -href="glossaries-user.html#dx1-147006" ><span -class="cmti-10">3056</span></a>, <a -href="glossaries-user.html#dx1-147035" >3057</a>, <a -href="glossaries-user.html#dx1-147040" >3058</a>, <a -href="glossaries-user.html#dx1-147056" >3059</a>, <a -href="glossaries-user.html#dx1-147063" >3060</a>, <a -href="glossaries-user.html#dx1-147067" >3061</a>, <a -href="glossaries-user.html#dx1-147074" >3062</a>, <a -href="glossaries-user.html#dx1-149045" >3063</a>, <a -href="glossaries-user.html#dx1-149063" >3064</a>, <a -href="glossaries-user.html#dx1-149077" >3065</a>, <a -href="glossaries-user.html#dx1-150007" >3066</a>, <a -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-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 -href="glossaries-user.html#dx1-172042" >3076</a>, <a -href="glossaries-user.html#dx1-172061" >3077</a>, <a -href="glossaries-user.html#dx1-178006" >3078</a>, <a -href="glossaries-user.html#dx1-178025" >3079</a>, <a -href="glossaries-user.html#dx1-178029" >3080</a>, <a -href="glossaries-user.html#dx1-179017" >3081</a>, <a -href="glossaries-user.html#dx1-179034" >3082</a>, <a -href="glossaries-user.html#dx1-179047" >3083</a>, <a -href="glossaries-user.html#dx1-180002" >3084</a>, <a -href="glossaries-user.html#dx1-180005" >3085</a>, <a -href="glossaries-user.html#dx1-182028" >3086</a>, <a -href="glossaries-user.html#dx1-182032" >3087</a>, <a -href="glossaries-user.html#dx1-184049" >3088</a>, <a -href="glossaries-user.html#dx1-186004" >3089</a>, <a -href="glossaries-user.html#dx1-186007" >3090</a>, <a -href="glossaries-user.html#dx1-198023" >3091</a>, <a -href="glossaries-user.html#dx1-198025" >3092</a>, <a -href="glossaries-user.html#dx1-207005" >3093</a>, <a -href="glossaries-user.html#dx1-207006" >3094</a>, <a -href="glossaries-user.html#dx1-207007" >3095</a>, <a -href="glossaries-user.html#dx1-224014" >3096</a>, <a -href="glossaries-user.html#dx1-224040" >3097</a>, <a -href="glossaries-user.html#dx1-224046" >3098</a>, <a -href="glossaries-user.html#dx1-224058" >3099</a> <br /></span> +href="glossaries-user.html#dx1-12011" >3076</a>, <a +href="glossaries-user.html#dx1-12015" >3077</a>, <a +href="glossaries-user.html#dx1-12019" >3078</a>, <a +href="glossaries-user.html#dx1-91013" >3079</a>, <a +href="glossaries-user.html#dx1-91021" >3080</a>, <a +href="glossaries-user.html#dx1-97001" >3081</a>, <a +href="glossaries-user.html#dx1-98001" >3082</a>, <a +href="glossaries-user.html#dx1-99001" >3083</a>, <a +href="glossaries-user.html#dx1-100001" >3084</a>, <a +href="glossaries-user.html#dx1-101001" >3085</a>, <a +href="glossaries-user.html#dx1-113114" >3086</a>, <a +href="glossaries-user.html#dx1-113157" >3087</a>, <a +href="glossaries-user.html#dx1-118004" >3088</a>, <a +href="glossaries-user.html#dx1-123018" >3089</a>, <a +href="glossaries-user.html#dx1-125002" >3090</a>, <a +href="glossaries-user.html#dx1-128002" >3091</a>, <a +href="glossaries-user.html#dx1-130016" >3092</a>, <a +href="glossaries-user.html#dx1-132049" >3093</a>, <a +href="glossaries-user.html#dx1-135009" ><span +class="cmti-10">3094</span></a>, <a +href="glossaries-user.html#dx1-135018" >3095</a>, <a +href="glossaries-user.html#dx1-135041" >3096</a>, <a +href="glossaries-user.html#dx1-136009" >3097</a>, <a +href="glossaries-user.html#dx1-136016" >3098</a>, <a +href="glossaries-user.html#dx1-136020" >3099</a>, <a +href="glossaries-user.html#dx1-136027" >3100</a>, <a +href="glossaries-user.html#dx1-138045" >3101</a>, <a +href="glossaries-user.html#dx1-138063" >3102</a>, <a +href="glossaries-user.html#dx1-138077" >3103</a>, <a +href="glossaries-user.html#dx1-139007" >3104</a>, <a +href="glossaries-user.html#dx1-139023" >3105</a>, <a +href="glossaries-user.html#dx1-139083" >3106</a>, <a +href="glossaries-user.html#dx1-141006" >3107</a>, <a +href="glossaries-user.html#dx1-143002" >3108</a>, <a +href="glossaries-user.html#dx1-147016" >3109</a>, <a +href="glossaries-user.html#dx1-172021" >3110</a>, <a +href="glossaries-user.html#dx1-172024" >3111</a>, <a +href="glossaries-user.html#dx1-175033" >3112</a>, <a +href="glossaries-user.html#dx1-175036" >3113</a>, <a +href="glossaries-user.html#dx1-175039" >3114</a>, <a +href="glossaries-user.html#dx1-175042" >3115</a>, <a +href="glossaries-user.html#dx1-175061" >3116</a>, <a +href="glossaries-user.html#dx1-181006" >3117</a>, <a +href="glossaries-user.html#dx1-181025" >3118</a>, <a +href="glossaries-user.html#dx1-181029" >3119</a>, <a +href="glossaries-user.html#dx1-182017" >3120</a>, <a +href="glossaries-user.html#dx1-182034" >3121</a>, <a +href="glossaries-user.html#dx1-182047" >3122</a>, <a +href="glossaries-user.html#dx1-183002" >3123</a>, <a +href="glossaries-user.html#dx1-183005" >3124</a>, <a +href="glossaries-user.html#dx1-185028" >3125</a>, <a +href="glossaries-user.html#dx1-185032" >3126</a>, <a +href="glossaries-user.html#dx1-187049" >3127</a>, <a +href="glossaries-user.html#dx1-189004" >3128</a>, <a +href="glossaries-user.html#dx1-189007" >3129</a>, <a +href="glossaries-user.html#dx1-201023" >3130</a>, <a +href="glossaries-user.html#dx1-201025" >3131</a>, <a +href="glossaries-user.html#dx1-210005" >3132</a>, <a +href="glossaries-user.html#dx1-210006" >3133</a>, <a +href="glossaries-user.html#dx1-210007" >3134</a>, <a +href="glossaries-user.html#dx1-227014" >3135</a>, <a +href="glossaries-user.html#dx1-227040" >3136</a>, <a +href="glossaries-user.html#dx1-227046" >3137</a>, <a +href="glossaries-user.html#dx1-227058" >3138</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newacronymstyle</span></span></span>  <a -href="glossaries-user.html#dx1-150001" ><span -class="cmti-10">3100</span></a>, <a -href="glossaries-user.html#dx1-150044" >3101</a>, <a -href="glossaries-user.html#dx1-150047" >3102</a> <br /></span> +href="glossaries-user.html#dx1-139001" ><span +class="cmti-10">3139</span></a>, <a +href="glossaries-user.html#dx1-139044" >3140</a>, <a +href="glossaries-user.html#dx1-139047" >3141</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newdualentry</span></span></span>  <a -href="glossaries-user.html#dx1-137017" >3103</a>, <a -href="glossaries-user.html#dx1-193001" >3104</a> <br /></span> +href="glossaries-user.html#dx1-146018" >3142</a>, <a +href="glossaries-user.html#dx1-196001" >3143</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newglossary</span></span></span>  <a -href="glossaries-user.html#dx1-19020" >3105</a>, <a -href="glossaries-user.html#dx1-20017" >3106</a>, <a -href="glossaries-user.html#dx1-84007" >3107</a>, <a -href="glossaries-user.html#dx1-144005" >3108</a>, <a -href="glossaries-user.html#dx1-144042" >3109</a>, <a -href="glossaries-user.html#dx1-146001" ><span -class="cmti-10">3110</span></a>, <a -href="glossaries-user.html#dx1-192009" >3111</a> <br /></span> +href="glossaries-user.html#dx1-19020" >3144</a>, <a +href="glossaries-user.html#dx1-20017" >3145</a>, <a +href="glossaries-user.html#dx1-85007" >3146</a>, <a +href="glossaries-user.html#dx1-145001" ><span +class="cmti-10">3147</span></a>, <a +href="glossaries-user.html#dx1-168005" >3148</a>, <a +href="glossaries-user.html#dx1-168042" >3149</a>, <a +href="glossaries-user.html#dx1-195009" >3150</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newglossary*</span></span></span>  <a -href="glossaries-user.html#dx1-146007" ><span -class="cmti-10">3112</span></a>, <a -href="glossaries-user.html#dx1-176016" >3113</a>, <a -href="glossaries-user.html#dx1-176024" >3114</a>, <a -href="glossaries-user.html#dx1-192015" >3115</a> <br /></span> +href="glossaries-user.html#dx1-145007" ><span +class="cmti-10">3151</span></a>, <a +href="glossaries-user.html#dx1-179016" >3152</a>, <a +href="glossaries-user.html#dx1-179024" >3153</a>, <a +href="glossaries-user.html#dx1-195015" >3154</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newglossaryentry</span></span></span>  <a -href="glossaries-user.html#dx1-3033" >3116</a>, <a -href="glossaries-user.html#dx1-5003" >3117</a>, <a -href="glossaries-user.html#dx1-6012" >3118</a>, <a -href="glossaries-user.html#dx1-56004" >3119</a>, <a -href="glossaries-user.html#dx1-73007" >3120</a>, <a -href="glossaries-user.html#dx1-73033" >3121</a>, <a -href="glossaries-user.html#dx1-87002" >3122</a>, <a -href="glossaries-user.html#dx1-112001" >3123</a>, <a -href="glossaries-user.html#dx1-112003" ><span -class="cmti-10">3124</span></a>, <a -href="glossaries-user.html#dx1-112122" >3125</a>, <a -href="glossaries-user.html#dx1-116002" >3126</a>, <a -href="glossaries-user.html#dx1-122002" >3127</a>, <a -href="glossaries-user.html#dx1-122006" >3128</a>, <a -href="glossaries-user.html#dx1-122031" >3129</a>, <a -href="glossaries-user.html#dx1-124001" >3130</a>, <a -href="glossaries-user.html#dx1-132001" >3131</a>, <a -href="glossaries-user.html#dx1-133015" >3132</a>, <a -href="glossaries-user.html#dx1-133052" >3133</a>, <a -href="glossaries-user.html#dx1-147007" >3134</a>, <a -href="glossaries-user.html#dx1-147014" >3135</a>, <a -href="glossaries-user.html#dx1-147020" >3136</a>, <a -href="glossaries-user.html#dx1-147036" >3137</a>, <a -href="glossaries-user.html#dx1-150008" >3138</a>, <a -href="glossaries-user.html#dx1-154001" >3139</a>, <a -href="glossaries-user.html#dx1-171002" >3140</a>, <a -href="glossaries-user.html#dx1-180001" >3141</a>, <a -href="glossaries-user.html#dx1-183019" >3142</a>, <a -href="glossaries-user.html#dx1-189013" >3143</a>, <a -href="glossaries-user.html#dx1-189029" >3144</a>, <a -href="glossaries-user.html#dx1-189045" >3145</a>, <a -href="glossaries-user.html#dx1-198021" >3146</a>, <a -href="glossaries-user.html#dx1-200014" >3147</a>, <a -href="glossaries-user.html#dx1-224013" >3148</a> <br /></span> +href="glossaries-user.html#dx1-3033" >3155</a>, <a +href="glossaries-user.html#dx1-5003" >3156</a>, <a +href="glossaries-user.html#dx1-6012" >3157</a>, <a +href="glossaries-user.html#dx1-57004" >3158</a>, <a +href="glossaries-user.html#dx1-74007" >3159</a>, <a +href="glossaries-user.html#dx1-74033" >3160</a>, <a +href="glossaries-user.html#dx1-88002" >3161</a>, <a +href="glossaries-user.html#dx1-113006" >3162</a>, <a +href="glossaries-user.html#dx1-113008" ><span +class="cmti-10">3163</span></a>, <a +href="glossaries-user.html#dx1-113138" >3164</a>, <a +href="glossaries-user.html#dx1-117002" >3165</a>, <a +href="glossaries-user.html#dx1-123002" >3166</a>, <a +href="glossaries-user.html#dx1-123006" >3167</a>, <a +href="glossaries-user.html#dx1-123031" >3168</a>, <a +href="glossaries-user.html#dx1-125001" >3169</a>, <a +href="glossaries-user.html#dx1-128001" >3170</a>, <a +href="glossaries-user.html#dx1-130015" >3171</a>, <a +href="glossaries-user.html#dx1-130052" >3172</a>, <a +href="glossaries-user.html#dx1-135017" >3173</a>, <a +href="glossaries-user.html#dx1-135019" >3174</a>, <a +href="glossaries-user.html#dx1-135026" >3175</a>, <a +href="glossaries-user.html#dx1-139008" >3176</a>, <a +href="glossaries-user.html#dx1-143001" >3177</a>, <a +href="glossaries-user.html#dx1-174002" >3178</a>, <a +href="glossaries-user.html#dx1-183001" >3179</a>, <a +href="glossaries-user.html#dx1-186019" >3180</a>, <a +href="glossaries-user.html#dx1-192013" >3181</a>, <a +href="glossaries-user.html#dx1-192029" >3182</a>, <a +href="glossaries-user.html#dx1-192045" >3183</a>, <a +href="glossaries-user.html#dx1-201021" >3184</a>, <a +href="glossaries-user.html#dx1-203014" >3185</a>, <a +href="glossaries-user.html#dx1-227013" >3186</a> <br /></span> <span class="index-item"><span class="cmtt-10">\newglossaryentry </span>options<br /></span> <span class="index-subitem">    <span class="cmtt-10">access</span>  <a -href="glossaries-user.html#dx1-172013" >3149</a>, <a -href="glossaries-user.html#dx1-224015" >3150</a> <br /></span> +href="glossaries-user.html#dx1-175013" >3187</a>, <a +href="glossaries-user.html#dx1-227015" >3188</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">alias</span>  <a -href="glossaries-user.html#dx1-11093" >3151</a>, <a -href="glossaries-user.html#dx1-12027" >3152</a>, <a -href="glossaries-user.html#dx1-112134" >3153</a>, <a -href="glossaries-user.html#dx1-179032" >3154</a> <br /></span> +href="glossaries-user.html#dx1-11093" >3189</a>, <a +href="glossaries-user.html#dx1-12029" >3190</a>, <a +href="glossaries-user.html#dx1-113154" >3191</a>, <a +href="glossaries-user.html#dx1-182032" >3192</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">category</span>  <a -href="glossaries-user.html#dx1-12013" >3155</a>, <a -href="glossaries-user.html#dx1-12017" >3156</a>, <a -href="glossaries-user.html#dx1-12021" >3157</a>, <a -href="glossaries-user.html#dx1-112136" >3158</a>, <a -href="glossaries-user.html#dx1-185001" >3159</a>, <a -href="glossaries-user.html#dx1-185003" >3160</a>, <a -href="glossaries-user.html#dx1-186008" >3161</a>, <a -href="glossaries-user.html#dx1-186009" >3162</a>, <a -href="glossaries-user.html#dx1-202020" >3163</a>, <a -href="glossaries-user.html#dx1-202030" >3164</a>, <a -href="glossaries-user.html#dx1-202090" >3165</a>, <a -href="glossaries-user.html#dx1-202092" >3166</a>, <a -href="glossaries-user.html#dx1-202096" >3167</a>, <a -href="glossaries-user.html#dx1-202098" >3168</a>, <a -href="glossaries-user.html#dx1-207002" >3169</a> <br /></span> +href="glossaries-user.html#dx1-12013" >3193</a>, <a +href="glossaries-user.html#dx1-12017" >3194</a>, <a +href="glossaries-user.html#dx1-12021" >3195</a>, <a +href="glossaries-user.html#dx1-113156" >3196</a>, <a +href="glossaries-user.html#dx1-188001" >3197</a>, <a +href="glossaries-user.html#dx1-188003" >3198</a>, <a +href="glossaries-user.html#dx1-189008" >3199</a>, <a +href="glossaries-user.html#dx1-189009" >3200</a>, <a +href="glossaries-user.html#dx1-205020" >3201</a>, <a +href="glossaries-user.html#dx1-205030" >3202</a>, <a +href="glossaries-user.html#dx1-205090" >3203</a>, <a +href="glossaries-user.html#dx1-205092" >3204</a>, <a +href="glossaries-user.html#dx1-205096" >3205</a>, <a +href="glossaries-user.html#dx1-205098" >3206</a>, <a +href="glossaries-user.html#dx1-210002" >3207</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">description</span>  <a -href="glossaries-user.html#dx1-12014" >3170</a>, <a -href="glossaries-user.html#dx1-112010" >3171</a>, <a -href="glossaries-user.html#dx1-112013" >3172</a>, <a -href="glossaries-user.html#dx1-112020" >3173</a>, <a -href="glossaries-user.html#dx1-112027" >3174</a>, <a -href="glossaries-user.html#dx1-112150" >3175</a>, <a -href="glossaries-user.html#dx1-117008" >3176</a>, <a -href="glossaries-user.html#dx1-118002" >3177</a>, <a -href="glossaries-user.html#dx1-118012" >3178</a>, <a -href="glossaries-user.html#dx1-134051" >3179</a>, <a -href="glossaries-user.html#dx1-147021" >3180</a>, <a -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-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 -href="glossaries-user.html#dx1-197015" >3190</a>, <a -href="glossaries-user.html#dx1-202068" >3191</a>, <a -href="glossaries-user.html#dx1-225002" >3192</a> <br /></span> +href="glossaries-user.html#dx1-12014" >3208</a>, <a +href="glossaries-user.html#dx1-113015" >3209</a>, <a +href="glossaries-user.html#dx1-113018" >3210</a>, <a +href="glossaries-user.html#dx1-113025" >3211</a>, <a +href="glossaries-user.html#dx1-113032" >3212</a>, <a +href="glossaries-user.html#dx1-113170" >3213</a>, <a +href="glossaries-user.html#dx1-118008" >3214</a>, <a +href="glossaries-user.html#dx1-119002" >3215</a>, <a +href="glossaries-user.html#dx1-119012" >3216</a>, <a +href="glossaries-user.html#dx1-131051" >3217</a>, <a +href="glossaries-user.html#dx1-135027" >3218</a>, <a +href="glossaries-user.html#dx1-138027" >3219</a>, <a +href="glossaries-user.html#dx1-138044" >3220</a>, <a +href="glossaries-user.html#dx1-138072" >3221</a>, <a +href="glossaries-user.html#dx1-139029" >3222</a>, <a +href="glossaries-user.html#dx1-172026" >3223</a>, <a +href="glossaries-user.html#dx1-172028" >3224</a>, <a +href="glossaries-user.html#dx1-175028" >3225</a>, <a +href="glossaries-user.html#dx1-182077" >3226</a>, <a +href="glossaries-user.html#dx1-200012" >3227</a>, <a +href="glossaries-user.html#dx1-200015" >3228</a>, <a +href="glossaries-user.html#dx1-205068" >3229</a>, <a +href="glossaries-user.html#dx1-228002" >3230</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">descriptionaccess</span>  <a -href="glossaries-user.html#dx1-172027" >3193</a> <br /></span> +href="glossaries-user.html#dx1-175027" >3231</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">descriptionplural</span>  <a -href="glossaries-user.html#dx1-112026" >3194</a>, <a -href="glossaries-user.html#dx1-118003" >3195</a>, <a -href="glossaries-user.html#dx1-118013" >3196</a>, <a -href="glossaries-user.html#dx1-172030" >3197</a> <br /></span> +href="glossaries-user.html#dx1-113031" >3232</a>, <a +href="glossaries-user.html#dx1-119003" >3233</a>, <a +href="glossaries-user.html#dx1-119013" >3234</a>, <a +href="glossaries-user.html#dx1-175030" >3235</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">descriptionpluralaccess</span>  <a -href="glossaries-user.html#dx1-172029" >3198</a> <br /></span> +href="glossaries-user.html#dx1-175029" >3236</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">entrycounter</span>  <a -href="glossaries-user.html#dx1-141037" >3199</a>, <a -href="glossaries-user.html#dx1-141039" >3200</a> <br /></span> +href="glossaries-user.html#dx1-144044" >3237</a>, <a +href="glossaries-user.html#dx1-144046" >3238</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">first</span>  <a -href="glossaries-user.html#dx1-3031" >3201</a>, <a -href="glossaries-user.html#dx1-112031" >3202</a>, <a -href="glossaries-user.html#dx1-112049" >3203</a>, <a -href="glossaries-user.html#dx1-112051" >3204</a>, <a -href="glossaries-user.html#dx1-112052" >3205</a>, <a -href="glossaries-user.html#dx1-112060" >3206</a>, <a -href="glossaries-user.html#dx1-112063" >3207</a>, <a -href="glossaries-user.html#dx1-112146" >3208</a>, <a -href="glossaries-user.html#dx1-132032" >3209</a>, <a -href="glossaries-user.html#dx1-133014" >3210</a>, <a -href="glossaries-user.html#dx1-134014" >3211</a>, <a -href="glossaries-user.html#dx1-134018" >3212</a>, <a -href="glossaries-user.html#dx1-134042" >3213</a>, <a -href="glossaries-user.html#dx1-135040" >3214</a>, <a -href="glossaries-user.html#dx1-135045" >3215</a>, <a -href="glossaries-user.html#dx1-135057" >3216</a>, <a -href="glossaries-user.html#dx1-135060" >3217</a>, <a -href="glossaries-user.html#dx1-140010" >3218</a>, <a -href="glossaries-user.html#dx1-140021" >3219</a>, <a -href="glossaries-user.html#dx1-147045" >3220</a>, <a -href="glossaries-user.html#dx1-148002" >3221</a>, <a -href="glossaries-user.html#dx1-153001" >3222</a>, <a -href="glossaries-user.html#dx1-170008" >3223</a>, <a -href="glossaries-user.html#dx1-171008" >3224</a>, <a -href="glossaries-user.html#dx1-172018" >3225</a>, <a -href="glossaries-user.html#dx1-172085" >3226</a>, <a -href="glossaries-user.html#dx1-180003" >3227</a>, <a -href="glossaries-user.html#dx1-224079" >3228</a> <br /></span> +href="glossaries-user.html#dx1-3031" >3239</a>, <a +href="glossaries-user.html#dx1-113004" >3240</a>, <a +href="glossaries-user.html#dx1-113037" >3241</a>, <a +href="glossaries-user.html#dx1-113045" >3242</a>, <a +href="glossaries-user.html#dx1-113048" >3243</a>, <a +href="glossaries-user.html#dx1-113059" >3244</a>, <a +href="glossaries-user.html#dx1-113061" >3245</a>, <a +href="glossaries-user.html#dx1-113062" >3246</a>, <a +href="glossaries-user.html#dx1-113073" >3247</a>, <a +href="glossaries-user.html#dx1-113076" >3248</a>, <a +href="glossaries-user.html#dx1-113166" >3249</a>, <a +href="glossaries-user.html#dx1-129030" >3250</a>, <a +href="glossaries-user.html#dx1-130014" >3251</a>, <a +href="glossaries-user.html#dx1-131014" >3252</a>, <a +href="glossaries-user.html#dx1-131018" >3253</a>, <a +href="glossaries-user.html#dx1-131042" >3254</a>, <a +href="glossaries-user.html#dx1-132040" >3255</a>, <a +href="glossaries-user.html#dx1-132045" >3256</a>, <a +href="glossaries-user.html#dx1-132057" >3257</a>, <a +href="glossaries-user.html#dx1-132060" >3258</a>, <a +href="glossaries-user.html#dx1-134010" >3259</a>, <a +href="glossaries-user.html#dx1-134021" >3260</a>, <a +href="glossaries-user.html#dx1-135046" >3261</a>, <a +href="glossaries-user.html#dx1-137005" >3262</a>, <a +href="glossaries-user.html#dx1-142001" >3263</a>, <a +href="glossaries-user.html#dx1-173008" >3264</a>, <a +href="glossaries-user.html#dx1-174008" >3265</a>, <a +href="glossaries-user.html#dx1-175018" >3266</a>, <a +href="glossaries-user.html#dx1-175085" >3267</a>, <a +href="glossaries-user.html#dx1-183003" >3268</a>, <a +href="glossaries-user.html#dx1-227079" >3269</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">firstaccess</span>  <a -href="glossaries-user.html#dx1-172017" >3229</a> <br /></span> +href="glossaries-user.html#dx1-175017" >3270</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">firstplural</span>  <a -href="glossaries-user.html#dx1-3032" >3230</a>, <a -href="glossaries-user.html#dx1-112039" >3231</a>, <a -href="glossaries-user.html#dx1-112046" >3232</a>, <a -href="glossaries-user.html#dx1-112057" >3233</a>, <a -href="glossaries-user.html#dx1-112059" >3234</a>, <a -href="glossaries-user.html#dx1-112062" >3235</a>, <a -href="glossaries-user.html#dx1-113005" >3236</a>, <a -href="glossaries-user.html#dx1-118011" >3237</a>, <a -href="glossaries-user.html#dx1-133051" >3238</a>, <a -href="glossaries-user.html#dx1-134019" >3239</a>, <a -href="glossaries-user.html#dx1-134034" >3240</a>, <a -href="glossaries-user.html#dx1-135048" >3241</a>, <a -href="glossaries-user.html#dx1-135058" >3242</a>, <a -href="glossaries-user.html#dx1-135062" >3243</a>, <a -href="glossaries-user.html#dx1-140024" >3244</a>, <a -href="glossaries-user.html#dx1-147028" >3245</a>, <a -href="glossaries-user.html#dx1-171011" >3246</a>, <a -href="glossaries-user.html#dx1-172022" >3247</a>, <a -href="glossaries-user.html#dx1-172084" >3248</a>, <a -href="glossaries-user.html#dx1-224080" >3249</a> <br /></span> +href="glossaries-user.html#dx1-3032" >3271</a>, <a +href="glossaries-user.html#dx1-113056" >3272</a>, <a +href="glossaries-user.html#dx1-113067" >3273</a>, <a +href="glossaries-user.html#dx1-113069" >3274</a>, <a +href="glossaries-user.html#dx1-113072" >3275</a>, <a +href="glossaries-user.html#dx1-113075" >3276</a>, <a +href="glossaries-user.html#dx1-114005" >3277</a>, <a +href="glossaries-user.html#dx1-119011" >3278</a>, <a +href="glossaries-user.html#dx1-130051" >3279</a>, <a +href="glossaries-user.html#dx1-131019" >3280</a>, <a +href="glossaries-user.html#dx1-131034" >3281</a>, <a +href="glossaries-user.html#dx1-132048" >3282</a>, <a +href="glossaries-user.html#dx1-132058" >3283</a>, <a +href="glossaries-user.html#dx1-132062" >3284</a>, <a +href="glossaries-user.html#dx1-134024" >3285</a>, <a +href="glossaries-user.html#dx1-174011" >3286</a>, <a +href="glossaries-user.html#dx1-175022" >3287</a>, <a +href="glossaries-user.html#dx1-175084" >3288</a>, <a +href="glossaries-user.html#dx1-227080" >3289</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">firstpluralaccess</span>  <a -href="glossaries-user.html#dx1-172021" >3250</a> <br /></span> +href="glossaries-user.html#dx1-175021" >3290</a> <br /></span> +<span class="index-subitem">    <span +class="cmtt-10">format</span>  <a +href="glossaries-user.html#dx1-146003" >3291</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">long</span>  <a -href="glossaries-user.html#dx1-34020" >3251</a>, <a -href="glossaries-user.html#dx1-112139" >3252</a>, <a -href="glossaries-user.html#dx1-112148" >3253</a>, <a -href="glossaries-user.html#dx1-117005" >3254</a>, <a -href="glossaries-user.html#dx1-132034" >3255</a>, <a -href="glossaries-user.html#dx1-133019" >3256</a>, <a -href="glossaries-user.html#dx1-135042" >3257</a>, <a -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-169017" >3262</a>, <a -href="glossaries-user.html#dx1-172032" >3263</a>, <a -href="glossaries-user.html#dx1-184072" >3264</a> <br /></span> +href="glossaries-user.html#dx1-34020" >3292</a>, <a +href="glossaries-user.html#dx1-113159" >3293</a>, <a +href="glossaries-user.html#dx1-113168" >3294</a>, <a +href="glossaries-user.html#dx1-118005" >3295</a>, <a +href="glossaries-user.html#dx1-129032" >3296</a>, <a +href="glossaries-user.html#dx1-130019" >3297</a>, <a +href="glossaries-user.html#dx1-132042" >3298</a>, <a +href="glossaries-user.html#dx1-132051" >3299</a>, <a +href="glossaries-user.html#dx1-135012" >3300</a>, <a +href="glossaries-user.html#dx1-136019" >3301</a>, <a +href="glossaries-user.html#dx1-137008" >3302</a>, <a +href="glossaries-user.html#dx1-172020" >3303</a>, <a +href="glossaries-user.html#dx1-175032" >3304</a>, <a +href="glossaries-user.html#dx1-187072" >3305</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longaccess</span>  <a -href="glossaries-user.html#dx1-172031" >3265</a> <br /></span> +href="glossaries-user.html#dx1-175031" >3306</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longplural</span>  <a -href="glossaries-user.html#dx1-15009" >3266</a>, <a -href="glossaries-user.html#dx1-112140" >3267</a>, <a -href="glossaries-user.html#dx1-118020" >3268</a>, <a -href="glossaries-user.html#dx1-133053" >3269</a>, <a -href="glossaries-user.html#dx1-135053" >3270</a>, <a -href="glossaries-user.html#dx1-147011" >3271</a>, <a -href="glossaries-user.html#dx1-147023" >3272</a>, <a -href="glossaries-user.html#dx1-147024" >3273</a>, <a -href="glossaries-user.html#dx1-147029" >3274</a>, <a -href="glossaries-user.html#dx1-147073" >3275</a>, <a -href="glossaries-user.html#dx1-172038" >3276</a> <br /></span> +href="glossaries-user.html#dx1-15009" >3307</a>, <a +href="glossaries-user.html#dx1-113071" >3308</a>, <a +href="glossaries-user.html#dx1-113160" >3309</a>, <a +href="glossaries-user.html#dx1-119020" >3310</a>, <a +href="glossaries-user.html#dx1-130053" >3311</a>, <a +href="glossaries-user.html#dx1-132053" >3312</a>, <a +href="glossaries-user.html#dx1-135013" >3313</a>, <a +href="glossaries-user.html#dx1-135029" >3314</a>, <a +href="glossaries-user.html#dx1-135030" >3315</a>, <a +href="glossaries-user.html#dx1-135034" >3316</a>, <a +href="glossaries-user.html#dx1-136026" >3317</a>, <a +href="glossaries-user.html#dx1-175038" >3318</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">longpluralaccess</span>  <a -href="glossaries-user.html#dx1-172037" >3277</a> <br /></span> +href="glossaries-user.html#dx1-175037" >3319</a> <br /></span> + + <span class="index-subitem">    <span class="cmtt-10">name</span>  <a -href="glossaries-user.html#dx1-6016" >3278</a>, <a -href="glossaries-user.html#dx1-8018" >3279</a>, <a -href="glossaries-user.html#dx1-9015" >3280</a>, <a -href="glossaries-user.html#dx1-11053" >3281</a>, <a -href="glossaries-user.html#dx1-11063" >3282</a>, <a -href="glossaries-user.html#dx1-11065" >3283</a>, <a -href="glossaries-user.html#dx1-12008" >3284</a>, <a -href="glossaries-user.html#dx1-12022" >3285</a>, <a -href="glossaries-user.html#dx1-12023" >3286</a>, <a -href="glossaries-user.html#dx1-16002" >3287</a>, <a -href="glossaries-user.html#dx1-73008" >3288</a>, <a -href="glossaries-user.html#dx1-73026" >3289</a>, <a -href="glossaries-user.html#dx1-73044" >3290</a>, <a -href="glossaries-user.html#dx1-112011" >3291</a>, <a -href="glossaries-user.html#dx1-112016" >3292</a>, <a -href="glossaries-user.html#dx1-112018" >3293</a>, <a -href="glossaries-user.html#dx1-112030" >3294</a>, <a -href="glossaries-user.html#dx1-112073" >3295</a>, <a -href="glossaries-user.html#dx1-112077" >3296</a>, <a -href="glossaries-user.html#dx1-112083" >3297</a>, <a -href="glossaries-user.html#dx1-112089" >3298</a>, <a -href="glossaries-user.html#dx1-112091" >3299</a>, <a -href="glossaries-user.html#dx1-112097" >3300</a>, <a -href="glossaries-user.html#dx1-118001" >3301</a>, <a -href="glossaries-user.html#dx1-121001" >3302</a>, <a -href="glossaries-user.html#dx1-133042" >3303</a>, <a -href="glossaries-user.html#dx1-133043" >3304</a>, <a -href="glossaries-user.html#dx1-134039" >3305</a>, <a -href="glossaries-user.html#dx1-140008" >3306</a>, <a -href="glossaries-user.html#dx1-148009" >3307</a>, <a -href="glossaries-user.html#dx1-149058" >3308</a>, <a -href="glossaries-user.html#dx1-149061" >3309</a>, <a -href="glossaries-user.html#dx1-149071" >3310</a>, <a -href="glossaries-user.html#dx1-149078" >3311</a>, <a -href="glossaries-user.html#dx1-149080" >3312</a>, <a -href="glossaries-user.html#dx1-149085" >3313</a>, <a -href="glossaries-user.html#dx1-150066" >3314</a>, <a -href="glossaries-user.html#dx1-166023" >3315</a>, <a -href="glossaries-user.html#dx1-170006" >3316</a>, <a -href="glossaries-user.html#dx1-172014" >3317</a>, <a -href="glossaries-user.html#dx1-172081" >3318</a>, <a -href="glossaries-user.html#dx1-179068" >3319</a>, <a -href="glossaries-user.html#dx1-184003" >3320</a>, <a -href="glossaries-user.html#dx1-184060" >3321</a>, <a -href="glossaries-user.html#dx1-188029" >3322</a>, <a -href="glossaries-user.html#dx1-189053" >3323</a>, <a -href="glossaries-user.html#dx1-192063" >3324</a>, <a -href="glossaries-user.html#dx1-200069" >3325</a>, <a -href="glossaries-user.html#dx1-200070" >3326</a>, <a -href="glossaries-user.html#dx1-202008" >3327</a>, <a -href="glossaries-user.html#dx1-202057" >3328</a>, <a -href="glossaries-user.html#dx1-202069" >3329</a>, <a -href="glossaries-user.html#dx1-202073" >3330</a>, <a -href="glossaries-user.html#dx1-202078" >3331</a>, <a -href="glossaries-user.html#dx1-202086" >3332</a>, <a -href="glossaries-user.html#dx1-210004" >3333</a>, <a -href="glossaries-user.html#dx1-216001" >3334</a>, <a -href="glossaries-user.html#dx1-224075" >3335</a>, <a -href="glossaries-user.html#dx1-224078" >3336</a>, <a -href="glossaries-user.html#dx1-139014" >3337</a>, <a -href="glossaries-user.html#dx1-140054" >3338</a> <br /></span> +href="glossaries-user.html#dx1-6016" >3320</a>, <a +href="glossaries-user.html#dx1-8018" >3321</a>, <a +href="glossaries-user.html#dx1-9015" >3322</a>, <a +href="glossaries-user.html#dx1-11053" >3323</a>, <a +href="glossaries-user.html#dx1-11063" >3324</a>, <a +href="glossaries-user.html#dx1-11065" >3325</a>, <a +href="glossaries-user.html#dx1-12008" >3326</a>, <a +href="glossaries-user.html#dx1-12022" >3327</a>, <a +href="glossaries-user.html#dx1-12023" >3328</a>, <a +href="glossaries-user.html#dx1-16002" >3329</a>, <a +href="glossaries-user.html#dx1-74008" >3330</a>, <a +href="glossaries-user.html#dx1-74026" >3331</a>, <a +href="glossaries-user.html#dx1-74044" >3332</a>, <a +href="glossaries-user.html#dx1-113016" >3333</a>, <a +href="glossaries-user.html#dx1-113021" >3334</a>, <a +href="glossaries-user.html#dx1-113023" >3335</a>, <a +href="glossaries-user.html#dx1-113035" >3336</a>, <a +href="glossaries-user.html#dx1-113086" >3337</a>, <a +href="glossaries-user.html#dx1-113090" >3338</a>, <a +href="glossaries-user.html#dx1-113096" >3339</a>, <a +href="glossaries-user.html#dx1-113102" >3340</a>, <a +href="glossaries-user.html#dx1-113104" >3341</a>, <a +href="glossaries-user.html#dx1-113110" >3342</a>, <a +href="glossaries-user.html#dx1-119001" >3343</a>, <a +href="glossaries-user.html#dx1-122001" >3344</a>, <a +href="glossaries-user.html#dx1-130042" >3345</a>, <a +href="glossaries-user.html#dx1-130043" >3346</a>, <a +href="glossaries-user.html#dx1-131039" >3347</a>, <a +href="glossaries-user.html#dx1-134008" >3348</a>, <a +href="glossaries-user.html#dx1-137012" >3349</a>, <a +href="glossaries-user.html#dx1-138058" >3350</a>, <a +href="glossaries-user.html#dx1-138061" >3351</a>, <a +href="glossaries-user.html#dx1-138071" >3352</a>, <a +href="glossaries-user.html#dx1-138078" >3353</a>, <a +href="glossaries-user.html#dx1-138080" >3354</a>, <a +href="glossaries-user.html#dx1-138085" >3355</a>, <a +href="glossaries-user.html#dx1-139066" >3356</a>, <a +href="glossaries-user.html#dx1-165024" >3357</a>, <a +href="glossaries-user.html#dx1-173006" >3358</a>, <a +href="glossaries-user.html#dx1-175014" >3359</a>, <a +href="glossaries-user.html#dx1-175081" >3360</a>, <a +href="glossaries-user.html#dx1-182068" >3361</a>, <a +href="glossaries-user.html#dx1-187003" >3362</a>, <a +href="glossaries-user.html#dx1-187060" >3363</a>, <a +href="glossaries-user.html#dx1-191029" >3364</a>, <a +href="glossaries-user.html#dx1-192053" >3365</a>, <a +href="glossaries-user.html#dx1-195063" >3366</a>, <a +href="glossaries-user.html#dx1-203069" >3367</a>, <a +href="glossaries-user.html#dx1-203070" >3368</a>, <a +href="glossaries-user.html#dx1-205008" >3369</a>, <a +href="glossaries-user.html#dx1-205057" >3370</a>, <a +href="glossaries-user.html#dx1-205069" >3371</a>, <a +href="glossaries-user.html#dx1-205073" >3372</a>, <a +href="glossaries-user.html#dx1-205078" >3373</a>, <a +href="glossaries-user.html#dx1-205086" >3374</a>, <a +href="glossaries-user.html#dx1-213004" >3375</a>, <a +href="glossaries-user.html#dx1-219001" >3376</a>, <a +href="glossaries-user.html#dx1-227075" >3377</a>, <a +href="glossaries-user.html#dx1-227078" >3378</a>, <a +href="glossaries-user.html#dx1-134054" >3379</a>, <a +href="glossaries-user.html#dx1-148014" >3380</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">nonumberlist</span>  <a -href="glossaries-user.html#dx1-112110" >3339</a> <br /></span> +href="glossaries-user.html#dx1-113123" >3381</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">parent</span>  <a -href="glossaries-user.html#dx1-112012" >3340</a>, <a -href="glossaries-user.html#dx1-112017" >3341</a>, <a -href="glossaries-user.html#dx1-112025" >3342</a>, <a -href="glossaries-user.html#dx1-120001" >3343</a> <br /></span> +href="glossaries-user.html#dx1-113017" >3382</a>, <a +href="glossaries-user.html#dx1-113022" >3383</a>, <a +href="glossaries-user.html#dx1-113030" >3384</a>, <a +href="glossaries-user.html#dx1-121001" >3385</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">plural</span>  <a -href="glossaries-user.html#dx1-15008" >3344</a>, <a -href="glossaries-user.html#dx1-112041" >3345</a>, <a -href="glossaries-user.html#dx1-112048" >3346</a>, <a -href="glossaries-user.html#dx1-112061" >3347</a>, <a -href="glossaries-user.html#dx1-113002" >3348</a>, <a -href="glossaries-user.html#dx1-113004" >3349</a>, <a -href="glossaries-user.html#dx1-121008" >3350</a>, <a -href="glossaries-user.html#dx1-133050" >3351</a>, <a -href="glossaries-user.html#dx1-134026" >3352</a>, <a -href="glossaries-user.html#dx1-134029" >3353</a>, <a -href="glossaries-user.html#dx1-135047" >3354</a>, <a -href="glossaries-user.html#dx1-135056" >3355</a>, <a -href="glossaries-user.html#dx1-140018" >3356</a>, <a -href="glossaries-user.html#dx1-147027" >3357</a>, <a -href="glossaries-user.html#dx1-170007" >3358</a>, <a -href="glossaries-user.html#dx1-171006" >3359</a>, <a -href="glossaries-user.html#dx1-172020" >3360</a>, <a -href="glossaries-user.html#dx1-172083" >3361</a>, <a -href="glossaries-user.html#dx1-200051" >3362</a>, <a -href="glossaries-user.html#dx1-200052" >3363</a>, <a -href="glossaries-user.html#dx1-202070" >3364</a>, <a -href="glossaries-user.html#dx1-202071" >3365</a>, <a -href="glossaries-user.html#dx1-224082" >3366</a> <br /></span> - - +href="glossaries-user.html#dx1-15008" >3386</a>, <a +href="glossaries-user.html#dx1-113005" >3387</a>, <a +href="glossaries-user.html#dx1-113049" >3388</a>, <a +href="glossaries-user.html#dx1-113054" >3389</a>, <a +href="glossaries-user.html#dx1-113058" >3390</a>, <a +href="glossaries-user.html#dx1-113074" >3391</a>, <a +href="glossaries-user.html#dx1-114002" >3392</a>, <a +href="glossaries-user.html#dx1-114004" >3393</a>, <a +href="glossaries-user.html#dx1-122008" >3394</a>, <a +href="glossaries-user.html#dx1-130050" >3395</a>, <a +href="glossaries-user.html#dx1-131026" >3396</a>, <a +href="glossaries-user.html#dx1-131029" >3397</a>, <a +href="glossaries-user.html#dx1-132047" >3398</a>, <a +href="glossaries-user.html#dx1-132056" >3399</a>, <a +href="glossaries-user.html#dx1-134018" >3400</a>, <a +href="glossaries-user.html#dx1-135033" >3401</a>, <a +href="glossaries-user.html#dx1-173007" >3402</a>, <a +href="glossaries-user.html#dx1-174006" >3403</a>, <a +href="glossaries-user.html#dx1-175020" >3404</a>, <a +href="glossaries-user.html#dx1-175083" >3405</a>, <a +href="glossaries-user.html#dx1-203051" >3406</a>, <a +href="glossaries-user.html#dx1-203052" >3407</a>, <a +href="glossaries-user.html#dx1-205070" >3408</a>, <a +href="glossaries-user.html#dx1-205071" >3409</a>, <a +href="glossaries-user.html#dx1-227082" >3410</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">pluralaccess</span>  <a -href="glossaries-user.html#dx1-172019" >3367</a> <br /></span> +href="glossaries-user.html#dx1-175019" >3411</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">prefix</span>  <a -href="glossaries-user.html#dx1-171003" >3368</a>, <a -href="glossaries-user.html#dx1-171009" >3369</a>, <a -href="glossaries-user.html#dx1-171022" >3370</a>, <a -href="glossaries-user.html#dx1-171025" >3371</a>, <a -href="glossaries-user.html#dx1-171042" >3372</a>, <a -href="glossaries-user.html#dx1-171049" >3373</a>, <a -href="glossaries-user.html#dx1-194015" >3374</a>, <a -href="glossaries-user.html#dx1-194018" >3375</a>, <a -href="glossaries-user.html#dx1-171016" >3376</a> <br /></span> +href="glossaries-user.html#dx1-174003" >3412</a>, <a +href="glossaries-user.html#dx1-174009" >3413</a>, <a +href="glossaries-user.html#dx1-174022" >3414</a>, <a +href="glossaries-user.html#dx1-174025" >3415</a>, <a +href="glossaries-user.html#dx1-174042" >3416</a>, <a +href="glossaries-user.html#dx1-174049" >3417</a>, <a +href="glossaries-user.html#dx1-197015" >3418</a>, <a +href="glossaries-user.html#dx1-197018" >3419</a>, <a +href="glossaries-user.html#dx1-174016" >3420</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">prefixfirst</span>  <a -href="glossaries-user.html#dx1-171007" >3377</a>, <a -href="glossaries-user.html#dx1-171023" >3378</a>, <a -href="glossaries-user.html#dx1-171026" >3379</a>, <a -href="glossaries-user.html#dx1-171046" >3380</a>, <a -href="glossaries-user.html#dx1-171051" >3381</a> <br /></span> +href="glossaries-user.html#dx1-174007" >3421</a>, <a +href="glossaries-user.html#dx1-174023" >3422</a>, <a +href="glossaries-user.html#dx1-174026" >3423</a>, <a +href="glossaries-user.html#dx1-174046" >3424</a>, <a +href="glossaries-user.html#dx1-174051" >3425</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">prefixfirstplural</span>  <a -href="glossaries-user.html#dx1-171010" >3382</a>, <a -href="glossaries-user.html#dx1-171032" >3383</a>, <a -href="glossaries-user.html#dx1-171035" >3384</a>, <a -href="glossaries-user.html#dx1-171055" >3385</a> <br /></span> +href="glossaries-user.html#dx1-174010" >3426</a>, <a +href="glossaries-user.html#dx1-174032" >3427</a>, <a +href="glossaries-user.html#dx1-174035" >3428</a>, <a +href="glossaries-user.html#dx1-174055" >3429</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">prefixplural</span>  <a -href="glossaries-user.html#dx1-171005" >3386</a>, <a -href="glossaries-user.html#dx1-171012" >3387</a>, <a -href="glossaries-user.html#dx1-171031" >3388</a>, <a -href="glossaries-user.html#dx1-171034" >3389</a>, <a -href="glossaries-user.html#dx1-171044" >3390</a>, <a -href="glossaries-user.html#dx1-171053" >3391</a>, <a -href="glossaries-user.html#dx1-194016" >3392</a>, <a -href="glossaries-user.html#dx1-194019" >3393</a> <br /></span> +href="glossaries-user.html#dx1-174005" >3430</a>, <a +href="glossaries-user.html#dx1-174012" >3431</a>, <a +href="glossaries-user.html#dx1-174031" >3432</a>, <a +href="glossaries-user.html#dx1-174034" >3433</a>, <a +href="glossaries-user.html#dx1-174044" >3434</a>, <a +href="glossaries-user.html#dx1-174053" >3435</a>, <a +href="glossaries-user.html#dx1-197016" >3436</a>, <a +href="glossaries-user.html#dx1-197019" >3437</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">see</span>  <a -href="glossaries-user.html#dx1-12026" >3394</a>, <a -href="glossaries-user.html#dx1-30018" >3395</a>, <a -href="glossaries-user.html#dx1-56003" >3396</a>, <a -href="glossaries-user.html#dx1-56007" >3397</a>, <a -href="glossaries-user.html#dx1-62001" >3398</a>, <a -href="glossaries-user.html#dx1-62002" >3399</a>, <a -href="glossaries-user.html#dx1-66001" >3400</a>, <a -href="glossaries-user.html#dx1-112115" >3401</a>, <a -href="glossaries-user.html#dx1-112116" >3402</a>, <a -href="glossaries-user.html#dx1-112123" >3403</a>, <a -href="glossaries-user.html#dx1-112127" >3404</a>, <a -href="glossaries-user.html#dx1-112128" >3405</a>, <a -href="glossaries-user.html#dx1-112129" >3406</a>, <a -href="glossaries-user.html#dx1-112131" >3407</a>, <a -href="glossaries-user.html#dx1-125016" >3408</a>, <a -href="glossaries-user.html#dx1-138009" >3409</a>, <a -href="glossaries-user.html#dx1-138010" >3410</a>, <a -href="glossaries-user.html#dx1-138012" >3411</a>, <a -href="glossaries-user.html#dx1-138023" >3412</a>, <a -href="glossaries-user.html#dx1-139001" >3413</a>, <a -href="glossaries-user.html#dx1-179022" >3414</a>, <a -href="glossaries-user.html#dx1-179033" >3415</a>, <a -href="glossaries-user.html#dx1-204002" >3416</a>, <a -href="glossaries-user.html#dx1-204003" >3417</a>, <a -href="glossaries-user.html#dx1-204009" >3418</a>, <a -href="glossaries-user.html#dx1-204012" >3419</a>, <a -href="glossaries-user.html#dx1-204030" >3420</a>, <a -href="glossaries-user.html#dx1-4003" >3421</a>, <a -href="glossaries-user.html#dx1-139007" >3422</a> <br /></span> +href="glossaries-user.html#dx1-12028" >3438</a>, <a +href="glossaries-user.html#dx1-30018" >3439</a>, <a +href="glossaries-user.html#dx1-57003" >3440</a>, <a +href="glossaries-user.html#dx1-57007" >3441</a>, <a +href="glossaries-user.html#dx1-63001" >3442</a>, <a +href="glossaries-user.html#dx1-63003" >3443</a>, <a +href="glossaries-user.html#dx1-67001" >3444</a>, <a +href="glossaries-user.html#dx1-113128" >3445</a>, <a +href="glossaries-user.html#dx1-113130" >3446</a>, <a +href="glossaries-user.html#dx1-113139" >3447</a>, <a +href="glossaries-user.html#dx1-113143" >3448</a>, <a +href="glossaries-user.html#dx1-113144" >3449</a>, <a +href="glossaries-user.html#dx1-113145" >3450</a>, <a +href="glossaries-user.html#dx1-113147" >3451</a>, <a +href="glossaries-user.html#dx1-113151" >3452</a>, <a +href="glossaries-user.html#dx1-147012" >3453</a>, <a +href="glossaries-user.html#dx1-147013" >3454</a>, <a +href="glossaries-user.html#dx1-147015" >3455</a>, <a +href="glossaries-user.html#dx1-147026" >3456</a>, <a +href="glossaries-user.html#dx1-148001" >3457</a>, <a +href="glossaries-user.html#dx1-182022" >3458</a>, <a +href="glossaries-user.html#dx1-182033" >3459</a>, <a +href="glossaries-user.html#dx1-207002" >3460</a>, <a +href="glossaries-user.html#dx1-207003" >3461</a>, <a +href="glossaries-user.html#dx1-207009" >3462</a>, <a +href="glossaries-user.html#dx1-207012" >3463</a>, <a +href="glossaries-user.html#dx1-207030" >3464</a>, <a +href="glossaries-user.html#dx1-4003" >3465</a>, <a +href="glossaries-user.html#dx1-148007" >3466</a> <br /></span> <span class="index-subitem">    <sup class="textsuperscript"><span class="tcrm-0900">†</span></sup><span class="cmtt-10">seealso</span>  <a -href="glossaries-user.html#dx1-12028" >3423</a>, <a -href="glossaries-user.html#dx1-66002" >3424</a>, <a -href="glossaries-user.html#dx1-112130" >3425</a>, <a -href="glossaries-user.html#dx1-179031" >3426</a>, <a -href="glossaries-user.html#dx1-179035" >3427</a>, <a -href="glossaries-user.html#dx1-182029" >3428</a>, <a -href="glossaries-user.html#dx1-182030" >3429</a>, <a -href="glossaries-user.html#dx1-204010" >3430</a>, <a -href="glossaries-user.html#dx1-204013" >3431</a>, <a -href="glossaries-user.html#dx1-204032" >3432</a> <br /></span> +href="glossaries-user.html#dx1-12030" >3467</a>, <a +href="glossaries-user.html#dx1-67002" >3468</a>, <a +href="glossaries-user.html#dx1-113148" >3469</a>, <a +href="glossaries-user.html#dx1-113150" >3470</a>, <a +href="glossaries-user.html#dx1-182031" >3471</a>, <a +href="glossaries-user.html#dx1-182035" >3472</a>, <a +href="glossaries-user.html#dx1-185029" >3473</a>, <a +href="glossaries-user.html#dx1-185030" >3474</a>, <a +href="glossaries-user.html#dx1-207010" >3475</a>, <a +href="glossaries-user.html#dx1-207013" >3476</a>, <a +href="glossaries-user.html#dx1-207032" >3477</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">short</span>  <a -href="glossaries-user.html#dx1-9016" >3433</a>, <a -href="glossaries-user.html#dx1-112141" >3434</a>, <a -href="glossaries-user.html#dx1-112147" >3435</a>, <a -href="glossaries-user.html#dx1-132033" >3436</a>, <a -href="glossaries-user.html#dx1-133020" >3437</a>, <a -href="glossaries-user.html#dx1-135043" >3438</a>, <a -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-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 -href="glossaries-user.html#dx1-192022" >3447</a>, <a -href="glossaries-user.html#dx1-193031" >3448</a> <br /></span> +href="glossaries-user.html#dx1-9016" >3478</a>, <a +href="glossaries-user.html#dx1-113161" >3479</a>, <a +href="glossaries-user.html#dx1-113167" >3480</a>, <a +href="glossaries-user.html#dx1-129031" >3481</a>, <a +href="glossaries-user.html#dx1-130020" >3482</a>, <a +href="glossaries-user.html#dx1-132043" >3483</a>, <a +href="glossaries-user.html#dx1-132052" >3484</a>, <a +href="glossaries-user.html#dx1-135014" >3485</a>, <a +href="glossaries-user.html#dx1-136008" >3486</a>, <a +href="glossaries-user.html#dx1-137009" >3487</a>, <a +href="glossaries-user.html#dx1-172023" >3488</a>, <a +href="glossaries-user.html#dx1-175035" >3489</a>, <a +href="glossaries-user.html#dx1-175068" >3490</a>, <a +href="glossaries-user.html#dx1-182067" >3491</a>, <a +href="glossaries-user.html#dx1-195022" >3492</a>, <a +href="glossaries-user.html#dx1-196031" >3493</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">shortaccess</span>  <a -href="glossaries-user.html#dx1-172034" >3449</a>, <a -href="glossaries-user.html#dx1-172062" >3450</a>, <a -href="glossaries-user.html#dx1-224011" >3451</a>, <a -href="glossaries-user.html#dx1-224012" >3452</a>, <a -href="glossaries-user.html#dx1-224021" >3453</a>, <a -href="glossaries-user.html#dx1-224049" >3454</a>, <a -href="glossaries-user.html#dx1-224054" >3455</a> <br /></span> +href="glossaries-user.html#dx1-175034" >3494</a>, <a +href="glossaries-user.html#dx1-175062" >3495</a>, <a +href="glossaries-user.html#dx1-227011" >3496</a>, <a +href="glossaries-user.html#dx1-227012" >3497</a>, <a +href="glossaries-user.html#dx1-227021" >3498</a>, <a +href="glossaries-user.html#dx1-227049" >3499</a>, <a +href="glossaries-user.html#dx1-227054" >3500</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">shortplural</span>  <a -href="glossaries-user.html#dx1-15010" >3456</a>, <a -href="glossaries-user.html#dx1-112142" >3457</a>, <a -href="glossaries-user.html#dx1-118021" >3458</a>, <a -href="glossaries-user.html#dx1-133054" >3459</a>, <a -href="glossaries-user.html#dx1-135054" >3460</a>, <a -href="glossaries-user.html#dx1-147013" >3461</a>, <a -href="glossaries-user.html#dx1-147022" >3462</a>, <a -href="glossaries-user.html#dx1-147025" >3463</a>, <a -href="glossaries-user.html#dx1-147031" >3464</a>, <a -href="glossaries-user.html#dx1-147034" >3465</a>, <a -href="glossaries-user.html#dx1-147062" >3466</a>, <a -href="glossaries-user.html#dx1-172041" >3467</a>, <a -href="glossaries-user.html#dx1-172069" >3468</a> <br /></span> +href="glossaries-user.html#dx1-15010" >3501</a>, <a +href="glossaries-user.html#dx1-113055" >3502</a>, <a +href="glossaries-user.html#dx1-113070" >3503</a>, <a +href="glossaries-user.html#dx1-113162" >3504</a>, <a +href="glossaries-user.html#dx1-119021" >3505</a>, <a +href="glossaries-user.html#dx1-130054" >3506</a>, <a +href="glossaries-user.html#dx1-132054" >3507</a>, <a +href="glossaries-user.html#dx1-135015" >3508</a>, <a +href="glossaries-user.html#dx1-135028" >3509</a>, <a +href="glossaries-user.html#dx1-135031" >3510</a>, <a +href="glossaries-user.html#dx1-135036" >3511</a>, <a +href="glossaries-user.html#dx1-135039" >3512</a>, <a +href="glossaries-user.html#dx1-136015" >3513</a>, <a +href="glossaries-user.html#dx1-175041" >3514</a>, <a +href="glossaries-user.html#dx1-175069" >3515</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">shortpluralaccess</span>  <a -href="glossaries-user.html#dx1-172040" >3469</a> <br /></span> +href="glossaries-user.html#dx1-175040" >3516</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">sort</span>  <a -href="glossaries-user.html#dx1-3062" >3470</a>, <a -href="glossaries-user.html#dx1-6011" >3471</a>, <a -href="glossaries-user.html#dx1-6015" >3472</a>, <a -href="glossaries-user.html#dx1-8014" >3473</a>, <a -href="glossaries-user.html#dx1-8017" >3474</a>, <a -href="glossaries-user.html#dx1-9011" >3475</a>, <a -href="glossaries-user.html#dx1-9017" >3476</a>, <a -href="glossaries-user.html#dx1-13045" >3477</a>, <a -href="glossaries-user.html#dx1-16001" >3478</a>, <a -href="glossaries-user.html#dx1-73006" >3479</a>, <a -href="glossaries-user.html#dx1-73009" >3480</a>, <a -href="glossaries-user.html#dx1-73011" >3481</a>, <a -href="glossaries-user.html#dx1-73013" >3482</a>, <a -href="glossaries-user.html#dx1-73025" >3483</a>, <a -href="glossaries-user.html#dx1-112019" >3484</a>, <a -href="glossaries-user.html#dx1-112072" >3485</a>, <a -href="glossaries-user.html#dx1-112076" >3486</a>, <a -href="glossaries-user.html#dx1-112078" >3487</a>, <a -href="glossaries-user.html#dx1-112080" >3488</a>, <a -href="glossaries-user.html#dx1-112084" >3489</a>, <a -href="glossaries-user.html#dx1-112088" >3490</a>, <a -href="glossaries-user.html#dx1-112094" >3491</a>, <a -href="glossaries-user.html#dx1-112096" >3492</a>, <a -href="glossaries-user.html#dx1-112098" >3493</a>, <a -href="glossaries-user.html#dx1-112157" >3494</a>, <a -href="glossaries-user.html#dx1-118006" >3495</a>, <a -href="glossaries-user.html#dx1-118010" >3496</a>, <a -href="glossaries-user.html#dx1-121004" >3497</a>, <a -href="glossaries-user.html#dx1-125010" >3498</a>, <a -href="glossaries-user.html#dx1-133030" >3499</a>, <a -href="glossaries-user.html#dx1-141056" >3500</a>, <a -href="glossaries-user.html#dx1-148011" >3501</a>, <a -href="glossaries-user.html#dx1-149059" >3502</a>, <a -href="glossaries-user.html#dx1-149062" >3503</a>, <a -href="glossaries-user.html#dx1-149070" >3504</a>, <a -href="glossaries-user.html#dx1-149079" >3505</a>, <a -href="glossaries-user.html#dx1-149086" >3506</a>, <a -href="glossaries-user.html#dx1-166022" >3507</a>, <a -href="glossaries-user.html#dx1-166024" >3508</a>, <a -href="glossaries-user.html#dx1-179064" >3509</a>, <a -href="glossaries-user.html#dx1-182001" >3510</a>, <a -href="glossaries-user.html#dx1-184001" >3511</a>, <a -href="glossaries-user.html#dx1-184068" >3512</a>, <a -href="glossaries-user.html#dx1-188010" >3513</a>, <a -href="glossaries-user.html#dx1-188025" >3514</a>, <a -href="glossaries-user.html#dx1-188031" >3515</a>, <a -href="glossaries-user.html#dx1-192061" >3516</a>, <a -href="glossaries-user.html#dx1-194011" >3517</a>, <a -href="glossaries-user.html#dx1-197001" >3518</a>, <a -href="glossaries-user.html#dx1-197004" >3519</a>, <a -href="glossaries-user.html#dx1-200007" >3520</a>, <a -href="glossaries-user.html#dx1-200012" >3521</a>, <a -href="glossaries-user.html#dx1-200063" >3522</a>, <a -href="glossaries-user.html#dx1-200066" >3523</a>, <a -href="glossaries-user.html#dx1-200078" >3524</a>, <a -href="glossaries-user.html#dx1-200083" >3525</a>, <a -href="glossaries-user.html#dx1-200089" >3526</a>, <a -href="glossaries-user.html#dx1-202087" >3527</a>, <a -href="glossaries-user.html#dx1-202088" >3528</a>, <a -href="glossaries-user.html#dx1-210005" >3529</a>, <a -href="glossaries-user.html#dx1-211034" >3530</a>, <a -href="glossaries-user.html#dx1-211070" >3531</a> <br /></span> +href="glossaries-user.html#dx1-3062" >3517</a>, <a +href="glossaries-user.html#dx1-6011" >3518</a>, <a +href="glossaries-user.html#dx1-6015" >3519</a>, <a +href="glossaries-user.html#dx1-8014" >3520</a>, <a +href="glossaries-user.html#dx1-8017" >3521</a>, <a +href="glossaries-user.html#dx1-9011" >3522</a>, <a +href="glossaries-user.html#dx1-9017" >3523</a>, <a +href="glossaries-user.html#dx1-13045" >3524</a>, <a +href="glossaries-user.html#dx1-16001" >3525</a>, <a +href="glossaries-user.html#dx1-74006" >3526</a>, <a +href="glossaries-user.html#dx1-74009" >3527</a>, <a +href="glossaries-user.html#dx1-74011" >3528</a>, <a +href="glossaries-user.html#dx1-74013" >3529</a>, <a +href="glossaries-user.html#dx1-74025" >3530</a>, <a +href="glossaries-user.html#dx1-113024" >3531</a>, <a +href="glossaries-user.html#dx1-113085" >3532</a>, <a +href="glossaries-user.html#dx1-113089" >3533</a>, <a +href="glossaries-user.html#dx1-113091" >3534</a>, <a +href="glossaries-user.html#dx1-113093" >3535</a>, <a +href="glossaries-user.html#dx1-113097" >3536</a>, <a +href="glossaries-user.html#dx1-113101" >3537</a>, <a +href="glossaries-user.html#dx1-113107" >3538</a>, <a +href="glossaries-user.html#dx1-113109" >3539</a>, <a +href="glossaries-user.html#dx1-113111" >3540</a>, <a +href="glossaries-user.html#dx1-113176" >3541</a>, <a +href="glossaries-user.html#dx1-119006" >3542</a>, <a +href="glossaries-user.html#dx1-119010" >3543</a>, <a +href="glossaries-user.html#dx1-122004" >3544</a>, <a +href="glossaries-user.html#dx1-126012" >3545</a>, <a +href="glossaries-user.html#dx1-130030" >3546</a>, <a +href="glossaries-user.html#dx1-137014" >3547</a>, <a +href="glossaries-user.html#dx1-138059" >3548</a>, <a +href="glossaries-user.html#dx1-138062" >3549</a>, <a +href="glossaries-user.html#dx1-138070" >3550</a>, <a +href="glossaries-user.html#dx1-138079" >3551</a>, <a +href="glossaries-user.html#dx1-138086" >3552</a>, <a +href="glossaries-user.html#dx1-144063" >3553</a>, <a +href="glossaries-user.html#dx1-165023" >3554</a>, <a +href="glossaries-user.html#dx1-165025" >3555</a>, <a +href="glossaries-user.html#dx1-182064" >3556</a>, <a +href="glossaries-user.html#dx1-185001" >3557</a>, <a +href="glossaries-user.html#dx1-187001" >3558</a>, <a +href="glossaries-user.html#dx1-187068" >3559</a>, <a +href="glossaries-user.html#dx1-191010" >3560</a>, <a +href="glossaries-user.html#dx1-191025" >3561</a>, <a +href="glossaries-user.html#dx1-191031" >3562</a>, <a +href="glossaries-user.html#dx1-195061" >3563</a>, <a +href="glossaries-user.html#dx1-197011" >3564</a>, <a +href="glossaries-user.html#dx1-200001" >3565</a>, <a +href="glossaries-user.html#dx1-200004" >3566</a>, <a +href="glossaries-user.html#dx1-203007" >3567</a>, <a +href="glossaries-user.html#dx1-203012" >3568</a>, <a +href="glossaries-user.html#dx1-203063" >3569</a>, <a +href="glossaries-user.html#dx1-203066" >3570</a>, <a +href="glossaries-user.html#dx1-203078" >3571</a>, <a +href="glossaries-user.html#dx1-203083" >3572</a>, <a +href="glossaries-user.html#dx1-203089" >3573</a>, <a +href="glossaries-user.html#dx1-205087" >3574</a>, <a +href="glossaries-user.html#dx1-205088" >3575</a>, <a +href="glossaries-user.html#dx1-213005" >3576</a>, <a +href="glossaries-user.html#dx1-214034" >3577</a>, <a +href="glossaries-user.html#dx1-214070" >3578</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">subentrycounter</span>  <a -href="glossaries-user.html#dx1-141038" >3532</a> <br /></span> +href="glossaries-user.html#dx1-144045" >3579</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">symbol</span>  <a -href="glossaries-user.html#dx1-11051" >3533</a>, <a -href="glossaries-user.html#dx1-12006" >3534</a>, <a -href="glossaries-user.html#dx1-12007" >3535</a>, <a -href="glossaries-user.html#dx1-112064" >3536</a>, <a -href="glossaries-user.html#dx1-112071" >3537</a>, <a -href="glossaries-user.html#dx1-112149" >3538</a>, <a -href="glossaries-user.html#dx1-118004" >3539</a>, <a -href="glossaries-user.html#dx1-132035" >3540</a>, <a -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-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 -href="glossaries-user.html#dx1-189043" >3549</a>, <a -href="glossaries-user.html#dx1-189046" >3550</a>, <a -href="glossaries-user.html#dx1-189049" >3551</a>, <a -href="glossaries-user.html#dx1-224076" >3552</a> <br /></span> +href="glossaries-user.html#dx1-11051" >3580</a>, <a +href="glossaries-user.html#dx1-12006" >3581</a>, <a +href="glossaries-user.html#dx1-12007" >3582</a>, <a +href="glossaries-user.html#dx1-113077" >3583</a>, <a +href="glossaries-user.html#dx1-113084" >3584</a>, <a +href="glossaries-user.html#dx1-113169" >3585</a>, <a +href="glossaries-user.html#dx1-119004" >3586</a>, <a +href="glossaries-user.html#dx1-129033" >3587</a>, <a +href="glossaries-user.html#dx1-131046" >3588</a>, <a +href="glossaries-user.html#dx1-132077" >3589</a>, <a +href="glossaries-user.html#dx1-132086" >3590</a>, <a +href="glossaries-user.html#dx1-139065" >3591</a>, <a +href="glossaries-user.html#dx1-172018" >3592</a>, <a +href="glossaries-user.html#dx1-175024" >3593</a>, <a +href="glossaries-user.html#dx1-192028" >3594</a>, <a +href="glossaries-user.html#dx1-192037" >3595</a>, <a +href="glossaries-user.html#dx1-192043" >3596</a>, <a +href="glossaries-user.html#dx1-192046" >3597</a>, <a +href="glossaries-user.html#dx1-192049" >3598</a>, <a +href="glossaries-user.html#dx1-227076" >3599</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">symbolaccess</span>  <a -href="glossaries-user.html#dx1-172023" >3553</a>, <a -href="glossaries-user.html#dx1-224023" >3554</a> <br /></span> +href="glossaries-user.html#dx1-175023" >3600</a>, <a +href="glossaries-user.html#dx1-227023" >3601</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">symbolplural</span>  <a -href="glossaries-user.html#dx1-112065" >3555</a>, <a -href="glossaries-user.html#dx1-118005" >3556</a>, <a -href="glossaries-user.html#dx1-172026" >3557</a> <br /></span> +href="glossaries-user.html#dx1-113078" >3602</a>, <a +href="glossaries-user.html#dx1-119005" >3603</a>, <a +href="glossaries-user.html#dx1-175026" >3604</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">symbolpluralaccess</span>  <a -href="glossaries-user.html#dx1-172025" >3558</a> <br /></span> +href="glossaries-user.html#dx1-175025" >3605</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">text</span>  <a -href="glossaries-user.html#dx1-11064" >3559</a>, <a -href="glossaries-user.html#dx1-11066" >3560</a>, <a -href="glossaries-user.html#dx1-11086" >3561</a>, <a -href="glossaries-user.html#dx1-112028" >3562</a>, <a -href="glossaries-user.html#dx1-112033" >3563</a>, <a -href="glossaries-user.html#dx1-112044" >3564</a>, <a -href="glossaries-user.html#dx1-112145" >3565</a>, <a -href="glossaries-user.html#dx1-132031" >3566</a>, <a -href="glossaries-user.html#dx1-133013" >3567</a>, <a -href="glossaries-user.html#dx1-133041" >3568</a>, <a -href="glossaries-user.html#dx1-134008" >3569</a>, <a -href="glossaries-user.html#dx1-134025" >3570</a>, <a -href="glossaries-user.html#dx1-134041" >3571</a>, <a -href="glossaries-user.html#dx1-135041" >3572</a>, <a -href="glossaries-user.html#dx1-135046" >3573</a>, <a -href="glossaries-user.html#dx1-135055" >3574</a>, <a -href="glossaries-user.html#dx1-140009" >3575</a>, <a -href="glossaries-user.html#dx1-140015" >3576</a>, <a -href="glossaries-user.html#dx1-147044" >3577</a>, <a -href="glossaries-user.html#dx1-148003" >3578</a>, <a -href="glossaries-user.html#dx1-153002" >3579</a>, <a -href="glossaries-user.html#dx1-170005" >3580</a>, <a -href="glossaries-user.html#dx1-171004" >3581</a>, <a -href="glossaries-user.html#dx1-172016" >3582</a>, <a -href="glossaries-user.html#dx1-172082" >3583</a>, <a -href="glossaries-user.html#dx1-180004" >3584</a>, <a -href="glossaries-user.html#dx1-189052" >3585</a>, <a -href="glossaries-user.html#dx1-192024" >3586</a>, <a -href="glossaries-user.html#dx1-193032" >3587</a>, <a -href="glossaries-user.html#dx1-202072" >3588</a>, <a -href="glossaries-user.html#dx1-206002" >3589</a>, <a -href="glossaries-user.html#dx1-206003" >3590</a>, <a -href="glossaries-user.html#dx1-206004" >3591</a>, <a -href="glossaries-user.html#dx1-224081" >3592</a> <br /></span> +href="glossaries-user.html#dx1-11064" >3606</a>, <a +href="glossaries-user.html#dx1-11066" >3607</a>, <a +href="glossaries-user.html#dx1-11086" >3608</a>, <a +href="glossaries-user.html#dx1-113033" >3609</a>, <a +href="glossaries-user.html#dx1-113036" >3610</a>, <a +href="glossaries-user.html#dx1-113039" >3611</a>, <a +href="glossaries-user.html#dx1-113052" >3612</a>, <a +href="glossaries-user.html#dx1-113165" >3613</a>, <a +href="glossaries-user.html#dx1-129029" >3614</a>, <a +href="glossaries-user.html#dx1-130013" >3615</a>, <a +href="glossaries-user.html#dx1-130041" >3616</a>, <a +href="glossaries-user.html#dx1-131008" >3617</a>, <a +href="glossaries-user.html#dx1-131025" >3618</a>, <a +href="glossaries-user.html#dx1-131041" >3619</a>, <a +href="glossaries-user.html#dx1-132041" >3620</a>, <a +href="glossaries-user.html#dx1-132046" >3621</a>, <a +href="glossaries-user.html#dx1-132055" >3622</a>, <a +href="glossaries-user.html#dx1-134009" >3623</a>, <a +href="glossaries-user.html#dx1-134015" >3624</a>, <a +href="glossaries-user.html#dx1-135045" >3625</a>, <a +href="glossaries-user.html#dx1-137006" >3626</a>, <a +href="glossaries-user.html#dx1-142002" >3627</a>, <a +href="glossaries-user.html#dx1-173005" >3628</a>, <a +href="glossaries-user.html#dx1-174004" >3629</a>, <a +href="glossaries-user.html#dx1-175016" >3630</a>, <a +href="glossaries-user.html#dx1-175082" >3631</a>, <a +href="glossaries-user.html#dx1-183004" >3632</a>, <a +href="glossaries-user.html#dx1-192052" >3633</a>, <a +href="glossaries-user.html#dx1-195024" >3634</a>, <a +href="glossaries-user.html#dx1-196032" >3635</a>, <a +href="glossaries-user.html#dx1-205072" >3636</a>, <a +href="glossaries-user.html#dx1-209002" >3637</a>, <a +href="glossaries-user.html#dx1-209003" >3638</a>, <a +href="glossaries-user.html#dx1-209004" >3639</a>, <a +href="glossaries-user.html#dx1-227081" >3640</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">textaccess</span>  <a -href="glossaries-user.html#dx1-172015" >3593</a> <br /></span> +href="glossaries-user.html#dx1-175015" >3641</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">type</span>  <a -href="glossaries-user.html#dx1-7031" >3594</a>, <a -href="glossaries-user.html#dx1-8034" >3595</a>, <a -href="glossaries-user.html#dx1-112100" >3596</a>, <a -href="glossaries-user.html#dx1-122004" >3597</a>, <a -href="glossaries-user.html#dx1-147009" >3598</a>, <a -href="glossaries-user.html#dx1-192043" >3599</a>, <a -href="glossaries-user.html#dx1-192045" >3600</a>, <a -href="glossaries-user.html#dx1-192048" >3601</a>, <a -href="glossaries-user.html#dx1-198029" >3602</a> <br /></span> +href="glossaries-user.html#dx1-7031" >3642</a>, <a +href="glossaries-user.html#dx1-8034" >3643</a>, <a +href="glossaries-user.html#dx1-113113" >3644</a>, <a +href="glossaries-user.html#dx1-123004" >3645</a>, <a +href="glossaries-user.html#dx1-135011" >3646</a>, <a +href="glossaries-user.html#dx1-195043" >3647</a>, <a +href="glossaries-user.html#dx1-195045" >3648</a>, <a +href="glossaries-user.html#dx1-195048" >3649</a>, <a +href="glossaries-user.html#dx1-201029" >3650</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user1</span>  <a -href="glossaries-user.html#dx1-12009" >3603</a>, <a -href="glossaries-user.html#dx1-12018" >3604</a>, <a -href="glossaries-user.html#dx1-12024" >3605</a>, <a -href="glossaries-user.html#dx1-12025" >3606</a>, <a -href="glossaries-user.html#dx1-112102" >3607</a>, <a -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-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 -href="glossaries-user.html#dx1-202026" >3617</a>, <a -href="glossaries-user.html#dx1-224026" >3618</a>, <a -href="glossaries-user.html#dx1-224077" >3619</a> <br /></span> +href="glossaries-user.html#dx1-12009" >3651</a>, <a +href="glossaries-user.html#dx1-12018" >3652</a>, <a +href="glossaries-user.html#dx1-12024" >3653</a>, <a +href="glossaries-user.html#dx1-12026" >3654</a>, <a +href="glossaries-user.html#dx1-12027" >3655</a>, <a +href="glossaries-user.html#dx1-113115" >3656</a>, <a +href="glossaries-user.html#dx1-119014" >3657</a>, <a +href="glossaries-user.html#dx1-131056" >3658</a>, <a +href="glossaries-user.html#dx1-165099" >3659</a>, <a +href="glossaries-user.html#dx1-165102" >3660</a>, <a +href="glossaries-user.html#dx1-172032" >3661</a>, <a +href="glossaries-user.html#dx1-172035" >3662</a>, <a +href="glossaries-user.html#dx1-175044" >3663</a>, <a +href="glossaries-user.html#dx1-192036" >3664</a>, <a +href="glossaries-user.html#dx1-192044" >3665</a>, <a +href="glossaries-user.html#dx1-205026" >3666</a>, <a +href="glossaries-user.html#dx1-227026" >3667</a>, <a +href="glossaries-user.html#dx1-227077" >3668</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user1access</span>  <a -href="glossaries-user.html#dx1-172043" >3620</a>, <a -href="glossaries-user.html#dx1-224030" >3621</a> <br /></span> +href="glossaries-user.html#dx1-175043" >3669</a>, <a +href="glossaries-user.html#dx1-227030" >3670</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user2</span>  <a -href="glossaries-user.html#dx1-112104" >3622</a>, <a -href="glossaries-user.html#dx1-118015" >3623</a>, <a -href="glossaries-user.html#dx1-134061" >3624</a>, <a -href="glossaries-user.html#dx1-166102" >3625</a>, <a -href="glossaries-user.html#dx1-172046" >3626</a> <br /></span> +href="glossaries-user.html#dx1-113117" >3671</a>, <a +href="glossaries-user.html#dx1-119015" >3672</a>, <a +href="glossaries-user.html#dx1-131061" >3673</a>, <a +href="glossaries-user.html#dx1-165103" >3674</a>, <a +href="glossaries-user.html#dx1-175046" >3675</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user2access</span>  <a -href="glossaries-user.html#dx1-172045" >3627</a> <br /></span> +href="glossaries-user.html#dx1-175045" >3676</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user3</span>  <a -href="glossaries-user.html#dx1-112105" >3628</a>, <a -href="glossaries-user.html#dx1-118016" >3629</a>, <a -href="glossaries-user.html#dx1-134066" >3630</a>, <a -href="glossaries-user.html#dx1-172048" >3631</a> <br /></span> +href="glossaries-user.html#dx1-113118" >3677</a>, <a +href="glossaries-user.html#dx1-119016" >3678</a>, <a +href="glossaries-user.html#dx1-131066" >3679</a>, <a +href="glossaries-user.html#dx1-175048" >3680</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user3access</span>  <a -href="glossaries-user.html#dx1-172047" >3632</a> <br /></span> +href="glossaries-user.html#dx1-175047" >3681</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user4</span>  <a -href="glossaries-user.html#dx1-112106" >3633</a>, <a -href="glossaries-user.html#dx1-118017" >3634</a>, <a -href="glossaries-user.html#dx1-134071" >3635</a>, <a -href="glossaries-user.html#dx1-172050" >3636</a> <br /></span> +href="glossaries-user.html#dx1-113119" >3682</a>, <a +href="glossaries-user.html#dx1-119017" >3683</a>, <a +href="glossaries-user.html#dx1-131071" >3684</a>, <a +href="glossaries-user.html#dx1-175050" >3685</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user4access</span>  <a -href="glossaries-user.html#dx1-172049" >3637</a> <br /></span> +href="glossaries-user.html#dx1-175049" >3686</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user5</span>  <a -href="glossaries-user.html#dx1-112107" >3638</a>, <a -href="glossaries-user.html#dx1-118018" >3639</a>, <a -href="glossaries-user.html#dx1-134076" >3640</a>, <a -href="glossaries-user.html#dx1-172052" >3641</a> <br /></span> +href="glossaries-user.html#dx1-113120" >3687</a>, <a +href="glossaries-user.html#dx1-119018" >3688</a>, <a +href="glossaries-user.html#dx1-131076" >3689</a>, <a +href="glossaries-user.html#dx1-175052" >3690</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user5access</span>  <a -href="glossaries-user.html#dx1-172051" >3642</a> <br /></span> +href="glossaries-user.html#dx1-175051" >3691</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user6</span>  <a -href="glossaries-user.html#dx1-112103" >3643</a>, <a -href="glossaries-user.html#dx1-118019" >3644</a>, <a -href="glossaries-user.html#dx1-134081" >3645</a>, <a -href="glossaries-user.html#dx1-166099" >3646</a>, <a -href="glossaries-user.html#dx1-172054" >3647</a> <br /></span> +href="glossaries-user.html#dx1-113116" >3692</a>, <a +href="glossaries-user.html#dx1-119019" >3693</a>, <a +href="glossaries-user.html#dx1-131081" >3694</a>, <a +href="glossaries-user.html#dx1-165100" >3695</a>, <a +href="glossaries-user.html#dx1-175054" >3696</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">user6access</span>  <a -href="glossaries-user.html#dx1-172053" >3648</a> <br /></span> +href="glossaries-user.html#dx1-175053" >3697</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newglossarystyle</span></span></span>  <a -href="glossaries-user.html#dx1-156035" >3649</a>, <a -href="glossaries-user.html#dx1-166001" ><span -class="cmti-10">3650</span></a>, <a -href="glossaries-user.html#dx1-166033" >3651</a>, <a -href="glossaries-user.html#dx1-166092" >3652</a> <br /></span> +href="glossaries-user.html#dx1-155036" >3698</a>, <a +href="glossaries-user.html#dx1-165002" ><span +class="cmti-10">3699</span></a>, <a +href="glossaries-user.html#dx1-165034" >3700</a>, <a +href="glossaries-user.html#dx1-165093" >3701</a> <br /></span> <span class="index-item"><span class="obeylines-h"><span class="verb"><span class="cmtt-10">\newignoredglossary</span></span></span>  <a -href="glossaries-user.html#dx1-34012" >3653</a>, <a -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-169002" >3657</a>, <a -href="glossaries-user.html#dx1-225001" >3658</a> <br /></span> +href="glossaries-user.html#dx1-34012" >3702</a>, <a +href="glossaries-user.html#dx1-124003" >3703</a>, <a +href="glossaries-user.html#dx1-144026" >3704</a>, <a +href="glossaries-user.html#dx1-145010" ><span +class="cmti-10">3705</span></a>, <a +href="glossaries-user.html#dx1-172002" >3706</a>, <a +href="glossaries-user.html#dx1-228001" >3707</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" >3659</a>, <a -href="glossaries-user.html#dx1-156026" >3660</a> <br /></span> +href="glossaries-user.html#dx1-113028" >3708</a>, <a +href="glossaries-user.html#dx1-155027" >3709</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">3661</span></a>, <a -href="glossaries-user.html#dx1-138014" >3662</a> <br /></span> +href="glossaries-user.html#dx1-88001" ><span +class="cmti-10">3710</span></a>, <a +href="glossaries-user.html#dx1-147017" >3711</a> <br /></span> <span class="index-item"><span class="cmss-10">ngerman </span>package  <a -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> +href="glossaries-user.html#dx1-13029" >3712</a>, <a +href="glossaries-user.html#dx1-13038" >3713</a>, <a +href="glossaries-user.html#dx1-13047" >3714</a>, <a +href="glossaries-user.html#dx1-166013" >3715</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" >3667</a> <br /></span> +href="glossaries-user.html#dx1-152013" >3716</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">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> +href="glossaries-user.html#dx1-112008" ><span +class="cmti-10">3717</span></a>, <a +href="glossaries-user.html#dx1-152006" >3718</a>, <a +href="glossaries-user.html#dx1-152015" >3719</a>, <a +href="glossaries-user.html#dx1-166017" >3720</a>, <a +href="glossaries-user.html#dx1-167012" >3721</a>, <a +href="glossaries-user.html#dx1-168024" >3722</a>, <a +href="glossaries-user.html#dx1-168029" >3723</a>, <a +href="glossaries-user.html#dx1-168062" >3724</a>, <a +href="glossaries-user.html#dx1-168068" >3725</a>, <a +href="glossaries-user.html#dx1-169008" >3726</a>, <a +href="glossaries-user.html#dx1-214009" >3727</a>, <a +href="glossaries-user.html#dx1-214021" >3728</a> <br /></span> <span class="index-item">Non-Latin Alphabet  <a href="glossaries-user.html#dx1-3054" ><span -class="cmbx-10">3680</span></a> <br /></span> +class="cmbx-10">3729</span></a> <br /></span> <span class="index-item">non-Latin character  <a -href="glossaries-user.html#dx1-3020" >3681</a>, <a -href="glossaries-user.html#dx1-3055" >3682</a>, <a +href="glossaries-user.html#dx1-3020" >3730</a>, <a +href="glossaries-user.html#dx1-3055" >3731</a>, <a href="glossaries-user.html#dx1-3056" ><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> +class="cmbx-10">3732</span></a>, <a +href="glossaries-user.html#dx1-13013" >3733</a>, <a +href="glossaries-user.html#dx1-13016" >3734</a>, <a +href="glossaries-user.html#dx1-14055" >3735</a>, <a +href="glossaries-user.html#dx1-15011" >3736</a>, <a +href="glossaries-user.html#dx1-113013" >3737</a>, <a +href="glossaries-user.html#dx1-113171" >3738</a>, <a +href="glossaries-user.html#dx1-113178" >3739</a>, <a +href="glossaries-user.html#dx1-217004" >3740</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" >3692</a>, <a -href="glossaries-user.html#dx1-112021" ><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> +href="glossaries-user.html#dx1-88003" >3741</a>, <a +href="glossaries-user.html#dx1-113026" ><span +class="cmti-10">3742</span></a>, <a +href="glossaries-user.html#dx1-121004" >3743</a>, <a +href="glossaries-user.html#dx1-122002" >3744</a>, <a +href="glossaries-user.html#dx1-155041" >3745</a>, <a +href="glossaries-user.html#dx1-172029" >3746</a>, <a +href="glossaries-user.html#dx1-200011" >3747</a>, <a +href="glossaries-user.html#dx1-200016" >3748</a>, <a +href="glossaries-user.html#dx1-203011" >3749</a>, <a +href="glossaries-user.html#dx1-203013" >3750</a>, <a +href="glossaries-user.html#dx1-203015" >3751</a>, <a +href="glossaries-user.html#dx1-205017" >3752</a>, <a +href="glossaries-user.html#dx1-209010" >3753</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" >3705</a> <br /></span> - - +href="glossaries-user.html#dx1-205034" >3754</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" >3706</a>, <a -href="glossaries-user.html#dx1-141010" >3707</a> <br /></span> +href="glossaries-user.html#dx1-144011" >3755</a>, <a +href="glossaries-user.html#dx1-144012" >3756</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" >3708</a> <br /></span> +href="glossaries-user.html#dx1-151027" >3757</a> <br /></span> <span class="index-item">number list  <a href="glossaries-user.html#dx1-3059" ><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> +class="cmbx-10">3758</span></a>, <a +href="glossaries-user.html#dx1-6019" >3759</a>, <a +href="glossaries-user.html#dx1-7011" >3760</a>, <a +href="glossaries-user.html#dx1-9038" >3761</a>, <a +href="glossaries-user.html#dx1-10006" >3762</a>, <a +href="glossaries-user.html#dx1-16007" >3763</a>, <a +href="glossaries-user.html#dx1-16077" >3764</a>, <a +href="glossaries-user.html#dx1-31006" >3765</a>, <a +href="glossaries-user.html#dx1-46001" >3766</a>, <a +href="glossaries-user.html#dx1-46009" >3767</a>, <a +href="glossaries-user.html#dx1-56001" >3768</a>, <a +href="glossaries-user.html#dx1-56004" >3769</a>, <a +href="glossaries-user.html#dx1-56007" >3770</a>, <a +href="glossaries-user.html#dx1-56008" >3771</a>, <a +href="glossaries-user.html#dx1-57001" >3772</a>, <a +href="glossaries-user.html#dx1-58002" >3773</a>, <a +href="glossaries-user.html#dx1-68005" >3774</a>, <a +href="glossaries-user.html#dx1-112016" >3775</a>, <a +href="glossaries-user.html#dx1-112020" >3776</a>, <a +href="glossaries-user.html#dx1-112021" >3777</a>, <a +href="glossaries-user.html#dx1-113124" >3778</a>, <a +href="glossaries-user.html#dx1-113126" >3779</a>, <a +href="glossaries-user.html#dx1-113129" >3780</a>, <a +href="glossaries-user.html#dx1-113131" >3781</a>, <a +href="glossaries-user.html#dx1-113132" >3782</a>, <a +href="glossaries-user.html#dx1-113133" >3783</a>, <a +href="glossaries-user.html#dx1-113134" >3784</a>, <a +href="glossaries-user.html#dx1-120002" >3785</a>, <a +href="glossaries-user.html#dx1-122003" >3786</a>, <a +href="glossaries-user.html#dx1-129002" >3787</a>, <a +href="glossaries-user.html#dx1-129007" >3788</a>, <a +href="glossaries-user.html#dx1-134061" >3789</a>, <a +href="glossaries-user.html#dx1-144016" >3790</a>, <a +href="glossaries-user.html#dx1-145002" >3791</a>, <a +href="glossaries-user.html#dx1-146009" >3792</a>, <a +href="glossaries-user.html#dx1-147022" >3793</a>, <a +href="glossaries-user.html#dx1-147023" >3794</a>, <a +href="glossaries-user.html#dx1-147024" >3795</a>, <a +href="glossaries-user.html#dx1-147028" >3796</a>, <a +href="glossaries-user.html#dx1-149001" >3797</a>, <a +href="glossaries-user.html#dx1-149005" >3798</a>, <a +href="glossaries-user.html#dx1-149011" >3799</a>, <a +href="glossaries-user.html#dx1-149012" >3800</a>, <a +href="glossaries-user.html#dx1-149014" >3801</a>, <a +href="glossaries-user.html#dx1-150001" >3802</a>, <a +href="glossaries-user.html#dx1-150005" >3803</a>, <a +href="glossaries-user.html#dx1-150006" >3804</a>, <a +href="glossaries-user.html#dx1-150009" >3805</a>, <a +href="glossaries-user.html#dx1-150014" >3806</a>, <a +href="glossaries-user.html#dx1-151018" >3807</a>, <a +href="glossaries-user.html#dx1-152018" >3808</a>, <a +href="glossaries-user.html#dx1-152021" >3809</a>, <a +href="glossaries-user.html#dx1-156014" >3810</a>, <a +href="glossaries-user.html#dx1-156038" >3811</a>, <a +href="glossaries-user.html#dx1-156041" >3812</a>, <a +href="glossaries-user.html#dx1-157011" >3813</a>, <a +href="glossaries-user.html#dx1-157021" >3814</a>, <a +href="glossaries-user.html#dx1-158011" >3815</a>, <a +href="glossaries-user.html#dx1-158021" >3816</a>, <a +href="glossaries-user.html#dx1-160016" >3817</a>, <a +href="glossaries-user.html#dx1-160026" >3818</a>, <a +href="glossaries-user.html#dx1-161013" >3819</a>, <a +href="glossaries-user.html#dx1-161023" >3820</a>, <a +href="glossaries-user.html#dx1-164003" >3821</a>, <a +href="glossaries-user.html#dx1-165040" >3822</a>, <a +href="glossaries-user.html#dx1-165081" >3823</a>, <a +href="glossaries-user.html#dx1-168002" >3824</a>, <a +href="glossaries-user.html#dx1-168054" >3825</a>, <a +href="glossaries-user.html#dx1-168065" >3826</a>, <a +href="glossaries-user.html#dx1-179001" >3827</a>, <a +href="glossaries-user.html#dx1-191005" >3828</a>, <a +href="glossaries-user.html#dx1-192001" >3829</a>, <a +href="glossaries-user.html#dx1-192066" >3830</a>, <a +href="glossaries-user.html#dx1-192070" >3831</a>, <a +href="glossaries-user.html#dx1-193011" >3832</a>, <a +href="glossaries-user.html#dx1-196028" >3833</a>, <a +href="glossaries-user.html#dx1-196034" >3834</a>, <a +href="glossaries-user.html#dx1-196035" >3835</a>, <a +href="glossaries-user.html#dx1-196036" >3836</a>, <a +href="glossaries-user.html#dx1-207031" >3837</a>, <a +href="glossaries-user.html#dx1-207033" >3838</a>, <a +href="glossaries-user.html#dx1-214016" >3839</a>, <a +href="glossaries-user.html#dx1-217016" >3840</a>, <a +href="glossaries-user.html#dx1-217034" >3841</a>, <a +href="glossaries-user.html#dx1-219004" >3842</a>, <a +href="glossaries-user.html#dx1-223001" >3843</a>, <a +href="glossaries-user.html#dx1-223005" >3844</a>, <a +href="glossaries-user.html#dx1-223006" >3845</a>, <a +href="glossaries-user.html#dx1-223009" >3846</a>, <a +href="glossaries-user.html#dx1-223030" >3847</a>, <a +href="glossaries-user.html#dx1-223033" >3848</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" >3797</a> <br /></span> +href="glossaries-user.html#dx1-41002" >3849</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">3798</span></a>, <a -href="glossaries-user.html#dx1-152007" >3799</a> <br /></span> +href="glossaries-user.html#dx1-141004" ><span +class="cmti-10">3850</span></a>, <a +href="glossaries-user.html#dx1-141007" >3851</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" >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> +href="glossaries-user.html#dx1-4011" >3852</a>, <a +href="glossaries-user.html#dx1-91016" >3853</a>, <a +href="glossaries-user.html#x1-930002.7" >3854</a>, <a +href="glossaries-user.html#dx1-135005" >3855</a>, <a +href="glossaries-user.html#dx1-175009" >3856</a>, <a +href="glossaries-user.html#dx1-178037" >3857</a>, <a +href="glossaries-user.html#dx1-178044" >3858</a>, <a +href="glossaries-user.html#dx1-182009" >3859</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" >3808</a>, <a -href="glossaries-user.html#dx1-172008" >3809</a>, <a -href="glossaries-user.html#dx1-224039" >3810</a> <br /></span> +href="glossaries-user.html#x1-1030002.9" >3860</a>, <a +href="glossaries-user.html#dx1-175008" >3861</a>, <a +href="glossaries-user.html#dx1-227039" >3862</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">acronym</span>  <a -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> +href="glossaries-user.html#dx1-14026" >3863</a>, <a +href="glossaries-user.html#dx1-19015" >3864</a>, <a +href="glossaries-user.html#dx1-19019" >3865</a>, <a +href="glossaries-user.html#dx1-20011" >3866</a>, <a +href="glossaries-user.html#dx1-20016" >3867</a>, <a +href="glossaries-user.html#dx1-25001" >3868</a>, <a +href="glossaries-user.html#dx1-25003" >3869</a>, <a +href="glossaries-user.html#dx1-44008" >3870</a>, <a +href="glossaries-user.html#dx1-44009" >3871</a>, <a +href="glossaries-user.html#dx1-85002" >3872</a>, <a +href="glossaries-user.html#x1-910002.7" >3873</a>, <a +href="glossaries-user.html#dx1-91005" >3874</a>, <a +href="glossaries-user.html#dx1-91018" >3875</a>, <a +href="glossaries-user.html#dx1-91023" >3876</a>, <a +href="glossaries-user.html#dx1-94002" >3877</a>, <a +href="glossaries-user.html#dx1-109015" >3878</a>, <a +href="glossaries-user.html#dx1-123019" >3879</a>, <a +href="glossaries-user.html#dx1-123020" >3880</a>, <a +href="glossaries-user.html#dx1-123025" >3881</a>, <a +href="glossaries-user.html#dx1-140005" >3882</a>, <a +href="glossaries-user.html#dx1-145016" >3883</a>, <a +href="glossaries-user.html#dx1-145017" >3884</a>, <a +href="glossaries-user.html#dx1-145019" >3885</a>, <a +href="glossaries-user.html#dx1-146017" >3886</a>, <a +href="glossaries-user.html#dx1-175006" >3887</a>, <a +href="glossaries-user.html#dx1-178011" >3888</a>, <a +href="glossaries-user.html#dx1-178019" >3889</a>, <a +href="glossaries-user.html#dx1-178020" >3890</a>, <a +href="glossaries-user.html#dx1-178033" >3891</a>, <a +href="glossaries-user.html#dx1-178035" >3892</a>, <a +href="glossaries-user.html#dx1-178043" >3893</a>, <a +href="glossaries-user.html#dx1-182001" >3894</a>, <a +href="glossaries-user.html#dx1-182008" >3895</a>, <a +href="glossaries-user.html#dx1-91010" >3896</a>, <a +href="glossaries-user.html#dx1-123024" >3897</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-25002" >3846</a>, <a -href="glossaries-user.html#dx1-91001" >3847</a> <br /></span> +href="glossaries-user.html#dx1-25002" >3898</a>, <a +href="glossaries-user.html#dx1-92001" >3899</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">acronymlists</span>  <a -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> +href="glossaries-user.html#x1-940002.7" >3900</a>, <a +href="glossaries-user.html#dx1-94001" >3901</a>, <a +href="glossaries-user.html#dx1-94004" >3902</a>, <a +href="glossaries-user.html#dx1-132010" >3903</a>, <a +href="glossaries-user.html#dx1-135021" >3904</a>, <a +href="glossaries-user.html#dx1-145020" >3905</a>, <a +href="glossaries-user.html#dx1-171004" >3906</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">acronyms</span>  <a -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> +href="glossaries-user.html#dx1-85003" >3907</a>, <a +href="glossaries-user.html#dx1-91024" >3908</a>, <a +href="glossaries-user.html#x1-920002.7" >3909</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">automake</span>  <a -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> +href="glossaries-user.html#dx1-7010" >3910</a>, <a +href="glossaries-user.html#dx1-16006" >3911</a>, <a +href="glossaries-user.html#x1-800002.5" >3912</a>, <a +href="glossaries-user.html#dx1-80014" >3913</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-79021" >3862</a> <br /></span> +href="glossaries-user.html#dx1-80021" >3914</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">immediate</span>  <a -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> +href="glossaries-user.html#dx1-80005" >3915</a>, <a +href="glossaries-user.html#dx1-80010" >3916</a>, <a +href="glossaries-user.html#dx1-80011" >3917</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-79001" >3866</a>, <a -href="glossaries-user.html#dx1-79009" >3867</a> <br /></span> +href="glossaries-user.html#dx1-80001" >3918</a>, <a +href="glossaries-user.html#dx1-80009" >3919</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" >3868</a> <br /></span> +href="glossaries-user.html#x1-670002.4" >3920</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-204008" >3869</a>, <a -href="glossaries-user.html#dx1-204020" >3870</a> <br /></span> +href="glossaries-user.html#dx1-207008" >3921</a>, <a +href="glossaries-user.html#dx1-207020" >3922</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">compatible-2.07</span>  <a -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> +href="glossaries-user.html#x1-1060002.9" >3923</a>, <a +href="glossaries-user.html#dx1-109012" >3924</a>, <a +href="glossaries-user.html#dx1-112010" >3925</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">compatible-3.07</span>  <a -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> +href="glossaries-user.html#dx1-91003" >3926</a>, <a +href="glossaries-user.html#x1-1070002.9" >3927</a>, <a +href="glossaries-user.html#dx1-132005" >3928</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">counter</span>  <a -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> +href="glossaries-user.html#x1-580002.3" >3929</a>, <a +href="glossaries-user.html#dx1-112017" >3930</a>, <a +href="glossaries-user.html#dx1-149003" >3931</a>, <a +href="glossaries-user.html#dx1-168004" >3932</a>, <a +href="glossaries-user.html#dx1-168041" >3933</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">equation</span>  <a -href="glossaries-user.html#dx1-189002" >3882</a> <br /></span> +href="glossaries-user.html#dx1-192002" >3934</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">page</span>  <a -href="glossaries-user.html#dx1-57001" >3883</a> <br /></span> +href="glossaries-user.html#dx1-58001" >3935</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">counterwithin</span>  <a -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> +href="glossaries-user.html#x1-480002.3" >3936</a>, <a +href="glossaries-user.html#dx1-48004" >3937</a>, <a +href="glossaries-user.html#dx1-155002" >3938</a>, <a +href="glossaries-user.html#dx1-165048" >3939</a>, <a +href="glossaries-user.html#dx1-165085" >3940</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">debug</span>  <a -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> +href="glossaries-user.html#dx1-27002" >3941</a>, <a +href="glossaries-user.html#x1-300002.1" >3942</a>, <a +href="glossaries-user.html#dx1-30019" >3943</a>, <a +href="glossaries-user.html#dx1-30020" >3944</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" >3893</a> <br /></span> +href="glossaries-user.html#dx1-30004" >3945</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-30001" >3894</a>, <a -href="glossaries-user.html#dx1-30005" >3895</a> <br /></span> +href="glossaries-user.html#dx1-30001" >3946</a>, <a +href="glossaries-user.html#dx1-30005" >3947</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">showaccsupp</span>  <a -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> +href="glossaries-user.html#dx1-30011" >3948</a>, <a +href="glossaries-user.html#dx1-175076" >3949</a>, <a +href="glossaries-user.html#dx1-227034" >3950</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">showtargets</span>  <a -href="glossaries-user.html#dx1-30007" >3899</a> <br /></span> +href="glossaries-user.html#dx1-30007" >3951</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" >3900</a> <br /></span> +href="glossaries-user.html#dx1-30003" >3952</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-30002" >3901</a> <br /></span> +href="glossaries-user.html#dx1-30002" >3953</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">description </span>(deprecated)  <a -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> +href="glossaries-user.html#x1-970002.8" >3954</a>, <a +href="glossaries-user.html#dx1-98002" >3955</a>, <a +href="glossaries-user.html#dx1-98003" >3956</a>, <a +href="glossaries-user.html#dx1-99005" >3957</a>, <a +href="glossaries-user.html#dx1-99006" >3958</a>, <a +href="glossaries-user.html#dx1-100004" >3959</a>, <a +href="glossaries-user.html#dx1-100006" >3960</a>, <a +href="glossaries-user.html#dx1-100008" >3961</a>, <a +href="glossaries-user.html#dx1-101002" >3962</a> <br /></span> + + <span class="index-subitem">    <span class="cmss-10">disablemakegloss</span>  <a -href="glossaries-user.html#x1-800002.5" >3911</a>, <a -href="glossaries-user.html#dx1-81001" >3912</a> <br /></span> +href="glossaries-user.html#x1-810002.5" >3963</a>, <a +href="glossaries-user.html#dx1-82001" >3964</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" >3913</a> <br /></span> +href="glossaries-user.html#x1-380002.1" >3965</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">atom</span>  <a -href="glossaries-user.html#dx1-23002" >3914</a>, <a -href="glossaries-user.html#dx1-35003" >3915</a> <br /></span> +href="glossaries-user.html#dx1-23003" >3966</a>, <a +href="glossaries-user.html#dx1-35004" >3967</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-5013" >3916</a> <br /></span> +href="glossaries-user.html#dx1-5013" >3968</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">restricted</span>  <a -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> +href="glossaries-user.html#dx1-5012" >3969</a>, <a +href="glossaries-user.html#dx1-5014" >3970</a>, <a +href="glossaries-user.html#dx1-23005" >3971</a>, <a +href="glossaries-user.html#dx1-31004" >3972</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-5011" >3921</a>, <a -href="glossaries-user.html#dx1-37007" >3922</a> <br /></span> - - +href="glossaries-user.html#dx1-5011" >3973</a>, <a +href="glossaries-user.html#dx1-38007" >3974</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">dua </span>(deprecated)  <a -href="glossaries-user.html#dx1-96009" >3923</a>, <a -href="glossaries-user.html#x1-1000002.7.1" >3924</a> <br /></span> +href="glossaries-user.html#dx1-97009" >3975</a>, <a +href="glossaries-user.html#x1-1010002.8" >3976</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">entrycounter</span>  <a -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> +href="glossaries-user.html#x1-470002.3" >3977</a>, <a +href="glossaries-user.html#dx1-49004" >3978</a>, <a +href="glossaries-user.html#dx1-155001" >3979</a>, <a +href="glossaries-user.html#dx1-165047" >3980</a>, <a +href="glossaries-user.html#dx1-165084" >3981</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-46001" >3930</a> <br /></span> +href="glossaries-user.html#dx1-47001" >3982</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-47001" >3931</a> <br /></span> +href="glossaries-user.html#dx1-48001" >3983</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" >3932</a> <br /></span> +href="glossaries-user.html#x1-690002.4" >3984</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">esclocations</span>  <a -href="glossaries-user.html#x1-630002.4" >3933</a> <br /></span> +href="glossaries-user.html#x1-640002.4" >3985</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -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> +href="glossaries-user.html#dx1-64003" >3986</a>, <a +href="glossaries-user.html#dx1-64009" >3987</a>, <a +href="glossaries-user.html#dx1-151002" >3988</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-63001" >3937</a> <br /></span> +href="glossaries-user.html#dx1-64001" >3989</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" >3938</a> <br /></span> +href="glossaries-user.html#x1-700002.4" >3990</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">footnote </span>(deprecated)  <a -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> +href="glossaries-user.html#dx1-97004" >3991</a>, <a +href="glossaries-user.html#dx1-97005" >3992</a>, <a +href="glossaries-user.html#dx1-97007" >3993</a>, <a +href="glossaries-user.html#dx1-98004" >3994</a>, <a +href="glossaries-user.html#dx1-99007" >3995</a>, <a +href="glossaries-user.html#x1-1000002.8" >3996</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">hyperfirst</span>  <a -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> +href="glossaries-user.html#x1-340002.1" >3997</a>, <a +href="glossaries-user.html#dx1-34010" >3998</a>, <a +href="glossaries-user.html#dx1-133015" >3999</a>, <a +href="glossaries-user.html#dx1-133017" >4000</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -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> +href="glossaries-user.html#dx1-34014" >4001</a>, <a +href="glossaries-user.html#dx1-129035" >4002</a>, <a +href="glossaries-user.html#dx1-133010" >4003</a>, <a +href="glossaries-user.html#dx1-133013" >4004</a>, <a +href="glossaries-user.html#dx1-138073" >4005</a>, <a +href="glossaries-user.html#dx1-186001" >4006</a>, <a +href="glossaries-user.html#dx1-186005" >4007</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-34001" >3956</a>, <a -href="glossaries-user.html#dx1-34005" >3957</a> <br /></span> +href="glossaries-user.html#dx1-34001" >4008</a>, <a +href="glossaries-user.html#dx1-34005" >4009</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">index</span>  <a -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> +href="glossaries-user.html#dx1-85006" >4010</a>, <a +href="glossaries-user.html#x1-880002.6" >4011</a>, <a +href="glossaries-user.html#dx1-88012" >4012</a>, <a +href="glossaries-user.html#dx1-88015" >4013</a>, <a +href="glossaries-user.html#dx1-89001" >4014</a>, <a +href="glossaries-user.html#dx1-89002" >4015</a>, <a +href="glossaries-user.html#dx1-145023" >4016</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" >3965</a> <br /></span> +href="glossaries-user.html#x1-710002.4" >4017</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" >3966</a> <br /></span> +href="glossaries-user.html#x1-660002.4" >4018</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">indexonlyfirst</span>  <a -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> +href="glossaries-user.html#x1-650002.4" >4019</a>, <a +href="glossaries-user.html#dx1-65006" >4020</a>, <a +href="glossaries-user.html#dx1-65008" >4021</a>, <a +href="glossaries-user.html#dx1-149009" >4022</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-64001" >3971</a> <br /></span> +href="glossaries-user.html#dx1-65001" >4023</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">kernelglossredefs</span>  <a -href="glossaries-user.html#x1-1070002.8" >3972</a> <br /></span> +href="glossaries-user.html#x1-1080002.9" >4024</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-107002" >3973</a> <br /></span> +href="glossaries-user.html#dx1-108002" >4025</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">makeindex</span>  <a -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> +href="glossaries-user.html#dx1-25004" >4026</a>, <a +href="glossaries-user.html#x1-760002.5" >4027</a>, <a +href="glossaries-user.html#dx1-109005" >4028</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">noglossaryindex</span>  <a -href="glossaries-user.html#x1-880002.6" >3977</a> <br /></span> +href="glossaries-user.html#x1-890002.6" >4029</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nogroupskip</span>  <a -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> +href="glossaries-user.html#x1-600002.3" >4030</a>, <a +href="glossaries-user.html#dx1-144053" >4031</a>, <a +href="glossaries-user.html#dx1-155010" >4032</a>, <a +href="glossaries-user.html#dx1-155038" >4033</a>, <a +href="glossaries-user.html#dx1-159020" >4034</a>, <a +href="glossaries-user.html#dx1-165038" >4035</a>, <a +href="glossaries-user.html#dx1-165097" >4036</a>, <a +href="glossaries-user.html#dx1-222001" >4037</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-59001" >3986</a> <br /></span> +href="glossaries-user.html#dx1-60001" >4038</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nohyperfirst</span>  <a -href="glossaries-user.html#dx1-34025" >3987</a> <br /></span> +href="glossaries-user.html#dx1-34025" >4039</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nohypertypes</span>  <a -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> +href="glossaries-user.html#dx1-34003" >4040</a>, <a +href="glossaries-user.html#dx1-34004" >4041</a>, <a +href="glossaries-user.html#dx1-34011" >4042</a>, <a +href="glossaries-user.html#x1-840002.6" >4043</a>, <a +href="glossaries-user.html#dx1-129020" >4044</a>, <a +href="glossaries-user.html#dx1-129027" >4045</a>, <a +href="glossaries-user.html#dx1-132026" >4046</a>, <a +href="glossaries-user.html#dx1-133004" >4047</a>, <a +href="glossaries-user.html#dx1-145011" >4048</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">index</span>  <a -href="glossaries-user.html#dx1-87013" >3997</a> <br /></span> +href="glossaries-user.html#dx1-88013" >4049</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nolangwarn</span>  <a -href="glossaries-user.html#dx1-3" >3998</a>, <a -href="glossaries-user.html#x1-280002.1" >3999</a> <br /></span> +href="glossaries-user.html#dx1-3" >4050</a>, <a +href="glossaries-user.html#x1-280002.1" >4051</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nolist</span>  <a -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> +href="glossaries-user.html#x1-530002.3" >4052</a>, <a +href="glossaries-user.html#dx1-109008" >4053</a>, <a +href="glossaries-user.html#dx1-156004" >4054</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nolong</span>  <a -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> +href="glossaries-user.html#x1-510002.3" >4055</a>, <a +href="glossaries-user.html#dx1-109006" >4056</a>, <a +href="glossaries-user.html#dx1-157004" >4057</a>, <a +href="glossaries-user.html#dx1-205004" >4058</a>, <a +href="glossaries-user.html#dx1-155020" >4059</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nomain</span>  <a -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> +href="glossaries-user.html#x1-850002.6" >4060</a>, <a +href="glossaries-user.html#dx1-86004" >4061</a>, <a +href="glossaries-user.html#dx1-87004" >4062</a>, <a +href="glossaries-user.html#dx1-88007" >4063</a>, <a +href="glossaries-user.html#dx1-91015" >4064</a>, <a +href="glossaries-user.html#dx1-108003" >4065</a>, <a +href="glossaries-user.html#dx1-109011" >4066</a>, <a +href="glossaries-user.html#dx1-145015" >4067</a>, <a +href="glossaries-user.html#dx1-182002" >4068</a>, <a +href="glossaries-user.html#dx1-182003" >4069</a>, <a +href="glossaries-user.html#dx1-197001" >4070</a>, <a +href="glossaries-user.html#dx1-91012" >4071</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" >4020</a> <br /></span> +href="glossaries-user.html#x1-1050002.9" >4072</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nonumberlist</span>  <a -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> +href="glossaries-user.html#dx1-3060" >4073</a>, <a +href="glossaries-user.html#x1-560002.3" >4074</a>, <a +href="glossaries-user.html#dx1-57002" >4075</a>, <a +href="glossaries-user.html#dx1-113125" >4076</a>, <a +href="glossaries-user.html#dx1-146010" >4077</a>, <a +href="glossaries-user.html#dx1-149002" >4078</a>, <a +href="glossaries-user.html#dx1-149008" >4079</a>, <a +href="glossaries-user.html#dx1-156042" >4080</a>, <a +href="glossaries-user.html#dx1-165060" >4081</a>, <a +href="glossaries-user.html#dx1-165062" >4082</a>, <a +href="glossaries-user.html#dx1-179023" >4083</a>, <a +href="glossaries-user.html#dx1-209020" >4084</a>, <a +href="glossaries-user.html#dx1-217013" >4085</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nopostdot</span>  <a -href="glossaries-user.html#x1-580002.3" >4034</a>, <a -href="glossaries-user.html#dx1-156042" >4035</a> <br /></span> +href="glossaries-user.html#x1-590002.3" >4086</a>, <a +href="glossaries-user.html#dx1-155043" >4087</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -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> +href="glossaries-user.html#dx1-59003" >4088</a>, <a +href="glossaries-user.html#dx1-59006" >4089</a>, <a +href="glossaries-user.html#dx1-181018" >4090</a>, <a +href="glossaries-user.html#dx1-181020" >4091</a>, <a +href="glossaries-user.html#dx1-203010" >4092</a>, <a +href="glossaries-user.html#dx1-207005" >4093</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -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> +href="glossaries-user.html#dx1-59001" >4094</a>, <a +href="glossaries-user.html#dx1-59002" >4095</a>, <a +href="glossaries-user.html#dx1-59004" >4096</a>, <a +href="glossaries-user.html#dx1-181019" >4097</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">noredefwarn</span>  <a -href="glossaries-user.html#x1-290002.1" >4046</a> <br /></span> +href="glossaries-user.html#x1-290002.1" >4098</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nostyles</span>  <a -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> +href="glossaries-user.html#dx1-11021" >4099</a>, <a +href="glossaries-user.html#dx1-11074" >4100</a>, <a +href="glossaries-user.html#x1-550002.3" >4101</a>, <a +href="glossaries-user.html#dx1-109010" >4102</a>, <a +href="glossaries-user.html#dx1-156005" >4103</a>, <a +href="glossaries-user.html#dx1-157005" >4104</a>, <a +href="glossaries-user.html#dx1-160005" >4105</a>, <a +href="glossaries-user.html#dx1-162003" >4106</a>, <a +href="glossaries-user.html#dx1-181011" >4107</a>, <a +href="glossaries-user.html#dx1-205009" >4108</a>, <a +href="glossaries-user.html#dx1-222013" >4109</a>, <a +href="glossaries-user.html#dx1-155022" >4110</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nosuper</span>  <a -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> +href="glossaries-user.html#x1-520002.3" >4111</a>, <a +href="glossaries-user.html#dx1-109007" >4112</a>, <a +href="glossaries-user.html#dx1-160004" >4113</a>, <a +href="glossaries-user.html#dx1-205005" >4114</a>, <a +href="glossaries-user.html#dx1-155021" >4115</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">notranslate</span>  <a -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> +href="glossaries-user.html#dx1-14010" >4116</a>, <a +href="glossaries-user.html#x1-330002.1" >4117</a>, <a +href="glossaries-user.html#dx1-109014" >4118</a> <br /></span> + + <span class="index-subitem">    <span class="cmss-10">notree</span>  <a -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> +href="glossaries-user.html#x1-540002.3" >4119</a>, <a +href="glossaries-user.html#dx1-109009" >4120</a>, <a +href="glossaries-user.html#dx1-162002" >4121</a>, <a +href="glossaries-user.html#dx1-163011" >4122</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">nowarn</span>  <a -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> +href="glossaries-user.html#x1-270002.1" >4123</a>, <a +href="glossaries-user.html#dx1-29001" >4124</a>, <a +href="glossaries-user.html#dx1-30006" >4125</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">numberedsection</span>  <a -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> +href="glossaries-user.html#dx1-42001" >4126</a>, <a +href="glossaries-user.html#x1-440002.2" >4127</a>, <a +href="glossaries-user.html#dx1-44001" >4128</a>, <a +href="glossaries-user.html#dx1-144036" >4129</a>, <a +href="glossaries-user.html#dx1-144037" >4130</a>, <a +href="glossaries-user.html#dx1-144080" >4131</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">autolabel</span>  <a -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> +href="glossaries-user.html#dx1-44004" >4132</a>, <a +href="glossaries-user.html#dx1-44011" >4133</a>, <a +href="glossaries-user.html#dx1-144065" >4134</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-43002" >4083</a> <br /></span> +href="glossaries-user.html#dx1-44002" >4135</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">nameref</span>  <a -href="glossaries-user.html#dx1-43010" >4084</a> <br /></span> - - +href="glossaries-user.html#dx1-44010" >4136</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">nolabel</span>  <a -href="glossaries-user.html#dx1-43003" >4085</a> <br /></span> +href="glossaries-user.html#dx1-44003" >4137</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">numberline</span>  <a -href="glossaries-user.html#x1-400002.2" >4086</a>, <a -href="glossaries-user.html#dx1-40006" >4087</a> <br /></span> +href="glossaries-user.html#x1-410002.2" >4138</a>, <a +href="glossaries-user.html#dx1-41006" >4139</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">numbers</span>  <a -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> +href="glossaries-user.html#dx1-85005" >4140</a>, <a +href="glossaries-user.html#x1-870002.6" >4141</a>, <a +href="glossaries-user.html#dx1-145022" >4142</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">order</span>  <a -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> +href="glossaries-user.html#dx1-72002" >4143</a>, <a +href="glossaries-user.html#x1-750002.5" >4144</a>, <a +href="glossaries-user.html#dx1-75003" >4145</a>, <a +href="glossaries-user.html#dx1-144049" >4146</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">letter</span>  <a -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> +href="glossaries-user.html#dx1-7047" >4147</a>, <a +href="glossaries-user.html#dx1-8049" >4148</a>, <a +href="glossaries-user.html#dx1-16088" >4149</a>, <a +href="glossaries-user.html#dx1-75002" >4150</a>, <a +href="glossaries-user.html#dx1-203002" >4151</a>, <a +href="glossaries-user.html#dx1-203095" >4152</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">word</span>  <a -href="glossaries-user.html#dx1-16091" >4101</a>, <a -href="glossaries-user.html#dx1-74001" >4102</a> <br /></span> +href="glossaries-user.html#dx1-16091" >4153</a>, <a +href="glossaries-user.html#dx1-75001" >4154</a> <br /></span> +<span class="index-subitem">    <sup class="textsuperscript"><span +class="tcrm-0900">†</span></sup><span +class="cmss-10">p</span><br /></span> +<span class="index-subsubitem">        <span +class="cmss-10">record</span>  <a +href="glossaries-user.html#dx1-9042" >4155</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" >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> +href="glossaries-user.html#dx1-4012" >4156</a>, <a +href="glossaries-user.html#dx1-59005" >4157</a>, <a +href="glossaries-user.html#dx1-181021" >4158</a>, <a +href="glossaries-user.html#dx1-186031" >4159</a>, <a +href="glossaries-user.html#dx1-191018" >4160</a>, <a +href="glossaries-user.html#dx1-207006" >4161</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" >4109</a> <br /></span> +href="glossaries-user.html#dx1-59007" >4162</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" >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> +href="glossaries-user.html#x1-1040002.9" >4163</a>, <a +href="glossaries-user.html#dx1-181014" >4164</a>, <a +href="glossaries-user.html#dx1-197005" >4165</a>, <a +href="glossaries-user.html#dx1-226003" >4166</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" >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> +href="glossaries-user.html#dx1-9018" >4167</a>, <a +href="glossaries-user.html#dx1-11023" >4168</a>, <a +href="glossaries-user.html#dx1-13010" >4169</a>, <a +href="glossaries-user.html#dx1-46005" >4170</a>, <a +href="glossaries-user.html#x1-680002.4" >4171</a>, <a +href="glossaries-user.html#dx1-178048" >4172</a>, <a +href="glossaries-user.html#dx1-182044" >4173</a>, <a +href="glossaries-user.html#dx1-191013" >4174</a>, <a +href="glossaries-user.html#dx1-191015" >4175</a>, <a +href="glossaries-user.html#dx1-193024" >4176</a>, <a +href="glossaries-user.html#dx1-195037" >4177</a>, <a +href="glossaries-user.html#dx1-200007" >4178</a>, <a +href="glossaries-user.html#dx1-203057" >4179</a>, <a +href="glossaries-user.html#dx1-205050" >4180</a>, <a +href="glossaries-user.html#dx1-207019" >4181</a>, <a +href="glossaries-user.html#dx1-209007" >4182</a>, <a +href="glossaries-user.html#dx1-214037" >4183</a>, <a +href="glossaries-user.html#dx1-215007" >4184</a>, <a +href="glossaries-user.html#dx1-217012" >4185</a>, <a +href="glossaries-user.html#dx1-223045" >4186</a>, <a +href="glossaries-user.html#dx1-226008" >4187</a> <br /></span> <span class="index-subsubitem">        <span -class="cmss-10">alsoindex</span>  <a -href="glossaries-user.html#dx1-9021" >4135</a>, <a -href="glossaries-user.html#dx1-24010" >4136</a> <br /></span> +class="cmss-10">hybrid</span>  <a +href="glossaries-user.html#dx1-9021" >4188</a>, <a +href="glossaries-user.html#dx1-24010" >4189</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">nameref</span>  <a -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> +href="glossaries-user.html#dx1-9020" >4190</a>, <a +href="glossaries-user.html#dx1-24016" >4191</a>, <a +href="glossaries-user.html#dx1-46007" >4192</a>, <a +href="glossaries-user.html#dx1-72005" >4193</a>, <a +href="glossaries-user.html#dx1-82005" >4194</a>, <a +href="glossaries-user.html#dx1-191016" >4195</a>, <a +href="glossaries-user.html#dx1-191036" >4196</a>, <a +href="glossaries-user.html#dx1-193041" >4197</a>, <a +href="glossaries-user.html#dx1-195038" >4198</a>, <a +href="glossaries-user.html#dx1-215014" >4199</a>, <a +href="glossaries-user.html#dx1-223044" >4200</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">only</span>  <a -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> +href="glossaries-user.html#dx1-5016" >4201</a>, <a +href="glossaries-user.html#dx1-46006" >4202</a>, <a +href="glossaries-user.html#dx1-72004" >4203</a>, <a +href="glossaries-user.html#dx1-82004" >4204</a>, <a +href="glossaries-user.html#dx1-191014" >4205</a>, <a +href="glossaries-user.html#dx1-193040" >4206</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">record</span>  <a -href="glossaries-user.html#dx1-214045" >4154</a>, <a -href="glossaries-user.html#dx1-220020" >4155</a> <br /></span> +href="glossaries-user.html#dx1-217045" >4207</a>, <a +href="glossaries-user.html#dx1-223020" >4208</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">restoremakegloss</span>  <a -href="glossaries-user.html#x1-810002.5" >4156</a>, <a -href="glossaries-user.html#dx1-81006" >4157</a> <br /></span> +href="glossaries-user.html#x1-820002.5" >4209</a>, <a +href="glossaries-user.html#dx1-82006" >4210</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">sanitizesort</span>  <a -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> +href="glossaries-user.html#dx1-5006" >4211</a>, <a +href="glossaries-user.html#x1-730002.5" >4212</a>, <a +href="glossaries-user.html#dx1-74031" >4213</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -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> +href="glossaries-user.html#dx1-6005" >4214</a>, <a +href="glossaries-user.html#dx1-6006" >4215</a>, <a +href="glossaries-user.html#dx1-73002" >4216</a>, <a +href="glossaries-user.html#dx1-73004" >4217</a>, <a +href="glossaries-user.html#dx1-74032" >4218</a>, <a +href="glossaries-user.html#dx1-113105" >4219</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -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> +href="glossaries-user.html#dx1-6007" >4220</a>, <a +href="glossaries-user.html#dx1-6008" >4221</a>, <a +href="glossaries-user.html#dx1-73003" >4222</a>, <a +href="glossaries-user.html#dx1-113098" >4223</a>, <a +href="glossaries-user.html#dx1-113100" >4224</a>, <a +href="glossaries-user.html#dx1-113103" >4225</a>, <a +href="glossaries-user.html#dx1-113112" >4226</a>, <a +href="glossaries-user.html#dx1-113180" >4227</a>, <a +href="glossaries-user.html#dx1-144062" >4228</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">savenumberlist</span>  <a -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> +href="glossaries-user.html#x1-460002.3" >4229</a>, <a +href="glossaries-user.html#dx1-134058" >4230</a>, <a +href="glossaries-user.html#dx1-223002" >4231</a>, <a +href="glossaries-user.html#dx1-223021" >4232</a>, <a +href="glossaries-user.html#dx1-223028" >4233</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-45002" >4181</a> <br /></span> +href="glossaries-user.html#dx1-46002" >4234</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">savewrites</span>  <a -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> +href="glossaries-user.html#x1-310002.1" >4235</a>, <a +href="glossaries-user.html#dx1-31005" >4236</a>, <a +href="glossaries-user.html#dx1-31015" >4237</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-31001" >4185</a> <br /></span> +href="glossaries-user.html#dx1-31001" >4238</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">section</span>  <a -href="glossaries-user.html#x1-410002.2" >4186</a>, <a -href="glossaries-user.html#dx1-141068" >4187</a> <br /></span> +href="glossaries-user.html#x1-420002.2" >4239</a>, <a +href="glossaries-user.html#dx1-144078" >4240</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">seeautonumberlist</span>  <a -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> +href="glossaries-user.html#x1-570002.3" >4241</a>, <a +href="glossaries-user.html#dx1-57006" >4242</a>, <a +href="glossaries-user.html#dx1-113136" >4243</a>, <a +href="glossaries-user.html#dx1-147029" >4244</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">seenoindex</span>  <a -href="glossaries-user.html#x1-620002.4" >4192</a>, <a -href="glossaries-user.html#dx1-112126" >4193</a> <br /></span> +href="glossaries-user.html#x1-630002.4" >4245</a>, <a +href="glossaries-user.html#dx1-113142" >4246</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">ignore</span>  <a -href="glossaries-user.html#dx1-62005" >4194</a> <br /></span> +href="glossaries-user.html#dx1-63006" >4247</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">warn</span>  <a -href="glossaries-user.html#dx1-62004" >4195</a> <br /></span> +href="glossaries-user.html#dx1-63005" >4248</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">shortcuts</span>  <a -href="glossaries-user.html#x1-940002.7" >4196</a>, <a -href="glossaries-user.html#dx1-147084" >4197</a> <br /></span> +href="glossaries-user.html#x1-950002.7" >4249</a>, <a +href="glossaries-user.html#dx1-136037" >4250</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">smallcaps </span>(deprecated)  <a -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> +href="glossaries-user.html#dx1-97002" >4251</a>, <a +href="glossaries-user.html#dx1-97006" >4252</a>, <a +href="glossaries-user.html#x1-980002.8" >4253</a>, <a +href="glossaries-user.html#dx1-100002" >4254</a>, <a +href="glossaries-user.html#dx1-100005" >4255</a>, <a +href="glossaries-user.html#dx1-109018" >4256</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">smaller </span>(deprecated)  <a -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> +href="glossaries-user.html#dx1-97003" >4257</a>, <a +href="glossaries-user.html#dx1-97008" >4258</a>, <a +href="glossaries-user.html#x1-990002.8" >4259</a>, <a +href="glossaries-user.html#dx1-100003" >4260</a>, <a +href="glossaries-user.html#dx1-100007" >4261</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">sort</span>  <a -href="glossaries-user.html#dx1-71001" >4209</a>, <a -href="glossaries-user.html#x1-730002.5" >4210</a> <br /></span> +href="glossaries-user.html#dx1-72001" >4262</a>, <a +href="glossaries-user.html#x1-740002.5" >4263</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">def</span>  <a -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> +href="glossaries-user.html#dx1-6010" >4264</a>, <a +href="glossaries-user.html#dx1-6017" >4265</a>, <a +href="glossaries-user.html#dx1-74003" >4266</a>, <a +href="glossaries-user.html#dx1-74010" >4267</a>, <a +href="glossaries-user.html#dx1-74014" >4268</a>, <a +href="glossaries-user.html#dx1-74017" >4269</a>, <a +href="glossaries-user.html#dx1-74022" >4270</a>, <a +href="glossaries-user.html#dx1-74034" >4271</a>, <a +href="glossaries-user.html#dx1-113087" >4272</a>, <a +href="glossaries-user.html#dx1-122006" >4273</a>, <a +href="glossaries-user.html#dx1-155008" >4274</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">none</span>  <a -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> +href="glossaries-user.html#dx1-5008" >4275</a>, <a +href="glossaries-user.html#dx1-5015" >4276</a>, <a +href="glossaries-user.html#dx1-10002" >4277</a>, <a +href="glossaries-user.html#dx1-11022" >4278</a>, <a +href="glossaries-user.html#dx1-72003" >4279</a>, <a +href="glossaries-user.html#dx1-74019" >4280</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">standard</span>  <a -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> +href="glossaries-user.html#dx1-74005" >4281</a>, <a +href="glossaries-user.html#dx1-74023" >4282</a>, <a +href="glossaries-user.html#dx1-74040" >4283</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">use</span>  <a -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> +href="glossaries-user.html#dx1-6009" >4284</a>, <a +href="glossaries-user.html#dx1-6018" >4285</a>, <a +href="glossaries-user.html#dx1-74004" >4286</a>, <a +href="glossaries-user.html#dx1-74012" >4287</a>, <a +href="glossaries-user.html#dx1-74015" >4288</a>, <a +href="glossaries-user.html#dx1-74018" >4289</a>, <a +href="glossaries-user.html#dx1-74021" >4290</a>, <a +href="glossaries-user.html#dx1-74035" >4291</a>, <a +href="glossaries-user.html#dx1-113088" >4292</a>, <a +href="glossaries-user.html#dx1-122005" >4293</a>, <a +href="glossaries-user.html#dx1-155009" >4294</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">style</span>  <a -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> +href="glossaries-user.html#x1-500002.3" >4295</a>, <a +href="glossaries-user.html#dx1-53005" >4296</a>, <a +href="glossaries-user.html#dx1-55002" >4297</a>, <a +href="glossaries-user.html#dx1-144033" >4298</a>, <a +href="glossaries-user.html#dx1-154005" >4299</a>, <a +href="glossaries-user.html#dx1-158008" >4300</a>, <a +href="glossaries-user.html#dx1-159008" >4301</a>, <a +href="glossaries-user.html#dx1-161008" >4302</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">index</span>  <a -href="glossaries-user.html#dx1-49003" >4250</a> <br /></span> +href="glossaries-user.html#dx1-50003" >4303</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">list</span>  <a -href="glossaries-user.html#dx1-49001" >4251</a> <br /></span> +href="glossaries-user.html#dx1-50001" >4304</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" >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> +href="glossaries-user.html#dx1-4013" >4305</a>, <a +href="glossaries-user.html#dx1-4014" >4306</a>, <a +href="glossaries-user.html#x1-610002.3" >4307</a>, <a +href="glossaries-user.html#dx1-181010" >4308</a>, <a +href="glossaries-user.html#dx1-182007" >4309</a>, <a +href="glossaries-user.html#dx1-191017" >4310</a>, <a +href="glossaries-user.html#dx1-205010" >4311</a>, <a +href="glossaries-user.html#dx1-205011" >4312</a>, <a +href="glossaries-user.html#dx1-205038" >4313</a>, <a +href="glossaries-user.html#dx1-207007" >4314</a>, <a +href="glossaries-user.html#dx1-222009" >4315</a>, <a +href="glossaries-user.html#dx1-222012" >4316</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">subentrycounter</span>  <a -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> +href="glossaries-user.html#x1-490002.3" >4317</a>, <a +href="glossaries-user.html#dx1-120001" >4318</a>, <a +href="glossaries-user.html#dx1-122007" >4319</a>, <a +href="glossaries-user.html#dx1-155003" >4320</a>, <a +href="glossaries-user.html#dx1-165066" >4321</a>, <a +href="glossaries-user.html#dx1-165086" >4322</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-48001" >4270</a> <br /></span> +href="glossaries-user.html#dx1-49001" >4323</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">symbols</span>  <a -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> +href="glossaries-user.html#dx1-4015" >4324</a>, <a +href="glossaries-user.html#dx1-6013" >4325</a>, <a +href="glossaries-user.html#dx1-7027" >4326</a>, <a +href="glossaries-user.html#dx1-8015" >4327</a>, <a +href="glossaries-user.html#dx1-8028" >4328</a>, <a +href="glossaries-user.html#dx1-85004" >4329</a>, <a +href="glossaries-user.html#x1-860002.6" >4330</a>, <a +href="glossaries-user.html#dx1-145021" >4331</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">toc</span>  <a -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> +href="glossaries-user.html#dx1-7051" >4332</a>, <a +href="glossaries-user.html#x1-400002.2" >4333</a>, <a +href="glossaries-user.html#dx1-41004" >4334</a>, <a +href="glossaries-user.html#dx1-41005" >4335</a>, <a +href="glossaries-user.html#dx1-144030" >4336</a>, <a +href="glossaries-user.html#dx1-181015" >4337</a>, <a +href="glossaries-user.html#dx1-182004" >4338</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-39003" >4286</a> <br /></span> +href="glossaries-user.html#dx1-40003" >4339</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-39004" >4287</a>, <a -href="glossaries-user.html#dx1-40001" >4288</a> <br /></span> +href="glossaries-user.html#dx1-40004" >4340</a>, <a +href="glossaries-user.html#dx1-41001" >4341</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">translate</span>  <a -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> - - +href="glossaries-user.html#x1-320002.1" >4342</a>, <a +href="glossaries-user.html#dx1-32023" >4343</a>, <a +href="glossaries-user.html#dx1-32025" >4344</a>, <a +href="glossaries-user.html#dx1-109013" >4345</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">babel</span>  <a -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> +href="glossaries-user.html#dx1-14012" >4346</a>, <a +href="glossaries-user.html#dx1-14017" >4347</a>, <a +href="glossaries-user.html#dx1-14039" >4348</a>, <a +href="glossaries-user.html#dx1-14043" >4349</a>, <a +href="glossaries-user.html#dx1-14051" >4350</a>, <a +href="glossaries-user.html#dx1-32017" >4351</a>, <a +href="glossaries-user.html#dx1-32020" >4352</a>, <a +href="glossaries-user.html#dx1-32032" >4353</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -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> +href="glossaries-user.html#dx1-14011" >4354</a>, <a +href="glossaries-user.html#dx1-32011" >4355</a>, <a +href="glossaries-user.html#dx1-32030" >4356</a>, <a +href="glossaries-user.html#dx1-33001" >4357</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -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> +href="glossaries-user.html#dx1-32001" >4358</a>, <a +href="glossaries-user.html#dx1-32022" >4359</a>, <a +href="glossaries-user.html#dx1-32024" >4360</a>, <a +href="glossaries-user.html#dx1-32026" >4361</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">ucmark</span>  <a -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> +href="glossaries-user.html#dx1-42007" >4362</a>, <a +href="glossaries-user.html#x1-430002.2" >4363</a>, <a +href="glossaries-user.html#dx1-43013" >4364</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">false</span>  <a -href="glossaries-user.html#dx1-42001" >4312</a> <br /></span> +href="glossaries-user.html#dx1-43001" >4365</a> <br /></span> <span class="index-subsubitem">        <span class="cmss-10">true</span>  <a -href="glossaries-user.html#dx1-42003" >4313</a> <br /></span> +href="glossaries-user.html#dx1-43003" >4366</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" >4314</a> <br /></span> +href="glossaries-user.html#x1-370002.1" >4367</a> <br /></span> +<span class="index-subitem">    <span +class="cmss-10">writeglslabelnames</span>  <a +href="glossaries-user.html#dx1-23002" >4368</a>, <a +href="glossaries-user.html#dx1-35003" >4369</a>, <a +href="glossaries-user.html#x1-360002.1" >4370</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">writeglslabels</span>  <a -href="glossaries-user.html#dx1-23001" >4315</a>, <a -href="glossaries-user.html#x1-350002.1" >4316</a> <br /></span> +href="glossaries-user.html#dx1-23001" >4371</a>, <a +href="glossaries-user.html#x1-350002.1" >4372</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">xindy</span>  <a -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> +href="glossaries-user.html#dx1-8021" >4373</a>, <a +href="glossaries-user.html#dx1-13008" >4374</a>, <a +href="glossaries-user.html#dx1-16092" >4375</a>, <a +href="glossaries-user.html#dx1-19003" >4376</a>, <a +href="glossaries-user.html#dx1-20002" >4377</a>, <a +href="glossaries-user.html#dx1-76008" >4378</a>, <a +href="glossaries-user.html#x1-770002.5" >4379</a>, <a +href="glossaries-user.html#dx1-78001" >4380</a>, <a +href="glossaries-user.html#dx1-109002" >4381</a>, <a +href="glossaries-user.html#dx1-109016" >4382</a>, <a +href="glossaries-user.html#dx1-166002" >4383</a>, <a +href="glossaries-user.html#dx1-168001" >4384</a>, <a +href="glossaries-user.html#dx1-169001" >4385</a>, <a +href="glossaries-user.html#dx1-213003" >4386</a>, <a +href="glossaries-user.html#dx1-215008" >4387</a>, <a +href="glossaries-user.html#dx1-217006" >4388</a>, <a +href="glossaries-user.html#dx1-217011" >4389</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">xindygloss</span>  <a -href="glossaries-user.html#x1-770002.5" >4334</a>, <a -href="glossaries-user.html#dx1-108003" >4335</a> <br /></span> +href="glossaries-user.html#x1-780002.5" >4390</a>, <a +href="glossaries-user.html#dx1-109003" >4391</a> <br /></span> <span class="index-subitem">    <span class="cmss-10">xindynoglsnumbers</span>  <a -href="glossaries-user.html#x1-780002.5" >4336</a>, <a -href="glossaries-user.html#dx1-108004" >4337</a> <br /></span> +href="glossaries-user.html#x1-790002.5" >4392</a>, <a +href="glossaries-user.html#dx1-109004" >4393</a> <br /></span> <span class="index-item"><span class="cmtt-10">page </span>(counter)  <a -href="glossaries-user.html#dx1-144039" >4338</a>, <a -href="glossaries-user.html#dx1-144045" >4339</a> <br /></span> +href="glossaries-user.html#dx1-168039" >4394</a>, <a +href="glossaries-user.html#dx1-168045" >4395</a> <br /></span> <span class="index-item">page type precedence  <a -href="glossaries-user.html#dx1-131005" >4340</a> <br /></span> +href="glossaries-user.html#dx1-153005" >4396</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" >4341</a> <br /></span> +href="glossaries-user.html#dx1-14030" >4397</a> <br /></span> <span class="index-item"><span class="cmtt-10">pdflatex</span>  <a -href="glossaries-user.html#dx1-27" >4342</a>, <a -href="glossaries-user.html#dx1-132019" >4343</a> <br /></span> +href="glossaries-user.html#dx1-26" >4398</a>, <a +href="glossaries-user.html#dx1-129017" >4399</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">4344</span></a> <br /></span> +href="glossaries-user.html#dx1-174028" ><span +class="cmti-10">4400</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">4345</span></a> <br /></span> +href="glossaries-user.html#dx1-174024" ><span +class="cmti-10">4401</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">4346</span></a>, <a -href="glossaries-user.html#dx1-178008" >4347</a> <br /></span> +href="glossaries-user.html#dx1-174021" ><span +class="cmti-10">4402</span></a>, <a +href="glossaries-user.html#dx1-181008" >4403</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">4348</span></a> <br /></span> +href="glossaries-user.html#dx1-174037" ><span +class="cmti-10">4404</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">4349</span></a> <br /></span> +href="glossaries-user.html#dx1-174033" ><span +class="cmti-10">4405</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">4350</span></a> <br /></span> +href="glossaries-user.html#dx1-174030" ><span +class="cmti-10">4406</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" >4351</a> <br /></span> +href="glossaries-user.html#dx1-205082" >4407</a> <br /></span> <span class="index-item"><span class="cmss-10">polyglossia </span>package  <a -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> +href="glossaries-user.html#dx1-14002" >4408</a>, <a +href="glossaries-user.html#dx1-14004" >4409</a>, <a +href="glossaries-user.html#dx1-14006" >4410</a>, <a +href="glossaries-user.html#dx1-14041" >4411</a>, <a +href="glossaries-user.html#dx1-32009" >4412</a>, <a +href="glossaries-user.html#dx1-32013" >4413</a>, <a +href="glossaries-user.html#dx1-32028" >4414</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" >4359</a> <br /></span> +href="glossaries-user.html#dx1-193020" >4415</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">4360</span></a>, <a -href="glossaries-user.html#dx1-147004" >4361</a>, <a -href="glossaries-user.html#dx1-151006" >4362</a> <br /></span> +href="glossaries-user.html#dx1-91001" ><span +class="cmti-10">4416</span></a>, <a +href="glossaries-user.html#dx1-135004" >4417</a>, <a +href="glossaries-user.html#dx1-140006" >4418</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" >4363</a>, <a -href="glossaries-user.html#dx1-141004" ><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> +href="glossaries-user.html#dx1-124002" >4419</a>, <a +href="glossaries-user.html#dx1-140010" >4420</a>, <a +href="glossaries-user.html#dx1-144004" ><span +class="cmti-10">4421</span></a>, <a +href="glossaries-user.html#dx1-145009" >4422</a>, <a +href="glossaries-user.html#dx1-165070" >4423</a>, <a +href="glossaries-user.html#dx1-172005" >4424</a>, <a +href="glossaries-user.html#dx1-193030" >4425</a>, <a +href="glossaries-user.html#dx1-201010" >4426</a>, <a +href="glossaries-user.html#dx1-214049" >4427</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" >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">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> +href="glossaries-user.html#dx1-7002" >4428</a>, <a +href="glossaries-user.html#dx1-8002" >4429</a>, <a +href="glossaries-user.html#dx1-55005" >4430</a>, <a +href="glossaries-user.html#dx1-86002" >4431</a>, <a +href="glossaries-user.html#dx1-87002" >4432</a>, <a +href="glossaries-user.html#dx1-88005" >4433</a>, <a +href="glossaries-user.html#dx1-91002" >4434</a>, <a +href="glossaries-user.html#dx1-135003" >4435</a>, <a +href="glossaries-user.html#dx1-140003" >4436</a>, <a +href="glossaries-user.html#dx1-140007" >4437</a>, <a +href="glossaries-user.html#dx1-144019" ><span +class="cmti-10">4438</span></a>, <a +href="glossaries-user.html#dx1-154003" >4439</a>, <a +href="glossaries-user.html#dx1-155032" >4440</a>, <a +href="glossaries-user.html#dx1-165069" >4441</a>, <a +href="glossaries-user.html#dx1-172004" >4442</a>, <a +href="glossaries-user.html#dx1-191038" >4443</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" >4388</a> <br /></span> +href="glossaries-user.html#dx1-144041" >4444</a> <br /></span> +<span class="index-subitem">    <sup class="textsuperscript"><span +class="tcrm-0900">†</span></sup><span +class="cmtt-10">groups</span>  <a +href="glossaries-user.html#dx1-144072" >4445</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" >4389</a> <br /></span> +href="glossaries-user.html#dx1-144064" >4446</a> <br /></span> +<span class="index-subitem">    <sup class="textsuperscript"><span +class="tcrm-0900">†</span></sup><span +class="cmtt-10">leveloffset</span>  <a +href="glossaries-user.html#dx1-144073" >4447</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">nogroupskip</span>  <a -href="glossaries-user.html#dx1-141032" >4390</a> <br /></span> +href="glossaries-user.html#dx1-144039" >4448</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">nonumberlist</span>  <a -href="glossaries-user.html#dx1-141031" >4391</a> <br /></span> +href="glossaries-user.html#dx1-144038" >4449</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">nopostdot</span>  <a -href="glossaries-user.html#dx1-141033" >4392</a> <br /></span> +href="glossaries-user.html#dx1-144040" >4450</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">numberedsection</span>  <a -href="glossaries-user.html#dx1-141028" >4393</a> <br /></span> +href="glossaries-user.html#dx1-144035" >4451</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" >4394</a> <br /></span> +href="glossaries-user.html#dx1-144068" >4452</a> <br /></span> + + <span class="index-subitem">    <span class="cmtt-10">style</span>  <a -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> +href="glossaries-user.html#dx1-55004" >4453</a>, <a +href="glossaries-user.html#dx1-144032" >4454</a>, <a +href="glossaries-user.html#dx1-154001" >4455</a>, <a +href="glossaries-user.html#dx1-155030" >4456</a>, <a +href="glossaries-user.html#dx1-159019" >4457</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">subentrycounter</span>  <a -href="glossaries-user.html#dx1-141036" >4400</a> <br /></span> +href="glossaries-user.html#dx1-144043" >4458</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" >4401</a>, <a -href="glossaries-user.html#dx1-141059" >4402</a> <br /></span> +href="glossaries-user.html#dx1-11081" >4459</a>, <a +href="glossaries-user.html#dx1-144066" >4460</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" >4403</a> <br /></span> +href="glossaries-user.html#dx1-144070" >4461</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">title</span>  <a -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> +href="glossaries-user.html#dx1-4" >4462</a>, <a +href="glossaries-user.html#dx1-14045" >4463</a>, <a +href="glossaries-user.html#dx1-135002" >4464</a>, <a +href="glossaries-user.html#dx1-144028" >4465</a>, <a +href="glossaries-user.html#dx1-144031" >4466</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">toctitle</span>  <a -href="glossaries-user.html#dx1-141022" >4409</a> <br /></span> +href="glossaries-user.html#dx1-144029" >4467</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">type</span>  <a -href="glossaries-user.html#dx1-141018" >4410</a>, <a -href="glossaries-user.html#dx1-141019" >4411</a> <br /></span> +href="glossaries-user.html#dx1-144024" >4468</a>, <a +href="glossaries-user.html#dx1-144025" >4469</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">4412</span></a> <br /></span> +href="glossaries-user.html#dx1-88004" ><span +class="cmti-10">4470</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">4413</span></a>, <a -href="glossaries-user.html#dx1-151009" >4414</a> <br /></span> +href="glossaries-user.html#dx1-140009" >4471</a>, <a +href="glossaries-user.html#dx1-144002" ><span +class="cmti-10">4472</span></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" >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">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> +href="glossaries-user.html#dx1-6002" >4473</a>, <a +href="glossaries-user.html#dx1-74002" >4474</a>, <a +href="glossaries-user.html#dx1-74039" >4475</a>, <a +href="glossaries-user.html#dx1-75006" >4476</a>, <a +href="glossaries-user.html#dx1-86003" >4477</a>, <a +href="glossaries-user.html#dx1-87003" >4478</a>, <a +href="glossaries-user.html#dx1-88006" >4479</a>, <a +href="glossaries-user.html#dx1-91004" >4480</a>, <a +href="glossaries-user.html#dx1-140001" >4481</a>, <a +href="glossaries-user.html#dx1-144017" ><span +class="cmti-10">4482</span></a>, <a +href="glossaries-user.html#dx1-154002" >4483</a>, <a +href="glossaries-user.html#dx1-155031" >4484</a>, <a +href="glossaries-user.html#dx1-201011" >4485</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" >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> +href="glossaries-user.html#dx1-74001" >4486</a>, <a +href="glossaries-user.html#dx1-74038" >4487</a>, <a +href="glossaries-user.html#dx1-75005" >4488</a>, <a +href="glossaries-user.html#dx1-144048" >4489</a>, <a +href="glossaries-user.html#dx1-201013" >4490</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">4433</span></a> <br /></span> +href="glossaries-user.html#dx1-87001" ><span +class="cmti-10">4491</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">4434</span></a> <br /></span> +href="glossaries-user.html#dx1-86001" ><span +class="cmti-10">4492</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" >4435</a> <br /></span> +href="glossaries-user.html#dx1-226015" >4493</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" >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> +href="glossaries-user.html#dx1-4010" >4494</a>, <a +href="glossaries-user.html#dx1-9032" >4495</a>, <a +href="glossaries-user.html#dx1-10005" >4496</a>, <a +href="glossaries-user.html#dx1-178058" >4497</a>, <a +href="glossaries-user.html#dx1-193031" >4498</a>, <a +href="glossaries-user.html#dx1-195059" >4499</a>, <a +href="glossaries-user.html#dx1-196022" >4500</a>, <a +href="glossaries-user.html#dx1-200028" >4501</a>, <a +href="glossaries-user.html#dx1-201039" >4502</a>, <a +href="glossaries-user.html#dx1-203090" >4503</a>, <a +href="glossaries-user.html#dx1-205059" >4504</a>, <a +href="glossaries-user.html#dx1-207027" >4505</a>, <a +href="glossaries-user.html#dx1-209019" >4506</a>, <a +href="glossaries-user.html#dx1-214050" >4507</a>, <a +href="glossaries-user.html#dx1-215013" >4508</a>, <a +href="glossaries-user.html#dx1-217035" >4509</a>, <a +href="glossaries-user.html#dx1-223026" >4510</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">\printunsrtglossaries</span></span></span>  <a +href="glossaries-user.html#dx1-144005" ><span +class="cmti-10">4511</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">\printunsrtglossary</span></span></span>  <a -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> +href="glossaries-user.html#dx1-9005" >4512</a>, <a +href="glossaries-user.html#dx1-9031" >4513</a>, <a +href="glossaries-user.html#dx1-10001" >4514</a>, <a +href="glossaries-user.html#dx1-10004" >4515</a>, <a +href="glossaries-user.html#dx1-11080" >4516</a>, <a +href="glossaries-user.html#dx1-144021" >4517</a>, <a +href="glossaries-user.html#dx1-144027" >4518</a>, <a +href="glossaries-user.html#dx1-144067" >4519</a>, <a +href="glossaries-user.html#dx1-144074" >4520</a>, <a +href="glossaries-user.html#dx1-182072" >4521</a>, <a +href="glossaries-user.html#dx1-191039" >4522</a>, <a +href="glossaries-user.html#dx1-191040" >4523</a>, <a +href="glossaries-user.html#dx1-196050" >4524</a>, <a +href="glossaries-user.html#dx1-196051" >4525</a>, <a +href="glossaries-user.html#dx1-197039" >4526</a>, <a +href="glossaries-user.html#dx1-223038" >4527</a>, <a +href="glossaries-user.html#dx1-226014" >4528</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">\printunsrtinnerglossary</span></span></span>  <a +href="glossaries-user.html#dx1-144023" >4529</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" >4467</a>, <a -href="glossaries-user.html#dx1-197033" >4468</a> <br /></span> +href="glossaries-user.html#dx1-200022" >4530</a>, <a +href="glossaries-user.html#dx1-200033" >4531</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">4469</span></a>, <a -href="glossaries-user.html#dx1-122030" >4470</a> <br /></span> +href="glossaries-user.html#dx1-113010" ><span +class="cmti-10">4532</span></a>, <a +href="glossaries-user.html#dx1-123030" >4533</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" >4471</a> <br /></span> +href="glossaries-user.html#dx1-145013" >4534</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" >4472</a>, <a -href="glossaries-user.html#dx1-98002" >4473</a>, <a -href="glossaries-user.html#dx1-149016" >4474</a> <br /></span> +href="glossaries-user.html#dx1-3065" >4535</a>, <a +href="glossaries-user.html#dx1-99002" >4536</a>, <a +href="glossaries-user.html#dx1-138016" >4537</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" >4475</a> <br /></span> +href="glossaries-user.html#dx1-168035" >4538</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" >4476</a> <br /></span> +href="glossaries-user.html#dx1-193045" >4539</a> <br /></span> <span class="index-item">sanitize  <a href="glossaries-user.html#dx1-3061" ><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> +class="cmbx-10">4540</span></a>, <a +href="glossaries-user.html#dx1-73001" >4541</a>, <a +href="glossaries-user.html#dx1-74030" >4542</a>, <a +href="glossaries-user.html#dx1-134055" >4543</a>, <a +href="glossaries-user.html#dx1-148015" >4544</a> <br /></span> <span class="index-item"><span class="cmss-10">scrwfile </span>package  <a -href="glossaries-user.html#dx1-31007" >4482</a> <br /></span> +href="glossaries-user.html#dx1-31007" >4545</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" >4483</a>, <a -href="glossaries-user.html#dx1-141066" >4484</a> <br /></span> +href="glossaries-user.html#dx1-44013" >4546</a>, <a +href="glossaries-user.html#dx1-144076" >4547</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" >4485</a>, <a -href="glossaries-user.html#dx1-112133" >4486</a> <br /></span> +href="glossaries-user.html#dx1-113152" >4548</a>, <a +href="glossaries-user.html#dx1-113153" >4549</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" >4487</a>, <a -href="glossaries-user.html#dx1-138018" >4488</a>, <a -href="glossaries-user.html#dx1-139006" >4489</a> <br /></span> +href="glossaries-user.html#dx1-147014" >4550</a>, <a +href="glossaries-user.html#dx1-147021" >4551</a>, <a +href="glossaries-user.html#dx1-148006" >4552</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" >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> +href="glossaries-user.html#dx1-4007" >4553</a>, <a +href="glossaries-user.html#dx1-135016" >4554</a>, <a +href="glossaries-user.html#dx1-137001" >4555</a>, <a +href="glossaries-user.html#dx1-178021" >4556</a>, <a +href="glossaries-user.html#dx1-178027" >4557</a>, <a +href="glossaries-user.html#dx1-178028" >4558</a>, <a +href="glossaries-user.html#dx1-178055" >4559</a>, <a +href="glossaries-user.html#dx1-181022" >4560</a>, <a +href="glossaries-user.html#dx1-181024" >4561</a>, <a +href="glossaries-user.html#dx1-181031" >4562</a>, <a +href="glossaries-user.html#dx1-181033" >4563</a>, <a +href="glossaries-user.html#dx1-182012" >4564</a>, <a +href="glossaries-user.html#dx1-182018" >4565</a>, <a +href="glossaries-user.html#dx1-182052" >4566</a>, <a +href="glossaries-user.html#dx1-182057" >4567</a>, <a +href="glossaries-user.html#dx1-182063" >4568</a>, <a +href="glossaries-user.html#dx1-182073" >4569</a>, <a +href="glossaries-user.html#dx1-184003" >4570</a>, <a +href="glossaries-user.html#dx1-185004" >4571</a>, <a +href="glossaries-user.html#dx1-185036" >4572</a>, <a +href="glossaries-user.html#dx1-187047" >4573</a>, <a +href="glossaries-user.html#dx1-187052" >4574</a>, <a +href="glossaries-user.html#dx1-188004" >4575</a>, <a +href="glossaries-user.html#dx1-188005" >4576</a>, <a +href="glossaries-user.html#dx1-189003" >4577</a>, <a +href="glossaries-user.html#dx1-189013" >4578</a>, <a +href="glossaries-user.html#dx1-189029" >4579</a>, <a +href="glossaries-user.html#dx1-196025" >4580</a>, <a +href="glossaries-user.html#dx1-196043" >4581</a>, <a +href="glossaries-user.html#dx1-201007" >4582</a>, <a +href="glossaries-user.html#dx1-201033" >4583</a>, <a +href="glossaries-user.html#dx1-210004" >4584</a>, <a +href="glossaries-user.html#dx1-226011" >4585</a>, <a +href="glossaries-user.html#dx1-227066" >4586</a>, <a +href="glossaries-user.html#dx1-227072" >4587</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" >4523</a> <br /></span> +href="glossaries-user.html#dx1-227045" >4588</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">4524</span></a> <br /></span> +href="glossaries-user.html#dx1-94005" ><span +class="cmti-10">4589</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" >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">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> +href="glossaries-user.html#dx1-96001" >4590</a>, <a +href="glossaries-user.html#dx1-130017" >4591</a>, <a +href="glossaries-user.html#dx1-135032" >4592</a>, <a +href="glossaries-user.html#dx1-137004" ><span +class="cmti-10">4593</span></a>, <a +href="glossaries-user.html#dx1-139016" >4594</a>, <a +href="glossaries-user.html#dx1-181023" >4595</a>, <a +href="glossaries-user.html#dx1-189002" >4596</a>, <a +href="glossaries-user.html#dx1-227035" >4597</a>, <a +href="glossaries-user.html#dx1-227036" >4598</a>, <a +href="glossaries-user.html#dx1-227037" >4599</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" >4535</a>, <a -href="glossaries-user.html#dx1-166056" >4536</a> <br /></span> +href="glossaries-user.html#dx1-165054" >4600</a>, <a +href="glossaries-user.html#dx1-165057" >4601</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" >4537</a>, <a -href="glossaries-user.html#dx1-141075" ><span -class="cmti-10">4538</span></a> <br /></span> +href="glossaries-user.html#dx1-48008" >4602</a>, <a +href="glossaries-user.html#dx1-144085" ><span +class="cmti-10">4603</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">4539</span></a>, <a -href="glossaries-user.html#dx1-141069" >4540</a> <br /></span> +href="glossaries-user.html#dx1-42002" ><span +class="cmti-10">4604</span></a>, <a +href="glossaries-user.html#dx1-144079" >4605</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" >4541</a>, <a -href="glossaries-user.html#dx1-155004" ><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> +href="glossaries-user.html#dx1-55003" >4606</a>, <a +href="glossaries-user.html#dx1-154004" ><span +class="cmti-10">4607</span></a>, <a +href="glossaries-user.html#dx1-155034" >4608</a>, <a +href="glossaries-user.html#dx1-155037" >4609</a>, <a +href="glossaries-user.html#dx1-163014" >4610</a>, <a +href="glossaries-user.html#dx1-164006" >4611</a>, <a +href="glossaries-user.html#dx1-165092" >4612</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" >4548</a>, <a -href="glossaries-user.html#dx1-20008" >4549</a>, <a -href="glossaries-user.html#dx1-111015" ><span -class="cmti-10">4550</span></a> <br /></span> +href="glossaries-user.html#dx1-19014" >4613</a>, <a +href="glossaries-user.html#dx1-20008" >4614</a>, <a +href="glossaries-user.html#dx1-112015" ><span +class="cmti-10">4615</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">4551</span></a> <br /></span> +href="glossaries-user.html#dx1-109001" ><span +class="cmti-10">4616</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" >4552</a> <br /></span> +href="glossaries-user.html#dx1-205081" >4617</a> <br /></span> <span class="index-item"><span class="cmss-10">siunitx </span>package  <a -href="glossaries-user.html#dx1-4006" >4553</a>, <a -href="glossaries-user.html#dx1-222001" >4554</a> <br /></span> +href="glossaries-user.html#dx1-4006" >4618</a>, <a +href="glossaries-user.html#dx1-225001" >4619</a> <br /></span> <span class="index-item">small caps  <a href="glossaries-user.html#dx1-3063" ><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> +class="cmbx-10">4620</span></a>, <a +href="glossaries-user.html#dx1-135044" >4621</a>, <a +href="glossaries-user.html#dx1-138009" >4622</a>, <a +href="glossaries-user.html#dx1-138090" >4623</a>, <a +href="glossaries-user.html#dx1-138092" >4624</a>, <a +href="glossaries-user.html#dx1-139059" >4625</a>, <a +href="glossaries-user.html#dx1-164017" >4626</a>, <a +href="glossaries-user.html#dx1-187002" >4627</a>, <a +href="glossaries-user.html#dx1-187061" >4628</a>, <a +href="glossaries-user.html#dx1-207014" >4629</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" >4565</a> <br /></span> +href="glossaries-user.html#dx1-181007" >4630</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> +class="cmbx-10">4631</span></a>, <a +href="glossaries-user.html#dx1-113179" >4632</a> <br /></span> <span class="index-item"><span class="cmss-10">stix </span>package  <a -href="glossaries-user.html#dx1-144038" >4568</a>, <a -href="glossaries-user.html#dx1-211024" >4569</a> <br /></span> +href="glossaries-user.html#dx1-168038" >4633</a>, <a +href="glossaries-user.html#dx1-214024" >4634</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">4570</span></a> <br /></span> +href="glossaries-user.html#dx1-165063" ><span +class="cmti-10">4635</span></a> <br /></span> <span class="index-item"><span class="cmss-10">supertabular </span>package  <a -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> +href="glossaries-user.html#dx1-52002" >4636</a>, <a +href="glossaries-user.html#dx1-160015" >4637</a>, <a +href="glossaries-user.html#dx1-161012" >4638</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" >4574</a> <br /></span> +href="glossaries-user.html#dx1-14029" >4639</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" >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> - - +href="glossaries-user.html#dx1-130005" >4640</a>, <a +href="glossaries-user.html#dx1-130007" >4641</a>, <a +href="glossaries-user.html#dx1-130009" >4642</a>, <a +href="glossaries-user.html#dx1-142026" >4643</a> <br /></span> <span class="index-item"><span class="cmss-10">tagpdf </span>package  <a -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> +href="glossaries-user.html#dx1-175058" >4644</a>, <a +href="glossaries-user.html#dx1-175088" >4645</a>, <a +href="glossaries-user.html#dx1-227008" >4646</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" >4582</a>, <a -href="glossaries-user.html#dx1-132014" >4583</a> <br /></span> +href="glossaries-user.html#dx1-11050" >4647</a>, <a +href="glossaries-user.html#dx1-129012" >4648</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" >4584</a>, <a -href="glossaries-user.html#dx1-189006" >4585</a> <br /></span> +href="glossaries-user.html#dx1-129044" >4649</a>, <a +href="glossaries-user.html#dx1-192006" >4650</a> <br /></span> <span class="index-item"><span class="cmss-10">textcase </span>package  <a -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> +href="glossaries-user.html#dx1-9" >4651</a>, <a +href="glossaries-user.html#dx1-43008" >4652</a>, <a +href="glossaries-user.html#dx1-43010" >4653</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" >4589</a> <br /></span> +href="glossaries-user.html#dx1-168012" >4654</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" >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> +href="glossaries-user.html#dx1-3064" >4655</a>, <a +href="glossaries-user.html#dx1-138008" >4656</a>, <a +href="glossaries-user.html#dx1-138011" >4657</a>, <a +href="glossaries-user.html#dx1-139036" >4658</a>, <a +href="glossaries-user.html#dx1-139042" >4659</a>, <a +href="glossaries-user.html#dx1-139043" >4660</a>, <a +href="glossaries-user.html#dx1-139058" >4661</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" >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> +href="glossaries-user.html#dx1-3066" >4662</a>, <a +href="glossaries-user.html#dx1-99003" >4663</a>, <a +href="glossaries-user.html#dx1-138013" >4664</a>, <a +href="glossaries-user.html#dx1-138014" >4665</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" >4601</a> <br /></span> +href="glossaries-user.html#dx1-139037" >4666</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" >4602</a> <br /></span> +href="glossaries-user.html#dx1-139038" >4667</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" >4603</a>, <a -href="glossaries-user.html#dx1-150027" >4604</a> <br /></span> +href="glossaries-user.html#dx1-139027" >4668</a>, <a +href="glossaries-user.html#dx1-151026" >4669</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">4605</span></a> <br /></span> +href="glossaries-user.html#dx1-165003" ><span +class="cmti-10">4670</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" >4606</a> <br /></span> +href="glossaries-user.html#dx1-191009" >4671</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" >4607</a>, <a -href="glossaries-user.html#dx1-211025" >4608</a> <br /></span> +href="glossaries-user.html#dx1-168051" >4672</a>, <a +href="glossaries-user.html#dx1-214025" >4673</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" >4609</a> <br /></span> +href="glossaries-user.html#dx1-159012" >4674</a> <br /></span> <span class="index-item"><span class="cmss-10">tracklang </span>package  <a -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> +href="glossaries-user.html#dx1-5" >4675</a>, <a +href="glossaries-user.html#dx1-15001" >4676</a>, <a +href="glossaries-user.html#dx1-15002" >4677</a> <br /></span> <span class="index-item"><span class="cmss-10">translator </span>package  <a -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> +href="glossaries-user.html#dx1-14009" >4678</a>, <a +href="glossaries-user.html#dx1-14013" >4679</a>, <a +href="glossaries-user.html#dx1-14014" >4680</a>, <a +href="glossaries-user.html#dx1-14015" >4681</a>, <a +href="glossaries-user.html#dx1-14020" >4682</a>, <a +href="glossaries-user.html#dx1-14021" >4683</a>, <a +href="glossaries-user.html#dx1-14033" >4684</a>, <a +href="glossaries-user.html#dx1-14035" >4685</a>, <a +href="glossaries-user.html#dx1-14036" >4686</a>, <a +href="glossaries-user.html#dx1-14038" >4687</a>, <a +href="glossaries-user.html#dx1-14044" >4688</a>, <a +href="glossaries-user.html#dx1-14046" >4689</a>, <a +href="glossaries-user.html#dx1-14047" >4690</a>, <a +href="glossaries-user.html#dx1-14050" >4691</a>, <a +href="glossaries-user.html#dx1-15005" >4692</a>, <a +href="glossaries-user.html#dx1-15006" >4693</a>, <a +href="glossaries-user.html#dx1-15007" >4694</a>, <a +href="glossaries-user.html#dx1-15012" >4695</a>, <a +href="glossaries-user.html#dx1-32003" >4696</a>, <a +href="glossaries-user.html#dx1-32004" >4697</a>, <a +href="glossaries-user.html#dx1-32005" >4698</a>, <a +href="glossaries-user.html#dx1-32006" >4699</a>, <a +href="glossaries-user.html#dx1-32018" >4700</a>, <a +href="glossaries-user.html#dx1-32029" >4701</a>, <a +href="glossaries-user.html#dx1-145026" >4702</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" >4638</a> <br /></span> +href="glossaries-user.html#dx1-196042" >4703</a> <br /></span> +<span class="index-item">UTF-8  <a +href="glossaries-user.html#dx1-3069" ><span +class="cmbx-10">4704</span></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" >4639</a>, <a -href="glossaries-user.html#dx1-79004" >4640</a> <br /></span> +href="glossaries-user.html#dx1-31012" >4705</a>, <a +href="glossaries-user.html#dx1-80004" >4706</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" >4641</a> <br /></span> +href="glossaries-user.html#dx1-153001" >4707</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" >4642</a> <br /></span> +href="glossaries-user.html#dx1-10" >4708</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" >4643</a> <br /></span> +href="glossaries-user.html#dx1-212011" >4709</a> <br /></span> + + <span class="index-item"><span class="cmtt-10">xindy</span>  <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">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> +href="glossaries-user.html#dx1-3005" >4710</a>, <a +href="glossaries-user.html#dx1-3037" >4711</a>, <a +href="glossaries-user.html#dx1-3045" >4712</a>, <a +href="glossaries-user.html#dx1-3050" >4713</a>, <a +href="glossaries-user.html#dx1-3070" ><span +class="cmbx-10">4714</span></a>, <a +href="glossaries-user.html#dx1-4016" >4715</a>, <a +href="glossaries-user.html#dx1-4017" >4716</a>, <a +href="glossaries-user.html#dx1-8005" >4717</a>, <a +href="glossaries-user.html#dx1-8006" >4718</a>, <a +href="glossaries-user.html#dx1-8007" >4719</a>, <a +href="glossaries-user.html#dx1-8008" >4720</a>, <a +href="glossaries-user.html#dx1-8009" >4721</a>, <a +href="glossaries-user.html#dx1-8010" >4722</a>, <a +href="glossaries-user.html#dx1-8011" >4723</a>, <a +href="glossaries-user.html#dx1-8012" >4724</a>, <a +href="glossaries-user.html#dx1-8013" >4725</a>, <a +href="glossaries-user.html#dx1-8031" >4726</a>, <a +href="glossaries-user.html#dx1-8035" >4727</a>, <a +href="glossaries-user.html#dx1-8036" >4728</a>, <a +href="glossaries-user.html#dx1-8039" >4729</a>, <a +href="glossaries-user.html#dx1-8041" >4730</a>, <a +href="glossaries-user.html#dx1-8042" >4731</a>, <a +href="glossaries-user.html#dx1-8043" >4732</a>, <a +href="glossaries-user.html#dx1-8046" >4733</a>, <a +href="glossaries-user.html#dx1-8047" >4734</a>, <a +href="glossaries-user.html#dx1-8051" >4735</a>, <a +href="glossaries-user.html#dx1-8052" >4736</a>, <a +href="glossaries-user.html#dx1-8053" >4737</a>, <a +href="glossaries-user.html#dx1-9035" >4738</a>, <a +href="glossaries-user.html#dx1-13001" >4739</a>, <a +href="glossaries-user.html#dx1-13003" >4740</a>, <a +href="glossaries-user.html#dx1-13007" >4741</a>, <a +href="glossaries-user.html#dx1-13019" >4742</a>, <a +href="glossaries-user.html#dx1-13025" >4743</a>, <a +href="glossaries-user.html#dx1-13028" >4744</a>, <a +href="glossaries-user.html#dx1-13044" >4745</a>, <a +href="glossaries-user.html#dx1-14052" >4746</a>, <a +href="glossaries-user.html#dx1-14056" >4747</a>, <a +href="glossaries-user.html#dx1-16009" >4748</a>, <a +href="glossaries-user.html#dx1-16013" >4749</a>, <a +href="glossaries-user.html#dx1-16016" >4750</a>, <a +href="glossaries-user.html#dx1-16018" >4751</a>, <a +href="glossaries-user.html#dx1-16025" >4752</a>, <a +href="glossaries-user.html#dx1-16027" >4753</a>, <a +href="glossaries-user.html#dx1-16030" >4754</a>, <a +href="glossaries-user.html#dx1-16033" >4755</a>, <a +href="glossaries-user.html#dx1-16036" >4756</a>, <a +href="glossaries-user.html#dx1-16039" >4757</a>, <a +href="glossaries-user.html#dx1-16041" >4758</a>, <a +href="glossaries-user.html#dx1-16048" >4759</a>, <a +href="glossaries-user.html#dx1-16061" >4760</a>, <a +href="glossaries-user.html#dx1-16064" >4761</a>, <a +href="glossaries-user.html#dx1-16067" >4762</a>, <a +href="glossaries-user.html#dx1-16072" >4763</a>, <a +href="glossaries-user.html#dx1-16079" >4764</a>, <a +href="glossaries-user.html#dx1-16084" >4765</a>, <a +href="glossaries-user.html#dx1-16087" >4766</a>, <a +href="glossaries-user.html#dx1-17003" >4767</a>, <a +href="glossaries-user.html#dx1-17011" >4768</a>, <a +href="glossaries-user.html#dx1-17022" >4769</a>, <a +href="glossaries-user.html#dx1-17026" >4770</a>, <a +href="glossaries-user.html#dx1-17032" >4771</a>, <a +href="glossaries-user.html#dx1-17033" >4772</a>, <a +href="glossaries-user.html#x1-190001.4.3" >4773</a>, <a +href="glossaries-user.html#dx1-19001" >4774</a>, <a +href="glossaries-user.html#dx1-19002" >4775</a>, <a +href="glossaries-user.html#dx1-19004" >4776</a>, <a +href="glossaries-user.html#dx1-19006" >4777</a>, <a +href="glossaries-user.html#dx1-19009" >4778</a>, <a +href="glossaries-user.html#dx1-19011" >4779</a>, <a +href="glossaries-user.html#dx1-19022" >4780</a>, <a +href="glossaries-user.html#dx1-19024" >4781</a>, <a +href="glossaries-user.html#dx1-21001" >4782</a>, <a +href="glossaries-user.html#dx1-22003" >4783</a>, <a +href="glossaries-user.html#dx1-22008" >4784</a>, <a +href="glossaries-user.html#dx1-22013" >4785</a>, <a +href="glossaries-user.html#dx1-22015" >4786</a>, <a +href="glossaries-user.html#dx1-22018" >4787</a>, <a +href="glossaries-user.html#dx1-31014" >4788</a>, <a +href="glossaries-user.html#dx1-31017" >4789</a>, <a +href="glossaries-user.html#dx1-47008" >4790</a>, <a +href="glossaries-user.html#dx1-56003" >4791</a>, <a +href="glossaries-user.html#dx1-56006" >4792</a>, <a +href="glossaries-user.html#dx1-64006" >4793</a>, <a +href="glossaries-user.html#dx1-64008" >4794</a>, <a +href="glossaries-user.html#dx1-68009" >4795</a>, <a +href="glossaries-user.html#dx1-74028" >4796</a>, <a +href="glossaries-user.html#dx1-76006" >4797</a>, <a +href="glossaries-user.html#dx1-77001" >4798</a>, <a +href="glossaries-user.html#dx1-77003" >4799</a>, <a +href="glossaries-user.html#dx1-77005" >4800</a>, <a +href="glossaries-user.html#dx1-77008" >4801</a>, <a +href="glossaries-user.html#dx1-80003" >4802</a>, <a +href="glossaries-user.html#dx1-80007" >4803</a>, <a +href="glossaries-user.html#dx1-80013" >4804</a>, <a +href="glossaries-user.html#dx1-80016" >4805</a>, <a +href="glossaries-user.html#dx1-80017" >4806</a>, <a +href="glossaries-user.html#dx1-80018" >4807</a>, <a +href="glossaries-user.html#dx1-112004" >4808</a>, <a +href="glossaries-user.html#dx1-112006" >4809</a>, <a +href="glossaries-user.html#dx1-113106" >4810</a>, <a +href="glossaries-user.html#dx1-113108" >4811</a>, <a +href="glossaries-user.html#dx1-113177" >4812</a>, <a +href="glossaries-user.html#dx1-129004" >4813</a>, <a +href="glossaries-user.html#dx1-129046" >4814</a>, <a +href="glossaries-user.html#dx1-129050" >4815</a>, <a +href="glossaries-user.html#dx1-129054" >4816</a>, <a +href="glossaries-user.html#dx1-129073" >4817</a>, <a +href="glossaries-user.html#dx1-134064" >4818</a>, <a +href="glossaries-user.html#dx1-144009" >4819</a>, <a +href="glossaries-user.html#dx1-144014" >4820</a>, <a +href="glossaries-user.html#dx1-144050" >4821</a>, <a +href="glossaries-user.html#dx1-145004" >4822</a>, <a +href="glossaries-user.html#dx1-149007" >4823</a>, <a +href="glossaries-user.html#dx1-150011" >4824</a>, <a +href="glossaries-user.html#dx1-150012" >4825</a>, <a +href="glossaries-user.html#dx1-151004" >4826</a>, <a +href="glossaries-user.html#dx1-151007" >4827</a>, <a +href="glossaries-user.html#dx1-151013" >4828</a>, <a +href="glossaries-user.html#dx1-151014" >4829</a>, <a +href="glossaries-user.html#dx1-151020" >4830</a>, <a +href="glossaries-user.html#dx1-151021" >4831</a>, <a +href="glossaries-user.html#dx1-151024" >4832</a>, <a +href="glossaries-user.html#dx1-152002" >4833</a>, <a +href="glossaries-user.html#dx1-152003" >4834</a>, <a +href="glossaries-user.html#dx1-152008" >4835</a>, <a +href="glossaries-user.html#dx1-152011" >4836</a>, <a +href="glossaries-user.html#dx1-153007" >4837</a>, <a +href="glossaries-user.html#dx1-162032" >4838</a>, <a +href="glossaries-user.html#dx1-165026" >4839</a>, <a +href="glossaries-user.html#dx1-165030" >4840</a>, <a +href="glossaries-user.html#dx1-166001" >4841</a>, <a +href="glossaries-user.html#dx1-166003" >4842</a>, <a +href="glossaries-user.html#dx1-166004" >4843</a>, <a +href="glossaries-user.html#dx1-166006" >4844</a>, <a +href="glossaries-user.html#dx1-166011" >4845</a>, <a +href="glossaries-user.html#dx1-166015" >4846</a>, <a +href="glossaries-user.html#dx1-166016" >4847</a>, <a +href="glossaries-user.html#dx1-166018" >4848</a>, <a +href="glossaries-user.html#dx1-166019" >4849</a>, <a +href="glossaries-user.html#dx1-166020" >4850</a>, <a +href="glossaries-user.html#dx1-166021" >4851</a>, <a +href="glossaries-user.html#dx1-167001" >4852</a>, <a +href="glossaries-user.html#dx1-167002" >4853</a>, <a +href="glossaries-user.html#dx1-167006" >4854</a>, <a +href="glossaries-user.html#dx1-167011" >4855</a>, <a +href="glossaries-user.html#dx1-167014" >4856</a>, <a +href="glossaries-user.html#dx1-168003" >4857</a>, <a +href="glossaries-user.html#dx1-168014" >4858</a>, <a +href="glossaries-user.html#dx1-168021" >4859</a>, <a +href="glossaries-user.html#dx1-168028" >4860</a>, <a +href="glossaries-user.html#dx1-168040" >4861</a>, <a +href="glossaries-user.html#dx1-168047" >4862</a>, <a +href="glossaries-user.html#dx1-168067" >4863</a>, <a +href="glossaries-user.html#dx1-169002" >4864</a>, <a +href="glossaries-user.html#dx1-169003" >4865</a>, <a +href="glossaries-user.html#dx1-178016" >4866</a>, <a +href="glossaries-user.html#dx1-178042" >4867</a>, <a +href="glossaries-user.html#dx1-179026" >4868</a>, <a +href="glossaries-user.html#dx1-179031" >4869</a>, <a +href="glossaries-user.html#dx1-191008" >4870</a>, <a +href="glossaries-user.html#dx1-193015" >4871</a>, <a +href="glossaries-user.html#dx1-195011" >4872</a>, <a +href="glossaries-user.html#dx1-203077" >4873</a>, <a +href="glossaries-user.html#dx1-213002" >4874</a>, <a +href="glossaries-user.html#dx1-213006" >4875</a>, <a +href="glossaries-user.html#dx1-214002" >4876</a>, <a +href="glossaries-user.html#dx1-214005" >4877</a>, <a +href="glossaries-user.html#dx1-214011" >4878</a>, <a +href="glossaries-user.html#dx1-214012" >4879</a>, <a +href="glossaries-user.html#dx1-214019" >4880</a>, <a +href="glossaries-user.html#dx1-214027" >4881</a>, <a +href="glossaries-user.html#dx1-214030" >4882</a>, <a +href="glossaries-user.html#dx1-214038" >4883</a>, <a +href="glossaries-user.html#dx1-214065" >4884</a>, <a +href="glossaries-user.html#dx1-215001" >4885</a>, <a +href="glossaries-user.html#dx1-215002" >4886</a>, <a +href="glossaries-user.html#dx1-215003" >4887</a>, <a +href="glossaries-user.html#dx1-217001" >4888</a>, <a +href="glossaries-user.html#dx1-217003" >4889</a>, <a +href="glossaries-user.html#dx1-217005" >4890</a>, <a +href="glossaries-user.html#dx1-217031" >4891</a>, <a +href="glossaries-user.html#dx1-223008" >4892</a>, <a +href="glossaries-user.html#dx1-223036" >4893</a>, <a +href="glossaries-user.html#dx1-9037" >4894</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-C</span>  <a -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> +href="glossaries-user.html#dx1-8033" >4895</a>, <a +href="glossaries-user.html#dx1-13027" >4896</a>, <a +href="glossaries-user.html#dx1-16094" >4897</a>, <a +href="glossaries-user.html#dx1-16098" >4898</a>, <a +href="glossaries-user.html#dx1-167017" >4899</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-I</span>  <a -href="glossaries-user.html#dx1-19007" >4834</a>, <a -href="glossaries-user.html#dx1-19008" >4835</a> <br /></span> +href="glossaries-user.html#dx1-19007" >4900</a>, <a +href="glossaries-user.html#dx1-19008" >4901</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-L</span>  <a -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> +href="glossaries-user.html#dx1-8032" >4902</a>, <a +href="glossaries-user.html#dx1-16093" >4903</a>, <a +href="glossaries-user.html#dx1-16096" >4904</a>, <a +href="glossaries-user.html#dx1-167016" >4905</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">-M</span>  <a -href="glossaries-user.html#dx1-16090" >4840</a> <br /></span> +href="glossaries-user.html#dx1-16090" >4906</a> <br /></span> <span class="index-item">xindy attributes  <a -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> +href="glossaries-user.html#dx1-16049" >4907</a>, <a +href="glossaries-user.html#dx1-129074" >4908</a>, <a +href="glossaries-user.html#dx1-168010" >4909</a>, <a +href="glossaries-user.html#dx1-168017" >4910</a>, <a +href="glossaries-user.html#dx1-168022" >4911</a> <br /></span> <span class="index-subitem">    <span class="cmtt-10">:locref</span>  <a -href="glossaries-user.html#dx1-129022" >4846</a> <br /></span> +href="glossaries-user.html#dx1-151022" >4912</a> <br /></span> <span class="index-item"><span class="cmss-10">xkeyval </span>package  <a -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> +href="glossaries-user.html#dx1-8" >4913</a>, <a +href="glossaries-user.html#dx1-133030" >4914</a>, <a +href="glossaries-user.html#dx1-226002" >4915</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" >4850</a> <br /></span> +href="glossaries-user.html#dx1-141018" >4916</a> <br /></span> <span class="index-item"><span class="cmss-10">xspace </span>package  <a -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> +href="glossaries-user.html#dx1-141014" >4917</a>, <a +href="glossaries-user.html#dx1-141015" >4918</a>, <a +href="glossaries-user.html#dx1-141017" >4919</a>, <a +href="glossaries-user.html#dx1-141019" >4920</a>, <a +href="glossaries-user.html#dx1-141021" >4921</a>, <a +href="glossaries-user.html#dx1-141023" >4922</a>, <a +href="glossaries-user.html#dx1-141024" >4923</a> <br /></span> </p></div> - <div class="footnotes"><!--l. 871--><p class="indent" > <span class="footnote-mark"><a + <div class="footnotes"><!--l. 875--><p class="indent" > <span class="footnote-mark"><a href="#fn1x1-bk" id="fn1x1"><sup class="textsuperscript">1.1</sup></a></span><span class="cmr-8">That is, if the entry has been referenced using any of the commands described in </span><a href="#sec:glslink">§<span -class="cmr-8">6 </span></a><a +class="cmbx-8">??</span><span +class="cmr-8">sec:glslink </span></a><a href="#sec:glslink"><span -class="cmr-8">Links to Glossary Entries</span><!--tex4ht:ref: sec:glslink --></a> <span +class="cmr-8">Links to Glossary Entries</span><!--tex4ht:ref: sec:glslink --></a> +<span class="cmr-8">and </span><a href="#sec:glsadd">§<span -class="cmr-8">7 </span></a><a +class="cmbx-8">??</span><span +class="cmr-8">sec:glsadd </span></a><a href="#sec:glsadd"><span -class="cmr-8">Adding</span> -<span -class="cmr-8">an Entry to the Glossary Without Generating Text</span><!--tex4ht:ref: sec:glsadd --></a> <span +class="cmr-8">Adding an Entry to the Glossary Without Generating Text</span><!--tex4ht:ref: sec:glsadd --></a> <span class="cmr-8">or via </span><span class="cmtt-8">\glssee</span><a id="dx1-4002"></a> <span class="cmr-8">(or the </span><span class="cmtt-8">see</span><a id="dx1-4003"></a> <span -class="cmr-8">key) or commands such as </span><span +class="cmr-8">key) or commands such as</span> +<span class="cmtt-8">\acrshort</span><a id="dx1-4004"></a> <span -class="cmr-8">or</span> -<span id="textcolor3"><span +class="cmr-8">or </span><span id="textcolor3"><span class="cmtt-8">\glsxtrshort</span></span><a id="dx1-4005"></a><span class="cmr-8">.</span></p> -<!--l. 1734--><p class="indent" > <span class="footnote-mark"><a +<!--l. 1743--><p class="indent" > <span class="footnote-mark"><a href="#fn2x1-bk" id="fn2x1"><sup class="textsuperscript">1.2</sup></a></span><span class="cmr-8">Except for Klingon, which is supported by </span><a href="#glo:xindy"><span class="cmtt-8">xindy</span><a id="dx1-9037"></a></a><span class="cmr-8">, but not by the CLDR.</span></p> -<!--l. 1828--><p class="indent" > <span class="footnote-mark"><a +<!--l. 1873--><p class="indent" > <span class="footnote-mark"><a href="#fn3x1-bk" id="fn3x1"><sup class="textsuperscript">1.3</sup></a></span><span class="cmr-8">You can just use the base </span><span class="cmss-8">glossaries </span><span @@ -47795,7 +49445,7 @@ class="cmti-8">label</span>⟩<span class="cmtt-8">} </span><span class="cmr-8">to display the entry</span> <span -class="cmr-8">name.</span></p><!--l. 1999--><p class="indent" > <span class="footnote-mark"><a +class="cmr-8">name.</span></p><!--l. 2044--><p class="indent" > <span class="footnote-mark"><a href="#fn4x1-bk" id="fn4x1"><sup class="textsuperscript">1.4</sup></a></span><span class="cmtt-8">\glossentrysymbol </span><span class="cmr-8">is defined by the base </span><span @@ -47804,25 +49454,25 @@ class="cmr-8">package but is redefined by </span><a href="#glo:glossaries-extra"><span class="cmss-8">glossaries-extra</span></a><span class="cmr-8">.</span></p> -<!--l. 2395--><p class="indent" > <span class="footnote-mark"><a +<!--l. 2478--><p class="indent" > <span class="footnote-mark"><a href="#fn5x1-bk" id="fn5x1"><sup class="textsuperscript">1.5</sup></a></span><span class="cmr-8">deprecated, use </span><span class="cmss-8">babel </span><span class="cmr-8">instead</span></p> -<!--l. 2967--><p class="noindent" ><span class="footnote-mark"><a +<!--l. 3050--><p class="noindent" ><span class="footnote-mark"><a href="#fn6x1-bk" id="fn6x1"><sup class="textsuperscript">1.6</sup></a></span><span class="cmr-8">Added to version </span><a href="#glo:makeglossaries"><span class="cmtt-8">makeglossaries</span><a id="dx1-16045"></a></a> <span class="cmr-8">2.18.</span></p> -<!--l. 3011--><p class="indent" > <span class="footnote-mark"><a +<!--l. 3094--><p class="indent" > <span class="footnote-mark"><a href="#fn7x1-bk" id="fn7x1"><sup class="textsuperscript">1.7</sup></a></span><span class="cmr-8">As from v3.01 </span><span class="cmtt-8">\gls</span><a id="dx1-16069"></a> <span class="cmr-8">is no longer fragile and doesn’t need protecting.</span></p> -<!--l. 3114--><p class="indent" > <span class="footnote-mark"><a +<!--l. 3197--><p class="indent" > <span class="footnote-mark"><a 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 @@ -47831,7 +49481,7 @@ class="cmr-8"> distributions for Windows provide</span> <span class="cmtt-8">makeglossaries.exe</span><span class="cmr-8">.</span></p> -<!--l. 3675--><p class="indent" > <span class="footnote-mark"><a +<!--l. 3764--><p class="indent" > <span class="footnote-mark"><a href="#fn1x2-bk" id="fn1x2"><sup class="textsuperscript">2.1</sup></a></span><span class="cmr-8">These figures don’t include standard files and registers provided by the kernel or </span><span class="cmss-8">hyperref</span><a @@ -47841,22 +49491,22 @@ class="cmtt-8">aux </span><span class="cmr-8">and</span> <span class="cmtt-8">out</span><span -class="cmr-8">.</span></p><!--l. 3923--><p class="indent" > <span class="footnote-mark"><a +class="cmr-8">.</span></p><!--l. 4016--><p class="indent" > <span class="footnote-mark"><a href="#fn2x2-bk" id="fn2x2"><sup class="textsuperscript">2.2</sup></a></span><span class="cmr-8">unless </span><span class="cmss-8">memoir</span><a - id="dx1-41005"></a> <span + id="dx1-42005"></a> <span class="cmr-8">is loaded, which case it uses </span><span class="cmtt-8">\markboth</span><a - id="dx1-41006"></a></p> -<!--l. 3954--><p class="indent" > <span class="footnote-mark"><a + id="dx1-42006"></a></p> +<!--l. 4047--><p class="indent" > <span class="footnote-mark"><a href="#fn3x2-bk" id="fn3x2"><sup class="textsuperscript">2.3</sup></a></span><span class="cmr-8">Actually it uses </span><span class="cmtt-8">\mfirstucMakeUppercase</span><a - id="dx1-42007"></a> <span + id="dx1-43007"></a> <span class="cmr-8">which is set to </span><span class="cmss-8">textcase</span><a - id="dx1-42008"></a><span + id="dx1-43008"></a><span class="cmr-8">’s </span><span class="cmtt-8">\MakeTextUppercase </span><span class="cmr-8">by the </span><span @@ -47865,226 +49515,229 @@ class="cmr-8">package. This</span> <span class="cmr-8">makes it consistent with </span><span class="cmtt-8">\makefirstuc</span><a - id="dx1-42009"></a><span + id="dx1-43009"></a><span class="cmr-8">. (The </span><span class="cmss-8">textcase</span><a - id="dx1-42010"></a> <span + id="dx1-43010"></a> <span class="cmr-8">package is automatically loaded by </span><span class="cmss-8">glossaries</span><span class="cmr-8">.)</span></p> -<!--l. 4310--><p class="indent" > <span class="footnote-mark"><a +<!--l. 4403--><p class="indent" > <span class="footnote-mark"><a href="#fn4x2-bk" id="fn4x2"><sup class="textsuperscript">2.4</sup></a></span><span class="cmr-8">bug fix in v4.16 has corrected the code to ensure this.</span></p> -<!--l. 5012--><p class="indent" > <span class="footnote-mark"><a +<!--l. 5120--><p class="indent" > <span class="footnote-mark"><a href="#fn5x2-bk" id="fn5x2"><sup class="textsuperscript">2.5</sup></a></span><span class="cmr-8">Actually it sets </span><span class="cmtt-8">\acronymtype</span><a - id="dx1-90008"></a> <span + id="dx1-91008"></a> <span class="cmr-8">to </span><span class="cmtt-8">\glsdefaulttype</span><a - id="dx1-90009"></a> <span + id="dx1-91009"></a> <span class="cmr-8">if the </span><span class="cmss-8">acronym</span><a - id="dx1-90010"></a> <span + id="dx1-91010"></a> <span class="cmr-8">package option is not used, but </span><span class="cmtt-8">\glsdefaulttype</span><a - id="dx1-90011"></a> <span + id="dx1-91011"></a> <span class="cmr-8">usually</span> <span class="cmr-8">has the value </span><span class="cmtt-8">main </span><span class="cmr-8">unless the </span><span class="cmss-8">nomain</span><a - id="dx1-90012"></a> <span + id="dx1-91012"></a> <span class="cmr-8">option has been used.</span></p> -<!--l. 6559--><p class="indent" > <span class="footnote-mark"><a +<!--l. 6764--><p class="indent" > <span class="footnote-mark"><a href="#fn1x4-bk" id="fn1x4"><sup class="textsuperscript">4.1</sup></a></span><span class="cmr-8">This is because </span><span class="cmtt-8">\acronymtype</span><a - id="dx1-122022"></a> <span + id="dx1-123022"></a> <span class="cmr-8">is set to </span><span class="cmtt-8">\glsdefaulttype</span><a - id="dx1-122023"></a> <span + id="dx1-123023"></a> <span class="cmr-8">if the </span><span class="cmss-8">acronym</span><a - id="dx1-122024"></a> <span + id="dx1-123024"></a> <span class="cmr-8">package option is not used.</span></p> -<!--l. 7440--><p class="noindent" ><span class="footnote-mark"><a -href="#fn1x6-bk" id="fn1x6"><sup class="textsuperscript">6.1</sup></a></span><span +<!--l. 7220--><p class="noindent" ><span class="footnote-mark"><a +href="#fn1x5-bk" id="fn1x5"><sup class="textsuperscript">5.1</sup></a></span><span class="cmr-8">See also “Displaying the glossary” in the documented code, </span><span class="cmtt-8">glossaries-code.pdf</span><span class="cmr-8">.</span></p> -<!--l. 7591--><p class="noindent" ><span class="footnote-mark"><a -href="#fn2x6-bk" id="fn2x6"><sup class="textsuperscript">6.2</sup></a></span><span +<!--l. 7371--><p class="noindent" ><span class="footnote-mark"><a +href="#fn2x5-bk" id="fn2x5"><sup class="textsuperscript">5.2</sup></a></span><span class="cmr-8">I’ve used </span><span class="cmtt-8">\MakeUppercase </span><span class="cmr-8">in all the examples for clarity, but it will actually use </span><span class="cmtt-8">\mfirstucMakeUppercase</span><span class="cmr-8">.</span></p> -<!--l. 8040--><p class="indent" > <span class="footnote-mark"><a -href="#fn3x6-bk" id="fn3x6"><sup class="textsuperscript">6.3</sup></a></span><span +<!--l. 7820--><p class="indent" > <span class="footnote-mark"><a +href="#fn3x5-bk" id="fn3x5"><sup class="textsuperscript">5.3</sup></a></span><span class="cmtt-8">\glsdisplayfirst</span><a - id="dx1-135003"></a> <span + id="dx1-132003"></a> <span class="cmr-8">and </span><span class="cmtt-8">\glsdisplay</span><a - id="dx1-135004"></a> <span + id="dx1-132004"></a> <span class="cmr-8">are now deprecated. Backwards compatibility should be preserved but you may need to</span> <span class="cmr-8">use the </span><span class="cmss-8">compatible-3.07</span><a - id="dx1-135005"></a> <span + id="dx1-132005"></a> <span class="cmr-8">option</span></p> -<!--l. 8727--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x8-bk" id="fn1x8"><sup class="textsuperscript">8.1</sup></a></span><a +<!--l. 8515--><p class="indent" > <span class="footnote-mark"><a +href="#fn4x5-bk" id="fn4x5"><sup class="textsuperscript">5.4</sup></a></span><span +class="cmr-8">versions before 3.0 used </span><span +class="cmtt-8">\glsentryname</span><a + id="dx1-134053"></a> <span +class="cmr-8">as the default, but this could cause problems when </span><span +class="cmtt-8">name</span><a + id="dx1-134054"></a> <span +class="cmr-8">had been</span> +<a +href="#glo:sanitize"><span +class="cmr-8">sanitized</span><a + id="dx1-134055"></a></a><span +class="cmr-8">.</span></p><!--l. 9954--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x6-bk" id="fn1x6"><sup class="textsuperscript">6.1</sup></a></span><span +class="cmr-8">as from version 1.18</span></p> +<!--l. 9984--><p class="indent" > <span class="footnote-mark"><a +href="#fn2x6-bk" id="fn2x6"><sup class="textsuperscript">6.2</sup></a></span><span +class="cmr-8">See David Carlisle’s explanation in </span><a +href="http://tex.stackexchange.com/questions/86565/drawbacks-of-xspace" ><span +class="cmr-8">Drawbacks of xspace</span></a></p> +<!--l. 10696--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x8-bk" id="fn1x8"><sup class="textsuperscript">8.1</sup></a></span><span +class="cmr-8">you can’t use the </span><span +class="cmss-8">longheaderborder</span><a + id="dx1-144091"></a> <span +class="cmr-8">style for this example as you can’t use the </span><span +class="cmss-8">longtable</span><a + id="dx1-144092"></a><a + id="dx1-144093"></a> <span +class="cmr-8">environment in two column</span> +<span +class="cmr-8">mode.</span></p><!--l. 11179--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x11-bk" id="fn1x11"><sup class="textsuperscript">11.1</sup></a></span><a href="#glo:makeindex"><span class="cmtt-8">makeindex</span><a - id="dx1-139004"></a></a> <span + id="dx1-148004"></a></a> <span class="cmr-8">will always assign a location number, even if it’s not needed, so it needs to be discarded.</span></p> -<!--l. 8732--><p class="indent" > <span class="footnote-mark"><a -href="#fn2x8-bk" id="fn2x8"><sup class="textsuperscript">8.2</sup></a></span><span +<!--l. 11184--><p class="indent" > <span class="footnote-mark"><a +href="#fn2x11-bk" id="fn2x11"><sup class="textsuperscript">11.2</sup></a></span><span class="cmr-8">If you redefine </span><span class="cmtt-8">\glsseeformat</span><span class="cmr-8">, keep the default value of the optional argument as </span><span class="cmtt-8">\seename</span><a - id="dx1-139006"></a> <span + id="dx1-148006"></a> <span class="cmr-8">as both </span><span class="cmtt-8">see</span><a - id="dx1-139007"></a> <span + id="dx1-148007"></a> <span class="cmr-8">and </span><span class="cmtt-8">\glssee</span> <span class="cmr-8">explicitly write </span><span class="cmtt-8">[\seename] </span><span class="cmr-8">in the output file if no optional argument is given.</span></p> -<!--l. 8757--><p class="indent" > <span class="footnote-mark"><a -href="#fn3x8-bk" id="fn3x8"><sup class="textsuperscript">8.3</sup></a></span><span +<!--l. 11209--><p class="indent" > <span class="footnote-mark"><a +href="#fn3x11-bk" id="fn3x11"><sup class="textsuperscript">11.3</sup></a></span><span class="cmr-8">In versions before 3.0, </span><span class="cmtt-8">\glsentryname </span><span class="cmr-8">was used, but this could cause problems when the </span><span class="cmtt-8">name</span><a - id="dx1-139014"></a> <span + id="dx1-148014"></a> <span class="cmr-8">key was</span> <a href="#glo:sanitize"><span class="cmr-8">sanitized</span><a - id="dx1-139015"></a></a><span -class="cmr-8">.</span></p><!--l. 9054--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x9-bk" id="fn1x9"><sup class="textsuperscript">9.1</sup></a></span><span -class="cmr-8">versions before 3.0 used </span><span -class="cmtt-8">\glsentryname</span><a - id="dx1-140053"></a> <span -class="cmr-8">as the default, but this could cause problems when </span><span -class="cmtt-8">name</span><a - id="dx1-140054"></a> <span -class="cmr-8">had been</span> -<a -href="#glo:sanitize"><span -class="cmr-8">sanitized</span><a - id="dx1-140055"></a></a><span -class="cmr-8">.</span></p><!--l. 9353--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x10-bk" id="fn1x10"><sup class="textsuperscript">10.1</sup></a></span><span -class="cmr-8">you can’t use the </span><span -class="cmss-8">longheaderborder</span><a - id="dx1-141081"></a> <span -class="cmr-8">style for this example as you can’t use the </span><span -class="cmss-8">longtable</span><a - id="dx1-141082"></a><a - id="dx1-141083"></a> <span -class="cmr-8">environment in two column</span> + id="dx1-148015"></a></a><span +class="cmr-8">.</span></p><!--l. 11815--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x13-bk" id="fn1x13"><sup class="textsuperscript">13.1</sup></a></span><span +class="cmr-8">These lengths will not be available if you use both the </span><span +class="cmss-8">nolong</span><a + id="dx1-155020"></a> <span +class="cmr-8">and </span><span +class="cmss-8">nosuper</span><a + id="dx1-155021"></a> <span +class="cmr-8">package options or if you use the </span><span +class="cmss-8">nostyles</span><a + id="dx1-155022"></a> <span +class="cmr-8">package</span> <span -class="cmr-8">mode.</span></p><!--l. 9835--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x11-bk" id="fn1x11"><sup class="textsuperscript">11.1</sup></a></span><span +class="cmr-8">option unless you explicitly load the relevant package.</span></p> +<!--l. 11974--><p class="noindent" ><span class="footnote-mark"><a +href="#fn2x13-bk" id="fn2x13"><sup class="textsuperscript">13.2</sup></a></span><span +class="cmr-8">This style was supplied by Axel</span><span +class="cmr-8"> Menzel.</span></p> +<!--l. 12271--><p class="indent" > <span class="footnote-mark"><a +href="#fn3x13-bk" id="fn3x13"><sup class="textsuperscript">13.3</sup></a></span><span +class="cmr-8">e.g.</span><span +class="cmr-8"> with the </span><span +class="cmss-8">flowfram</span><a + id="dx1-160011"></a> <span +class="cmr-8">package.</span></p> +<!--l. 13623--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x14-bk" id="fn1x14"><sup class="textsuperscript">14.1</sup></a></span><span class="cmr-8">see </span><span class="cmtt-8">\glsSetCompositor</span><a - id="dx1-144056"></a> <span + id="dx1-168056"></a> <span class="cmr-8">described in </span><a href="#sec:setup">§<span -class="cmr-8">3 </span></a><a +class="cmbx-8">??</span><span +class="cmr-8">sec:setup </span></a><a href="#sec:setup"><span class="cmr-8">Setting Up</span><!--tex4ht:ref: sec:setup --></a></p> -<!--l. 9840--><p class="indent" > <span class="footnote-mark"><a -href="#fn2x11-bk" id="fn2x11"><sup class="textsuperscript">11.2</sup></a></span><span +<!--l. 13628--><p class="indent" > <span class="footnote-mark"><a +href="#fn2x14-bk" id="fn2x14"><sup class="textsuperscript">14.2</sup></a></span><span class="cmr-8">see </span><span class="cmtt-8">\glsSetAlphaCompositor</span><a - id="dx1-144058"></a> <span + id="dx1-168058"></a> <span class="cmr-8">described in </span><a href="#sec:setup">§<span -class="cmr-8">3 </span></a><a +class="cmbx-8">??</span><span +class="cmr-8">sec:setup </span></a><a href="#sec:setup"><span class="cmr-8">Setting Up</span><!--tex4ht:ref: sec:setup --></a></p> -<!--l. 9844--><p class="indent" > <span class="footnote-mark"><a -href="#fn3x11-bk" id="fn3x11"><sup class="textsuperscript">11.3</sup></a></span><span +<!--l. 13632--><p class="indent" > <span class="footnote-mark"><a +href="#fn3x14-bk" id="fn3x14"><sup class="textsuperscript">14.3</sup></a></span><span class="cmr-8">With </span><a href="#glo:glossaries-extra"><span class="cmss-8">glossaries-extra</span></a> <span class="cmtt-8">seealso </span><span class="cmr-8">is appended to the end of the list.</span></p> -<!--l. 11404--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x13-bk" id="fn1x13"><sup class="textsuperscript">13.1</sup></a></span><span -class="cmr-8">as from version 1.18</span></p><!--l. 11434--><p class="indent" > <span class="footnote-mark"><a -href="#fn2x13-bk" id="fn2x13"><sup class="textsuperscript">13.2</sup></a></span><span -class="cmr-8">See David Carlisle’s explanation in </span><a -href="http://tex.stackexchange.com/questions/86565/drawbacks-of-xspace" ><span -class="cmr-8">Drawbacks of xspace</span></a></p> -<!--l. 11974--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x15-bk" id="fn1x15"><sup class="textsuperscript">15.1</sup></a></span><span -class="cmr-8">These lengths will not be available if you use both the </span><span -class="cmss-8">nolong</span><a - id="dx1-156019"></a> <span -class="cmr-8">and </span><span -class="cmss-8">nosuper</span><a - id="dx1-156020"></a> <span -class="cmr-8">package options or if you use the </span><span -class="cmss-8">nostyles</span><a - id="dx1-156021"></a> <span -class="cmr-8">package</span> -<span -class="cmr-8">option unless you explicitly load the relevant package.</span></p> -<!--l. 12133--><p class="noindent" ><span class="footnote-mark"><a -href="#fn2x15-bk" id="fn2x15"><sup class="textsuperscript">15.2</sup></a></span><span -class="cmr-8">This style was supplied by Axel</span><span -class="cmr-8"> Menzel.</span></p> -<!--l. 12430--><p class="indent" > <span class="footnote-mark"><a -href="#fn3x15-bk" id="fn3x15"><sup class="textsuperscript">15.3</sup></a></span><span -class="cmr-8">e.g.</span><span -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. 13811--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x17-bk" id="fn1x17"><sup class="textsuperscript">17.1</sup></a></span><span +<!--l. 14234--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x16-bk" id="fn1x16"><sup class="textsuperscript">16.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 class="cmr-8">“a” in the </span><span class="cmtt-8">prefix</span><a - id="dx1-171016"></a> <span + id="dx1-174016"></a> <span class="cmr-8">field.</span></p> -<!--l. 13982--><p class="indent" > <span class="footnote-mark"><a -href="#fn2x17-bk" id="fn2x17"><sup class="textsuperscript">17.2</sup></a></span><span +<!--l. 14405--><p class="indent" > <span class="footnote-mark"><a +href="#fn2x16-bk" id="fn2x16"><sup class="textsuperscript">16.2</sup></a></span><span class="cmr-8">The earlier caveats about initial non-Latin characters apply.</span></p> -<!--l. 15818--><p class="indent" > <span class="footnote-mark"><a -href="#fn1x19-bk" id="fn1x19"><sup class="textsuperscript">19.1</sup></a></span><a +<!--l. 16241--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x18-bk" id="fn1x18"><sup class="textsuperscript">18.1</sup></a></span><a href="#glo:makeindex"><span class="cmtt-8">makeindex</span><a - id="dx1-190003"></a></a> <span + id="dx1-193003"></a></a> <span class="cmr-8">assumes that the location is a page number</span></p> -<!--l. 15997--><p class="indent" > <span class="footnote-mark"><a -href="#fn2x19-bk" id="fn2x19"><sup class="textsuperscript">19.2</sup></a></span><span +<!--l. 16420--><p class="indent" > <span class="footnote-mark"><a +href="#fn2x18-bk" id="fn2x18"><sup class="textsuperscript">18.2</sup></a></span><span class="cmr-8">If you use </span><span class="cmss-8">babel</span><a - id="dx1-192017"></a> <span + id="dx1-195017"></a> <span 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. 16062--><p class="indent" > <span class="footnote-mark"><a -href="#fn3x19-bk" id="fn3x19"><sup class="textsuperscript">19.3</sup></a></span><span +<!--l. 16485--><p class="indent" > <span class="footnote-mark"><a +href="#fn3x18-bk" id="fn3x18"><sup class="textsuperscript">18.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 + id="dx1-195042"></a></a> <span class="cmr-8">v2.0.</span></p> -<!--l. 18926--><p class="indent" > <span class="footnote-mark"><a -href="#fn4x19-bk" id="fn4x19"><sup class="textsuperscript">19.4</sup></a></span><span +<!--l. 19349--><p class="indent" > <span class="footnote-mark"><a +href="#fn4x18-bk" id="fn4x18"><sup class="textsuperscript">18.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 class="cmr-8">provided with </span><a diff --git a/macros/latex/contrib/glossaries/glossaries-user.pdf b/macros/latex/contrib/glossaries/glossaries-user.pdf Binary files differindex 2cbcfbdcc2..8980ed84e5 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 f4dc52e08e..cefb8116a9 100644 --- a/macros/latex/contrib/glossaries/glossaries-user.tex +++ b/macros/latex/contrib/glossaries/glossaries-user.tex @@ -198,7 +198,7 @@ \newcommand{\gallery}[2]{\href{https://www.dickimaw-books.com/gallery/#1}{#2}} \newcommand{\galleryurl}[1]{\gallery{#1}{\nolinkurl{https://www.dickimaw-books.com/gallery/#1}}} -\newcommand{\gallerytopic}[1]{\galleryurl{\##1}} +\newcommand{\gallerytopic}[1]{\gallery{\##1}{\styfmt{#1} gallery}} \newcommand*{\bibglsgallery}[2][\gallerytitle]{% \def\gallerytitle{#2}% @@ -501,6 +501,17 @@ user2={sanitization\protect\iterm{sanitize}}% description={An alphabet consisting of \glspl{nonlatinchar}.} } +\newglossaryentry{UTF-8}{% + name={UTF-8\itermdef{UTF-8}}, + text={UTF-8}, + sort={UTF-8}, + description={A variable-width character encoding. This means that +some characters are represented by more that one byte. \XeLaTeX\ and +\LuaLaTeX\ treat the multi-byte sequence as a single token, but the +older \LaTeX\ formats have single-byte tokens, which causes +complications. Related blog article: \href{https://www.dickimaw-books.com/blog/binary-files-text-files-and-file-encodings/}{Binary Files, Text Files and File Encodings}.} +} + \newglossaryentry{glossaries-extra}{% name={\styfmt{glossaries-extra}}, sort={glossaries-extra}, @@ -671,11 +682,11 @@ and~\hyperlink{option#2}{#2}} \MakeShortVerb{"} \DeleteShortVerb{\|} - \title{User Manual for glossaries.sty v4.46} + \title{User Manual for glossaries.sty v4.47} \author{Nicola L.C. Talbot\\% \href{http://www.dickimaw-books.com/contact}{\nolinkurl{dickimaw-books.com/contact}}} - \date{2020-03-19} + \date{2021-09-20} \maketitle \begin{abstract} @@ -750,18 +761,13 @@ how to adjust the settings. \end{important} \noindent -The \styfmt{glossaries} bundle comes with the following documentation: +The \styfmt{glossaries} bundle includes the following documentation: \begin{description} \item[\url{glossariesbegin.pdf}] If you are a complete beginner, start with \htmldoc{The glossaries package: a guide for beginners}{glossariesbegin}. -\item[\url{glossary2glossaries.pdf}] -If you are moving over from the obsolete \sty{glossary} package, -read \htmldoc{Upgrading from the glossary package to the -glossaries package}{glossary2glossaries}. - \item[glossaries-user.pdf] This document is the main user guide for the \styfmt{glossaries} package. @@ -769,9 +775,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.46}. - -\item[INSTALL] Installation instructions. +\qt{Documented Code for glossaries v4.47}. \item[CHANGES] Change log. @@ -785,7 +789,7 @@ Related resources: \item \href{http://www.dickimaw-books.com/faqs/glossariesfaq.html}{\styfmt{glossaries} FAQ} -\item \gallerytopic{glossaries}{\styfmt{glossaries} gallery} +\item \gallerytopic{glossaries} \item \gallery{glossaries-styles/}{a summary of all glossary styles provided by \styfmt{glossaries} and @@ -993,7 +997,7 @@ options are specific to \gls{glossaries-extra}. Other options are passed to the base \styfmt{glossaries} package. \begin{xtr} -In this document, commands and options displayed in teal, such as +In this user manual, commands and options displayed in teal, such as \xtrcs{newabbreviation} and \pkgopt*{stylemods}, are only available with the \gls{glossaries-extra} package. There are also some commands and options (such as \cs{makeglossaries} and \pkgopt{symbols}) that are provided by the @@ -1022,7 +1026,7 @@ hyperlinked-enabled PDF viewer (such as Adobe Reader or Okular) if you click on the word \qt{\gls{xindy}} you'll be taken to the entry in the glossary where there's a brief description of the term \qt{\gls*{xindy}}. This is the way the \styfmt{glossaries} -mechanism works. An \gls{indexingapp} is used to generated the +mechanism works. An \gls{indexingapp} is used to generate the sorted list of terms. The \glspl{indexingapp} are \gls{cli} tools, which means they can be run directly from a command prompt or terminal, or can be integrated into some text editors, or you can use a build tool @@ -1038,9 +1042,6 @@ The remainder of this introductory section covers the following: \item \sectionref{sec:indexingoptions} lists the available indexing options. -\item \sectionref{sec:samples} lists the sample documents provided -with this package. - \item \sectionref{sec:lipsum} lists the dummy glossary files that may be used for testing. @@ -1053,6 +1054,9 @@ wish to write in a language other than English. \end{itemize} +There are some sample documents provided with this package. They are +described in \sectionref{sec:samples}. + \section{Indexing Options} \label{sec:indexingoptions} @@ -1173,6 +1177,7 @@ format. \cs{newglossaryentry} should not be used explicitly.\par \optionsec[\TeX]{TeX} +This option isn't generally recommended for reasons given below. Example Document: \begin{verbatim} \documentclass{article} @@ -1198,7 +1203,8 @@ and load it in the preamble with \ics{loadglsentries} (\emph{after} This option doesn't require an external \gls{indexingapp} but, with the default alphabetic sorting, it's very slow with severe limitations. If you want a sorted list, it doesn't work well for -\glspl{exlatinalph} or \glspl{nonlatinalph}. However, if you use +\glspl{exlatinalph} or \glspl{nonlatinalph} and there's no guarantee +that it will work with \gls{UTF-8}. However, if you use the \pkgopt[false]{sanitizesort} package option (the default for Option~1) then the \glslink{latexexlatinchar}{standard \LaTeX\ accent commands} will be ignored, so if an entry's name is set to @@ -1232,6 +1238,7 @@ This option is not suitable for hierarchical glossaries and does not form ranges in the \glspl{numberlist}. If you really can't use an \gls{indexingapp} consider using \opt{5} instead. +Summary: \begin{enumerate} \item Add \begin{verbatim} @@ -1284,8 +1291,8 @@ This option uses a~\gls{cli} application called \gls{makeindex} to sort the entries. This application comes with all modern \TeX\ distributions, but it's hard-coded for the non-extended \gls{latinalph}. It can't correctly sort accent commands (such as \cs{'} or \cs{c}) 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 +with \gls{UTF-8} characters, especially for any sort values that start +with a \gls{UTF-8} character (as it separates the octets resulting in an invalid file encoding). This process involves making \LaTeX\ write the glossary information to a temporary file which \gls{makeindex} reads. Then \gls{makeindex} writes a~new file containing the code @@ -1319,6 +1326,7 @@ documentation for further details. See also the \sectionref{sec:samplessort}. \end{xtr} +Summary: \begin{enumerate} \item If you want to use \gls{makeindex}['s] \mkidxopt{g} option you must change the quote character using \ics{GlsSetQuote}. For example: @@ -1504,6 +1512,7 @@ of use\slash definition with \opt1. See the \gls{glossaries-extra} documentation for further details. \end{xtr} +Summary: \begin{enumerate} \item Add the \pkgopt{xindy} option to the \styfmt{glossaries} package option list: @@ -1668,7 +1677,7 @@ or (with at least \gls{glossaries-extra} v1.37 and \gls{bib2gls} v1.8): The \pkgopt+{nameref}{record} option is the best method. (It's possible to use a hybrid of this method and \optsor23 with -\pkgopt+{alsoindex}{record} but in general there is little need +\pkgopt+{hybrid}{record} but in general there is little need for this and it complicates the build process.) Each resource set is loaded with \ics*{GlsXtrLoadResources}\oarg{options}. @@ -1736,6 +1745,38 @@ Repository, which provides more extensive language support than numerical value it will attempt to form ranges otherwise it will simply list the locations. +Summary: +\begin{enumerate} + \item Use \gls{glossaries-extra} with the \pkgopt+{record} package +option: +\begin{verbatim} +\usepackage[record]{glossaries-extra} +\end{verbatim} + + \item Use \cs*{GlsXtrLoadResources} to identify the \filetype{bib} +file(s) and \gls{bib2gls} options: +\begin{verbatim} +\GlsXtrLoadResources[src={terms.bib,abbreviations.bib},sort=en] +\end{verbatim} + + \item Put +\begin{alltt} +\cs*{printunsrtglossary} +\end{alltt} +where you want your list of entries to appear. Alternatively to +display all glossaries use the iterative command: +\begin{alltt} +\cs*{printunsrtglossaries} +\end{alltt} + +\item Run \LaTeX\ on your document. + +\item Run \gls{bib2gls} with just the document base name. + +\item Run \LaTeX\ on your document. + +\end{enumerate} + See \bibglsbegin\ or the \gls{bib2gls} user manual for further details of this method, and also \href{https://www.dickimaw-books.com/latex/buildglossaries/}{Incorporating @@ -1766,7 +1807,11 @@ Example document: This method is best used with the package option \pkgopt[none]{sort} (as shown above). There's no \qt{activation} command (such as \cs{makeglossaries} -for \optsand23). +for \optsand23). In general it's best to use a style that doesn't +show letter group headings. If you do want letter headings then you +must ensure that you have defined your entries in alphabetical +order, and use \XeLaTeX\ or \LuaLaTeX\ if you require \gls{UTF-8} letter +groups. All entries must be defined before the glossary is displayed (preferably in the preamble) in the required order, and child @@ -2279,6 +2324,44 @@ For example: description={eu, nulla}} \end{verbatim} +\item[example-glossaries-longchild.tex] (New to v4.47.) These entries all +have long descriptions and there are some child entries. For example: +\begin{verbatim} +\newglossaryentry{longsedmattis}{name={sed mattis}, + description={erat sit amet dolor sit amet, consectetuer adipiscing elit. + Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. + Curabitur dictum gravida mauris.}} + +\newglossaryentry{longgravida}{parent={longsedmattis},name={gravida}, + description={malesuada libero, nonummy eget, consectetuer id, vulputate a, + magna. Donec vehicula augue eu neque. Pellentesque habitant morbi tristique +senectus et netus et malesuada fames ac turpis egestas. Mauris ut +leo.}} +\end{verbatim} + +\item[example-glossaries-childmultipar.tex] (New to v4.47.) This +consists of parent entries with single paragraph descriptions and +child entries with multi-paragraph descriptions. Some entries have +the \gloskey{user1} key set to the name of an image file provided by +the \sty{mwe} package. For example: +\begin{verbatim} +\newglossaryentry{hiersedmattis}{name={sed mattis},user1={example-image}, + description={Erat sit amet dolor sit amet, consectetuer adipiscing elit. + Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur +dictum gravida mauris. Ut pellentesque augue sed urna. Vestibulum +diam eros, fringilla et, consectetuer eu, nonummy id, sapien. Nullam +at lectus. In sagittis ultrices mauris. Curabitur malesuada erat sit +amet massa. Fusce blandit. Aliquam erat volutpat.}} + +\longnewglossaryentry{hierloremi-ii} +{name={lorem 1--2},parent={hiersedmattis}}% +{% +Lorem ipsum ... + +Nam dui ligula... +} +\end{verbatim} + \item[example-glossaries-cite.tex] These entries use the \gloskey{user1} key to store a citation key (or comma-separated list of citation keys). The citations are defined in \texttt{xampl.bib}, @@ -2352,7 +2435,7 @@ This means that with \optsor34 you are not restricted to the A, \ldots, Z letter groups. If you want to use \gls*{xindy}, remember to use the \pkgopt{xindy} package option. For example: \begin{verbatim} -\documentclass[frenchb]{article} +\documentclass[french]{article} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage{babel} @@ -2639,7 +2722,7 @@ if you have glossary entries that contain details on \gls{xindy}, and see the \gls{bib2gls} user manual for further details of that application. -\subsubsection{Creating a New Language Module} +\subsection{Creating a New Language Module} \label{sec:newlang} The \styfmt{glossaries} package now uses the \sty{tracklang} package @@ -2793,10 +2876,10 @@ language file and make the appropriate changes, for example: If the translations includes \glspl{nonlatinchar}, it's necessary to provide code that's independent of the input encoding. Remember that -while some users may use UTF-8, others may use Latin-1 or any other +while some users may use \gls{UTF-8}, others may use Latin-1 or any other supported encoding, but while users won't appreciate you enforcing -your preference on them, it's useful to provide a UTF-8 version for -\XeLaTeX\ users. +your preference on them, it's useful to provide a \gls{UTF-8} version for +\XeLaTeX\ and \LuaLaTeX\ users. The \texttt{glossaries-irish.ldf} file provides this as follows: \begin{verbatim} @@ -2842,7 +2925,7 @@ your root language label and \texttt{Irish} with the There are now two extra files: \nolinkurl{glossaries-irish-noenc.ldf} (no encoding information) -and \nolinkurl{glossaries-irish-utf8.ldf} (UTF-8). +and \nolinkurl{glossaries-irish-utf8.ldf} (\gls{UTF-8}). These both define \cs{glossariescaptionsirish} but the \texttt{*-noenc.ldf} uses \LaTeX\ accent commands: @@ -2874,7 +2957,7 @@ These both define \cs{glossariescaptionsirish} but the \texttt{*-noenc.ldf} uses } \end{verbatim} whereas the \texttt{*-utf8.ldf} replaces the accent commands with -the appropriate UTF-8 characters. +the appropriate \gls{UTF-8} characters. \section{Generating the Associated Glossary Files} @@ -3170,7 +3253,7 @@ For a complete list of options do \texttt{makeglossaries -{}-help}. \begin{important} When upgrading the \styfmt{glossaries} package, make sure you also upgrade your version of \gls{makeglossaries}. The current version is -4.45. +4.47. \end{important} \subsection{Using the makeglossaries-lite Lua Script} @@ -3422,9 +3505,15 @@ for every time an entry has been referenced. If you need to gather labels for auto-completion, the \pkgopt{writeglslabels} package option will create a file containing the labels of all defined entries (regardless of whether or not the -entry has been used in the document). The \gls{glossaries-extra} +entry has been used in the document). As from v4.47, there is a +similar option \pkgopt{writeglslabelnames} that writes both the +label and name (separated by a tab). + +\begin{xtr} +The \gls{glossaries-extra} package also provides \pkgopt+{atom}{docdef}, which will create the \filetype{glsdefs} file but will act like \pkgopt+{restricted}{docdef}. +\end{xtr} \subsection{Bib2Gls} \label{sec:notedev.bib2gls} @@ -3446,7 +3535,7 @@ not to run \gls{bib2gls}: \end{alltt} (It gets more complicated if both \ics*{glsxtr@resource} and \cs{@istfilename} are present as that indicates the hybrid -\pkgopt+{alsoindex}{record} option.) +\pkgopt+{hybrid}{record} option.) Remember that with \gls{bib2gls}, the entries will never be defined on the first \LaTeX\ call (because their definitions are contained @@ -3817,7 +3906,8 @@ will create a file called \cs{jobname}\texttt{.}\filetype{glslabels} at the end of the document. This file simply contains a list of all defined entry labels (including those in any ignored glossaries). It's provided for the benefit of text editors that need to know labels -for \Index{auto-completion}. (See also \gls{glossaries-extra}['s] +for \Index{auto-completion}. If you also want the name, use +\pkgopt{writeglslabelnames}. (See also \gls{glossaries-extra}['s] \pkgopt+{atom}{docdef} package option.) \begin{bib2gls} @@ -3825,12 +3915,15 @@ Note that with \gls{bib2gls} the file will only contain the entries that \gls{bib2gls} has selected from the \filetype{bib} files. \end{bib2gls} +\pkgoptsec{writeglslabelnames} Similar to the above but writes both +the label and name (separated by a tab). + \xtrpkgoptsec[value]{undefaction} The value may be one of: \begin{description} \item[\pkgoptfmt{error}] generate an error if a referenced entry is - undefined (default, and only available setting with just + undefined (default, and the only available setting with just \styfmt{glossaries}); \item[\pkgoptfmt{warn}] only warn if a referenced entry is undefined (automatically activated with \opt4). @@ -4252,7 +4345,7 @@ groups. \xtrpkgoptsec[list]{stylemods} -Load the \sty{glossaries-extra-stylemods} package and patch the +Load the \sty{glossaries-extra-stylemods} package, which patches the predefined styles. The \meta{list} argument is optional. If present, this will also load \styfmt{glossary-\meta{element}.sty} for each \meta{element} in the comma-separated \meta{list}. @@ -4263,7 +4356,7 @@ this will also load \styfmt{glossary-\meta{element}.sty} for each \pkgoptsec[value]{seenoindex} Introduced in version 4.24, this option may take one of three values: \pkgoptfmt{error}, \pkgoptfmt{warn} or \pkgoptfmt{ignore}. The \gloskey{see} key automatically indexes the -cross-referenced entry using \cs{glsadd}. This means that if this +cross-referenced entry using \ics{glssee}. This means that if this key is used in an entry definition before the relevant glossary file has been opened, the indexing can't be performed. Since this is easy to miss, the \styfmt{glossaries} package by @@ -4362,17 +4455,30 @@ and \texttt{acronym} categories. (Instead of using the \xtrpkgoptsec[boolean]{indexcrossrefs} -If \pkgoptfmt{true}, this will automatically index any +If \pkgoptfmt{true}, this will automatically index (\ics{glsadd}) any cross-referenced entries that haven't been marked as used at the end of the document. Increases document build time. See \gls{glossaries-extra} manual for further details. +\begin{bib2gls} +Note that \gls{bib2gls} can automatically find dependent entries +when it parses the \filetype{bib} file. Use the \xtrfont{selection} option to +\ics*{GlsXtrLoadResources} to determine the selection of +dependencies. +\end{bib2gls} + \xtrpkgoptsec[boolean]{autoseeindex} If \pkgoptfmt{true}, makes the \gloskey{see} and \xtrgloskey{seealso} keys automatically index the cross-reference -when the entry is defined (default, and the only option with just -the base \styfmt{glossaries} package). +(with \ics{glssee}) when the entry is defined (default, and the only +option with just the base \styfmt{glossaries} package). + +\begin{bib2gls} +With \gls{bib2gls}, use the \xtrfont{selection} option to +\ics*{GlsXtrLoadResources} to determine the selection of +dependencies. +\end{bib2gls} \xtrpkgoptsec[value]{record} @@ -4388,10 +4494,11 @@ for \optsto13; \item[\pkgoptfmt{nameref}] like \pkgoptfmt{only} but provides extra information that allows the associated title to be used instead of -the location number; +the location number and provides better support for hyperlinked +locations; -\item[\pkgoptfmt{alsoindex}] a hybrid approach where \gls{bib2gls} -is begin used to fetch entries from a \filetype{bib} file but +\item[\pkgoptfmt{hybrid}] a hybrid approach where \gls{bib2gls} +is used to fetch entries from a \filetype{bib} file but \gls{makeindex} or \gls{xindy} are used for the indexing. This requires a more complicated document build and isn't recommended. \end{description} @@ -4415,9 +4522,10 @@ is indexed within the float before the caption.) This valueless option is primarily intended for use with \gls{bib2gls} and \sty{hyperref} allowing the page location -hyperlink to the relevant point in the page (rather than the top of -the page). Unexpected results will occur with other indexing -methods. See \gls{glossaries-extra} manual for further details. +hyperlink target to be set to the relevant point within the page +(rather than the top of the page). Unexpected results will occur +with other indexing methods. See \gls{glossaries-extra} manual for +further details. \section{Sorting Options} \label{sec:pkgopts-sort} @@ -4753,7 +4861,7 @@ with \gls*{makeindex} but may not work with \gls{xindy}. However even in unrestricted mode this option may not work with \gls*{xindy} as \gls*{xindy} uses language names that don't always -correspond with \ics{babel}'s language names. (The +correspond with \sty{babel}'s language names. (The \gls{makeglossaries} script applies mappings to assist you.) Note that you still need at least two \LaTeX\ runs to ensure the document is up-to-date with this setting. @@ -5085,7 +5193,7 @@ of acronyms using: \end{definition} \begin{xtr} -This option is incompatible with \gls{glossaries-extra}['s] +This option and associated commands are incompatible with \gls{glossaries-extra}['s] abbreviation mechanism. \end{xtr} @@ -5100,7 +5208,7 @@ Alternatively you can use: The \gls{glossaries-extra} package provides additional shortcuts. \end{xtr} -\subsection{Deprecated Acronym Style Options} +\section{Deprecated Acronym Style Options} \label{sec:pkgopts-old-acronym} The package options listed in this section are now deprecated but @@ -5308,14 +5416,25 @@ unexpected results. If you try changing the sort option after you have started to define entries, you may get unexpected results. \end{important} +\begin{xtr} +With \gls{glossaries-extra}, use \ics*{glossariesextrasetup} +instead. +\end{xtr} + \chapter{Setting Up} \label{sec:setup} -In the preamble you need to indicate whether you want to use \opt1, -\opt2 or \opt3. It's not possible to mix these options within -a~document, although some combinations are possible with -\gls*{glossaries-extra}. (For \optsand45 see the \gls{bib2gls} and -\gls{glossaries-extra} manuals.) +In the preamble you need to indicate which method you want to use to +generate the glossary (or glossaries). The available options with +both \styfmt{glossaries} and \gls{glossaries-extra} are +summarized in \sectionref{sec:indexingoptions}. This chapter +documents \optsto13, which are provided by the base package. See the +\gls{glossaries-extra} and \gls{bib2gls} manuals for the full +documentation of the other options. + +If you don't need to display any glossaries, for example, if you are +just using the \styfmt{glossaries} package to enable consistent +formatting, then skip ahead to \sectionref{sec:newglosentry}. \section[Option 1]{\ifpdf\opt1\else Option 1\fi} \label{sec:setupopt1} @@ -5371,8 +5490,8 @@ Note that if you have a custom \filetype{xdy} file created when using \end{important} The default name for the customised style file is given by -\ics{jobname}\filetype{ist} (\opt2) or -\ics{jobname}\filetype{xdy} (\opt3). This name may be +\ics{jobname}\texttt{.}\filetype{ist} (\opt2) or +\ics{jobname}\texttt{.}\filetype{xdy} (\opt3). This name may be changed using: \begin{definition}[\DescribeMacro{\setStyleFile}] \cs{setStyleFile}\marg{name} @@ -5414,6 +5533,19 @@ See \sectionref{sec:numberlists} for further information about \chapter{Defining Glossary Entries} \label{sec:newglosentry} +\begin{bib2gls} +If you want to use \gls{bib2gls}, entries must be defined in +\filetype{bib} files using the syntax described in the \gls{bib2gls} +user manual. +\end{bib2gls} + +Acronyms are covered in \sectionref{sec:acronyms} but they use the +same underlying mechanism as all the other entries, so it's a good +idea to read this chapter first. The keys provided for +\cs{newglossaryentry} can also be used in the optional argument of +\cs{newacronym}, although some of them, such as \gloskey{first} and +\gloskey{plural}, interfere with the acronym styles. + All glossary entries must be defined before they are used, so it is better to define them in the preamble to ensure this. In fact, some commands such as \cs{longnewglossaryentry} @@ -5556,12 +5688,28 @@ is set to the same as the \gloskey{description} key. when using \ics{gls} (or one of its upper case variants). If this field is omitted, the value of the \gloskey{name} key is used. +This key is automatically set by \cs{newacronym}. Although it is +possible to override it by using \gloskey{text} in the optional +argument of \cs{newacronym}, it will interfere with the acronym +style and cause unexpected results. + \item[{\gloskey{first}}] How the entry will appear in the document text on \firstuse\ with \ics{gls} (or one of its upper case variants). If this field is omitted, the value of the \gloskey{text} key is used. Note that if you use \ics{glspl}, \ics{Glspl}, \ics{GLSpl}, \ics{glsdisp} before using \ics{gls}, the -\gloskey{firstplural} value won't be used with \ics{gls}. +\gloskey{first} value won't be used with \ics{gls}. + +You may prefer to use abbreviations (\sectionref{sec:acronyms}) +or the category post-link hook (\ics*{glsdefpostlink}) provided by +\gls{glossaries-extra} if you would like to automatically append +content on \firstuse\ in a consistent manner. See, for example, +\gallery{index.php?label=sample-units}{Gallery: Units +(\styfmt{glossaries-extra.sty})}. + +Although it is possible to use \gloskey{first} in the optional +argument of \cs{newacronym}, it can interfere with the acronym +style and cause unexpected results. \item[{\gloskey{plural}}] How the entry will appear in the document text when using \ics{glspl} (or one of its upper case variants). If this @@ -5569,6 +5717,11 @@ field is omitted, the value is obtained by appending \ics{glspluralsuffix} to the value of the \gloskey{text} field. The default value of \ics{glspluralsuffix} is the letter \qt{s}. +Although it is possible to use \gloskey{plural} in the optional +argument of \cs{newacronym}, it can interfere with the acronym +style and cause unexpected results. Use \gloskey{shortplural} +instead, if the default value is inappropriate. + \item[{\gloskey{firstplural}}] How the entry will appear in the document text on \firstuse\ with \ics{glspl} (or one of its upper case variants). If this field is omitted, the value is obtained @@ -5579,6 +5732,11 @@ that if you use \ics{gls}, \ics{Gls}, \ics{GLS}, \cs{glsdisp} before using \ics{glspl}, the \gloskey{firstplural} value won't be used with \ics{glspl}. +Although it is possible to use \gloskey{firstplural} in the optional +argument of \cs{newacronym}, it can interfere with the acronym +style and cause unexpected results. Use \gloskey{shortplural} +and \gloskey{longplural} instead, if the default value is inappropriate. + \importantpar Note: prior to version 1.13, the default value of \gloskey{firstplural} was always taken by appending \qt{s} to the @@ -5595,12 +5753,15 @@ symbol (as passed to \ics{glsdisplay} and \ics{glsdisplayfirst} by \ics{glspl}, \ics{Glspl} and \ics{GLSpl}). If omitted, the value is set to the same as the \gloskey{symbol} key. -\item[{\gloskey{sort}}] This value indicates how this entry should -be sorted. If omitted, the value is given +\item[{\gloskey{sort}}] This value indicates the text to be used by +the sort comparator when ordering all the entries. If omitted, the value is given by the \gloskey{name} field unless one of the package options -\pkgopt[def]{sort} and \pkgopt[use]{sort} have been used. In -general, it's best to use the \gloskey{sort} key if the -\gloskey{name} contains commands (e.g.\ \verb|\ensuremath{\alpha}|). +\pkgopt[def]{sort} and \pkgopt[use]{sort} have been used. +With \opt2 it's best to use the \gloskey{sort} key if the +\gloskey{name} contains commands (e.g.\ \verb|\ensuremath{\alpha}|) +and with \optsand13, it's strongly recommended as the indexing may +fail if you don't (see below). + You can also override the \gloskey{sort} key by redefining \ics{glsprestandardsort} (see \sectionref{sec:pkgopts-sort}). @@ -5652,7 +5813,7 @@ Similarly if you use the \sty{inputenc} package: This is equivalent to \begin{alltt} \cs{newglossaryentry}\mgroup{elite}\mgroup{\% - name=i\mgroup{\mgroup{\'e}lite}, + name=\mgroup{\mgroup{\'e}lite}, description=\mgroup{select group of people}, sort=elite } @@ -5706,9 +5867,48 @@ this entry. Conversely, if you have used the package option for this entry with \gloskey{nonumberlist=false}. (See \sectionref{sec:numberlists}.) -\item[{\gloskey{see}}] Cross-reference another entry. Using the -\gloskey{see} key will \emph{automatically add this entry to the -glossary}, but will not automatically add the cross-referenced entry. +\item[{\gloskey{see}}] +This key essentially provides a convenient shortcut that performs +\begin{alltt} +\cs{glssee}\oarg{tag}\marg{label}\marg{xr-label list} +\end{alltt} +after the entry has been defined. (See \sectionref{sec:crossref}.) +It was originally designed for synonyms that may not occur in the +document text but needed to be included in the glossary in order to +redirect the reader. Note that it doesn't index the cross-referenced +entry (or entries) as that would interfere with their \glspl{numberlist}. + +\begin{important} +Using the \gloskey{see} key will \emph{automatically add this entry +to the glossary}, but will not automatically add the +cross-referenced entry. +\end{important} + +For example: +\begin{verbatim} +\newglossaryentry{courgette}{name={courgette}, + description={variety of small marrow}} +\newglossaryentry{zucchini}{name={zucchini}, + description={(North American)}, + see={courgette}} +\end{verbatim} +This defines two entries (courgette and zucchini) and automatically +adds a cross-reference from zucchini to courgette. (That is, it adds +\qt{\emph{see} courgette} to zucchini's \gls{numberlist}.) This +doesn't automatically index courgette since this would create an +unwanted location in courgette's \gls{numberlist}. (Page~1, if the +definitions occur in the preamble.) + +Note that while it's possible to put the cross-reference in the +description instead, for example: +\begin{verbatim} +\newglossaryentry{zucchini}{name={zucchini}, + description={(North American) see \gls{courgette}}} +\end{verbatim} +this won't index the zucchini entry, so if zucchini isn't indexed +elsewhere (with commands like \cs{gls} or \cs{glsadd}) then it won't +appear in the glossary even if courgette does. + The referenced entry should be supplied as the value to this key. If you want to override the \qt{see} tag, you can supply the new tag in square brackets before the label. For example @@ -5720,12 +5920,6 @@ glossary entries using \gloskey{nonumberlist=false} (see above). Alternatively, you can use the \pkgopt{seeautonumberlist} package option. For further details, see \sectionref{sec:crossref}. -This key essentially provides a convenient shortcut that performs -\begin{alltt} -\cs{glssee}\oarg{tag}\marg{label}\marg{xr-label list} -\end{alltt} -after the entry has been defined. - \begin{important} For \optsand23, \ics{makeglossaries} must be used before any occurrence of \ics{newglossaryentry} that contains the \gloskey{see} key. This key @@ -5740,7 +5934,14 @@ If you use the \gloskey{see} key, you may want to consider using the \gls{glossaries-extra} package which additionally provides a \texttt{seealso} and \texttt{alias} key. If you want to avoid the automatic indexing triggered by the \gloskey{see} key, -consider using \opt4. +consider using \opt4. See also the FAQ item +\href{https://www.dickimaw-books.com/faq.php?action=view&category=glossaries&itemlabel=whyseekeyautoindex}{Why does the see key automatically index the entry?} + +\begin{bib2gls} +The analogous \gls{bib2gls} \gloskey{see} field (and \xtrgloskey{seealso}) have a +slightly different meaning. The \resourceopt{selection} resource option +determines the behaviour. +\end{bib2gls} \item[{\xtrgloskey{seealso}}] This key is only available with \gls{glossaries-extra} and is @@ -5756,8 +5957,12 @@ another form of cross-referencing. An entry can be aliased to another entry with \texttt{alias=\marg{label}}. This behaves like \texttt{see=\marg{label}} but also alters the behaviour of commands like \cs{gls} so that they index the entry given by \meta{label} -instead of the original entry. More variations with the key are -available with \gls{bib2gls}. +instead of the original entry. (See, for example, +\gallery{index.php?label=aliases}{Gallery: Aliases}.) + +\begin{bib2gls} +More variations with the key are available with \gls{bib2gls}. +\end{bib2gls} \item[\xtrgloskey{category}] This key is only available with \gls{glossaries-extra} and is used @@ -5809,8 +6014,8 @@ package: \cs{newglossaryentry}\mgroup{elite}\mgroup{name=\mgroup{\mgroup{\'e}lite}, description=\mgroup{select group or class}} \end{alltt} -(This doesn't apply for \XeLaTeX\ documents using the \sty{fontspec} -package. For further details, see the \qt{UTF-8} section in the +(This doesn't apply for \XeLaTeX\ or \LuaLaTeX\ documents. +For further details, see the \qt{UTF-8} section in the \sty{mfirstuc} user manual.) Note that in both of the above examples, you will also need to @@ -6648,7 +6853,7 @@ maintained for newer commands. This restriction is also reimposed for \cs{newglossaryentry} by the new \opt1. (The \gls{glossaries-extra} package automatically reimposes this restriction for \optsand23 but provides a package option to allow document -definitions.) +definitions if necessary.) \subsection{Technical Issues} \label{sec:techissues} @@ -6661,7 +6866,11 @@ entry before it has been defined. \item Entry information is required when displaying the glossary. If this occurs at the start of the document, but the entries aren't defined until later, then the entry details are -being looked up before the entry has been defined. +being looked up before the entry has been defined. This means that +it's not possible to display the content of the glossary unless the +entry definitions are saved on the previous \LaTeX\ run and can be +picked up at the start of the \env{document} environment on the next run +(in a similar way that \cs{label} and \cs{ref} work). \item If you use a package, such as \sty{babel}, that makes certain characters active at the start of the \env{document} @@ -6683,19 +6892,21 @@ To overcome the first two problems, as from version 4.0 the \styfmt{glossaries} package modifies the definition of \cs{newglossaryentry} at the beginning of the \env{document} environment so that the definitions are written to an external file -(\cs{jobname}\filetype{glsdefs}) which is then read in at the start -of the document on the next run. The entry will then only be defined -in the \env{document} environment if it doesn't already exist. This -means that the entry can now be looked up in the glossary, even if -the glossary occurs at the beginning of the document. +(\cs{jobname}\texttt{.}\filetype{glsdefs}) which is then read in at the start +of the document on the next run. This means that the entry can now +be looked up in the glossary, even if the glossary occurs at the +beginning of the document. 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 \cs{newwrite}, which may +modification in \cs{printglossary} (if it occurs at the start of the +document); this method requires an extra \cs{newwrite}, which may exceed \TeX's maximum allocation; unexpected expansion issues could -occur; the \gloskey{see} key isn't stored, which means it can't be -added to the \filetype{glsdefs} file when it's created at the end of the -document (and therefore won't be present on subsequent runs). +occur. + +Version 4.47 has introduced changes that have removed some of +the issues involved, and there are now warning messages if there is an +attempt to multiple define the same entry label. The \gls{glossaries-extra} package provides a setting (but only for \optsand23) that allows \cs{newglossaryentry} to occur in the @@ -6730,488 +6941,55 @@ you forget the label, you can look it up in the definition file rather than searching through your document text to find the definition. -\chapter{Number lists} -\label{sec:numberlists} +\chapter{Referencing Entries in the Document} +\label{sec:usingentries} -Each entry in the glossary has an associated \gls{numberlist}. -By default, these numbers refer to the pages on which that entry has -been indexed (using any of the commands described in -\sectionref{sec:glslink} and \sectionref{sec:glsadd}). The number -list can be suppressed using the \pkgopt{nonumberlist} package -option, or an alternative counter can be set as the default using -the \pkgopt{counter} package option. The number list is also -referred to as the location list\index{location list|see{number list}}. +Once you have defined a glossary entry using a command like +\ics{newglossaryentry} (\sectionref{sec:newglosentry}) or +\ics{newacronym} (\sectionref{sec:acronyms}), you can refer to that +entry in the document with one of the provided commands that are +describe in this manual. (There are some additional commands +provided by \gls{glossaries-extra}.) The text produced at that point +in the document is determined by the command and can also be +governed by whether or not the entry has been +\glsdisp{firstuseflag}{marked as used}. -\Glspl{numberlist} are more common with indexes rather than -glossaries (although you can use the \styfmt{glossaries} package for -indexes as well). However, the \styfmt{glossaries} package makes use -of \gls{makeindex} or \gls{xindy} to hierarchically sort and collate the -entries since they are readily available with most modern \TeX\ -distributions. Since these are both designed as \glspl{indexingapp} -they both require that terms either have a valid location or a -cross-reference. Even if you use \pkgopt{nonumberlist}, the -locations must still be provided and acceptable to the -\gls{indexingapp} or they will cause an error during the indexing -stage, which will interrupt the document build. However, if you're -not interested in the locations, each entry only needs to be indexed -once, so consider using \pkgopt{indexonlyfirst}, which can improve the -document build time by only indexing the \gls{firstuse} of each term. +Some of these commands are more complicated than others. Many of +them are robust and can't be used in fully expandable contexts, such +as in PDF bookmarks. -The \ics{glsaddall} command (see \sectionref{sec:glsadd}), which is used to -automatically index all entries, iterates over all defined entries -and does \cs{glsadd}\marg{label} for each entry (where \meta{label} -is that entry's label). This means that \cs{glsaddall} automatically -adds the same location to every entry's \gls{numberlist}, which -looks weird if the \gls*{numberlist} hasn't been suppressed. - -With \opt4, the indexing is performed by \gls{bib2gls}, which was -specifically designed for the \gls{glossaries-extra} package. So it -will allow any location format, and its \texttt{selection=all} -option will select all entries without adding an unwanted location to the -\gls{numberlist}. If \gls{bib2gls} can deduce a numerical value for -a location, it will attempt to form a range over consecutive -locations, otherwise it won't try to form a range and the -location will just form an individual item in the list. -\opt1 also allows any location but it doesn't form ranges. - -\section{Encap Values} -\label{sec:encap} - -Each location in the \gls{numberlist} is encapsulated with a -command formed from the \termdef{encap} value. By -default this is the \ics{glsnumberformat} command, which corresponds -to the encap \texttt{glsnumberformat}, but this may be -overridden using the \gloskey[glslink]{format} key in the optional -argument to commands like \cs{gls}. (See \sectionref{sec:glslink}.) -For example, you may want the location to appear in bold to indicate -the principle use of a term or symbol. If the encap starts with an -open parenthesis~\verb|(| this signifies the start of a range and if -the encap starts with close parenthesis~\verb|)| this signifies the -end of a range. These must always occur in matching pairs. - -The \styfmt{glossaries} package provides the command \ics{glsignore} -which ignores its argument. This is the format used by -\cs{glsaddallunused} to suppress the location, which works fine as -long as no other locations are added to the \gls{numberlist}. For -example, if you use \verb|\gls{sample}| on page~2 then reset the -\gls{firstuseflag} and then use \cs{glsaddallunused} on page~10, the -\gls{numberlist} for \texttt{sample} will be \verb|2, \glsignore{10}| -which will result in \qt{2,~} which has a spurious comma. - -This isn't a problem with \gls{bib2gls} because you'd use -\texttt{selection=all} instead of \cs{glsaddallunused}, but even if -you explicitly had, for example, -\cs{gls}\texttt{[format=glsignore]}\marg{label} -for some reason, \gls{bib2gls} will recognise \texttt{glsignore} as -a special encap indicating an ignored location, so it will select -the entry but not add that location to the \gls{numberlist}. It's a -problem for all the other options (except \opt5, which doesn't -perform any indexing). - -Complications can arise if you use different encap values for the -same location. For example, suppose on page~10 you have both the -default \texttt{glsnumberformat} and \texttt{textbf} encaps. While it may -seem apparent that \texttt{textbf} should override \texttt{glsnumberformat} -in this situation, the \gls{indexingapp} may not know it. -This is therefore something you need to be careful about if you use the -\gloskey[glslink]{format} key or if you use a command that -implicitly sets it. - -In the case of \gls{xindy}, it only accepts one encap (according to -the order of precedence given in the \gls{xindy} module) and discards the -others for identical locations (for the same entry). This can cause -a problem if a discarded location forms the start or end of a range. - -In the case of \gls{makeindex}, it accepts different encaps for the -same location, but warns about it. This leads to a \gls{numberlist} -with the same location repeated in different formats. If you use -the \gls{makeglossaries} Perl script with \opt2 it will detect -\gls{makeindex}'s warning and attempt to fix the problem, ensuring -that the \texttt{glsnumberformat} encap always has the least precedence -unless it includes a range identifier. Other conflicting encaps will -have the last one override earlier ones for the same location with -range identifiers taking priority. - -No discard occurs with \opt1 so again you get the same location -repeated in different formats. With \opt4, \gls{bib2gls} will discard -according to order of precedence, giving priority to start and end -range encaps. (See the \gls{bib2gls} manual for further details.) - -\section{Locations} -\label{sec:locationsyntax} - -Neither \opt1 nor \opt4 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 -\filetype{aux} file. The write operation is deferred to avoid the -problems associated with \TeX's asynchronous output routine. -(See, for example, -\href{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=oddpage}{Finding -if you're on an odd or an even page} for more details on this issue.) -Unfortunately \optsand23 are far more problematic and need some -complex code to deal with awkward locations. - -If you know that your locations will always expand to a format -acceptable to your chosen \gls{indexingapp} then use the package -option \pkgopt[false]{esclocations} to bypass this operation. This setting -only affects \optsand23 as the problem doesn't arise with the other -indexing options. - -Both \gls{makeindex} and \gls{xindy} are fussy about the syntax of -the locations. In the case of \gls{makeindex}, only the numbering -system obtained with \cs{arabic}, \cs{roman}, \cs{Roman}, \cs{alph} -and \cs{Alph} or composites formed from them with the same separator -(set with \cs{glsSetCompositor}\marg{char}) are accepted. -(\gls{makeindex} won't accept an empty location.) In the case of -\gls{xindy}, you can define your own location classes, but if the -location contains a robust command then the leading backslash must -be escaped. The \sty{glossaries} package tries to do this, but it's -caught between two conflicting requirements: +The commands are broadly divided into: \begin{enumerate} -\item The location must be fully expanded before \verb|\| can be -converted to \verb|\\| (there's no point converting \verb|\thepage| -to \verb|\\thepage|); -\item The page number can't be expanded until the deferred write -operation (so \verb|\c@page| mustn't expand in the previous step -but \verb|\the\c@page| mustn't be converted to \verb|\\the\\c@page| -and \verb|\number\c@page| mustn't be converted to -\verb|\\number\\c@page| etc). +\item Those that display text in the document (where the formatting +can be adjusted by a style or hook) and also index the +entry (so that it's added to the document) are described in +\sectionref{sec:glslink}. This set of commands can +be further sub-divided into those that mark the entry as having been +used (the \cs{gls}-like commands, \sectionref{sec:gls-like}) and those that don't +(the \cs{glstext}-like commands, \sectionref{sec:glstext-like}). + +\item Those that display text in the document without indexing or applying any +additional formatting (\sectionref{sec:glsnolink}). \end{enumerate} -There's a certain amount of trickery needed to deal with this -conflict and the code requires the location to be in a form that -doesn't embed the counter's internal register in commands like -\cs{value}. For example, suppose you have a robust command called -\cs{tallynum} that takes a number as the argument and an expandable -command called \cs{tally} that converts a counter name into the -associated register or number to pass to \cs{tallynum}. Let's -suppose that this command is used to represent the page number: -\begin{verbatim} -\renewcommand{\thepage}{\tally{page}} -\end{verbatim} -Now let's suppose that a term is indexed at the beginning of page~2 -at the end of a paragraph that started on page~1. With \gls{xindy}, -the location \verb|\tally{page}| needs to be written to the file -as \verb|\\tallynum{2}|. If it's written as \verb|\tallynum{2}| then -\gls{xindy} will interpret \verb|\t| as the character \qt{t} -(which means the location would appear as \qt{tallynum2}). So -\sty{glossaries} tries to expand \cs{thepage} without expanding -\cs{c@page} and then escapes all the backslashes, except for the -page counter's internal command. The following definitions of -\cs{tally} will work: -\begin{itemize} -\item In the following, \cs{arabic} works as its internal command \cs{c@arabic} is -temporarily redefined to check for \cs{c@page}: -\begin{verbatim} -\newcommand{\tally}[1]{\tallynum{\arabic{#1}}} -\end{verbatim} - -\item The form \verb|\expandafter\the\csname c@|\meta{counter}\verb|\endcsname| -also works (provided \cs{the} is allowed to be temporarily redefined, -see below): -\begin{verbatim} -\newcommand{\tally}[1]{% - \tallynum{\expandafter\the\csname c@#1\endcsname}} -\end{verbatim} - -\item \verb|\expandafter\the\value|\marg{counter} now also works -(with the same condition as above): -\begin{verbatim} -\newcommand{\tally}[1]{\tallynum{\expandafter\the\value{#1}}} -\end{verbatim} - -\item Another variation that will work: -\begin{verbatim} -\newcommand{\tally}[1]{% - \expandafter\tallynum\expandafter{\the\csname c@#1\endcsname}} -\end{verbatim} - -\item and also: -\begin{verbatim} -\newcommand{\tally}[1]{\tallynum{\the\csname c@#1\endcsname}} -\end{verbatim} -\end{itemize} -The following \emph{don't work}: -\begin{itemize} -\item This definition leads to the premature expansion of \cs{c@page} -to \qt{1} when, in this case, it should be \qt{2}: -\begin{verbatim} -\newcommand{\tally}[1]{\tallynum{\the\value{#1}}} -\end{verbatim} -\item This definition leads to \verb|\\c@page| in the glossary file: -\begin{verbatim} -\newcommand{\tally}[1]{\tallynum{\csname c@#1\endcsname}} -\end{verbatim} -\end{itemize} -If you have a numbering system where -\verb|\|\meta{cs name}\verb|{page}| expands to -\verb|\|\meta{internal cs name}\cs{c@page} (for example, if -\verb|\tally{page}| expands to \verb|\tallynum\c@page|) then you -need to use: -\begin{definition}[\DescribeMacro\glsaddprotectedpagefmt] -\cs{glsaddprotectedpagefmt}\marg{internal cs name} -\end{definition} -Note that the backslash must be omitted from \meta{internal cs name} -and the corresponding command must be able to process a count -register as the (sole) argument. - -For example, suppose you have a style \texttt{samplenum} that is -implemented as follows: -\begin{verbatim} - \newcommand*{\samplenum}[1]{% - \expandafter\@samplenum\csname c@#1\endcsname} - \newcommand*{\@samplenum}[1]{\two@digits{#1}} - -\end{verbatim} -(That is, it displays the value of the counter as a two-digit -number.) Then to ensure the location is correct for entries in -page-spanning paragraphs, you need to do: -\begin{verbatim} -\glsaddprotectedpagefmt{@samplenum} -\end{verbatim} -(If you are using a different counter for the location, such as -\texttt{section} or \texttt{equation}, you don't need to worry about -this provided the inner command is expandable.) - -If the inner macro (as given by \verb|\|\meta{internal cs name}) contains -non-expandable commands then you may need to redefine -\cs{gls}\meta{internal cs name}\texttt{page} after using -\begin{alltt} -\cs{glsaddprotectedpagefmt}\marg{internal cs name} -\end{alltt} -This command doesn't take any arguments -as \emph{the location is assumed to be given by \cs{c@page}} because -that's the only occasion this command should be used. For example, -suppose now my page counter format uses small caps Roman numerals: -\begin{verbatim} - \newcommand*{\samplenum}[1]{% - \expandafter\@samplenum\csname c@#1\endcsname} - \newcommand*{\@samplenum}[1]{\textsc{\romannumeral#1}} -\end{verbatim} -Again, the inner macro needs to be identified using: -\begin{verbatim} -\glsaddprotectedpagefmt{@samplenum} -\end{verbatim} -However, since \cs{textsc} isn't fully expandable, the location -is written to the file as \verb|\textsc {i}| (for page~1), -\verb|\textsc {ii}| (for page~2), etc. This format may cause a problem for -the \gls{indexingapp} (particularly for \gls{makeindex}). -To compensate for this, the \cs{gls}\meta{internal cs -name}\texttt{page} command may be redefined so that it expands to a -format that's acceptable to the \gls*{indexingapp}. For example: -\begin{verbatim} -\renewcommand*{\gls@samplenumpage}{\romannumeral\c@page} -\end{verbatim} -While this modification means that the \gls{numberlist} in the glossary -won't exactly match the format of the page numbers (displaying -lower case Roman numbers instead of small cap Roman numerals) -this method will at least work correctly for both \gls{makeindex} -and \gls{xindy}. If you are using \gls{xindy}, the following -definition: -\begin{verbatim} - \renewcommand*{\gls@samplenumpage}{% - \glsbackslash\string\textsc{\romannumeral\c@page}} -\end{verbatim} -combined with -\begin{verbatim} -\GlsAddXdyLocation{romansc}{:sep "\string\textsc\glsopenbrace" - "roman-numbers-lowercase" :sep "\glsclosebrace"} -\end{verbatim} -will now have lowercase Roman numerals in the location list -(see \sectionref{sec:xindyloc} for further details on that command). -Take care of the backslashes. The location (which ends up in -the \xindyattr{:locref} attribute) needs \verb|\\| but the location class -(identified with \cs{GlsAddXdyLocation}) just has a single -backslash. Note that this example will cause problems if your -locations should be hyperlinks. - -Another possibility that may work with both \gls{makeindex} and -\gls{xindy} is to redefine \cs{gls}\meta{internal cs -name}\texttt{page} (\cs{gls@samplenumpage} in this example) -to just expand to the decimal page number (\verb|\number\c@page|) and redefine -\ics{glsnumberformat} to change the displayed format: -\begin{verbatim} -\renewcommand*{\gls@samplenumpage}{\number\c@page} -\renewcommand*{\glsnumberformat}[1]{\textsc{\romannumeral#1}} -\end{verbatim} +There are additional commands specific to entries defined with +\cs{newacronym} that are described in \sectionref{sec:longshortfull}. -\begin{important} -If you redefine \cs{gls}\meta{internal cs name}\texttt{page}, -you must make sure that \cs{c@page} is expanded when it's written to -the file. (So don't, for example, hide \cs{c@page} inside a robust -command.) -\end{important} - -The mechanism that allows this to work temporarily redefines -\ics{the} and \ics{number} while it processes the location. If this -causes a problem you can disallow it using -\begin{definition}[\DescribeMacro\glswrallowprimitivemodsfalse] -\cs{glswrallowprimitivemodsfalse} -\end{definition} -but you will need to find some other way to ensure the location expands -correctly. - -\section{Range Formations} -\label{sec:ranges} - -Both \gls{makeindex} and \gls{xindy} (\optsand23) concatenate a -sequence of~3 or more consecutive pages into~a range. With -\gls*{xindy} (\opt3) you can vary the minimum sequence length using -\ics{GlsSetXdyMinRangeLength}\marg{n} where \meta{n} is either -an integer or the keyword \texttt{none} which indicates that there -should be no range formation (see \sectionref{sec:xindyloc} for -further details). - -\begin{important} -Note that \cs{GlsSetXdyMinRangeLength} must be used before -\ics{makeglossaries} and has no effect if \ics{noist} is used. -\end{important} - -With both \gls{makeindex} and \gls{xindy} (\optsand23), you can replace -the separator and the closing number in the range using: -\begin{definition}[\DescribeMacro{\glsSetSuffixF}] -\cs{glsSetSuffixF}\marg{suffix} -\end{definition} -\begin{definition}[\DescribeMacro{\glsSetSuffixFF}] -\cs{glsSetSuffixFF}\marg{suffix} -\end{definition} -where the former command specifies the suffix to use for a 2 page -list and the latter specifies the suffix to use for longer lists. -For example: -\begin{verbatim} -\glsSetSuffixF{f.} -\glsSetSuffixFF{ff.} -\end{verbatim} -Note that if you use \gls{xindy} (\opt3), you will also need to -set the minimum range length to 1 if you want to change these -suffixes: -\begin{verbatim} -\GlsSetXdyMinRangeLength{1} -\end{verbatim} -Note that if you use the \sty{hyperref} package, you will need -to use \ics{nohyperpage} in the suffix to ensure that the hyperlinks -work correctly. For example: -\begin{verbatim} -\glsSetSuffixF{\nohyperpage{f.}} -\glsSetSuffixFF{\nohyperpage{ff.}} -\end{verbatim} - -\begin{important} -Note that \cs{glsSetSuffixF} and \cs{glsSetSuffixFF} must be used -before \ics{makeglossaries} and have no effect if \ics{noist} is -used. -\end{important} - -It's also possible to concatenate a sequence of consecutive -locations into a range or have suffixes with \opt4, but with -\gls{bib2gls} these implicit ranges can't be merged with explicit -ranges (created with the \verb|(| and \verb|)| encaps). See -the \gls{bib2gls} manual for further details. - -\opt1 doesn't form ranges. However, with this option you -can iterate over an entry's \gls{numberlist} using: -\begin{definition}[\DescribeMacro\glsnumberlistloop] -\cs{glsnumberlistloop}\marg{label}\marg{handler cs}\marg{xr handler -cs} -\end{definition} -where \meta{label} is the entry's label and \meta{handler cs} is a -handler control sequence of the form: -\begin{definition} -\meta{handler cs}\marg{prefix}\marg{counter}\marg{format}\marg{location} -\end{definition} -where \meta{prefix} is the \sty{hyperref} prefix, \meta{counter} is -the name of the counter used for the location, \meta{format} is the -format used to display the location (e.g.\ \texttt{textbf}) -and \meta{location} is the location. The third argument is the -control sequence to use for any cross-references in the list. This -handler should have the syntax: -\begin{definition} -\meta{xr handler cs}\oarg{tag}\marg{xr list} -\end{definition} -where \meta{tag} is the cross-referenced text (e.g.\ \qt{see}) and -\meta{xr list} is a~comma-separated list of labels. (This actually -has a third argument but it's always empty when used with \opt1.) - -For example, if on page~12 -I~have used -\begin{verbatim} -\gls[format=textbf]{apple} -\end{verbatim} -and on page~18 I~have used -\begin{verbatim} -\gls[format=emph]{apple} -\end{verbatim} -then -\begin{verbatim} -\glsnumberlistloop{apple}{\myhandler} -\end{verbatim} -will be equivalent to: -\begin{verbatim} -\myhandler{}{page}{textbf}{12}% -\myhandler{}{page}{emph}{18}% -\end{verbatim} -There is a predefined handler that's used to display the -\gls{numberlist} in the glossary: -\begin{definition}[\DescribeMacro\glsnoidxdisplayloc] -\cs{glsnoidxdisplayloc}\marg{prefix}\marg{counter}\marg{format}\marg{location} -\end{definition} -The predefined handler used for the cross-references in the glossary is: -\begin{definition} -\cs{glsseeformat}\oarg{tag}\marg{xr list}\marg{location} -\end{definition} -which is described in \sectionref{sec:customxr}. - -\begin{important} -\cs{glsnumberlistloop} is not available for \optsand23. -\end{important} - -\section{Style Hook} -\label{sec:isthook} - -As from version 4.24, there's a hook that's used near the end of -\ics{writeist} before the file is closed. You can set the code -to be performed then using: -\begin{definition}[\DescribeMacro\GlsSetWriteIstHook] -\cs{GlsSetWriteIstHook}\marg{code} -\end{definition} -If you want the \meta{code} to write any information to the -file, you need to use -\begin{definition}[\DescribeMacro\glswrite] -\cs{write}\cs{glswrite}\marg{style information} -\end{definition} -Make sure you use the correct format within \meta{style -information}. For example, if you are using \app{makeindex}: -\begin{verbatim} -\GlsSetWriteIstHook{% - \write\glswrite{page_precedence "arnAR"}% - \write\glswrite{line_max 80}% -} -\end{verbatim} -This changes the page type precedence\index{page type precedence|main} and the maximum line length -used by \app{makeindex}. - -Remember that if you switch to \app{xindy}, this will no longer be -valid code. - -\chapter{Links to Glossary Entries} +\section{Links to Glossary Entries} \label{sec:glslink} -Once you have defined a glossary entry using \ics{newglossaryentry} -(\sectionref{sec:newglosentry}) or \ics{newacronym} (see -\sectionref{sec:acronyms}), you can refer to that entry in the -document using one of the commands listed in -\sectionref{sec:gls-like} or \sectionref{sec:glstext-like}. The text -which appears at that point in the document when using one of these -commands is referred to as the \gls{linktext} (even if there are no -hyperlinks). These commands also add a line to an external file that -is used to generate the relevant entry in the glossary. This -information includes an associated location that is added to the -\gls{numberlist} for that entry. By default, the location refers to -the page number. For further information on number lists, see -\sectionref{sec:numberlists}. These external files need to be -post-processed by \gls{makeindex} or \gls{xindy} unless you have -chosen \optsor14. If you don't use \ics{makeglossaries} these external -files won't be created. (\optsand14 write the information to the -\filetype{aux} file.) +The text which appears at the point in the document when using any +of the commands described in \sectionref{sec:gls-like} or +\sectionref{sec:glstext-like} is referred to as the \gls{linktext} +(even if there are no hyperlinks). These commands also add a line to +an external file that is used to generate the relevant entry in the +glossary. This information includes an associated location that is +added to the \gls{numberlist} for that entry. By default, the +location refers to the page number. For further information on +number lists, see \sectionref{sec:numberlists}. These external +files need to be post-processed by \gls{makeindex} or \gls{xindy} +unless you have chosen \optsor14. If you don't use +\ics{makeglossaries} these external files won't be created. +(\optsand14 write the information to the \filetype{aux} file.) Note that repeated use of these commands for the same entry can cause the \gls{numberlist} to become quite long, which may not be @@ -7246,11 +7024,13 @@ command or use \sty{hyperref}'s \ics{texorpdfstring}. Examples: \chapter[An overview of Perl]{An overview of \gls{perl}} \chapter{An overview of \texorpdfstring{\gls{perl}}{Perl}} \end{verbatim} +\begin{xtr} If you want to retain the formatting that's available through commands like \cs{acrshort} (for example, if you are using one of the small caps styles), then you might want to consider the \gls{glossaries-extra} package which provides commands for this purpose. +\end{xtr} If you want the \gls{linktext} to produce a hyperlink to the corresponding entry details in the glossary, you should load the @@ -7338,7 +7118,7 @@ other key that you plan to access through these commands. \cs{glssymbol}.) \end{important} -The keys listed below are available for the optional argument. +The keys listed below are available for the optional first argument. The \gls{glossaries-extra} package provides additional keys. (See the \gls*{glossaries-extra} manual for further details.) \begin{description} @@ -7500,7 +7280,7 @@ The \gls{linktext} isn't scoped by default with just the base declarations in the \gls{linktext} may affect subsequent text. \end{important} -\section{The \cs{gls}-Like Commands (First Use Flag Queried)} +\subsection{The \cs{gls}-Like Commands (First Use Flag Queried)} \label{sec:gls-like} This section describes the commands that unset (mark as used) the \firstuseflag\ on @@ -7779,7 +7559,7 @@ Don't use any of the \glslike\ or \glstextlike\ commands in the \meta{link text} argument of \cs{glsdisp}. \end{important} -\section{The \cs{glstext}-Like Commands (First Use Flag Not Queried)} +\subsection{The \cs{glstext}-Like Commands (First Use Flag Not Queried)} \label{sec:glstext-like} This section describes the commands that don't change or reference @@ -8025,7 +7805,7 @@ There are also analogous uppercasing commands: \cs{GLSuservi}\oarg{options}\marg{text}\oarg{insert} \end{definition} -\section{Changing the format of the link text} +\subsection{Changing the format of the link text} \label{sec:glsdisplay} \begin{xtr} @@ -8305,7 +8085,7 @@ Remember that if you use the \gloskey{symbol} key, you need to use a glossary style that displays the symbol, as many of the styles ignore it. -\section{Enabling and disabling hyperlinks to glossary entries} +\subsection{Enabling and disabling hyperlinks to glossary entries} \label{sec:disablehyperlinks} If you load the \sty{hyperref} or \sty{html} packages prior to @@ -8454,326 +8234,7 @@ See the sample file \samplefile{-chap-hyperfirst} for a complete document. \end{example} -\chapter{Adding an Entry to the Glossary Without Generating Text} -\label{sec:glsadd} - -It is possible to add a line to the glossary file without -generating any text at that point in the document using: -\begin{definition}[\DescribeMacro{\glsadd}] -\cs{glsadd}\oarg{options}\marg{label} -\end{definition} -This is similar to the \glstextlike\ commands, only it doesn't produce -any text (so therefore, there is no \gloskey[glslink]{hyper} key -available in \meta{options} but all the other options that can -be used with \glstextlike\ commands can be passed to \cs{glsadd}). -For example, to add a page range to the glossary number list for the -entry whose label is given by \texttt{set}: -\begin{verbatim} -\glsadd[format=(]{set} -Lots of text about sets spanning many pages. -\glsadd[format=)]{set} -\end{verbatim} - -To add all entries that have been defined, use: -\begin{definition}[\DescribeMacro{\glsaddall}] -\cs{glsaddall}\oarg{options} -\end{definition} -The optional argument is the same as for \cs{glsadd}, except -there is also a key \gloskey[glsaddall]{types} which can be -used to specify which glossaries to use. This should be a -comma-separated list. For example, if you only want to add -all the entries belonging to the list of acronyms (specified by -the glossary type \ics{acronymtype}) and a list of -notation (specified by the glossary type \texttt{notation}) then you can -do: -\begin{verbatim} -\glsaddall[types={\acronymtype,notation}] -\end{verbatim} -If you are using \gls{bib2gls} with \gls{glossaries-extra}, you -can't use \cs{glsaddall}. Instead use the \optfmt{selection=all} -resource option to select all entries in the given \filetype{bib} files. - -\begin{important} -Note that \cs{glsadd} and \cs{glsaddall} add the current location to -the \gls{numberlist}. In the case of \cs{glsaddall}, all entries in the -glossary will have the same location in the number list. If you want -to use \cs{glsaddall}, it's best to suppress the number list with -the \pkgopt{nonumberlist} package option. (See -sections~\ref{sec:pkgopts-printglos} and~\ref{sec:numberlists}.) -\end{important} - -There is now a variation of \cs{glsaddall} that skips any entries -that have already been used: -\begin{definition}[\DescribeMacro\glsaddallunused] -\cs{glsaddallunused}\oarg{list} -\end{definition} -This command uses \cs{glsadd}\texttt{[format=glsignore]} which will -ignore this location in the number list. The optional argument -\meta{list} is a comma-separated list of glossary types. If omitted, -it defaults to the list of all defined glossaries. - -\begin{important} -If you want to use \cs{glsaddallunused}, it's best to place the -command at the end of the document to ensure that all the commands -you intend to use have already been used. Otherwise you could end up -with a spurious comma or dash in the location list. -\end{important} - -With \gls{glossaries-extra} and \gls{bib2gls}, \texttt{glsignore} -indicates an \qt{ignored location} which influences selection but -isn't added to the location list. In this case, if you use -\optfmt{selection=all} then only those entries that have been -explicitly indexed in the document will have location lists. The -other entries that were selected as a result of -\optfmt{selection=all} won't have location lists. - -Base \sty{glossaries} package only: -\begin{verbatim} -\documentclass{article} -\usepackage{glossaries} -\makeglossaries -\newglossaryentry{cat}{name={cat},description={feline}} -\newglossaryentry{dog}{name={dog},description={canine}} -\begin{document} -\gls{cat}. -\printglossaries -\glsaddallunused % <- make sure dog is also listed -\end{document} -\end{verbatim} -Corresponding \gls{glossaries-extra} and \gls{bib2gls} document code: -\begin{verbatim} -\documentclass{article} -\usepackage[record]{glossaries-extra} -\GlsXtrLoadResources[src={entries},selection=all] -\begin{document} -\gls{cat}. -\printunsrtglossaries -\end{document} -\end{verbatim} -With the file \texttt{entries.bib}: -\begin{verbatim} -@entry{cat,name={cat},description={feline}} -@entry{dog,name={dog},description={canine}} -\end{verbatim} - -\begin{example}{Dual Entries}{ex:dual} -The example file \samplefile{-dual} makes use of \cs{glsadd} to -allow for an entry that should appear both in the main glossary and -in the list of acronyms. This example sets up the list of acronyms -using the \pkgopt{acronym} package option: -\begin{verbatim} -\usepackage[acronym]{glossaries} -\end{verbatim} -A new command is then defined to make it easier to define dual -entries: -\begin{verbatim} -\newcommand*{\newdualentry}[5][]{% - \newglossaryentry{main-#2}{name={#4},% - text={#3\glsadd{#2}},% - description={#5},% - #1 - }% - \newacronym{#2}{#3\glsadd{main-#2}}{#4}% -} -\end{verbatim} -This has the following syntax: -\begin{alltt} -\ics{newdualentry}\oarg{options}\marg{label}\marg{abbrv}\marg{long}\marg{description} -\end{alltt} -You can then define a new dual entry: -\begin{verbatim} -\newdualentry{svm}% label - {SVM}% abbreviation - {support vector machine}% long form - {Statistical pattern recognition technique}% description -\end{verbatim} -Now you can reference the acronym with \verb|\gls{svm}| or you can -reference the entry in the main glossary with \verb|\gls{main-svm}|. - -Note that with \gls{bib2gls}, there are special dual entry types -that implement this behaviour. That is, if an entry is referenced -then its corresponding dual entry will automatically be selected as -well. So there is less need for \cs{glsadd} with \gls{bib2gls}. -(Although it can still be useful, as shown in \opt6.) -\end{example} - -\chapter{Cross-Referencing Entries} -\label{sec:crossref} - -\begin{important} -You must use \ics{makeglossaries} (\optsor23) or -\ics{makenoidxglossaries} (\opt1) \emph{before} defining any -terms that cross-reference entries. If any of the terms that you have -cross-referenced don't appear in the glossary, check that you have -put \cs{makeglossaries}\slash\cs{makenoidxglossaries} before all -entry definitions. The \gls{glossaries-extra} package provides -better cross-reference handling. -\end{important} - -There are several ways of cross-referencing entries in the -glossary: - -\begin{enumerate} -\item You can use commands such as \ics{gls} in the -entries description. For example: -\begin{verbatim} -\newglossaryentry{apple}{name=apple, -description={firm, round fruit. See also \gls{pear}}} -\end{verbatim} -Note that with this method, if you don't use the cross-referenced term -in the main part of the document, you will need two runs of -\gls{makeglossaries}: -\begin{prompt} -pdflatex filename -makeglossaries filename -pdflatex filename -makeglossaries filename -pdflatex filename -\end{prompt} - -\item As described in \sectionref{sec:newglosentry}, you can use the -\gloskey{see} key when you define the entry. For example: -\begin{verbatim} -\newglossaryentry{MaclaurinSeries}{name={Maclaurin -series}, -description={Series expansion}, -see={TaylorsTheorem}} -\end{verbatim} -Note that in this case, the entry with the \gloskey{see} key will -automatically be added to the glossary, but the cross-referenced -entry won't. You therefore need to ensure that you use the -cross-referenced term with the commands described in -\sectionref{sec:glslink} or \sectionref{sec:glsadd}. - -The \qt{see} tag is produce using \ics{seename}, but can be -overridden in specific instances using square brackets -at the start of the \gloskey{see} value. For example: -\begin{verbatim} -\newglossaryentry{MaclaurinSeries}{name={Maclaurin -series}, -description={Series expansion}, -see=[see also]{TaylorsTheorem}} -\end{verbatim} -Take care if you want to use the optional argument of commands such -as \ics{newacronym} or \ics{newterm} as the value will need to be -grouped. For example: -\begin{verbatim} -\newterm{seal} -\newterm[see={[see also]seal}]{sea lion} -\end{verbatim} -Similarly if the value contains a list. For example: -\begin{verbatim} -\glossaryentry{lemon}{ - name={lemon}, - description={Yellow citrus fruit} -} -\glossaryentry{lime} -{ - name={lime}, - description={Green citrus fruit} -} -\glossaryentry{citrus} -{ - name={citrus}, - description={Plant in the Rutaceae family}, - see={lemon,lime} -} -\end{verbatim} - -\item After you have defined the entry, use -\begin{definition}[\DescribeMacro{\glssee}] -\cs{glssee}\oarg{tag}\marg{label}\marg{xr label list} -\end{definition} -where \meta{xr label list} is a comma-separated list of entry -labels to be cross-referenced, \meta{label} is the label of the -entry doing the cross-referencing and \meta{tag} is the \qt{see} tag. -(The default value of \meta{tag} is \ics{seename}.) -For example: -\begin{verbatim} -\glssee[see also]{series}{FourierSeries,TaylorsTheorem} -\end{verbatim} -Note that this automatically adds the entry given by \meta{label} to -the glossary but doesn't add the cross-referenced entries (specified -by \meta{xr label list}) to the glossary. -\end{enumerate} - -In both cases~2 and 3 above, the cross-referenced information -appears in the \gls{numberlist}, whereas in case~1, the -cross-referenced information appears in the description. (See the -\samplefile{-crossref} example file that comes with this package.) -This means that in cases~2 and~3, the cross-referencing information -won't appear if you have suppressed the \gls*{numberlist}. In this -case, you will need to activate the \gls*{numberlist} for the given -entries using \gloskey{nonumberlist=false}. Alternatively, if you -just use the \gloskey{see} key instead of \ics{glssee}, you can -automatically activate the \gls*{numberlist} using the -\pkgopt{seeautonumberlist} package option. - -\section{Customising Cross-reference Text} -\label{sec:customxr} - -When you use either the \gloskey{see} key or the command -\cs{glssee}, the cross-referencing information will be typeset in the -glossary according to: -\begin{definition}[\DescribeMacro{\glsseeformat}] -\cs{glsseeformat}\oarg{tag}\marg{label-list}\marg{location} -\end{definition} -The default definition of \cs{glsseeformat} is: -\begin{display} -\cs{emph}\marg{tag} \cs{glsseelist}\marg{label-list} -\end{display} -Note that the location is always ignored.\footnote{\gls{makeindex} -will always assign a location number, even if it's not needed, so it -needs to be discarded.} For example, if you want the tag to appear -in bold, you can do:\footnote{If you redefine \cs{glsseeformat}, -keep the default value of the optional argument as \ics{seename} as -both \gloskey{see} and \cs{glssee} explicitly write -\texttt[\cs{seename}\texttt] in the output file if no optional -argument is given.} -\begin{verbatim} -\renewcommand*{\glsseeformat}[3][\seename]{\textbf{#1} - \glsseelist{#2}} -\end{verbatim} - - -The list of labels is dealt with by \cs{glsseelist}, which iterates -through the list and typesets each entry in the label. The entries -are separated by -\begin{definition}[\DescribeMacro{\glsseesep}] -\cs{glsseesep} -\end{definition} -or (for the last pair) -\begin{definition}[\DescribeMacro{\glsseelastsep}] -\cs{glsseelastsep} -\end{definition} -These default to ``",\space"'' and -\qt{\cs{space}\ics{andname}\cs{space}} respectively. The list entry text -is displayed using: -\begin{definition}[\DescribeMacro{\glsseeitemformat}] -\cs{glsseeitemformat}\marg{label} -\end{definition} -This defaults to \ics{glsentrytext}\marg{label}.\footnote{In -versions before 3.0, \cs{glsentryname} was used, but this could cause -problems when the \gloskey{name} key was \glsd{sanitize}.} For example, to -make the cross-referenced list use small caps: -\begin{verbatim} -\renewcommand{\glsseeitemformat}[1]{% - \textsc{\glsentrytext{#1}}} -\end{verbatim} - -\begin{important} -You can use \ics{glsseeformat} and \ics{glsseelist} in the main body -of the text, but they won't automatically add the cross-referenced -entries to the glossary. If you want them added with that location, -you can do: -\begin{verbatim} -Some information (see also -\glsseelist{FourierSeries,TaylorsTheorem}% -\glsadd{FourierSeries}\glsadd{TaylorsTheorem}). -\end{verbatim} -\end{important} - -\chapter{Using Glossary Terms Without Links} +\section{Using Glossary Terms Without Links} \label{sec:glsnolink} The commands described in this section display entry details without @@ -9092,10 +8553,10 @@ between the final two elements. The defaults are \begin{important} \cs{glsdisplaynumberlist} is fairly experimental. It works with -\opt1, but for \optsor23 it only works when the default counter +\optsand14, but for \optsor23 it only works when the default counter format is used (that is, when the \gloskey[glslink]{format} key is set to \texttt{glsnumberformat}). This command will only work with -\sty{hyperref} if you choose \opt1. If you try using this command +\sty{hyperref} if you choose \optsor14. If you try using this command with \optsor23 and \sty{hyperref}, \cs{glsentrynumberlist} will be used instead. \end{important} @@ -9104,978 +8565,6 @@ For further information see \ifpdf section~\ref*{sec:code:glsnolink} \fi \qt{Displaying entry details without adding information to the glossary} in the documented code (\texttt{glossaries-code.pdf}). -\chapter{Displaying a glossary} -\label{sec:printglossary} - -All defined glossaries may be displayed using: -\begin{description} -\item[\opt1:] -(Must be used with \ics{makenoidxglossaries} in the preamble.) -\begin{definition}[\DescribeMacro\printnoidxglossaries] -\cs{printnoidxglossaries} -\end{definition} - -\item[\optsand23:] -(Must be used with \ics{makeglossaries} in the preamble.) -\begin{definition}[\DescribeMacro\printglossaries] -\cs{printglossaries} -\end{definition} -\end{description} - -These commands will display all the glossaries in the order in which -they were defined. - -Note that, in the case of \optsand23, no glossaries will appear -until you have either used the Perl script \gls{makeglossaries} or -Lua script \gls{makeglossaries-lite.lua} or have directly used -\gls{makeindex} or \gls{xindy} (as described in -\sectionref{sec:makeglossaries}). - -\begin{important} -While the external files are missing, \cs{printglossary} will just do -\ics{null} for each missing glossary to assist dictionary style -documents that just use \cs{glsaddall} without inserting any text. -This use of \ics{null} ensures that all indexing information is -written before the final page is shipped out. Once the external -files are present \cs{null} 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, \cs{null} -will no longer be used and so shouldn't cause interference for the -final document. -\end{important} - -\begin{xtr} -If you use \gls{glossaries-extra}, it will insert a heading and boilerplate text when the -external files are missing. The extension package also provides -\cs{printunsrtglossaries} as an alternative. See the -\gls{glossaries-extra} manual for further details. -\end{xtr} - -If the glossary still does not appear after you re-\LaTeX\ your -document, check the \gls*{makeindex}\slash\gls*{xindy} log files to -see if there is a problem. With \opt1, you just need two \LaTeX\ -runs to make the glossaries appear, but you may need further runs to -make the \glspl{numberlist} up-to-date. - -An individual glossary can be displayed using: -\begin{description} -\itempar{\opt1:} -\begin{definition}[\DescribeMacro{\printnoidxglossary}] -\cs{printnoidxglossary}\oarg{options} -\end{definition} -(Must be used with \ics{makenoidxglossaries} in the preamble.) - -\itempar{\optsand23:} -\begin{definition}[\DescribeMacro{\printglossary}] -\cs{printglossary}\oarg{options} -\end{definition} -(Must be used with \ics{makeglossaries} in the preamble.) -\end{description} -where \meta{options} is a \meta{key}=\meta{value} list of options. -(Again, when the associated external file is missing, \cs{null} is -inserted into the document.) - -The following keys are available: -\begin{description} -\item[{\gloskey[printglossary]{type}}] The value of this key -specifies which glossary to print. If omitted, the default -glossary is assumed. For example, to print the list of acronyms: -\begin{verbatim} -\printglossary[type=\acronymtype] -\end{verbatim} -Note that you can't display an ignored glossary, so don't try -setting \gloskey[printglossary]{type} to the name of a glossary that -was defined using \ics{newignoredglossary}, described in -\sectionref{sec:newglossary}. (You can display an ignored glossary -with \cs{printunsrtglossary} provided by \gls{glossaries-extra}.) - -\item[{\gloskey[printglossary]{title}}] This is the glossary's -title (overriding the title specified when the glossary was -defined). - -\item[{\gloskey[printglossary]{toctitle}}] This is the title -to use for the table of contents (if the \pkgopt{toc} package -option has been used). It may also be used for the page header, -depending on the page style. If omitted, the value of -\gloskey[printglossary]{title} is used. - -\item[{\gloskey[printglossary]{style}}] This specifies which -glossary style to use for this glossary, overriding the effect -of the \pkgopt{style} package option or \ics{glossarystyle}. - -\item[{\gloskey[printglossary]{numberedsection}}] This specifies -whether to use a numbered section for this glossary, overriding -the effect of the \pkgopt{numberedsection} package option. This -key has the same syntax as the \pkgopt{numberedsection} package -option, described in \sectionref{sec:pkgopts-sec}. - -\item[{\gloskey[printglossary]{nonumberlist}}] This is a boolean -key. If true (\verb|nonumberlist=true|) the numberlist is suppressed -for this glossary. If false (\verb|nonumberlist=false|) the -numberlist is displayed for this glossary. - -\item[{\gloskey[printglossary]{nogroupskip}}] This is a boolean -key. If true the vertical gap between groups -is suppressed for this glossary. - -\item[{\gloskey[printglossary]{nopostdot}}] This is a boolean -key. If true the full stop after the description -is suppressed for this glossary. - -\item[{\gloskey[printglossary]{entrycounter}}] This is a boolean -key. Behaves similar to the package option of the same name. -The corresponding package option must be used to make \ics{glsrefentry} -work correctly. - -\item[{\gloskey[printglossary]{subentrycounter}}] This is a boolean -key. Behaves similar to the package option of the same name. If you -want to set both \gloskey{entrycounter} and -\gloskey{subentrycounter}, make sure you specify -\gloskey{entrycounter} first. The corresponding package option must -be used to make \ics{glsrefentry} work correctly. - -\item[{\gloskey[printnoidxglossary]{sort}}] This key is only -available for \opt1. Possible values are: \texttt{word} (word -order), \texttt{letter} (letter order), \texttt{standard} (word or -letter ordering taken from the \pkgopt{order} package option), -\texttt{use} (order of use), \texttt{def} (order of definition) -\texttt{nocase} (case-insensitive) or \texttt{case} (case-sensitive). -Note that the word and letter comparisons (that is, everything other -than \texttt{sort=use} and \texttt{sort=def}) just use a simple -character code comparison. For a locale-sensitive sort, you must use -either \gls{xindy} (\opt3) or \gls{bib2gls} (\opt4). Note that \gls{bib2gls} -provides many other sort options. - -\begin{important} -If you use the \texttt{use} or \texttt{def} values make sure -that you select a glossary style that doesn't have a visual -indicator between groups, as the grouping no longer makes sense. -Consider using the \pkgopt{nogroupskip} option. -\end{important} - -{\raggedright -The word and letter order sort methods use -\sty{datatool}'s -\ics{dtlwordindexcompare} and \ics{dtlletterindexcompare} handlers. -The case-insensitive sort method uses \sty{datatool}'s -\ics{dtlicompare} handler. The case-sensitive sort method uses -\sty{datatool}'s \ics{dtlcompare} handler. See the \sty{datatool} -documentation for further details. -\par} - -If you don't get an error with \texttt{sort=use} and -\texttt{sort=def} but you do get an error with one of the other sort -options, then you probably need to use the -\pkgopt[true]{sanitizesort} package option or make sure none of the -entries have fragile commands in their \gloskey{sort} field. - -\item[{\xtrprintglosskey[\marg{label}]{label}}] -This key is only available with \gls{glossaries-extra} and labels -the glossary with \cs{label}\marg{label}. This is an alternative to -the package option \pkgopt[autolabel]{numberedsection} - -\item[\xtrprintglosskey{target}] This is a boolean key only -available with \gls{glossaries-extra}, which can be used to switch -off the automatic hypertarget for each entry. (This refers to the -target used by commands like \cs{gls} and \cs{glslink}.) - -This option is useful with \ics*{printunsrtglossary} as it allows -the same list (of sub-list) of entries to be displayed multiple -times without causing duplicate hypertarget names. - -\item[{\xtrprintglosskey[\marg{prefix}]{prefix}}] -This key is only available with \gls{glossaries-extra} and provides -another way of avoiding duplicate hypertarget names is to use a -different prefix for those names. This locally redefines -\ics{glolinkprefix} but note this will also affect the target for any entry -referenced within the glossary with commands like \cs{gls}, -\cs{glslink} or \cs{glshypertarget}. - -\item[{\xtrprintglosskey[\marg{prefix}]{targetnameprefix}}] -This key is only available with \gls{glossaries-extra}. -This is similar to the \pkgoptfmt{prefix} option, but it alters the prefix of -the hypertarget anchors without changing \ics{glslinkprefix} (so it -won't change the hyperlinks for any entries referenced in the -glossary). - -\end{description} - -By default, the glossary is started either by \ics{chapter*} or by -\ics{section*}, depending on whether or not \ics{chapter} is defined. -This can be overridden by the \pkgopt{section} package option or the -\ics{setglossarysection} command. Numbered sectional units can be -obtained using the \pkgopt{numberedsection} package option. Each -glossary sets the page header via the command -\begin{definition}[\DescribeMacro\glsglossarymark] -\ics{glsglossarymark}\marg{title} -\end{definition} -If this mechanism is unsuitable for your chosen class file or page -style package, you will need to redefine \ics{glsglossarymark}. Further -information about these options and commands is given in -\sectionref{sec:pkgopts-sec}. - -Information can be added to the start of the glossary (after the -title and before the main body of the glossary) by redefining -\begin{definition}[\DescribeMacro{\glossarypreamble}] -\cs{glossarypreamble} -\end{definition} -For example: -\begin{verbatim} -\renewcommand{\glossarypreamble}{Numbers in italic -indicate primary definitions.} -\end{verbatim} -This needs to be done before the glossary is displayed. - -If you want a different preamble per glossary you can use -\begin{definition}[\DescribeMacro{\setglossarypreamble}] -\cs{setglossarypreamble}\oarg{type}\marg{preamble text} -\end{definition} -If \meta{type} is omitted, \cs{glsdefaulttype} is used. - -For example: -\begin{verbatim} -\setglossarypreamble{Numbers in italic -indicate primary definitions.} -\end{verbatim} -This will print the given preamble text for the main glossary, -but not have any preamble text for any other glossaries. - -There is an analogous command to \cs{glossarypreamble} called -\begin{definition}[\DescribeMacro{\glossarypostamble}] -\cs{glossarypostamble} -\end{definition} -which is placed at the end of each glossary. - -\begin{example}{Switch to Two Column Mode for Glossary}{ex:twocolumn} -Suppose you are using the \glostyle{superheaderborder} -style\footnote{you can't use the \glostyle{longheaderborder} style -for this example as you can't use the \env{longtable} environment in -two column mode.}, and you want the glossary to be in two columns, -but after the glossary you want to switch back to one column mode, -you could do: -\begin{verbatim} -\renewcommand*{\glossarysection}[2][]{% - \twocolumn[{\chapter*{#2}}]% - \setlength\glsdescwidth{0.6\linewidth}% - \glsglossarymark{\glossarytoctitle}% -} - -\renewcommand*{\glossarypostamble}{\onecolumn} -\end{verbatim} - -\end{example} - -Within each glossary, each entry name is formatted according to -\begin{definition}[\DescribeMacro{\glsnamefont}] -\cs{glsnamefont}\marg{name} -\end{definition} -which takes one argument: the entry name. This command is always -used regardless of the glossary style. By default, \cs{glsnamefont} -simply displays its argument in whatever the surrounding font -happens to be. This means that in the list-like glossary styles -(defined in the \sty{glossary-list} style file) the name will appear -in bold, since the name is placed in the optional argument of -\cs{item}, whereas in the tabular styles (defined in the -\sty{glossary-long} and \sty{glossary-super} style files) the name -will appear in the normal font. The hierarchical glossary styles -(defined in the \sty{glossary-tree} style file) also set the name in -bold. - -If you want to change the font for the description, or if you -only want to change the name font for some types of entries -but not others, you might want to consider using the -\gls{glossaries-extra} package. - -\begin{example}{Changing the Font Used to Display Entry Names in the -Glossary}{ex:glsnamefont} -Suppose you want all the entry names to appear in -medium weight small caps in your glossaries, then you can do: -\begin{verbatim} -\renewcommand{\glsnamefont}[1]{\textsc{\mdseries #1}} -\end{verbatim} -\end{example} - -\chapter[Xindy (Option 3)]{Xindy (\ifpdf\opt3\else Option 3\fi)} -\label{sec:xindy} - -If you want to use \gls{xindy} to sort the glossary, you -must use the package option \pkgopt{xindy}: -\begin{verbatim} -\usepackage[xindy]{glossaries} -\end{verbatim} -This ensures that the glossary information is written in -\gls*{xindy} syntax. - -\sectionref{sec:makeglossaries} covers how to use the external -\gls{indexingapp}, and \sectionref{sec:locationsyntax} covers the -issues involved in the location syntax. This section covers the -commands provided by the \styfmt{glossaries} package that allow you -to adjust the \gls{xindy} style file (\filetype{xdy}) and -parameters. - -To assist writing information to the \gls{xindy} style -file, the \styfmt{glossaries} package provides the following -commands: -\begin{definition}[\DescribeMacro{\glsopenbrace}] -\cs{glsopenbrace} -\end{definition} -\begin{definition}[\DescribeMacro{\glsclosebrace}] -\cs{glsclosebrace} -\end{definition} -which produce an open and closing brace. (This is needed because -\verb|\{| and \verb|\}| don't expand to a simple brace character -when written to a file.) Similarly, you can write a percent -character using: -\begin{definition}[\DescribeMacro{\glspercentchar}] -\cs{glspercentchar} -\end{definition} -and a tilde character using: -\begin{definition}[\DescribeMacro{\glstildechar}] -\cs{glstildechar} -\end{definition} -For example, a newline character is specified in a \gls{xindy} style -file using \verb|~n| so you can use \texttt{\cs{glstildechar} n} -to write this correctly (or you can do \verb|\string~n|). -A backslash can be written to a file using -\begin{definition}[\DescribeMacro{\glsbackslash}] -\cs{glsbackslash} -\end{definition} - -In addition, if you are using a package that makes the double -quote character active (e.g. \sty{ngerman}) you can use: -\begin{definition}[\DescribeMacro{\glsquote}] -\cs{glsquote}\marg{text} -\end{definition} -which will produce \verb|"|\meta{text}\verb|"|. Alternatively, -you can use \verb|\string"| to write the double-quote character. -This document assumes that the double quote character has not been -made active, so the examples just use \verb|"| for clarity. - -If you want greater control over the \gls{xindy} style file than is -available through the \LaTeX\ commands provided by the -\styfmt{glossaries} package, you will need to edit the \gls*{xindy} -style file. In which case, you must use \ics{noist} to prevent the -style file from being overwritten by the \styfmt{glossaries} -package. For additional information about \gls*{xindy}, read the -\gls*{xindy} documentation. I'm sorry I can't provide any assistance -with writing \gls*{xindy} style files. If you need help, I recommend -you ask on the \gls*{xindy} mailing list -(\url{http://xindy.sourceforge.net/mailing-list.html}). - -\section{Language and Encodings} -\label{sec:langenc} - -When you use \gls{xindy}, you need to specify the language -and encoding used (unless you have written your own custom -\gls*{xindy} style file that defines the relevant alphabet -and sort rules). If you use \gls{makeglossaries}, -this information is obtained from the document's auxiliary -(\filetype{aux}) file. The \gls{makeglossaries} script attempts to -find the root language given your document settings, but in the -event that it gets it wrong or if \gls*{xindy} doesn't support -that language, then you can specify the required language using: -\begin{definition}[\DescribeMacro{\GlsSetXdyLanguage}] -\cs{GlsSetXdyLanguage}\oarg{glossary type}\marg{language} -\end{definition} -where \meta{language} is the name of the language. The -optional argument can be used if you have multiple glossaries -in different languages. If \meta{glossary type} is omitted, it -will be applied to all glossaries, otherwise the language -setting will only be applied to the glossary given by -\meta{glossary type}. - -If the \sty{inputenc} package is used, the encoding will be -obtained from the value of \ics{inputencodingname}. -Alternatively, you can specify the encoding using: -\begin{definition}[\DescribeMacro{\GlsSetXdyCodePage}] -\cs{GlsSetXdyCodePage}\marg{code} -\end{definition} -where \meta{code} is the name of the encoding. For example: -\begin{verbatim} -\GlsSetXdyCodePage{utf8} -\end{verbatim} - -Note that you can also specify the language and encoding using -the package option -\verb|xindy={language=|\meta{lang}\verb|,codepage=|\meta{code}\verb|}|. -For example: -\begin{verbatim} -\usepackage[xindy={language=english,codepage=utf8}]{glossaries} -\end{verbatim} - -If you write your own custom \gls{xindy} style file that -includes the language settings, you need to set the language -to nothing: -\begin{verbatim} -\GlsSetXdyLanguage{} -\end{verbatim} -(and remember to use \ics{noist} to prevent the style file from -being overwritten). - -\begin{important} -The commands \cs{GlsSetXdyLanguage} and \cs{GlsSetXdyCodePage} -have no effect if you don't use \gls{makeglossaries}. If -you call \gls{xindy} without \gls*{makeglossaries} you -need to remember to set the language and encoding using the -\xdyopt{L} and \xdyopt{C} switches. -\end{important} - -\section{Locations and Number lists} -\label{sec:xindyloc} - -If you use \pkgopt{xindy}, the \styfmt{glossaries} package needs to -know which counters you will be using in the \gls{numberlist} in order to correctly format the \gls{xindy} style -file. Counters specified using the \pkgopt{counter} package option -or the \meta{counter} option of \ics{newglossary} are -automatically taken care of, but if you plan to use a different -counter in the \gloskey[glslink]{counter} key for commands like -\ics{glslink}, then you need to identify these counters \emph{before} -\ics{makeglossaries} using: -\begin{definition}[\DescribeMacro{\GlsAddXdyCounters}] -\cs{GlsAddXdyCounters}\marg{counter list} -\end{definition} -where \meta{counter list} is a comma-separated list of counter names. - -The most likely \ixindyattrs attributes used in the \gloskey[glslink]{format} -key (\locfmt{textrm}, \locfmt{hyperrm} etc) are automatically added -to the \gls{xindy} style file, but if you want to use another -attribute, you need to add it using: -\begin{definition}[\DescribeMacro{\GlsAddXdyAttribute}] -\cs{GlsAddXdyAttribute}\marg{name} -\end{definition} -where \meta{name} is the name of the attribute, as used in -the \gloskey[glslink]{format} key. - -Take care if you have multiple instances of the same location with -different formats. The duplicate locations will be discarded -according to the order in which the \ixindyattrs attributes are listed. Consider -defining semantic commands to use for primary references. For -example: -\begin{verbatim} -\newcommand*{\primary}[1]{\textbf{#1}} -\GlsAddXdyAttribute{primary} -\end{verbatim} -Then in the document: -\begin{verbatim} -A \gls[format=primary]{duck} is an aquatic bird. -There are lots of different types of \gls{duck}. -\end{verbatim} -This will give the \verb|format=primary| instance preference over -the next use that doesn't use the \gloskey[glslink]{format} key. - -\begin{example}{Custom Font for Displaying a Location}{ex:hyperbfit} -Suppose I want a bold, italic, hyperlinked location. I first need to define a -command that will do this: -\begin{verbatim} -\newcommand*{\hyperbfit}[1]{\textit{\hyperbf{#1}}} -\end{verbatim} -but with \gls{xindy}, I also need to add this as an allowed -\ixindyattrs attribute: -\begin{verbatim} -\GlsAddXdyAttribute{hyperbfit} -\end{verbatim} -Now I can use it in the optional argument of commands like -\ics{gls}: -\begin{verbatim} -Here is a \gls[format=hyperbfit]{sample} entry. -\end{verbatim} -(where \texttt{sample} is the label of the required entry). -\end{example} - -\begin{important} -Note that \cs{GlsAddXdyAttribute} has no effect if \ics{noist} is -used or if \ics{makeglossaries} is omitted. -\cs{GlsAddXdyAttribute} must be used before \ics{makeglossaries}. -Additionally, \cs{GlsAddXdyCounters} must come before -\cs{GlsAddXdyAttribute}. -\end{important} - -If the location numbers include formatting commands, then -you need to add a location style in the appropriate format using -\begin{definition}[\DescribeMacro{\GlsAddXdyLocation}] -\cs{GlsAddXdyLocation}\oarg{prefix-location}\marg{name}\marg{definition} -\end{definition} -where \meta{name} is the name of the format and \meta{definition} is -the \gls{xindy} definition. The optional argument \meta{prefix-location} -is needed if \cs{theH}\meta{counter} either isn't defined or is -different from \cs{the}\meta{counter}. -Be sure to also read \sectionref{sec:locationsyntax} for some issues -that you may encounter. - -\begin{important} -Note that \cs{GlsAddXdyLocation} has no effect if \ics{noist} is -used or if \ics{makeglossaries} is omitted. -\cs{GlsAddXdyLocation} must be used before \ics{makeglossaries}. -\end{important} - -\begin{example}{Custom Numbering System for Locations}{ex:customloc} -Suppose I decide to use a somewhat eccentric numbering -system for sections where I redefine \cs{thesection} as follows: -\begin{verbatim} -\renewcommand*{\thesection}{[\thechapter]\arabic{section}} -\end{verbatim} -If I haven't done "counter=section" in the package -option, I need to specify that the counter will be used as a -location number: -\begin{verbatim} -\GlsAddXdyCounters{section} -\end{verbatim} -Next I need to add the location style (\cs{thechapter} is assumed to -be the standard \verb"\arabic{chapter}"): -\begin{verbatim} -\GlsAddXdyLocation{section}{:sep "[" "arabic-numbers" :sep "]" - "arabic-numbers" -} -\end{verbatim} -Note that if I have further decided to use the \sty{hyperref} -package and want to redefine \cs{theHsection} as: -\begin{verbatim} -\renewcommand*{\theHsection}{\thepart.\thesection} -\renewcommand*{\thepart}{\Roman{part}} -\end{verbatim} -then I need to modify the \cs{GlsAddXdyLocation} code above to: -\begin{verbatim} -\GlsAddXdyLocation["roman-numbers-uppercase"]{section}{:sep "[" - "arabic-numbers" :sep "]" "arabic-numbers" -} -\end{verbatim} -Since \ics{Roman} will result in an empty string if the counter is -zero, it's a good idea to add an extra location to catch this: -\begin{verbatim} -\GlsAddXdyLocation{zero.section}{:sep "[" - "arabic-numbers" :sep "]" "arabic-numbers" -} -\end{verbatim} -This example is illustrated in the sample file -\samplefile{xdy2}. -\end{example} - -\begin{example}{Locations as Dice}{ex:dice} -Suppose I want a rather eccentric page numbering system that's -represented by the number of dots on dice. The \sty{stix} package -provides \cs{dicei}, \ldots, \cs{dicevi} that represent the six -sides of a die. I can define a command that takes a number as its -argument. If the number is less than seven, the appropriate -\cs{dice}\meta{n} command is used otherwise it does \cs{dicevi} the -required number of times with the leftover in a final -\cs{dice}\meta{n}. For example, the number 16 is represented by -\verb|\dicevi\dicevi\diceiv| ($6+6+4=16$). I've called this command -\cs{tallynum} to match the example given earlier in -\sectionref{sec:locationsyntax}: -\begin{verbatim} -\newrobustcmd{\tallynum}[1]{% - \ifnum\number#1<7 - $\csname dice\romannumeral#1\endcsname$% - \else - $\dicevi$% - \expandafter\tallynum\expandafter{\numexpr#1-6}% - \fi -} -\end{verbatim} -Here's the counter command: -\begin{verbatim} -newcommand{\tally}[1]{\tallynum{\arabic{#1}}} -\end{verbatim} -The \ctr{page} counter representation (\cs{thepage}) needs to be -changed to use this command: -\begin{verbatim} -\renewcommand*{\thepage}{\tally{page}} -\end{verbatim} -The \cs{tally} command expands to \cs{tallynum} \marg{number} so -this needs a location class that matches this format: -\begin{verbatim} -\GlsAddXdyLocation{tally}{% - :sep "\string\tallynum\space\glsopenbrace" - "arabic-numbers" - :sep "\glsclosebrace" -} -\end{verbatim} -The space between \cs{tallynum} and \marg{number} is -significant to \gls{xindy} so \cs{space} is required. - -Note that \cs{GlsAddXdyLocation}\marg{name}\marg{definition} will define -commands in the form: -\begin{definition} -\cs{glsX}\meta{counter}"X"\meta{name}\marg{Hprefix}\marg{location} -\end{definition} -for each counter that has been identified either by the -\pkgopt{counter} package option, the \meta{counter} option for -\ics{newglossary} or in the argument of \ics{GlsAddXdyCounters}. -The first argument \meta{Hprefix} is only relevant when used with -the \sty{hyperref} package and indicates that \cs{theH}\meta{counter} -is given by \cs{Hprefix}"."\cs{the}\meta{counter}. - -The sample file \samplefile{xdy}, which comes with the \styfmt{glossaries} -package, uses the default \ctr{page} counter for locations, and it -uses the default \ics{glsnumberformat} and a custom \cs{hyperbfit} -format. A new \gls{xindy} location called \texttt{tallynum}, as -illustrated above, is defined to make the page numbers appear as -dice. In order for the location numbers to -hyperlink to the relevant pages, I~need to redefine the necessary -\cs{glsX}\meta{counter}"X"\meta{format} commands: -\begin{verbatim} -\renewcommand{\glsXpageXglsnumberformat}[2]{% - \linkpagenumber#2% -} - -\renewcommand{\glsXpageXhyperbfit}[2]{% - \textbf{\em\linkpagenumber#2}% -} - -\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} -\end{verbatim} -Note that the second argument of \cs{glsXpageXglsnumberformat} is -in the format \cs{tallynum}\marg{n} so the line -\begin{verbatim} - \linkpagenumber#2% -\end{verbatim} -does -\begin{alltt} - \cs{linkpagenumber}\cs{tallynum}\marg{number} -\end{alltt} -so \cs{tallynum} is the first argument of \cs{linkpagenumber} -and \meta{number} is the second argument. -\end{example} - -\begin{important} -This method is very sensitive to the internal definition of the -location command. -\end{important} - -\begin{example}{Locations as Words not Digits}{ex:fmtcount} -Suppose I want the page numbers written as words -rather than digits and I~use the \sty{fmtcount} package to -do this. I~can redefine \ics{thepage} as follows: -\begin{verbatim} -\renewcommand*{\thepage}{\Numberstring{page}} -\end{verbatim} -This \emph{used} to get expanded to \verb|\protect \Numberstringnum |\marg{n} -where \meta{n} is the Arabic page number. This means that I~needed to -define a new location with the form: -\begin{verbatim} -\GlsAddXdyLocation{Numberstring}{:sep "\string\protect\space - \string\Numberstringnum\space\glsopenbrace" - "arabic-numbers" :sep "\glsclosebrace"} -\end{verbatim} -and if I'd used the \cs{linkpagenumber} command from the previous -example, it would need \emph{three} arguments (the first being -\cs{protect}): -\begin{verbatim} -\newcommand{\linkpagenumber}[3]{\hyperlink{page.#3}{#1#2{#3}}} -\end{verbatim} - -The internal definition of \cs{Numberstring} has since changed -so that it now expands to \verb|\Numberstringnum |\marg{n} -(no \cs{protect}). This means that the location class definition -must be changed to: -\begin{verbatim} -\GlsAddXdyLocation{Numberstring}{% no \protect now! - :sep "\string\Numberstringnum\space\glsopenbrace" - "arabic-numbers" :sep "\glsclosebrace"} -\end{verbatim} -and \cs{linkpagenumber} goes back to only two arguments: -\begin{verbatim} -\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} -\end{verbatim} -The other change is that \cs{Numberstring} uses -\begin{alltt} -\cs{the}\cs{value}\marg{counter} -\end{alltt} -instead of -\begin{alltt} -\cs{expandafter}\cs{the}\cs{csname} c@\meta{counter}\cs{endcsname} -\end{alltt} -so it hides \cs{c@page} from the location escaping mechanism -(see \sectionref{sec:locationsyntax}). This means that the page -number may be incorrect if the indexing occurs during the output -routine. - -A more recent change to \sty{fmtcount} (v3.03) now puts three -instances of \cs{expandafter} before \verb|\the\value| which -no longer hides \cs{c@page} from the location escaping mechanism, so -the page numbers should once more be correct. Further changes -to the \sty{fmtcount} package may cause a problem again. - -\begin{important} -When dealing with custom formats where the internal definitions -are outside of your control and liable to change, it's best -to provide a wrapper command. -\end{important} - -Instead of directly using \cs{Numberstring} in the definition of -\cs{thepage}, I can provide a custom command in the same form -as the earlier \cs{tally} command: -\begin{verbatim} -\newcommand{\customfmt}[1]{\customfmtnum{\arabic{#1}}} -\newrobustcmd{\customfmtnum}[1]{\Numberstringnum{#1}} -\end{verbatim} -This ensures that the location will always be written to -the indexing file in the form: -\begin{alltt} -:locref "\glsopenbrace\glsclosebrace\glsopenbrace\string\\customfmtnum \marg{n}\glsclosebrace" -\end{alltt} -So the location class can be defined as: -\begin{verbatim} -\GlsAddXdyLocation{customfmt}{ - :sep "\string\customfmtnum\space\glsopenbrace" - "arabic-numbers" - :sep "\glsclosebrace"} -\end{verbatim} - -The sample file -\samplefile{xdy3} illustrates this. -\end{example} - -In the \gls{numberlist}, the locations are sorted according to the list -of provided location classes. The default ordering is: -\texttt{roman-page-numbers} (i, ii, \ldots), \texttt{arabic-page-numbers} -(1, 2, \ldots), \texttt{arabic-section-numbers} (for example, 1.1 if the -compositor is a full stop or 1-1 if the compositor is a -hyphen\footnote{see \ics{glsSetCompositor} described in -\sectionref{sec:setup}}), \texttt{alpha-page-numbers} (a, b, \ldots), -\texttt{Roman-page-numbers} (I, II, \ldots), \texttt{Alpha-page-numbers} -(A, B, \ldots), \texttt{Appendix-page-numbers} (for example, A.1 if the Alpha -compositor is a full stop or A-1 if the Alpha compositor is a -hyphen\footnote{see \ics{glsSetAlphaCompositor} described in -\sectionref{sec:setup}}), user defined location names (as specified -by \ics{GlsAddXdyLocation} in the order in which they were defined), -and finally \texttt{see} (cross-referenced entries).\footnote{With -\gls{glossaries-extra} \texttt{seealso} is appended to the end of -the list.} This ordering can be changed using: - -\begin{definition}[\DescribeMacro\GlsSetXdyLocationClassOrder] -\cs{GlsSetXdyLocationClassOrder}\marg{location names} -\end{definition} -where each location name is delimited by double quote marks and -separated by white space. For example: -\begin{verbatim} -\GlsSetXdyLocationClassOrder{ - "arabic-page-numbers" - "arabic-section-numbers" - "roman-page-numbers" - "Roman-page-numbers" - "alpha-page-numbers" - "Alpha-page-numbers" - "Appendix-page-numbers" - "see" -} -\end{verbatim} -(Remember to add \verb|"seealso"| if you're using -\gls{glossaries-extra}.) - -\begin{important} -Note that \cs{GlsSetXdyLocationClassOrder} has no effect if -\ics{noist} is used or if \ics{makeglossaries} is omitted. -\cs{GlsSetXdyLocationClassOrder} must be used before -\ics{makeglossaries}. -\end{important} - -If a \gls{numberlist} consists of a sequence of consecutive -numbers, the range will be concatenated. The -number of consecutive locations that causes a range formation -defaults to 2, but can be changed using: - -\begin{definition}[\DescribeMacro\GlsSetXdyMinRangeLength] -\cs{GlsSetXdyMinRangeLength}\marg{n} -\end{definition} -For example: -\begin{verbatim} -\GlsSetXdyMinRangeLength{3} -\end{verbatim} -The argument may also be the keyword \texttt{none}, to indicate that -there should be no range formations. See the \gls{xindy} -manual for further details on range formations. - -\begin{important} -Note that \cs{GlsSetXdyMinRangeLength} has no effect if \ics{noist} -is used or if \ics{makeglossaries} is omitted. -\cs{GlsSetXdyMinRangeLength} must be used before -\ics{makeglossaries}. -\end{important} -See also \sectionref{sec:ranges}. - -\section{Glossary Groups} -\label{sec:groups} - -The glossary is divided into groups according to the first -letter of the sort key. The \styfmt{glossaries} package also adds -a number group by default, unless you suppress it in the -\pkgopt{xindy} package option. For example: -\begin{verbatim} -\usepackage[xindy={glsnumbers=false}]{glossaries} -\end{verbatim} -Any entry that doesn't go in one of the letter groups or the -number group is placed in the default group. If you want \gls{xindy} -to sort the number group numerically (rather than by a string sort) -then you need to use \gls{xindy}['s] \texttt{numeric-sort} module: -\begin{verbatim} -\GlsAddXdyStyle{numeric-sort} -\end{verbatim} - -If you don't use \texttt{glsnumbers=false}, the default behaviour is to locate -the number group before the \qt{A} letter group. If you are not using a -Roman alphabet, you need to change this using: - - -\begin{definition}[\DescribeMacro\GlsSetXdyFirstLetterAfterDigits] -\cs{GlsSetXdyFirstLetterAfterDigits}\marg{letter} -\end{definition} -where \meta{letter} is the first letter of your alphabet. Take care -if you're using \sty{inputenc} as non-ASCII characters are actually -active characters that expand. (This isn't a problem with the native -UTF-8 engines and \sty{fontspec}.) The starred form will sanitize -the argument to prevent expansion. -Alternatively you can use: - - -\begin{definition}[\DescribeMacro\GlsSetXdyNumberGroupOrder] -\cs{GlsSetXdyNumberGroupOrder}\marg{relative location} -\end{definition} -to change the default -\begin{alltt} -:before \cs{string}"\meta{letter}\cs{string}" -\end{alltt} -to \meta{relative location}. For example: -\begin{verbatim} -\GlsSetXdyNumberGroupOrder{:after \string"Z\string"} -\end{verbatim} -will put the number group after the \qt{Z} letter group. -Again take care of active characters. There's a starred version -that sanitizes the argument (so don't use \cs{string} in it). -\begin{alltt} -\cs{GlsSetXdyNumberGroupOrder}*\{:after "\"O"\} -\end{alltt} - -\begin{important} -Note that these commands have no effect if -\ics{noist} is used or if \ics{makeglossaries} is omitted. -\cs{GlsSetXdyFirstLetterAfterDigits} must be used before -\ics{makeglossaries}.\par -\end{important} - - -\chapter{Defining New Glossaries} -\label{sec:newglossary} - -A new glossary can be defined using: -\begin{definition}[\DescribeMacro{\newglossary}] -\cs{newglossary}\oarg{log-ext}\marg{name}\marg{in-ext}\marg{out-ext}\linebreak\marg{title}\oarg{counter} -\end{definition} -where \meta{name} is the label to assign to this glossary. -The arguments \meta{in-ext} and \meta{out-ext} specify the extensions to -give to the input and output files for that glossary, \meta{title} -is the default title for this new glossary and the final optional -argument \meta{counter} specifies which counter to use for the -associated \glspl{numberlist} (see also -\sectionref{sec:numberlists}). The first optional argument specifies -the extension for the \gls{makeindex} (\opt2) or \gls{xindy} (\opt3) -transcript file (this information is only used by -\gls{makeglossaries} which picks up the information from the -auxiliary file). If you use \opt1, the \meta{log-ext}, -\meta{in-ext} and \meta{out-ext} arguments are ignored. - -\begin{important} -The glossary label \meta{name} must not contain any active -characters. It's generally best to stick with just characters that -have category code~11 (typically the non-extended \glspl{latinchar} -for standard \LaTeX). -\end{important} - -There is also a starred version (new to v4.08): -\begin{definition}[\DescribeMacro{\newglossary*}] -\cs{newglossary*}\marg{name}\marg{title}\oarg{counter} -\end{definition} -which is equivalent to -\begin{alltt} -\cs{newglossary}[\meta{name}-glg]\marg{name}\{\meta{name}-gls\}\{\meta{name}-glo\}\ifpdf\linebreak\fi\marg{title}\oarg{counter} -\end{alltt} -or you can also use: -\begin{definition}[\DescribeMacro{\altnewglossary}] -\cs{altnewglossary}\marg{name}\marg{tag}\marg{title}\oarg{counter} -\end{definition} -which is equivalent to -\begin{alltt} -\cs{newglossary}[\meta{tag}-glg]\marg{name}\{\meta{tag}-gls\}\{\meta{tag}-glo\}\marg{title}\oarg{counter} -\end{alltt} - -It may be that you have some terms that are so common -that they don't need to be listed. In this case, you can define -a~special type of glossary that doesn't create any associated files. -This is referred to as an \qt{ignored glossary} and it's ignored by -commands that iterate over all the glossaries, such as -\ics{printglossaries}. To define an ignored glossary, use -\begin{definition}[\DescribeMacro\newignoredglossary] -\cs{newignoredglossary}\marg{name} -\end{definition} -where \meta{name} is the name of the glossary (as above). This -glossary type will automatically be added to the -\pkgopt{nohypertypes} list, since there are no hypertargets for -the entries in an ignored glossary. -(The sample file \samplefile{-entryfmt} defines an ignored glossary.) - -\begin{xtr} -The \gls{glossaries-extra} package provides a starred version of -this command that allows hyperlinks (since ignored glossaries can be -useful with \gls{bib2gls}). There is also an analogous -\ics*{provideignoredglossary} command. -\end{xtr} - -You can test if a glossary is an ignored one using: -\begin{definition}[\DescribeMacro\ifignoredglossary] -\cs{ifignoredglossary}\marg{name}\marg{true}\marg{false} -\end{definition} -This does \meta{true} if \meta{name} was defined as an ignored -glossary, otherwise it does \meta{false}. - -Note that the main (default) glossary is automatically created as: -\begin{verbatim} -\newglossary{main}{gls}{glo}{\glossaryname} -\end{verbatim} -so it can be identified by the label \texttt{main} (unless the -\pkgopt{nomain} package option is used). Using the -\pkgopt{acronym} package option is equivalent to: -\begin{verbatim} -\newglossary[alg]{acronym}{acr}{acn}{\acronymname} -\end{verbatim} -so it can be identified by the label \texttt{acronym}. If you are -not sure whether the \pkgopt{acronym} option has been used, you -can identify the list of acronyms by the command -\DescribeMacro{\acronymtype}\cs{acronymtype} which is set to -\texttt{acronym}, if the \pkgopt{acronym} option has been used, -otherwise it is set to \texttt{main}. Note that if you are using -the main glossary as your list of acronyms, you need to declare -it as a list of acronyms using the package option -\pkgopt{acronymlists}. - -The \pkgopt{symbols} package option creates a new glossary with the -label \texttt{symbols} using: -\begin{verbatim} -\newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname} -\end{verbatim} -The \pkgopt{numbers} package option creates a new glossary with -the label \texttt{numbers} using: -\begin{verbatim} -\newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname} -\end{verbatim} -The \pkgopt{index} package option creates a new glossary with -the label \texttt{index} using: -\begin{verbatim} -\newglossary[ilg]{index}{ind}{idx}{\indexname} -\end{verbatim} - -\begin{important} -\optsand23: all glossaries must be defined before \ics{makeglossaries} to -ensure that the relevant output files are opened. - -See \sectionref{sec:fixednames} if you want to redefine \cs{glossaryname}, -especially if you are using \sty{babel} or \sty{translator}. -(Similarly for \cs{glssymbolsgroupname} and -\cs{glsnumbersgroupname}.) If you want to redefine \ics{indexname}, -just follow the advice in -\href{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fixnam}{How to -change LaTeX’s \qt{fixed names}}. -\end{important} - \chapter{Acronyms and Other Abbreviations} \label{sec:acronyms} @@ -10093,22 +8582,40 @@ If the glossary title is no longer applicable (for example, it should be \qt{Abbreviations} rather than \qt{Acronyms}) then you can change the title either by redefining \ics{acronymname} (see \sectionref{sec:languages}) or by using the \gloskey[printglossary]{title} -in the optional argument of \ics{printglossary} (or +key in the optional argument of \ics{printglossary} (or \ics{printacronyms}). Alternatively consider using the \gls{glossaries-extra} package's \pkgopt*{abbreviations} option instead. \end{important} -You may have noticed in \sectionref{sec:newglosentry} that when you -specify a new entry, you can specify alternate text to use when the -term is \glsd{firstuse} in the document. This provides a -useful means to define abbreviations. For convenience, the -\styfmt{glossaries} package defines the command: +Acronyms use the same underlying mechanism as terms defined with +\cs{newglossaryentry} so you can reference them with \ics{gls} and +\ics{glspl}. The way the acronym is displayed on \gls{firstuse} is +governed by the acronym style, which should be set before you define +your acronyms. For example: +\begin{verbatim} +\documentclass{article} +\usepackage{glossaries} +\setacronymstyle{long-short} +\newacronym{html}{HTML}{hypertext markup language} +\newacronym{xml}{XML}{extensible markup language} +\begin{document} +First use: \gls{html} and \gls{xml}. +Next use: \gls{html} and \gls{xml}. +\end{document} +\end{verbatim} +If you don't specify a style, you will have a less-flexible, but +backward-compatible, \qt{long (short)} style with just the base +\styfmt{glossaries} package or the \abbrstyle{short-nolong} style +(which only displays the short form on \gls{firstuse}) +with \gls{glossaries-extra}. + +Acronyms are defined using: \begin{definition}[\DescribeMacro{\newacronym}] \cs{newacronym}\oarg{key-val list}\marg{label}\marg{abbrv}\marg{long} \end{definition} -This uses \ics{newglossaryentry} to create an entry with the given +This creates an entry with the given label in the glossary given by \ics{acronymtype}. You can specify a different glossary using the \gloskey{type} key within the optional argument. The \cs{newacronym} command also uses the \gloskey{long}, @@ -10116,9 +8623,19 @@ argument. The \cs{newacronym} command also uses the \gloskey{long}, in \cs{newglossaryentry} to store the long and abbreviated forms and their plurals. +\begin{xtr} +If you use \cs{newacronym} with \gls{glossaries-extra}, you need to +first set the style with: +\begin{alltt} +\ics*{setabbreviationstyle}[acronym]\marg{style-name} +\end{alltt} +\end{xtr} + Note that the same restrictions on the entry \meta{label} in \ics{newglossaryentry} also apply to \cs{newacronym} (see \sectionref{sec:newglosentry}). +Since \ics{newacronym} works like \ics{newglossaryentry}, you can use +\ics{glsreset} to reset the \gls{firstuseflag}. \begin{important} If you haven't identified the specified glossary type as a list of @@ -10130,7 +8647,8 @@ the list and \emph{reset the display style} for that glossary via entries within the same glossary, care is needed if you want to change the display style: you must first identify that glossary as a list of acronyms and then use \ics{defglsentryfmt} (not redefine -\ics{glsentryfmt}) before defining your entries. +\ics{glsentryfmt}) before defining your entries. Alternatively, use +\gls{glossaries-extra} to have better support for a mixed glossary. \end{important} The optional argument \marg{key-val list} allows you to specify @@ -10151,23 +8669,24 @@ If the \firstuse\ uses the plural form, \verb|\glspl{dm}| will display: diagonal matrices (DMs). If you want to use the \gloskey{longplural} or \gloskey{shortplural} keys, I recommend you use \ics{setacronymstyle} to set the display style rather than -using one of the pre-version 4.02 acronym styles. - -As with \gloskey{plural} and \gloskey{firstplural}, if -\gloskey{longplural} is missing, it's obtained by appended -\ics{glspluralsuffix} to the singular form. The short plural -\gloskey{shortplural} is obtained (is not explicitly set) by appending -\ics{glsacrpluralsuffix} to the short form. These commands may be -changed by the associated language files, but they can't be added to -the usual caption hooks as there's no guarantee when they'll be -expanded (as \hyperref[pluralsuffix]{discussed earlier}). -A different approach is used by \styfmt{glossaries-extra}, which has -\icatattrs category attributes to determine whether or not to append a suffix -when forming the default value of \gloskey{shortplural}. - -Since \ics{newacronym} uses \ics{newglossaryentry}, you can use -commands like \ics{gls} and \ics{glsreset} as with any other -glossary entry. +using one of the pre-version 4.02 acronym styles (described in +\sectionref{sec:pkgopts-old-acronym}). + +As with \gloskey{plural}, if \gloskey{longplural} is missing, it's +obtained by appending \ics{glspluralsuffix} to the singular form. The +short plural \gloskey{shortplural} is obtained (if not explicitly +set) by appending \ics{glsacrpluralsuffix} to the short form. These +commands may be changed by the associated language files, but they +can't be added to the usual caption hooks as there's no guarantee +when they'll be expanded (as \hyperref[pluralsuffix]{discussed +earlier}). + +\begin{xtr} +A different approach is used by +\styfmt{glossaries-extra}, which has \icatattrs category attributes +to determine whether or not to append a suffix when forming the +default value of \gloskey{shortplural}. +\end{xtr} \begin{important} Since \cs{newacronym} sets \verb|type=\acronymtype|, @@ -10181,6 +8700,7 @@ type as \verb|type=\glsdefaulttype| in the optional argument to \begin{example}{Defining an Abbreviation}{ex:newacronym} The following defines the abbreviation IDN: \begin{verbatim} +\setacronymstyle{long-short} \newacronym{idn}{IDN}{identification number} \end{verbatim} \verb|\gls{idn}| will produce \qt{identification number (IDN)} on @@ -10189,6 +8709,7 @@ of the \gls{smallcaps} acronym styles, described in \sectionref{sec:setacronymstyle}, you need to use lower case characters for the shortened form: \begin{verbatim} +\setacronymstyle{long-sc-short} \newacronym{idn}{idn}{identification number} \end{verbatim} Now \verb|\gls{idn}| will produce \qt{identification number @@ -10237,18 +8758,37 @@ or \end{verbatim} Similarly for the \glstextlike\ commands. +\begin{xtr} Other approaches are available with \gls{glossaries-extra}. See the section \qt{Nested Links} in the \styfmt{glossaries-extra} user manual. +\end{xtr} -\begin{important} -The commands described below are similar to the \glstextlike\ -commands in that they don't modify the \firstuseflag. +\section{Displaying the Long, Short and Full Forms (Independent of +First Use)} +\label{sec:longshortfull} + +It may be that you want the long, short or full form +regardless of whether or not the acronym has already been used in +the document. You can do so with the commands described in this +section. + +The \cs{acr\ldots} commands described below are part of the set of +\glstextlike\ commands. That is, they index and can form +hyperlinks, but they don't modify the \firstuseflag. However, their display is governed by \ics{defentryfmt} with \ics{glscustomtext} set as appropriate. All caveats that apply to the \glstextlike\ commands also apply to the following commands. -(Including the warning immediately above this box.) -\end{important} +(Including the above warning about nested links.) + +\begin{xtr} +If you are using \gls{glossaries-extra}, don't use the commands +described in this section. The \gls{glossaries-extra} package +provides analogous \cs{glsxtr\ldots} or \cs{glsfmt\ldots} +commands. For example, \cs{glsxtrshort} instead of \cs{acrshort} +or, if needed in a heading, \cs{glsfmtshort}. (Similarly for the +case-changing variants.) +\end{xtr} The optional arguments are the same as those for the \glstextlike\ commands, and there are similar star and plus variants that switch @@ -10335,7 +8875,7 @@ where \cs{acrfullformat}\marg{long}\marg{short} \end{definition} by default does \meta{long} (\meta{short}). This command is now -deprecated for new acronym styles but is used by the default for +deprecated for new acronym styles but is used by default for backward compatibility if \cs{setacronymstyle} (\sectionref{sec:setacronymstyle}) hasn't been used. (For further details of these format commands see \ifpdf @@ -10451,11 +8991,20 @@ These again use \ics{acrfullformat} by default, but the new styles described in the section below use different formatting commands. -\section{Changing the Abbreviation Style} +\section{Changing the Acronym Style} \label{sec:setacronymstyle} -It may be that the default style doesn't suit your requirements in -which case you can switch to another style using +\begin{xtr} +If you are using \gls{glossaries-extra}, don't use the commands +described in this section. Use \ics*{setabbreviationstyle} to set +the style. This uses a different (but more consistent) naming +scheme. For example, \abbrstyle{long-noshort} instead of +\acrstyle{dua}. See the \qt{Acronym Style Modifications} section and +the \qt{Abbreviations} chapter in the \gls{glossaries-extra} manual +for further details. +\end{xtr} + +The acronym style is set using: \begin{definition}[\DescribeMacro{\setacronymstyle}] \cs{setacronymstyle}\marg{style name} \end{definition} @@ -10480,13 +9029,14 @@ For example: Unpredictable results can occur if you try to use multiple styles. \begin{important} -If you need multiple abbreviation styles, then try -using the \gls{glossaries-extra} package, which has better -abbreviation management. +If you need multiple abbreviation styles, then +use the \gls{glossaries-extra} package, which has better +abbreviation management. See, for example, +\gallery{index.php?label=sample-name-font}{Gallery: Mixing Styles}. \end{important} -Unlike the default behaviour of \cs{newacronym}, the -styles used via \cs{setacronymstyle} don't use the \gloskey{first} +Unlike the backward-compatible default behaviour of \cs{newacronym}, the +styles set via \cs{setacronymstyle} don't use the \gloskey{first} or \gloskey{text} keys, but instead they use \ics{defglsentryfmt} to set a~custom format that uses the \gloskey{long} and \gloskey{short} keys (or their plural equivalents). This means that these styles @@ -11260,8 +9810,8 @@ before the full stop. The next example shows one way of achieving this. (Note that the supplemental \gls{glossaries-extra} package provides a much -simpler way of doing this, which you may prefer to use. See the -\gallery{sample-initialisms.shtml}{initialisms example}.) +simpler way of doing this, which you may prefer to use. See +\gallery{sample-initialisms.shtml}{Gallery: Initialisms}.) \begin{example}{Abbreviations with Full Stops (Periods)}{ex:dotabbr} As from version 4.16, there's now a hook (\ics{glspostlinkhook}) @@ -11527,6 +10077,14 @@ where \meta{label} is the label of the required entry. If the entry has been used, \meta{true part} will be done, otherwise \meta{false part} will be done. +Note that \cs{ifglsused} is unreliable with \gls{bib2gls} as the +entry isn't defined on the first \LaTeX\ run, which means there's no +way of determining if it has been used, so +\gls{glossaries-extra} provides a similar command: +\begin{definition} +\ics*{GlsXtrIfUnusedOrUndefined}\marg{label}\marg{true part}\marg{false part} +\end{definition} + \begin{important} Be careful when using \glslike\ commands within an environment or command argument that gets processed multiple times @@ -11797,7 +10355,7 @@ otherwise. This means that if the previous count for the given entry was~1, the entry won't be hyperlinked with the \cs{cgls}-like commands and they won't add a~line to the external glossary file. If you haven't used -any of the other commands that add information to glossary file +any of the other commands that add information to the glossary file (such as \cs{glsadd} or the \glstextlike\ commands) then the entry won't appear in the glossary. @@ -11837,7 +10395,7 @@ These entries are only used once: \cgls{sql}, \cgls{rdbms}, \end{document} \end{verbatim} After a complete document build (\texttt{latex}, \texttt{latex}, -\texttt{makeglossaries}, \texttt{latex}) the list of abbrevaitions only +\texttt{makeglossaries}, \texttt{latex}) the list of abbreviations only includes the entries HTML, CSS and RDSMS. The entries SQL, RDBMS and XML only have their long forms displayed and don't have a~hyperlink. @@ -11854,6 +10412,1289 @@ With \gls{bib2gls} there's an analogous record counting set of commands. See \gls{glossaries-extra} and \gls{bib2gls} manuals for further details. \end{bib2gls} +\chapter{Displaying a Glossary} +\label{sec:printglossary} + +All defined glossaries may be displayed using: +\begin{description} +\item[\opt1:] +(Must be used with \ics{makenoidxglossaries} in the preamble.) +\begin{definition}[\DescribeMacro\printnoidxglossaries] +\cs{printnoidxglossaries} +\end{definition} +which internally uses \cs{printnoidxglossary} for each glossary. + +\item[\optsand23:] +(Must be used with \ics{makeglossaries} in the preamble.) +\begin{definition}[\DescribeMacro\printglossaries] +\cs{printglossaries} +\end{definition} +which internally uses \cs{printglossary} for each glossary. + +\item[\optsto46:] (\gls{glossaries-extra} only) +\begin{definition}[\DescribeMacro\printunsrtglossaries] +\cs{printunsrtglossaries} +\end{definition} +which internally uses \cs{printunsrtglossary} for each glossary. +\end{description} +These commands will display all the glossaries in the order in which +they were defined. + +Note that, in the case of \optsand23, no glossaries will appear +until you have either used the Perl script \gls{makeglossaries} or +Lua script \gls{makeglossaries-lite.lua} or have directly used +\gls{makeindex} or \gls{xindy} (as described in +\sectionref{sec:makeglossaries}). In the case of \opt4, no glossary +will appear until you have used \gls{bib2gls}. + +\begin{important} +While the external files are missing, \cs{printglossary} will just do +\ics{null} for each missing glossary to assist dictionary style +documents that just use \cs{glsaddall} without inserting any text. +This use of \ics{null} ensures that all indexing information is +written before the final page is shipped out. Once the external +files are present \cs{null} 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, \cs{null} +will no longer be used and so shouldn't cause interference for the +final document. +\end{important} + +\begin{xtr} +If you use \gls{glossaries-extra}, it will insert a heading and boilerplate text when the +external files are missing. See the +\gls{glossaries-extra} manual for further details. +\end{xtr} + +If the glossary still does not appear after you re-\LaTeX\ your +document, check the \gls*{makeindex}, \gls*{xindy} or \gls*{bib2gls} +log files, as applicable, to see if there is a problem. With \opt1, +you just need two \LaTeX\ runs to make the glossaries appear, but +you may need further runs to make the \glspl{numberlist} up-to-date. + +An individual glossary can be displayed using: +\begin{description} +\itempar{\opt1:} +\begin{definition}[\DescribeMacro{\printnoidxglossary}] +\cs{printnoidxglossary}\oarg{options} +\end{definition} +(Must be used with \ics{makenoidxglossaries} in the preamble.) + +\itempar{\optsand23:} +\begin{definition}[\DescribeMacro{\printglossary}] +\cs{printglossary}\oarg{options} +\end{definition} +(Must be used with \ics{makeglossaries} in the preamble.) + +\itempar{\optsto46:} +\begin{definition} +\ics*{printunsrtglossary}\oarg{options} +\end{definition} +(May be used with or without \gls{bib2gls}.) +\end{description} +where \meta{options} is a \meta{key}=\meta{value} list of options. +(Again, when the associated external file is missing, \cs{null} is +inserted into the document.) + +\begin{xtr} +The \gls{glossaries-extra} package also provides +\begin{definition} +\ics*{printunsrtinnerglossary}\oarg{options}\marg{pre +code}\marg{post code} +\end{definition} +which is designed for inner or nested glossaries. It allows many, but not all, +of the options listed below. There's an example available in the gallery: +\gallery{index.php?label=bib2gls-inner}{Inner or Nested Glossaries}. +See the \gls{glossaries-extra} package for further details. +\end{xtr} + +The following keys are available in \marg{options}: +\begin{description} +\item[{\gloskey[printglossary]{type}}] The value of this key +specifies which glossary to print. If omitted, the default +glossary is assumed. For example, to print the list of acronyms: +\begin{verbatim} +\printglossary[type=\acronymtype] +\end{verbatim} +Note that you can't display an ignored glossary, so don't try +setting \gloskey[printglossary]{type} to the name of a glossary that +was defined using \ics{newignoredglossary}, described in +\sectionref{sec:newglossary}. (You can display an ignored glossary +with \ics*{printunsrtglossary} provided by \gls{glossaries-extra}.) + +\item[{\gloskey[printglossary]{title}}] This is the glossary's +title (overriding the title specified when the glossary was +defined). + +\item[{\gloskey[printglossary]{toctitle}}] This is the title +to use for the table of contents (if the \pkgopt{toc} package +option has been used). It may also be used for the page header, +depending on the page style. If omitted, the value of +\gloskey[printglossary]{title} is used. + +\item[{\gloskey[printglossary]{style}}] This specifies which +glossary style to use for this glossary, overriding the effect +of the \pkgopt{style} package option or \ics{glossarystyle}. + +\item[{\gloskey[printglossary]{numberedsection}}] This specifies +whether to use a numbered section for this glossary, overriding +the effect of the \pkgopt{numberedsection} package option. This +key has the same syntax as the \pkgopt{numberedsection} package +option, described in \sectionref{sec:pkgopts-sec}. + +\item[{\gloskey[printglossary]{nonumberlist}}] This is a boolean +key. If true (\verb|nonumberlist=true|) the numberlist is suppressed +for this glossary. If false (\verb|nonumberlist=false|) the +numberlist is displayed for this glossary. + +\item[{\gloskey[printglossary]{nogroupskip}}] This is a boolean +key. If true the vertical gap between groups +is suppressed for this glossary. + +\item[{\gloskey[printglossary]{nopostdot}}] This is a boolean +key. If true the full stop after the description +is suppressed for this glossary. + +\item[{\gloskey[printglossary]{entrycounter}}] This is a boolean +key. Behaves similar to the package option of the same name. +The corresponding package option must be used to make \ics{glsrefentry} +work correctly. + +\item[{\gloskey[printglossary]{subentrycounter}}] This is a boolean +key. Behaves similar to the package option of the same name. If you +want to set both \gloskey{entrycounter} and +\gloskey{subentrycounter}, make sure you specify +\gloskey{entrycounter} first. The corresponding package option must +be used to make \ics{glsrefentry} work correctly. + +\item[{\gloskey[printnoidxglossary]{sort}}] This key is only +available for \opt1. Possible values are: \texttt{word} (word +order), \texttt{letter} (letter order), \texttt{standard} (word or +letter ordering taken from the \pkgopt{order} package option), +\texttt{use} (order of use), \texttt{def} (order of definition) +\texttt{nocase} (case-insensitive) or \texttt{case} (case-sensitive). +Note that the word and letter comparisons (that is, everything other +than \texttt{sort=use} and \texttt{sort=def}) just use a simple +character code comparison. For a locale-sensitive sort, you must use +either \gls{xindy} (\opt3) or \gls{bib2gls} (\opt4). Note that \gls{bib2gls} +provides many other sort options. + +\begin{important} +If you use the \texttt{use} or \texttt{def} values make sure +that you select a glossary style that doesn't have a visual +indicator between groups, as the grouping no longer makes sense. +Consider using the \pkgopt{nogroupskip} option. +\end{important} + +{\raggedright +The word and letter order sort methods use +\sty{datatool}'s +\ics{dtlwordindexcompare} and \ics{dtlletterindexcompare} handlers. +The case-insensitive sort method uses \sty{datatool}'s +\ics{dtlicompare} handler. The case-sensitive sort method uses +\sty{datatool}'s \ics{dtlcompare} handler. See the \sty{datatool} +documentation for further details. +\par} + +If you don't get an error with \texttt{sort=use} and +\texttt{sort=def} but you do get an error with one of the other sort +options, then you probably need to use the +\pkgopt[true]{sanitizesort} package option or make sure none of the +entries have fragile commands in their \gloskey{sort} field. + +\item[{\xtrprintglosskey[\marg{label}]{label}}] +This key is only available with \gls{glossaries-extra} and labels +the glossary with \cs{label}\marg{label}. This is an alternative to +the package option \pkgopt[autolabel]{numberedsection} + +\item[{\xtrprintglosskey[\marg{boolean}]{target}}] This boolean key is only +available with \gls{glossaries-extra} and can be used to switch +off the automatic hypertarget for each entry. (This refers to the +target used by commands like \cs{gls} and \cs{glslink}.) + +This option is useful with \ics*{printunsrtglossary} as it allows +the same list (or sub-list) of entries to be displayed multiple +times without causing duplicate hypertarget names. + +\item[{\xtrprintglosskey[\marg{prefix}]{prefix}}] +This key is only available with \gls{glossaries-extra} and provides +another way of avoiding duplicate hypertarget names. In this case it uses a +different prefix for those names. This locally redefines +\ics{glolinkprefix} but note this will also affect the target for any entry +referenced within the glossary with commands like \cs{gls}, +\cs{glslink} or \cs{glshypertarget}. + +\item[{\xtrprintglosskey[\marg{prefix}]{targetnameprefix}}] +This key is only available with \gls{glossaries-extra}. +This is similar to the \pkgoptfmt{prefix} option, but it alters the prefix of +the hypertarget anchors without changing \ics{glslinkprefix} (so it +won't change the hyperlinks for any entries referenced in the +glossary). + +\item[{\xtrprintglosskey[\marg{boolean}]{groups}}] +This boolean key is only available with \gls{glossaries-extra} and, +if true, will attempt to perform group formation. See the +\gls{glossaries-extra} manual for further details. + +\item[{\xtrprintglosskey[\marg{n}]{leveloffset}}] +This key is only available with \ics*{printunsrtglossary}. +It can be used to locally adjust the +hierarchical level used by the glossary style. See the +\gls{glossaries-extra} manual for further details. +\end{description} + +By default, the glossary is started either by \ics{chapter*} or by +\ics{section*}, depending on whether or not \ics{chapter} is defined. +This can be overridden by the \pkgopt{section} package option or the +\ics{setglossarysection} command. Numbered sectional units can be +obtained using the \pkgopt{numberedsection} package option. Each +glossary sets the page header via the command +\begin{definition}[\DescribeMacro\glsglossarymark] +\ics{glsglossarymark}\marg{title} +\end{definition} +If this mechanism is unsuitable for your chosen class file or page +style package, you will need to redefine \ics{glsglossarymark}. Further +information about these options and commands is given in +\sectionref{sec:pkgopts-sec}. + +Information can be added to the start of the glossary (after the +title and before the main body of the glossary) by redefining +\begin{definition}[\DescribeMacro{\glossarypreamble}] +\cs{glossarypreamble} +\end{definition} +For example: +\begin{verbatim} +\renewcommand{\glossarypreamble}{Numbers in italic +indicate primary definitions.} +\end{verbatim} +This needs to be done before the glossary is displayed. + +If you want a different preamble per glossary you can use +\begin{definition}[\DescribeMacro{\setglossarypreamble}] +\cs{setglossarypreamble}\oarg{type}\marg{preamble text} +\end{definition} +If \meta{type} is omitted, \cs{glsdefaulttype} is used. + +For example: +\begin{verbatim} +\setglossarypreamble{Numbers in italic +indicate primary definitions.} +\end{verbatim} +This will print the given preamble text for the main glossary, +but not have any preamble text for any other glossaries. + +There is an analogous command to \cs{glossarypreamble} called +\begin{definition}[\DescribeMacro{\glossarypostamble}] +\cs{glossarypostamble} +\end{definition} +which is placed at the end of each glossary. + +\begin{example}{Switch to Two Column Mode for Glossary}{ex:twocolumn} +Suppose you are using the \glostyle{superheaderborder} +style\footnote{you can't use the \glostyle{longheaderborder} style +for this example as you can't use the \env{longtable} environment in +two column mode.}, and you want the glossary to be in two columns, +but after the glossary you want to switch back to one column mode, +you could do: +\begin{verbatim} +\renewcommand*{\glossarysection}[2][]{% + \twocolumn[{\chapter*{#2}}]% + \setlength\glsdescwidth{0.6\linewidth}% + \glsglossarymark{\glossarytoctitle}% +} + +\renewcommand*{\glossarypostamble}{\onecolumn} +\end{verbatim} + +\end{example} + +Within each glossary, each entry name is formatted according to +\begin{definition}[\DescribeMacro{\glsnamefont}] +\cs{glsnamefont}\marg{name} +\end{definition} +which takes one argument: the entry name. This command is always +used regardless of the glossary style. By default, \cs{glsnamefont} +simply displays its argument in whatever the surrounding font +happens to be. This means that in the list-like glossary styles +(defined in the \sty{glossary-list} style file) the name will appear +in bold, since the name is placed in the optional argument of +\cs{item}, whereas in the tabular styles (defined in the +\sty{glossary-long} and \sty{glossary-super} style files) the name +will appear in the normal font. The hierarchical glossary styles +(defined in the \sty{glossary-tree} style file) also set the name in +bold. + +If you want to change the font for the description, or if you +only want to change the name font for some types of entries +but not others, you might want to consider using the +\gls{glossaries-extra} package. + +\begin{example}{Changing the Font Used to Display Entry Names in the +Glossary}{ex:glsnamefont} +Suppose you want all the entry names to appear in +medium weight small caps in your glossaries, then you can do: +\begin{verbatim} +\renewcommand{\glsnamefont}[1]{\textsc{\mdseries #1}} +\end{verbatim} +\end{example} + +\begin{xtr} +The \gls{glossaries-extra} package provides additional hooks that +can be used to make other minor adjustments. +\end{xtr} + +The letter group titles (which are displayed for styles like +\glostyle{indexgroup}) can be changed either by redefining the +corresponding \cs{\meta{group-label}groupname} commands, such as +\ics{glssymbolsgroupname}, (see \sectionref{sec:fixednames}) or by +using the \gls{glossaries-extra} commands \ics*{glsxtrsetgrouptitle} +and \ics*{glsxtrlocalsetgrouptitle}. The \meta{group-label} is +typically obtained by the \gls{indexingapp}. + +\chapter{Defining New Glossaries} +\label{sec:newglossary} + +A new glossary can be defined using: +\begin{definition}[\DescribeMacro{\newglossary}] +\cs{newglossary}\oarg{log-ext}\marg{name}\marg{in-ext}\marg{out-ext}\linebreak\marg{title}\oarg{counter} +\end{definition} +where \meta{name} is the label to assign to this glossary. +The arguments \meta{in-ext} and \meta{out-ext} specify the extensions to +give to the input and output files for that glossary, \meta{title} +is the default title for this new glossary and the final optional +argument \meta{counter} specifies which counter to use for the +associated \glspl{numberlist} (see also +\sectionref{sec:numberlists}). The first optional argument specifies +the extension for the \gls{makeindex} (\opt2) or \gls{xindy} (\opt3) +transcript file (this information is only used by +\gls{makeglossaries} which picks up the information from the +auxiliary file). If you use \opt1, the \meta{log-ext}, +\meta{in-ext} and \meta{out-ext} arguments are ignored. + +\begin{important} +The glossary label \meta{name} must not contain any active +characters. It's generally best to stick with just characters that +have category code~11 (typically the non-extended \glspl{latinchar} +for standard \LaTeX). +\end{important} + +There is also a starred version (new to v4.08): +\begin{definition}[\DescribeMacro{\newglossary*}] +\cs{newglossary*}\marg{name}\marg{title}\oarg{counter} +\end{definition} +which is equivalent to +\begin{alltt} +\cs{newglossary}[\meta{name}-glg]\marg{name}\{\meta{name}-gls\}\{\meta{name}-glo\}\ifpdf\linebreak\fi\marg{title}\oarg{counter} +\end{alltt} +or you can also use: +\begin{definition}[\DescribeMacro{\altnewglossary}] +\cs{altnewglossary}\marg{name}\marg{tag}\marg{title}\oarg{counter} +\end{definition} +which is equivalent to +\begin{alltt} +\cs{newglossary}[\meta{tag}-glg]\marg{name}\{\meta{tag}-gls\}\{\meta{tag}-glo\}\marg{title}\oarg{counter} +\end{alltt} + +It may be that you have some terms that are so common +that they don't need to be listed. In this case, you can define +a~special type of glossary that doesn't create any associated files. +This is referred to as an \qt{ignored glossary} and it's ignored by +commands that iterate over all the glossaries, such as +\ics{printglossaries}. To define an ignored glossary, use +\begin{definition}[\DescribeMacro\newignoredglossary] +\cs{newignoredglossary}\marg{name} +\end{definition} +where \meta{name} is the name of the glossary (as above). This +glossary type will automatically be added to the +\pkgopt{nohypertypes} list, since there are no hypertargets for +the entries in an ignored glossary. +(The sample file \samplefile{-entryfmt} defines an ignored glossary.) + +\begin{xtr} +The \gls{glossaries-extra} package provides a starred version of +this command that allows hyperlinks (since ignored glossaries can be +useful with \gls{bib2gls}). There is also an analogous +\ics*{provideignoredglossary} command. +\end{xtr} + +You can test if a glossary is an ignored one using: +\begin{definition}[\DescribeMacro\ifignoredglossary] +\cs{ifignoredglossary}\marg{name}\marg{true}\marg{false} +\end{definition} +This does \meta{true} if \meta{name} was defined as an ignored +glossary, otherwise it does \meta{false}. + +Note that the main (default) glossary is automatically created as: +\begin{verbatim} +\newglossary{main}{gls}{glo}{\glossaryname} +\end{verbatim} +so it can be identified by the label \texttt{main} (unless the +\pkgopt{nomain} package option is used). Using the +\pkgopt{acronym} package option is equivalent to: +\begin{verbatim} +\newglossary[alg]{acronym}{acr}{acn}{\acronymname} +\end{verbatim} +so it can be identified by the label \texttt{acronym}. If you are +not sure whether the \pkgopt{acronym} option has been used, you +can identify the list of acronyms by the command +\DescribeMacro{\acronymtype}\cs{acronymtype} which is set to +\texttt{acronym}, if the \pkgopt{acronym} option has been used, +otherwise it is set to \texttt{main}. Note that if you are using +the main glossary as your list of acronyms, you need to declare +it as a list of acronyms using the package option +\pkgopt{acronymlists}. + +The \pkgopt{symbols} package option creates a new glossary with the +label \texttt{symbols} using: +\begin{verbatim} +\newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname} +\end{verbatim} +The \pkgopt{numbers} package option creates a new glossary with +the label \texttt{numbers} using: +\begin{verbatim} +\newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname} +\end{verbatim} +The \pkgopt{index} package option creates a new glossary with +the label \texttt{index} using: +\begin{verbatim} +\newglossary[ilg]{index}{ind}{idx}{\indexname} +\end{verbatim} + +\begin{important} +\optsand23: all glossaries must be defined before \ics{makeglossaries} to +ensure that the relevant output files are opened. + +See \sectionref{sec:fixednames} if you want to redefine \cs{glossaryname}, +especially if you are using \sty{babel} or \sty{translator}. +(Similarly for \cs{glssymbolsgroupname} and +\cs{glsnumbersgroupname}.) If you want to redefine \ics{indexname}, +just follow the advice in +\href{https://texfaq.org/FAQ-fixnam}{How to +change LaTeX’s \qt{fixed names}}. +\end{important} + +\chapter{Adding an Entry to the Glossary Without Generating Text} +\label{sec:glsadd} + +It is possible to add a line to the glossary file without +generating any text at that point in the document using: +\begin{definition}[\DescribeMacro{\glsadd}] +\cs{glsadd}\oarg{options}\marg{label} +\end{definition} +This is similar to the \glstextlike\ commands, only it doesn't produce +any text (so therefore, there is no \gloskey[glslink]{hyper} key +available in \meta{options} but all the other options that can +be used with \glstextlike\ commands can be passed to \cs{glsadd}). + +This command essentially works like \cs{index} (provided by the +\LaTeX\ kernel) in that it doesn't produce text but it does add a +line with an associated location to the glossary file. In this case, +the \qt{encap} (the page encapsulator information) is specified with +the \gloskey{format} key. (See \sectionref{sec:encap}.) + +For example, to add a page range to the glossary number list for the +entry whose label is given by \texttt{set}: +\begin{verbatim} +\glsadd[format=(]{set} +Lots of text about sets spanning many pages. +\glsadd[format=)]{set} +\end{verbatim} + +To add all entries that have been defined, use: +\begin{definition}[\DescribeMacro{\glsaddall}] +\cs{glsaddall}\oarg{options} +\end{definition} +The optional argument is the same as for \cs{glsadd}, except +there is also a key \gloskey[glsaddall]{types} which can be +used to specify which glossaries to use. This should be a +comma-separated list. For example, if you only want to add +all the entries belonging to the list of acronyms (specified by +the glossary type \ics{acronymtype}) and a list of +notation (specified by the glossary type \texttt{notation}) then you can +do: +\begin{verbatim} +\glsaddall[types={\acronymtype,notation}] +\end{verbatim} + +\begin{bib2gls} +If you are using \gls{bib2gls} with \gls{glossaries-extra}, you +can't use \cs{glsaddall}. Instead use the \optfmt{selection=all} +resource option to select all entries in the given \filetype{bib} files. +\end{bib2gls} + +\begin{important} +Note that \cs{glsadd} and \cs{glsaddall} add the current location to +the \gls{numberlist}. In the case of \cs{glsaddall}, all entries in the +glossary will have the same location in the number list. If you want +to use \cs{glsaddall}, it's best to suppress the number list with +the \pkgopt{nonumberlist} package option. (See +sections~\ref{sec:pkgopts-printglos} and~\ref{sec:numberlists}.) +\end{important} + +There is now a variation of \cs{glsaddall} that skips any entries +that have been \glsdisp{firstuseflag}{marked as used}: +\begin{definition}[\DescribeMacro\glsaddallunused] +\cs{glsaddallunused}\oarg{list} +\end{definition} +This command uses \cs{glsadd}\texttt{[format=glsignore]} which will +ignore this location in the number list. (See \sectionref{sec:encap}.) +The optional argument \meta{list} is a comma-separated list of +glossary types. If omitted, it defaults to the list of all defined +glossaries. + +\begin{important} +If you want to use \cs{glsaddallunused}, it's best to place the +command at the end of the document to ensure that all the commands +you intend to use have already been used. Otherwise you could end up +with a spurious comma or dash in the location list. +\end{important} + +\begin{bib2gls} +With \gls{glossaries-extra} and \gls{bib2gls}, \texttt{glsignore} +indicates an \qt{ignored location} which influences selection but +isn't added to the location list. In this case, if you use +\optfmt{selection=all} then only those entries that have been +explicitly indexed in the document will have location lists. The +other entries that were selected as a result of +\optfmt{selection=all} won't have location lists. +\end{bib2gls} + +Base \sty{glossaries} package only: +\begin{verbatim} +\documentclass{article} +\usepackage{glossaries} +\makeglossaries +\newglossaryentry{cat}{name={cat},description={feline}} +\newglossaryentry{dog}{name={dog},description={canine}} +\begin{document} +\gls{cat}. +\printglossaries +\glsaddallunused % <- make sure dog is also listed +\end{document} +\end{verbatim} +Corresponding \gls{glossaries-extra} and \gls{bib2gls} document code: +\begin{verbatim} +\documentclass{article} +\usepackage[record]{glossaries-extra} +\GlsXtrLoadResources[src={entries},selection=all] +\begin{document} +\gls{cat}. +\printunsrtglossaries +\end{document} +\end{verbatim} +With the file \texttt{entries.bib}: +\begin{verbatim} +@entry{cat,name={cat},description={feline}} +@entry{dog,name={dog},description={canine}} +\end{verbatim} + +\begin{example}{Dual Entries}{ex:dual} +The example file \samplefile{-dual} makes use of \cs{glsadd} to +allow for an entry that should appear both in the main glossary and +in the list of acronyms. This example sets up the list of acronyms +using the \pkgopt{acronym} package option: +\begin{verbatim} +\usepackage[acronym]{glossaries} +\end{verbatim} +A new command is then defined to make it easier to define dual +entries: +\begin{verbatim} +\newcommand*{\newdualentry}[5][]{% + \newglossaryentry{main-#2}{name={#4},% + text={#3\glsadd{#2}},% + description={#5},% + #1 + }% + \newacronym{#2}{#3\glsadd{main-#2}}{#4}% +} +\end{verbatim} +This has the following syntax: +\begin{alltt} +\ics{newdualentry}\oarg{options}\marg{label}\marg{abbrv}\marg{long}\marg{description} +\end{alltt} +You can then define a new dual entry: +\begin{verbatim} +\newdualentry{svm}% label + {SVM}% abbreviation + {support vector machine}% long form + {Statistical pattern recognition technique}% description +\end{verbatim} +Now you can reference the acronym with \verb|\gls{svm}| or you can +reference the entry in the main glossary with \verb|\gls{main-svm}|. + +This is just an example. +In general, think twice before you add this kind of duplication. +If all information (short, long and description) can be provided in +a single list, it's redundant to provide a second list unless any +of the short forms start with a different letter to the associated +long form, which may make it harder to lookup. + +\begin{bib2gls} +Note that with \gls{bib2gls}, there are special dual entry types +that implement this behaviour. That is, if an entry is referenced +then its corresponding dual entry will automatically be selected as +well. So there is less need for \cs{glsadd} with \gls{bib2gls}. +(Although it can still be useful, as shown in \opt6.) +\end{bib2gls} +\end{example} + +\chapter{Cross-Referencing Entries} +\label{sec:crossref} + +\begin{important} +You must use \ics{makeglossaries} (\optsor23) or +\ics{makenoidxglossaries} (\opt1) \emph{before} defining any +terms that cross-reference entries. If any of the terms that you have +cross-referenced don't appear in the glossary, check that you have +put \cs{makeglossaries}\slash\cs{makenoidxglossaries} before all +entry definitions. The \gls{glossaries-extra} package provides +better cross-reference handling. +\end{important} + +There are several ways of cross-referencing entries in the +glossary: + +\begin{enumerate} +\item You can use commands such as \ics{gls} in the +entries description. For example: +\begin{verbatim} +\newglossaryentry{apple}{name=apple, +description={firm, round fruit. See also \gls{pear}}} +\end{verbatim} +Note that with this method, if you don't use the cross-referenced term +in the main part of the document, you will need two runs of +\gls{makeglossaries}: +\begin{prompt} +pdflatex filename +makeglossaries filename +pdflatex filename +makeglossaries filename +pdflatex filename +\end{prompt} +This is because the \cs{gls} in the description won't be detected +until the glossary has been created (unless the description is used +elsewhere in the document with \ics{glsentrydesc}). Take care not to +use \ics{glsdesc} (or \ics{Glsdesc}) in this case as it will cause a +nested link. + +\item As described in \sectionref{sec:newglosentry}, you can use the +\gloskey{see} key when you define the entry. For example: +\begin{verbatim} +\newglossaryentry{MaclaurinSeries}{name={Maclaurin +series}, +description={Series expansion}, +see={TaylorsTheorem}} +\end{verbatim} +Note that in this case, the entry with the \gloskey{see} key will +automatically be added to the glossary, but the cross-referenced +entry won't. You therefore need to ensure that you use the +cross-referenced term with the commands described in +\sectionref{sec:glslink} or \sectionref{sec:glsadd}. + +The \qt{see} tag is produce using \ics{seename}, but can be +overridden in specific instances using square brackets +at the start of the \gloskey{see} value. For example: +\begin{verbatim} +\newglossaryentry{MaclaurinSeries}{name={Maclaurin +series}, +description={Series expansion}, +see=[see also]{TaylorsTheorem}} +\end{verbatim} +Take care if you want to use the optional argument of commands such +as \ics{newacronym} or \ics{newterm} as the value will need to be +grouped. For example: +\begin{verbatim} +\newterm{seal} +\newterm[see={[see also]seal}]{sea lion} +\end{verbatim} +Similarly if the value contains a list. For example: +\begin{verbatim} +\glossaryentry{lemon}{ + name={lemon}, + description={Yellow citrus fruit} +} +\glossaryentry{lime} +{ + name={lime}, + description={Green citrus fruit} +} +\glossaryentry{citrus} +{ + name={citrus}, + description={Plant in the Rutaceae family}, + see={lemon,lime} +} +\end{verbatim} + +\item After you have defined the entry, use +\begin{definition}[\DescribeMacro{\glssee}] +\cs{glssee}\oarg{tag}\marg{label}\marg{xr label list} +\end{definition} +where \meta{xr label list} is a comma-separated list of entry +labels to be cross-referenced, \meta{label} is the label of the +entry doing the cross-referencing and \meta{tag} is the \qt{see} tag. +(The default value of \meta{tag} is \ics{seename}.) +For example: +\begin{verbatim} +\glssee[see also]{series}{FourierSeries,TaylorsTheorem} +\end{verbatim} +Note that this automatically adds the entry given by \meta{label} to +the glossary but doesn't add the cross-referenced entries (specified +by \meta{xr label list}) to the glossary. +\end{enumerate} + +In both cases~2 and 3 above, the cross-referenced information +appears in the \gls{numberlist}, whereas in case~1, the +cross-referenced information appears in the description. (See the +\samplefile{-crossref} example file that comes with this package.) +This means that in cases~2 and~3, the cross-referencing information +won't appear if you have suppressed the \gls*{numberlist}. In this +case, you will need to activate the \gls*{numberlist} for the given +entries using \gloskey{nonumberlist=false}. Alternatively, if you +just use the \gloskey{see} key instead of \ics{glssee}, you can +automatically activate the \gls*{numberlist} using the +\pkgopt{seeautonumberlist} package option. + +\begin{bib2gls} +\gls{bib2gls} provides much better support for cross-references. +See, for example, +\gallery{index.php?label=bib2gls-xr}{Gallery: Cross-References (bib2gls)}. +\end{bib2gls} + +\section{Customising Cross-reference Text} +\label{sec:customxr} + +When you use either the \gloskey{see} key or the command +\cs{glssee}, the cross-referencing information will be typeset in the +glossary according to: +\begin{definition}[\DescribeMacro{\glsseeformat}] +\cs{glsseeformat}\oarg{tag}\marg{label-list}\marg{location} +\end{definition} +The default definition of \cs{glsseeformat} is: +\begin{display} +\cs{emph}\marg{tag} \cs{glsseelist}\marg{label-list} +\end{display} +Note that the location is always ignored.\footnote{\gls{makeindex} +will always assign a location number, even if it's not needed, so it +needs to be discarded.} For example, if you want the tag to appear +in bold, you can do:\footnote{If you redefine \cs{glsseeformat}, +keep the default value of the optional argument as \ics{seename} as +both \gloskey{see} and \cs{glssee} explicitly write +\texttt[\cs{seename}\texttt] in the output file if no optional +argument is given.} +\begin{verbatim} +\renewcommand*{\glsseeformat}[3][\seename]{\textbf{#1} + \glsseelist{#2}} +\end{verbatim} + + +The list of labels is dealt with by \cs{glsseelist}, which iterates +through the list and typesets each entry in the label. The entries +are separated by +\begin{definition}[\DescribeMacro{\glsseesep}] +\cs{glsseesep} +\end{definition} +or (for the last pair) +\begin{definition}[\DescribeMacro{\glsseelastsep}] +\cs{glsseelastsep} +\end{definition} +These default to ``",\space"'' and +\qt{\cs{space}\ics{andname}\cs{space}} respectively. The list entry text +is displayed using: +\begin{definition}[\DescribeMacro{\glsseeitemformat}] +\cs{glsseeitemformat}\marg{label} +\end{definition} +This defaults to \ics{glsentrytext}\marg{label}.\footnote{In +versions before 3.0, \cs{glsentryname} was used, but this could cause +problems when the \gloskey{name} key was \glsd{sanitize}.} For example, to +make the cross-referenced list use small caps: +\begin{verbatim} +\renewcommand{\glsseeitemformat}[1]{% + \textsc{\glsentrytext{#1}}} +\end{verbatim} +\begin{xtr} +The \gls{glossaries-extra} package redefines \cs{glsseeitemformat} +and additionally provides \ics*{glsxtrhiername} which can be used +as an alternative to \cs{glsentrytext}. See the +\gls{glossaries-extra} manual for further details. +\end{xtr} + +\begin{important} +You can use \ics{glsseeformat} and \ics{glsseelist} in the main body +of the text, but they won't automatically add the cross-referenced +entries to the glossary. If you want them added with that location, +you can do: +\begin{verbatim} +Some information (see also +\glsseelist{FourierSeries,TaylorsTheorem}% +\glsadd{FourierSeries}\glsadd{TaylorsTheorem}). +\end{verbatim} +\end{important} + +\chapter{Number Lists} +\label{sec:numberlists} + +Each entry in the glossary has an associated \gls{numberlist}. +By default, these numbers refer to the pages on which that entry has +been indexed (using any of the commands described in +\sectionref{sec:glslink} and \sectionref{sec:glsadd}). The number +list can be suppressed using the \pkgopt{nonumberlist} package +option, or an alternative counter can be set as the default using +the \pkgopt{counter} package option. The number list is also +referred to as the location list\index{location list|see{number list}}. + +\Glspl{numberlist} are more common with indexes rather than +glossaries (although you can use the \styfmt{glossaries} package for +indexes as well). However, the \styfmt{glossaries} package makes use +of \gls{makeindex} or \gls{xindy} to hierarchically sort and collate the +entries since they are readily available with most modern \TeX\ +distributions. Since these are both designed as \glspl{indexingapp} +they both require that terms either have a valid location or a +cross-reference. Even if you use \pkgopt{nonumberlist}, the +locations must still be provided and acceptable to the +\gls{indexingapp} or they will cause an error during the indexing +stage, which will interrupt the document build. However, if you're +not interested in the locations, each entry only needs to be indexed +once, so consider using \pkgopt{indexonlyfirst}, which can improve the +document build time by only indexing the \gls{firstuse} of each term. + +The \ics{glsaddall} command (see \sectionref{sec:glsadd}), which is used to +automatically index all entries, iterates over all defined entries +and does \cs{glsadd}\marg{label} for each entry (where \meta{label} +is that entry's label). This means that \cs{glsaddall} automatically +adds the same location to every entry's \gls{numberlist}, which +looks weird if the \gls*{numberlist} hasn't been suppressed. + +With \opt4, the indexing is performed by \gls{bib2gls}, which was +specifically designed for the \gls{glossaries-extra} package. So it +will allow any location format, and its \texttt{selection=all} +option will select all entries without adding an unwanted location to the +\gls{numberlist}. If \gls{bib2gls} can deduce a numerical value for +a location, it will attempt to form a range over consecutive +locations, otherwise it won't try to form a range and the +location will just form an individual item in the list. +\opt1 also allows any location but it doesn't form ranges. + +\section{Encap Values (Location Formats)} +\label{sec:encap} + +Each location in the \gls{numberlist} is encapsulated with a +command formed from the \termdef{encap} value. By +default this is the \ics{glsnumberformat} command, which corresponds +to the encap \texttt{glsnumberformat}, but this may be +overridden using the \gloskey[glslink]{format} key in the optional +argument to commands like \cs{gls}. (See \sectionref{sec:glslink}.) +For example, you may want the location to appear in bold to indicate +the principle use of a term or symbol. If the encap starts with an +open parenthesis~\verb|(| this signifies the start of a range and if +the encap starts with close parenthesis~\verb|)| this signifies the +end of a range. These must always occur in matching pairs. + +The \styfmt{glossaries} package provides the command: +\begin{definition}[\glsignore] +\cs{glsignore}\marg{text} +\end{definition} +which ignores its argument. This is the format used by +\cs{glsaddallunused} to suppress the location, which works fine as +long as no other locations are added to the \gls{numberlist}. For +example, if you use \verb|\gls{sample}| on page~2 then reset the +\gls{firstuseflag} and then use \cs{glsaddallunused} on page~10, the +\gls{numberlist} for \texttt{sample} will be \verb|2, \glsignore{10}| +which will result in \qt{2,~} which has a spurious comma. + +This isn't a problem with \gls{bib2gls} because you would need to use +\texttt{selection=all} instead of \cs{glsaddallunused}, but even if +you explicitly had used \texttt{glsignore}, for example, +\cs{gls}\texttt{[format=glsignore]}\marg{label}, then \gls{bib2gls} +will recognise \texttt{glsignore} as +a special encap indicating an ignored location, so it will select +the entry but not add that location to the \gls{numberlist}. It's a +problem for all the other indexing options. + +Complications can arise if you use different encap values for the +same location. For example, suppose on page~10 you have both the +default \texttt{glsnumberformat} and \texttt{textbf} encaps. While it may +seem apparent that \texttt{textbf} should override \texttt{glsnumberformat} +in this situation, the \gls{indexingapp} may not know it. +This is therefore something you need to be careful about if you use the +\gloskey[glslink]{format} key or if you use a command that +implicitly sets it. + +In the case of \gls{xindy}, it only accepts one encap (according to +the order of precedence given in the \gls{xindy} module) and discards the +others for identical locations (for the same entry). This can cause +a problem if a discarded location forms the start or end of a range. + +In the case of \gls{makeindex}, it accepts different encaps for the +same location, but warns about it. This leads to a \gls{numberlist} +with the same location repeated in different formats. If you use +the \gls{makeglossaries} Perl script with \opt2 it will detect +\gls{makeindex}'s warning and attempt to fix the problem, ensuring +that the \texttt{glsnumberformat} encap always has the least precedence +unless it includes a range identifier. Other conflicting encaps will +have the last one override earlier ones for the same location with +range identifiers taking priority. + +No discard occurs with \opt1 so again you get the same location +repeated in different formats. With \opt4, \gls{bib2gls} will discard +according to order of precedence, giving priority to start and end +range encaps. (See the \gls{bib2gls} manual for further details.) + +\section{Locations} +\label{sec:locationsyntax} + +Neither \opt1 nor \opt4 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 +\filetype{aux} file. The write operation is deferred to avoid the +problems associated with \TeX's asynchronous output routine. +(See, for example, +\href{https://texfaq.org/FAQ-oddpage}{Finding +if you're on an odd or an even page} for more details on this issue.) +Unfortunately \optsand23 are far more problematic and need some +complex code to deal with awkward locations. + +If you know that your locations will always expand to a format +acceptable to your chosen \gls{indexingapp} then use the package +option \pkgopt[false]{esclocations} to bypass this operation. This setting +only affects \optsand23 as the problem doesn't arise with the other +indexing options. + +Both \gls{makeindex} and \gls{xindy} are fussy about the syntax of +the locations. In the case of \gls{makeindex}, only the numbering +system obtained with \cs{arabic}, \cs{roman}, \cs{Roman}, \cs{alph} +and \cs{Alph} or composites formed from them with the same separator +(set with \cs{glsSetCompositor}\marg{char}) are accepted. +(\gls{makeindex} won't accept an empty location.) In the case of +\gls{xindy}, you can define your own location classes, but if the +location contains a robust command then the leading backslash must +be escaped. The \sty{glossaries} package tries to do this, but it's +caught between two conflicting requirements: +\begin{enumerate} +\item The location must be fully expanded before \verb|\| can be +converted to \verb|\\| (there's no point converting \verb|\thepage| +to \verb|\\thepage|); +\item The page number can't be expanded until the deferred write +operation (so \verb|\c@page| mustn't expand in the previous step +but \verb|\the\c@page| mustn't be converted to \verb|\\the\\c@page| +and \verb|\number\c@page| mustn't be converted to +\verb|\\number\\c@page| etc). +\end{enumerate} +There's a certain amount of trickery needed to deal with this +conflict and the code requires the location to be in a form that +doesn't embed the counter's internal register in commands like +\cs{value}. For example, suppose you have a robust command called +\cs{tallynum} that takes a number as the argument and an expandable +command called \cs{tally} that converts a counter name into the +associated register or number to pass to \cs{tallynum}. Let's +suppose that this command is used to represent the page number: +\begin{verbatim} +\renewcommand{\thepage}{\tally{page}} +\end{verbatim} +Now let's suppose that a term is indexed at the beginning of page~2 +at the end of a paragraph that started on page~1. With \gls{xindy}, +the location \verb|\tally{page}| needs to be written to the file +as \verb|\\tallynum{2}|. If it's written as \verb|\tallynum{2}| then +\gls{xindy} will interpret \verb|\t| as the character \qt{t} +(which means the location would appear as \qt{tallynum2}). So +\sty{glossaries} tries to expand \cs{thepage} without expanding +\cs{c@page} and then escapes all the backslashes, except for the +page counter's internal command. The following definitions of +\cs{tally} will work: +\begin{itemize} +\item In the following, \cs{arabic} works as its internal command \cs{c@arabic} is +temporarily redefined to check for \cs{c@page}: +\begin{verbatim} +\newcommand{\tally}[1]{\tallynum{\arabic{#1}}} +\end{verbatim} + +\item The form \verb|\expandafter\the\csname c@|\meta{counter}\verb|\endcsname| +also works (provided \cs{the} is allowed to be temporarily redefined, +see below): +\begin{verbatim} +\newcommand{\tally}[1]{% + \tallynum{\expandafter\the\csname c@#1\endcsname}} +\end{verbatim} + +\item \verb|\expandafter\the\value|\marg{counter} now also works +(with the same condition as above): +\begin{verbatim} +\newcommand{\tally}[1]{\tallynum{\expandafter\the\value{#1}}} +\end{verbatim} + +\item Another variation that will work: +\begin{verbatim} +\newcommand{\tally}[1]{% + \expandafter\tallynum\expandafter{\the\csname c@#1\endcsname}} +\end{verbatim} + +\item and also: +\begin{verbatim} +\newcommand{\tally}[1]{\tallynum{\the\csname c@#1\endcsname}} +\end{verbatim} +\end{itemize} +The following \emph{don't work}: +\begin{itemize} +\item This definition leads to the premature expansion of \cs{c@page} +to \qt{1} when, in this case, it should be \qt{2}: +\begin{verbatim} +\newcommand{\tally}[1]{\tallynum{\the\value{#1}}} +\end{verbatim} +\item This definition leads to \verb|\\c@page| in the glossary file: +\begin{verbatim} +\newcommand{\tally}[1]{\tallynum{\csname c@#1\endcsname}} +\end{verbatim} +\end{itemize} +If you have a numbering system where +\verb|\|\meta{cs name}\verb|{page}| expands to +\verb|\|\meta{internal cs name}\cs{c@page} (for example, if +\verb|\tally{page}| expands to \verb|\tallynum\c@page|) then you +need to use: +\begin{definition}[\DescribeMacro\glsaddprotectedpagefmt] +\cs{glsaddprotectedpagefmt}\marg{internal cs name} +\end{definition} +Note that the backslash must be omitted from \meta{internal cs name} +and the corresponding command must be able to process a count +register as the (sole) argument. + +For example, suppose you have a style \texttt{samplenum} that is +implemented as follows: +\begin{verbatim} + \newcommand*{\samplenum}[1]{% + \expandafter\@samplenum\csname c@#1\endcsname} + \newcommand*{\@samplenum}[1]{\two@digits{#1}} + +\end{verbatim} +(That is, it displays the value of the counter as a two-digit +number.) Then to ensure the location is correct for entries in +page-spanning paragraphs, you need to do: +\begin{verbatim} +\glsaddprotectedpagefmt{@samplenum} +\end{verbatim} +(If you are using a different counter for the location, such as +\texttt{section} or \texttt{equation}, you don't need to worry about +this provided the inner command is expandable.) + +If the inner macro (as given by \verb|\|\meta{internal cs name}) contains +non-expandable commands then you may need to redefine +\cs{gls}\meta{internal cs name}\texttt{page} after using +\begin{alltt} +\cs{glsaddprotectedpagefmt}\marg{internal cs name} +\end{alltt} +This command doesn't take any arguments +as \emph{the location is assumed to be given by \cs{c@page}} because +that's the only occasion this command should be used. For example, +suppose now my page counter format uses small caps Roman numerals: +\begin{verbatim} + \newcommand*{\samplenum}[1]{% + \expandafter\@samplenum\csname c@#1\endcsname} + \newcommand*{\@samplenum}[1]{\textsc{\romannumeral#1}} +\end{verbatim} +Again, the inner macro needs to be identified using: +\begin{verbatim} +\glsaddprotectedpagefmt{@samplenum} +\end{verbatim} +However, since \cs{textsc} isn't fully expandable, the location +is written to the file as \verb|\textsc {i}| (for page~1), +\verb|\textsc {ii}| (for page~2), etc. This format may cause a problem for +the \gls{indexingapp} (particularly for \gls{makeindex}). +To compensate for this, the \cs{gls}\meta{internal cs +name}\texttt{page} command may be redefined so that it expands to a +format that's acceptable to the \gls*{indexingapp}. For example: +\begin{verbatim} +\renewcommand*{\gls@samplenumpage}{\romannumeral\c@page} +\end{verbatim} +While this modification means that the \gls{numberlist} in the glossary +won't exactly match the format of the page numbers (displaying +lower case Roman numbers instead of small cap Roman numerals) +this method will at least work correctly for both \gls{makeindex} +and \gls{xindy}. If you are using \gls{xindy}, the following +definition: +\begin{verbatim} + \renewcommand*{\gls@samplenumpage}{% + \glsbackslash\string\textsc{\romannumeral\c@page}} +\end{verbatim} +combined with +\begin{verbatim} +\GlsAddXdyLocation{romansc}{:sep "\string\textsc\glsopenbrace" + "roman-numbers-lowercase" :sep "\glsclosebrace"} +\end{verbatim} +will now have lowercase Roman numerals in the location list +(see \sectionref{sec:xindyloc} for further details on that command). +Take care of the backslashes. The location (which ends up in +the \xindyattr{:locref} attribute) needs \verb|\\| but the location class +(identified with \cs{GlsAddXdyLocation}) just has a single +backslash. Note that this example will cause problems if your +locations should be hyperlinks. + +Another possibility that may work with both \gls{makeindex} and +\gls{xindy} is to redefine \cs{gls}\meta{internal cs +name}\texttt{page} (\cs{gls@samplenumpage} in this example) +to just expand to the decimal page number (\verb|\number\c@page|) and redefine +\ics{glsnumberformat} to change the displayed format: +\begin{verbatim} +\renewcommand*{\gls@samplenumpage}{\number\c@page} +\renewcommand*{\glsnumberformat}[1]{\textsc{\romannumeral#1}} +\end{verbatim} + +\begin{important} +If you redefine \cs{gls}\meta{internal cs name}\texttt{page}, +you must make sure that \cs{c@page} is expanded when it's written to +the file. (So don't, for example, hide \cs{c@page} inside a robust +command.) +\end{important} + +The mechanism that allows this to work temporarily redefines +\ics{the} and \ics{number} while it processes the location. If this +causes a problem you can disallow it using +\begin{definition}[\DescribeMacro\glswrallowprimitivemodsfalse] +\cs{glswrallowprimitivemodsfalse} +\end{definition} +but you will need to find some other way to ensure the location expands +correctly. + +\section{Range Formations} +\label{sec:ranges} + +Both \gls{makeindex} and \gls{xindy} (\optsand23) concatenate a +sequence of~3 or more consecutive pages into~a range. With +\gls*{xindy} (\opt3) you can vary the minimum sequence length using +\ics{GlsSetXdyMinRangeLength}\marg{n} where \meta{n} is either +an integer or the keyword \texttt{none} which indicates that there +should be no range formation (see \sectionref{sec:xindyloc} for +further details). + +\begin{important} +Note that \cs{GlsSetXdyMinRangeLength} must be used before +\ics{makeglossaries} and has no effect if \ics{noist} is used. +\end{important} + +With both \gls{makeindex} and \gls{xindy} (\optsand23), you can replace +the separator and the closing number in the range using: +\begin{definition}[\DescribeMacro{\glsSetSuffixF}] +\cs{glsSetSuffixF}\marg{suffix} +\end{definition} +\begin{definition}[\DescribeMacro{\glsSetSuffixFF}] +\cs{glsSetSuffixFF}\marg{suffix} +\end{definition} +where the former command specifies the suffix to use for a 2 page +list and the latter specifies the suffix to use for longer lists. +For example: +\begin{verbatim} +\glsSetSuffixF{f.} +\glsSetSuffixFF{ff.} +\end{verbatim} +Note that if you use \gls{xindy} (\opt3), you will also need to +set the minimum range length to 1 if you want to change these +suffixes: +\begin{verbatim} +\GlsSetXdyMinRangeLength{1} +\end{verbatim} +Note that if you use the \sty{hyperref} package, you will need +to use \ics{nohyperpage} in the suffix to ensure that the hyperlinks +work correctly. For example: +\begin{verbatim} +\glsSetSuffixF{\nohyperpage{f.}} +\glsSetSuffixFF{\nohyperpage{ff.}} +\end{verbatim} + +\begin{important} +Note that \cs{glsSetSuffixF} and \cs{glsSetSuffixFF} must be used +before \ics{makeglossaries} and have no effect if \ics{noist} is +used. +\end{important} + +It's also possible to concatenate a sequence of consecutive +locations into a range or have suffixes with \opt4, but with +\gls{bib2gls} these implicit ranges can't be merged with explicit +ranges (created with the \verb|(| and \verb|)| encaps). See +the \gls{bib2gls} manual for further details. + +\opt1 doesn't form ranges. However, with this option you +can iterate over an entry's \gls{numberlist} using: +\begin{definition}[\DescribeMacro\glsnumberlistloop] +\cs{glsnumberlistloop}\marg{label}\marg{handler cs}\marg{xr handler +cs} +\end{definition} +where \meta{label} is the entry's label and \meta{handler cs} is a +handler control sequence of the form: +\begin{definition} +\meta{handler cs}\marg{prefix}\marg{counter}\marg{format}\marg{location} +\end{definition} +where \meta{prefix} is the \sty{hyperref} prefix, \meta{counter} is +the name of the counter used for the location, \meta{format} is the +format used to display the location (e.g.\ \texttt{textbf}) +and \meta{location} is the location. The third argument is the +control sequence to use for any cross-references in the list. This +handler should have the syntax: +\begin{definition} +\meta{xr handler cs}\oarg{tag}\marg{xr list} +\end{definition} +where \meta{tag} is the cross-referenced text (e.g.\ \qt{see}) and +\meta{xr list} is a~comma-separated list of labels. (This actually +has a third argument but it's always empty when used with \opt1.) + +For example, if on page~12 +I~have used +\begin{verbatim} +\gls[format=textbf]{apple} +\end{verbatim} +and on page~18 I~have used +\begin{verbatim} +\gls[format=emph]{apple} +\end{verbatim} +then +\begin{verbatim} +\glsnumberlistloop{apple}{\myhandler} +\end{verbatim} +will be equivalent to: +\begin{verbatim} +\myhandler{}{page}{textbf}{12}% +\myhandler{}{page}{emph}{18}% +\end{verbatim} +There is a predefined handler that's used to display the +\gls{numberlist} in the glossary: +\begin{definition}[\DescribeMacro\glsnoidxdisplayloc] +\cs{glsnoidxdisplayloc}\marg{prefix}\marg{counter}\marg{format}\marg{location} +\end{definition} +The predefined handler used for the cross-references in the glossary is: +\begin{definition} +\cs{glsseeformat}\oarg{tag}\marg{xr list}\marg{location} +\end{definition} +which is described in \sectionref{sec:customxr}. + +\begin{important} +\cs{glsnumberlistloop} is not available for \optsand23. +\end{important} + +\section{Style Hook} +\label{sec:isthook} + +As from version 4.24, there's a hook that's used near the end of +\ics{writeist} before the file is closed. You can set the code +to be performed then using: +\begin{definition}[\DescribeMacro\GlsSetWriteIstHook] +\cs{GlsSetWriteIstHook}\marg{code} +\end{definition} +If you want the \meta{code} to write any information to the +file, you need to use +\begin{definition}[\DescribeMacro\glswrite] +\cs{write}\cs{glswrite}\marg{style information} +\end{definition} +Make sure you use the correct format within \meta{style +information}. For example, if you are using \app{makeindex}: +\begin{verbatim} +\GlsSetWriteIstHook{% + \write\glswrite{page_precedence "arnAR"}% + \write\glswrite{line_max 80}% +} +\end{verbatim} +This changes the page type precedence\index{page type precedence|main} and the maximum line length +used by \app{makeindex}. + +Remember that if you switch to \app{xindy}, this will no longer be +valid code. + \chapter{Glossary Styles} \label{sec:styles} @@ -11867,7 +11708,7 @@ with a number of pre-defined glossary styles, described in best suits your type of glossary or, if none of them suit your document, you can defined your own style (see \sectionref{sec:newglossarystyle}). There are some examples -of glossary styles available at \gallerytopic{glossaries}. +of glossary styles available at the \gallerytopic{glossaries}. The glossary style can be set using the \gloskey[printglossary]{style} key in the optional argument to \ics{printnoidxglossary} (\opt1) or \ics{printglossary} @@ -11904,9 +11745,9 @@ of available styles in \tableref{tab:styles}. You can view samples of all the predefined styles at \galleryurl{glossaries-styles/}. Note that \gls{glossaries-extra} provides additional styles -in the supplementary packages \sty{glossary-bookindex} and -\sty{glossary-longnoloc}. See the \gls{glossaries-extra} manual for -further details. +in the supplementary packages \sty{glossary-bookindex}, +\sty{glossary-topic} and \sty{glossary-longextra}. See the +\gls{glossaries-extra} manual for further details. \begin{important} Note that the group styles (such as \glostyle{listgroup}) will @@ -12988,6 +12829,16 @@ This defaults to just \meta{description}. \section{Defining your own glossary style} \label{sec:newglossarystyle} +\begin{important} +Commands like \cs{printglossary} are designed to produce content in +the PDF. If your intention is to design a style that doesn't print +any content (for example, to simply capture information) then you +are likely to experience unwanted side-effects. If you just want to +capture indexing information (such as locations) then a much better +approach is to use \gls{bib2gls}, which automatically stores this +information in dedicated fields when the entry is defined. +\end{important} + If the predefined styles don't fit your requirements, you can define your own style using: \begin{definition}[\DescribeMacro{\newglossarystyle}] @@ -13332,6 +13183,565 @@ that displays each entry in a \env{longtable} as follows: \end{verbatim} \end{example} +\chapter[Xindy (Option 3)]{Xindy (\ifpdf\opt3\else Option 3\fi)} +\label{sec:xindy} + +If you want to use \gls{xindy} to sort the glossary, you +must use the package option \pkgopt{xindy}: +\begin{verbatim} +\usepackage[xindy]{glossaries} +\end{verbatim} +This ensures that the glossary information is written in +\gls*{xindy} syntax. + +\sectionref{sec:makeglossaries} covers how to use the external +\gls{indexingapp}, and \sectionref{sec:locationsyntax} covers the +issues involved in the location syntax. This section covers the +commands provided by the \styfmt{glossaries} package that allow you +to adjust the \gls{xindy} style file (\filetype{xdy}) and +parameters. + +To assist writing information to the \gls{xindy} style +file, the \styfmt{glossaries} package provides the following +commands: +\begin{definition}[\DescribeMacro{\glsopenbrace}] +\cs{glsopenbrace} +\end{definition} +\begin{definition}[\DescribeMacro{\glsclosebrace}] +\cs{glsclosebrace} +\end{definition} +which produce an open and closing brace. (This is needed because +\verb|\{| and \verb|\}| don't expand to a simple brace character +when written to a file.) Similarly, you can write a percent +character using: +\begin{definition}[\DescribeMacro{\glspercentchar}] +\cs{glspercentchar} +\end{definition} +and a tilde character using: +\begin{definition}[\DescribeMacro{\glstildechar}] +\cs{glstildechar} +\end{definition} +For example, a newline character is specified in a \gls{xindy} style +file using \verb|~n| so you can use \texttt{\cs{glstildechar} n} +to write this correctly (or you can do \verb|\string~n|). +A backslash can be written to a file using +\begin{definition}[\DescribeMacro{\glsbackslash}] +\cs{glsbackslash} +\end{definition} + +In addition, if you are using a package that makes the double +quote character active (e.g. \sty{ngerman}) you can use: +\begin{definition}[\DescribeMacro{\glsquote}] +\cs{glsquote}\marg{text} +\end{definition} +which will produce \verb|"|\meta{text}\verb|"|. Alternatively, +you can use \verb|\string"| to write the double-quote character. +This document assumes that the double quote character has not been +made active, so the examples just use \verb|"| for clarity. + +If you want greater control over the \gls{xindy} style file than is +available through the \LaTeX\ commands provided by the +\styfmt{glossaries} package, you will need to edit the \gls*{xindy} +style file. In which case, you must use \ics{noist} to prevent the +style file from being overwritten by the \styfmt{glossaries} +package. For additional information about \gls*{xindy}, read the +\gls*{xindy} documentation. I'm sorry I can't provide any assistance +with writing \gls*{xindy} style files. If you need help, I recommend +you ask on the \gls*{xindy} mailing list +(\url{http://xindy.sourceforge.net/mailing-list.html}). + +\section{Language and Encodings} +\label{sec:langenc} + +When you use \gls{xindy}, you need to specify the language +and encoding used (unless you have written your own custom +\gls*{xindy} style file that defines the relevant alphabet +and sort rules). If you use \gls{makeglossaries}, +this information is obtained from the document's auxiliary +(\filetype{aux}) file. The \gls{makeglossaries} script attempts to +find the root language given your document settings, but in the +event that it gets it wrong or if \gls*{xindy} doesn't support +that language, then you can specify the required language using: +\begin{definition}[\DescribeMacro{\GlsSetXdyLanguage}] +\cs{GlsSetXdyLanguage}\oarg{glossary type}\marg{language} +\end{definition} +where \meta{language} is the name of the language. The +optional argument can be used if you have multiple glossaries +in different languages. If \meta{glossary type} is omitted, it +will be applied to all glossaries, otherwise the language +setting will only be applied to the glossary given by +\meta{glossary type}. + +If the \sty{inputenc} package is used, the encoding will be +obtained from the value of \ics{inputencodingname}. +Alternatively, you can specify the encoding using: +\begin{definition}[\DescribeMacro{\GlsSetXdyCodePage}] +\cs{GlsSetXdyCodePage}\marg{code} +\end{definition} +where \meta{code} is the name of the encoding. For example: +\begin{verbatim} +\GlsSetXdyCodePage{utf8} +\end{verbatim} + +Note that you can also specify the language and encoding using +the package option +\verb|xindy={language=|\meta{lang}\verb|,codepage=|\meta{code}\verb|}|. +For example: +\begin{verbatim} +\usepackage[xindy={language=english,codepage=utf8}]{glossaries} +\end{verbatim} + +If you write your own custom \gls{xindy} style file that +includes the language settings, you need to set the language +to nothing: +\begin{verbatim} +\GlsSetXdyLanguage{} +\end{verbatim} +(and remember to use \ics{noist} to prevent the style file from +being overwritten). + +\begin{important} +The commands \cs{GlsSetXdyLanguage} and \cs{GlsSetXdyCodePage} +have no effect if you don't use \gls{makeglossaries}. If +you call \gls{xindy} without \gls*{makeglossaries} you +need to remember to set the language and encoding using the +\xdyopt{L} and \xdyopt{C} switches. +\end{important} + +\section{Locations and Number lists} +\label{sec:xindyloc} + +If you use \pkgopt{xindy}, the \styfmt{glossaries} package needs to +know which counters you will be using in the \gls{numberlist} in order to correctly format the \gls{xindy} style +file. Counters specified using the \pkgopt{counter} package option +or the \meta{counter} option of \ics{newglossary} are +automatically taken care of, but if you plan to use a different +counter in the \gloskey[glslink]{counter} key for commands like +\ics{glslink}, then you need to identify these counters \emph{before} +\ics{makeglossaries} using: +\begin{definition}[\DescribeMacro{\GlsAddXdyCounters}] +\cs{GlsAddXdyCounters}\marg{counter list} +\end{definition} +where \meta{counter list} is a comma-separated list of counter names. + +The most likely \ixindyattrs attributes used in the \gloskey[glslink]{format} +key (\locfmt{textrm}, \locfmt{hyperrm} etc) are automatically added +to the \gls{xindy} style file, but if you want to use another +attribute, you need to add it using: +\begin{definition}[\DescribeMacro{\GlsAddXdyAttribute}] +\cs{GlsAddXdyAttribute}\marg{name} +\end{definition} +where \meta{name} is the name of the attribute, as used in +the \gloskey[glslink]{format} key. + +Take care if you have multiple instances of the same location with +different formats. The duplicate locations will be discarded +according to the order in which the \ixindyattrs attributes are listed. Consider +defining semantic commands to use for primary references. For +example: +\begin{verbatim} +\newcommand*{\primary}[1]{\textbf{#1}} +\GlsAddXdyAttribute{primary} +\end{verbatim} +Then in the document: +\begin{verbatim} +A \gls[format=primary]{duck} is an aquatic bird. +There are lots of different types of \gls{duck}. +\end{verbatim} +This will give the \verb|format=primary| instance preference over +the next use that doesn't use the \gloskey[glslink]{format} key. + +\begin{example}{Custom Font for Displaying a Location}{ex:hyperbfit} +Suppose I want a bold, italic, hyperlinked location. I first need to define a +command that will do this: +\begin{verbatim} +\newcommand*{\hyperbfit}[1]{\textit{\hyperbf{#1}}} +\end{verbatim} +but with \gls{xindy}, I also need to add this as an allowed +\ixindyattrs attribute: +\begin{verbatim} +\GlsAddXdyAttribute{hyperbfit} +\end{verbatim} +Now I can use it in the optional argument of commands like +\ics{gls}: +\begin{verbatim} +Here is a \gls[format=hyperbfit]{sample} entry. +\end{verbatim} +(where \texttt{sample} is the label of the required entry). +\end{example} + +\begin{important} +Note that \cs{GlsAddXdyAttribute} has no effect if \ics{noist} is +used or if \ics{makeglossaries} is omitted. +\cs{GlsAddXdyAttribute} must be used before \ics{makeglossaries}. +Additionally, \cs{GlsAddXdyCounters} must come before +\cs{GlsAddXdyAttribute}. +\end{important} + +If the location numbers include formatting commands, then +you need to add a location style in the appropriate format using +\begin{definition}[\DescribeMacro{\GlsAddXdyLocation}] +\cs{GlsAddXdyLocation}\oarg{prefix-location}\marg{name}\marg{definition} +\end{definition} +where \meta{name} is the name of the format and \meta{definition} is +the \gls{xindy} definition. The optional argument \meta{prefix-location} +is needed if \cs{theH}\meta{counter} either isn't defined or is +different from \cs{the}\meta{counter}. +Be sure to also read \sectionref{sec:locationsyntax} for some issues +that you may encounter. + +\begin{important} +Note that \cs{GlsAddXdyLocation} has no effect if \ics{noist} is +used or if \ics{makeglossaries} is omitted. +\cs{GlsAddXdyLocation} must be used before \ics{makeglossaries}. +\end{important} + +\begin{example}{Custom Numbering System for Locations}{ex:customloc} +Suppose I decide to use a somewhat eccentric numbering +system for sections where I redefine \cs{thesection} as follows: +\begin{verbatim} +\renewcommand*{\thesection}{[\thechapter]\arabic{section}} +\end{verbatim} +If I haven't done "counter=section" in the package +option, I need to specify that the counter will be used as a +location number: +\begin{verbatim} +\GlsAddXdyCounters{section} +\end{verbatim} +Next I need to add the location style (\cs{thechapter} is assumed to +be the standard \verb"\arabic{chapter}"): +\begin{verbatim} +\GlsAddXdyLocation{section}{:sep "[" "arabic-numbers" :sep "]" + "arabic-numbers" +} +\end{verbatim} +Note that if I have further decided to use the \sty{hyperref} +package and want to redefine \cs{theHsection} as: +\begin{verbatim} +\renewcommand*{\theHsection}{\thepart.\thesection} +\renewcommand*{\thepart}{\Roman{part}} +\end{verbatim} +then I need to modify the \cs{GlsAddXdyLocation} code above to: +\begin{verbatim} +\GlsAddXdyLocation["roman-numbers-uppercase"]{section}{:sep "[" + "arabic-numbers" :sep "]" "arabic-numbers" +} +\end{verbatim} +Since \ics{Roman} will result in an empty string if the counter is +zero, it's a good idea to add an extra location to catch this: +\begin{verbatim} +\GlsAddXdyLocation{zero.section}{:sep "[" + "arabic-numbers" :sep "]" "arabic-numbers" +} +\end{verbatim} +This example is illustrated in the sample file +\samplefile{xdy2}. +\end{example} + +\begin{example}{Locations as Dice}{ex:dice} +Suppose I want a rather eccentric page numbering system that's +represented by the number of dots on dice. The \sty{stix} package +provides \cs{dicei}, \ldots, \cs{dicevi} that represent the six +sides of a die. I can define a command that takes a number as its +argument. If the number is less than seven, the appropriate +\cs{dice}\meta{n} command is used otherwise it does \cs{dicevi} the +required number of times with the leftover in a final +\cs{dice}\meta{n}. For example, the number 16 is represented by +\verb|\dicevi\dicevi\diceiv| ($6+6+4=16$). I've called this command +\cs{tallynum} to match the example given earlier in +\sectionref{sec:locationsyntax}: +\begin{verbatim} +\newrobustcmd{\tallynum}[1]{% + \ifnum\number#1<7 + $\csname dice\romannumeral#1\endcsname$% + \else + $\dicevi$% + \expandafter\tallynum\expandafter{\numexpr#1-6}% + \fi +} +\end{verbatim} +Here's the counter command: +\begin{verbatim} +newcommand{\tally}[1]{\tallynum{\arabic{#1}}} +\end{verbatim} +The \ctr{page} counter representation (\cs{thepage}) needs to be +changed to use this command: +\begin{verbatim} +\renewcommand*{\thepage}{\tally{page}} +\end{verbatim} +The \cs{tally} command expands to \cs{tallynum} \marg{number} so +this needs a location class that matches this format: +\begin{verbatim} +\GlsAddXdyLocation{tally}{% + :sep "\string\tallynum\space\glsopenbrace" + "arabic-numbers" + :sep "\glsclosebrace" +} +\end{verbatim} +The space between \cs{tallynum} and \marg{number} is +significant to \gls{xindy} so \cs{space} is required. + +Note that \cs{GlsAddXdyLocation}\marg{name}\marg{definition} will define +commands in the form: +\begin{definition} +\cs{glsX}\meta{counter}"X"\meta{name}\marg{Hprefix}\marg{location} +\end{definition} +for each counter that has been identified either by the +\pkgopt{counter} package option, the \meta{counter} option for +\ics{newglossary} or in the argument of \ics{GlsAddXdyCounters}. +The first argument \meta{Hprefix} is only relevant when used with +the \sty{hyperref} package and indicates that \cs{theH}\meta{counter} +is given by \cs{Hprefix}"."\cs{the}\meta{counter}. + +The sample file \samplefile{xdy}, which comes with the \styfmt{glossaries} +package, uses the default \ctr{page} counter for locations, and it +uses the default \ics{glsnumberformat} and a custom \cs{hyperbfit} +format. A new \gls{xindy} location called \texttt{tallynum}, as +illustrated above, is defined to make the page numbers appear as +dice. In order for the location numbers to +hyperlink to the relevant pages, I~need to redefine the necessary +\cs{glsX}\meta{counter}"X"\meta{format} commands: +\begin{verbatim} +\renewcommand{\glsXpageXglsnumberformat}[2]{% + \linkpagenumber#2% +} + +\renewcommand{\glsXpageXhyperbfit}[2]{% + \textbf{\em\linkpagenumber#2}% +} + +\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} +\end{verbatim} +Note that the second argument of \cs{glsXpageXglsnumberformat} is +in the format \cs{tallynum}\marg{n} so the line +\begin{verbatim} + \linkpagenumber#2% +\end{verbatim} +does +\begin{alltt} + \cs{linkpagenumber}\cs{tallynum}\marg{number} +\end{alltt} +so \cs{tallynum} is the first argument of \cs{linkpagenumber} +and \meta{number} is the second argument. +\end{example} + +\begin{important} +This method is very sensitive to the internal definition of the +location command. +\end{important} + +\begin{example}{Locations as Words not Digits}{ex:fmtcount} +Suppose I want the page numbers written as words +rather than digits and I~use the \sty{fmtcount} package to +do this. I~can redefine \ics{thepage} as follows: +\begin{verbatim} +\renewcommand*{\thepage}{\Numberstring{page}} +\end{verbatim} +This \emph{used} to get expanded to \verb|\protect \Numberstringnum |\marg{n} +where \meta{n} is the Arabic page number. This means that I~needed to +define a new location with the form: +\begin{verbatim} +\GlsAddXdyLocation{Numberstring}{:sep "\string\protect\space + \string\Numberstringnum\space\glsopenbrace" + "arabic-numbers" :sep "\glsclosebrace"} +\end{verbatim} +and if I'd used the \cs{linkpagenumber} command from the previous +example, it would need \emph{three} arguments (the first being +\cs{protect}): +\begin{verbatim} +\newcommand{\linkpagenumber}[3]{\hyperlink{page.#3}{#1#2{#3}}} +\end{verbatim} + +The internal definition of \cs{Numberstring} has since changed +so that it now expands to \verb|\Numberstringnum |\marg{n} +(no \cs{protect}). This means that the location class definition +must be changed to: +\begin{verbatim} +\GlsAddXdyLocation{Numberstring}{% no \protect now! + :sep "\string\Numberstringnum\space\glsopenbrace" + "arabic-numbers" :sep "\glsclosebrace"} +\end{verbatim} +and \cs{linkpagenumber} goes back to only two arguments: +\begin{verbatim} +\newcommand{\linkpagenumber}[2]{\hyperlink{page.#2}{#1{#2}}} +\end{verbatim} +The other change is that \cs{Numberstring} uses +\begin{alltt} +\cs{the}\cs{value}\marg{counter} +\end{alltt} +instead of +\begin{alltt} +\cs{expandafter}\cs{the}\cs{csname} c@\meta{counter}\cs{endcsname} +\end{alltt} +so it hides \cs{c@page} from the location escaping mechanism +(see \sectionref{sec:locationsyntax}). This means that the page +number may be incorrect if the indexing occurs during the output +routine. + +A more recent change to \sty{fmtcount} (v3.03) now puts three +instances of \cs{expandafter} before \verb|\the\value| which +no longer hides \cs{c@page} from the location escaping mechanism, so +the page numbers should once more be correct. Further changes +to the \sty{fmtcount} package may cause a problem again. + +\begin{important} +When dealing with custom formats where the internal definitions +are outside of your control and liable to change, it's best +to provide a wrapper command. +\end{important} + +Instead of directly using \cs{Numberstring} in the definition of +\cs{thepage}, I can provide a custom command in the same form +as the earlier \cs{tally} command: +\begin{verbatim} +\newcommand{\customfmt}[1]{\customfmtnum{\arabic{#1}}} +\newrobustcmd{\customfmtnum}[1]{\Numberstringnum{#1}} +\end{verbatim} +This ensures that the location will always be written to +the indexing file in the form: +\begin{alltt} +:locref "\glsopenbrace\glsclosebrace\glsopenbrace\string\\customfmtnum \marg{n}\glsclosebrace" +\end{alltt} +So the location class can be defined as: +\begin{verbatim} +\GlsAddXdyLocation{customfmt}{ + :sep "\string\customfmtnum\space\glsopenbrace" + "arabic-numbers" + :sep "\glsclosebrace"} +\end{verbatim} + +The sample file +\samplefile{xdy3} illustrates this. +\end{example} + +In the \gls{numberlist}, the locations are sorted according to the list +of provided location classes. The default ordering is: +\texttt{roman-page-numbers} (i, ii, \ldots), \texttt{arabic-page-numbers} +(1, 2, \ldots), \texttt{arabic-section-numbers} (for example, 1.1 if the +compositor is a full stop or 1-1 if the compositor is a +hyphen\footnote{see \ics{glsSetCompositor} described in +\sectionref{sec:setup}}), \texttt{alpha-page-numbers} (a, b, \ldots), +\texttt{Roman-page-numbers} (I, II, \ldots), \texttt{Alpha-page-numbers} +(A, B, \ldots), \texttt{Appendix-page-numbers} (for example, A.1 if the Alpha +compositor is a full stop or A-1 if the Alpha compositor is a +hyphen\footnote{see \ics{glsSetAlphaCompositor} described in +\sectionref{sec:setup}}), user defined location names (as specified +by \ics{GlsAddXdyLocation} in the order in which they were defined), +and finally \texttt{see} (cross-referenced entries).\footnote{With +\gls{glossaries-extra} \texttt{seealso} is appended to the end of +the list.} This ordering can be changed using: + +\begin{definition}[\DescribeMacro\GlsSetXdyLocationClassOrder] +\cs{GlsSetXdyLocationClassOrder}\marg{location names} +\end{definition} +where each location name is delimited by double quote marks and +separated by white space. For example: +\begin{verbatim} +\GlsSetXdyLocationClassOrder{ + "arabic-page-numbers" + "arabic-section-numbers" + "roman-page-numbers" + "Roman-page-numbers" + "alpha-page-numbers" + "Alpha-page-numbers" + "Appendix-page-numbers" + "see" +} +\end{verbatim} +(Remember to add \verb|"seealso"| if you're using +\gls{glossaries-extra}.) + +\begin{important} +Note that \cs{GlsSetXdyLocationClassOrder} has no effect if +\ics{noist} is used or if \ics{makeglossaries} is omitted. +\cs{GlsSetXdyLocationClassOrder} must be used before +\ics{makeglossaries}. +\end{important} + +If a \gls{numberlist} consists of a sequence of consecutive +numbers, the range will be concatenated. The +number of consecutive locations that causes a range formation +defaults to 2, but can be changed using: + +\begin{definition}[\DescribeMacro\GlsSetXdyMinRangeLength] +\cs{GlsSetXdyMinRangeLength}\marg{n} +\end{definition} +For example: +\begin{verbatim} +\GlsSetXdyMinRangeLength{3} +\end{verbatim} +The argument may also be the keyword \texttt{none}, to indicate that +there should be no range formations. See the \gls{xindy} +manual for further details on range formations. + +\begin{important} +Note that \cs{GlsSetXdyMinRangeLength} has no effect if \ics{noist} +is used or if \ics{makeglossaries} is omitted. +\cs{GlsSetXdyMinRangeLength} must be used before +\ics{makeglossaries}. +\end{important} +See also \sectionref{sec:ranges}. + +\section{Glossary Groups} +\label{sec:groups} + +The glossary is divided into groups according to the first +letter of the sort key. The \styfmt{glossaries} package also adds +a number group by default, unless you suppress it in the +\pkgopt{xindy} package option. For example: +\begin{verbatim} +\usepackage[xindy={glsnumbers=false}]{glossaries} +\end{verbatim} +Any entry that doesn't go in one of the letter groups or the +number group is placed in the default group. If you want \gls{xindy} +to sort the number group numerically (rather than by a string sort) +then you need to use \gls{xindy}['s] \texttt{numeric-sort} module: +\begin{verbatim} +\GlsAddXdyStyle{numeric-sort} +\end{verbatim} + +If you don't use \texttt{glsnumbers=false}, the default behaviour is to locate +the number group before the \qt{A} letter group. If you are not using a +Roman alphabet, you need to change this using: + + +\begin{definition}[\DescribeMacro\GlsSetXdyFirstLetterAfterDigits] +\cs{GlsSetXdyFirstLetterAfterDigits}\marg{letter} +\end{definition} +where \meta{letter} is the first letter of your alphabet. Take care +if you're using \sty{inputenc} as non-ASCII characters are actually +active characters that expand. (This isn't a problem with the native +\gls{UTF-8} engines and \sty{fontspec}.) The starred form will sanitize +the argument to prevent expansion. +Alternatively you can use: + + +\begin{definition}[\DescribeMacro\GlsSetXdyNumberGroupOrder] +\cs{GlsSetXdyNumberGroupOrder}\marg{relative location} +\end{definition} +to change the default +\begin{alltt} +:before \cs{string}"\meta{letter}\cs{string}" +\end{alltt} +to \meta{relative location}. For example: +\begin{verbatim} +\GlsSetXdyNumberGroupOrder{:after \string"Z\string"} +\end{verbatim} +will put the number group after the \qt{Z} letter group. +Again take care of active characters. There's a starred version +that sanitizes the argument (so don't use \cs{string} in it). +\begin{alltt} +\cs{GlsSetXdyNumberGroupOrder}*\{:after "\"O"\} +\end{alltt} + +\begin{important} +Note that these commands have no effect if +\ics{noist} is used or if \ics{makeglossaries} is omitted. +\cs{GlsSetXdyFirstLetterAfterDigits} must be used before +\ics{makeglossaries}.\par +\end{important} + + \chapter{Utilities} \label{sec:utilities} @@ -13375,6 +13785,12 @@ option). This command doesn't have an optional argument. If you want to explicitly say which lists to iterate over, just use the optional argument of \cs{forallglossaries}. +\begin{xtr} +The \gls{glossaries-extra} +package provides an analogous command +\ics*{forallabbreviationlists}. +\end{xtr} + \begin{definition}[\DescribeMacro{\forglsentries}] \cs{forglsentries}\oarg{glossary label}\marg{cs}\marg{body} \end{definition} @@ -13474,7 +13890,14 @@ part}} \end{definition} This checks if the glossary entry given by \meta{label} has any sub-entries. If it does, \meta{true part} is performed, otherwise -\meta{false part}. +\meta{false part}. This uses an inefficient method since this +information isn't stored. + +\begin{bib2gls} +If you use \gls{bib2gls}, a more efficient method is to use the +\resourceopt{save-child-count} resource option and test the value of +the \field{childcount} field. +\end{bib2gls} \begin{definition}[\DescribeMacro{\ifglshasparent}] \cs{ifglshasparent}{\meta{label}}{\meta{true part}}{\meta{false @@ -14314,7 +14737,7 @@ The \gls{glossaries-extra} package and \gls{bib2gls} provide some additional sample files. There are also examples in the \gallery{}{Dickimaw Books Gallery}. -If you prefer to use UTF-8 aware engines (\texttt{xelatex} or +If you prefer to use \gls{UTF-8} aware engines (\texttt{xelatex} or \texttt{lualatex}) remember that you'll need to switch from \styfmt{fontenc} \& \styfmt{inputenc} to \styfmt{fontspec} where appropriate. @@ -18272,7 +18695,7 @@ also the earlier \samplefile{Sec}. \exitem{utf8} This is another example that uses \gls{xindy}. Unlike \gls{makeindex}, \gls{xindy} can cope with \glspl{nonlatinchar}. This -document uses UTF-8 encoding. To create the document do: +document uses \gls{UTF-8} encoding. To create the document do: \begin{prompt} pdflatex sampleutf8 makeglossaries sampleutf8 @@ -19214,10 +19637,10 @@ If you have any problems, please first consult the \urlfootref{http://www.dickimaw-books.com/faqs/glossariesfaq.html}{\styfmt{glossaries} FAQ}. If that doesn't help, try posting your query to somewhere like the \texttt{comp.text.tex} newsgroup, the -\urlfootref{http://www.latex-community.org/}{\LaTeX\ Community Forum} or -\urlfootref{http://tex.stackexchange.com/}{\TeX\ on StackExchange}. +\urlfootref{https://latex.org/forum/}{\LaTeX\ Community Forum} or +\urlfootref{https://tex.stackexchange.com/}{\TeX\ on StackExchange}. Bug reports can be submitted via -\urlfootref{http://www.dickimaw-books.com/bug-report.html}{my package bug report form}. +\urlfootref{https://www.dickimaw-books.com/bug-report.html}{my package bug report form}. \PrintIndex diff --git a/macros/latex/contrib/glossaries/glossaries.dtx b/macros/latex/contrib/glossaries/glossaries.dtx index b0d0914db2..5c9124cc63 100644 --- a/macros/latex/contrib/glossaries/glossaries.dtx +++ b/macros/latex/contrib/glossaries/glossaries.dtx @@ -1,15 +1,9 @@ %\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" -% -doc "glossaries-manual.tex" -% -codetitle "Main Package Code" % -comment ".*\.perl" % -comment ".*\.tex" -% -macrocode ".*\.perl" -% -macrocode ".*\.tex" +% -author "Nicola Talbot" % -src "glossaries\.sty\Z=>glossaries.sty" % -src "glossaries-prefix.sty\Z=>glossaries-prefix.sty" % -src "(glossary-.+)\.(sty)\Z=>\1.\2" @@ -19,10 +13,17 @@ % -src "(glossaries-babel)\.(sty)\Z=>\1.\2" % -src "(glossaries-polyglossia)\.(sty)\Z=>\1.\2" % -src "(example-glossaries-.*\.tex)\Z=>\1" +% -src "(glossaries-2020-03-19\.sty)\Z=>\1" % -src "(.*\.perl)\Z=>\1" -% -author "Nicola Talbot" +% -setambles ".*\.perl=>\nopreamble\nopostamble" +% -setambles ".*\.tex=>\nopreamble\nopostamble" +% -doc "glossaries-manual.tex" +% -section "chapter" +% -codetitle "Main Package Code" +% -macrocode ".*\.perl" +% -macrocode ".*\.tex" % glossaries -% Created on 2020/3/19 17:03 +% Created on 2021/9/23 17:22 %\fi %\iffalse %<*package> @@ -45,7 +46,7 @@ %\fi % \iffalse % Doc-Source file to use with LaTeX2e -% Copyright (C) 2020 Nicola Talbot, all rights reserved. +% Copyright (C) 2021 Nicola Talbot, all rights reserved. % \fi % \iffalse %<*driver> @@ -136,7 +137,7 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of \setcounter{IndexColumns}{2} -\CheckSum{20358} +\CheckSum{34113} \newcommand*{\ifirstuse}{\iterm{first use}} \newcommand*{\firstuse}{\gls{firstuse}} @@ -163,12 +164,12 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of %\fi %\MakeShortVerb{"} % -% \title{Documented Code For glossaries v4.46} +% \title{Documented Code For glossaries v4.47} % \author{Nicola L.C. Talbot\\[10pt] %Dickimaw Books\\ %\url{http://www.dickimaw-books.com/}} % -% \date{2020-03-19} +% \date{2021-09-20} % \maketitle % %This is the documented code for the \styfmt{glossaries} package. @@ -184,7 +185,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.46: +%For the main user guide, read \qt{glossaries.sty v4.47: %\LaTeX2e\ Package to Assist Generating Glossaries}. % %\item[\url{mfirstuc-manual.pdf}] @@ -239,7 +240,15 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of % This package requires \LaTeXe. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries}[2020/03/19 v4.46 (NLCT)] +% \end{macrocode} +% Rollback releases: +% \begin{macrocode} +\DeclareRelease{v4.46}{2020-03-19}{glossaries-2020-03-19.sty} +\DeclareCurrentRelease{v4.47}{2021-09-20} +% \end{macrocode} +% Declare package: +% \begin{macrocode} +\ProvidesPackage{glossaries}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} %\changes{4.18}{2015-09-09}{split mfirstuc into separate bundle} % Required packages: @@ -1181,8 +1190,9 @@ false,nolabel,autolabel,nameref}[nolabel]{% \def\@gls@setsort##1{% % \end{macrocode} % Get the parent, if one exists +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \edef\@glo@parent{\csname glo@##1@parent\endcsname}% + \protected@edef\@glo@parent{\csname glo@##1@parent\endcsname}% % \end{macrocode} % Set the information for the parent entry if not already done. % \begin{macrocode} @@ -1193,8 +1203,8 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} % Set index information for this entry % \begin{macrocode} - \edef\@glo@type{\csname glo@##1@type\endcsname}% - \edef\@gls@tmp{\csname glo@##1@sort\endcsname}% + \protected@edef\@glo@type{\csname glo@##1@type\endcsname}% + \protected@edef\@gls@tmp{\csname glo@##1@sort\endcsname}% \ifx\@gls@tmp\@empty \expandafter\global\expandafter \advance\csname glossary@\@glo@type @sortcount\endcsname by 1\relax @@ -1424,9 +1434,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\end{definition} % Determines if the glossary with the given label has been identified % as being a list of acronyms. +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand{\glsIfListOfAcronyms}[1]{% - \edef\@do@gls@islistofacronyms{% + \protected@edef\@do@gls@islistofacronyms{% \noexpand\@gls@islistofacronyms{#1}{\@glsacronymlists}}% \@do@gls@islistofacronyms } @@ -2399,24 +2410,69 @@ false,nolabel,autolabel,nameref}[nolabel]{% % %\begin{macro}{\@@do@write@glslabels} %\changes{4.45}{2020-02-13}{new} +%\changes{4.47}{2021-09-20}{fully expand list} % \begin{macrocode} \newcommand*{\@@do@write@glslabels}{% \newwrite\@gls@labelsfile \immediate\openout\@gls@labelsfile=\jobname.glslabels - \forallglsentries[\@glo@types,\@ignored@glossaries]{\@glsentry}% - {\ifdefempty{\@glsentry}{}{\immediate\write\@gls@labelsfile{\@glsentry}}}% + \protected@edef\@gls@fulllist{\@glo@types}% + \ifdefempty{\@ignored@glossaries}{}% + {\protected@eappto\@gls@fulllist{,\@ignored@glossaries}}% + \forallglsentries[\@gls@fulllist]{\@glsentry}% + {% + \ifdefempty{\@glsentry}{}% + {% + \ifx\do@write@glslabelsname\@gobble + \def\@gls@thisentryname{}% + \else + \letcs{\@gls@thisentryname}{glo@\glsdetoklabel{\@glsentry}@name}% + \@onelevel@sanitize\@gls@thisentryname + \fi + \immediate\write\@gls@labelsfile + {\@glsentry\do@write@glslabelsname{\@gls@thisentryname}}% + }% + }% \immediate\closeout\@gls@labelsfile } % \end{macrocode} %\end{macro} % +%\begin{macro}{\do@write@glslabelsname} +%\changes{4.47}{2021-09-20}{new} +% Support for additionally writing the name as well as the label. +% Let to \cs{@gobble} if name not required and to +% \cs{@write@glslabelsname} if required. +% \begin{macrocode} +\newcommand*{\do@write@glslabelsname}[1]{} +% \end{macrocode} +%\end{macro} +% +%\begin{macro}{\@write@glslabelsname} +%\changes{4.47}{2021-09-20}{new} +% \begin{macrocode} +\begingroup +\catcode`\^^I12 +\gdef\@write@glslabelsname#1{^^I#1} +\endgroup +% \end{macrocode} +%\end{macro} +% %\begin{option}{writeglslabels} %\changes{4.45}{2020-02-13}{new} %This option will write all entry labels (including those in ignored %glossaries) to the file \cs{jobname}\texttt{.glslabels}. This file %may be used by text editors for label auto-completion. % \begin{macrocode} -\@gls@declareoption{writeglslabels}{\@do@write@glslabels} +\@gls@declareoption{writeglslabels}{\@do@write@glslabels + \let\do@write@glslabelsname\@gobble} +% \end{macrocode} +%\end{option} +%\begin{option}{writeglslabelnames} +%\changes{4.47}{2021-09-20}{new} +%As the above but also writes the name. +% \begin{macrocode} +\@gls@declareoption{writeglslabelnames}{\@do@write@glslabels + \let\do@write@glslabelsname\@write@glslabelsname} % \end{macrocode} %\end{option} %\begin{macro}{\ifglsautomake} @@ -3887,10 +3943,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% \protected@edef\@gls@roman{\@roman{0\string" \string"roman-numbers-lowercase\string" :sep \string"}}% \@onelevel@sanitize\@gls@roman - \edef\@tmp{\string" \string"roman-numbers-lowercase\string" + \edef\@gls@tmp{\string" \string"roman-numbers-lowercase\string" :sep \string"}% - \@onelevel@sanitize\@tmp - \ifx\@tmp\@gls@roman + \@onelevel@sanitize\@gls@tmp + \ifx\@gls@tmp\@gls@roman \expandafter \edef\csname @gls@xdy@Lclass@roman-page-numbers\endcsname{% \string"roman-numbers-lowercase\string"% @@ -4277,9 +4333,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% % current iteration. %\changes{2.01}{2009 May 30}{replaced \cs{ifthenelse} with \cs{ifx}} %\changes{3.11a}{2013-10-15}{replaced \cs{ifx} with \cs{ifdefempty}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand*{\forglsentries}[3][\glsdefaulttype]{% - \edef\@@glo@list{\csname glolist@#1\endcsname}% + \protected@edef\@@glo@list{\csname glolist@#1\endcsname}% \@for#2:=\@@glo@list\do {% \ifdefempty{#2}{}{#3}% @@ -4507,7 +4564,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% \glsdoifexists{#1}% {% \def\do@glshaschildren{#3}% - \edef\@gls@thislabel{\glsdetoklabel{#1}}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} +% \begin{macrocode} + \protected@edef\@gls@thislabel{\glsdetoklabel{#1}}% \expandafter\forglsentries\expandafter [\csname glo@\@gls@thislabel @type\endcsname] {\glo@label}% @@ -4878,8 +4938,9 @@ false,nolabel,autolabel,nameref}[nolabel]{% }{}% % \end{macrocode} % Add this to the list of glossary types: +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \toks@{#2}\edef\@glo@types{\@glo@types\the\toks@,}% + \toks@{#2}\protected@edef\@glo@types{\@glo@types\the\toks@,}% % \end{macrocode} % Define a comma-separated list of labels for this glossary type, % so that all the entries for this glossary can be reset with a @@ -5015,19 +5076,20 @@ false,nolabel,autolabel,nameref}[nolabel]{% % %\begin{macro}{\newignoredglossary} % Creates a new glossary that doesn't have associated files. -% This glossary is ignored by and commands that iterate over +% This glossary is ignored by any commands that iterate over % glossaries, such as \ics{printglossaries}, and won't work with % commands like \ics{printglossary}. It's intended for entries that % are so commonly-known they don't require a glossary. %\changes{4.08}{2014-07-30}{new} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand*{\newignoredglossary}[1]{% \ifdefempty\@ignored@glossaries {% - \edef\@ignored@glossaries{#1}% + \protected@edef\@ignored@glossaries{#1}% }% {% - \eappto\@ignored@glossaries{,#1}% + \protected@eappto\@ignored@glossaries{,#1}% }% \csgdef{glolist@#1}{,}% \ifcsundef{gls@#1@entryfmt}% @@ -5040,7 +5102,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% \renewcommand*{\@gls@nohyperlist}{#1}% }% {% - \eappto\@gls@nohyperlist{,#1}% + \protected@eappto\@gls@nohyperlist{,#1}% }% } % \end{macrocode} @@ -5059,9 +5121,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% % Expansion is used in case the first argument is a control % sequence. %\changes{4.08}{2014-07-30}{new} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand*{\ifignoredglossary}[3]{% - \edef\@gls@igtype{#1}% + \protected@edef\@gls@igtype{#1}% \expandafter\DTLifinlist\expandafter {\@gls@igtype}{\@ignored@glossaries}{#2}{#3}% } @@ -5285,7 +5348,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\changes{4.20}{2015-11-30}{new} % \begin{macrocode} \newcommand*{\gls@checkseeallowed@preambleonly}{% - \GlossariesWarning{glossaries}% + \GlossariesWarning {`\gls@xr@key' key doesn't have any effect when used in the document environment. Move the definition to the preamble after \string\makeglossaries\space @@ -5686,11 +5749,11 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\begin{macro}{\gls@defdocnewglossaryentry} %\changes{4.14}{2015-02-28}{new} % The definition of \cs{newglossaryentry} is changed at the start of -% the \env{document} environment. The \gloskey{see} key doesn't work -% for entries that have been defined in the document environment. +% the \env{document} environment. As from v4.47 the \gloskey{see} +% key now works in the \env{document} environment. +%\changes{4.47}{2021-09-20}{removed see warning} % \begin{macrocode} \newcommand*{\gls@defdocnewglossaryentry}{% - \let\gls@checkseeallowed\gls@checkseeallowed@preambleonly \let\newglossaryentry\new@glossaryentry } % \end{macrocode} @@ -5712,6 +5775,38 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} %\end{macro} % +%\begin{macro}{\gls@glsdefs@labellist} +%\changes{4.47}{2021-09-20}{new} +% List of labels of entries defined in \texttt{.glsdefs} file. +% \begin{macrocode} +\newcommand*{\gls@glsdefs@labellist}{} +% \end{macrocode} +%\end{macro} +% +%\begin{macro}{\gls@glsdefs@addlabel} +%\changes{4.47}{2021-09-20}{new} +% Save label of entry defined in \texttt{.glsdefs} file. +% \begin{macrocode} +\newcommand*{\gls@glsdefs@addlabel}[1]{\listxadd{\gls@glsdefs@labellist}{#1}} +% \end{macrocode} +%\end{macro} +% +%\begin{macro}{\gls@docdef@labellist} +%\changes{4.47}{2021-09-20}{new} +% List of labels of entries defined in the \env{document} environment. +% \begin{macrocode} +\newcommand*{\gls@docdef@labellist}{} +% \end{macrocode} +%\end{macro} +% +%\begin{macro}{\gls@docdef@addlabel} +%\changes{4.47}{2021-09-20}{new} +% Save label of entry defined in the \env{document} environment. +% \begin{macrocode} +\newcommand*{\gls@docdef@addlabel}[1]{\listxadd{\gls@docdef@labellist}{#1}} +% \end{macrocode} +%\end{macro} +% %\begin{macro}{\new@glossaryentry} %\changes{3.10a}{2013-10-13}{new} % For use in document environment. This opens the \texttt{.glsdefs} @@ -5726,11 +5821,55 @@ false,nolabel,autolabel,nameref}[nolabel]{% \immediate\openout\@gls@deffile=\jobname.glsdefs }% {}% - \ifglsentryexists{#1}{}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{allow overwrite if defined in \texttt{.glsdefs}} +% Don't check for existence since if the entry has been defined in +% the \texttt{.glsdefs} it will need to be redefined in case the +% entry has been updated, but keep track of which entries have been +% defined in the document environment to prevent duplicate +% definitions. +% \begin{macrocode} + \ifglsentryexists{#1}% + {% + \xifinlist{#1}{\gls@docdef@labellist}% + {% +% \end{macrocode} +% This entry has already been defined in the document environment. +% \begin{macrocode} + \GlossariesWarning{Entry `#1' has already been defined in the + document environment (ignoring new definition)}% + }% + {% + \xifinlist{#1}{\gls@glsdefs@labellist}% + {% +% \end{macrocode} +% This entry was defined in the \texttt{.glsdefs} file so update the +% definition in case it has been changed. +% \begin{macrocode} + \gls@defglossaryentry{#1}{#2}% + \gls@docdef@addlabel{#1}% + \@gls@writedef{#1}% + }% + {% +% \end{macrocode} +% This entry wasn't defined in the \texttt{.glsdefs} file so it must +% have been defined in the preamble. +% \begin{macrocode} + \GlossariesWarning{Entry `#1' has already been defined in + the preamble (in which case remove the duplicate definition) + or you have just updated to glossaries.sty + v4.47 (in which case delete `\jobname.glsdefs')}% + }% + }% + }% {% +% \end{macrocode} +% This entry hasn't been defined (new entry since last build). +% \begin{macrocode} \gls@defglossaryentry{#1}{#2}% + \gls@docdef@addlabel{#1}% + \@gls@writedef{#1}% }% - \@gls@writedef{#1}% } % \end{macrocode} %At the start of the document input the \texttt{.glsdefs} file if it @@ -5766,18 +5905,38 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} %\end{macro} % +%\begin{macro}{\glsdefs@newdocentry} +%\changes{4.47}{2021-09-20}{new} +% Used to define entries in the \texttt{.glsdefs} file. +% \begin{macrocode} +\newcommand*{\glsdefs@newdocentry}[2]{% + \ifglsentryexists{#1}% + {\GlossariesWarning{entry `#1' has already been defined in the preamble + (if you have moved the definition there from the document + environment, delete \jobname.glsdefs)}}% + {% + \gls@glsdefs@addlabel{#1}% + \gls@defglossaryentry{#1}{#2}% + }% +} +% \end{macrocode} +%\end{macro} +% %\begin{macro}{\@gls@writedef} %\changes{3.10a}{2013-10-13}{new} % Writes glossary entry definition to \cs{@gls@deffile}. +% Allow for the possibility that the entry definition may have been +% moved from the document environment to the preamble, so warn +% rather than generate an error. %\changes{4.03}{2014-01-20}{added \cs{glsdetoklabel}} +%\changes{4.47}{2021-09-20}{added a warning if entry has already been +%defined} % \begin{macrocode} \newcommand*{\@gls@writedef}[1]{% \immediate\write\@gls@deffile {% - \string\ifglsentryexists{#1}{}\glspercentchar^^J% - \expandafter\@gobble\string\{\glspercentchar^^J% - \string\gls@defglossaryentry{\glsdetoklabel{#1}}\glspercentchar^^J% - \expandafter\@gobble\string\{\glspercentchar% + \string\glsdefs@newdocentry{\glsdetoklabel{#1}}\glspercentchar^^J% + \expandafter\@gobble\string\{\glspercentchar% }% % \end{macrocode} % Write key value information: @@ -5803,9 +5962,8 @@ false,nolabel,autolabel,nameref}[nolabel]{% \glswritedefhook \immediate\write\@gls@deffile {% - \glspercentchar^^J% - \expandafter\@gobble\string\}\glspercentchar^^J% - \expandafter\@gobble\string\}\glspercentchar% + \glspercentchar^^J% + \expandafter\@gobble\string\}\glspercentchar^^J% }% } % \end{macrocode} @@ -6089,11 +6247,12 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\end{definition} %\changes{4.16}{2015-07-08}{new} %\changes{4.42}{2019-01-06}{changed from \cs{edef} to \cs{protected@csxdef}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand{\glsfieldxdef}[3]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \protected@csxdef{glo@\@glo@label @#2}{#3}% @@ -6112,11 +6271,12 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\end{definition} %\changes{4.16}{2015-07-08}{new} %\changes{4.42}{2019-01-06}{changed from \cs{edef} to \cs{protected@csedef}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand{\glsfieldedef}[3]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \protected@csedef{glo@\@glo@label @#2}{#3}% @@ -6134,11 +6294,12 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\cs{glsfieldgdef}\marg{label}\marg{field}\marg{definition} %\end{definition} %\changes{4.16}{2015-07-08}{new} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand{\glsfieldgdef}[3]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \expandafter\gdef\csname glo@\@glo@label @#2\endcsname{#3}% @@ -6156,11 +6317,12 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\cs{glsfielddef}\marg{label}\marg{field}\marg{definition} %\end{definition} %\changes{4.16}{2015-07-08}{new} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand{\glsfielddef}[3]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \expandafter\def\csname glo@\@glo@label @#2\endcsname{#3}% @@ -6180,11 +6342,12 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\changes{4.16}{2015-07-08}{new} % Fetches the value of the given field and stores in the given % control sequence. +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand{\glsfieldfetch}[3]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \letcs#3{glo@\@glo@label @#2}% @@ -6208,7 +6371,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% \newcommand{\ifglsfieldeq}[5]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \ifcsstring{glo@\@glo@label @#2}{#3}{#4}{#5}% @@ -6232,7 +6395,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% \newcommand{\ifglsfielddefeq}[5]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \expandafter\ifdefstrequal @@ -6252,11 +6415,12 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\end{definition} %\changes{4.16}{2015-07-08}{new} %As above but uses \cs{ifcsstrequal} instead of \cs{ifdefstrequal} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand{\ifglsfieldcseq}[5]{% \glsdoifexists{#1}% {% - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \ifcsdef{glo@\@glo@label @#2}% {% \ifcsstrequal{glo@\@glo@label @#2}{#3}{#4}{#5}% @@ -6341,8 +6505,9 @@ false,nolabel,autolabel,nameref}[nolabel]{% \let\GlsSetQuote\gls@nosetquote % \end{macrocode} % Store label +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% % \end{macrocode} % \changes{3.12a}{2013-10-16}{added \cs{glslabel}} % Provide a means for user defined keys to reference the label: @@ -6456,9 +6621,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} % Assign type. This must be fully expandable %\changes{4.03}{2014-01-20}{replaced \#1 with \cs{@glo@label}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \gls@assign@field{\glsdefaulttype}{\@glo@label}{type}{\@glo@type}% - \edef\@glo@type{\glsentrytype{\@glo@label}}% + \protected@edef\@glo@type{\glsentrytype{\@glo@label}}% % \end{macrocode} % Check to see if this glossary type has been defined, if it has, % add this label to the relevant list, otherwise generate an error. @@ -6490,7 +6656,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% {% }% \protected@edef\@glolist@{\csname glolist@\@glo@type\endcsname}% - \expandafter\xdef\csname glolist@\@glo@type\endcsname{% +% \end{macrocode} +%\changes{1.46}{2021-09-20}{changed \cs{xdef} to \cs{protected@xdef}} +% \begin{macrocode} + \expandafter\protected@xdef\csname glolist@\@glo@type\endcsname{% \@glolist@{\@glo@label},}% }% % \end{macrocode} @@ -6526,8 +6695,9 @@ false,nolabel,autolabel,nameref}[nolabel]{% {% % \end{macrocode} % Parent exists. Set \cs{glo@}\meta{label}"@parent". +%\changes{1.46}{2021-09-20}{changed \cs{xdef} to \cs{protected@xdef}} % \begin{macrocode} - \expandafter\xdef\csname glo@\@glo@label @parent\endcsname{% + \expandafter\protected@xdef\csname glo@\@glo@label @parent\endcsname{% \@glo@parent}% % \end{macrocode} % Determine level. @@ -6678,13 +6848,14 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} % Define an associated boolean variable to determine whether this % entry has been used yet (needs to be defined globally): +%\changes{1.46}{2021-09-20}{changed \cs{xdef} to \cs{protected@xdef}} % \begin{macrocode} - \expandafter\xdef\csname glo@\@glo@label @flagfalse\endcsname{% + \expandafter\protected@xdef\csname glo@\@glo@label @flagfalse\endcsname{% \noexpand\global \noexpand\let\expandafter\noexpand \csname ifglo@\@glo@label @flag\endcsname\noexpand\iffalse }% - \expandafter\xdef\csname glo@\@glo@label @flagtrue\endcsname{% + \expandafter\protected@xdef\csname glo@\@glo@label @flagtrue\endcsname{% \noexpand\global \noexpand\let\expandafter\noexpand \csname ifglo@\@glo@label @flag\endcsname\noexpand\iftrue @@ -6773,10 +6944,11 @@ false,nolabel,autolabel,nameref}[nolabel]{% % Moves entry whose label is given by first argument to the glossary % named in the second argument. %\changes{4.03}{2014-01-20}{added \cs{glsdetoklabel}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newcommand*{\glsmoveentry}[2]{% - \edef\@glo@thislabel{\glsdetoklabel{#1}}% - \edef\glo@type{\csname glo@\@glo@thislabel @type\endcsname}% + \protected@edef\@glo@thislabel{\glsdetoklabel{#1}}% + \protected@edef\glo@type{\csname glo@\@glo@thislabel @type\endcsname}% \def\glo@list{,}% \forglsentries[\glo@type]{\glo@label}% {% @@ -6785,7 +6957,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% %\cs{ifdefequal}} % \begin{macrocode} \ifdefequal\@glo@thislabel\glo@label - {}{\eappto\glo@list{\glo@label,}}% + {}{\protected@eappto\glo@list{\glo@label,}}% }% \cslet{glolist@\glo@type}{\glo@list}% \csdef{glo@\@glo@thislabel @type}{#2}% @@ -6841,8 +7013,9 @@ false,nolabel,autolabel,nameref}[nolabel]{% \newcommand{\@glo@storeentry}[1]{% % \end{macrocode} % Escape makeindex/xindy special characters in the label: +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \edef\@glo@esclabel{#1}% + \protected@edef\@glo@esclabel{#1}% \@gls@checkmkidxchars\@glo@esclabel % \end{macrocode} % Get the sort string and escape any special characters @@ -6859,7 +7032,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} % Get the parent, if one exists % \begin{macrocode} - \edef\@glo@parent{\csname glo@#1@parent\endcsname}% + \protected@edef\@glo@parent{\csname glo@#1@parent\endcsname}% % \end{macrocode} % Write the information to the glossary file. % \begin{macrocode} @@ -8498,9 +8671,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% % problem with tabularx). %\changes{2.03}{2009-09-23}{added \cs{leavevmode}} %\changes{4.03}{2014-01-20}{added \cs{glsdetoklabel}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \leavevmode - \edef\glslabel{\glsdetoklabel{#2}}% + \protected@edef\glslabel{\glsdetoklabel{#2}}% % \end{macrocode} % Save options in \cs{@gls@link@opts} and label in \cs{@gls@link@label} %\changes{4.03}{2014-01-20}{moved \cs{@gls@link@opts} and @@ -8511,7 +8685,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} % \begin{macrocode} \def\@glsnumberformat{glsnumberformat}% - \edef\@gls@counter{\csname glo@\glslabel @counter\endcsname}% + \protected@edef\@gls@counter{\csname glo@\glslabel @counter\endcsname}% % \end{macrocode} %\changes{3.05}{2013-04-21}{added check for ``nohypertypes''}% %\changes{3.07}{2013-07-05}{fixed bug that failed to find entry in list}% @@ -8519,7 +8693,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% % hyperlink by default %\changes{4.08}{2014-07-30}{renamed \cs{gls@type} to \cs{glstype}} % \begin{macrocode} - \edef\glstype{\csname glo@\glslabel @type\endcsname}% + \protected@edef\glstype{\csname glo@\glslabel @type\endcsname}% % \end{macrocode} %\changes{4.08}{2014-07-30}{removed redundancy} % Save original setting @@ -8785,6 +8959,19 @@ false,nolabel,autolabel,nameref}[nolabel]{% \def\@gls@checkedmkidx{}% \expandafter\@gls@checklevel#1\@nil!!\null \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{added check for \cs{"!} and backslash} +% \begin{macrocode} + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checkesclevel#1\@nil\!\!\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \def\@gls@checkedmkidx{}% + \edef\@do@gls@checkesc{% + \noexpand\@gls@checkesc\expandonce{#1}\noexpand\@nil + \@backslashchar\@backslashchar\noexpand\null + }% + \@do@gls@checkesc + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% \fi } % \end{macrocode} @@ -9032,6 +9219,40 @@ false,nolabel,autolabel,nameref}[nolabel]{% } % \end{macrocode} %\end{macro} +%\begin{macro}{\@gls@checkesc} +% and for \verb"\": +%\changes{4.47}{2021-09-20}{new} +% \begin{macrocode} +\bgroup +\catcode`\|0\relax +\catcode`\\12\relax +|gdef|@gls@checkesc#1\#2\#3|null{% + |@gls@tmpb=|expandafter{|@gls@checkedmkidx}% + |toks@={#1}% + |ifx|null#2|null + |ifx|null#3|null + |edef|@gls@checkedmkidx{|the|@gls@tmpb|the|toks@}% + |def|@@gls@checkesc{|relax}% + |else + |edef|@gls@checkedmkidx{|the|@gls@tmpb|the|toks@ + |@gls@quotechar|@backslashchar|@gls@quotechar|@backslashchar}% + |def|@@gls@checkesc{|@gls@checkesc#3|null}% + |fi + |else + |edef|@gls@checkedmkidx{|the|@gls@tmpb|the|toks@ + |@gls@quotechar|@backslashchar}% + |ifx|null#3|null + |def|@@gls@checkesc{|@gls@checkesc#2\\|null}% + |else + |def|@@gls@checkesc{|@gls@checkesc#2\#3|null}% + |fi + |fi + |@@gls@checkesc +} +|egroup +% \end{macrocode} +%\end{macro} +% % %\begin{macro}{\@gls@xdycheckquote} % As before but for use with \app{xindy} @@ -12210,8 +12431,9 @@ false,nolabel,autolabel,nameref}[nolabel]{% \bgroup % \end{macrocode} %\changes{4.03}{2014-01-20}{added \cs{glsdetoklabel}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \edef\@glo@label{\glsdetoklabel{#1}}% + \protected@edef\@glo@label{\glsdetoklabel{#1}}% \let\@org@glsnumberformat\glsnumberformat \def\glsnumberformat##1{##1}% \protected@edef\the@numberlist{% @@ -12316,7 +12538,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% \glsdoifexists{#2}% {% \def\@glsnumberformat{glsnumberformat}% - \edef\@gls@counter{\csname glo@\glsdetoklabel{#2}@counter\endcsname}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} +% \begin{macrocode} + \protected@edef\@gls@counter{\csname glo@\glsdetoklabel{#2}@counter\endcsname}% \setkeys{glossadd}{#1}% % \end{macrocode} % Store the entry's counter in \cs{theglsentrycounter} @@ -12358,9 +12583,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% % glossary types. %\begin{macro}{\glsaddall} %\changes{3.01}{2011-04-12}{made robust} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \newrobustcmd*{\glsaddall}[1][]{% - \edef\@glo@type{\@glo@types}% + \protected@edef\@glo@type{\@glo@types}% \setkeys{glossadd}{#1}% \forallglsentries[\@glo@type]{\@glo@entry}{% \glsadd[#1]{\@glo@entry}% @@ -13034,6 +13260,22 @@ false,nolabel,autolabel,nameref}[nolabel]{% \noexpand!\noexpand!\noexpand\null \noexpand\expandafter\noexpand\@gls@updatechecked \noexpand\@gls@checkedmkidx{####1}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{added check for \cs{"!}} +% \begin{macrocode} + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkesclevel####1\noexpand\@nil + \noexpand\!\noexpand\!\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{added check for backslash} +% \begin{macrocode} + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkesc####1\noexpand\@nil + \@backslashchar\@backslashchar\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% }% }% \@gls@docheckquotedef @@ -13409,19 +13651,7 @@ false,nolabel,autolabel,nameref}[nolabel]{% % \end{macrocode} % Activate warning about missing \cs{printglossary} % \begin{macrocode} - \def\warn@noprintglossary{% - \ifdefstring{\@glo@types}{,}% - {% - \GlossariesWarningNoLine{No glossaries have been defined}% - }% - {% - \GlossariesWarningNoLine{No \string\printglossary\space - or \string\printglossaries\space - found. ^^J(Remove \string\makeglossaries\space if you - don't want any glossaries.) ^^JThis document will not - have a glossary}% - }% - }% + \let\warn@noprintglossary\@makeglossaries@warn@noprintglossary % \end{macrocode} % Declare list parser for \cs{glsdisplaynumberlist} %\changes{3.02}{2012-05-21}{added list parser} @@ -13465,6 +13695,26 @@ false,nolabel,autolabel,nameref}[nolabel]{% \@onlypreamble{\makeglossaries} % \end{macrocode} %\end{macro} +% +%\begin{macro}{\@makeglossaries@warn@noprintglossary} +%\changes{4.47}{??}{new} +% \begin{macrocode} +\newcommand\@makeglossaries@warn@noprintglossary{% + \ifdefstring{\@glo@types}{,}% + {% + \GlossariesWarningNoLine{No glossaries have been defined}% + }% + {% + \GlossariesWarningNoLine{No \string\printglossary\space + or \string\printglossaries\space + found. ^^J(Remove \string\makeglossaries\space if you + don't want any glossaries.) ^^JThis document will not + have a glossary}% + }% +}% +% \end{macrocode} +%\end{macro} +% %\begin{macro}{\glswrite} % The definition of \cs{glswrite} has now been moved to % \cs{makeglossaries} so that it's only defined if needed. @@ -13520,9 +13770,10 @@ false,nolabel,autolabel,nameref}[nolabel]{% \let\gls@checkseeallowed\relax % \end{macrocode} % Redefine cross-referencing macro: +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \renewcommand{\@do@seeglossary}[2]{% - \edef\@gls@label{\glsdetoklabel{##1}}% + \protected@edef\@gls@label{\glsdetoklabel{##1}}% \protected@write\@auxout{}{% \string\@gls@reference {\csname glo@\@gls@label @type\endcsname}% @@ -14005,11 +14256,12 @@ you % command that takes a \TeX\ register as the argument % (\verb|\|\meta{csname}\verb|\c@page| must be valid). %\changes{4.11}{2014-09-01}{new} +%\changes{1.46}{2021-09-20}{changed \cs{eappto} to \cs{protected@eappto}} % \begin{macrocode} \newcommand*{\glsaddprotectedpagefmt}[1]{% - \eappto\gls@protected@pagefmts{,\expandonce{\csname gls#1page\endcsname}}% + \protected@eappto\gls@protected@pagefmts{,\expandonce{\csname gls#1page\endcsname}}% \csedef{gls#1page}{\expandonce{\csname#1\endcsname}\noexpand\c@page}% - \eappto\@wrglossarynumberhook{% + \protected@eappto\@wrglossarynumberhook{% \noexpand\let\expandonce{\csname org@gls#1\endcsname}% \expandonce{\csname#1\endcsname}% \noexpand\def\expandonce{\csname#1\endcsname}{% @@ -14085,8 +14337,9 @@ you % \end{macrocode} % De-tok label if required. %\changes{4.03}{2014-01-20}{added \cs{glsdetoklabel}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \edef\@gls@label{\glsdetoklabel{#1}}% + \protected@edef\@gls@label{\glsdetoklabel{#1}}% % \end{macrocode} % Write the information to file: % \begin{macrocode} @@ -14271,8 +14524,9 @@ you % \end{macrocode} % De-tok label if required %\changes{4.03}{2014-01-20}{added \cs{glsdetoklabel}} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \edef\@gls@label{\glsdetoklabel{#1}}% + \protected@edef\@gls@label{\glsdetoklabel{#1}}% % \end{macrocode} % Write the information to file: % \begin{macrocode} @@ -14543,7 +14797,10 @@ you \newcommand*{\gls@save@numberlist}[1]{% \ifglssavenumberlist \toks@{#1}% - \edef\@do@writeaux@info{% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} +% \begin{macrocode} + \protected@edef\@do@writeaux@info{% \noexpand\csgdef{glo@\glscurrententrylabel @numberlist}{\the\toks@}% }% \@onelevel@sanitize\@do@writeaux@info @@ -14797,15 +15054,16 @@ you % new \cs{glossentry} and \cs{subglossentry}, but this is now only % needed for backward compatibility): %\changes{4.03}{2014-01-20}{added \cs{glsdetoklabel}} +%\changes{1.46}{2021-09-20}{changed \cs{xdef} to \cs{protected@xdef}} % \begin{macrocode} \let\gls@org@glossaryentryfield\glossentry \let\gls@org@glossarysubentryfield\subglossentry \renewcommand{\glossentry}[1]{% - \xdef\glscurrententrylabel{\glsdetoklabel{##1}}% + \protected@xdef\glscurrententrylabel{\glsdetoklabel{##1}}% \gls@org@glossaryentryfield{##1}% }% \renewcommand{\subglossentry}[2]{% - \xdef\glscurrententrylabel{\glsdetoklabel{##2}}% + \protected@xdef\glscurrententrylabel{\glsdetoklabel{##2}}% \gls@org@glossarysubentryfield{##1}{##2}% }% % \end{macrocode} @@ -14941,7 +15199,10 @@ you \glosortentrieswarning \def\@glo@sortinglist{}% \def\@glo@sortinghandler{#1}% - \edef\@glo@type{#2}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} +% \begin{macrocode} + \protected@edef\@glo@type{#2}% \forlistcsloop{\@glo@do@sortentries}{@glsref@#2}% \csdef{@glsref@#2}{}% \@for\@this@label:=\@glo@sortinglist\do{% @@ -15007,8 +15268,9 @@ you {% % \end{macrocode} % This entry has a parent, so add it to the child list +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} - \edef\@glo@parent{\csuse{glo@\glsdetoklabel{#1}@parent}}% + \protected@edef\@glo@parent{\csuse{glo@\glsdetoklabel{#1}@parent}}% \ifcsundef{@glo@sortingchildren@\@glo@parent}% {% \csdef{@glo@sortingchildren@\@glo@parent}{}% @@ -15331,6 +15593,7 @@ you % %\begin{macro}{\glo@grabfirst} %\changes{4.04}{2014-03-06}{new} +%This won't work for UTF-8 and \sty{inputenc}. % \begin{macrocode} \def\glo@grabfirst#1#2\@nil{% \def\@gls@firsttok{#1}% @@ -15843,7 +16106,10 @@ you % \begin{macrocode} \newcommand*{\glsstepsubentry}[1]{% \ifglssubentrycounter - \edef\currentglssubentry{\glsdetoklabel{#1}}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} +% \begin{macrocode} + \protected@edef\currentglssubentry{\glsdetoklabel{#1}}% \refstepcounter{glossarysubentry}% \label{\GlsEntryCounterLabelPrefix\currentglssubentry}% \fi @@ -16506,8 +16772,11 @@ you \def\@gls@removespaces#1 #2\@nil{% \toks@=\expandafter{\the\toks@#1}% \ifx\\#2\\% - \edef\x{\the\toks@}% - \ifx\x\empty +% \end{macrocode} +%\changes{4.47}{2021-09-20}{changed \cs{x} to \cs{@gls@x}} +% \begin{macrocode} + \edef\@gls@x{\the\toks@}% + \ifx\@gls@x\empty \else % \end{macrocode} %\changes{3.0}{2011-04-02}{added prefix to hyperlink} @@ -18001,9 +18270,50 @@ you \let\gls@assign@firstpl\@org@gls@assign@firstpl \let\gls@assign@plural\@org@gls@assign@plural \let\gls@assign@symbolplural\@org@gls@assign@symbolplural +% \end{macrocode} +% If expansion is switched off, the default plurals won't be properly set. +% \begin{macrocode} + \@@gls@noexpand@assign@default@plurals +} +% \end{macrocode} +%\end{macro} +%\begin{macro}{\@@gls@noexpand@assign@default@plurals} +%\changes{4.47}{2021-09-20}{new} +% \begin{macrocode} +\newcommand*{\@@gls@noexpand@assign@default@plurals}{% + \expandafter\ifx\csname glo@\the\glslabeltok @plural\endcsname\@@gls@@default@acr@plural + \csxdef{glo@\the\glslabeltok @plural}{\expandonce\@glo@shortpl}% + \fi + \expandafter\ifx\csname glo@\the\glslabeltok @firstpl\endcsname\@@gls@@default@acr@firstplural + \csxdef{glo@\the\glslabeltok @firstpl}{% + \expandonce\@glo@longpl\glsspace(\expandonce\@glo@shortpl)}% + \fi + \expandafter\ifx\csname glo@\the\glslabeltok @descplural\endcsname\@@gls@@default@acr@descplural + \csxdef{glo@\the\glslabeltok @descplural}{\expandonce\@glo@longpl}% + \fi } % \end{macrocode} %\end{macro} +%\begin{macro}{\@@gls@@default@acr@plural} +%\changes{4.47}{2021-09-20}{new} +% \begin{macrocode} +\newcommand*{\@@gls@@default@acr@plural}{\expandonce\@glo@shortpl} +% \end{macrocode} +%\end{macro} +%\begin{macro}{\@@gls@@default@acr@firstplural} +%\changes{4.47}{2021-09-20}{new} +% \begin{macrocode} +\newcommand*{\@@gls@@default@acr@firstplural}{% + \expandonce\@glo@longpl\glsspace(\expandonce\@glo@shortpl)% +} +% \end{macrocode} +%\end{macro} +%\begin{macro}{\@@gls@@default@acr@descplural} +%\changes{4.47}{2021-09-20}{new} +% \begin{macrocode} +\newcommand*{\@@gls@@default@acr@descplural}{\expandonce\@glo@longpl} +% \end{macrocode} +%\end{macro} %\begin{macro}{\SetDefaultAcronymStyle} %\changes{2.04}{2009-11-10}{new} % Set up the default acronym style: @@ -18151,8 +18461,23 @@ you % key. Note that since the long form is stored in the symbol key, % if you want the long form to appear in the list of acronyms, you % need to use a glossary style that displays the symbol key. +% This style was deprecated with the introduction of +% \cs{newacronymstyle}. +%\changes{4.47}{2021-09-20}{added deprecated warnings} % \begin{macrocode} \newcommand*{\SetDescriptionFootnoteAcronymStyle}{% + \ifglsacrsmallcaps + \@gls@deprecated@acr@warning{footnote,smallcaps,description}% + {footnote-sc-desc}{short-sc-footnote-desc}% + \else + \ifglsacrsmaller + \@gls@deprecated@acr@warning{footnote,smaller,description}% + {footnote-sm-desc}{short-sm-footnote-desc}% + \else + \@gls@deprecated@acr@warning{footnote,description}% + {footnote-desc}{short-footnote-desc}% + \fi + \fi \renewcommand{\newacronym}[4][]{% \ifx\@glsacronymlists\@empty \def\@glo@type{\acronymtype}% @@ -18264,6 +18589,9 @@ you % Note that the short form is stored in the \gloskey{symbol} key, % so if the short form needs to be displayed in the glossary, % use a style the displays the symbol. +% This style was deprecated with the introduction of +% \cs{newacronymstyle}. +%\changes{4.47}{2021-09-20}{added deprecated warning} % \begin{macrocode} \newcommand*{\SetDescriptionDUAAcronymStyle}{% \ifglsacrsmallcaps @@ -18275,6 +18603,7 @@ you can't both be set}{}% \fi \fi + \@gls@deprecated@acr@warning{dua,description}{dua-desc}{long-noshort-desc}% \renewcommand{\newacronym}[4][]{% \ifx\@glsacronymlists\@empty \def\@glo@type{\acronymtype}% @@ -18399,6 +18728,18 @@ you % list of acronyms. % \begin{macrocode} \newcommand*{\SetDescriptionAcronymStyle}{% + \ifglsacrsmallcaps + \@gls@deprecated@acr@warning{smallcaps,description}% + {long-sc-short-desc}{long-short-sc-desc}% + \else + \ifglsacrsmaller + \@gls@deprecated@acr@warning{smaller,description}% + {long-sm-short-desc}{long-short-sm-desc}% + \else + \@gls@deprecated@acr@warning{description}% + {long-short-desc}{long-short-desc}% + \fi + \fi \renewcommand{\newacronym}[4][]{% \ifx\@glsacronymlists\@empty \def\@glo@type{\acronymtype}% @@ -18531,8 +18872,20 @@ you % use to append the long form (stored in \gloskey{description}) as a % footnote. % Use the \gloskey{description} key to store the long form. +% This style was deprecated with the introduction of +% \cs{newacronymstyle}. +%\changes{4.47}{2021-09-20}{added deprecated warnings} % \begin{macrocode} \newcommand*{\SetFootnoteAcronymStyle}{% + \ifglsacrsmallcaps + \@gls@deprecated@acr@warning{footnote,smallcaps}{footnote-sc}{short-sc-footnote}% + \else + \ifglsacrsmaller + \@gls@deprecated@acr@warning{footnote,smaller}{footnote-sm}{short-sm-footnote}% + \else + \@gls@deprecated@acr@warning{footnote}{footnote}{short-footnote}% + \fi + \fi \renewcommand{\newacronym}[4][]{% \ifx\@glsacronymlists\@empty \def\@glo@type{\acronymtype}% @@ -18713,8 +19066,16 @@ you % smaller specified. % Use the \gloskey{symbol} key to store the short form and % \gloskey{first} to store the long form. +% This style was deprecated with the introduction of +% \cs{newacronymstyle}. +%\changes{4.47}{2021-09-20}{added deprecated warnings} % \begin{macrocode} \newcommand*{\SetSmallAcronymStyle}{% + \ifglsacrsmallcaps + \@gls@deprecated@acr@warning{smallcaps}{long-sc-short}{long-short-sc}% + \else + \@gls@deprecated@acr@warning{smaller}{long-sm-short}{long-short-sm}% + \fi \renewcommand{\newacronym}[4][]{% \ifx\@glsacronymlists\@empty \def\@glo@type{\acronymtype}% @@ -18825,8 +19186,12 @@ you %\end{macro} %\begin{macro}{\SetDUAStyle} % Always expand acronyms. +% This style was deprecated with the introduction of +% \cs{newacronymstyle}. +%\changes{4.47}{2021-09-20}{added deprecated warnings} % \begin{macrocode} \newcommand*{\SetDUAStyle}{% + \@gls@deprecated@acr@warning{dua}{dua}{long-noshort}% \renewcommand{\newacronym}[4][]{% \ifx\@glsacronymlists\@empty \def\@glo@type{\acronymtype}% @@ -18851,6 +19216,18 @@ you % \end{macrocode} %\end{macro} % +%\begin{macro}{\@gls@deprecated@acr@warning} +%\changes{4.47}{2021-09-20}{new} +% \begin{macrocode} +\newcommand*{\@gls@deprecated@acr@warning}[3]{% + \GlossariesWarning{Acronym style option #1 deprecated. + Use \string\setacronymstyle{#2} with just glossaries.sty or + use \string\setabbreviationstyle[acronym]{#3} with + glossaries-extra.sty}% +} +% \end{macrocode} +%\end{macro} +% %\begin{macro}{\SetAcronymStyle} % \begin{macrocode} \newcommand*{\SetAcronymStyle}{% @@ -19488,7 +19865,7 @@ you % \cs{gls}\marg{label}} on subsequent use. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-prefix}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossaries-prefix}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Pass all options to \sty{glossaries}: % \begin{macrocode} @@ -19953,7 +20330,7 @@ you %\label{sec:code:hypernav} % Package Definition: % \begin{macrocode} -\ProvidesPackage{glossary-hypernav}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-hypernav}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % % The commands defined in this package are provided to @@ -19975,7 +20352,10 @@ you %\cs{@glslink}} % \begin{macrocode} \newcommand*{\glsnavhyperlink}[3][\@glo@type]{% - \edef\gls@grplabel{#2}\protected@edef\@gls@grptitle{#3}% +% \end{macrocode} +%\changes{4.47}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} +% \begin{macrocode} + \protected@edef\gls@grplabel{#2}\protected@edef\@gls@grptitle{#3}% \@glslink{\glsnavhyperlinkname{#1}{#2}}{#3}} % \end{macrocode} %\end{macro} @@ -20149,7 +20529,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/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-inline}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % %\begin{style}{inline} @@ -20340,7 +20720,7 @@ you % \ics{item} command, it will appear in a bold font by % default. % \begin{macrocode} -\ProvidesPackage{glossary-list}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-list}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} %\begin{macro}{\indexspace} %\changes{4.13}{2015-02-03}{new} @@ -20622,7 +21002,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/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-long}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Requires the \isty{longtable} package: % \begin{macrocode} @@ -21119,7 +21499,7 @@ you % \url{http://tex.stackexchange.com/a/56890} % % \begin{macrocode} -\ProvidesPackage{glossary-longbooktabs}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-longbooktabs}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Requires \sty{booktabs} package: % \begin{macrocode} @@ -21460,7 +21840,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/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-longragged}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Requires the \isty{array} package: % \begin{macrocode} @@ -21893,7 +22273,7 @@ you %use the \sty{multicol} package. These use the tree-like glossary %styles in a multicol environment. % \begin{macrocode} -\ProvidesPackage{glossary-mcols}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-mcols}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Required packages: % \begin{macrocode} @@ -22330,7 +22710,7 @@ you % The glossary styles defined in the \isty{glossary-super} package % use the \env{supertabular} environment. % \begin{macrocode} -\ProvidesPackage{glossary-super}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-super}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Requires the \isty{supertabular} package: % \begin{macrocode} @@ -22862,7 +23242,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/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-superragged}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Requires the \isty{array} package: % \begin{macrocode} @@ -23302,7 +23682,7 @@ you % that have a tree-like structure. These are designed for % hierarchical glossaries. % \begin{macrocode} -\ProvidesPackage{glossary-tree}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossary-tree}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % %\begin{macro}{\indexspace} @@ -24023,7 +24403,7 @@ you % hyperlinks may not work properly. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-compatible-207}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossaries-compatible-207}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} %\begin{macro}{\GlsAddXdyAttribute} % Adds an attribute in old format. @@ -24384,7 +24764,7 @@ you %\section{glossaries-compatible-307} % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-compatible-307}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossaries-compatible-307}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % % Compatibility macros for predefined glossary styles: @@ -25192,7 +25572,7 @@ you % \end{macrocode} % Package version number now in line with main glossaries package number. % \begin{macrocode} -\ProvidesPackage{glossaries-accsupp}[2020/03/19 v4.46 (NLCT) +\ProvidesPackage{glossaries-accsupp}[2021/09/20 v4.47 (NLCT) Experimental glossaries accessibility] % \end{macrocode} % Pass all options to \sty{glossaries}: @@ -28103,9 +28483,10 @@ you % % Use \cs{newacronymhook} to modify the key list to set % the access text to the long version by default. +%\changes{1.46}{2021-09-20}{changed \cs{edef} to \cs{protected@edef}} % \begin{macrocode} \renewcommand*{\newacronymhook}{% - \edef\@gls@keylist{% + \protected@edef\@gls@keylist{% shortaccess={\glsdefaultshortaccess{\the\glslongtok}{\the\glsshorttok}},% shortpluralaccess={\glsdefaultshortaccess{\the\glslongtok}{\the\glsshorttok}},% \the\glskeylisttok}% @@ -28163,6 +28544,7 @@ you \let\gls@assign@firstpl\@org@gls@assign@firstpl \let\gls@assign@plural\@org@gls@assign@plural \let\gls@assign@symbolplural\@org@gls@assign@symbolplural + \@@gls@noexpand@assign@default@plurals } % \end{macrocode} %\end{macro} @@ -28498,7 +28880,7 @@ you % modules. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-babel}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossaries-babel}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Load \sty{tracklang} to obtain language settings. % \begin{macrocode} @@ -28542,7 +28924,7 @@ you % modules. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{glossaries-polyglossia}[2020/03/19 v4.46 (NLCT)] +\ProvidesPackage{glossaries-polyglossia}[2021/09/20 v4.47 (NLCT)] % \end{macrocode} % Load \sty{tracklang} to obtain language settings. % \begin{macrocode} @@ -28882,6 +29264,181 @@ risus ut urna} %\fi %\iffalse % \begin{macrocode} +%<*example-glossaries-childmultipar.tex> +% \end{macrocode} +%\fi +%\iffalse +% \begin{macrocode} +%<<COMMENT +% This file is part of the glossaries bundle. +% These are test glossary entries with child entries that have +% multi-paragraph descriptions. One parent entry also has a +% multi-paragraph description. Some entries have an associated +% image file (stored in user1). The referenced image files are +% provided by the mwe package. +%COMMENT + +\newglossaryentry{hiersedmattis}{name={sed mattis},user1={example-image}, + description={Erat sit amet dolor sit amet, consectetuer adipiscing elit. Ut purus +elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur +dictum gravida mauris. Ut pellentesque augue sed urna. Vestibulum +diam eros, fringilla et, consectetuer eu, nonummy id, sapien. Nullam +at lectus. In sagittis ultrices mauris. Curabitur malesuada erat sit +amet massa. Fusce blandit. Aliquam erat volutpat.}} + + +\longnewglossaryentry{hierloremi-ii} +{name={lorem 1--2},parent={hiersedmattis}}% +{% +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, +vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur +dictum gravida mauris. Nam arcu libero, nonummy eget, consectetuer +id, vulputate a, magna. Donec vehicula augue eu neque. Pellentesque +habitant morbi tristique senectus et netus et malesuada fames ac +turpis egestas. Mauris ut leo. Cras viverra metus rhoncus sem. Nulla +et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus +sit amet tortor gravida placerat. Integer sapien est, iaculis in, +pretium quis, viverra ac, nunc. Praesent eget sem vel leo ultrices +bibendum. Aenean faucibus. Morbi dolor nulla, malesuada eu, pulvinar +at, mollis ac, nulla. Curabitur auctor semper nulla. Donec varius +orci eget risus. Duis nibh mi, congue eu, accumsan eleifend, +sagittis quis, diam. Duis eget orci sit amet orci dignissim rutrum. + +Nam dui ligula, fringilla a, euismod sodales, sollicitudin vel, +wisi. Morbi auctor lorem non justo. Nam lacus libero, pretium at, +lobortis vitae, ultricies et, tellus. Donec aliquet, tortor sed +accumsan bibendum, erat ligula aliquet magna, vitae ornare odio +metus a mi. Morbi ac orci et nisl hendrerit mollis. Suspendisse ut +massa. Cras nec ante. Pellentesque a nulla. Cum sociis natoque +penatibus et magnis dis parturient montes, nascetur ridiculus mus. +Aliquam tincidunt urna. Nulla ullamcorper vestibulum turpis. +Pellentesque cursus luctus mauris.% +} + +\longnewglossaryentry{hierloremiii-iv} +{name={lorem 3--4},parent={hiersedmattis},user1={example-image}}% +{% +Nulla malesuada porttitor diam. Donec felis erat, congue non, +volutpat at, tincidunt tristique, libero. Vivamus viverra fermentum +felis. Donec nonummy pellentesque ante. Phasellus adipiscing semper +elit. Proin fermentum massa ac quam. Sed diam turpis, molestie +vitae, placerat a, molestie nec, leo. Maecenas lacinia. Nam ipsum +ligula, eleifend at, accumsan nec, suscipit a, ipsum. Morbi blandit +ligula feugiat magna. Nunc eleifend consequat lorem. Sed lacinia +nulla vitae enim. Pellentesque tincidunt purus vel magna. Integer +non enim. Praesent euismod nunc eu purus. Donec bibendum quam in +tellus. Nullam cursus pulvinar lectus. Donec et mi. Nam vulputate +metus eu enim. Vestibulum pellentesque felis eu massa. + +Quisque ullamcorper placerat ipsum. Cras nibh. Morbi vel justo +vitae lacus tincidunt ultrices. Lorem ipsum dolor sit amet, +consectetuer adipiscing elit. In hac habitasse platea dictumst. +Integer tempus convallis augue. Etiam facilisis. Nunc elementum +fermentum wisi. Aenean placerat. Ut imperdiet, enim sed gravida +sollicitudin, felis odio placerat quam, ac pulvinar elit purus eget +enim. Nunc vitae tortor. Proin tempus nibh sit amet nisl. Vivamus +quis tortor vitae risus porta vehicula.% +} + +\longnewglossaryentry{hierloremv-vi} +{name={lorem 5--6},parent={hiersedmattis}}% +{% +Fusce mauris. Vestibulum luctus nibh at lectus. Sed bibendum, nulla +a faucibus semper, leo velit ultricies tellus, ac venenatis arcu +wisi vel nisl. Vestibulum diam. Aliquam pellentesque, augue quis +sagittis posuere, turpis lacus congue quam, in hendrerit risus eros +eget felis. Maecenas eget erat in sapien mattis porttitor. +Vestibulum porttitor. Nulla facilisi. Sed a turpis eu lacus commodo +facilisis. Morbi fringilla, wisi in dignissim interdum, justo lectus +sagittis dui, et vehicula libero dui cursus dui. Mauris tempor +ligula sed lacus. Duis cursus enim ut augue. Cras ac magna. Cras +nulla. Nulla egestas. Curabitur a leo. Quisque egestas wisi eget +nunc. Nam feugiat lacus vel est. Curabitur consectetuer.% + +Suspendisse vel felis. Ut lorem lorem, interdum eu, tincidunt sit +amet, laoreet vitae, arcu. Aenean faucibus pede eu ante. Praesent +enim elit, rutrum at, molestie non, nonummy vel, nisl. Ut lectus +eros, malesuada sit amet, fermentum eu, sodales cursus, magna. Donec +eu purus. Quisque vehicula, urna sed ultricies auctor, pede lorem +egestas dui, et convallis elit erat sed nulla. Donec luctus. +Curabitur et nunc. Aliquam dolor odio, commodo pretium, ultricies +non, pharetra in, velit. Integer arcu est, nonummy in, fermentum +faucibus, egestas vel, odio.% +} + +\longnewglossaryentry{hiergravida}{name={gravida}} +{Malesuada libero, nonummy eget, consectetuer id, vulputate a, magna. Donec +vehicula augue eu neque. Pellentesque habitant morbi tristique +senectus et netus et malesuada fames ac turpis egestas. Mauris ut +leo. + +Morbi ultrices rutrum lorem. Nam elementum ullamcorper +leo. Morbi dui. Aliquam sagittis. Nunc placerat. Pellentesque +tristique sodales est. Maecenas imperdiet lacinia velit. Cras non +urna. Morbi eros pede, suscipit ac, varius vel, egestas non, eros.} + +\longnewglossaryentry{hierloremvii-viii} +{name={lorem 7--8},parent={hiergravida},user1={example-image-b}}% +{% +Sed commodo posuere pede. Mauris ut est. Ut quis purus. Sed ac odio. +Sed vehicula hendrerit sem. Duis non odio. Morbi ut dui. Sed +accumsan risus eget odio. In hac habitasse platea dictumst. +Pellentesque non elit. Fusce sed justo eu urna porta tincidunt. +Mauris felis odio, sollicitudin sed, volutpat a, ornare ac, erat. +Morbi quis dolor. Donec pellentesque, erat ac sagittis semper, nunc +dui lobortis purus, quis congue purus metus ultricies tellus. Proin +et quam. Class aptent taciti sociosqu ad litora torquent per conubia +nostra, per inceptos hymenaeos. Praesent sapien turpis, fermentum +vel, eleifend faucibus, vehicula eu, lacus. + +Pellentesque habitant morbi tristique senectus et netus et malesuada +fames ac turpis egestas. Donec odio elit, dictum in, hendrerit sit +amet, egestas sed, leo. Praesent feugiat sapien aliquet odio. +Integer vitae justo. Aliquam vestibulum fringilla lorem. Sed neque +lectus, consectetuer at, consectetuer sed, eleifend ac, lectus. +Nulla facilisi. Pellentesque eget lectus. Proin eu metus. Sed +porttitor. In hac habitasse platea dictumst. Suspendisse eu lectus. +Ut mi mi, lacinia sit amet, placerat et, mollis vitae, dui. Sed ante +tellus, tristique ut, iaculis eu, malesuada ac, dui. Mauris nibh +leo, facilisis non, adipiscing quis, ultrices a, dui.% +} + +\longnewglossaryentry{hierloremix-x} +{name={lorem 9--10},parent={hiergravida},user1={example-image-c}}% +{% +Morbi luctus, wisi viverra faucibus pretium, nibh est placerat odio, +nec commodo wisi enim eget quam. Quisque libero justo, consectetuer +a, feugiat vitae, porttitor eu, libero. Suspendisse sed mauris +vitae elit sollicitudin malesuada. Maecenas ultricies eros sit amet +ante. Ut venenatis velit. Maecenas sed mi eget dui varius euismod. +Phasellus aliquet volutpat odio. Vestibulum ante ipsum primis in +faucibus orci luctus et ultrices posuere cubilia Curae; Pellentesque +sit amet pede ac sem eleifend consectetuer. Nullam elementum, urna +vel imperdiet sodales, elit ipsum pharetra ligula, ac pretium ante +justo a nulla. Curabitur tristique arcu eu metus. Vestibulum lectus. +Proin mauris. Proin eu nunc eu urna hendrerit faucibus. Aliquam +auctor, pede consequat laoreet varius, eros tellus scelerisque quam, +pellentesque hendrerit ipsum dolor sed augue. Nulla nec lacus. + +Suspendisse vitae elit. Aliquam arcu neque, ornare in, ullamcorper +quis, commodo eu, libero. Fusce sagittis erat at erat tristique +mollis. Maecenas sapien libero, molestie et, lobortis in, sodales +eget, dui. Morbi ultrices rutrum lorem. Nam elementum ullamcorper +leo. Morbi dui. Aliquam sagittis. Nunc placerat. Pellentesque +tristique sodales est. Maecenas imperdiet lacinia velit. Cras non +urna. Morbi eros pede, suscipit ac, varius vel, egestas non, eros. +Praesent malesuada, diam id pretium elementum, eros sem dictum +tortor, vel consectetuer odio sem sed wisi.% +} +% \end{macrocode} +%\fi +%\iffalse +% \begin{macrocode} +%</example-glossaries-childmultipar.tex> +% \end{macrocode} +%\fi +%\iffalse +% \begin{macrocode} %<*example-glossaries-childnoname.tex> % \end{macrocode} %\fi @@ -29470,6 +30027,140 @@ bibendum quam in tellus.}} %\fi %\iffalse % \begin{macrocode} +%<*example-glossaries-longchild.tex> +% \end{macrocode} +%\fi +%\iffalse +% \begin{macrocode} +%<<COMMENT +% This file is part of the glossaries bundle +% These are test glossary entries with child entries and long +% descriptions. +%COMMENT + +\newglossaryentry{longsedmattis}{name={sed mattis}, + description={erat sit amet dolor sit amet, consectetuer adipiscing elit. Ut purus +elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur +dictum gravida mauris.}} + +\newglossaryentry{longgravida}{parent={longsedmattis},name={gravida}, + description={malesuada libero, nonummy eget, consectetuer id, vulputate a, magna. Donec +vehicula augue eu neque. Pellentesque habitant morbi tristique +senectus et netus et malesuada fames ac turpis egestas. Mauris ut +leo.}} + +\newglossaryentry{longelitaugue}{parent={longsedmattis},name={elit augue}, +description={egestas diam metus rhoncus sem. Nulla et lectus vestibulum +urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida +placerat.}} + +\newglossaryentry{longtempus}{parent={longsedmattis},name={tempus}, +description={scelerisque est, iaculis in, pretium quis, viverra ac, +nunc. Praesent eget sem vel leo ultrices bibendum. Aenean +faucibus.}} + +\newglossaryentry{longnunc}{name={nunc}, + description={nisl vitae nulla, malesuada eu, pulvinar at, mollis ac, nulla. +Curabitur auctor semper nulla. Donec varius orci eget risus. Duis +nibh mi, congue eu, accumsan eleifend, sagittis quis, diam. Duis +eget orci sit amet orci dignissim rutrum.}} + +\newglossaryentry{longlibero}{parent={longnunc},name={libero}, + description={sed consequat ligula, fringilla a, euismod sodales, +sollicitudin vel, wisi. Morbi auctor lorem non justo.}} + +\newglossaryentry{longfeugiat}{parent={longnunc},name={feugiat}, + description={massa libero, pretium at, lobortis vitae, ultricies et, +tellus. Donec aliquet, tortor sed accumsan bibendum, erat ligula aliquet magna, +vitae ornare odio metus a mi.}} + +\newglossaryentry{longporta}{parent={longnunc},name={porta}, + description={eros in eleifend orci et nisl hendrerit mollis. Suspendisse ut massa. +Cras nec ante. Pellentesque a nulla. Cum sociis natoque penatibus +et magnis dis parturient montes, nascetur ridiculus mus.}} + +\newglossaryentry{longvariuserat}{parent={longnunc},name={varius erat}, +description={leo rutrum dui tincidunt urna. Nulla ullamcorper +vestibulum turpis. Pellentesque cursus luctus mauris.}} + +\newglossaryentry{longnonconvallis}{name={non convallis}, + description={lectus orci ut nibh porttitor diam. Donec felis erat, +congue non, volutpat at, tincidunt tristique, libero. Vivamus +viverra fermentum felis.}} + +\newglossaryentry{longsedlorem}{parent={longnonconvallis},name={sedlorem}, + description={massa pellentesque ante. Phasellus +adipiscing semper elit. Proin fermentum massa ac quam. Sed diam +turpis, molestie vitae, placerat a, molestie nec, leo.}} + +\newglossaryentry{longnonummyquis}{parent={longnonconvallis},name={nonummy +quis}, description={egestas id nam ipsum ligula, eleifend at, accumsan nec, suscipit +a, ipsum. Morbi blandit ligula feugiat magna. Nunc eleifend consequat +lorem.}} + +\newglossaryentry{longcondimentum}{name={condimentum}, + description={at nisl nulla vitae enim. Pellentesque tincidunt purus +vel magna. Integer non enim. Praesent euismod nunc eu purus. Donec +bibendum quam in tellus.}} + +\newglossaryentry{longmaecenas}{parent={longcondimentum},name={maecenas}, +description={at nibh fringilla a, euismod sodales, sollicitudin vel, +wisi. Morbi auctor lorem non justo. Nam lacus libero, pretium at, +lobortis vitae, ultricies et, tellus. Donec aliquet, tortor sed +accumsan bibendum, erat ligula aliquet magna, vitae ornare odio +metus a mi. Morbi ac orci et nisl hendrerit mollis. Suspendisse ut +massa. Cras nec ante. Pellentesque a nulla. Cum sociis natoque +penatibus et magnis dis parturient montes, nascetur ridiculus mus. +Aliquam tincidunt urna. Nulla ullamcorper vestibulum turpis. +Pellentesque cursus luctus mauris.}} + +\newglossaryentry{longaliquamet}{name={aliquam et}, + description={augue felis erat, congue non, +volutpat at, tincidunt tristique, libero. Vivamus viverra fermentum +felis. Donec nonummy pellentesque ante.}} + +\newglossaryentry{longatnunc}{parent={longaliquamet},name={at nunc}, + description={pellentesque ullamcorper el justo +vitae lacus tincidunt ultrices. Lorem ipsum dolor sit amet, +consectetuer adipiscing elit.}} + +\newglossaryentry{longduisnisl}{parent={longatnunc},name={duisnisl}, + description={laoreet suscipit ac venenatis arcu +wisi vel nisl. Vestibulum diam. Aliquam pellentesque, augue quis +sagittis posuere, turpis lacus congue quam, in hendrerit risus eros +eget felis. Maecenas eget erat in sapien mattis porttitor.}} + +\newglossaryentry{longduisnibh}{parent={longatnunc},name={duisnibh}, +description={convallis ut justo lectus +sagittis dui, et vehicula libero dui cursus dui. Mauris tempor +ligula sed lacus. Duis cursus enim ut augue. Cras ac magna.}} + +\newglossaryentry{longrutrum}{name={rutrum}, + description={id, enim elit, rutrum at, molestie non, nonummy vel, nisl. Ut lectus +eros, malesuada sit amet, fermentum eu, sodales cursus, magna. Donec +eu purus. Quisque vehicula, urna sed ultricies auctor, pede lorem +egestas dui, et convallis elit erat sed nulla.}} + +\newglossaryentry{longphasellus}{parent={longrutrum},name={phasellus}, + description={odio volutpat a, ornare ac, erat. +Morbi quis dolor. Donec pellentesque, erat ac sagittis semper, nunc +dui lobortis purus, quis congue purus metus ultricies tellus. Proin +et quam.}} + +\newglossaryentry{longnullanulla}{parent={longrutrum},name={nulla nulla}, +description={elit, molestie non wisi viverra faucibus pretium, nibh est placerat odio, +nec commodo wisi enim eget quam. Quisque libero justo, consectetuer +a, feugiat vitae, porttitor eu, libero.}} + +% \end{macrocode} +%\fi +%\iffalse +% \begin{macrocode} +%</example-glossaries-longchild.tex> +% \end{macrocode} +%\fi +%\iffalse +% \begin{macrocode} %<*example-glossaries-multipar.tex> % \end{macrocode} %\fi @@ -29950,6 +30641,8181 @@ amet, libero}, %\fi %\iffalse % \begin{macrocode} +%<*glossaries-2020-03-19.sty> +% \end{macrocode} +%\fi +% \section{Rollback v4.46 (glossaries-2020-03-19.sty)} +% Version 4.46 preserved for rollback. +% \begin{macrocode} +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{glossaries}[2020/03/19 v4.46 (NLCT)] +\RequirePackage{ifthen} +\RequirePackage{xkeyval}[2006/11/18] +\RequirePackage{mfirstuc} +\RequirePackage{textcase} +\renewcommand*{\mfirstucMakeUppercase}{\MakeTextUppercase}% +\RequirePackage{xfor} +\RequirePackage{datatool-base} +\RequirePackage{amsgen} +\RequirePackage{etoolbox} +\newif\if@gls@docloaded +\@ifpackageloaded{doc}% +{% + \@gls@docloadedtrue +}% +{% + \@ifclassloaded{nlctdoc}{\@gls@docloadedtrue}{\@gls@docloadedfalse}% +} +\if@gls@docloaded + \let\glsorg@theglossary\theglossary + \let\glsorg@endtheglossary\endtheglossary + \let\glsorg@PrintChanges\PrintChanges + \renewcommand{\PrintChanges}{% + \begingroup + \let\theglossary\glsorg@theglossary + \let\endtheglossary\glsorg@endtheglossary + \glsorg@PrintChanges + \endgroup + } +\fi +\newif\if@gls@debug +\define@choicekey{glossaries.sty}{debug}[\gls@debug@val\gls@debug@nr]% + {true,false,showtargets,showaccsupp}[true]{% + \ifcase\gls@debug@nr\relax + % debug=true + \@gls@debugtrue + \renewcommand*{\GlossariesWarning}[1]{% + \PackageWarning{glossaries}{##1}% + }% + \renewcommand*{\GlossariesWarningNoLine}[1]{% + \PackageWarningNoLine{glossaries}{##1}% + }% + \let\@glsshowtarget\@gobble + \PackageInfo{glossaries}{debug mode ON (nowarn option disabled)}% + \or + % debug=false + \@gls@debugfalse + \let\@glsshowtarget\@gobble + \let\@glsshowaccsupp\@gobblethree + \PackageInfo{glossaries}{debug mode OFF}% + \or + % debug=showtargets + \@gls@debugtrue + \renewcommand*{\GlossariesWarning}[1]{% + \PackageWarning{glossaries}{##1}% + }% + \renewcommand*{\GlossariesWarningNoLine}[1]{% + \PackageWarningNoLine{glossaries}{##1}% + }% + \PackageInfo{glossaries}{debug mode ON (nowarn option disabled)}% + \renewcommand{\@glsshowtarget}{\@@glsshowtarget}% + \or + % debug=showaccsupp + \@gls@debugtrue + \renewcommand*{\GlossariesWarning}[1]{% + \PackageWarning{glossaries}{##1}% + }% + \renewcommand*{\GlossariesWarningNoLine}[1]{% + \PackageWarningNoLine{glossaries}{##1}% + }% + \PackageInfo{glossaries}{debug mode ON (nowarn option disabled)}% + \renewcommand{\@glsshowaccsupp}{\glsshowaccsupp}% + \fi +} +\newcommand*{\glsshowtarget}[1]{% + \ifmmode + \nfss@text{\glsshowtargetfont [#1]}% + \else + \ifinner + {\glsshowtargetfont [#1]}% + \else + \glsshowtargetouter{#1}% + \fi + \fi +} +\newcommand*{\glsshowtargetouter}[1]{% + \glsshowtargetsymbol\marginpar{\glsshowtargetsymbol\glsshowtargetfont #1}} +\newcommand*{\glsshowtargetsymbol}{{\tiny$\triangleright$}} +\newcommand*{\glsshowtargetfont}{\ttfamily\footnotesize} +\newcommand*{\@glsshowtarget}[1]{} +\newrobustcmd*{\@@glsshowtarget}[1]{% + \begingroup + \protected@edef\@gls@tmp{#1}% + \@onelevel@sanitize\@gls@tmp + \expandafter\glsshowtarget\expandafter{\@gls@tmp}% + \endgroup +} +\newcommand*{\@glsshowaccsupp}[3]{} +\newrobustcmd*{\glsshowaccsupp}[3]{% + \ifstrempty{#1}% + {\@@glsshowtarget{/#2 (#3)}}% + {\@@glsshowtarget{/#2 (#3) [#1]}}% +} +\newcommand*{\@gls@see@noindex}{% + \PackageError{glossaries}% + {`\gls@xr@key' key may only be used after \string\makeglossaries\space + or \string\makenoidxglossaries\space (or move + \string\newglossaryentry\space + definitions into the preamble)}% + {You must use \string\makeglossaries\space + or \string\makenoidxglossaries\space before defining + any entries that have a `\gls@xr@key' key. It may + be that the `see' key has been written to the .glsdefs + file from the previous run, in which case you need to + move your definitions + to the preamble if you don't want to use + \string\makeglossaries\space + or \string\makenoidxglossaries}% +} +\define@choicekey{glossaries.sty}{seenoindex}% + [\gls@seenoindex@val\gls@seenoindex@nr]{error,warn,ignore}{% + \ifcase\gls@seenoindex@nr + \renewcommand*{\@gls@see@noindex}{% + \PackageError{glossaries}% + {`\gls@xr@key' key may only be used after \string\makeglossaries\space + or \string\makenoidxglossaries}% + {You must use \string\makeglossaries\space + or \string\makenoidxglossaries\space before defining + any entries that have a `\gls@xr@key' key}% + }% + \or + \renewcommand*{\@gls@see@noindex}{% + \GlossariesWarning{`\gls@xr@key' key ignored}% + }% + \or + \renewcommand*{\@gls@see@noindex}{}% + \fi +} +\define@boolkey{glossaries.sty}[gls]{toc}[true]{} +\define@boolkey{glossaries.sty}[gls]{numberline}[true]{} +\ifcsundef{chapter}% + {\newcommand*{\@@glossarysec}{section}}% + {\newcommand*{\@@glossarysec}{chapter}} +\define@choicekey{glossaries.sty}{section}{part,chapter,section,% +subsection,subsubsection,paragraph,subparagraph}[section]{% + \renewcommand*{\@@glossarysec}{#1}} +\newcommand*{\@@glossarysecstar}{*} +\newcommand*{\@@glossaryseclabel}{} +\newcommand*{\glsautoprefix}{} +\define@choicekey{glossaries.sty}{numberedsection}% + [\gls@numberedsection@val\gls@numberedsection@nr]{% +false,nolabel,autolabel,nameref}[nolabel]{% + \ifcase\gls@numberedsection@nr\relax + \renewcommand*{\@@glossarysecstar}{*}% + \renewcommand*{\@@glossaryseclabel}{}% + \or + \renewcommand*{\@@glossarysecstar}{}% + \renewcommand*{\@@glossaryseclabel}{}% + \or + \renewcommand*{\@@glossarysecstar}{}% + \renewcommand*{\@@glossaryseclabel}{% + \label{\glsautoprefix\@glo@type}}% + \or + \renewcommand*{\@@glossarysecstar}{*}% + \renewcommand*{\@@glossaryseclabel}{% + \protected@edef\@currentlabelname{\glossarytoctitle}% + \label{\glsautoprefix\@glo@type}}% + \fi +} +\@ifpackageloaded{classicthesis} +{\newcommand*{\@glossary@default@style}{index}} +{\newcommand*{\@glossary@default@style}{list}} +\define@key{glossaries.sty}{style}{% + \def\@glossary@default@style{#1}% +} +\newcommand*{\@gls@declareoption}[2]{% + \DeclareOptionX{#1}{#2}% + \DeclareOption{#1}{#2}% +} +\newcommand*{\glossaryentrynumbers}[1]{#1\gls@save@numberlist{#1}} +\@gls@declareoption{nonumberlist}{% + \renewcommand*{\glossaryentrynumbers}[1]{\gls@save@numberlist{#1}}% +} +\define@boolkey{glossaries.sty}[gls]{savenumberlist}[true]{} +\glssavenumberlistfalse +\newcommand*\@glo@seeautonumberlist{} +\@gls@declareoption{seeautonumberlist}{% + \renewcommand*{\@glo@seeautonumberlist}{% + \def\@glo@prefix{\glsnextpages}% + }% +} +\define@boolkey{glossaries.sty}[gls]{esclocations}[true]{} +\glsesclocationstrue +\newcommand*{\@gls@loadlong}{\RequirePackage{glossary-long}} +\@gls@declareoption{nolong}{\renewcommand*{\@gls@loadlong}{}} +\IfFileExists{supertabular.sty}{% + \newcommand*{\@gls@loadsuper}{\RequirePackage{glossary-super}}}{% + \newcommand*{\@gls@loadsuper}{}} +\@gls@declareoption{nosuper}{\renewcommand*{\@gls@loadsuper}{}} +\newcommand*{\@gls@loadlist}{\RequirePackage{glossary-list}} +\@gls@declareoption{nolist}{% + \renewcommand*{\@gls@loadlist}{% + \ifdefstring{\@glossary@default@style}{list}% + {\let\@glossary@default@style\relax}% + {}% + }% +} +\newcommand*{\@gls@loadtree}{\RequirePackage{glossary-tree}} +\@gls@declareoption{notree}{\renewcommand*{\@gls@loadtree}{}} +\@gls@declareoption{nostyles}{% + \renewcommand*{\@gls@loadlong}{}% + \renewcommand*{\@gls@loadsuper}{}% + \renewcommand*{\@gls@loadlist}{}% + \renewcommand*{\@gls@loadtree}{}% + \let\@glossary@default@style\relax +} +\newcommand*{\glspostdescription}{% + \ifglsnopostdot\else.\spacefactor\sfcode`\. \fi +} +\define@boolkey{glossaries.sty}[gls]{nopostdot}[true]{} +\glsnopostdotfalse +\define@boolkey{glossaries.sty}[gls]{nogroupskip}[true]{} +\glsnogroupskipfalse +\define@boolkey{glossaries.sty}[gls]{ucmark}[true]{} +\@ifclassloaded{memoir} +{% + \glsucmarktrue +}% +{% + \glsucmarkfalse +} +\newcommand*{\@gls@define@glossaryentrycounter}{% + \ifglsentrycounter + \ifundef\c@glossaryentry + {% + \ifx\@gls@counterwithin\@empty + \newcounter{glossaryentry}% + \else + \newcounter{glossaryentry}[\@gls@counterwithin]% + \fi + \def\theHglossaryentry{\currentglossary.\theglossaryentry}% + }% + {}% + \fi +} +\define@boolkey{glossaries.sty}[gls]{entrycounter}[true]{} +\glsentrycounterfalse +\define@key{glossaries.sty}{counterwithin}{% + \renewcommand*{\@gls@counterwithin}{#1}% + \glsentrycountertrue + \@gls@define@glossaryentrycounter +} +\newcommand*{\@gls@counterwithin}{} +\newcommand{\@gls@define@glossarysubentrycounter}{% + \ifundef\c@glossarysubentry + {% + \ifglssubentrycounter + \ifglsentrycounter + \newcounter{glossarysubentry}[glossaryentry]% + \else + \newcounter{glossarysubentry}% + \fi + \def\theHglossarysubentry{\currentglossary.\currentglssubentry.\theglossarysubentry}% + \fi + }% + {}% +} +\define@boolkey{glossaries.sty}[gls]{subentrycounter}[true]{} +\glssubentrycounterfalse +\newcommand*{\@glo@default@sorttype}{standard} +\define@choicekey{glossaries.sty}{sort}{standard,def,use,none}{% + \renewcommand*{\@glo@default@sorttype}{#1}% + \csname @gls@setupsort@#1\endcsname +} +\newcommand*{\glsprestandardsort}[3]{% + \glsdosanitizesort +} +\newcommand*{\@glo@check@sortallowed}[1]{} +\newcommand*{\@gls@setupsort@standard}{% + \def\do@glo@storeentry{\@glo@storeentry}% + \def\@gls@defsortcount##1{}% + \def\@gls@defsort##1##2{% + \ifx\@glo@sort\@glsdefaultsort + \let\@glo@sort\@glo@name + \fi + \let\glsdosanitizesort\@gls@sanitizesort + \glsprestandardsort{\@glo@sort}{##1}{##2}% + \expandafter\protected@xdef\csname glo@##2@sort\endcsname{\@glo@sort}% + }% + \def\@gls@setsort##1{}% + \let\@glo@check@sortallowed\@gobble +} +\@gls@setupsort@standard +\newcommand*\glssortnumberfmt[1]{% + \ifnum#1<100000 0\fi + \ifnum#1<10000 0\fi + \ifnum#1<1000 0\fi + \ifnum#1<100 0\fi + \ifnum#1<10 0\fi + \number#1% +} +\newcommand*{\@gls@setupsort@def}{% + \def\do@glo@storeentry{\@glo@storeentry}% + \def\@gls@defsortcount##1{% + \expandafter\global + \expandafter\newcount\csname glossary@##1@sortcount\endcsname + }% + \def\@gls@defsort##1##2{% + \ifcsundef{glossary@##1@sortcount}% + {\@gls@defsortcount{##1}}% + {}% + \expandafter\global\expandafter + \advance\csname glossary@##1@sortcount\endcsname by 1\relax + \expandafter\protected@xdef\csname glo@##2@sort\endcsname{% + \expandafter\glssortnumberfmt + {\csname glossary@##1@sortcount\endcsname}}% + }% + \def\@gls@setsort##1{}% + \let\@glo@check@sortallowed\@gobble +} +\newcommand*{\@gls@setupsort@use}{% + \let\do@glo@storeentry\@gobble + \def\@gls@defsortcount##1{% + \expandafter\global + \expandafter\newcount\csname glossary@##1@sortcount\endcsname + }% + \def\@gls@defsort##1##2{% + \expandafter\gdef\csname glo@##2@sort\endcsname{}% + }% + \def\@gls@setsort##1{% + \edef\@glo@parent{\csname glo@##1@parent\endcsname}% + \ifx\@glo@parent\@empty + \else + \expandafter\@gls@setsort\expandafter{\@glo@parent}% + \fi + \edef\@glo@type{\csname glo@##1@type\endcsname}% + \edef\@gls@tmp{\csname glo@##1@sort\endcsname}% + \ifx\@gls@tmp\@empty + \expandafter\global\expandafter + \advance\csname glossary@\@glo@type @sortcount\endcsname by 1\relax + \expandafter\protected@xdef\csname glo@##1@sort\endcsname{% + \expandafter\glssortnumberfmt + {\csname glossary@\@glo@type @sortcount\endcsname}}% + \@glo@storeentry{##1}% + \fi + }% + \let\@glo@check@sortallowed\@gobble +} +\newcommand*{\@gls@setupsort@none}{% + \def\do@glo@storeentry##1{}% + \def\@gls@defsortcount##1{}% + \def\@gls@defsort##1##2{% + \expandafter\global\expandafter\let\csname glo@##2@sort\endcsname\@glo@sort + }% + \def\@gls@setsort##1{}% + \renewcommand\@glo@check@sortallowed[1]{\PackageError{glossaries} + {Option sort=none not allowed with \string##1}% + {(Use sort=def instead)}}% +} +\newcommand*{\glsdefmain}{% + \if@gls@docloaded + \newglossary[glg2]{main}{gls2}{glo2}{\glossaryname}% + \else + \newglossary{main}{gls}{glo}{\glossaryname}% + \fi + \newcommand*{\gls@tr@set@main@toctitle}{% + \translatelet{\glossarytoctitle}{Glossary}% + }% +} +\newcommand*{\glsdefaulttype}{main} +\newcommand*{\acronymtype}{\glsdefaulttype} +\@gls@declareoption{nomain}{% + \let\glsdefaulttype\relax + \renewcommand*{\glsdefmain}{}% +} +\define@boolkey{glossaries.sty}[gls]{acronym}[true]{% + \ifglsacronym + \renewcommand{\@gls@do@acronymsdef}{% + \DeclareAcronymList{acronym}% + \newglossary[alg]{acronym}{acr}{acn}{\acronymname}% + \renewcommand*{\acronymtype}{acronym}% + \newcommand*{\gls@tr@set@acronym@toctitle}{% + \translatelet{\glossarytoctitle}{Acronyms}% + }% + }% + \else + \let\@gls@do@acronymsdef\relax + \fi +} +\AtBeginDocument{% + \ifglsacronym + \ifbool{glscompatible-3.07}% + {}% + {% + \providecommand*{\printacronyms}[1][]{% + \printglossary[type=\acronymtype,#1]}% + }% + \fi +} +\newcommand*{\@gls@do@acronymsdef}{} +\@gls@declareoption{acronyms}{% + \glsacronymtrue + \def\@gls@do@acronymsdef{% + \DeclareAcronymList{acronym}% + \newglossary[alg]{acronym}{acr}{acn}{\acronymname}% + \renewcommand*{\acronymtype}{acronym}% + \newcommand*{\gls@tr@set@acronym@toctitle}{% + \translatelet{\glossarytoctitle}{Acronyms}% + }% + }% +} +\newcommand*{\@glsacronymlists}{} +\newcommand*{\@addtoacronymlists}[1]{% + \ifx\@glsacronymlists\@empty + \protected@xdef\@glsacronymlists{#1}% + \else + \protected@xdef\@glsacronymlists{\@glsacronymlists,#1}% + \fi +} +\newcommand*{\DeclareAcronymList}[1]{% + \glsIfListOfAcronyms{#1}{}{\@addtoacronymlists{#1}}% +} +\newcommand{\glsIfListOfAcronyms}[1]{% + \edef\@do@gls@islistofacronyms{% + \noexpand\@gls@islistofacronyms{#1}{\@glsacronymlists}}% + \@do@gls@islistofacronyms +} +\newcommand{\@gls@islistofacronyms}[4]{% + \def\gls@islistofacronyms##1,#1,##2\end@gls@islistofacronyms{% + \def\@gls@before{##1}\def\@gls@after{##2}}% + \gls@islistofacronyms,#2,#1,\@nil\end@gls@islistofacronyms + \ifx\@gls@after\@nnil + #4% + \else + #3% + \fi +} +\newif\if@glsisacronymlist +\newcommand*{\gls@checkisacronymlist}[1]{% + \glsIfListOfAcronyms{#1}% + {\@glsisacronymlisttrue}{\@glsisacronymlistfalse}% +} +\newcommand*{\SetAcronymLists}[1]{% + \renewcommand*{\@glsacronymlists}{#1}% +} +\define@key{glossaries.sty}{acronymlists}{% + \DeclareAcronymList{#1}% +} +\newcommand{\glscounter}{page} +\define@key{glossaries.sty}{counter}{% + \renewcommand*{\glscounter}{#1}% +} +\newcommand*{\@gls@nohyperlist}{} +\newcommand*{\GlsDeclareNoHyperList}[1]{% + \ifdefempty\@gls@nohyperlist + {% + \renewcommand*{\@gls@nohyperlist}{#1}% + }% + {% + \appto\@gls@nohyperlist{,#1}% + }% +} +\define@key{glossaries.sty}{nohypertypes}{% + \GlsDeclareNoHyperList{#1}% +} +\newcommand*{\GlossariesWarning}[1]{% + \PackageWarning{glossaries}{#1}% +} +\newcommand*{\GlossariesWarningNoLine}[1]{% + \PackageWarningNoLine{glossaries}{#1}% +} +\newcommand{\glosortentrieswarning}{% + \typeout{Using TeX to sort glossary entries---this may + take a while}% +} +\@gls@declareoption{nowarn}{% + \if@gls@debug + \GlossariesWarning{Warnings can't be suppressed in debug mode}% + \else + \renewcommand*{\GlossariesWarning}[1]{}% + \renewcommand*{\GlossariesWarningNoLine}[1]{}% + \renewcommand*{\glosortentrieswarning}{}% + \renewcommand*{\@gls@missinglang@warn}[2]{}% + \fi +} +\newcommand*{\@gls@missinglang@warn}[2]{% + \PackageWarningNoLine{glossaries}% + {No language module detected for `#1'.\MessageBreak + Language modules need to be installed separately.\MessageBreak + Please check on CTAN for a bundle called\MessageBreak + `glossaries-#2' or similar}% +} +\@gls@declareoption{nolangwarn}{% + \renewcommand*{\@gls@missinglang@warn}[2]{}% +} +\newcommand*{\@gls@warnonglossdefined}{% + \GlossariesWarning{Overriding \string\printglossary}% +} +\newcommand*{\@gls@warnontheglossdefined}{% + \GlossariesWarning{Overriding `theglossary' environment}% +} +\@gls@declareoption{noredefwarn}{% + \renewcommand*{\@gls@warnonglossdefined}{}% + \renewcommand*{\@gls@warnontheglossdefined}{}% +} +\newcommand*{\@gls@sanitizedesc}{% +} +\newcommand*{\glssetexpandfield}[1]{% + \csdef{gls@assign@#1@field}##1##2{% + \@@gls@expand@field{##1}{#1}{##2}% + }% +} +\newcommand*{\glssetnoexpandfield}[1]{% + \csdef{gls@assign@#1@field}##1##2{% + \@@gls@noexpand@field{##1}{#1}{##2}% + }% +} +\glssetexpandfield{type} +\glssetnoexpandfield{desc} +\glssetnoexpandfield{descplural} +\newcommand*{\@gls@sanitizename}{} +\glssetnoexpandfield{name} +\newcommand*{\@gls@sanitizesymbol}{} +\glssetnoexpandfield{symbol} +\glssetnoexpandfield{symbolplural} +\newcommand*{\@gls@sanitizesort}{% + \ifglssanitizesort + \@@gls@sanitizesort + \else + \@@gls@nosanitizesort + \fi +} +\newcommand*\@@gls@sanitizesort{% + \@onelevel@sanitize\@glo@sort +} +\newcommand*{\@@gls@nosanitizesort}{} +\newcommand*\@gls@noidx@sanitizesort{% + \ifdefvoid\@glo@sort + {}% + {% + \expandafter\@@gls@noidx@sanitizesort\@glo@sort\gls@end@sanitizesort + }% +} +\def\@@gls@noidx@sanitizesort#1#2\gls@end@sanitizesort{% + \def\@glo@sort{#1#2}% + \@onelevel@sanitize\@glo@sort +} +\newcommand*{\@@gls@noidx@nosanitizesort}{% + \ifdefvoid\@glo@sort + {}% + {% + \expandafter\@@gls@noidx@no@sanitizesort\@glo@sort\gls@end@sanitizesort + }% +} +\def\@@gls@noidx@no@sanitizesort#1#2\gls@end@sanitizesort{% + \bgroup + \glsnoidxstripaccents + \protected@xdef\@@glo@sort{#1#2}% + \egroup + \let\@glo@sort\@@glo@sort +} +\newcommand*\glsnoidxstripaccents{% + \let\IeC\@firstofone + \let\add@accent@\@secondoftwo + \let\@text@composite@x\@secondoftwo + \let\@tabacckludge\@secondoftwo + \expandafter\def\csname \encodingdefault-cmd\endcsname##1##2##3{##3}% + \expandafter\def\csname OT1-cmd\endcsname##1##2##3{##3}% + \expandafter\def\csname T1-cmd\endcsname##1##2##3{##3}% + \expandafter\def\csname PD1-cmd\endcsname##1##2##3{##3}% + \let\'\@firstofone + \let\`\@firstofone + \let\^\@firstofone + \let\"\@firstofone + \let\u\@firstofone + \let\t\@firstofone + \let\d\@firstofone + \let\r\@firstofone + \let\=\@firstofone + \let\.\@firstofone + \let\~\@firstofone + \let\v\@firstofone + \let\H\@firstofone + \let\c\@firstofone + \let\b\@firstofone + \let\a\@secondoftwo + \def\AE{AE}% + \def\ae{ae}% + \def\OE{OE}% + \def\oe{oe}% + \def\AA{AA}% + \def\aa{aa}% + \def\L{L}% + \def\l{l}% + \def\O{O}% + \def\o{o}% + \def\SS{SS}% + \def\ss{ss}% + \def\th{th}% + \def\TH{TH}% + \def\dh{dh}% + \def\DH{DH}% +} +\@ifl@t@r\fmtversion{2019/10/01} +{% + \appto\glsnoidxstripaccents{\let\UTFviii@two@octets\UTFviii@two@octets@combine}% +} +{} +\define@boolkey[gls]{sanitize}{description}[true]{% + \GlossariesWarning{sanitize={description} package option deprecated}% + \ifgls@sanitize@description + \glssetnoexpandfield{desc}% + \glssetnoexpandfield{descplural}% + \else + \glssetexpandfield{desc}% + \glssetexpandfield{descplural}% + \fi +} +\define@boolkey[gls]{sanitize}{name}[true]{% + \GlossariesWarning{sanitize={name} package option deprecated}% + \ifgls@sanitize@name + \glssetnoexpandfield{name}% + \else + \glssetexpandfield{name}% + \fi +} +\define@boolkey[gls]{sanitize}{symbol}[true]{% + \GlossariesWarning{sanitize={symbol} package option deprecated}% + \ifgls@sanitize@symbol + \glssetnoexpandfield{symbol}% + \glssetnoexpandfield{symbolplural}% + \else + \glssetexpandfield{symbol}% + \glssetexpandfield{symbolplural}% + \fi +} +\define@boolkey{glossaries.sty}[gls]{sanitizesort}[true]{% + \ifglssanitizesort + \glssetnoexpandfield{sortvalue}% + \renewcommand*{\@gls@noidx@setsanitizesort}{% + \glssanitizesorttrue + \glssetnoexpandfield{sortvalue}% + }% + \else + \glssetexpandfield{sortvalue}% + \renewcommand*{\@gls@noidx@setsanitizesort}{% + \glssanitizesortfalse + \glssetexpandfield{sortvalue}% + }% + \fi +} +\glssanitizesorttrue +\glssetnoexpandfield{sortvalue}% +\newcommand*{\@gls@noidx@setsanitizesort}{% + \glssanitizesortfalse + \glssetexpandfield{sortvalue}% +} +\define@choicekey[gls]{sanitize}{sort}{true,false}[true]{% + \setbool{glssanitizesort}{#1}% + \ifglssanitizesort + \glssetnoexpandfield{sortvalue}% + \else + \glssetexpandfield{sortvalue}% + \fi + \GlossariesWarning{sanitize={sort} package option + deprecated. Use sanitizesort instead}% +} +\define@key{glossaries.sty}{sanitize}[description=true,symbol=true,name=true]{% + \ifthenelse{\equal{#1}{none}}% + {% + \GlossariesWarning{sanitize package option deprecated}% + \glssetexpandfield{name}% + \glssetexpandfield{symbol}% + \glssetexpandfield{symbolplural}% + \glssetexpandfield{desc}% + \glssetexpandfield{descplural}% + }% + {% + \setkeys[gls]{sanitize}{#1}% + }% +} +\newif\ifglstranslate +\newcommand*\@gls@usetranslator{% + \@ifpackageloaded{polyglossia}% + {% + \let\glsifusetranslator\@secondoftwo + }% + {% + \@ifpackageloaded{babel}% + {% + \IfFileExists{translator.sty}% + {% + \RequirePackage{translator}% + \let\glsifusetranslator\@firstoftwo + }% + {}% + }% + {}% + }% +} +\newcommand{\glsifusedtranslatordict}[3]{% + \glsifusetranslator + {\ifcsdef{ver@glossaries-dictionary-#1.dict}{#2}{#3}}% + {#3}% +} +\@gls@declareoption{notranslate}{% + \glstranslatefalse + \let\@gls@usetranslator\relax + \let\glsifusetranslator\@secondoftwo +} +\define@choicekey{glossaries.sty}{translate}% + [\gls@translate@val\gls@translate@nr]% + {true,false,babel}[true]% + {% + \ifcase\gls@translate@nr\relax + \glstranslatetrue + \renewcommand*\@gls@usetranslator{% + \@ifpackageloaded{polyglossia}% + {% + \let\glsifusetranslator\@secondoftwo + }% + {% + \@ifpackageloaded{babel}% + {% + \IfFileExists{translator.sty}% + {% + \RequirePackage{translator}% + \let\glsifusetranslator\@firstoftwo + }% + {}% + }% + {}% + }% + }% + \or + \glstranslatefalse + \let\@gls@usetranslator\relax + \let\glsifusetranslator\@secondoftwo + \or + \glstranslatetrue + \let\@gls@usetranslator\relax + \let\glsifusetranslator\@secondoftwo + \fi + } +\glstranslatefalse +\let\glsifusetranslator\@secondoftwo +\@ifpackageloaded{translator}% +{% + \glstranslatetrue + \let\glsifusetranslator\@firstoftwo +}% +{% + \@for\gls@thissty:=tracklang,babel,ngerman,polyglossia\do + { + \@ifpackageloaded{\gls@thissty}% + {% + \glstranslatetrue + \@endfortrue + }% + {}% + } +} +\define@boolkey{glossaries.sty}[gls]{indexonlyfirst}[true]{} +\glsindexonlyfirstfalse +\define@boolkey{glossaries.sty}[gls]{hyperfirst}[true]{} +\glshyperfirsttrue +\newcommand*{\@gls@setacrstyle}{} +\define@boolkey{glossaries.sty}[glsacr]{footnote}[true]{% + \ifbool{glsacrdescription}% + {}% + {% + \renewcommand*{\@gls@sanitizedesc}{}% + }% + \renewcommand*{\@gls@setacrstyle}{\SetAcronymStyle}% +} +\define@boolkey{glossaries.sty}[glsacr]{description}[true]{% + \renewcommand*{\@gls@sanitizesymbol}{}% + \renewcommand*{\@gls@setacrstyle}{\SetAcronymStyle}% +} +\define@boolkey{glossaries.sty}[glsacr]{smallcaps}[true]{% + \renewcommand*{\@gls@sanitizesymbol}{}% + \renewcommand*{\@gls@setacrstyle}{\SetAcronymStyle}% +} +\define@boolkey{glossaries.sty}[glsacr]{smaller}[true]{% + \renewcommand*{\@gls@sanitizesymbol}{}% + \renewcommand*{\@gls@setacrstyle}{\SetAcronymStyle}% +} +\define@boolkey{glossaries.sty}[glsacr]{dua}[true]{% + \renewcommand*{\@gls@sanitizesymbol}{}% + \renewcommand*{\@gls@setacrstyle}{\SetAcronymStyle}% +} +\define@boolkey{glossaries.sty}[glsacr]{shortcuts}[true]{} +\newcommand*{\glsorder}{word} +\newcommand*{\@glsorder}[1]{} +\define@choicekey{glossaries.sty}{order}{word,letter}{% + \def\glsorder{#1}} +\newif\ifglsxindy +\glsxindyfalse +\@gls@declareoption{makeindex}{\glsxindyfalse} +\define@boolkey[gls]{xindy}{glsnumbers}[true]{} +\gls@xindy@glsnumberstrue +\def\@xdy@main@language{\languagename}% +\define@key[gls]{xindy}{language}{\def\@xdy@main@language{#1}} +\ifcsundef{inputencodingname}{% + \def\gls@codepage{}}{% + \def\gls@codepage{\inputencodingname} +} +\define@key[gls]{xindy}{codepage}{\def\gls@codepage{#1}} +\define@key{glossaries.sty}{xindy}[]{% + \glsxindytrue + \setkeys[gls]{xindy}{#1}% +} +\@gls@declareoption{xindygloss}{% + \glsxindytrue +} +\@gls@declareoption{xindynoglsnumbers}{% + \glsxindytrue + \gls@xindy@glsnumbersfalse +} +\providecommand{\@domakeglossaries}[1]{#1} +\@gls@declareoption{disablemakegloss}{% + \ifdefequal\makeglossaries\@no@makeglossaries + {% + \GlossariesWarning{Option `disablemakegloss' has no effect + (\string\makenoidxglossaries\space has already been used)}% + }% + {% + \ifdefequal\@makeglossary\@gobble + {% + \GlossariesWarning{Option `disablemakegloss' has no effect + (\string\makeglossaries\space has already been used)}% + }% + {% + \renewcommand{\@domakeglossaries}[1]{% + \PackageInfo{glossaries}{\string\makeglossaries\space and + \string\makenoidxglossaries\space have been disabled}% + }% + }% + }% +} +\@gls@declareoption{restoremakegloss}{% + \ifdefequal\makeglossaries\@no@makeglossaries + {% + \GlossariesWarning{Option `restoremakegloss' has no effect + (\string\makenoidxglossaries\space has already been used)}% + }% + {% + \ifdefequal\@makeglossary\@gobble + {% + \GlossariesWarning{Option `restoremakegloss' has no effect + (\string\makeglossaries\space has already been used)}% + }% + {% + \PackageInfo{glossaries}{\string\makeglossaries\space and + \string\makenoidxglossaries\space have been restored}% + \let\@domakeglossaries\@firstofone + }% + }% +} +\newcommand*{\@do@write@glslabels}{% + \AtEndDocument{\@@do@write@glslabels}% + \let\@do@write@glslabels\relax +} +\newcommand*{\@@do@write@glslabels}{% + \newwrite\@gls@labelsfile + \immediate\openout\@gls@labelsfile=\jobname.glslabels + \forallglsentries[\@glo@types,\@ignored@glossaries]{\@glsentry}% + {\ifdefempty{\@glsentry}{}{\immediate\write\@gls@labelsfile{\@glsentry}}}% + \immediate\closeout\@gls@labelsfile +} +\@gls@declareoption{writeglslabels}{\@do@write@glslabels} +\newif\ifglsautomake +\newcommand{\gls@automake@nr}{1} +\define@choicekey{glossaries.sty}{automake}% + [\gls@automake@val\gls@automake@nr]{true,false,immediate}[true]{% + \ifnum\gls@automake@nr=1\relax + \glsautomakefalse + \else + \glsautomaketrue + \fi + \ifglsautomake + \renewcommand*{\@gls@doautomake}{% + \PackageError{glossaries}{You must use + \string\makeglossaries\space with automake=true} + {% + Either remove the automake=true setting or + add \string\makeglossaries\space to your document preamble.% + }% + }% + \else + \renewcommand*{\@gls@doautomake}{}% + \fi +} +\glsautomakefalse +\newcommand*{\@gls@doautomake}{} +\AtEndDocument{\@gls@doautomake} +\define@boolkey{glossaries.sty}[gls]{savewrites}[true]{% + \ifglssavewrites + \renewcommand*{\glswritefiles}{\@glswritefiles}% + \else + \let\glswritefiles\@empty + \fi +} +\glssavewritesfalse +\let\glswritefiles\@empty +\define@boolkey{glossaries.sty}[gls]{compatible-3.07}[true]{} +\boolfalse{glscompatible-3.07} +\define@boolkey{glossaries.sty}[gls]{compatible-2.07}[true]{% + \ifbool{glscompatible-2.07}% + {% + \booltrue{glscompatible-3.07}% + }% + {}% +} +\boolfalse{glscompatible-2.07} +\let\gls@original@makeglossary\makeglossary +\let\gls@original@glossary\glossary +\def\makeglossary{% + \GlossariesWarning{Use of \string\makeglossary\space with + glossaries.sty is \MessageBreak deprecated. Use \string\makeglossaries\space + instead. If you \MessageBreak need the original definition of + \string\makeglossary\space use \MessageBreak the package options + kernelglossredefs=false (to \MessageBreak restore the former definition of + \string\makeglossary) and \MessageBreak nomain (if the file extensions cause a + conflict)}% + \makeglossaries +} +\newcommand*{\@gls@override@glossary}[1][main]{% + \GlossariesWarning{Use of \string\glossary\space with + glossaries.sty is deprecated. \MessageBreak Indexing should be performed + with the user level \MessageBreak commands, such as \string\gls\space or + \string\glsadd. If you need the \MessageBreak original definition of + \string\glossary\space use the package \MessageBreak options + kernelglossredefs=false (to restore the \MessageBreak former definition of + \string\glossary) and nomain (if the \MessageBreak file extensions cause a + conflict)}% + \gls@glossary{#1}% +} +\if@gls@docloaded +\else + \def\glossary{\@gls@override@glossary} +\fi +\define@choicekey{glossaries.sty}{kernelglossredefs}% + [\gls@debug@val\gls@debug@nr]{true,false,nowarn}[true]% +{% + \ifcase\gls@debug@nr\relax + \def\glossary{\@gls@override@glossary}% + \def\makeglossary{% + \GlossariesWarning{Use of \string\makeglossary\space with + glossaries.sty is deprecated. Use \string\makeglossaries\space + instead. If you need the original definition of + \string\makeglossary\space use the package options + kernelglossredefs=false (to prevent redefinition of + \string\makeglossary) and nomain (if the file extensions cause a + conflict)}% + \makeglossaries + }% + \or + \let\glossary\gls@original@glossary + \let\makeglossary\gls@original@makeglossary + \or + \def\makeglossary{\makeglossaries}% + \renewcommand*{\@gls@override@glossary}[1][main]{% + \gls@glossary{##1}% + }% + \fi +} +\@gls@declareoption{symbols}{% + \let\@gls@do@symbolsdef\@gls@symbolsdef +} +\newcommand*{\@gls@do@symbolsdef}{} +\newcommand*{\@gls@symbolsdef}{% + \newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname}% + \newcommand*{\printsymbols}[1][]{\printglossary[type=symbols,##1]}% + \newcommand*{\gls@tr@set@symbols@toctitle}{% + \translatelet{\glossarytoctitle}{Symbols (glossaries)}% + }% +}% +\@gls@declareoption{numbers}{% + \let\@gls@do@numbersdef\@gls@numbersdef +} +\newcommand*{\@gls@do@numbersdef}{} +\newcommand*{\@gls@numbersdef}{% + \newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname}% + \newcommand*{\printnumbers}[1][]{\printglossary[type=numbers,##1]}% + \newcommand*{\gls@tr@set@numbers@toctitle}{% + \translatelet{\glossarytoctitle}{Numbers (glossaries)}% + }% +}% +\@gls@declareoption{index}{% + \ifx\@gls@do@indexdef\@empty + \let\@gls@do@indexdef\@gls@indexdef + \fi +} +\@gls@declareoption{noglossaryindex}{% + \let\@gls@do@indexdef\relax +} +\newcommand*{\@gls@do@indexdef}{} +\newcommand*{\@gls@indexdef}{% + \newglossary[ilg]{index}{ind}{idx}{\indexname}% + \newcommand*{\printindex}[1][]{\printglossary[type=index,##1]}% + \newcommand*{\newterm}[2][]{% + \newglossaryentry{##2}% + {type={index},name={##2},description={\nopostdesc},##1}} + \let\@gls@do@indexdef\relax +}% +\@for\CurrentOption :=\@declaredoptions\do{% + \ifx\CurrentOption\@empty + \else + \@expandtwoargs + \in@ {,\CurrentOption ,}{,\@classoptionslist,\@curroptions,}% + \ifin@ + \@use@ption + \expandafter \let\csname ds@\CurrentOption\endcsname\@empty + \fi + \fi +} +\ProcessOptionsX +\RequirePackage{glossaries-compatible-307} +\disable@keys{glossaries.sty}{compatible-2.07,% + xindy,xindygloss,xindynoglsnumbers,makeindex,% + acronym,translate,notranslate,nolong,nosuper,notree,nostyles,% + nomain,noglossaryindex} +\newcommand*{\setupglossaries}[1]{% + \renewcommand*{\@gls@setacrstyle}{}% + \ifglsacrshortcuts + \def\@gls@setupshortcuts{\glsacrshortcutstrue}% + \else + \def\@gls@setupshortcuts{% + \ifglsacrshortcuts + \DefineAcronymSynonyms + \fi + }% + \fi + \glsacrshortcutsfalse + \let\@gls@do@numbersdef\relax + \let\@gls@do@symbolssdef\relax + \let\@gls@do@indexdef\relax + \let\@gls@do@acronymsdef\relax + \ifglsentrycounter + \let\@gls@doentrycounterdef\relax + \else + \let\@gls@doentrycounterdef\@gls@define@glossaryentrycounter + \fi + \ifglssubentrycounter + \let\@gls@dosubentrycounterdef\relax + \else + \let\@gls@dosubentrycounterdef\@gls@define@glossarysubentrycounter + \fi + \setkeys{glossaries.sty}{#1}% + \@gls@setacrstyle + \@gls@setupshortcuts + \@gls@do@acronymsdef + \@gls@do@numbersdef + \@gls@do@symbolssdef + \@gls@do@indexdef + \@gls@doentrycounterdef + \@gls@dosubentrycounterdef +} +\ifthenelse{\equal{\glscounter}{section}}% +{% + \ifcsundef{chapter}{}% + {% + \let\@gls@old@chapter\@chapter + \def\@chapter[#1]#2{\@gls@old@chapter[{#1}]{#2}% + \ifcsundef{hyperdef}{}{\hyperdef{section}{\thesection}{}}}% + }% +}% +{} +\newcommand*{\@gls@onlypremakeg}{} +\newcommand*{\@onlypremakeg}[1]{% + \ifx\@gls@onlypremakeg\@empty + \def\@gls@onlypremakeg{#1}% + \else + \expandafter\toks@\expandafter{\@gls@onlypremakeg}% + \edef\@gls@onlypremakeg{\the\toks@,\noexpand#1}% + \fi +} +\newcommand*{\@disable@onlypremakeg}{% +\@for\@thiscs:=\@gls@onlypremakeg\do{% + \expandafter\@disable@premakecs\@thiscs% +}} +\newcommand*{\@disable@premakecs}[1]{% + \def#1{\PackageError{glossaries}{\string#1\space may only be + used before \string\makeglossaries}{You can't use + \string#1\space after \string\makeglossaries}}% +} +\providecommand*{\glossaryname}{Glossary} +\providecommand*{\acronymname}{Acronyms} +\newcommand*{\glssettoctitle}[1]{% + \def\glossarytoctitle{\csname @glotype@#1@title\endcsname}} +\providecommand*{\entryname}{Notation} +\providecommand*{\descriptionname}{Description} +\providecommand*{\symbolname}{Symbol} +\providecommand*{\pagelistname}{Page List} +\providecommand*{\glssymbolsgroupname}{Symbols} +\providecommand*{\glsnumbersgroupname}{Numbers} +\newcommand*{\glspluralsuffix}{s} +\newcommand*{\glsacrpluralsuffix}{\glspluralsuffix} +\newcommand*{\glsupacrpluralsuffix}{\glstextup{\glsacrpluralsuffix}} +\providecommand*{\seename}{see} +\providecommand*{\andname}{\&} +\newcommand*{\RequireGlossariesLang}[1]{% + \@ifundefined{ver@glossaries-#1.ldf}{\input{glossaries-#1.ldf}}{}% +} +\newcommand*{\ProvidesGlossariesLang}[1]{% + \ProvidesFile{glossaries-#1.ldf}% +} +\newcommand*{\addglossarytocaptions}[1]{} +\ifglstranslate + \RequirePackage{tracklang} + \@gls@usetranslator + \@ifpackageloaded{translator} + {% + \ifboolexpr + { + test {\ifdefstring{\trans@languages}{English}} + and not + test {\ifdefstring{bbl@loaded}{english}} + } + {% + \let\glsifusetranslator\@secondoftwo + }% + {% + \usedictionary{glossaries-dictionary}% + \renewcommand*{\addglossarytocaptions}[1]{% + \ifcsundef{captions#1}{}% + {% + \expandafter\let\expandafter\@gls@tmp\csname captions#1\endcsname + \expandafter\toks@\expandafter{\@gls@tmp + \renewcommand*{\glossaryname}{\translate{Glossary}}% + }% + \expandafter\edef\csname captions#1\endcsname{\the\toks@}% + }% + }% + }% + }% + {}% + \AnyTrackedLanguages + {% + \ForEachTrackedDialect{\this@dialect}{% + \IfTrackedLanguageFileExists{\this@dialect}% + {glossaries-}% prefix + {.ldf}% + {% + \RequireGlossariesLang{\CurrentTrackedTag}% + }% + {% + \@gls@missinglang@warn\this@dialect\CurrentTrackedLanguage + }% + }% + }% + {}% + \glsifusetranslator + {% + \renewcommand*{\glssettoctitle}[1]{% + \ifcsdef{gls@tr@set@#1@toctitle}% + {% + \csuse{gls@tr@set@#1@toctitle}% + }% + {% + \def\glossarytoctitle{\csname @glotype@#1@title\endcsname}% + }% + }% + \renewcommand*{\glossaryname}{\translate{Glossary}}% + \renewcommand*{\acronymname}{\translate{Acronyms}}% + \renewcommand*{\entryname}{\translate{Notation (glossaries)}}% + \renewcommand*{\descriptionname}{% + \translate{Description (glossaries)}}% + \renewcommand*{\symbolname}{\translate{Symbol (glossaries)}}% + \renewcommand*{\pagelistname}{% + \translate{Page List (glossaries)}}% + \renewcommand*{\glssymbolsgroupname}{% + \translate{Symbols (glossaries)}}% + \renewcommand*{\glsnumbersgroupname}{% + \translate{Numbers (glossaries)}}% + }{}% +\fi +\DeclareRobustCommand*{\nopostdesc}{} +\newcommand*{\@nopostdesc}{% + \let\org@glspostdescription\glspostdescription + \def\glspostdescription{% + \let\glspostdescription\org@glspostdescription}% +} +\newcommand*{\@no@post@desc}{\nopostdesc} +\newcommand{\glspar}{\par} +\newcommand{\setStyleFile}[1]{% + \renewcommand*{\gls@istfilebase}{#1}% + \ifglsxindy + \def\istfilename{\gls@istfilebase.xdy} + \else + \def\istfilename{\gls@istfilebase.ist} + \fi +} +\@onlypremakeg\setStyleFile +\ifglsxindy + \def\istfilename{\gls@istfilebase.xdy} +\else + \def\istfilename{\gls@istfilebase.ist} +\fi +\newcommand*{\gls@istfilebase}{\jobname} +\newcommand*{\@istfilename}[1]{} +\newcommand*{\glscompositor}{.} +\newcommand*{\glsSetCompositor}[1]{% + \renewcommand*{\glscompositor}{#1}} +\@onlypremakeg\glsSetCompositor +\newcommand*{\@glsAlphacompositor}{\glscompositor} +\ifglsxindy + \newcommand*\glsSetAlphaCompositor[1]{% + \renewcommand*\@glsAlphacompositor{#1}} +\else + \newcommand*\glsSetAlphaCompositor[1]{% + \glsnoxindywarning\glsSetAlphaCompositor} +\fi +\@onlypremakeg\glsSetAlphaCompositor +\newcommand*{\gls@suffixF}{} +\newcommand*{\glsSetSuffixF}[1]{% + \renewcommand*{\gls@suffixF}{#1}} +\@onlypremakeg\glsSetSuffixF +\newcommand*{\gls@suffixFF}{} +\newcommand*{\glsSetSuffixFF}[1]{% + \renewcommand*{\gls@suffixFF}{#1}% +} +\ifcsundef{hyperlink}% +{% + \newcommand*{\glsnumberformat}[1]{#1}% +}% +{% + \newcommand*{\glsnumberformat}[1]{\glshypernumber{#1}}% +} +\newcommand{\delimN}{, } +\newcommand{\delimR}{--} +\newcommand*{\glossarypreamble}{% + \csuse{@glossarypreamble@\currentglossary}% +} +\newcommand{\setglossarypreamble}[2][\glsdefaulttype]{% + \ifglossaryexists*{#1}% + {\csgdef{@glossarypreamble@#1}{#2}}% + {\GlossariesWarning{Glossary `#1' is not defined}}% +} +\newcommand*{\glossarypostamble}{} +\newcommand*{\glossarysection}[2][\@gls@title]{% + \def\@gls@title{#2}% + \ifcsundef{phantomsection}% + {% + \@glossarysection{#1}{#2}% + }% + {% + \@p@glossarysection{#1}{#2}% + }% + \glsglossarymark{\glossarytoctitle}% +} +\ifcsundef{glossarymark}% +{% + \newcommand{\glsglossarymark}[1]{\glossarymark{#1}} +}% +{% + \@ifclassloaded{memoir} + {% + \newcommand{\glsglossarymark}[1]{% + \ifglsucmark + \markboth{\memUChead{#1}}{\memUChead{#1}}% + \else + \markboth{#1}{#1}% + \fi + } + }% + {% + \newcommand{\glsglossarymark}[1]{% + \ifglsucmark + \@mkboth{\mfirstucMakeUppercase{#1}}{\mfirstucMakeUppercase{#1}}% + \else + \@mkboth{#1}{#1}% + \fi + } + } +} +\providecommand{\glossarymark}[1]{% + \ifglsucmark + \@mkboth{\mfirstucMakeUppercase{#1}}{\mfirstucMakeUppercase{#1}}% + \else + \@mkboth{#1}{#1}% + \fi +} +\newcommand*{\setglossarysection}[1]{% +\setkeys{glossaries.sty}{section=#1}} +\newcommand*{\@glossarysection}[2]{% + \ifdefempty\@@glossarysecstar + {% + \csname\@@glossarysec\endcsname[#1]{#2}% + }% + {% + \csname\@@glossarysec\endcsname*{#2}% + \@gls@toc{#1}{\@@glossarysec}% + }% + \@@glossaryseclabel +} +\newcommand*{\@p@glossarysection}[2]{% + \glsclearpage + \phantomsection + \ifdefempty\@@glossarysecstar + {% + \csname\@@glossarysec\endcsname{#2}% + }% + {% + \@gls@toc{#1}{\@@glossarysec}% + \csname\@@glossarysec\endcsname*{#2}% + }% + \@@glossaryseclabel +} +\newcommand*{\gls@doclearpage}{% + \ifthenelse{\equal{\@@glossarysec}{chapter}}% + {% + \ifcsundef{cleardoublepage}% + {% + \clearpage + }% + {% + \ifcsdef{if@openright}% + {% + \if@openright + \cleardoublepage + \else + \clearpage + \fi + }% + {% + \cleardoublepage + }% + }% + }% + {}% +} +\newcommand*{\glsclearpage}{\gls@doclearpage} +\newcommand*{\@gls@toc}[2]{% + \ifglstoc + \ifglsnumberline + \addcontentsline{toc}{#2}{\protect\numberline{}#1}% + \else + \addcontentsline{toc}{#2}{#1}% + \fi + \fi +} +\newcommand*{\glsnoxindywarning}[1]{% + \GlossariesWarning{Not in xindy mode --- ignoring \string#1}% +} +\newcommand*{\glsnomakeindexwarning}[1]{% + \GlossariesWarning{Not in makeindex mode --- ignoring \string#1}% +} +\ifglsxindy + \edef\@xdyattributes{\string"default\string"}% +\fi +\ifglsxindy + \edef\@xdyattributelist{}% +\fi +\ifglsxindy + \def\@xdylocref{} +\fi +\newcommand*{\@gls@ifinlist}[4]{% + \def\@do@ifinlist##1,#1,##2\end@doifinlist{% + \def\@gls@listsuffix{##2}% + \ifx\@gls@listsuffix\@empty + #4% + \else + #3% + \fi + }% + \@do@ifinlist,#2,#1,\end@doifinlist +} +\ifglsxindy + \newcommand*{\@xdycounters}{\glscounter} + \newcommand*\GlsAddXdyCounters[1]{% + \@for\@gls@ctr:=#1\do{% + \edef\@do@addcounter{% + \noexpand\@gls@ifinlist{\@gls@ctr}{\@xdycounters}{}% + {% + \noexpand\edef\noexpand\@xdycounters{\@xdycounters,% + \noexpand\@gls@ctr}% + }% + }% + \@do@addcounter + } + } + \@onlypremakeg\GlsAddXdyCounters +\else + \newcommand*\GlsAddXdyCounters[1]{% + \glsnoxindywarning\GlsAddXdyAttribute + } +\fi +\newcommand*\@disabled@glsaddxdycounters{% + \PackageError{glossaries}{\string\GlsAddXdyCounters\space + can't be used after \string\GlsAddXdyAttribute}{Move all + occurrences of \string\GlsAddXdyCounters\space before the first + instance of \string\GlsAddXdyAttribute}% +} +\ifglsxindy + \newcommand*\@glsaddxdyattribute[2]{% + \edef\@xdyattributes{\@xdyattributes ^^J \string"#1\string" ^^J + \string"#2#1\string"}% + \expandafter\toks@\expandafter{\@xdylocref}% + \edef\@xdylocref{\the\toks@ ^^J% + (markup-locref + :open \string"\glstildechar n% + \expandafter\string\csname glsX#2X#1\endcsname + \string" ^^J + :close \string"\string" ^^J + :attr \string"#2#1\string")}% + \expandafter\gdef\csname glsX#2X#1\endcsname##1##2{% + \setentrycounter[##1]{#2}\csname #1\endcsname{##2}% + }% + } + \newcommand*\GlsAddXdyAttribute[1]{% + \ifx\@xdyattributelist\@empty + \edef\@xdyattributelist{#1}% + \else + \edef\@xdyattributelist{\@xdyattributelist,#1}% + \fi + \@for\@this@counter:=\@xdycounters\do{% + \protected@edef\gls@do@addxdyattribute{% + \noexpand\@glsaddxdyattribute{#1}{\@this@counter}% + } + \gls@do@addxdyattribute + }% + \let\GlsAddXdyCounters\@disabled@glsaddxdycounters + } + \@onlypremakeg\GlsAddXdyAttribute +\else + \newcommand*\GlsAddXdyAttribute[1]{% + \glsnoxindywarning\GlsAddXdyAttribute} +\fi +\ifglsxindy +\newcommand*{\@gls@addpredefinedattributes}{% + \GlsAddXdyAttribute{glsnumberformat} + \GlsAddXdyAttribute{textrm} + \GlsAddXdyAttribute{textsf} + \GlsAddXdyAttribute{texttt} + \GlsAddXdyAttribute{textbf} + \GlsAddXdyAttribute{textmd} + \GlsAddXdyAttribute{textit} + \GlsAddXdyAttribute{textup} + \GlsAddXdyAttribute{textsl} + \GlsAddXdyAttribute{textsc} + \GlsAddXdyAttribute{emph} + \GlsAddXdyAttribute{glshypernumber} + \GlsAddXdyAttribute{hyperrm} + \GlsAddXdyAttribute{hypersf} + \GlsAddXdyAttribute{hypertt} + \GlsAddXdyAttribute{hyperbf} + \GlsAddXdyAttribute{hypermd} + \GlsAddXdyAttribute{hyperit} + \GlsAddXdyAttribute{hyperup} + \GlsAddXdyAttribute{hypersl} + \GlsAddXdyAttribute{hypersc} + \GlsAddXdyAttribute{hyperemph} + \GlsAddXdyAttribute{glsignore} +} +\else + \let\@gls@addpredefinedattributes\relax +\fi +\def\@xdyuseralphabets{} +\ifglsxindy + \newcommand*{\GlsAddXdyAlphabet}[2]{% + \edef\@xdyuseralphabets{% + \@xdyuseralphabets ^^J + (define-alphabet "#1" (#2))}} +\else + \newcommand*{\GlsAddXdyAlphabet}[2]{% + \glsnoxindywarning\GlsAddXdyAlphabet} +\fi +\ifglsxindy + \newcommand*{\@gls@xdy@locationlist}{% + roman-page-numbers,% + Roman-page-numbers,% + arabic-page-numbers,% + alpha-page-numbers,% + Alpha-page-numbers,% + Appendix-page-numbers,% + arabic-section-numbers% + } + \protected@edef\@gls@roman{\@roman{0\string" + \string"roman-numbers-lowercase\string" :sep \string"}}% + \@onelevel@sanitize\@gls@roman + \edef\@tmp{\string" \string"roman-numbers-lowercase\string" + :sep \string"}% + \@onelevel@sanitize\@tmp + \ifx\@tmp\@gls@roman + \expandafter + \edef\csname @gls@xdy@Lclass@roman-page-numbers\endcsname{% + \string"roman-numbers-lowercase\string"% + }% + \else + \expandafter + \edef\csname @gls@xdy@Lclass@roman-page-numbers\endcsname{ + :sep \string"\@gls@roman\string"% + }% + \fi + \expandafter\def\csname @gls@xdy@Lclass@Roman-page-numbers\endcsname{% + \string"roman-numbers-uppercase\string"% + }% + \expandafter\def\csname @gls@xdy@Lclass@arabic-page-numbers\endcsname{% + \string"arabic-numbers\string"% + }% + \expandafter\def\csname @gls@xdy@Lclass@alpha-page-numbers\endcsname{% + \string"alpha\string"% + }% + \expandafter\def\csname @gls@xdy@Lclass@Alpha-page-numbers\endcsname{% + \string"ALPHA\string"% + }% + \expandafter\def\csname @gls@xdy@Lclass@Appendix-page-numbers\endcsname{% + \string"ALPHA\string" + :sep \string"\@glsAlphacompositor\string" + \string"arabic-numbers\string"% + } + \expandafter\def\csname @gls@xdy@Lclass@arabic-section-numbers\endcsname{% + \string"arabic-numbers\string" + :sep \string"\glscompositor\string" + \string"arabic-numbers\string"% + }% + \def\@xdyuserlocationdefs{} + \def\@xdyuserlocationnames{} +\fi +\ifglsxindy + \newcommand\@xdycrossrefhook{} +\fi +\ifglsxindy + \newcommand*{\GlsAddXdyLocation}[3][]{% + \def\@gls@tmp{#1}% + \ifx\@gls@tmp\@empty + \edef\@xdyuserlocationdefs{% + \@xdyuserlocationdefs ^^J% + (define-location-class \string"#2\string"^^J\space\space + \space(:sep \string"{}\glsopenbrace\string" #3 + :sep \string"\glsclosebrace\string")) + }% + \else + \edef\@xdyuserlocationdefs{% + \@xdyuserlocationdefs ^^J% + (define-location-class \string"#2\string"^^J\space\space + \space(:sep "\glsopenbrace" + #1 + :sep "\glsclosebrace\glsopenbrace" #3 + :sep "\glsclosebrace")) + }% + \fi + \edef\@xdyuserlocationnames{% + \@xdyuserlocationnames^^J\space\space\space + \string"#2\string"}% + } + \@onlypremakeg\GlsAddXdyLocation +\else + \newcommand*{\GlsAddXdyLocation}[2]{% + \glsnoxindywarning\GlsAddXdyLocation} +\fi +\ifglsxindy + \def\@xdylocationclassorder{^^J\space\space\space + \string"roman-page-numbers\string"^^J\space\space\space + \string"arabic-page-numbers\string"^^J\space\space\space + \string"arabic-section-numbers\string"^^J\space\space\space + \string"alpha-page-numbers\string"^^J\space\space\space + \string"Roman-page-numbers\string"^^J\space\space\space + \string"Alpha-page-numbers\string"^^J\space\space\space + \string"Appendix-page-numbers\string" + \@xdyuserlocationnames^^J\space\space\space + \string"see\string" + } +\fi +\ifglsxindy + \newcommand*\GlsSetXdyLocationClassOrder[1]{% + \def\@xdylocationclassorder{#1}} +\else + \newcommand*\GlsSetXdyLocationClassOrder[1]{% + \glsnoxindywarning\GlsSetXdyLocationClassOrder} +\fi +\ifglsxindy + \def\@xdysortrules{} +\fi +\ifglsxindy + \newcommand*\GlsAddSortRule[2]{% + \expandafter\toks@\expandafter{\@xdysortrules}% + \protected@edef\@xdysortrules{\the\toks@ ^^J + (sort-rule \string"#1\string" \string"#2\string")}% + } +\else + \newcommand*\GlsAddSortRule[2]{% + \glsnoxindywarning\GlsAddSortRule} +\fi +\ifglsxindy + \def\@xdyrequiredstyles{tex} +\fi +\ifglsxindy + \newcommand*\GlsAddXdyStyle[1]{% + \edef\@xdyrequiredstyles{\@xdyrequiredstyles,#1}}% +\else + \newcommand*\GlsAddXdyStyle[1]{% + \glsnoxindywarning\GlsAddXdyStyle} +\fi +\ifglsxindy + \newcommand*\GlsSetXdyStyles[1]{% + \edef\@xdyrequiredstyles{#1}} +\else + \newcommand*\GlsSetXdyStyles[1]{% + \glsnoxindywarning\GlsSetXdyStyles} +\fi +\newcommand*{\findrootlanguage}{} +\def\@xdylanguage#1#2{} +\ifglsxindy + \newcommand*\GlsSetXdyLanguage[2][\glsdefaulttype]{% + \ifglossaryexists{#1}{% + \expandafter\def\csname @xdy@#1@language\endcsname{#2}% + }{% + \PackageError{glossaries}{Can't set language type for + glossary type `#1' --- no such glossary}{% + You have specified a glossary type that doesn't exist}}} +\else + \newcommand*\GlsSetXdyLanguage[2][]{% + \glsnoxindywarning\GlsSetXdyLanguage} +\fi +\def\@gls@codepage#1#2{} +\ifglsxindy + \newcommand*{\GlsSetXdyCodePage}[1]{% + \renewcommand*{\gls@codepage}{#1}% + } + \AtBeginDocument{% + \ifx\gls@codepage\@empty + \@ifpackageloaded{fontspec}{\def\gls@codepage{utf8}}{}% + \fi + } +\else + \newcommand*{\GlsSetXdyCodePage}[1]{% + \glsnoxindywarning\GlsSetXdyCodePage} +\fi +\ifglsxindy + \ifgls@xindy@glsnumbers + \def\@xdylettergroups{(define-letter-group + \string"glsnumbers\string"^^J\space\space\space + :prefixes (\string"0\string" \string"1\string" + \string"2\string" \string"3\string" \string"4\string" + \string"5\string" \string"6\string" \string"7\string" + \string"8\string" \string"9\string")^^J\space\space\space + \@xdynumbergrouporder)} + \else + \def\@xdylettergroups{} + \fi +\fi + \newcommand*\GlsAddLetterGroup[2]{% + \expandafter\toks@\expandafter{\@xdylettergroups}% + \protected@edef\@xdylettergroups{\the\toks@^^J% + (define-letter-group \string"#1\string"^^J\space\space\space#2)}% + }% +\newcommand*{\forallglossaries}[3][\@glo@types]{% + \@for#2:=#1\do{\ifx#2\@empty\else#3\fi}% +} + +\newcommand*{\forallacronyms}[2]{% + \@for#1:=\@glsacronymlists\do{\ifx#1\@empty\else#2\fi}% +} +\newcommand*{\forglsentries}[3][\glsdefaulttype]{% + \edef\@@glo@list{\csname glolist@#1\endcsname}% + \@for#2:=\@@glo@list\do + {% + \ifdefempty{#2}{}{#3}% + }% +} +\newcommand*{\forallglsentries}[3][\@glo@types]{% + \expandafter\forallglossaries\expandafter[#1]{\@@this@glo@}% + {% + \forglsentries[\@@this@glo@]{#2}{#3}% + }% +} +\newcommand{\ifglossaryexists}{% + \@ifstar\s@ifglossaryexists\@ifglossaryexists +} +\newcommand{\@ifglossaryexists}[3]{% + \ifcsundef{@glotype@#1@out}{#3}{#2}% +} +\newcommand{\s@ifglossaryexists}[3]{% + \ifcsundef{glolist@#1}{#3}{#2}% +} +\newcommand*{\glsdetoklabel}[1]{#1} +\newcommand{\ifglsentryexists}[3]{% + \ifcsundef{glo@\glsdetoklabel{#1}@name}{#3}{#2}% +} +\newcommand*{\ifglsused}[3]{% + \ifbool{glo@\glsdetoklabel{#1}@flag}{#2}{#3}% +} +\newcommand{\glsdoifexists}[2]{% + \ifglsentryexists{#1}{#2}{% + \PackageError{glossaries}{Glossary entry `\glsdetoklabel{#1}' + has not been defined}{You need to define a glossary entry before you + can use it.}}% +} +\newcommand{\glsdoifnoexists}[2]{% + \ifglsentryexists{#1}{% + \PackageError{glossaries}{Glossary entry `\glsdetoklabel{#1}' has already + been defined}{}}{#2}% +} +\newcommand{\glsdoifexistsorwarn}[2]{% + \ifglsentryexists{#1}{#2}{% + \GlossariesWarning{Glossary entry `\glsdetoklabel{#1}' + has not been defined}% + }% +} +\newcommand{\glsdoifexistsordo}[3]{% + \ifglsentryexists{#1}{#2}{% + \PackageError{glossaries}{Glossary entry `\glsdetoklabel{#1}' + has not been defined}{You need to define a glossary entry before you + can use it.}% + #3% + }% +} +\newcommand{\doifglossarynoexistsordo}[3]{% + \ifglossaryexists*{#1}% + {% + \PackageError{glossaries}{Glossary type `#1' already exists}{}% + #3% + }% + {#2}% +} +\newrobustcmd{\ifglshaschildren}[3]{% + \glsdoifexists{#1}% + {% + \def\do@glshaschildren{#3}% + \edef\@gls@thislabel{\glsdetoklabel{#1}}% + \expandafter\forglsentries\expandafter + [\csname glo@\@gls@thislabel @type\endcsname] + {\glo@label}% + {% + \letcs\glo@parent{glo@\glo@label @parent}% + \ifdefequal\@gls@thislabel\glo@parent + {% + \def\do@glshaschildren{#2}% + \@endfortrue + }% + {}% + }% + \do@glshaschildren + }% +} +\newcommand{\ifglshasparent}[3]{% + \glsdoifexists{#1}% + {% + \ifcsempty{glo@\glsdetoklabel{#1}@parent}{#3}{#2}% + }% +} +\newcommand*{\ifglshasdesc}[3]{% + \ifcsempty{glo@\glsdetoklabel{#1}@desc}% + {#3}% + {#2}% +} +\newcommand*{\ifglsdescsuppressed}[3]{% + \ifcsequal{glo@\glsdetoklabel{#1}@desc}{@no@post@desc}% + {#2}% + {#3}% +} +\newrobustcmd*{\ifglshassymbol}[3]{% + \letcs{\@glo@symbol}{glo@\glsdetoklabel{#1}@symbol}% + \ifdefempty\@glo@symbol + {#3}% + {% + \ifdefequal\@glo@symbol\@gls@default@value + {#3}% + {#2}% + }% +} +\newrobustcmd*{\ifglshaslong}[3]{% + \letcs{\@glo@long}{glo@\glsdetoklabel{#1}@long}% + \ifdefempty\@glo@long + {#3}% + {% + \ifdefequal\@glo@long\@gls@default@value + {#3}% + {#2}% + }% +} +\newrobustcmd*{\ifglshasshort}[3]{% + \letcs{\@glo@short}{glo@\glsdetoklabel{#1}@short}% + \ifdefempty\@glo@short + {#3}% + {% + \ifdefequal\@glo@short\@gls@default@value + {#3}% + {#2}% + }% +} +\newrobustcmd*{\ifglshasfield}[4]{% + \glsdoifexists{#2}% + {% + \letcs{\@glo@thisvalue}{glo@\glsdetoklabel{#2}@#1}% + \ifdef\@glo@thisvalue + {% + \ifdefempty\@glo@thisvalue + {% + #4% + }% + {% + \ifdefequal\@glo@thisvalue\@gls@default@value + {% + #4% + }% + {% + \let\glscurrentfieldvalue\@glo@thisvalue + #3% + }% + }% + }% + {% + \@gls@fetchfield{\@gls@thisfield}{#1}% + \ifdef\@gls@thisfield + {% + \letcs{\@glo@thisvalue}{glo@\glsdetoklabel{#2}@\@gls@thisfield}% + \ifdefempty\@glo@thisvalue + {% + #4% + }% + {% + \ifdefequal\@glo@thisvalue\@gls@default@value + {% + #4% + }% + {% + \let\glscurrentfieldvalue\@glo@thisvalue + #3% + }% + }% + }% + {% + \GlossariesWarning{Unknown entry field `#1'}% + #4% + }% + }% + }% +} +\newcommand*{\glscurrentfieldvalue}{} +\newcommand*{\@glo@types}{,} +\newcommand*\@gls@provide@newglossary{% + \protected@write\@auxout{}{\string\providecommand\string\@newglossary[4]{}}% + \let\@gls@provide@newglossary\relax +} +\newcommand*{\defglsentryfmt}[2][\glsdefaulttype]{% + \csgdef{gls@#1@entryfmt}{#2}% +} +\newcommand*{\gls@doentryfmt}[1]{\csuse{gls@#1@entryfmt}} +\newcommand*{\@gls@forbidtexext}[1]{% + \ifboolexpr{test {\ifdefstring{#1}{tex}} + or test {\ifdefstring{#1}{TEX}}} + {% + \def#1{nottex}% + \PackageError{glossaries}% + {Forbidden `.tex' extension replaced with `.nottex'}% + {I'm sorry, I can't allow you to do something so reckless.\MessageBreak + Don't use `.tex' as an extension for a temporary file.}% + }% + {% + }% +} +\newcommand*{\gls@gobbleopt}{\new@ifnextchar[{\@gls@gobbleopt}{}} +\def\@gls@gobbleopt[#1]{} +\newcommand*{\newglossary}{\@ifstar\s@newglossary\ns@newglossary} +\newcommand*{\s@newglossary}[2]{% + \ns@newglossary[#1-glg]{#1}{#1-gls}{#1-glo}{#2}% +} +\newcommand*{\ns@newglossary}[5][glg]{% + \doifglossarynoexistsordo{#2}% + {% + \ifundef\glsdefaulttype + {% + \gdef\glsdefaulttype{#2}% + }{}% + \toks@{#2}\edef\@glo@types{\@glo@types\the\toks@,}% + \expandafter\gdef\csname glolist@#2\endcsname{,}% + \expandafter\edef\csname @glotype@#2@log\endcsname{#1}% + \expandafter\edef\csname @glotype@#2@in\endcsname{#3}% + \expandafter\edef\csname @glotype@#2@out\endcsname{#4}% + \expandafter\@gls@forbidtexext\csname @glotype@#2@log\endcsname + \expandafter\@gls@forbidtexext\csname @glotype@#2@in\endcsname + \expandafter\@gls@forbidtexext\csname @glotype@#2@out\endcsname + \expandafter\def\csname @glotype@#2@title\endcsname{#5}% + \@gls@provide@newglossary + \protected@write\@auxout{}{\string\@newglossary{#2}{#1}{#3}{#4}}% + \ifcsundef{gls@#2@entryfmt}% + {% + \defglsentryfmt[#2]{\glsentryfmt}% + }% + {}% + \@gls@defsortcount{#2}% + \@ifnextchar[{\@gls@setcounter{#2}}% + {\@gls@setcounter{#2}[\glscounter]}% + }% + {% + \gls@gobbleopt + }% +} +\newcommand*{\altnewglossary}[3]{% + \newglossary[#2-glg]{#1}{#2-gls}{#2-glo}{#3}% +} +\@onlypreamble{\newglossary} +\@onlypremakeg\newglossary +\newcommand*{\@newglossary}[4]{} +\def\@gls@setcounter#1[#2]{% + \expandafter\def\csname @glotype@#1@counter\endcsname{#2}% + \ifglsxindy + \GlsAddXdyCounters{#2}% + \fi +} +\newcommand*{\@gls@getcounter}[1]{% + \csname @glotype@#1@counter\endcsname +} +\glsdefmain +\@gls@do@acronymsdef +\@gls@do@symbolsdef +\@gls@do@numbersdef +\@gls@do@indexdef +\newcommand*{\newignoredglossary}[1]{% + \ifdefempty\@ignored@glossaries + {% + \edef\@ignored@glossaries{#1}% + }% + {% + \eappto\@ignored@glossaries{,#1}% + }% + \csgdef{glolist@#1}{,}% + \ifcsundef{gls@#1@entryfmt}% + {% + \defglsentryfmt[#1]{\glsentryfmt}% + }% + {}% + \ifdefempty\@gls@nohyperlist + {% + \renewcommand*{\@gls@nohyperlist}{#1}% + }% + {% + \eappto\@gls@nohyperlist{,#1}% + }% +} +\newcommand*{\@ignored@glossaries}{} +\newcommand*{\ifignoredglossary}[3]{% + \edef\@gls@igtype{#1}% + \expandafter\DTLifinlist\expandafter + {\@gls@igtype}{\@ignored@glossaries}{#2}{#3}% +} +\define@key{glossentry}{name}{% +\def\@glo@name{#1}% +} +\define@key{glossentry}{description}{% +\def\@glo@desc{#1}% +} +\define@key{glossentry}{descriptionplural}{% +\def\@glo@descplural{#1}% +} +\define@key{glossentry}{sort}{% +\def\@glo@sort{#1}} +\define@key{glossentry}{text}{% +\def\@glo@text{#1}% +} +\define@key{glossentry}{plural}{% +\def\@glo@plural{#1}% +} +\define@key{glossentry}{first}{% +\def\@glo@first{#1}% +} +\define@key{glossentry}{firstplural}{% +\def\@glo@firstplural{#1}% +} +\newcommand*{\@gls@default@value}{\relax} +\define@key{glossentry}{symbol}{% +\def\@glo@symbol{#1}% +} +\define@key{glossentry}{symbolplural}{% +\def\@glo@symbolplural{#1}% +} +\define@key{glossentry}{type}{% +\def\@glo@type{#1}} +\define@key{glossentry}{counter}{% + \ifcsundef{c@#1}% + {% + \PackageError{glossaries}% + {There is no counter called `#1'}% + {% + The counter key should have the name of a valid counter + as its value% + }% + }% + {% + \def\@glo@counter{#1}% + }% +} +\define@key{glossentry}{see}{% + \gls@set@xr@key{see}{\@glo@see}{#1}% +} +\newcommand*{\gls@set@xr@key}[3]{% + \renewcommand*{\gls@xr@key}{#1}% + \gls@checkseeallowed + \def#2{#3}% + \@glo@seeautonumberlist +} +\newcommand*{\gls@xr@key}{see} +\newcommand*{\gls@checkseeallowed}{% + \@gls@see@noindex +} +\newcommand*{\gls@checkseeallowed@preambleonly}{% + \GlossariesWarning{glossaries}% + {`\gls@xr@key' key doesn't have any effect when used in the document + environment. Move the definition to the preamble + after \string\makeglossaries\space + or \string\makenoidxglossaries}% +} +\define@key{glossentry}{parent}{% +\def\@glo@parent{#1}} +\define@choicekey{glossentry}{nonumberlist}% + [\gls@nonumberlist@val\gls@nonumberlist@nr]{true,false}[true]% +{% + \ifcase\gls@nonumberlist@nr\relax + \def\@glo@prefix{\glsnonextpages}% + \@gls@savenonumberlist{true}% + \else + \def\@glo@prefix{\glsnextpages}% + \@gls@savenonumberlist{false}% + \fi +} +\newcommand*{\@gls@savenonumberlist}[1]{} +\newcommand*{\@gls@initnonumberlist}{}% +\newcommand*{\@gls@storenonumberlist}[1]{} +\newcommand*{\@gls@enablesavenonumberlist}{% + \renewcommand*{\@gls@initnonumberlist}{% + \undef\@glo@nonumberlist + }% + \renewcommand*{\@gls@savenonumberlist}[1]{% + \def\@glo@nonumberlist{##1}% + }% + \renewcommand*{\@gls@storenonumberlist}[1]{% + \ifdef\@glo@nonumberlist + {% + \cslet{glo@\glsdetoklabel{##1}@nonumberlist}{\@glo@nonumberlist}% + }% + {}% + }% + \appto\@gls@keymap{,{nonumberlist}{nonumberlist}}% +} +\define@key{glossentry}{user1}{% + \def\@glo@useri{#1}% +} +\define@key{glossentry}{user2}{% + \def\@glo@userii{#1}% +} +\define@key{glossentry}{user3}{% + \def\@glo@useriii{#1}% +} +\define@key{glossentry}{user4}{% + \def\@glo@useriv{#1}% +} +\define@key{glossentry}{user5}{% + \def\@glo@userv{#1}% +} +\define@key{glossentry}{user6}{% + \def\@glo@uservi{#1}% +} +\define@key{glossentry}{short}{% + \def\@glo@short{#1}% +} +\define@key{glossentry}{shortplural}{% + \def\@glo@shortpl{#1}% +} +\define@key{glossentry}{long}{% + \def\@glo@long{#1}% +} +\define@key{glossentry}{longplural}{% + \def\@glo@longpl{#1}% +} +\newcommand*{\@glsnoname}{% + \PackageError{glossaries}{name key required in + \string\newglossaryentry\space for entry `\@glo@label'}{You + haven't specified the entry name}} +\newcommand*\@glsnodesc{% + \PackageError{glossaries} + {% + description key required in \string\newglossaryentry\space + for entry `\@glo@label'% + }% + {% + You haven't specified the entry description% + }% +}% +\newcommand*{\@glsdefaultplural}{} +\newcommand*{\@gls@missingnumberlist}[1]{% + ??% + \ifglssavenumberlist + \GlossariesWarning{Missing number list for entry `#1'. + Maybe makeglossaries + rerun required}% + \else + \PackageError{glossaries}% + {Package option `savenumberlist=true' required}% + {% + You must use the `savenumberlist' package option + to reference location lists.% + }% + \fi +} +\newcommand*{\@glsdefaultsort}{\@glo@name} +\newcount\gls@level +\newcommand{\@@gls@noexpand@field}[3]{% + \expandafter\global\expandafter + \let\csname glo@#1@#2\endcsname#3% +} +\newcommand{\@gls@noexpand@fields}[4]{% + \ifcsdef{gls@assign@#3@field} + {% + \ifdefequal{#4}{\@gls@default@value}% + {% + \edef\@gls@value{\expandonce{#1}}% + \csuse{gls@assign@#3@field}{#2}{\@gls@value}% + }% + {% + \csuse{gls@assign@#3@field}{#2}{#4}% + }% + }% + {% + \ifdefequal{#4}{\@gls@default@value}% + {% + \edef\@gls@value{\expandonce{#1}}% + \@@gls@noexpand@field{#2}{#3}{\@gls@value}% + }% + {% + \@@gls@noexpand@field{#2}{#3}{#4}% + }% + }% +} +\newcommand{\@@gls@expand@field}[3]{% + \expandafter + \protected@xdef\csname glo@#1@#2\endcsname{#3}% +} +\newcommand{\@gls@expand@fields}[4]{% + \ifcsdef{gls@assign@#3@field} + {% + \ifdefequal{#4}{\@gls@default@value}% + {% + \edef\@gls@value{\expandonce{#1}}% + \csuse{gls@assign@#3@field}{#2}{\@gls@value}% + }% + {% + \expandafter\@gls@startswithexpandonce#4\relax\relax\gls@endcheck + {% + \@@gls@expand@field{#2}{#3}{#4}% + }% + {% + \csuse{gls@assign@#3@field}{#2}{#4}% + }% + }% + }% + {% + \ifdefequal{#4}{\@gls@default@value}% + {% + \@@gls@expand@field{#2}{#3}{#1}% + }% + {% + \@@gls@expand@field{#2}{#3}{#4}% + }% + }% +} +\def\@gls@expandonce{\expandonce} +\def\@gls@startswithexpandonce#1#2\gls@endcheck#3#4{% + \def\@gls@tmp{#1}% + \ifdefequal{\@gls@expandonce}{\@gls@tmp}{#3}{#4}% +} +\let\gls@assign@field\@gls@expand@fields +\newcommand*{\glsexpandfields}{% + \let\gls@assign@field\@gls@expand@fields +} +\newcommand*{\glsnoexpandfields}{% + \let\gls@assign@field\@gls@noexpand@fields +} +\newrobustcmd{\newglossaryentry}[2]{% + \glsdoifnoexists{#1}% + {% + \gls@defglossaryentry{#1}{#2}% + }% +} +\newcommand*{\gls@defdocnewglossaryentry}{% + \let\gls@checkseeallowed\gls@checkseeallowed@preambleonly + \let\newglossaryentry\new@glossaryentry +} +\newrobustcmd{\provideglossaryentry}[2]{% + \ifglsentryexists{#1}% + {}% + {% + \gls@defglossaryentry{#1}{#2}% + }% +} +\@onlypreamble{\provideglossaryentry} +\newrobustcmd{\new@glossaryentry}[2]{% + \ifundef\@gls@deffile + {% + \global\newwrite\@gls@deffile + \immediate\openout\@gls@deffile=\jobname.glsdefs + }% + {}% + \ifglsentryexists{#1}{}% + {% + \gls@defglossaryentry{#1}{#2}% + }% + \@gls@writedef{#1}% +} +\AtBeginDocument{\gls@begindocdefs} +\AtEndDocument{\ifdef\@gls@deffile{\closeout\@gls@deffile}{}} +\newcommand*{\gls@begindocdefs}{% + \@gls@enablesavenonumberlist + \edef\@gls@restoreat{\noexpand\catcode`\noexpand\@=\number\catcode`\@\relax}% + \makeatletter + \InputIfFileExists{\jobname.glsdefs}{}{}% + \@gls@restoreat + \undef\@gls@restoreat + \gls@defdocnewglossaryentry +} +\newcommand*{\@gls@writedef}[1]{% + \immediate\write\@gls@deffile + {% + \string\ifglsentryexists{#1}{}\glspercentchar^^J% + \expandafter\@gobble\string\{\glspercentchar^^J% + \string\gls@defglossaryentry{\glsdetoklabel{#1}}\glspercentchar^^J% + \expandafter\@gobble\string\{\glspercentchar% + }% + \@for\@gls@map:=\@gls@keymap\do + {% + \letcs\glo@value{glo@\glsdetoklabel{#1}@\expandafter\@secondoftwo\@gls@map}% + \ifdef\glo@value + {% + \@onelevel@sanitize\glo@value + \immediate\write\@gls@deffile + {% + \expandafter\@firstoftwo\@gls@map + =\expandafter\@gobble\string\{\glo@value\expandafter\@gobble\string\},% + \glspercentchar + }% + }% + {}% + }% + \glswritedefhook + \immediate\write\@gls@deffile + {% + \glspercentchar^^J% + \expandafter\@gobble\string\}\glspercentchar^^J% + \expandafter\@gobble\string\}\glspercentchar% + }% +} +\newcommand*{\@gls@keymap}{% + {name}{name},% + {sort}{sortvalue},% unescaped sort value + {type}{type},% + {first}{first},% + {firstplural}{firstpl},% + {text}{text},% + {plural}{plural},% + {description}{desc},% + {descriptionplural}{descplural},% + {symbol}{symbol},% + {symbolplural}{symbolplural},% + {user1}{useri},% + {user2}{userii},% + {user3}{useriii},% + {user4}{useriv},% + {user5}{userv},% + {user6}{uservi},% + {long}{long},% + {longplural}{longpl},% + {short}{short},% + {shortplural}{shortpl},% + {counter}{counter},% + {parent}{parent}% +} +\newcommand*{\@gls@fetchfield}[2]{% + \edef\@gls@thisval{#2}% + \@for\@gls@map:=\@gls@keymap\do{% + \edef\@this@key{\expandafter\@firstoftwo\@gls@map}% + \ifdefequal{\@this@key}{\@gls@thisval}% + {% + \edef#1{\expandafter\@secondoftwo\@gls@map}% + \@endfortrue + }% + {}% + }% +} +\newcommand*{\glsaddstoragekey}{\@ifstar\@sglsaddstoragekey\@glsaddstoragekey} +\newcommand*{\@sglsaddstoragekey}[1]{% + \key@ifundefined{glossentry}{#1}% + {% + \expandafter\newcommand\expandafter*\expandafter + {\csname gls@assign@#1@field\endcsname}[2]{% + \@@gls@expand@field{##1}{#1}{##2}% + }% + }% + {}% + \@glsaddstoragekey{#1}% +} +\newcommand*{\@glsaddstoragekey}[3]{% + \key@ifundefined{glossentry}{#1}% + {% + \define@key{glossentry}{#1}{\csdef{@glo@#1}{##1}}% + \appto\@gls@keymap{,{#1}{#1}}% + \appto\@newglossaryentryprehook{\csdef{@glo@#1}{#2}}% + \appto\@newglossaryentryposthook{% + \letcs{\@glo@tmp}{@glo@#1}% + \gls@assign@field{#2}{\@glo@label}{#1}{\@glo@tmp}% + }% + \newcommand*{#3}[1]{\@gls@entry@field{##1}{#1}}% + }% + {% + \PackageError{glossaries}{Key `#1' already exists}{}% + }% +} +\newcommand*{\glsaddkey}{\@ifstar\@sglsaddkey\@glsaddkey} +\newcommand*{\@sglsaddkey}[1]{% + \key@ifundefined{glossentry}{#1}% + {% + \expandafter\newcommand\expandafter*\expandafter + {\csname gls@assign@#1@field\endcsname}[2]{% + \@@gls@expand@field{##1}{#1}{##2}% + }% + }% + {}% + \@glsaddkey{#1}% +} +\newcommand*{\@glsaddkey}[7]{% + \key@ifundefined{glossentry}{#1}% + {% + \define@key{glossentry}{#1}{\csdef{@glo@#1}{##1}}% + \appto\@gls@keymap{,{#1}{#1}}% + \appto\@newglossaryentryprehook{\csdef{@glo@#1}{#2}}% + \appto\@newglossaryentryposthook{% + \letcs{\@glo@tmp}{@glo@#1}% + \gls@assign@field{#2}{\@glo@label}{#1}{\@glo@tmp}% + }% + \newcommand*{#3}[1]{\@gls@entry@field{##1}{#1}}% + \newcommand*{#4}[1]{\@Gls@entry@field{##1}{#1}}% + \ifcsdef{@gls@user@#1@}% + {% + \PackageError{glossaries}% + {Can't define `\string#5' as helper command + `\expandafter\string\csname @gls@user@#1@\endcsname' already exists}% + {}% + }% + {% + \expandafter\newcommand\expandafter*\expandafter + {\csname @gls@user@#1\endcsname}[2][]{% + \new@ifnextchar[% + {\csuse{@gls@user@#1@}{##1}{##2}}% + {\csuse{@gls@user@#1@}{##1}{##2}[]}}% + \csdef{@gls@user@#1@}##1##2[##3]{% + \@gls@field@link{##1}{##2}{#3{##2}##3}% + }% + \newrobustcmd*{#5}{% + \expandafter\@gls@hyp@opt\csname @gls@user@#1\endcsname}% + }% + \ifcsdef{@Gls@user@#1@}% + {% + \PackageError{glossaries}% + {Can't define `\string#6' as helper command + `\expandafter\string\csname @Gls@user@#1@\endcsname' already exists}% + {}% + }% + {% + \expandafter\newcommand\expandafter*\expandafter + {\csname @Gls@user@#1\endcsname}[2][]{% + \new@ifnextchar[% + {\csuse{@Gls@user@#1@}{##1}{##2}}% + {\csuse{@Gls@user@#1@}{##1}{##2}[]}}% + \csdef{@Gls@user@#1@}##1##2[##3]{% + \@gls@field@link{##1}{##2}{#4{##2}##3}% + }% + \newrobustcmd*{#6}{% + \expandafter\@gls@hyp@opt\csname @Gls@user@#1\endcsname}% + }% + \ifcsdef{@GLS@user@#1@}% + {% + \PackageError{glossaries}% + {Can't define `\string#7' as helper command + `\expandafter\string\csname @GLS@user@#1@\endcsname' already exists}% + {}% + }% + {% + \expandafter\newcommand\expandafter*\expandafter + {\csname @GLS@user@#1\endcsname}[2][]{% + \new@ifnextchar[% + {\csuse{@GLS@user@#1@}{##1}{##2}}% + {\csuse{@GLS@user@#1@}{##1}{##2}[]}}% + \csdef{@GLS@user@#1@}##1##2[##3]{% + \@gls@field@link{##1}{##2}{\mfirstucMakeUppercase{#3{##2}##3}}% + }% + \newrobustcmd*{#7}{% + \expandafter\@gls@hyp@opt\csname @GLS@user@#1\endcsname}% + }% + }% + {% + \PackageError{glossaries}{Key `#1' already exists}{}% + }% +} +\newcommand{\glsfieldxdef}[3]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \protected@csxdef{glo@\@glo@label @#2}{#3}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand{\glsfieldedef}[3]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \protected@csedef{glo@\@glo@label @#2}{#3}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand{\glsfieldgdef}[3]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \expandafter\gdef\csname glo@\@glo@label @#2\endcsname{#3}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand{\glsfielddef}[3]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \expandafter\def\csname glo@\@glo@label @#2\endcsname{#3}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand{\glsfieldfetch}[3]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \letcs#3{glo@\@glo@label @#2}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand{\ifglsfieldeq}[5]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \ifcsstring{glo@\@glo@label @#2}{#3}{#4}{#5}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand{\ifglsfielddefeq}[5]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \expandafter\ifdefstrequal + \csname glo@\@glo@label @#2\endcsname{#3}{#4}{#5}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand{\ifglsfieldcseq}[5]{% + \glsdoifexists{#1}% + {% + \edef\@glo@label{\glsdetoklabel{#1}}% + \ifcsdef{glo@\@glo@label @#2}% + {% + \ifcsstrequal{glo@\@glo@label @#2}{#3}{#4}{#5}% + }% + {% + \PackageError{glossaries}{Key `#2' doesn't exist}{}% + }% + }% +} +\newcommand*{\glswritedefhook}{} +\newcommand*{\gls@assign@desc}[1]{% + \gls@assign@field{}{#1}{desc}{\@glo@desc}% + \gls@assign@field{\@glo@desc}{#1}{descplural}{\@glo@descplural}% +} +\newcommand{\longnewglossaryentry}[3]{% + \glsdoifnoexists{#1}% + {% + \bgroup + \let\@org@newglossaryentryprehook\@newglossaryentryprehook + \long\def\@newglossaryentryprehook{% + \long\def\@glo@desc{#3\leavevmode\unskip\nopostdesc}% + \@org@newglossaryentryprehook + }% + \renewcommand*{\gls@assign@desc}[1]{% + \global\cslet{glo@\glsdetoklabel{#1}@desc}{\@glo@desc}% + \global\cslet{glo@\glsdetoklabel{#1}@descplural}{\@glo@desc}% + } + \gls@defglossaryentry{#1}{#2}% + \egroup + } +} +\@onlypreamble{\longnewglossaryentry} +\newcommand{\longprovideglossaryentry}[3]{% + \ifglsentryexists{#1}{}% + {\longnewglossaryentry{#1}{#2}{#3}}% +} +\@onlypreamble{\longprovideglossaryentry} +\newcommand{\gls@defglossaryentry}[2]{% + \let\GlsSetQuote\gls@nosetquote + \edef\@glo@label{\glsdetoklabel{#1}}% + \let\glslabel\@glo@label + \let\@glo@name\@glsnoname + \let\@glo@desc\@glsnodesc + \let\@glo@descplural\@gls@default@value + \let\@glo@type\@gls@default@value + \let\@glo@symbol\@gls@default@value + \let\@glo@symbolplural\@gls@default@value + \let\@glo@text\@gls@default@value + \let\@glo@plural\@gls@default@value + \let\@glo@first\@gls@default@value + \let\@glo@firstplural\@gls@default@value + \let\@glo@sort\@gls@default@value + \let\@glo@counter\@gls@default@value + \def\@glo@see{}% + \def\@glo@parent{}% + \def\@glo@prefix{}% + \@gls@initnonumberlist + \def\@glo@useri{}% + \def\@glo@userii{}% + \def\@glo@useriii{}% + \def\@glo@useriv{}% + \def\@glo@userv{}% + \def\@glo@uservi{}% + \def\@glo@short{}% + \def\@glo@shortpl{}% + \def\@glo@long{}% + \def\@glo@longpl{}% + \@newglossaryentryprehook + \setkeys{glossentry}{#2}% + \ifundef\glsdefaulttype + {% + \PackageError{glossaries}% + {No default glossary type (have you used `nomain' by mistake?)}% + {If you use package option `nomain' you must define + a new glossary before you can define entries}% + }% + {}% + \gls@assign@field{\glsdefaulttype}{\@glo@label}{type}{\@glo@type}% + \edef\@glo@type{\glsentrytype{\@glo@label}}% + \ifcsundef{glolist@\@glo@type}% + {% + \PackageError{glossaries}% + {Glossary type `\@glo@type' has not been defined}% + {You need to define a new glossary type, before making entries + in it}% + }% + {% + \ifignoredglossary\@glo@type + {% + \ifx\@glo@desc\@glsnodesc + \let\@glo@desc\@empty + \fi + }% + {% + }% + \protected@edef\@glolist@{\csname glolist@\@glo@type\endcsname}% + \expandafter\xdef\csname glolist@\@glo@type\endcsname{% + \@glolist@{\@glo@label},}% + }% + \gls@level=0\relax + \ifx\@glo@parent\@empty + \expandafter\gdef\csname glo@\@glo@label @parent\endcsname{}% + \else + \ifdefequal\@glo@label\@glo@parent% + {% + \PackageError{glossaries}{Entry `\@glo@label' can't be its own parent}{}% + \def\@glo@parent{}% + \expandafter\gdef\csname glo@\@glo@label @parent\endcsname{}% + }% + {% + \ifglsentryexists{\@glo@parent}% + {% + \expandafter\xdef\csname glo@\@glo@label @parent\endcsname{% + \@glo@parent}% + \gls@level=\csname glo@\@glo@parent @level\endcsname\relax + \advance\gls@level by 1\relax + \ifx\@glo@name\@glsnoname + \expandafter\let\expandafter\@glo@name + \csname glo@\@glo@parent @name\endcsname + \ifx\@glo@plural\@gls@default@value + \expandafter\let\expandafter\@glo@plural + \csname glo@\@glo@parent @plural\endcsname + \fi + \fi + }% + {% + \PackageError{glossaries}% + {% + Invalid parent `\@glo@parent' + for entry `\@glo@label' - parent doesn't exist% + }% + {% + Parent entries must be defined before their children% + }% + \def\@glo@parent{}% + \expandafter\gdef\csname glo@\@glo@label @parent\endcsname{}% + }% + }% + \fi + \expandafter\xdef\csname glo@\@glo@label @level\endcsname{\number\gls@level}% + \gls@assign@field{\@glo@name}{\@glo@label}{sortvalue}{\@glo@sort}% + \letcs\@glo@sort{glo@\@glo@label @sortvalue}% + \gls@assign@field{\@glo@name}{\@glo@label}{text}{\@glo@text}% + \expandafter\gls@assign@field\expandafter + {\csname glo@\@glo@label @text\endcsname\glspluralsuffix}% + {\@glo@label}{plural}{\@glo@plural}% + \expandafter\gls@assign@field\expandafter + {\csname glo@\@glo@label @text\endcsname}% + {\@glo@label}{first}{\@glo@first}% + \ifx\@glo@first\@gls@default@value + \expandafter\gls@assign@field\expandafter + {\csname glo@\@glo@label @plural\endcsname}% + {\@glo@label}{firstpl}{\@glo@firstplural}% + \else + \expandafter\gls@assign@field\expandafter + {\csname glo@\@glo@label @first\endcsname\glspluralsuffix}% + {\@glo@label}{firstpl}{\@glo@firstplural}% + \fi + \ifcsundef{@glotype@\@glo@type @counter}% + {% + \def\@glo@defaultcounter{\glscounter}% + }% + {% + \letcs\@glo@defaultcounter{@glotype@\@glo@type @counter}% + }% + \gls@assign@field{\@glo@defaultcounter}{\@glo@label}{counter}{\@glo@counter}% + \gls@assign@field{}{\@glo@label}{useri}{\@glo@useri}% + \gls@assign@field{}{\@glo@label}{userii}{\@glo@userii}% + \gls@assign@field{}{\@glo@label}{useriii}{\@glo@useriii}% + \gls@assign@field{}{\@glo@label}{useriv}{\@glo@useriv}% + \gls@assign@field{}{\@glo@label}{userv}{\@glo@userv}% + \gls@assign@field{}{\@glo@label}{uservi}{\@glo@uservi}% + \gls@assign@field{}{\@glo@label}{short}{\@glo@short}% + \gls@assign@field{}{\@glo@label}{shortpl}{\@glo@shortpl}% + \gls@assign@field{}{\@glo@label}{long}{\@glo@long}% + \gls@assign@field{}{\@glo@label}{longpl}{\@glo@longpl}% + \ifx\@glo@name\@glsnoname + \@glsnoname + \let\@gloname\@gls@default@value + \fi + \gls@assign@field{}{\@glo@label}{name}{\@glo@name}% + \ifcsundef{glo@\@glo@label @numberlist}% + {% + \csxdef{glo@\@glo@label @numberlist}{% + \noexpand\@gls@missingnumberlist{\@glo@label}}% + }% + {}% + \@gls@storenonumberlist{\@glo@label}% + \def\@glo@@desc{\@glo@first}% + \ifx\@glo@desc\@glo@@desc + \let\@glo@desc\@glo@first + \fi + \ifx\@glo@desc\@glsnodesc + \@glsnodesc + \let\@glodesc\@gls@default@value + \fi + \gls@assign@desc{\@glo@label}% + \@gls@defsort{\@glo@type}{\@glo@label}% + \def\@glo@@symbol{\@glo@text}% + \ifx\@glo@symbol\@glo@@symbol + \let\@glo@symbol\@glo@text + \fi + \gls@assign@field{\relax}{\@glo@label}{symbol}{\@glo@symbol}% + \expandafter + \gls@assign@field\expandafter + {\csname glo@\@glo@label @symbol\endcsname} + {\@glo@label}{symbolplural}{\@glo@symbolplural}% + \expandafter\xdef\csname glo@\@glo@label @flagfalse\endcsname{% + \noexpand\global + \noexpand\let\expandafter\noexpand + \csname ifglo@\@glo@label @flag\endcsname\noexpand\iffalse + }% + \expandafter\xdef\csname glo@\@glo@label @flagtrue\endcsname{% + \noexpand\global + \noexpand\let\expandafter\noexpand + \csname ifglo@\@glo@label @flag\endcsname\noexpand\iftrue + }% + \csname glo@\@glo@label @flagfalse\endcsname + \@glo@autosee + \ifignoredglossary\@glo@type + {% + \csdef{glo@\@glo@label @index}{}% + } + {% + \do@glo@storeentry{\@glo@label}% + }% + \@newglossaryentry@defcounters + \@newglossaryentryposthook +} +\newcommand*{\@glo@autosee}{% + \ifdefvoid\@glo@see{}% + {% + \protected@edef\@do@glssee{% + \noexpand\@gls@fixbraces\noexpand\@glo@list\@glo@see\noexpand\@nil + \noexpand\expandafter\noexpand\@glssee\noexpand\@glo@list{\@glo@label}}% + \@do@glssee + }% + \@glo@autoseehook +}% +\newcommand*{\@glo@autoseehook}{} +\newcommand*{\@newglossaryentryprehook}{} +\newcommand*{\@newglossaryentryposthook}{} +\newcommand*{\@newglossaryentry@defcounters}{} +\newcommand*{\glsmoveentry}[2]{% + \edef\@glo@thislabel{\glsdetoklabel{#1}}% + \edef\glo@type{\csname glo@\@glo@thislabel @type\endcsname}% + \def\glo@list{,}% + \forglsentries[\glo@type]{\glo@label}% + {% + \ifdefequal\@glo@thislabel\glo@label + {}{\eappto\glo@list{\glo@label,}}% + }% + \cslet{glolist@\glo@type}{\glo@list}% + \csdef{glo@\@glo@thislabel @type}{#2}% +} +\ifglsxindy + \newcommand*{\@glossaryentryfield}{\string\\glossentry} +\else + \newcommand*{\@glossaryentryfield}{\string\glossentry} +\fi +\ifglsxindy + \newcommand*{\@glossarysubentryfield}{% + \string\\subglossentry} +\else + \newcommand*{\@glossarysubentryfield}{% + \string\subglossentry} +\fi +\newcommand{\@glo@storeentry}[1]{% + \edef\@glo@esclabel{#1}% + \@gls@checkmkidxchars\@glo@esclabel + \protected@edef\@glo@sort{\csname glo@#1@sort\endcsname}% + \@gls@checkmkidxchars\@glo@sort + \@gls@checkmkidxchars\@glo@prefix + \edef\@glo@parent{\csname glo@#1@parent\endcsname}% + \ifglsxindy + \ifx\@glo@parent\@empty + \expandafter\protected@xdef\csname glo@#1@index\endcsname{% + (\string"\@glo@sort\string" % + \string"\@glo@prefix\@glossaryentryfield{\@glo@esclabel}\string") % + }% + \else + \expandafter\protected@xdef\csname glo@#1@index\endcsname{% + \csname glo@\@glo@parent @index\endcsname + (\string"\@glo@sort\string" % + \string"\@glo@prefix\@glossarysubentryfield + {\csname glo@#1@level\endcsname}{\@glo@esclabel}\string") % + }% + \fi + \else + \ifx\@glo@parent\@empty + \@onelevel@sanitize\@glo@prefix + \expandafter\protected@xdef\csname glo@#1@index\endcsname{% + \@glo@sort\@gls@actualchar\@glo@prefix + \@glossaryentryfield{\@glo@esclabel}% + }% + \else + \expandafter\protected@xdef\csname glo@#1@index\endcsname{% + \csname glo@\@glo@parent @index\endcsname\@gls@levelchar + \@glo@sort\@gls@actualchar\@glo@prefix + \@glossarysubentryfield + {\csname glo@#1@level\endcsname}{\@glo@esclabel}% + }% + \fi + \fi +} +\AtBeginDocument{% + \@ifpackageloaded{amsmath}% + {\let\gls@ifnotmeasuring\@gls@ifnotmeasuring}% + {}% +} +\newcommand*{\@gls@ifnotmeasuring}[1]{% + \ifmeasuring@ + \else + #1% + \fi +} +\newcommand*\gls@ifnotmeasuring[1]{#1} +\def\@gls@patchtabularx#1\hbox#2#3!!{% + \def\TX@trial##1{#1\hbox{\let\glsunset\@gobble#2}#3}% +} +\newcommand*\glspatchtabularx{% + \ifdef\TX@trial + {% + \expandafter\@gls@patchtabularx\TX@trial{##1}!!% + \let\glspatchtabularx\relax + }% + {}% +} +\newcommand*{\glsreset}[1]{% + \gls@ifnotmeasuring + {% + \glsdoifexists{#1}% + {% + \@glsreset{#1}% + }% + }% +} +\newcommand*{\glslocalreset}[1]{% + \gls@ifnotmeasuring + {% + \glsdoifexists{#1}% + {% + \@glslocalreset{#1}% + }% + }% +} +\newcommand*{\glsunset}[1]{% + \gls@ifnotmeasuring + {% + \glsdoifexists{#1}% + {% + \@glsunset{#1}% + }% + }% +} +\newcommand*{\glslocalunset}[1]{% + \gls@ifnotmeasuring + {% + \glsdoifexists{#1}% + {% + \@glslocalunset{#1}% + }% + }% +} +\newcommand*{\@glslocalunset}{\@@glslocalunset} +\newcommand*{\@@glslocalunset}[1]{% + \expandafter\let\csname ifglo@\glsdetoklabel{#1}@flag\endcsname\iftrue +} +\newcommand*{\@glsunset}{\@@glsunset} +\newcommand*{\@@glsunset}[1]{% + \expandafter\global\csname glo@\glsdetoklabel{#1}@flagtrue\endcsname +} +\newcommand*{\@glslocalreset}{\@@glslocalreset} +\newcommand*{\@@glslocalreset}[1]{% + \expandafter\let\csname ifglo@\glsdetoklabel{#1}@flag\endcsname\iffalse +} +\newcommand*{\@glsreset}{\@@glsreset} +\newcommand*{\@@glsreset}[1]{% + \expandafter\global\csname glo@\glsdetoklabel{#1}@flagfalse\endcsname +} +\newcommand*{\glsresetall}[1][\@glo@types]{% + \forallglsentries[#1]{\@glsentry}% + {% + \glsreset{\@glsentry}% + }% +} +\newcommand*{\glslocalresetall}[1][\@glo@types]{% + \forallglsentries[#1]{\@glsentry}% + {% + \glslocalreset{\@glsentry}% + }% +} +\newcommand*{\glsunsetall}[1][\@glo@types]{% + \forallglsentries[#1]{\@glsentry}% + {% + \glsunset{\@glsentry}% + }% +} +\newcommand*{\glslocalunsetall}[1][\@glo@types]{% + \forallglsentries[#1]{\@glsentry}% + {% + \glslocalunset{\@glsentry}% + }% +} +\newcommand*{\@@newglossaryentry@defcounters}{% + \csdef{glo@\@glo@label @currcount}{0}% + \csdef{glo@\@glo@label @prevcount}{0}% +} +\newcommand*{\glsenableentrycount}{% + \let\@newglossaryentry@defcounters\@@newglossaryentry@defcounters + \renewcommand*{\gls@defdocnewglossaryentry}{% + \renewcommand*\newglossaryentry[2]{% + \PackageError{glossaries}{\string\newglossaryentry\space + may only be used in the preamble when entry counting has + been activated}{If you use \string\glsenableentrycount\space + you must place all entry definitions in the preamble not in + the document environment}% + }% + }% + \newcommand*{\glsentrycurrcount}[1]{% + \ifcsundef{glo@\glsdetoklabel{##1}@currcount}% + {0}{\@gls@entry@field{##1}{currcount}}% + }% + \newcommand*{\glsentryprevcount}[1]{% + \ifcsundef{glo@\glsdetoklabel{##1}@prevcount}% + {0}{\@gls@entry@field{##1}{prevcount}}% + }% + \renewcommand*{\@glsunset}[1]{% + \@@glsunset{##1}% + \@gls@increment@currcount{##1}% + }% + \renewcommand*{\@glslocalunset}[1]{% + \@@glslocalunset{##1}% + \@gls@local@increment@currcount{##1}% + }% + \renewcommand*{\@glsreset}[1]{% + \@@glsreset{##1}% + \csgdef{glo@\glsdetoklabel{##1}@currcount}{0}% + }% + \renewcommand*{\@glslocalreset}[1]{% + \@@glslocalreset{##1}% + \csdef{glo@\glsdetoklabel{##1}@currcount}{0}% + }% + \def\@cgls@##1##2[##3]{% + \ifnum\glsentryprevcount{##2}=1\relax + \cglsformat{##2}{##3}% + \glsunset{##2}% + \else + \@gls@{##1}{##2}[##3]% + \fi + }% + \def\@cglspl@##1##2[##3]{% + \ifnum\glsentryprevcount{##2}=1\relax + \cglsplformat{##2}{##3}% + \glsunset{##2}% + \else + \@glspl@{##1}{##2}[##3]% + \fi + }% + \def\@cGls@##1##2[##3]{% + \ifnum\glsentryprevcount{##2}=1\relax + \cGlsformat{##2}{##3}% + \glsunset{##2}% + \else + \@Gls@{##1}{##2}[##3]% + \fi + }% + \def\@cGlspl@##1##2[##3]{% + \ifnum\glsentryprevcount{##2}=1\relax + \cGlsplformat{##2}{##3}% + \glsunset{##2}% + \else + \@Glspl@{##1}{##2}[##3]% + \fi + }% + \AtEndDocument{\@gls@write@entrycounts}% + \renewcommand*{\@gls@entry@count}[2]{% + \csgdef{glo@\glsdetoklabel{##1}@prevcount}{##2}% + }% + \let\glsenableentrycount\relax +} +\@onlypreamble\glsenableentrycount +\newcommand*{\@gls@increment@currcount}[1]{% + \csxdef{glo@\glsdetoklabel{#1}@currcount}{% + \number\numexpr\glsentrycurrcount{#1}+1}% +} +\newcommand*{\@gls@local@increment@currcount}[1]{% + \csedef{glo@\glsdetoklabel{#1}@currcount}{% + \number\numexpr\glsentrycurrcount{#1}+1}% +} +\newcommand*{\@gls@write@entrycounts}{% + \immediate\write\@auxout + {\string\providecommand*{\string\@gls@entry@count}[2]{}}% + \forallglsentries{\@glsentry}{% + \ifglsused{\@glsentry}% + {\immediate\write\@auxout + {\string\@gls@entry@count{\@glsentry}{\glsentrycurrcount{\@glsentry}}}}% + {}% + }% +} +\newcommand*{\@gls@entry@count}[2]{} +\newrobustcmd*{\cgls}{\@gls@hyp@opt\@cgls} +\newcommand*{\@cgls}[2][]{% + \new@ifnextchar[{\@cgls@{#1}{#2}}{\@cgls@{#1}{#2}[]}% +} +\def\@cgls@#1#2[#3]{% + \GlossariesWarning{\string\cgls\space is defaulting to + \string\gls\space since you haven't enabled entry counting}% + \@gls@{#1}{#2}[#3]% +} +\newcommand*{\cglsformat}[2]{% + \ifglshaslong{#1}{\glsentrylong{#1}}{\glsentryfirst{#1}}#2% +} +\newrobustcmd*{\cGls}{\@gls@hyp@opt\@cGls} +\newcommand*{\@cGls}[2][]{% + \new@ifnextchar[{\@cGls@{#1}{#2}}{\@cGls@{#1}{#2}[]}% +} +\def\@cGls@#1#2[#3]{% + \GlossariesWarning{\string\cGls\space is defaulting to + \string\Gls\space since you haven't enabled entry counting}% + \@Gls@{#1}{#2}[#3]% +} +\newcommand*{\cGlsformat}[2]{% + \ifglshaslong{#1}{\Glsentrylong{#1}}{\Glsentryfirst{#1}}#2% +} +\newrobustcmd*{\cglspl}{\@gls@hyp@opt\@cglspl} +\newcommand*{\@cglspl}[2][]{% + \new@ifnextchar[{\@cglspl@{#1}{#2}}{\@cglspl@{#1}{#2}[]}% +} +\def\@cglspl@#1#2[#3]{% + \GlossariesWarning{\string\cglspl\space is defaulting to + \string\glspl\space since you haven't enabled entry counting}% + \@glspl@{#1}{#2}[#3]% +} +\newcommand*{\cglsplformat}[2]{% + \ifglshaslong{#1}{\glsentrylongpl{#1}}{\glsentryfirstplural{#1}}#2% +} +\newrobustcmd*{\cGlspl}{\@gls@hyp@opt\@cGlspl} +\newcommand*{\@cGlspl}[2][]{% + \new@ifnextchar[{\@cGlspl@{#1}{#2}}{\@cGlspl@{#1}{#2}[]}% +} +\def\@cGlspl@#1#2[#3]{% + \GlossariesWarning{\string\cGlspl\space is defaulting to + \string\Glspl\space since you haven't enabled entry counting}% + \@Glspl@{#1}{#2}[#3]% +} +\newcommand*{\cGlsplformat}[2]{% + \ifglshaslong{#1}{\Glsentrylongpl{#1}}{\Glsentryfirstplural{#1}}#2% +} +\newcommand*{\loadglsentries}[2][\@gls@default]{% + \let\@gls@default\glsdefaulttype + \def\glsdefaulttype{#1}\input{#2}% + \let\glsdefaulttype\@gls@default +} +\@onlypreamble{\loadglsentries} +\newcommand*{\glstextformat}[1]{#1} +\newcommand*{\glsentryfmt}{% + \@@gls@default@entryfmt\glsdisplayfirst\glsdisplay +} +\newcommand*{\@@gls@default@entryfmt}[2]{% + \ifdefempty\glscustomtext + {% + \glsifplural + {% + \glscapscase + {% + \ifglsused\glslabel + {% + #2{\glsentryplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}% + }% + {% + #1{\glsentryfirstplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}% + }% + }% + {% + \ifglsused\glslabel + {% + \ifbool{glscompatible-3.07}% + {% + \protected@edef\@glo@etext{% + #2{\glsentryplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}}% + \xmakefirstuc\@glo@etext + }% + {% + #2{\Glsentryplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}% + }% + }% + {% + \ifbool{glscompatible-3.07}% + {% + \protected@edef\@glo@etext{% + #1{\glsentryfirstplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}}% + \xmakefirstuc\@glo@etext + }% + {% + #1{\Glsentryfirstplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}% + }% + }% + }% + {% + \ifglsused\glslabel + {% + \mfirstucMakeUppercase{#2{\glsentryplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}}% + }% + {% + \mfirstucMakeUppercase{#1{\glsentryfirstplural{\glslabel}}% + {\glsentrydescplural{\glslabel}}% + {\glsentrysymbolplural{\glslabel}}{\glsinsert}}% + }% + }% + }% + {% + \glscapscase + {% + \ifglsused\glslabel + {% + #2{\glsentrytext{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}% + }% + {% + #1{\glsentryfirst{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}% + }% + }% + {% + \ifglsused\glslabel + {% + \ifbool{glscompatible-3.07}% + {% + \protected@edef\@glo@etext{% + #2{\glsentrytext{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}}% + \xmakefirstuc\@glo@etext + }% + {% + #2{\Glsentrytext{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}% + }% + }% + {% + \ifbool{glscompatible-3.07}% + {% + \protected@edef\@glo@etext{% + #1{\glsentryfirst{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}}% + \xmakefirstuc\@glo@etext + }% + {% + #1{\Glsentryfirst{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}% + }% + }% + }% + {% + \ifglsused\glslabel + {% + \mfirstucMakeUppercase{#2{\glsentrytext{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}}% + }% + {% + \mfirstucMakeUppercase{#1{\glsentryfirst{\glslabel}}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{\glsinsert}}% + }% + }% + }% + }% + {% + \ifglsused{\glslabel}% + {% + #2{\glscustomtext}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{}% + }% + {% + #1{\glscustomtext}% + {\glsentrydesc{\glslabel}}% + {\glsentrysymbol{\glslabel}}{}% + }% + }% +} +\newcommand*{\glsgenentryfmt}{% + \ifdefempty\glscustomtext + {% + \glsifplural + {% + \glscapscase + {% + \ifglsused\glslabel + {% + \glsentryplural{\glslabel}\glsinsert + }% + {% + \glsentryfirstplural{\glslabel}\glsinsert + }% + }% + {% + \ifglsused\glslabel + {% + \Glsentryplural{\glslabel}\glsinsert + }% + {% + \Glsentryfirstplural{\glslabel}\glsinsert + }% + }% + {% + \ifglsused\glslabel + {% + \mfirstucMakeUppercase + {\glsentryplural{\glslabel}\glsinsert}% + }% + {% + \mfirstucMakeUppercase + {\glsentryfirstplural{\glslabel}\glsinsert}% + }% + }% + }% + {% + \glscapscase + {% + \ifglsused\glslabel + {% + \glsentrytext{\glslabel}\glsinsert + }% + {% + \glsentryfirst{\glslabel}\glsinsert + }% + }% + {% + \ifglsused\glslabel + {% + \Glsentrytext{\glslabel}\glsinsert + }% + {% + \Glsentryfirst{\glslabel}\glsinsert + }% + }% + {% + \ifglsused\glslabel + {% + \mfirstucMakeUppercase{\glsentrytext{\glslabel}\glsinsert}% + }% + {% + \mfirstucMakeUppercase{\glsentryfirst{\glslabel}\glsinsert}% + }% + }% + }% + }% + {% + \glscustomtext\glsinsert + }% +} +\newcommand*{\glsgenacfmt}{% + \ifdefempty\glscustomtext + {% + \ifglsused\glslabel + {% + \glsifplural + {% + \glscapscase + {% + \acronymfont{\glsentryshortpl{\glslabel}}\glsinsert + }% + {% + \acronymfont{\Glsentryshortpl{\glslabel}}\glsinsert + }% + {% + \mfirstucMakeUppercase + {\acronymfont{\glsentryshortpl{\glslabel}}\glsinsert}% + }% + }% + {% + \glscapscase + {% + \acronymfont{\glsentryshort{\glslabel}}\glsinsert + }% + {% + \acronymfont{\Glsentryshort{\glslabel}}\glsinsert + }% + {% + \mfirstucMakeUppercase + {\acronymfont{\glsentryshort{\glslabel}}\glsinsert}% + }% + }% + }% + {% + \glsifplural + {% + \glscapscase + {% + \genplacrfullformat{\glslabel}{\glsinsert}% + }% + {% + \Genplacrfullformat{\glslabel}{\glsinsert}% + }% + {% + \mfirstucMakeUppercase + {\genplacrfullformat{\glslabel}{\glsinsert}}% + }% + }% + {% + \glscapscase + {% + \genacrfullformat{\glslabel}{\glsinsert}% + }% + {% + \Genacrfullformat{\glslabel}{\glsinsert}% + }% + {% + \mfirstucMakeUppercase + {\genacrfullformat{\glslabel}{\glsinsert}}% + }% + }% + }% + }% + {% + \glscustomtext + }% +} +\newcommand*{\genacrfullformat}[2]{% + \glsentrylong{#1}#2\space + (\protect\firstacronymfont{\glsentryshort{#1}})% +} +\newcommand*{\Genacrfullformat}[2]{% + \protected@edef\gls@text{\genacrfullformat{#1}{#2}}% + \xmakefirstuc\gls@text +} +\newcommand*{\genplacrfullformat}[2]{% + \glsentrylongpl{#1}#2\space + (\protect\firstacronymfont{\glsentryshortpl{#1}})% +} +\newcommand*{\Genplacrfullformat}[2]{% + \protected@edef\gls@text{\genplacrfullformat{#1}{#2}}% + \xmakefirstuc\gls@text +} +\newcommand*{\glsdisplayfirst}[4]{#1#4} +\newcommand*{\glsdisplay}[4]{#1#4} +\newcommand*{\defglsdisplay}[2][\glsdefaulttype]{% + \GlossariesWarning{\string\defglsdisplay\space is now obsolete.^^J + Use \string\defglsentryfmt\space instead}% + \expandafter\def\csname gls@#1@display\endcsname##1##2##3##4{#2}% + \edef\@gls@doentrydef{% + \noexpand\defglsentryfmt[#1]{% + \noexpand\ifcsdef{gls@#1@displayfirst}% + {% + \noexpand\@@gls@default@entryfmt + {\noexpand\csuse{gls@#1@displayfirst}}% + {\noexpand\csuse{gls@#1@display}}% + }% + {% + \noexpand\@@gls@default@entryfmt + {\noexpand\glsdisplayfirst}% + {\noexpand\csuse{gls@#1@display}}% + }% + }% + }% + \@gls@doentrydef +} +\newcommand*{\defglsdisplayfirst}[2][\glsdefaulttype]{% + \GlossariesWarning{\string\defglsdisplayfirst\space is now obsolete.^^J + Use \string\defglsentryfmt\space instead}% + \expandafter\def\csname gls@#1@displayfirst\endcsname##1##2##3##4{#2}% + \edef\@gls@doentrydef{% + \noexpand\defglsentryfmt[#1]{% + \noexpand\ifcsdef{gls@#1@display}% + {% + \noexpand\@@gls@default@entryfmt + {\noexpand\csuse{gls@#1@displayfirst}}% + {\noexpand\csuse{gls@#1@display}}% + }% + {% + \noexpand\@@gls@default@entryfmt + {\noexpand\csuse{gls@#1@displayfirst}}% + {\noexpand\glsdisplay}% + }% + }% + }% + \@gls@doentrydef +} +\define@key{glslink}{counter}{% + \ifcsundef{c@#1}% + {% + \PackageError{glossaries}% + {There is no counter called `#1'}% + {% + The counter key should have the name of a valid counter + as its value% + }% + }% + {% + \def\@gls@counter{#1}% + }% +} +\define@key{glslink}{format}{% + \def\@glsnumberformat{#1}} +\define@boolkey{glslink}{hyper}[true]{} +\ifdef{\hyperlink}{\KV@glslink@hypertrue}{\KV@glslink@hyperfalse} +\define@boolkey{glslink}{local}[true]{} +\newcommand*{\glslinkvar}[3]{#1} +\newcommand*{\glsifhyper}[2]{% + \glslinkvar{#1}{#2}{#1}% + \GlossariesWarning{\string\glsifhyper\space is deprecated. Did + you mean \string\glsifhyperon\space or \string\glslinkvar?}% +} +\newcommand*{\@gls@hyp@opt}[1]{% + \let\glslinkvar\@firstofthree + \let\@gls@hyp@opt@cs#1\relax + \@ifstar{\s@gls@hyp@opt}% + {\@ifnextchar+{\@firstoftwo{\p@gls@hyp@opt}}{#1}}% +} +\newcommand*{\s@gls@hyp@opt}[1][]{% + \let\glslinkvar\@secondofthree + \@gls@hyp@opt@cs[hyper=false,#1]} +\newcommand*{\p@gls@hyp@opt}[1][]{% + \let\glslinkvar\@thirdofthree + \@gls@hyp@opt@cs[hyper=true,#1]} +\newrobustcmd*{\glslink}{% + \@gls@hyp@opt\@gls@@link +} +\newcommand*{\@gls@@link}[3][]{% + \glsdoifexistsordo{#2}% + {% + \let\do@gls@link@checkfirsthyper\relax + \@gls@link[#1]{#2}{#3}% + }{% + \glstextformat{#3}% + }% + \glspostlinkhook +} +\newcommand*{\glspostlinkhook}{} +\newcommand*{\@gls@link@checkfirsthyper}{% + \ifglsused{\glslabel}% + {% + }% + {% + \gls@checkisacronymlist\glstype + \ifglshyperfirst + \if@glsisacronymlist + \ifglsacrfootnote + \KV@glslink@hyperfalse + \fi + \fi + \else + \KV@glslink@hyperfalse + \fi + }% + \glslinkcheckfirsthyperhook +} +\newcommand*{\glslinkcheckfirsthyperhook}{} +\newcommand*{\glslinkpostsetkeys}{} +\newcommand{\glsifhyperon}[2]{\ifKV@glslink@hyper#1\else#2\fi} +\newcommand*{\do@glsdisablehyperinlist}{% + \expandafter\DTLifinlist\expandafter{\glstype}{\@gls@nohyperlist}% + {\KV@glslink@hyperfalse}{}% +} +\newcommand*{\@gls@setdefault@glslink@opts}{} +\def\@gls@link[#1]#2#3{% + \leavevmode + \edef\glslabel{\glsdetoklabel{#2}}% + \def\@gls@link@opts{#1}% + \let\@gls@link@label\glslabel + \def\@glsnumberformat{glsnumberformat}% + \edef\@gls@counter{\csname glo@\glslabel @counter\endcsname}% + \edef\glstype{\csname glo@\glslabel @type\endcsname}% + \let\org@ifKV@glslink@hyper\ifKV@glslink@hyper + \@gls@setdefault@glslink@opts + \do@glsdisablehyperinlist + \do@gls@link@checkfirsthyper + \setkeys{glslink}{#1}% + \glslinkpostsetkeys + \@gls@saveentrycounter + \@gls@setsort{\glslabel}% + \@do@wrglossary{#2}% + \ifKV@glslink@hyper + \@glslink{\glolinkprefix\glslabel}{\glstextformat{#3}}% + \else + \glsdonohyperlink{\glolinkprefix\glslabel}{\glstextformat{#3}}% + \fi + \let\ifKV@glslink@hyper\org@ifKV@glslink@hyper +} +\newcommand*{\glolinkprefix}{glo:} +\def\glsentrycounter{\glscounter}% +\newcommand*{\@gls@saveentrycounter}{% + \def\@gls@Hcounter{}% + \ifthenelse{\equal{\@gls@counter}{equation}}% + { + \ifcsundef{xatlevel@}% + {% + \edef\theglsentrycounter{\expandafter\noexpand + \csname the\@gls@counter\endcsname}% + }% + {% + \ifx\xatlevel@\@empty + \edef\theglsentrycounter{\expandafter\noexpand + \csname the\@gls@counter\endcsname}% + \else + \savecounters@ + \advance\c@equation by 1\relax + \edef\theglsentrycounter{\csname the\@gls@counter\endcsname}% + \ifcsundef{theH\@gls@counter}% + {% + \def\@gls@Hcounter{\theglsentrycounter}% + }% + {% + \def\@gls@Hcounter{\csname theH\@gls@counter\endcsname}% + }% + \protected@edef\theHglsentrycounter{\@gls@Hcounter}% + \restorecounters@ + \fi + }% + }% + {% + \edef\theglsentrycounter{\expandafter\noexpand + \csname the\@gls@counter\endcsname}% + }% + \ifx\@gls@Hcounter\@empty + \ifcsundef{theH\@gls@counter}% + {% + \def\theHglsentrycounter{\theglsentrycounter}% + }% + {% + \protected@edef\theHglsentrycounter{\expandafter\noexpand + \csname theH\@gls@counter\endcsname}% + }% + \fi +} +\def\@set@glo@numformat#1#2#3#4{% + \expandafter\@glo@check@mkidxrangechar#3\@nil + \protected@edef#1{% + \@glo@prefix setentrycounter[#4]{#2}% + \expandafter\string\csname\@glo@suffix\endcsname + }% + \@gls@checkmkidxchars#1% +} +\def\@glo@check@mkidxrangechar#1#2\@nil{% +\if#1(\relax + \def\@glo@prefix{(}% + \if\relax#2\relax + \def\@glo@suffix{glsnumberformat}% + \else + \def\@glo@suffix{#2}% + \fi +\else + \if#1)\relax + \def\@glo@prefix{)}% + \if\relax#2\relax + \def\@glo@suffix{glsnumberformat}% + \else + \def\@glo@suffix{#2}% + \fi + \else + \def\@glo@prefix{}\def\@glo@suffix{#1#2}% + \fi +\fi} +\newcommand*{\@gls@escbsdq}[1]{% + \def\@gls@checkedmkidx{}% + \let\gls@xdystring=#1\relax + \@onelevel@sanitize\gls@xdystring + \edef\do@gls@xdycheckbackslash{% + \noexpand\@gls@xdycheckbackslash\gls@xdystring\noexpand\@nil + \@backslashchar\@backslashchar\noexpand\null}% + \do@gls@xdycheckbackslash + \expandafter\@gls@updatechecked\@gls@checkedmkidx{\gls@xdystring}% + \def\@gls@checkedmkidx{}% + \expandafter\@gls@xdycheckquote\gls@xdystring\@nil""\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{\gls@xdystring}% + \@for\@gls@tmp:=\gls@protected@pagefmts\do + {% + \edef\@gls@sanitized@tmp{\expandafter\@gobble\string\\\expandonce\@gls@tmp}% + \@onelevel@sanitize\@gls@sanitized@tmp + \edef\gls@dosubst{% + \noexpand\DTLsubstituteall\noexpand\gls@xdystring + {\@gls@sanitized@tmp}{\expandonce\@gls@tmp}% + }% + \gls@dosubst + }% + \let#1=\gls@xdystring +} +\newcommand{\@gls@checkmkidxchars}[1]{% + \ifglsxindy + \@gls@escbsdq{#1}% + \else + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checkquote#1\@nil""\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checkescquote#1\@nil\"\"\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checkescactual#1\@nil\?\?\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checkactual#1\@nil??\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checkbar#1\@nil||\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checkescbar#1\@nil\|\|\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \def\@gls@checkedmkidx{}% + \expandafter\@gls@checklevel#1\@nil!!\null + \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}% + \fi +} +\def\@gls@updatechecked#1\@nil#2{\def#2{#1}} +\newtoks\@gls@tmpb +\def\@gls@checkquote#1"#2"#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checkquote{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@quotechar\@gls@quotechar\@gls@quotechar}% + \def\@@gls@checkquote{\@gls@checkquote#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@quotechar}% + \ifx\null#3\null + \def\@@gls@checkquote{\@gls@checkquote#2""\null}% + \else + \def\@@gls@checkquote{\@gls@checkquote#2"#3\null}% + \fi + \fi + \@@gls@checkquote +} +\def\@gls@checkescquote#1\"#2\"#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checkescquote{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@quotechar + \@gls@quotechar\string\"\@gls@quotechar}% + \def\@@gls@checkescquote{\@gls@checkescquote#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@quotechar}% + \ifx\null#3\null + \def\@@gls@checkescquote{\@gls@checkescquote#2\"\"\null}% + \else + \def\@@gls@checkescquote{\@gls@checkescquote#2\"#3\null}% + \fi + \fi +\@@gls@checkescquote +} +\def\@gls@checkescactual#1\?#2\?#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checkescactual{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@actualchar + \@gls@quotechar\string\"\@gls@actualchar}% + \def\@@gls@checkescactual{\@gls@checkescactual#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@actualchar}% + \ifx\null#3\null + \def\@@gls@checkescactual{\@gls@checkescactual#2\?\?\null}% + \else + \def\@@gls@checkescactual{\@gls@checkescactual#2\?#3\null}% + \fi + \fi +\@@gls@checkescactual +} +\def\@gls@checkescbar#1\|#2\|#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checkescbar{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@encapchar + \@gls@quotechar\string\"\@gls@encapchar}% + \def\@@gls@checkescbar{\@gls@checkescbar#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@encapchar}% + \ifx\null#3\null + \def\@@gls@checkescbar{\@gls@checkescbar#2\|\|\null}% + \else + \def\@@gls@checkescbar{\@gls@checkescbar#2\|#3\null}% + \fi + \fi +\@@gls@checkescbar +} +\def\@gls@checkesclevel#1\!#2\!#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checkesclevel{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@levelchar + \@gls@quotechar\string\"\@gls@levelchar}% + \def\@@gls@checkesclevel{\@gls@checkesclevel#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\string\"\@gls@levelchar}% + \ifx\null#3\null + \def\@@gls@checkesclevel{\@gls@checkesclevel#2\!\!\null}% + \else + \def\@@gls@checkesclevel{\@gls@checkesclevel#2\!#3\null}% + \fi + \fi +\@@gls@checkesclevel +} +\def\@gls@checkbar#1|#2|#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checkbar{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@encapchar\@gls@quotechar\@gls@encapchar}% + \def\@@gls@checkbar{\@gls@checkbar#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@encapchar}% + \ifx\null#3\null + \def\@@gls@checkbar{\@gls@checkbar#2||\null}% + \else + \def\@@gls@checkbar{\@gls@checkbar#2|#3\null}% + \fi + \fi + \@@gls@checkbar +} +\def\@gls@checklevel#1!#2!#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checklevel{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@levelchar\@gls@quotechar\@gls@levelchar}% + \def\@@gls@checklevel{\@gls@checklevel#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@levelchar}% + \ifx\null#3\null + \def\@@gls@checklevel{\@gls@checklevel#2!!\null}% + \else + \def\@@gls@checklevel{\@gls@checklevel#2!#3\null}% + \fi + \fi + \@@gls@checklevel +} +\def\@gls@checkactual#1?#2?#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@checkactual{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@actualchar\@gls@quotechar\@gls@actualchar}% + \def\@@gls@checkactual{\@gls@checkactual#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \@gls@quotechar\@gls@actualchar}% + \ifx\null#3\null + \def\@@gls@checkactual{\@gls@checkactual#2??\null}% + \else + \def\@@gls@checkactual{\@gls@checkactual#2?#3\null}% + \fi + \fi + \@@gls@checkactual +} +\def\@gls@xdycheckquote#1"#2"#3\null{% + \@gls@tmpb=\expandafter{\@gls@checkedmkidx}% + \toks@={#1}% + \ifx\null#2\null + \ifx\null#3\null + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@}% + \def\@@gls@xdycheckquote{\relax}% + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \string\"\string\"}% + \def\@@gls@xdycheckquote{\@gls@xdycheckquote#3\null}% + \fi + \else + \edef\@gls@checkedmkidx{\the\@gls@tmpb\the\toks@ + \string\"}% + \ifx\null#3\null + \def\@@gls@xdycheckquote{\@gls@xdycheckquote#2""\null}% + \else + \def\@@gls@xdycheckquote{\@gls@xdycheckquote#2"#3\null}% + \fi + \fi + \@@gls@xdycheckquote +} +\edef\def@gls@xdycheckbackslash{% + \noexpand\def\noexpand\@gls@xdycheckbackslash##1\@backslashchar + ##2\@backslashchar##3\noexpand\null{% + \noexpand\@gls@tmpb=\noexpand\expandafter + {\noexpand\@gls@checkedmkidx}% + \noexpand\toks@={##1}% + \noexpand\ifx\noexpand\null##2\noexpand\null + \noexpand\ifx\noexpand\null##3\noexpand\null + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@}% + \noexpand\def\noexpand\@@gls@xdycheckbackslash{\relax}% + \noexpand\else + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@ + \@backslashchar\@backslashchar\@backslashchar\@backslashchar}% + \noexpand\def\noexpand\@@gls@xdycheckbackslash{% + \noexpand\@gls@xdycheckbackslash##3\noexpand\null}% + \noexpand\fi + \noexpand\else + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@ + \@backslashchar\@backslashchar}% + \noexpand\ifx\noexpand\null##3\noexpand\null + \noexpand\def\noexpand\@@gls@xdycheckbackslash{% + \noexpand\@gls@xdycheckbackslash##2\@backslashchar + \@backslashchar\noexpand\null}% + \noexpand\else + \noexpand\def\noexpand\@@gls@xdycheckbackslash{% + \noexpand\@gls@xdycheckbackslash##2\@backslashchar + ##3\noexpand\null}% + \noexpand\fi + \noexpand\fi + \noexpand\@@gls@xdycheckbackslash + }% +} +\def@gls@xdycheckbackslash + +\newlength\gls@tmplen +\newcommand*{\glsdohypertarget}[2]{% + \@glsshowtarget{#1}% + \settoheight{\gls@tmplen}{#2}% + \raisebox{\gls@tmplen}{\hypertarget{#1}{}}#2% +} +\newcommand*{\glsdohyperlink}[2]{% + \@glsshowtarget{#1}% + \hyperlink{#1}{#2}% +} +\newcommand*{\glsdonohyperlink}[2]{#2} +\ifcsundef{hyperlink}% +{% + \let\@glslink\glsdonohyperlink +}% +{% + \let\@glslink\glsdohyperlink +} +\ifcsundef{hypertarget}% +{% + \let\@glstarget\@secondoftwo +}% +{% + \let\@glstarget\glsdohypertarget +} +\newcommand{\glsdisablehyper}{% + \KV@glslink@hyperfalse + \let\@glslink\glsdonohyperlink + \let\@glstarget\@secondoftwo +} +\newcommand{\glsenablehyper}{% + \KV@glslink@hypertrue + \let\@glslink\glsdohyperlink + \let\@glstarget\glsdohypertarget +} +\providecommand{\@firstofthree}[3]{#1} +\providecommand{\@secondofthree}[3]{#2} +\newrobustcmd*{\gls}{\@gls@hyp@opt\@gls} +\newcommand*{\@gls}[2][]{% + \new@ifnextchar[{\@gls@{#1}{#2}}{\@gls@{#1}{#2}[]}% +} +\def\@gls@#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper + \let\glsifplural\@secondoftwo + \let\glscapscase\@firstofthree + \let\glscustomtext\@empty + \def\glsinsert{#3}% + \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}% + \@gls@link[#1]{#2}{\@glo@text}% + \ifKV@glslink@local + \glslocalunset{#2}% + \else + \glsunset{#2}% + \fi + }% + \glspostlinkhook +} +\newrobustcmd*{\Gls}{\@gls@hyp@opt\@Gls} +\newcommand*{\@Gls}[2][]{% + \new@ifnextchar[{\@Gls@{#1}{#2}}{\@Gls@{#1}{#2}[]}% +} +\def\@Gls@#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper + \let\glsifplural\@secondoftwo + \let\glscapscase\@secondofthree + \let\glscustomtext\@empty + \def\glsinsert{#3}% + \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}% + \@gls@link[#1]{#2}{\@glo@text}% + \ifKV@glslink@local + \glslocalunset{#2}% + \else + \glsunset{#2}% + \fi + }% + \glspostlinkhook +} +\newrobustcmd*{\GLS}{\@gls@hyp@opt\@GLS} +\newcommand*{\@GLS}[2][]{% + \new@ifnextchar[{\@GLS@{#1}{#2}}{\@GLS@{#1}{#2}[]}% +} +\def\@GLS@#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper + \let\glsifplural\@secondoftwo + \let\glscapscase\@thirdofthree + \let\glscustomtext\@empty + \def\glsinsert{#3}% + \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}% + \@gls@link[#1]{#2}{\@glo@text}% + \ifKV@glslink@local + \glslocalunset{#2}% + \else + \glsunset{#2}% + \fi + }% + \glspostlinkhook +} +\newrobustcmd*{\glspl}{\@gls@hyp@opt\@glspl} +\newcommand*{\@glspl}[2][]{% + \new@ifnextchar[{\@glspl@{#1}{#2}}{\@glspl@{#1}{#2}[]}% +} +\def\@glspl@#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper + \let\glsifplural\@firstoftwo + \let\glscapscase\@firstofthree + \let\glscustomtext\@empty + \def\glsinsert{#3}% + \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}% + \@gls@link[#1]{#2}{\@glo@text}% + \ifKV@glslink@local + \glslocalunset{#2}% + \else + \glsunset{#2}% + \fi + }% + \glspostlinkhook +} +\newrobustcmd*{\Glspl}{\@gls@hyp@opt\@Glspl} +\newcommand*{\@Glspl}[2][]{% + \new@ifnextchar[{\@Glspl@{#1}{#2}}{\@Glspl@{#1}{#2}[]}% +} +\def\@Glspl@#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper + \let\glsifplural\@firstoftwo + \let\glscapscase\@secondofthree + \let\glscustomtext\@empty + \def\glsinsert{#3}% + \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}% + \@gls@link[#1]{#2}{\@glo@text}% + \ifKV@glslink@local + \glslocalunset{#2}% + \else + \glsunset{#2}% + \fi + }% + \glspostlinkhook +} +\newrobustcmd*{\GLSpl}{\@gls@hyp@opt\@GLSpl} +\newcommand*{\@GLSpl}[2][]{% + \new@ifnextchar[{\@GLSpl@{#1}{#2}}{\@GLSpl@{#1}{#2}[]}% +} +\def\@GLSpl@#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper + \let\glsifplural\@firstoftwo + \let\glscapscase\@thirdofthree + \let\glscustomtext\@empty + \def\glsinsert{#3}% + \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}% + \@gls@link[#1]{#2}{\@glo@text}% + \ifKV@glslink@local + \glslocalunset{#2}% + \else + \glsunset{#2}% + \fi + }% + \glspostlinkhook +} +\newrobustcmd*{\glsdisp}{\@gls@hyp@opt\@glsdisp} +\newcommand*{\@glsdisp}[3][]{% + \glsdoifexists{#2}{% + \let\do@gls@link@checkfirsthyper\@gls@link@checkfirsthyper + \let\glsifplural\@secondoftwo + \let\glscapscase\@firstofthree + \def\glscustomtext{#3}% + \def\glsinsert{}% + \def\@glo@text{\csname gls@\glstype @entryfmt\endcsname}% + \@gls@link[#1]{#2}{\@glo@text}% + \ifKV@glslink@local + \glslocalunset{#2}% + \else + \glsunset{#2}% + \fi + }% + \glspostlinkhook +} +\newcommand*{\@gls@link@nocheckfirsthyper}{} +\newcommand{\@gls@field@link}[3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \@gls@link[#1]{#2}{#3}% + }% + \glspostlinkhook +} +\newrobustcmd*{\glstext}{\@gls@hyp@opt\@glstext} +\newcommand*{\@glstext}[2][]{% + \new@ifnextchar[{\@glstext@{#1}{#2}}{\@glstext@{#1}{#2}[]}} +\def\@glstext@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentrytext{#2}#3}% +} +\newrobustcmd*{\GLStext}{\@gls@hyp@opt\@GLStext} +\newcommand*{\@GLStext}[2][]{% + \new@ifnextchar[{\@GLStext@{#1}{#2}}{\@GLStext@{#1}{#2}[]}} +\def\@GLStext@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentrytext{#2}#3}}% +} +\newrobustcmd*{\Glstext}{\@gls@hyp@opt\@Glstext} +\newcommand*{\@Glstext}[2][]{% + \new@ifnextchar[{\@Glstext@{#1}{#2}}{\@Glstext@{#1}{#2}[]}} +\def\@Glstext@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentrytext{#2}#3}% +} +\newrobustcmd*{\glsfirst}{\@gls@hyp@opt\@glsfirst} +\newcommand*{\@glsfirst}[2][]{% + \new@ifnextchar[{\@glsfirst@{#1}{#2}}{\@glsfirst@{#1}{#2}[]}} +\def\@glsfirst@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryfirst{#2}#3}% +} +\newrobustcmd*{\Glsfirst}{\@gls@hyp@opt\@Glsfirst} +\newcommand*{\@Glsfirst}[2][]{% + \new@ifnextchar[{\@Glsfirst@{#1}{#2}}{\@Glsfirst@{#1}{#2}[]}} +\def\@Glsfirst@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryfirst{#2}#3}% +} +\newrobustcmd*{\GLSfirst}{\@gls@hyp@opt\@GLSfirst} +\newcommand*{\@GLSfirst}[2][]{% + \new@ifnextchar[{\@GLSfirst@{#1}{#2}}{\@GLSfirst@{#1}{#2}[]}} +\def\@GLSfirst@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryfirst{#2}#3}}% +} +\newrobustcmd*{\glsplural}{\@gls@hyp@opt\@glsplural} +\newcommand*{\@glsplural}[2][]{% + \new@ifnextchar[{\@glsplural@{#1}{#2}}{\@glsplural@{#1}{#2}[]}} +\def\@glsplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryplural{#2}#3}% +} +\newrobustcmd*{\Glsplural}{\@gls@hyp@opt\@Glsplural} +\newcommand*{\@Glsplural}[2][]{% + \new@ifnextchar[{\@Glsplural@{#1}{#2}}{\@Glsplural@{#1}{#2}[]}} +\def\@Glsplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryplural{#2}#3}% +} +\newrobustcmd*{\GLSplural}{\@gls@hyp@opt\@GLSplural} +\newcommand*{\@GLSplural}[2][]{% + \new@ifnextchar[{\@GLSplural@{#1}{#2}}{\@GLSplural@{#1}{#2}[]}} +\def\@GLSplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryplural{#2}#3}}% +} +\newrobustcmd*{\glsfirstplural}{\@gls@hyp@opt\@glsfirstplural} +\newcommand*{\@glsfirstplural}[2][]{% + \new@ifnextchar[{\@glsfirstplural@{#1}{#2}}{\@glsfirstplural@{#1}{#2}[]}} +\def\@glsfirstplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryfirstplural{#2}#3}% +} +\newrobustcmd*{\Glsfirstplural}{\@gls@hyp@opt\@Glsfirstplural} +\newcommand*{\@Glsfirstplural}[2][]{% + \new@ifnextchar[{\@Glsfirstplural@{#1}{#2}}{\@Glsfirstplural@{#1}{#2}[]}} +\def\@Glsfirstplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryfirstplural{#2}#3}% +} +\newrobustcmd*{\GLSfirstplural}{\@gls@hyp@opt\@GLSfirstplural} +\newcommand*{\@GLSfirstplural}[2][]{% + \new@ifnextchar[{\@GLSfirstplural@{#1}{#2}}{\@GLSfirstplural@{#1}{#2}[]}} +\def\@GLSfirstplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryfirstplural{#2}#3}}% +} +\newrobustcmd*{\glsname}{\@gls@hyp@opt\@glsname} +\newcommand*{\@glsname}[2][]{% + \new@ifnextchar[{\@glsname@{#1}{#2}}{\@glsname@{#1}{#2}[]}} +\def\@glsname@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryname{#2}#3}% +} +\newrobustcmd*{\Glsname}{\@gls@hyp@opt\@Glsname} +\newcommand*{\@Glsname}[2][]{% + \new@ifnextchar[{\@Glsname@{#1}{#2}}{\@Glsname@{#1}{#2}[]}} +\def\@Glsname@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryname{#2}#3}% +} +\newrobustcmd*{\GLSname}{\@gls@hyp@opt\@GLSname} +\newcommand*{\@GLSname}[2][]{% + \new@ifnextchar[{\@GLSname@{#1}{#2}}{\@GLSname@{#1}{#2}[]}} +\def\@GLSname@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryname{#2}#3}}% +} +\newrobustcmd*{\glsdesc}{\@gls@hyp@opt\@glsdesc} +\newcommand*{\@glsdesc}[2][]{% + \new@ifnextchar[{\@glsdesc@{#1}{#2}}{\@glsdesc@{#1}{#2}[]}} +\def\@glsdesc@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentrydesc{#2}#3}% +} +\newrobustcmd*{\Glsdesc}{\@gls@hyp@opt\@Glsdesc} +\newcommand*{\@Glsdesc}[2][]{% + \new@ifnextchar[{\@Glsdesc@{#1}{#2}}{\@Glsdesc@{#1}{#2}[]}} +\def\@Glsdesc@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentrydesc{#2}#3}% +} +\newrobustcmd*{\GLSdesc}{\@gls@hyp@opt\@GLSdesc} +\newcommand*{\@GLSdesc}[2][]{% + \new@ifnextchar[{\@GLSdesc@{#1}{#2}}{\@GLSdesc@{#1}{#2}[]}} +\def\@GLSdesc@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentrydesc{#2}#3}}% +} +\newrobustcmd*{\glsdescplural}{\@gls@hyp@opt\@glsdescplural} +\newcommand*{\@glsdescplural}[2][]{% + \new@ifnextchar[{\@glsdescplural@{#1}{#2}}{\@glsdescplural@{#1}{#2}[]}} +\def\@glsdescplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentrydescplural{#2}#3}% +} +\newrobustcmd*{\Glsdescplural}{\@gls@hyp@opt\@Glsdescplural} +\newcommand*{\@Glsdescplural}[2][]{% + \new@ifnextchar[{\@Glsdescplural@{#1}{#2}}{\@Glsdescplural@{#1}{#2}[]}} +\def\@Glsdescplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentrydescplural{#2}#3}% +} +\newrobustcmd*{\GLSdescplural}{\@gls@hyp@opt\@GLSdescplural} +\newcommand*{\@GLSdescplural}[2][]{% + \new@ifnextchar[{\@GLSdescplural@{#1}{#2}}{\@GLSdescplural@{#1}{#2}[]}} +\def\@GLSdescplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentrydescplural{#2}#3}}% +} +\newrobustcmd*{\glssymbol}{\@gls@hyp@opt\@glssymbol} +\newcommand*{\@glssymbol}[2][]{% + \new@ifnextchar[{\@glssymbol@{#1}{#2}}{\@glssymbol@{#1}{#2}[]}} +\def\@glssymbol@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentrysymbol{#2}#3}% +} +\newrobustcmd*{\Glssymbol}{\@gls@hyp@opt\@Glssymbol} +\newcommand*{\@Glssymbol}[2][]{% + \new@ifnextchar[{\@Glssymbol@{#1}{#2}}{\@Glssymbol@{#1}{#2}[]}} +\def\@Glssymbol@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentrysymbol{#2}#3}% +} +\newrobustcmd*{\GLSsymbol}{\@gls@hyp@opt\@GLSsymbol} +\newcommand*{\@GLSsymbol}[2][]{% + \new@ifnextchar[{\@GLSsymbol@{#1}{#2}}{\@GLSsymbol@{#1}{#2}[]}} +\def\@GLSsymbol@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentrysymbol{#2}#3}}% +} +\newrobustcmd*{\glssymbolplural}{\@gls@hyp@opt\@glssymbolplural} +\newcommand*{\@glssymbolplural}[2][]{% + \new@ifnextchar[{\@glssymbolplural@{#1}{#2}}{\@glssymbolplural@{#1}{#2}[]}} +\def\@glssymbolplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentrysymbolplural{#2}#3}% +} +\newrobustcmd*{\Glssymbolplural}{\@gls@hyp@opt\@Glssymbolplural} +\newcommand*{\@Glssymbolplural}[2][]{% + \new@ifnextchar[{\@Glssymbolplural@{#1}{#2}}{\@Glssymbolplural@{#1}{#2}[]}} +\def\@Glssymbolplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentrysymbolplural{#2}#3}% +} +\newrobustcmd*{\GLSsymbolplural}{\@gls@hyp@opt\@GLSsymbolplural} +\newcommand*{\@GLSsymbolplural}[2][]{% + \new@ifnextchar[{\@GLSsymbolplural@{#1}{#2}}{\@GLSsymbolplural@{#1}{#2}[]}} +\def\@GLSsymbolplural@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentrysymbolplural{#2}#3}}% +} +\newrobustcmd*{\glsuseri}{\@gls@hyp@opt\@glsuseri} +\newcommand*{\@glsuseri}[2][]{% + \new@ifnextchar[{\@glsuseri@{#1}{#2}}{\@glsuseri@{#1}{#2}[]}} +\def\@glsuseri@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryuseri{#2}#3}% +} +\newrobustcmd*{\Glsuseri}{\@gls@hyp@opt\@Glsuseri} +\newcommand*{\@Glsuseri}[2][]{% + \new@ifnextchar[{\@Glsuseri@{#1}{#2}}{\@Glsuseri@{#1}{#2}[]}} +\def\@Glsuseri@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryuseri{#2}#3}% +} +\newrobustcmd*{\GLSuseri}{\@gls@hyp@opt\@GLSuseri} +\newcommand*{\@GLSuseri}[2][]{% + \new@ifnextchar[{\@GLSuseri@{#1}{#2}}{\@GLSuseri@{#1}{#2}[]}} +\def\@GLSuseri@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryuseri{#2}#3}}% +} +\newrobustcmd*{\glsuserii}{\@gls@hyp@opt\@glsuserii} +\newcommand*{\@glsuserii}[2][]{% + \new@ifnextchar[{\@glsuserii@{#1}{#2}}{\@glsuserii@{#1}{#2}[]}} +\def\@glsuserii@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryuserii{#2}#3}% +} +\newrobustcmd*{\Glsuserii}{\@gls@hyp@opt\@Glsuserii} +\newcommand*{\@Glsuserii}[2][]{% + \new@ifnextchar[{\@Glsuserii@{#1}{#2}}{\@Glsuserii@{#1}{#2}[]}} +\def\@Glsuserii@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryuserii{#2}#3}% +} +\newrobustcmd*{\GLSuserii}{\@gls@hyp@opt\@GLSuserii} +\newcommand*{\@GLSuserii}[2][]{% + \new@ifnextchar[{\@GLSuserii@{#1}{#2}}{\@GLSuserii@{#1}{#2}[]}} +\def\@GLSuserii@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryuserii{#2}#3}}% +} +\newrobustcmd*{\glsuseriii}{\@gls@hyp@opt\@glsuseriii} +\newcommand*{\@glsuseriii}[2][]{% + \new@ifnextchar[{\@glsuseriii@{#1}{#2}}{\@glsuseriii@{#1}{#2}[]}} +\def\@glsuseriii@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryuseriii{#2}#3}% +} +\newrobustcmd*{\Glsuseriii}{\@gls@hyp@opt\@Glsuseriii} +\newcommand*{\@Glsuseriii}[2][]{% + \new@ifnextchar[{\@Glsuseriii@{#1}{#2}}{\@Glsuseriii@{#1}{#2}[]}} +\def\@Glsuseriii@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryuseriii{#2}#3}% +} +\newrobustcmd*{\GLSuseriii}{\@gls@hyp@opt\@GLSuseriii} +\newcommand*{\@GLSuseriii}[2][]{% + \new@ifnextchar[{\@GLSuseriii@{#1}{#2}}{\@GLSuseriii@{#1}{#2}[]}} +\def\@GLSuseriii@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryuseriii{#2}#3}}% +} +\newrobustcmd*{\glsuseriv}{\@gls@hyp@opt\@glsuseriv} +\newcommand*{\@glsuseriv}[2][]{% + \new@ifnextchar[{\@glsuseriv@{#1}{#2}}{\@glsuseriv@{#1}{#2}[]}} +\def\@glsuseriv@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryuseriv{#2}#3}% +} +\newrobustcmd*{\Glsuseriv}{\@gls@hyp@opt\@Glsuseriv} +\newcommand*{\@Glsuseriv}[2][]{% + \new@ifnextchar[{\@Glsuseriv@{#1}{#2}}{\@Glsuseriv@{#1}{#2}[]}} +\def\@Glsuseriv@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryuseriv{#2}#3}% +} +\newrobustcmd*{\GLSuseriv}{\@gls@hyp@opt\@GLSuseriv} +\newcommand*{\@GLSuseriv}[2][]{% + \new@ifnextchar[{\@GLSuseriv@{#1}{#2}}{\@GLSuseriv@{#1}{#2}[]}} +\def\@GLSuseriv@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryuseriv{#2}#3}}% +} +\newrobustcmd*{\glsuserv}{\@gls@hyp@opt\@glsuserv} +\newcommand*{\@glsuserv}[2][]{% + \new@ifnextchar[{\@glsuserv@{#1}{#2}}{\@glsuserv@{#1}{#2}[]}} +\def\@glsuserv@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryuserv{#2}#3}% +} +\newrobustcmd*{\Glsuserv}{\@gls@hyp@opt\@Glsuserv} +\newcommand*{\@Glsuserv}[2][]{% +\new@ifnextchar[{\@Glsuserv@{#1}{#2}}{\@Glsuserv@{#1}{#2}[]}} +\def\@Glsuserv@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryuserv{#2}#3}% +} +\newrobustcmd*{\GLSuserv}{\@gls@hyp@opt\@GLSuserv} +\newcommand*{\@GLSuserv}[2][]{% +\new@ifnextchar[{\@GLSuserv@{#1}{#2}}{\@GLSuserv@{#1}{#2}[]}} +\def\@GLSuserv@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryuserv{#2}#3}}% +} +\newrobustcmd*{\glsuservi}{\@gls@hyp@opt\@glsuservi} +\newcommand*{\@glsuservi}[2][]{% + \new@ifnextchar[{\@glsuservi@{#1}{#2}}{\@glsuservi@{#1}{#2}[]}} +\def\@glsuservi@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\glsentryuservi{#2}#3}% +} +\newrobustcmd*{\Glsuservi}{\@gls@hyp@opt\@Glsuservi} +\newcommand*{\@Glsuservi}[2][]{% + \new@ifnextchar[{\@Glsuservi@{#1}{#2}}{\@Glsuservi@{#1}{#2}[]}} +\def\@Glsuservi@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\Glsentryuservi{#2}#3}% +} +\newrobustcmd*{\GLSuservi}{\@gls@hyp@opt\@GLSuservi} +\newcommand*{\@GLSuservi}[2][]{% + \new@ifnextchar[{\@GLSuservi@{#1}{#2}}{\@GLSuservi@{#1}{#2}[]}} +\def\@GLSuservi@#1#2[#3]{% + \@gls@field@link{#1}{#2}{\mfirstucMakeUppercase{\glsentryuservi{#2}#3}}% +} +\newrobustcmd*{\acrshort}{\@gls@hyp@opt\ns@acrshort} +\newcommand*{\ns@acrshort}[2][]{% + \new@ifnextchar[{\@acrshort{#1}{#2}}{\@acrshort{#1}{#2}[]}% +} +\def\@acrshort#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \let\glsifplural\@secondoftwo + \let\glscapscase\@firstofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \acronymfont{\glsentryshort{#2}}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\Acrshort}{\@gls@hyp@opt\ns@Acrshort} +\newcommand*{\ns@Acrshort}[2][]{% + \new@ifnextchar[{\@Acrshort{#1}{#2}}{\@Acrshort{#1}{#2}[]}% +} +\def\@Acrshort#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@secondoftwo + \let\glscapscase\@secondofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \acronymfont{\Glsentryshort{#2}}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\ACRshort}{\@gls@hyp@opt\ns@ACRshort} +\newcommand*{\ns@ACRshort}[2][]{% + \new@ifnextchar[{\@ACRshort{#1}{#2}}{\@ACRshort{#1}{#2}[]}% +} +\def\@ACRshort#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@secondoftwo + \let\glscapscase\@thirdofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \mfirstucMakeUppercase{\acronymfont{\glsentryshort{#2}}#3}% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\acrshortpl}{\@gls@hyp@opt\ns@acrshortpl} +\newcommand*{\ns@acrshortpl}[2][]{% + \new@ifnextchar[{\@acrshortpl{#1}{#2}}{\@acrshortpl{#1}{#2}[]}% +} +\def\@acrshortpl#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@firstoftwo + \let\glscapscase\@firstofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \acronymfont{\glsentryshortpl{#2}}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\Acrshortpl}{\@gls@hyp@opt\ns@Acrshortpl} +\newcommand*{\ns@Acrshortpl}[2][]{% + \new@ifnextchar[{\@Acrshortpl{#1}{#2}}{\@Acrshortpl{#1}{#2}[]}% +} +\def\@Acrshortpl#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@firstoftwo + \let\glscapscase\@secondofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \acronymfont{\Glsentryshortpl{#2}}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\ACRshortpl}{\@gls@hyp@opt\ns@ACRshortpl} +\newcommand*{\ns@ACRshortpl}[2][]{% + \new@ifnextchar[{\@ACRshortpl{#1}{#2}}{\@ACRshortpl{#1}{#2}[]}% +} +\def\@ACRshortpl#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@firstoftwo + \let\glscapscase\@thirdofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \mfirstucMakeUppercase{\acronymfont{\glsentryshortpl{#2}}#3}% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\acrlong}{\@gls@hyp@opt\ns@acrlong} +\newcommand*{\ns@acrlong}[2][]{% + \new@ifnextchar[{\@acrlong{#1}{#2}}{\@acrlong{#1}{#2}[]}% +} +\def\@acrlong#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@secondoftwo + \let\glscapscase\@firstofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \glsentrylong{#2}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\Acrlong}{\@gls@hyp@opt\ns@Acrlong} +\newcommand*{\ns@Acrlong}[2][]{% + \new@ifnextchar[{\@Acrlong{#1}{#2}}{\@Acrlong{#1}{#2}[]}% +} +\def\@Acrlong#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@secondoftwo + \let\glscapscase\@secondofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \Glsentrylong{#2}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\ACRlong}{\@gls@hyp@opt\ns@ACRlong} +\newcommand*{\ns@ACRlong}[2][]{% + \new@ifnextchar[{\@ACRlong{#1}{#2}}{\@ACRlong{#1}{#2}[]}% +} +\def\@ACRlong#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@secondoftwo + \let\glscapscase\@thirdofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \mfirstucMakeUppercase{\glsentrylong{#2}#3}% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\acrlongpl}{\@gls@hyp@opt\ns@acrlongpl} +\newcommand*{\ns@acrlongpl}[2][]{% + \new@ifnextchar[{\@acrlongpl{#1}{#2}}{\@acrlongpl{#1}{#2}[]}% +} +\def\@acrlongpl#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@firstoftwo + \let\glscapscase\@firstofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \glsentrylongpl{#2}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\Acrlongpl}{\@gls@hyp@opt\ns@Acrlongpl} +\newcommand*{\ns@Acrlongpl}[2][]{% + \new@ifnextchar[{\@Acrlongpl{#1}{#2}}{\@Acrlongpl{#1}{#2}[]}% +} +\def\@Acrlongpl#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@firstoftwo + \let\glscapscase\@secondofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \Glsentrylongpl{#2}#3% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newrobustcmd*{\ACRlongpl}{\@gls@hyp@opt\ns@ACRlongpl} +\newcommand*{\ns@ACRlongpl}[2][]{% + \new@ifnextchar[{\@ACRlongpl{#1}{#2}}{\@ACRlongpl{#1}{#2}[]}% +} +\def\@ACRlongpl#1#2[#3]{% + \glsdoifexists{#2}% + {% + \let\do@gls@link@checkfirsthyper\@gls@link@nocheckfirsthyper + \def\glslabel{#2}% + \let\glsifplural\@firstoftwo + \let\glscapscase\@thirdofthree + \let\glsinsert\@empty + \def\glscustomtext{% + \mfirstucMakeUppercase{\glsentrylongpl{#2}#3}% + }% + \@gls@link[#1]{#2}{\csname gls@\glstype @entryfmt\endcsname}% + }% + \glspostlinkhook +} +\newcommand*{\@gls@entry@field}[2]{% + \csname glo@\glsdetoklabel{#1}@#2\endcsname +} +\newcommand*{\glsletentryfield}[3]{% + \letcs{#1}{glo@\glsdetoklabel{#2}@#3}% +} +\newcommand*{\@Gls@entry@field}[2]{% + \glsdoifexistsordo{#1}% + {% + \letcs\@glo@text{glo@\glsdetoklabel{#1}@#2}% + \ifdef\@glo@text + {% + \xmakefirstuc{\@glo@text}% + }% + {% + ??\PackageError{glossaries}{The field `#2' doesn't exist for glossary + entry `\glsdetoklabel{#1}'}{Check you have correctly spelt the entry + label and the field name}% + }% + }% + {% + ??% + }% +} +\newcommand*{\glsentryname}[1]{\@gls@entry@field{#1}{name}} +\newrobustcmd*{\Glsentryname}[1]{% + \@Gls@entryname{#1}% +} +\newcommand*{\@Gls@entryname}[1]{% + \@Gls@entry@field{#1}{name}% +} +\newcommand*{\@Gls@acrentryname}[1]{% + \ifglshaslong{#1}% + {% + \letcs\@glo@text{glo@\glsdetoklabel{#1}@name}% + \expandafter\@gls@getbody\@glo@text{}\@nil + \expandafter\ifx\@gls@body\glsentrylong\relax + \expandafter\Glsentrylong\@gls@rest + \else + \expandafter\ifx\@gls@body\glsentryshort\relax + \expandafter\Glsentryshort\@gls@rest + \else + \expandafter\ifx\@gls@body\acronymfont\relax + {% + \let\glsentryshort\Glsentryshort + \@glo@text + }% + \else + \expandafter\ifx\@gls@body\glsshortaccessdisplay\relax + {% + \let\glsentryshort\Glsentryshort + \@glo@text + }% + \else + \xmakefirstuc{\@glo@text}% + \fi + \fi + \fi + \fi + }% + {% + \@Gls@entry@field{#1}{name}% + }% +} +\newcommand*{\glsentrydesc}[1]{\@gls@entry@field{#1}{desc}} +\newrobustcmd*{\Glsentrydesc}[1]{% + \@Gls@entry@field{#1}{desc}% +} +\newcommand*{\glsentrydescplural}[1]{% + \@gls@entry@field{#1}{descplural}% +} +\newrobustcmd*{\Glsentrydescplural}[1]{% + \@Gls@entry@field{#1}{descplural}% +} +\newcommand*{\glsentrytext}[1]{\@gls@entry@field{#1}{text}} +\newrobustcmd*{\Glsentrytext}[1]{% + \@Gls@entry@field{#1}{text}% +} +\newcommand*{\glsentryplural}[1]{% + \@gls@entry@field{#1}{plural}% +} +\newrobustcmd*{\Glsentryplural}[1]{% + \@Gls@entry@field{#1}{plural}% +} +\newcommand*{\glsentrysymbol}[1]{% + \@gls@entry@field{#1}{symbol}% +} +\newrobustcmd*{\Glsentrysymbol}[1]{% + \@Gls@entry@field{#1}{symbol}% +} +\newcommand*{\glsentrysymbolplural}[1]{% + \@gls@entry@field{#1}{symbolplural}% +} +\newrobustcmd*{\Glsentrysymbolplural}[1]{% + \@Gls@entry@field{#1}{symbolplural}% +} +\newcommand*{\glsentryfirst}[1]{% + \@gls@entry@field{#1}{first}% +} +\newrobustcmd*{\Glsentryfirst}[1]{% + \@Gls@entry@field{#1}{first}% +} +\newcommand*{\glsentryfirstplural}[1]{% + \@gls@entry@field{#1}{firstpl}% +} +\newrobustcmd*{\Glsentryfirstplural}[1]{% + \@Gls@entry@field{#1}{firstpl}% +} +\newrobustcmd*{\@glsentrytitlecase}[2]{% + \glsdoifexists{#1}% + {% + \glsfieldfetch{#1}{#2}{\@gls@value}% + \xcapitalisewords{\@gls@value}% + }% +} +\ifdef\texorpdfstring +{ + \newcommand*{\glsentrytitlecase}[2]{% + \texorpdfstring + {\@glsentrytitlecase{#1}{#2}}% + {\@gls@entry@field{#1}{#2}}% + } +} +{ + \newcommand*{\glsentrytitlecase}[2]{\@glsentrytitlecase{#1}{#2}} +} +\newcommand*{\glsentrytype}[1]{\@gls@entry@field{#1}{type}} +\newcommand*{\glsentrysort}[1]{% + \@gls@entry@field{#1}{sort}% +} +\newcommand*{\glsentryparent}[1]{% + \@gls@entry@field{#1}{parent}% +} +\newcommand*{\glsentryuseri}[1]{% + \@gls@entry@field{#1}{useri}% +} +\newrobustcmd*{\Glsentryuseri}[1]{% + \@Gls@entry@field{#1}{useri}% +} +\newcommand*{\glsentryuserii}[1]{% + \@gls@entry@field{#1}{userii}% +} +\newrobustcmd*{\Glsentryuserii}[1]{% + \@Gls@entry@field{#1}{userii}% +} +\newcommand*{\glsentryuseriii}[1]{% + \@gls@entry@field{#1}{useriii}% +} +\newrobustcmd*{\Glsentryuseriii}[1]{% + \@Gls@entry@field{#1}{useriii}% +} +\newcommand*{\glsentryuseriv}[1]{% + \@gls@entry@field{#1}{useriv}% +} +\newrobustcmd*{\Glsentryuseriv}[1]{% + \@Gls@entry@field{#1}{useriv}% +} +\newcommand*{\glsentryuserv}[1]{% + \@gls@entry@field{#1}{userv}% +} +\newrobustcmd*{\Glsentryuserv}[1]{% + \@Gls@entry@field{#1}{userv}% +} +\newcommand*{\glsentryuservi}[1]{% + \@gls@entry@field{#1}{uservi}% +} +\newrobustcmd*{\Glsentryuservi}[1]{% + \@Gls@entry@field{#1}{uservi}% +} +\newcommand*{\glsentryshort}[1]{\@gls@entry@field{#1}{short}} +\newrobustcmd*{\Glsentryshort}[1]{% + \@Gls@entry@field{#1}{short}% +} +\newcommand*{\glsentryshortpl}[1]{\@gls@entry@field{#1}{shortpl}} +\newrobustcmd*{\Glsentryshortpl}[1]{% + \@Gls@entry@field{#1}{shortpl}% +} +\newcommand*{\glsentrylong}[1]{\@gls@entry@field{#1}{long}} +\newrobustcmd*{\Glsentrylong}[1]{% + \@Gls@entry@field{#1}{long}% +} +\newcommand*{\glsentrylongpl}[1]{\@gls@entry@field{#1}{longpl}} +\newrobustcmd*{\Glsentrylongpl}[1]{% + \@Gls@entry@field{#1}{longpl}% +} +\newcommand*{\glsentryfull}[1]{% + \acrfullformat{\glsentrylong{#1}}{\acronymfont{\glsentryshort{#1}}}% +} +\newrobustcmd*{\Glsentryfull}[1]{% + \acrfullformat{\Glsentrylong{#1}}{\acronymfont{\glsentryshort{#1}}}% +} +\newcommand*{\glsentryfullpl}[1]{% + \acrfullformat{\glsentrylongpl{#1}}{\acronymfont{\glsentryshortpl{#1}}}% +} +\newrobustcmd*{\Glsentryfullpl}[1]{% + \acrfullformat{\Glsentrylongpl{#1}}{\acronymfont{\glsentryshortpl{#1}}}% +} +\newcommand*{\glsentrynumberlist}[1]{% + \glsdoifexists{#1}% + {% + \@gls@entry@field{#1}{numberlist}% + }% +} +\@ifpackageloaded{hyperref} {% + \newcommand*{\glsdisplaynumberlist}[1]{% + \GlossariesWarning + {% + \string\glsdisplaynumberlist\space + doesn't work with hyperref.^^JUsing + \string\glsentrynumberlist\space instead% + }% + \glsentrynumberlist{#1}% + }% +}% +{% + \newcommand*{\glsdisplaynumberlist}[1]{% + \glsdoifexists{#1}% + {% + \bgroup + \edef\@glo@label{\glsdetoklabel{#1}}% + \let\@org@glsnumberformat\glsnumberformat + \def\glsnumberformat##1{##1}% + \protected@edef\the@numberlist{% + \csname glo@\@glo@label @numberlist\endcsname}% + \def\@gls@numlist@sep{}% + \def\@gls@numlist@nextsep{}% + \def\@gls@numlist@lastsep{}% + \def\@gls@thislist{}% + \def\@gls@donext@def{}% + \renewcommand\do[1]{% + \protected@edef\@gls@thislist{% + \@gls@thislist + \noexpand\@gls@numlist@sep + ##1% + }% + \let\@gls@numlist@sep\@gls@numlist@nextsep + \def\@gls@numlist@nextsep{\glsnumlistsep}% + \@gls@donext@def + \def\@gls@donext@def{% + \def\@gls@numlist@lastsep{\glsnumlistlastsep}% + }% + }% + \expandafter \glsnumlistparser \expandafter{\the@numberlist}% + \let\@gls@numlist@sep\@gls@numlist@lastsep + \@gls@thislist + \egroup + }% + } +} +\newcommand*{\glsnumlistsep}{, } +\newcommand*{\glsnumlistlastsep}{ \& } +\newcommand*{\glshyperlink}[2][\glsentrytext{\@glo@label}]{% + \def\@glo@label{#2}% + \@glslink{\glolinkprefix\glsdetoklabel{#2}}{#1}} +\define@key{glossadd}{counter}{\def\@gls@counter{#1}} +\define@key{glossadd}{format}{\def\@glsnumberformat{#1}} +\define@key{glossadd}{types}{\def\@glo@type{#1}} +\newrobustcmd*{\glsadd}[2][]{% + \@gls@adjustmode + \glsdoifexists{#2}% + {% + \def\@glsnumberformat{glsnumberformat}% + \edef\@gls@counter{\csname glo@\glsdetoklabel{#2}@counter\endcsname}% + \setkeys{glossadd}{#1}% + \@gls@saveentrycounter + \@gls@setsort{#2}% + \@@do@wrglossary{#2}% + }% +} +\newcommand*{\@gls@adjustmode}{} +\AtBeginDocument{\renewcommand*{\@gls@adjustmode}{\ifvmode\mbox{}\fi}} +\newrobustcmd*{\glsaddall}[1][]{% + \edef\@glo@type{\@glo@types}% + \setkeys{glossadd}{#1}% + \forallglsentries[\@glo@type]{\@glo@entry}{% + \glsadd[#1]{\@glo@entry}% + }% +} +\newrobustcmd*{\glsaddallunused}[1][\@glo@types]{% + \forallglsentries[#1]{\@glo@entry}% + {% + \ifglsused{\@glo@entry}{}{\glsadd[format=glsignore]{\@glo@entry}}% + }% +} +\newcommand*{\glsignore}[1]{} +\edef\glsopenbrace{\expandafter\@gobble\string\{} +\edef\glsclosebrace{\expandafter\@gobble\string\}} +\edef\glsbackslash{\expandafter\@gobble\string\\} +\edef\glsquote#1{\string"#1\string"} +\edef\glspercentchar{\expandafter\@gobble\string\%} +\edef\glstildechar{\string~} +\ifglsxindy + \newcommand*{\@glsfirstletter}{A} +\fi +\newcommand*{\GlsSetXdyFirstLetterAfterDigits}{% + \@ifstar\s@GlsSetXdyFirstLetterAfterDigits\@GlsSetXdyFirstLetterAfterDigits} +\ifglsxindy + \newcommand*{\@GlsSetXdyFirstLetterAfterDigits}[1]{% + \renewcommand*{\@glsfirstletter}{#1}} + \newcommand*{\s@GlsSetXdyFirstLetterAfterDigits}[1]{% + \renewcommand*{\@glsfirstletter}{#1}% + \@onelevel@sanitize\@glsfirstletter + } +\else + \newcommand*{\@GlsSetXdyFirstLetterAfterDigits}[1]{% + \glsnoxindywarning\GlsSetXdyFirstLetterAfterDigits} + \newcommand*{\s@GlsSetXdyFirstLetterAfterDigits}{% + \@GlsSetXdyFirstLetterAfterDigits + } +\fi +\ifglsxindy + \newcommand*{\@xdynumbergrouporder}{:before \string"\@glsfirstletter\string"} +\fi +\newcommand*{\GlsSetXdyNumberGroupOrder}[1]{% + \@ifstar\s@GlsSetXdyNumberGroupOrder\@GlsSetXdyNumberGroupOrder +} +\ifglsxindy + \newcommand*{\@GlsSetXdyNumberGroupOrder}[1]{% + \renewcommand*{\@xdynumbergrouporder}{#1}% + } + \newcommand*{\s@GlsSetXdyNumberGroupOrder}[1]{% + \renewcommand*{\@xdynumbergrouporder}{#1}% + \@onelevel@sanitize\@xdynumbergrouporder + } +\else + \newcommand*{\@GlsSetXdyNumberGroupOrder}[1]{% + \glsnoxindywarning\GlsSetXdyNumberGroupOrder} + \newcommand*{\s@GlsSetXdyNumberGroupOrder}{% + \@GlsSetXdyNumberGroupOrder} +\fi +\newcommand*{\@glsminrange}{2} +\ifglsxindy + \newcommand*{\GlsSetXdyMinRangeLength}[1]{% + \renewcommand*{\@glsminrange}{#1}} +\else + \newcommand*{\GlsSetXdyMinRangeLength}[1]{% + \glsnoxindywarning\GlsSetXdyMinRangeLength} +\fi + +\ifglsxindy + \def\writeist{% + \ifundef{\glswrite}{\newwrite\glswrite}{}% + \@gls@addpredefinedattributes + \openout\glswrite=\istfilename + \write\glswrite{;; xindy style file created by the glossaries + package}% + \write\glswrite{;; for document '\jobname' on + \the\year-\the\month-\the\day}% + \write\glswrite{^^J; required styles^^J} + \@for\@xdystyle:=\@xdyrequiredstyles\do{% + \ifx\@xdystyle\@empty + \else + \protected@write\glswrite{}{(require + \string"\@xdystyle.xdy\string")}% + \fi + }% + \write\glswrite{^^J% + ; list of allowed attributes (number formats)^^J}% + \write\glswrite{(define-attributes ((\@xdyattributes)))}% + \write\glswrite{^^J; user defined alphabets^^J}% + \write\glswrite{\@xdyuseralphabets}% + \write\glswrite{^^J; location class definitions^^J}% + \@for\@gls@classI:=\@gls@xdy@locationlist\do{% + \protected@write\glswrite{}{(define-location-class + \string"\@gls@classI\string"^^J\space\space\space + ( + :sep "{}{" + \csname @gls@xdy@Lclass@\@gls@classI\endcsname\space + :sep "}" + ) + ^^J\space\space\space + :min-range-length \@glsminrange^^J% + ) + }% + {% + \@for\@gls@classII:=\@gls@xdy@locationlist\do{% + \protected@write\glswrite{}{(define-location-class + \string"\@gls@classII-\@gls@classI\string" + ^^J\space\space\space + ( + :sep "{" + \csname @gls@xdy@Lclass@\@gls@classII\endcsname\space + :sep "}{" + \csname @gls@xdy@Lclass@\@gls@classI\endcsname\space + :sep "}" + ) + ^^J\space\space\space + :min-range-length \@glsminrange^^J% + ) + }% + }% + }% + }% + \write\glswrite{^^J; user defined location classes}% + \write\glswrite{\@xdyuserlocationdefs}% + \write\glswrite{^^J; define cross-reference class^^J}% + \write\glswrite{(define-crossref-class \string"see\string" + :unverified )}% + \write\glswrite{(markup-crossref-list + :class \string"see\string"^^J\space\space\space + :open \string"\string\glsseeformat\string" + :close \string"{}\string")}% + \@xdycrossrefhook + \write\glswrite{^^J; define the order of the location classes}% + \write\glswrite{(define-location-class-order + (\@xdylocationclassorder))}% + \write\glswrite{^^J; define the glossary markup^^J}% + \write\glswrite{(markup-index^^J\space\space\space + :open \string"\string + \glossarysection[\string\glossarytoctitle]{\string + \glossarytitle}\string\glossarypreamble}% + \@for\@this@ctr:=\@xdycounters\do{% + {% + \@for\@this@attr:=\@xdyattributelist\do{% + \protected@write\glswrite{}{\string\providecommand*% + \expandafter\string + \csname glsX\@this@ctr X\@this@attr\endcsname[2]% + {% + \string\setentrycounter + [\expandafter\@gobble\string\#1]{\@this@ctr}% + \expandafter\string + \csname\@this@attr\endcsname + {\expandafter\@gobble\string\#2}% + }% + }% + }% + }% + }% + \write\glswrite{% + \string\begin + {theglossary}\string\glossaryheader\glstildechar n\string" ^^J\space + \space\space:close \string"\glspercentchar\glstildechar n\string + \end{theglossary}\string\glossarypostamble + \glstildechar n\string" ^^J\space\space\space + :tree)}% + \write\glswrite{(markup-letter-group-list + :sep \string"\string\glsgroupskip\glstildechar n\string")}% + \write\glswrite{(markup-indexentry + :open \string"\string\relax \string\glsresetentrylist + \glstildechar n\string")}% + \write\glswrite{(markup-locclass-list :open + \string"\glsopenbrace\string\glossaryentrynumbers + \glsopenbrace\string\relax\space \string"^^J\space\space\space + :sep \string", \string" + :close \string"\glsclosebrace\glsclosebrace\string")}% + \write\glswrite{(markup-locref-list + :sep \string"\string\delimN\space\string")}% + \write\glswrite{(markup-range + :sep \string"\string\delimR\space\string")}% + \@onelevel@sanitize\gls@suffixF + \@onelevel@sanitize\gls@suffixFF + \ifx\gls@suffixF\@empty + \else + \write\glswrite{(markup-range + :close "\gls@suffixF" :length 1 :ignore-end)}% + \fi + \ifx\gls@suffixFF\@empty + \else + \write\glswrite{(markup-range + :close "\gls@suffixFF" :length 2 :ignore-end)}% + \fi + \write\glswrite{^^J; define format to use for locations^^J}% + \write\glswrite{\@xdylocref}% + \write\glswrite{^^J; define letter group list format^^J}% + \write\glswrite{(markup-letter-group-list + :sep \string"\string\glsgroupskip\glstildechar n\string")}% + \write\glswrite{^^J; letter group headings^^J}% + \write\glswrite{(markup-letter-group + :open-head \string"\string\glsgroupheading + \glsopenbrace\string"^^J\space\space\space + :close-head \string"\glsclosebrace\string")}% + \write\glswrite{^^J; additional letter groups^^J}% + \write\glswrite{\@xdylettergroups}% + \write\glswrite{^^J; additional sort rules^^J} + \write\glswrite{\@xdysortrules}% + \@gls@writeisthook + \closeout\glswrite + \let\writeist\relax + } +\else + \edef\@gls@actualchar{\string?} + \edef\@gls@encapchar{\string|} + \edef\@gls@levelchar{\string!} + \edef\@gls@quotechar{\string"}% + \let\GlsSetQuote\gls@nosetquote + \def\writeist{\relax + \ifundef{\glswrite}{\newwrite\glswrite}{}\relax + \openout\glswrite=\istfilename + \write\glswrite{\glspercentchar\space makeindex style file + created by the glossaries package} + \write\glswrite{\glspercentchar\space for document + '\jobname' on \the\year-\the\month-\the\day} + \write\glswrite{actual '\@gls@actualchar'} + \write\glswrite{encap '\@gls@encapchar'} + \write\glswrite{level '\@gls@levelchar'} + \write\glswrite{quote '\@gls@quotechar'} + \write\glswrite{keyword \string"\string\\glossaryentry\string"} + \write\glswrite{preamble \string"\string\\glossarysection[\string + \\glossarytoctitle]{\string\\glossarytitle}\string + \\glossarypreamble\string\n\string\\begin{theglossary}\string + \\glossaryheader\string\n\string"} + \write\glswrite{postamble \string"\string\%\string\n\string + \\end{theglossary}\string\\glossarypostamble\string\n + \string"} + \write\glswrite{group_skip \string"\string\\glsgroupskip\string\n + \string"} + \write\glswrite{item_0 \string"\string\%\string\n\string"} + \write\glswrite{item_1 \string"\string\%\string\n\string"} + \write\glswrite{item_2 \string"\string\%\string\n\string"} + \write\glswrite{item_01 \string"\string\%\string\n\string"} + \write\glswrite{item_x1 + \string"\string\\relax \string\\glsresetentrylist\string\n + \string"} + \write\glswrite{item_12 \string"\string\%\string\n\string"} + \write\glswrite{item_x2 + \string"\string\\relax \string\\glsresetentrylist\string\n + \string"} + \write\glswrite{delim_0 \string"\string\{\string + \\glossaryentrynumbers\string\{\string\\relax \string"} + \write\glswrite{delim_1 \string"\string\{\string + \\glossaryentrynumbers\string\{\string\\relax \string"} + \write\glswrite{delim_2 \string"\string\{\string + \\glossaryentrynumbers\string\{\string\\relax \string"} + \write\glswrite{delim_t \string"\string\}\string\}\string"} + \write\glswrite{delim_n \string"\string\\delimN \string"} + \write\glswrite{delim_r \string"\string\\delimR \string"} + \write\glswrite{headings_flag 1} + \write\glswrite{heading_prefix + \string"\string\\glsgroupheading\string\{\string"} + \write\glswrite{heading_suffix + \string"\string\}\string\\relax + \string\\glsresetentrylist \string"} + \write\glswrite{symhead_positive \string"glssymbols\string"} + \write\glswrite{numhead_positive \string"glsnumbers\string"} + \write\glswrite{page_compositor \string"\glscompositor\string"} + \@gls@escbsdq\gls@suffixF + \@gls@escbsdq\gls@suffixFF + \ifx\gls@suffixF\@empty + \else + \write\glswrite{suffix_2p \string"\gls@suffixF\string"} + \fi + \ifx\gls@suffixFF\@empty + \else + \write\glswrite{suffix_3p \string"\gls@suffixFF\string"} + \fi + \@gls@writeisthook + \closeout\glswrite + \let\writeist\relax + } +\fi +\newcommand*{\GlsSetWriteIstHook}[1]{\renewcommand*{\@gls@writeisthook}{#1}} +\@onlypremakeg\GlsSetWriteIstHook +\newcommand*{\@gls@writeisthook}{} +\ifglsxindy + \newcommand*{\GlsSetQuote}[1]{\glsnomakeindexwarning\GlsSetQuote} + \newcommand*{\gls@nosetquote}[1]{\glsnomakeindexwarning\GlsSetQuote} +\else + \newcommand*{\GlsSetQuote}[1]{\edef\@gls@quotechar{\string#1}% + \@ifpackageloaded{tracklang}% + {% + \IfTrackedLanguage{german}% + {% + \def\@@gls@extramakeindexopts{-g}% + }% + {}% + }% + {}% + \edef\@gls@docheckquotedef{% + \noexpand\def\noexpand\@gls@checkquote####1#1####2#1####3\noexpand\null{% + \noexpand\@gls@tmpb=\noexpand\expandafter{\noexpand\@gls@checkedmkidx}% + \noexpand\toks@={####1}% + \noexpand\ifx\noexpand\null####2\noexpand\null + \noexpand\ifx\noexpand\null####3\noexpand\null + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@}% + \noexpand\def\noexpand\@@gls@checkquote{\noexpand\relax}% + \noexpand\else + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@ + \noexpand\@gls@quotechar\noexpand\@gls@quotechar + \noexpand\@gls@quotechar\noexpand\@gls@quotechar}% + \noexpand\def\noexpand\@@gls@checkquote{% + \noexpand\@gls@checkquote####3\noexpand\null}% + \noexpand\fi + \noexpand\else + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@ + \noexpand\@gls@quotechar\noexpand\@gls@quotechar}% + \noexpand\ifx\noexpand\null####3\noexpand\null + \noexpand\def\noexpand\@@gls@checkquote{% + \noexpand\@gls@checkquote####2#1#1\noexpand\null}% + \noexpand\else + \noexpand\def\noexpand\@@gls@checkquote{% + \noexpand\@gls@checkquote####2#1####3\noexpand\null}% + \noexpand\fi + \noexpand\fi + \noexpand\@@gls@checkquote + }% + }% + \@gls@docheckquotedef + \edef\@gls@docheckquotedef{% + \noexpand\renewcommand{\noexpand\@gls@checkmkidxchars}[1]{% + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkquote####1\noexpand\@nil + #1#1\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkescquote####1\noexpand\@nil + \expandonce{\csname#1\endcsname}\expandonce{\csname#1\endcsname}% + \noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkescactual####1\noexpand\@nil + \noexpand\?\noexpand\?\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkactual####1\noexpand\@nil + \noexpand?\noexpand?\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkbar####1\noexpand\@nil + \noexpand|\noexpand|\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checkescbar####1\noexpand\@nil + \noexpand\|\noexpand\|\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% + \noexpand\def\noexpand\@gls@checkedmkidx{}% + \noexpand\expandafter\noexpand\@gls@checklevel####1\noexpand\@nil + \noexpand!\noexpand!\noexpand\null + \noexpand\expandafter\noexpand\@gls@updatechecked + \noexpand\@gls@checkedmkidx{####1}% + }% + }% + \@gls@docheckquotedef + \edef\@gls@docheckquotedef{% + \noexpand\def\noexpand\@gls@checkescquote####1% + \expandonce{\csname#1\endcsname}####2\expandonce{\csname#1\endcsname}% + ####3\noexpand\null{% + \noexpand\@gls@tmpb=\noexpand\expandafter{\noexpand\@gls@checkedmkidx}% + \noexpand\toks@={####1}% + \noexpand\ifx\noexpand\null####2\noexpand\null + \noexpand\ifx\noexpand\null####3\noexpand\null + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@}% + \noexpand\def\noexpand\@@gls@checkescquote{\noexpand\relax}% + \noexpand\else + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@ + \noexpand\@gls@quotechar\noexpand\string\expandonce{% + \csname#1\endcsname}\noexpand\@gls@quotechar + \noexpand\@gls@quotechar\noexpand\string\expandonce{% + \csname#1\endcsname}\noexpand\@gls@quotechar}% + \noexpand\def\noexpand\@@gls@checkescquote{% + \noexpand\@gls@checkescquote####3\noexpand\null}% + \noexpand\fi + \noexpand\else + \noexpand\edef\noexpand\@gls@checkedmkidx{% + \noexpand\the\noexpand\@gls@tmpb\noexpand\the\noexpand\toks@ + \noexpand\@gls@quotechar\noexpand\string + \expandonce{\csname#1\endcsname}\noexpand\@gls@quotechar}% + \noexpand\ifx\noexpand\null####3\noexpand\null + \noexpand\def\noexpand\@@gls@checkescquote{% + \noexpand\@gls@checkescquote####2\expandonce{\csname#1\endcsname}% + \expandonce{\csname#1\endcsname}\noexpand\null}% + \noexpand\else + \noexpand\def\noexpand\@@gls@checkescquote{% + \noexpand\@gls@checkescquote####2\expandonce{\csname#1\endcsname}% + ####3\noexpand\null}% + \noexpand\fi + \noexpand\fi + \noexpand\@@gls@checkescquote + }% + }% + \@gls@docheckquotedef + } + \newcommand*{\gls@nosetquote}[1]{\PackageError{glossaries}% + {\string\GlsSetQuote\space not permitted here}% + {Move \string\GlsSetQuote\space earlier in the preamble, as + soon as possible after glossaries.sty has been loaded}} +\fi +\newcommand*{\@gls@extramakeindexopts}[1]{} +\newcommand{\noist}{% + \@gls@addpredefinedattributes + \let\writeist\relax +} +\newcommand*{\@makeglossary}[1]{% + \ifglossaryexists{#1}% + {% + \ifglssavewrites + \expandafter\newtoks\csname glo@#1@filetok\endcsname + \else + \expandafter\newwrite\csname glo@#1@file\endcsname + \expandafter\@glsopenfile\csname glo@#1@file\endcsname{#1}% + \fi + \@gls@renewglossary + \writeist + }% + {% + \PackageError{glossaries}% + {Glossary type `#1' not defined}% + {New glossaries must be defined before using \string\makeglossaries}% + }% +} +\newcommand*{\@glsopenfile}[2]{% + \immediate\openout#1=\jobname.\csname @glotype@#2@out\endcsname + \PackageInfo{glossaries}{Writing glossary file + \jobname.\csname @glotype@#2@out\endcsname}% +} +\newcommand*{\@closegls}[1]{% + \closeout\csname glo@#1@file\endcsname +} +\ifglsxindy + \newcommand*{\@gls@automake}[1]{% + \ifglossaryexists{#1} + {% + \@closegls{#1}% + \ifdefstring{\glsorder}{letter}% + {\def\@gls@order{-M ord/letorder }}% + {\let\@gls@order\@empty}% + \ifcsundef{@xdy@#1@language}% + {\let\@gls@langmod\@xdy@main@language}% + {\letcs\@gls@langmod{@xdy@#1@language}}% + \edef\@gls@dothiswrite{\noexpand\write18{xindy + -I xindy + \@gls@order + -L \@gls@langmod\space + -M \gls@istfilebase\space + -C \gls@codepage\space + -t \jobname.\csuse{@glotype@#1@log} + -o \jobname.\csuse{@glotype@#1@in} + \jobname.\csuse{@glotype@#1@out}}% + }% + \@gls@dothiswrite + }% + {% + \GlossariesWarning{Can't make glossary `#1', it doesn't exist}% + }% + } +\else + \newcommand*{\@gls@automake}[1]{% + \ifglossaryexists{#1} + {% + \@closegls{#1}% + \ifdefstring{\glsorder}{letter}% + {\def\@gls@order{-l }}% + {\let\@gls@order\@empty}% + \edef\@gls@dothiswrite{\noexpand\write18{makeindex \@gls@order + -s \istfilename\space + -t \jobname.\csuse{@glotype@#1@log} + -o \jobname.\csuse{@glotype@#1@in} + \jobname.\csuse{@glotype@#1@out}}% + }% + \@gls@dothiswrite + }% + {% + \GlossariesWarning{Can't make glossary `#1', it doesn't exist}% + }% + } +\fi +\ifglsxindy + \newcommand*{\@gls@automake@immediate}[1]{% + \ifglossaryexists{#1} + {% + \IfFileExists{\jobname.\csuse{@glotype@#1@out}}% + {% + \ifdefstring{\glsorder}{letter}% + {\def\@gls@order{-M ord/letorder }}% + {\let\@gls@order\@empty}% + \ifcsundef{@xdy@#1@language}% + {\let\@gls@langmod\@xdy@main@language}% + {\letcs\@gls@langmod{@xdy@#1@language}}% + \edef\@gls@dothiswrite{\noexpand\immediate\noexpand\write18{xindy + -I xindy + \@gls@order + -L \@gls@langmod\space + -M \gls@istfilebase\space + -C \gls@codepage\space + -t \jobname.\csuse{@glotype@#1@log} + -o \jobname.\csuse{@glotype@#1@in} + \jobname.\csuse{@glotype@#1@out}}% + }% + \@gls@dothiswrite + }% + {\GlossariesWarning{can't automake `#1': \jobname.\csuse{@glotype@#1@out} + doesn't exist. Rerun may be required}}% + }% + {% + \GlossariesWarning{Can't make glossary `#1', it doesn't exist}% + }% + } +\else + \newcommand*{\@gls@automake@immediate}[1]{% + \ifglossaryexists{#1} + {% + \IfFileExists{\jobname.\csuse{@glotype@#1@out}}% + {% + \ifdefstring{\glsorder}{letter}% + {\def\@gls@order{-l }}% + {\let\@gls@order\@empty}% + \edef\@gls@dothiswrite{\noexpand\immediate\noexpand\write18{makeindex \@gls@order + -s \istfilename\space + -t \jobname.\csuse{@glotype@#1@log} + -o \jobname.\csuse{@glotype@#1@in} + \jobname.\csuse{@glotype@#1@out}}% + }% + \@gls@dothiswrite + }% + {\GlossariesWarning{can't automake `#1': \jobname.\csuse{@glotype@#1@out} + doesn't exist. Rerun may be required}}% + }% + {% + \GlossariesWarning{Can't make glossary `#1', it doesn't exist}% + }% + } +\fi +\newcommand*{\@warn@nomakeglossaries}{} +\newcommand*{\warn@nomakeglossaries}{\@warn@nomakeglossaries} +\newcommand{\@gls@@automake@immediate}{% + \ifnum\gls@automake@nr=2\relax + \@for\@gls@type:=\@glo@types\do{% + \ifdefempty{\@gls@type}{}% + {\@gls@automake@immediate{\@gls@type}}% + }% + \glsautomakefalse + \renewcommand*{\@gls@doautomake}{}% + \fi +} +\newcommand*{\makeglossaries}{% + \@domakeglossaries + {% + \@gls@@automake@immediate + \ifundef{\glswrite}{\newwrite\glswrite}{}% + \protected@write\@auxout{}{\string\providecommand\string\@glsorder[1]{}} + \protected@write\@auxout{}{\string\providecommand\string\@istfilename[1]{}} + \ifundef\@@gls@extramakeindexopts + {}% + {% + \protected@write\@auxout{}{\string\providecommand + \string\@gls@extramakeindexopts[1]{}} + \protected@write\@auxout{}{\string\@gls@extramakeindexopts + {\@@gls@extramakeindexopts}}% + }% + \protected@write\@auxout{}{\string\@istfilename{\istfilename}}% + \protected@write\@auxout{}{\string\@glsorder{\glsorder}} + \@for\@glo@type:=\@glo@types\do{% + \ifthenelse{\equal{\@glo@type}{}}{}{% + \@makeglossary{\@glo@type}}% + }% + \renewcommand*\newglossary[4][]{% + \PackageError{glossaries}{New glossaries + must be created before \string\makeglossaries}{You need + to move \string\makeglossaries\space after all your + \string\newglossary\space commands}}% + \let\@makeglossary\@gobble + \let\makeglossaries\relax + \@disable@onlypremakeg + \let\gls@checkseeallowed\relax + \let\warn@nomakeglossaries\relax + \def\warn@noprintglossary{% + \ifdefstring{\@glo@types}{,}% + {% + \GlossariesWarningNoLine{No glossaries have been defined}% + }% + {% + \GlossariesWarningNoLine{No \string\printglossary\space + or \string\printglossaries\space + found. ^^J(Remove \string\makeglossaries\space if you + don't want any glossaries.) ^^JThis document will not + have a glossary}% + }% + }% + \ifglssavenumberlist + \edef\@gls@dodeflistparser{\noexpand\DeclareListParser + {\noexpand\glsnumlistparser}{\delimN}}% + \@gls@dodeflistparser + \fi + \let\makenoidxglossaries\@no@makeglossaries + \renewcommand*{\@printgloss@setsort}{% + \let\@glo@assign@sortkey\@glo@no@assign@sortkey + }% + \ifglsautomake + \renewcommand*{\@gls@doautomake}{% + \@for\@gls@type:=\@glo@types\do{% + \ifdefempty{\@gls@type}{}% + {\@gls@automake{\@gls@type}}% + }% + }% + \fi + \@glo@check@sortallowed\makeglossaries + }% +} +\@onlypreamble{\makeglossaries} +\AtEndDocument{% + \warn@nomakeglossaries + \warn@noprintglossary +} +\newcommand*{\makenoidxglossaries}{% + \@domakeglossaries + {% + \renewcommand{\@gls@noref@warn}[1]{% + \GlossariesWarning{Empty glossary for + \string\printnoidxglossary[type={##1}]. + Rerun may be required (or you may have forgotten to use + commands like \string\gls)}% + }% + \let\@gls@checkmkidxchars\@gobble + \glsesclocationsfalse + \let\@@do@@wrglossary\gls@noidxglossary + \let\@gls@getgrouptitle\@gls@noidx@getgrouptitle + \let\gls@checkseeallowed\relax + \renewcommand{\@do@seeglossary}[2]{% + \edef\@gls@label{\glsdetoklabel{##1}}% + \protected@write\@auxout{}{% + \string\@gls@reference + {\csname glo@\@gls@label @type\endcsname}% + {\@gls@label}% + {% + \string\glsseeformat##2{}% + }% + }% + }% + \AtBeginDocument + {% + \write\@auxout{\string\providecommand\string\@gls@reference[3]{}}% + }% + \def\warn@noprintglossary{% + \GlossariesWarningNoLine{No \string\printnoidxglossary\space + or \string\printnoidxglossaries ^^J + found. (Remove \string\makenoidxglossaries\space if you + don't want any glossaries.)^^JThis document will not have a glossary}% + }% + \let\warn@nomakeglossaries\relax + \let\makeglossaries\@no@makeglossaries + \renewcommand*{\@printgloss@setsort}{% + \let\@glo@assign@sortkey\@@glo@assign@sortkey + \def\@glo@sorttype{\@glo@default@sorttype}% + }% + \renewcommand*\new@glossaryentry[2]{% + \PackageError{glossaries}{Glossary entries must be + defined in the preamble^^Jwhen you use + \string\makenoidxglossaries}% + {Either move your definitions to the preamble or use + \string\makeglossaries}% + }% + \renewcommand*{\glsentrynumberlist}[1]{% + \letcs{\@gls@loclist}{glo@\glsdetoklabel{##1}@loclist}% + \ifdef\@gls@loclist + {% + \glsnoidxloclist{\@gls@loclist}% + }% + {% + ??\glsdoifexists{##1}% + {% + \GlossariesWarning{Missing location list for `##1'. Either + a rerun is required or you haven't referenced the entry}% + }% + }% + }% + \renewcommand*{\glsdisplaynumberlist}[1]{% + \letcs{\@gls@loclist}{glo@\glsdetoklabel{##1}@loclist}% + \ifdef\@gls@loclist + {% + \def\@gls@noidxloclist@sep{% + \def\@gls@noidxloclist@sep{% + \def\@gls@noidxloclist@sep{% + \glsnumlistsep + }% + \def\@gls@noidxloclist@finalsep{\glsnumlistlastsep}% + }% + }% + \def\@gls@noidxloclist@finalsep{}% + \def\@gls@noidxloclist@prev{}% + \forlistloop{\glsnoidxdisplayloclisthandler}{\@gls@loclist}% + \@gls@noidxloclist@finalsep + \@gls@noidxloclist@prev + }% + {% + ??\glsdoifexists{##1}% + {% + \GlossariesWarning{Missing location list for `##1'. Either + a rerun is required or you haven't referenced the entry}% + }% + }% + }% + \renewcommand*{\glsnumberlistloop}[3]{% + \letcs{\@gls@loclist}{glo@\glsdetoklabel{##1}@loclist}% + \let\@gls@org@glsnoidxdisplayloc\glsnoidxdisplayloc + \let\@gls@org@glsseeformat\glsseeformat + \let\glsnoidxdisplayloc##2\relax + \let\glsseeformat##3\relax + \ifdef\@gls@loclist + {% + \forlistloop{\glsnoidxnumberlistloophandler}{\@gls@loclist}% + }% + {% + ??\glsdoifexists{##1}% + {% + \GlossariesWarning{Missing location list for `##1'. Either + a rerun is required or you haven't referenced the entry}% + }% + }% + \let\glsnoidxdisplayloc\@gls@org@glsnoidxdisplayloc + \let\glsseeformat\@gls@org@glsseeformat + }% + \let\@@gls@sanitizesort\@gls@noidx@sanitizesort + \let\@@gls@nosanitizesort\@@gls@noidx@nosanitizesort + \@gls@noidx@setsanitizesort + \@glo@check@sortallowed\makenoidxglossaries + }% +} +\@onlypreamble{\makenoidxglossaries} +\newcommand*{\glsnumberlistloop}[2]{% + \PackageError{glossaries}{\string\glsnumberlistloop\space + only works with \string\makenoidxglossaries}{}% +} +\newcommand*{\glsnoidxnumberlistloophandler}[1]{% + #1% +} +\newcommand*{\@no@makeglossaries}{% + \PackageError{glossaries}{You can't use both + \string\makeglossaries\space and \string\makenoidxglossaries}% + {Either use one or other (or none) of those commands but not both + together.}% +} +\newcommand{\@gls@noref@warn}[1]{% + \GlossariesWarning{\string\makenoidxglossaries\space + is required to make \string\printnoidxglossary[type={#1}] work}% +} +\newcommand*{\gls@noidxglossary}{% + \protected@write\@auxout{}{% + \string\@gls@reference + {\csname glo@\@gls@label @type\endcsname}% + {\@gls@label}% + {\string\glsnoidxdisplayloc + {\@glo@counterprefix}% + {\@gls@counter}% + {\@glsnumberformat}% + {\@glslocref}% + }% + }% +} +\providecommand\istfile{\glswrite} +\AtEndDocument{% + \glswritefiles +} +\newcommand*{\@glswritefiles}{% + \forallglossaries{\@glo@type}{% + \ifcsundef{glo@\@glo@type @filetok}% + {% + \def\gls@tmp{}% + }% + {% + \edef\gls@tmp{\expandafter\the + \csname glo@\@glo@type @filetok\endcsname}% + }% + \ifx\gls@tmp\@empty + \ifx\@glo@type\glsdefaulttype + \GlossariesWarningNoLine{Glossary `\@glo@type' has no + entries.^^JRemember to use package option `nomain' if +you + don't want to^^Juse the main glossary}% + \else + \GlossariesWarningNoLine{Glossary `\@glo@type' has no + entries}% + \fi + \else + \@glsopenfile{\glswrite}{\@glo@type}% + \immediate\write\glswrite{% + \expandafter\the + \csname glo@\@glo@type @filetok\endcsname}% + \immediate\closeout\glswrite + \fi + }% +} +\newcommand*{\gls@glossary}[1]{% + \@gls@glossary{#1}% +} +\newcommand*{\@gls@glossary}[2]{% + \if@gls@debug + \PackageInfo{glossaries}{wrglossary(#1)(#2)}% + \fi +} +\newcommand{\@gls@renewglossary}{% + \gdef\@gls@glossary##1{\@bsphack\begingroup\gls@wrglossary{##1}}% + \let\@gls@renewglossary\@empty +} +\newcommand*{\gls@wrglossary}[2]{% + \ifglssavewrites + \protected@edef\@gls@tmp{\the\csname glo@#1@filetok\endcsname#2}% + \expandafter\global\expandafter\csname glo@#1@filetok\endcsname + \expandafter{\@gls@tmp^^J}% + \else + \ifcsdef{glo@#1@file}% + {% + \expandafter\protected@write\csname glo@#1@file\endcsname{% + \gls@disablepagerefexpansion}{#2}% + }% + {% + \ifignoredglossary{#1}{}% + {% + \GlossariesWarning{No file defined for glossary `#1'}% + }% + }% + \fi + \endgroup\@esphack +} +\newcommand*{\@do@wrglossary}[1]{% + \glswriteentry{#1}{\@@do@wrglossary{#1}}% +} +\newcommand*{\glswriteentry}[2]{% + \ifglsindexonlyfirst + \ifglsused{#1}{}{#2}% + \else + #2% + \fi +} +\newcommand{\gls@protected@pagefmts}{\gls@numberpage,\gls@alphpage,% + \gls@Alphpage,\gls@romanpage,\gls@Romanpage,\gls@arabicpage} +\newcommand*{\gls@disablepagerefexpansion}{% + \@for\@gls@this:=\gls@protected@pagefmts\do + {% + \expandafter\let\@gls@this\relax + }% +} +\newcommand*{\gls@alphpage}{\@alph\c@page} +\newcommand*{\gls@Alphpage}{\@Alph\c@page} +\newcommand*{\gls@numberpage}{\number\c@page} +\newcommand*{\gls@arabicpage}{\@arabic\c@page} +\newcommand*{\gls@romanpage}{\romannumeral\c@page} +\newcommand*{\gls@Romanpage}{\@Roman\c@page} +\newcommand*{\glsaddprotectedpagefmt}[1]{% + \eappto\gls@protected@pagefmts{,\expandonce{\csname gls#1page\endcsname}}% + \csedef{gls#1page}{\expandonce{\csname#1\endcsname}\noexpand\c@page}% + \eappto\@wrglossarynumberhook{% + \noexpand\let\expandonce{\csname org@gls#1\endcsname}% + \expandonce{\csname#1\endcsname}% + \noexpand\def\expandonce{\csname#1\endcsname}{% + \noexpand\@wrglossary@pageformat + \expandonce{\csname gls#1page\endcsname}% + \expandonce{\csname org@gls#1\endcsname}% + }% + }% +} +\newcommand*\@wrglossarynumberhook{} +\newcommand{\@wrglossary@pageformat}[3]{% + \ifx#3\c@page #1\else #2#3\fi +} +\newcommand*{\@@do@wrglossary}[1]{% + \ifglsesclocations + \@@do@esc@wrglossary{#1}% + \else + \@@do@noesc@wrglossary{#1}% + \fi +} +\newcommand*{\@@do@noesc@wrglossary}[1]{% + \expandafter\def\expandafter\@glslocref\expandafter{\theglsentrycounter}% + \expandafter\def\expandafter\@glsHlocref\expandafter{\theHglsentrycounter}% + \ifx\@glsHlocref\@glslocref + \def\@glo@counterprefix{}% + \else + \protected@edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix + {\@glslocref}{\@glsHlocref}% + }% + \@do@gls@getcounterprefix + \fi + \edef\@gls@label{\glsdetoklabel{#1}}% + \@@do@@wrglossary +} +\newif\ifglswrallowprimitivemods +\glswrallowprimitivemodstrue +\newcommand*{\@@do@esc@wrglossary}[1]{% please read documented code! + \begingroup + \let\gls@orgthe\the + \let\gls@orgnumber\number + \let\gls@orgarabic\@arabic + \let\gls@orgromannumeral\romannumeral + \let\gls@orgalph\@alph + \let\gls@orgAlph\@Alph + \let\gls@orgRoman\@Roman + \ifglswrallowprimitivemods + \def\gls@the##1{% + \ifx##1\c@page \gls@numberpage\else\gls@orgthe##1\fi}% + \def\the{\expandafter\gls@the}% + \def\gls@number##1{% + \ifx##1\c@page \gls@numberpage\else\gls@orgnumber##1\fi}% + \def\number{\expandafter\gls@number}% + \fi + \def\@arabic##1{% + \ifx##1\c@page \gls@arabicpage\else\gls@orgarabic##1\fi}% + \def\romannumeral##1{% + \ifx##1\c@page \gls@romanpage\else\gls@orgromannumeral##1\fi}% + \def\@Roman##1{% + \ifx##1\c@page \gls@Romanpage\else\gls@orgRoman##1\fi}% + \def\@alph##1{% + \ifx##1\c@page \gls@alphpage\else\gls@orgalph##1\fi}% + \def\@Alph##1{% + \ifx##1\c@page \gls@Alphpage\else\gls@orgAlph##1\fi}% + \@wrglossarynumberhook + \gls@disablepagerefexpansion + \protected@xdef\@glslocref{\theglsentrycounter}% + \endgroup + \@gls@checkmkidxchars\@glslocref + \expandafter\ifx\theHglsentrycounter\theglsentrycounter\relax + \def\@glo@counterprefix{}% + \else + \protected@edef\@glsHlocref{\theHglsentrycounter}% + \@gls@checkmkidxchars\@glsHlocref + \edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix + {\@glslocref}{\@glsHlocref}% + }% + \@do@gls@getcounterprefix + \fi + \edef\@gls@label{\glsdetoklabel{#1}}% + \@@do@@wrglossary +} +\newcommand*{\@@do@@wrglossary}{% + \ifglsxindy + \expandafter\@glo@check@mkidxrangechar\@glsnumberformat\@nil + \def\@glo@range{}% + \expandafter\if\@glo@prefix(\relax + \def\@glo@range{:open-range}% + \else + \expandafter\if\@glo@prefix)\relax + \def\@glo@range{:close-range}% + \fi + \fi + \gls@glossary{\csname glo@\@gls@label @type\endcsname}{% + (indexentry :tkey (\csname glo@\@gls@label @index\endcsname) + :locref \string"{\@glo@counterprefix}{\@glslocref}\string" % + :attr \string"\@gls@counter\@glo@suffix\string" + \@glo@range + ) + }% + \else + \@set@glo@numformat{\@glo@numfmt}{\@gls@counter}{\@glsnumberformat}% + {\@glo@counterprefix}% + \gls@glossary{\csname glo@\@gls@label @type\endcsname}{% + \string\glossaryentry{\csname glo@\@gls@label @index\endcsname + \@gls@encapchar\@glo@numfmt}{\@glslocref}}% + \fi +} +\newcommand*\@gls@getcounterprefix[2]{% + \edef\@gls@thisloc{#1}\edef\@gls@thisHloc{#2}% + \ifx\@gls@thisloc\@gls@thisHloc + \def\@glo@counterprefix{}% + \else + \def\@gls@get@counterprefix##1.#1##2\end@getprefix{% + \def\@glo@tmp{##2}% + \ifx\@glo@tmp\@empty + \def\@glo@counterprefix{}% + \else + \def\@glo@counterprefix{##1}% + \fi + }% + \@gls@get@counterprefix#2.#1\end@getprefix + \ifx\@glo@counterprefix\@empty + \GlossariesWarning{Hyper target `#2' can't be formed by + prefixing^^Jlocation `#1'. You need to modify the + definition of \string\theH\@gls@counter^^Jotherwise you + will get the warning: "`name{\@gls@counter.#1}' has been^^J + referenced but does not exist"}% + \fi + \fi +} +\newcommand{\@do@seeglossary}[2]{% +\def\@gls@xref{#2}% +\@onelevel@sanitize\@gls@xref +\@gls@checkmkidxchars\@gls@xref +\ifglsxindy + \gls@glossary{\csname glo@#1@type\endcsname}{% + (indexentry + :tkey (\csname glo@#1@index\endcsname) + :xref (\string"\@gls@xref\string") + :attr \string"see\string" + ) + }% +\else + \gls@glossary{\csname glo@#1@type\endcsname}{% + \string\glossaryentry{\csname glo@#1@index\endcsname + \@gls@encapchar glsseeformat\@gls@xref}{Z}}% +\fi +} +\def\@gls@fixbraces#1#2#3\@nil{% + \ifx#2[\relax + \@@gls@fixbraces#1#2#3\@end@fixbraces + \else + \def#1{{#2#3}}% + \fi +} +\def\@@gls@fixbraces#1[#2]#3\@end@fixbraces{% + \def#1{[#2]{#3}}% +} +\newrobustcmd*{\glssee}[3][\seename]{% + \@do@seeglossary{#2}{[#1]{#3}}} +\newcommand*{\@glssee}[3][\seename]{% + \glssee[#1]{#3}{#2}} +\newrobustcmd*{\glsseeformat}[3][\seename]{% + \emph{#1} \glsseelist{#2}} +\newrobustcmd*{\glsseelist}[1]{% + \let\@gls@dolast\relax + \let\@gls@donext\relax + \@for\@gls@thislabel:=#1\do{% + \ifx\@xfor@nextelement\@nnil + \@gls@dolast + \else + \@gls@donext + \fi + \expandafter\glsseeitem\expandafter{\@gls@thislabel}% + \let\@gls@dolast\glsseelastsep + \let\@gls@donext\glsseesep + }% +} +\newcommand*{\glsseelastsep}{\space\andname\space} +\newcommand*{\glsseesep}{, } +\newrobustcmd*{\glsseeitem}[1]{\glshyperlink[\glsseeitemformat{#1}]{#1}} +\newcommand*{\glsseeitemformat}[1]{\glsentrytext{#1}} +\newcommand*{\gls@save@numberlist}[1]{% + \ifglssavenumberlist + \toks@{#1}% + \edef\@do@writeaux@info{% + \noexpand\csgdef{glo@\glscurrententrylabel @numberlist}{\the\toks@}% + }% + \@onelevel@sanitize\@do@writeaux@info + \protected@write\@auxout{}{\@do@writeaux@info}% + \fi +} +\newcommand*{\warn@noprintglossary}{}% +\ifcsundef{printglossary}{}% +{% + \@gls@warnonglossdefined + \undef\printglossary +} +\newcommand*{\@printgloss@checkexists@noignored}[2]{% + \@ifglossaryexists{#1}% + {#2}% + {% + \ifignoredglossary{#1}% + {\GlossariesWarning{Glossary `#1' is an ignored glossary}}% + {\GlossariesWarning{Glossary `#1' doesn't exist}}% + }% +} +\newcommand*{\@printgloss@checkexists@allowignored}[2]{% + \s@ifglossaryexists{#1}% + {#2}% + {\GlossariesWarning{Glossary `#1' doesn't exist}}% +} +\let\@printgloss@checkexists\@printgloss@checkexists@noignored +\newcommand*{\printglossary}[1][type=\glsdefaulttype]{% + \let\@printgloss@checkexists\@printgloss@checkexists@noignored + \@printglossary{#1}{\@print@glossary}% +} +\newcommand*{\printglossaries}{% + \forallglossaries{\@@glo@type}{\printglossary[type=\@@glo@type]}% +} +\newcommand*{\printnoidxglossary}[1][type=\glsdefaulttype]{% + \let\@printgloss@checkexists\@printgloss@checkexists@noignored + \@printglossary{#1}{\@print@noidx@glossary}% +} +\newcommand*{\printnoidxglossaries}{% + \forallglossaries{\@@glo@type}{\printnoidxglossary[type=\@@glo@type]}% +} +\newcommand*{\@printgloss@setsort}{} +\newcommand*{\@gls@preglossaryhook}{} +\newcommand{\@printglossary}[2]{% + \def\@glo@type{\glsdefaulttype}% + \def\glossarytitle{\csname @glotype@\@glo@type @title\endcsname}% + \def\glossarytoctitle{\glossarytitle}% + \let\org@glossarytitle\glossarytitle + \def\@glossarystyle{% + \ifx\@glossary@default@style\relax + \GlossariesWarning{No default glossary style provided \MessageBreak + for the glossary `\@glo@type'. \MessageBreak + Using deprecated fallback. \MessageBreak + To fix this set the style with \MessageBreak + \string\setglossarystyle\space or use the \MessageBreak + style key=value option}% + \fi + }% + \def\gls@dotoctitle{\glssettoctitle{\@glo@type}}% + \let\@org@glossaryentrynumbers\glossaryentrynumbers + \bgroup + \@printgloss@setsort + \setkeys{printgloss}{#1}% + \@printgloss@checkexists{\@glo@type}% + {% + \ifx\glossarytitle\org@glossarytitle + \else + \expandafter\let\csname @glotype@\@glo@type @title\endcsname + \glossarytitle + \fi + \let\currentglossary\@glo@type + \let\org@glossaryentrynumbers\glossaryentrynumbers + \let\glsnonextpages\@glsnonextpages + \let\glsnextpages\@glsnextpages + \let\nopostdesc\@nopostdesc + \gls@dotoctitle + \@glossarystyle + \let\gls@org@glossaryentryfield\glossentry + \let\gls@org@glossarysubentryfield\subglossentry + \renewcommand{\glossentry}[1]{% + \xdef\glscurrententrylabel{\glsdetoklabel{##1}}% + \gls@org@glossaryentryfield{##1}% + }% + \renewcommand{\subglossentry}[2]{% + \xdef\glscurrententrylabel{\glsdetoklabel{##2}}% + \gls@org@glossarysubentryfield{##1}{##2}% + }% + \@gls@preglossaryhook + #2% + }% + \egroup + \global\let\glossaryentrynumbers\@org@glossaryentrynumbers + \global\let\warn@noprintglossary\relax +} +\newcommand{\@print@glossary}{% + \makeatletter + \@input@{\jobname.\csname @glotype@\@glo@type @in\endcsname}% + \IfFileExists{\jobname.\csname @glotype@\@glo@type @in\endcsname}% + {}% + {\null}% + \ifglsxindy + \ifcsundef{@xdy@\@glo@type @language}% + {% + \edef\@do@auxoutstuff{% + \noexpand\AtEndDocument{% + \noexpand\immediate\noexpand\write\@auxout{% + \string\providecommand\string\@xdylanguage[2]{}}% + \noexpand\immediate\noexpand\write\@auxout{% + \string\@xdylanguage{\@glo@type}{\@xdy@main@language}}% + }% + }% + }% + {% + \edef\@do@auxoutstuff{% + \noexpand\AtEndDocument{% + \noexpand\immediate\noexpand\write\@auxout{% + \string\providecommand\string\@xdylanguage[2]{}}% + \noexpand\immediate\noexpand\write\@auxout{% + \string\@xdylanguage{\@glo@type}{\csname @xdy@\@glo@type + @language\endcsname}}% + }% + }% + }% + \@do@auxoutstuff + \edef\@do@auxoutstuff{% + \noexpand\AtEndDocument{% + \noexpand\immediate\noexpand\write\@auxout{% + \string\providecommand\string\@gls@codepage[2]{}}% + \noexpand\immediate\noexpand\write\@auxout{% + \string\@gls@codepage{\@glo@type}{\gls@codepage}}% + }% + }% + \@do@auxoutstuff + \fi + \renewcommand*{\@warn@nomakeglossaries}{% + \GlossariesWarningNoLine{\string\makeglossaries\space + hasn't been used,^^Jthe glossaries will not be updated}% + }% +} +\newcommand*{\@glo@sortentries}[2]{% + \glosortentrieswarning + \def\@glo@sortinglist{}% + \def\@glo@sortinghandler{#1}% + \edef\@glo@type{#2}% + \forlistcsloop{\@glo@do@sortentries}{@glsref@#2}% + \csdef{@glsref@#2}{}% + \@for\@this@label:=\@glo@sortinglist\do{% + \xifinlistcs{\@this@label}{@glsref@#2}% + {}% + {% + \listcsxadd{@glsref@#2}{\@this@label}% + }% + \ifcsdef{@glo@sortingchildren@\@this@label}% + {% + \@glo@addchildren{#2}{\@this@label}% + }% + {}% + }% +} +\newcommand*{\@glo@addchildren}[2]{% + \bgroup + \letcs{\@glo@childlist}{@glo@sortingchildren@#2}% + \@for\@this@childlabel:=\@glo@childlist\do + {% + \xifinlistcs{\@this@childlabel}{@glsref@#1}% + {}% + {% + \listcsxadd{@glsref@#1}{\@this@childlabel}% + }% + \ifcsdef{@glo@sortingchildren@\@this@childlabel}% + {% + \@glo@addchildren{#1}{\@this@childlabel}% + }% + {% + }% + }% + \egroup +} +\newcommand*{\@glo@do@sortentries}[1]{% + \ifglshasparent{#1}% + {% + \edef\@glo@parent{\csuse{glo@\glsdetoklabel{#1}@parent}}% + \ifcsundef{@glo@sortingchildren@\@glo@parent}% + {% + \csdef{@glo@sortingchildren@\@glo@parent}{}% + }% + {}% + \expandafter\@glo@sortedinsert + \csname @glo@sortingchildren@\@glo@parent\endcsname{#1}% + \xifinlistcs{\@glo@parent}{@glsref@\@glo@type}% + {% + }% + {% + \expandafter\@glo@do@sortentries\expandafter{\@glo@parent}% + }% + }% + {% + \@glo@sortedinsert{\@glo@sortinglist}{#1}% + }% +} +\newcommand*{\@glo@sortedinsert}[2]{% + \dtl@insertinto{#2}{#1}{\@glo@sortinghandler}% +}% +\newcommand*{\@glo@sorthandler@word}[2]{% + \letcs\@gls@sort@A{glo@\glsdetoklabel{#1}@sort}% + \letcs\@gls@sort@B{glo@\glsdetoklabel{#2}@sort}% + \edef\glo@do@compare{% + \noexpand\dtlwordindexcompare{\noexpand\dtl@sortresult}% + {\expandonce\@gls@sort@B}% + {\expandonce\@gls@sort@A}% + }% + \glo@do@compare +} +\newcommand*{\@glo@sorthandler@letter}[2]{% + \letcs\@gls@sort@A{glo@\glsdetoklabel{#1}@sort}% + \letcs\@gls@sort@B{glo@\glsdetoklabel{#2}@sort}% + \edef\glo@do@compare{% + \noexpand\dtlletterindexcompare{\noexpand\dtl@sortresult}% + {\expandonce\@gls@sort@B}% + {\expandonce\@gls@sort@A}% + }% + \glo@do@compare +} +\newcommand*{\@glo@sorthandler@case}[2]{% + \letcs\@gls@sort@A{glo@\glsdetoklabel{#1}@sort}% + \letcs\@gls@sort@B{glo@\glsdetoklabel{#2}@sort}% + \edef\glo@do@compare{% + \noexpand\dtlcompare{\noexpand\dtl@sortresult}% + {\expandonce\@gls@sort@B}% + {\expandonce\@gls@sort@A}% + }% + \glo@do@compare +} +\newcommand*{\@glo@sorthandler@nocase}[2]{% + \letcs\@gls@sort@A{glo@\glsdetoklabel{#1}@sort}% + \letcs\@gls@sort@B{glo@\glsdetoklabel{#2}@sort}% + \edef\glo@do@compare{% + \noexpand\dtlicompare{\noexpand\dtl@sortresult}% + {\expandonce\@gls@sort@B}% + {\expandonce\@gls@sort@A}% + }% + \glo@do@compare +} +\newcommand*{\@glo@sortmacro@word}[1]{% + \ifdefstring{\@glo@default@sorttype}{standard}% + {% + \@glo@sortentries{\@glo@sorthandler@word}{#1}% + }% + {% + \PackageError{glossaries}{Conflicting sort options:^^J + \string\usepackage[sort=\@glo@default@sorttype]{glossaries}^^J + \string\printnoidxglossary[sort=word]}{}% + }% +} +\newcommand*{\@glo@sortmacro@letter}[1]{% + \ifdefstring{\@glo@default@sorttype}{standard}% + {% + \@glo@sortentries{\@glo@sorthandler@letter}{#1}% + }% + {% + \PackageError{glossaries}{Conflicting sort options:^^J + \string\usepackage[sort=\@glo@default@sorttype]{glossaries}^^J + \string\printnoidxglossary[sort=letter]}{}% + }% +} +\newcommand*{\@glo@sortmacro@standard}[1]{% + \ifdefstring{\@glo@default@sorttype}{standard}% + {% + \ifcsdef{@glo@sorthandler@\glsorder}% + {% + \@glo@sortentries{\csuse{@glo@sorthandler@\glsorder}}{#1}% + }% + {% + \PackageError{glossaries}{Unknown sort handler `\glsorder'}{}% + }% + }% + {% + \PackageError{glossaries}{Conflicting sort options:^^J + \string\usepackage[sort=\@glo@default@sorttype]{glossaries}^^J + \string\printnoidxglossary[sort=standard]}{}% + }% +} +\newcommand*{\@glo@sortmacro@case}[1]{% + \ifdefstring{\@glo@default@sorttype}{standard}% + {% + \@glo@sortentries{\@glo@sorthandler@case}{#1}% + }% + {% + \PackageError{glossaries}{Conflicting sort options:^^J + \string\usepackage[sort=\@glo@default@sorttype]{glossaries}^^J + \string\printnoidxglossary[sort=case]}{}% + }% +} +\newcommand*{\@glo@sortmacro@nocase}[1]{% + \ifdefstring{\@glo@default@sorttype}{standard}% + {% + \@glo@sortentries{\@glo@sorthandler@nocase}{#1}% + }% + {% + \PackageError{glossaries}{Conflicting sort options:^^J + \string\usepackage[sort=\@glo@default@sorttype]{glossaries}^^J + \string\printnoidxglossary[sort=nocase]}{}% + }% +} +\newcommand*{\@glo@sortmacro@def}[1]{% + \def\@glo@sortinglist{}% + \forglsentries[#1]{\@gls@thislabel}% + {% + \xifinlistcs{\@gls@thislabel}{@glsref@#1}% + {% + \listeadd{\@glo@sortinglist}{\@gls@thislabel}% + }% + {% + }% + }% + \cslet{@glsref@#1}{\@glo@sortinglist}% +} +\newcommand*{\@glo@sortmacro@def@do}[1]{% + \ifinlistcs{#1}{@glsref@\@glo@type}% + {}% + {% + \listcsadd{@glsref@\@glo@type}{#1}% + }% + \ifcsdef{@glo@sortingchildren@#1}% + {% + \@glo@addchildren{\@glo@type}{#1}% + }% + {}% +} +\newcommand*{\@glo@sortmacro@use}[1]{} +\newcommand*{\@print@noidx@glossary}{% + \ifcsdef{@glsref@\@glo@type}% + {% + \ifcsdef{@glo@sortmacro@\@glo@sorttype}% + {% + \csuse{@glo@sortmacro@\@glo@sorttype}{\@glo@type}% + }% + {% + \PackageError{glossaries}{Unknown sort handler `\@glo@sorttype'}{}% + }% + \glossarysection[\glossarytoctitle]{\glossarytitle}% + \glossarypreamble + \def\@gls@currentlettergroup{}% + \begin{theglossary}% + \glossaryheader + \glsresetentrylist + \forlistcsloop{\@gls@noidx@do}{@glsref@\@glo@type}% + \end{theglossary}% + \glossarypostamble + }% + {% + \@gls@noref@warn{\@glo@type}% + }% +} +\def\glo@grabfirst#1#2\@nil{% + \def\@gls@firsttok{#1}% + \ifdefempty\@gls@firsttok + {% + \def\@glo@thislettergrp{0}% + }% + {% + \@onelevel@sanitize\@gls@firsttok + \expandafter\@glo@grabfirst\@gls@firsttok{}{}\@nil + }% +} +\def\@glo@grabfirst#1#2\@nil{% + \ifdefempty\@glo@thislettergrp + {% + \def\@glo@thislettergrp{glssymbols}% + }% + {% + \count@=\uccode`#1\relax + \ifnum\count@=0\relax + \def\@glo@thislettergrp{glssymbols}% + \else + \ifdefstring\@glo@sorttype{case}% + {% + \count@=`#1\relax + }% + {% + }% + \edef\@glo@thislettergrp{\the\count@}% + \fi + }% +} +\newcommand{\@gls@noidx@do}[1]{% + \global\letcs{\@gls@loclist}{glo@\glsdetoklabel{#1}@loclist}% + \ifglshasparent{#1}% + {% + \gls@level=\csuse{glo@\glsdetoklabel{#1}@level}\relax + \ifdefvoid{\@gls@loclist} + {% + \subglossentry{\gls@level}{#1}{}% + }% + {% + \subglossentry{\gls@level}{#1}% + {% + \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}% + }% + }% + }% + {% + \letcs{\@gls@sort}{glo@\glsdetoklabel{#1}@sort}% + \expandafter\glo@grabfirst\@gls@sort{}{}\@nil + \ifdefequal{\@glo@thislettergrp}{\@gls@currentlettergroup}% + {}% + {% + \ifdefempty{\@gls@currentlettergroup}{}% + {% + \global\let\@glo@thislettergrp\@glo@thislettergrp + \glsgroupskip + }% + \glsgroupheading{\@glo@thislettergrp}% + }% + \global\let\@gls@currentlettergroup\@glo@thislettergrp + \ifdefvoid{\@gls@loclist} + {% + \glossentry{#1}{}% + }% + {% + \glossentry{#1}% + {% + \glossaryentrynumbers{\glsnoidxloclist{\@gls@loclist}}% + }% + }% + }% +} +\newcommand*{\glsnoidxloclist}[1]{% + \def\@gls@noidxloclist@sep{}% + \def\@gls@noidxloclist@prev{}% + \forlistloop{\glsnoidxloclisthandler}{#1}% +} +\newcommand*{\glsnoidxloclisthandler}[1]{% + \ifdefstring{\@gls@noidxloclist@prev}{#1}% + {% + }% + {% + \@gls@noidxloclist@sep + #1% + \def\@gls@noidxloclist@sep{\delimN}% + \def\@gls@noidxloclist@prev{#1}% + }% +} +\newcommand*{\glsnoidxdisplayloclisthandler}[1]{% + \ifdefstring{\@gls@noidxloclist@prev}{#1}% + {% + }% + {% + \@gls@noidxloclist@sep + \@gls@noidxloclist@prev + \def\@gls@noidxloclist@prev{#1}% + }% +} +\newcommand*\glsnoidxdisplayloc[4]{% + \setentrycounter[#1]{#2}% + \csuse{#3}{#4}% +} +\newcommand*{\@gls@reference}[3]{% + \glsdoifexistsorwarn{#2}% + {% + \ifcsundef{@glsref@#1}{\csgdef{@glsref@#1}{}}{}% + \ifinlistcs{#2}{@glsref@#1}% + {}% + {\listcsgadd{@glsref@#1}{#2}}% + \ifcsundef{glo@\glsdetoklabel{#2}@loclist}% + {\csgdef{glo@\glsdetoklabel{#2}@loclist}{}}% + {}% + \listcsgadd{glo@\glsdetoklabel{#2}@loclist}{#3}% + }% +} +\define@key{printgloss}{type}{\def\@glo@type{#1}} +\define@key{printgloss}{title}{% + \def\glossarytitle{#1}% + \let\gls@dotoctitle\relax +} +\define@key{printgloss}{toctitle}{% + \def\glossarytoctitle{#1}% + \let\gls@dotoctitle\relax +} +\define@key{printgloss}{style}{% + \ifcsundef{@glsstyle@#1}% + {% + \PackageError{glossaries}% + {Glossary style `#1' undefined}{}% + }% + {% + \def\@glossarystyle{\setglossentrycompatibility + \csname @glsstyle@#1\endcsname}% + }% +} +\define@choicekey{printgloss}{numberedsection}% + [\gls@numberedsection@val\gls@numberedsection@nr]% + {false,nolabel,autolabel,nameref}[nolabel]% +{% + \ifcase\gls@numberedsection@nr\relax + \renewcommand*{\@@glossarysecstar}{*}% + \renewcommand*{\@@glossaryseclabel}{}% + \or + \renewcommand*{\@@glossarysecstar}{}% + \renewcommand*{\@@glossaryseclabel}{}% + \or + \renewcommand*{\@@glossarysecstar}{}% + \renewcommand*{\@@glossaryseclabel}{\label{\glsautoprefix\@glo@type}}% + \or + \renewcommand*{\@@glossarysecstar}{*}% + \renewcommand*{\@@glossaryseclabel}{% + \protected@edef\@currentlabelname{\glossarytoctitle}% + \label{\glsautoprefix\@glo@type}}% + \fi +} +\define@choicekey{printgloss}{nogroupskip}{true,false}[true]{% + \csuse{glsnogroupskip#1}% +} +\define@choicekey{printgloss}{nopostdot}{true,false}[true]{% + \csuse{glsnopostdot#1}% +} +\newcommand*{\GlsEntryCounterLabelPrefix}{glsentry-} +\define@choicekey{printgloss}{entrycounter}{true,false}[true]{% + \csuse{glsentrycounter#1}% + \@gls@define@glossaryentrycounter +} +\define@choicekey{printgloss}{subentrycounter}{true,false}[true]{% + \csuse{glssubentrycounter#1}% + \@gls@define@glossarysubentrycounter +} +\define@boolkey{printgloss}[gls]{nonumberlist}[true]{% +\ifglsnonumberlist + \def\glossaryentrynumbers##1{}% +\else + \def\glossaryentrynumbers##1{##1}% +\fi} +\define@key{printgloss}{sort}{\@glo@assign@sortkey{#1}} +\newcommand*{\@glo@no@assign@sortkey}[1]{% + \PackageError{glossaries}{`sort' key not permitted with + \string\printglossary}% + {The `sort' key may only be used with \string\printnoidxglossary}% +} +\newcommand*{\@@glo@assign@sortkey}[1]{% + \def\@glo@sorttype{#1}% +} +\newcommand*{\@glsnonextpages}{% + \gdef\glossaryentrynumbers##1{% + \glsresetentrylist + }% +} +\newcommand*{\@glsnextpages}{% + \gdef\glossaryentrynumbers##1{% + ##1\glsresetentrylist}} +\newcommand*{\glsresetentrylist}{% + \global\let\glossaryentrynumbers\org@glossaryentrynumbers} +\newcommand*{\glsnonextpages}{} +\newcommand*{\glsnextpages}{} +\@gls@define@glossaryentrycounter +\@gls@define@glossarysubentrycounter +\newcommand*{\glsresetsubentrycounter}{% + \ifglssubentrycounter + \setcounter{glossarysubentry}{0}% + \fi +} +\newcommand*{\glsresetentrycounter}{% + \ifglsentrycounter + \setcounter{glossaryentry}{0}% + \fi +} +\newcommand*{\glsstepentry}[1]{% + \ifglsentrycounter + \refstepcounter{glossaryentry}% + \label{\GlsEntryCounterLabelPrefix\glsdetoklabel{#1}}% + \fi +} +\newcommand*{\glsstepsubentry}[1]{% + \ifglssubentrycounter + \edef\currentglssubentry{\glsdetoklabel{#1}}% + \refstepcounter{glossarysubentry}% + \label{\GlsEntryCounterLabelPrefix\currentglssubentry}% + \fi +} +\newcommand*{\glsrefentry}[1]{% + \ifglsentrycounter + \ref{\GlsEntryCounterLabelPrefix\glsdetoklabel{#1}}% + \else + \ifglssubentrycounter + \ref{\GlsEntryCounterLabelPrefix\glsdetoklabel{#1}}% + \else + \gls{#1}% + \fi + \fi +} +\newcommand*{\glsentrycounterlabel}{% + \ifglsentrycounter + \theglossaryentry.\space + \fi +} +\newcommand*{\glssubentrycounterlabel}{% + \ifglssubentrycounter + \theglossarysubentry)\space + \fi +} +\newcommand*{\glsentryitem}[1]{% + \ifglsentrycounter + \glsstepentry{#1}\glsentrycounterlabel + \else + \glsresetsubentrycounter + \fi +} +\newcommand*{\glssubentryitem}[1]{% + \ifglssubentrycounter + \glsstepsubentry{#1}\glssubentrycounterlabel + \fi +} +\ifcsundef{theglossary}% +{% + \newenvironment{theglossary}{}{}% +}% +{% + \@gls@warnontheglossdefined + \renewenvironment{theglossary}{}{}% +} +\newcommand*{\glossaryheader}{} +\newcommand*{\glstarget}[2]{\@glstarget{\glolinkprefix#1}{#2}} +\providecommand*{\compatibleglossentry}[2]{% + \toks@{#2}% + \protected@edef\@do@glossentry{\noexpand\glossaryentryfield{#1}% + {\noexpand\glsnamefont + {\expandafter\expandonce\csname glo@#1@name\endcsname}}% + {\expandafter\expandonce\csname glo@#1@desc\endcsname}% + {\expandafter\expandonce\csname glo@#1@symbol\endcsname}% + {\the\toks@}% + }% + \@do@glossentry +} +\newcommand*{\glossentryname}[1]{% + \glsdoifexistsorwarn{#1}% + {% + \letcs{\glo@name}{glo@\glsdetoklabel{#1}@name}% + \expandafter\glsnamefont\expandafter{\glo@name}% + }% +} +\newcommand*{\Glossentryname}[1]{% + \glsdoifexistsorwarn{#1}% + {% + \glsnamefont{\Glsentryname{#1}}% + }% +} +\newcommand*{\glossentrydesc}[1]{% + \glsdoifexistsorwarn{#1}% + {% + \glsentrydesc{#1}% + }% +} +\newcommand*{\Glossentrydesc}[1]{% + \glsdoifexistsorwarn{#1}% + {% + \Glsentrydesc{#1}% + }% +} +\newcommand*{\glossentrysymbol}[1]{% + \glsdoifexistsorwarn{#1}% + {% + \glsentrysymbol{#1}% + }% +} +\newcommand*{\Glossentrysymbol}[1]{% + \glsdoifexistsorwarn{#1}% + {% + \Glsentrysymbol{#1}% + }% +} +\providecommand*{\compatiblesubglossentry}[3]{% + \toks@{#3}% + \protected@edef\@do@subglossentry{\noexpand\glossarysubentryfield{\number#1}% + {#2}% + {\noexpand\glsnamefont + {\expandafter\expandonce\csname glo@#2@name\endcsname}}% + {\expandafter\expandonce\csname glo@#2@desc\endcsname}% + {\expandafter\expandonce\csname glo@#2@symbol\endcsname}% + {\the\toks@}% + }% + \@do@subglossentry +} +\newcommand*{\setglossentrycompatibility}{% + \let\glossentry\compatibleglossentry + \let\subglossentry\compatiblesubglossentry +} +\setglossentrycompatibility +\newcommand{\glossaryentryfield}[5]{% + \GlossariesWarning + {Deprecated use of \string\glossaryentryfield.^^J + I recommend you change to \string\glossentry.^^J + If you've just upgraded, try removing your gls auxiliary + files^^J and recompile}% + \noindent\textbf{\glstarget{#1}{#2}} #4 #3. #5\par} +\newcommand*{\glossarysubentryfield}[6]{% + \GlossariesWarning + {Deprecated use of \string\glossarysubentryfield.^^J + I recommend you change to \string\subglossentry.^^J + If you've just upgraded, try removing your gls auxiliary + files^^J and recompile}% + \glstarget{#2}{\strut}#4. #6\par} +\newcommand*{\glsgroupskip}{} +\newcommand*{\glsgroupheading}[1]{} +\newcommand*{\glsgetgrouptitle}[1]{% + \@gls@getgrouptitle{#1}{\@gls@grptitle}% + \@gls@grptitle +} +\newcommand*{\@gls@getgrouptitle}[2]{% + \dtl@ifsingle{#1}% + {% + \ifcsundef{#1groupname}{\def#2{#1}}{\letcs#2{#1groupname}}% + }% + {% + \ifboolexpr{test{\ifstrequal{#1}{glssymbols}} + or test{\ifstrequal{#1}{glsnumbers}}}% + {% + \ifcsundef{#1groupname}{\def#2{#1}}{\letcs#2{#1groupname}}% + }% + {% + \def#2{#1}% + }% + }% +} +\newcommand*{\@gls@noidx@getgrouptitle}[2]{% + \DTLifint{#1}% + {\edef#2{\char#1\relax}}% + {% + \ifcsundef{#1groupname}{\def#2{#1}}{\letcs#2{#1groupname}}% + }% +} +\newcommand*{\glsgetgrouplabel}[1]{% +\ifthenelse{\equal{#1}{\glssymbolsgroupname}}{glssymbols}{% +\ifthenelse{\equal{#1}{\glsnumbersgroupname}}{glsnumbers}{#1}}} +\newcommand*{\setentrycounter}[2][]{% + \def\@glo@counterprefix{#1}% + \ifx\@glo@counterprefix\@empty + \def\@glo@counterprefix{.}% + \else + \def\@glo@counterprefix{.#1.}% + \fi + \def\glsentrycounter{#2}% +} +\newcommand*{\setglossarystyle}[1]{% + \ifcsundef{@glsstyle@#1}% + {% + \PackageError{glossaries}{Glossary style `#1' undefined}{}% + }% + {% + \csname @glsstyle@#1\endcsname + }% + \ifx\@glossary@default@style\relax + \protected@edef\@glossary@default@style{#1}% + \fi +} +\newcommand*{\glossarystyle}[1]{% + \ifcsundef{@glsstyle@#1}% + {% + \PackageError{glossaries}{Glossary style `#1' undefined}{}% + }% + {% + \GlossariesWarning + {Deprecated command \string\glossarystyle.^^J + I recommend you switch to \string\setglossarystyle\space unless + you want to maintain backward compatibility}% + \setglossentrycompatibility + \csname @glsstyle@#1\endcsname + \ifcsdef{@glscompstyle@#1}% + {\setglossentrycompatibility\csuse{@glscompstyle@#1}}% + {}% + }% + \ifx\@glossary@default@style\relax + \protected@edef\@glossary@default@style{#1}% + \fi +} +\newcommand{\newglossarystyle}[2]{% + \ifcsundef{@glsstyle@#1}% + {% + \expandafter\def\csname @glsstyle@#1\endcsname{#2}% + }% + {% + \PackageError{glossaries}{Glossary style `#1' is already defined}{}% + }% +} +\newcommand{\renewglossarystyle}[2]{% + \ifcsundef{@glsstyle@#1}% + {% + \PackageError{glossaries}{Glossary style `#1' isn't already defined}{}% + }% + {% + \csdef{@glsstyle@#1}{#2}% + }% +} +\newcommand*{\glsnamefont}[1]{#1} +\ifcsundef{hyperlink}% +{% + \def\glshypernumber#1{#1}% +}% +{% + \def\glshypernumber#1{\@glshypernumber#1\nohyperpage{}\@nil} +} +\def\@glshypernumber#1\nohyperpage#2#3\@nil{% + \ifx\\#1\\% + \else + \@delimR#1\delimR\delimR\\% + \fi + \ifx\\#2\\% + \else + #2% + \fi + \ifx\\#3\\% + \else + \@glshypernumber#3\@nil + \fi +} +\def\@delimR#1\delimR #2\delimR #3\\{% +\ifx\\#2\\% + \@delimN{#1}% +\else + \@gls@numberlink{#1}\delimR\@gls@numberlink{#2}% +\fi} +\def\@delimN#1{\@@delimN#1\delimN \delimN\\} +\def\@@delimN#1\delimN #2\delimN#3\\{% +\ifx\\#3\\% + \@gls@numberlink{#1}% +\else + \@gls@numberlink{#1}\delimN\@gls@numberlink{#2}% +\fi +} +\def\@gls@numberlink#1{% +\begingroup + \toks@={}% + \@gls@removespaces#1 \@nil +\endgroup} +\def\@gls@removespaces#1 #2\@nil{% + \toks@=\expandafter{\the\toks@#1}% + \ifx\\#2\\% + \edef\x{\the\toks@}% + \ifx\x\empty + \else + \hyperlink{\glsentrycounter\@glo@counterprefix\the\toks@}% + {\the\toks@}% + \fi + \else + \@gls@ReturnAfterFi{% + \@gls@removespaces#2\@nil + }% + \fi +} +\long\def\@gls@ReturnAfterFi#1\fi{\fi#1} +\newcommand*{\hyperrm}[1]{\textrm{\glshypernumber{#1}}} +\newcommand*{\hypersf}[1]{\textsf{\glshypernumber{#1}}} +\newcommand*{\hypertt}[1]{\texttt{\glshypernumber{#1}}} +\newcommand*{\hyperbf}[1]{\textbf{\glshypernumber{#1}}} +\newcommand*{\hypermd}[1]{\textmd{\glshypernumber{#1}}} +\newcommand*{\hyperit}[1]{\textit{\glshypernumber{#1}}} +\newcommand*{\hypersl}[1]{\textsl{\glshypernumber{#1}}} +\newcommand*{\hyperup}[1]{\textup{\glshypernumber{#1}}} +\newcommand*{\hypersc}[1]{\textsc{\glshypernumber{#1}}} +\newcommand*{\hyperemph}[1]{\emph{\glshypernumber{#1}}} +\newcommand{\oldacronym}[4][\gls@label]{% + \def\gls@label{#2}% + \newacronym[#4]{#1}{#2}{#3}% + \ifcsundef{xspace}% + {% + \expandafter\edef\csname#1\endcsname{% + \noexpand\@ifstar{\noexpand\Gls{#1}}{\noexpand\gls{#1}}% + }% + }% + {% + \expandafter\edef\csname#1\endcsname{% + \noexpand\@ifstar{\noexpand\Gls{#1}\noexpand\xspace}{% + \noexpand\gls{#1}\noexpand\xspace}% + }% + }% +} + \newcommand{\newacronym}[4][]{} +\newcommand*{\acrpluralsuffix}{\glsacrpluralsuffix} +\newrobustcmd*{\glstextup}[1]{\ifdef\textulc{\textulc{#1}}{\textup{#1}}} +\newcommand*{\glsshortkey}{short} +\newcommand*{\glsshortpluralkey}{shortplural} +\newcommand*{\glslongkey}{long} +\newcommand*{\glslongpluralkey}{longplural} +\newrobustcmd*{\acrfull}{\@gls@hyp@opt\ns@acrfull} +\newcommand*\ns@acrfull[2][]{% + \new@ifnextchar[{\@acrfull{#1}{#2}}% + {\@acrfull{#1}{#2}[]}% +} +\def\@acrfull#1#2[#3]{% + \acrfullfmt{#1}{#2}{#3}% +} +\newcommand*{\acrfullfmt}[3]{% + \acrlinkfullformat{\@acrlong}{\@acrshort}{#1}{#2}{#3}% +} +\newcommand{\acrlinkfullformat}[5]{% + \acrfullformat{#1{#3}{#4}[#5]}{#2{#3}{#4}[]}% +} +\newcommand{\acrfullformat}[2]{#1\glsspace(#2)} +\newrobustcmd{\glsspace}{\space} +\newrobustcmd*{\Acrfull}{\@gls@hyp@opt\ns@Acrfull} +\newcommand*\ns@Acrfull[2][]{% + \new@ifnextchar[{\@Acrfull{#1}{#2}}% + {\@Acrfull{#1}{#2}[]}% +} +\def\@Acrfull#1#2[#3]{% + \Acrfullfmt{#1}{#2}{#3}% +} +\newcommand*{\Acrfullfmt}[3]{% + \acrlinkfullformat{\@Acrlong}{\@acrshort}{#1}{#2}{#3}% +} +\newrobustcmd*{\ACRfull}{\@gls@hyp@opt\ns@ACRfull} +\newcommand*\ns@ACRfull[2][]{% + \new@ifnextchar[{\@ACRfull{#1}{#2}}% + {\@ACRfull{#1}{#2}[]}% +} +\def\@ACRfull#1#2[#3]{% + \ACRfullfmt{#1}{#2}{#3}% +} +\newcommand*{\ACRfullfmt}[3]{% + \acrlinkfullformat{\@ACRlong}{\@ACRshort}{#1}{#2}{#3}% +} +\newrobustcmd*{\acrfullpl}{\@gls@hyp@opt\ns@acrfullpl} +\newcommand*\ns@acrfullpl[2][]{% + \new@ifnextchar[{\@acrfullpl{#1}{#2}}% + {\@acrfullpl{#1}{#2}[]}% +} +\def\@acrfullpl#1#2[#3]{% + \acrfullplfmt{#1}{#2}{#3}% +} +\newcommand*{\acrfullplfmt}[3]{% + \acrlinkfullformat{\@acrlongpl}{\@acrshortpl}{#1}{#2}{#3}% +} +\newrobustcmd*{\Acrfullpl}{\@gls@hyp@opt\ns@Acrfullpl} +\newcommand*\ns@Acrfullpl[2][]{% + \new@ifnextchar[{\@Acrfullpl{#1}{#2}}% + {\@Acrfullpl{#1}{#2}[]}% +} +\def\@Acrfullpl#1#2[#3]{% + \Acrfullplfmt{#1}{#2}{#3}% +} +\newcommand*{\Acrfullplfmt}[3]{% + \acrlinkfullformat{\@Acrlongpl}{\@acrshortpl}{#1}{#2}{#3}% +} +\newrobustcmd*{\ACRfullpl}{\@gls@hyp@opt\ns@ACRfullpl} +\newcommand*\ns@ACRfullpl[2][]{% + \new@ifnextchar[{\@ACRfullpl{#1}{#2}}% + {\@ACRfullpl{#1}{#2}[]}% +} +\def\@ACRfullpl#1#2[#3]{% + \ACRfullplfmt{#1}{#2}{#3}% +} +\newcommand*{\ACRfullplfmt}[3]{% + \acrlinkfullformat{\@ACRlongpl}{\@ACRshortpl}{#1}{#2}{#3}% +} +\newcommand{\acronymfont}[1]{#1} +\newcommand{\firstacronymfont}[1]{\acronymfont{#1}} +\newcommand*{\acrnameformat}[2]{\acronymfont{#1}} +\newtoks\glskeylisttok +\newtoks\glslabeltok +\newtoks\glsshorttok +\newtoks\glslongtok +\newcommand*{\newacronymhook}{} +\newcommand*{\SetGenericNewAcronym}{% + \let\@Gls@entryname\@Gls@acrentryname + \renewcommand{\newacronym}[4][]{% + \ifdefempty{\@glsacronymlists}% + {% + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + }% + {}% + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \protected@edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\expandonce{\acronymentry{##2}}},% + sort={\acronymsort{\the\glsshorttok}{\the\glslongtok}},% + text={\the\glsshorttok},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + \GenericAcronymFields,% + \the\glskeylisttok + }% + }% + \@do@newglossaryentry + }% + \renewcommand*{\acrfullfmt}[3]{% + \glslink[##1]{##2}{\genacrfullformat{##2}{##3}}}% + \renewcommand*{\Acrfullfmt}[3]{% + \glslink[##1]{##2}{\Genacrfullformat{##2}{##3}}}% + \renewcommand*{\ACRfullfmt}[3]{% + \glslink[##1]{##2}{% + \mfirstucMakeUppercase{\genacrfullformat{##2}{##3}}}}% + \renewcommand*{\acrfullplfmt}[3]{% + \glslink[##1]{##2}{\genplacrfullformat{##2}{##3}}}% + \renewcommand*{\Acrfullplfmt}[3]{% + \glslink[##1]{##2}{\Genplacrfullformat{##2}{##3}}}% + \renewcommand*{\ACRfullplfmt}[3]{% + \glslink[##1]{##2}{% + \mfirstucMakeUppercase{\genplacrfullformat{##2}{##3}}}}% + \renewcommand*{\glsentryfull}[1]{\genacrfullformat{##1}{}}% + \renewcommand*{\Glsentryfull}[1]{\Genacrfullformat{##1}{}}% + \renewcommand*{\glsentryfullpl}[1]{\genplacrfullformat{##1}{}}% + \renewcommand*{\Glsentryfullpl}[1]{\Genplacrfullformat{##1}{}}% +} +\newcommand*{\GenericAcronymFields}{description={\the\glslongtok}} +\newcommand*{\acronymentry}[1]{\acronymfont{\glsentryshort{#1}}} +\newcommand*{\acronymsort}[2]{#1} +\newcommand*{\setacronymstyle}[1]{% + \ifcsundef{@glsacr@dispstyle@#1} + {% + \PackageError{glossaries}{Undefined acronym style `#1'}{}% + }% + {% + \ifdefempty{\@glsacronymlists}% + {% + \DeclareAcronymList{\acronymtype}% + }% + {}% + \SetGenericNewAcronym + \GlsUseAcrStyleDefs{#1}% + \@for\@gls@type:=\@glsacronymlists\do{% + \defglsentryfmt[\@gls@type]{\GlsUseAcrEntryDispStyle{#1}}% + }% + }% +} +\newcommand*{\newacronymstyle}[3]{% + \ifcsdef{@glsacr@dispstyle@#1}% + {% + \PackageError{glossaries}{Acronym style `#1' already exists}{}% + }% + {% + \csdef{@glsacr@dispstyle@#1}{#2}% + \csdef{@glsacr@styledefs@#1}{#3}% + }% +} +\newcommand*{\renewacronymstyle}[3]{% + \ifcsdef{@glsacr@dispstyle@#1}% + {% + \csdef{@glsacr@dispstyle@#1}{#2}% + \csdef{@glsacr@styledefs@#1}{#3}% + }% + {% + \PackageError{glossaries}{Acronym style `#1' doesn't exist}{}% + }% +} +\newcommand*{\GlsUseAcrEntryDispStyle}[1]{\csuse{@glsacr@dispstyle@#1}} +\newcommand*{\GlsUseAcrStyleDefs}[1]{\csuse{@glsacr@styledefs@#1}} +\newacronymstyle{long-short}% +{% + \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% +}% +{% + \renewcommand*{\GenericAcronymFields}{description={\the\glslongtok}}% + \renewcommand*{\genacrfullformat}[2]{% + \glsentrylong{##1}##2\space + (\protect\firstacronymfont{\glsentryshort{##1}})% + }% + \renewcommand*{\Genacrfullformat}[2]{% + \Glsentrylong{##1}##2\space + (\protect\firstacronymfont{\glsentryshort{##1}})% + }% + \renewcommand*{\genplacrfullformat}[2]{% + \glsentrylongpl{##1}##2\space + (\protect\firstacronymfont{\glsentryshortpl{##1}})% + }% + \renewcommand*{\Genplacrfullformat}[2]{% + \Glsentrylongpl{##1}##2\space + (\protect\firstacronymfont{\glsentryshortpl{##1}})% + }% + \renewcommand*{\acronymentry}[1]{\acronymfont{\glsentryshort{##1}}}% + \renewcommand*{\acronymsort}[2]{##1}% + \renewcommand*{\acronymfont}[1]{##1}% + \renewcommand*{\firstacronymfont}[1]{\acronymfont{##1}}% + \renewcommand*{\acrpluralsuffix}{\glspluralsuffix}% +} +\newacronymstyle{long-sp-short}% +{% + \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% +}% +{% + \renewcommand*{\GenericAcronymFields}{description={\the\glslongtok}}% + \renewcommand*{\genacrfullformat}[2]{% + \glsentrylong{##1}##2\glsacspace{##1}% + (\protect\firstacronymfont{\glsentryshort{##1}})% + }% + \renewcommand*{\Genacrfullformat}[2]{% + \Glsentrylong{##1}##2\glsacspace{##1}% + (\protect\firstacronymfont{\glsentryshort{##1}})% + }% + \renewcommand*{\genplacrfullformat}[2]{% + \glsentrylongpl{##1}##2\glsacspace{##1}% + (\protect\firstacronymfont{\glsentryshortpl{##1}})% + }% + \renewcommand*{\Genplacrfullformat}[2]{% + \Glsentrylongpl{##1}##2\glsacspace{##1}% + (\protect\firstacronymfont{\glsentryshortpl{##1}})% + }% + \renewcommand*{\acronymentry}[1]{\acronymfont{\glsentryshort{##1}}}% + \renewcommand*{\acronymsort}[2]{##1}% + \renewcommand*{\acronymfont}[1]{##1}% + \renewcommand*{\firstacronymfont}[1]{\acronymfont{##1}}% + \renewcommand*{\acrpluralsuffix}{\glspluralsuffix}% +} +\newcommand*{\glsacspace}[1]{% + \settowidth{\dimen@}{(\firstacronymfont{\glsentryshort{#1}})}% + \ifdim\dimen@<3em~\else\space\fi +} +\newacronymstyle{short-long}% +{% + \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% +}% +{% + \renewcommand*{\GenericAcronymFields}{description={\the\glslongtok}}% + \renewcommand*{\genacrfullformat}[2]{% + \protect\firstacronymfont{\glsentryshort{##1}}##2\space + (\glsentrylong{##1})% + }% + \renewcommand*{\Genacrfullformat}[2]{% + \protect\firstacronymfont{\Glsentryshort{##1}}##2\space + (\glsentrylong{##1})% + }% + \renewcommand*{\genplacrfullformat}[2]{% + \protect\firstacronymfont{\glsentryshortpl{##1}}##2\space + (\glsentrylongpl{##1})% + }% + \renewcommand*{\Genplacrfullformat}[2]{% + \protect\firstacronymfont{\Glsentryshortpl{##1}}##2\space + (\glsentrylongpl{##1})% + }% + \renewcommand*{\acronymentry}[1]{\acronymfont{\glsentryshort{##1}}}% + \renewcommand*{\acronymsort}[2]{##1}% + \renewcommand*{\acronymfont}[1]{##1}% + \renewcommand*{\firstacronymfont}[1]{\acronymfont{##1}}% + \renewcommand*{\acrpluralsuffix}{\glspluralsuffix}% +} +\newacronymstyle{long-sc-short}% +{% + \GlsUseAcrEntryDispStyle{long-short}% +}% +{% + \GlsUseAcrStyleDefs{long-short}% + \renewcommand{\acronymfont}[1]{\textsc{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsupacrpluralsuffix}% +} +\newacronymstyle{long-sm-short}% +{% + \GlsUseAcrEntryDispStyle{long-short}% +}% +{% + \GlsUseAcrStyleDefs{long-short}% + \renewcommand{\acronymfont}[1]{\textsmaller{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsacrpluralsuffix}% +} +\newacronymstyle{sc-short-long}% +{% + \GlsUseAcrEntryDispStyle{short-long}% +}% +{% + \GlsUseAcrStyleDefs{short-long}% + \renewcommand{\acronymfont}[1]{\textsc{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsupacrpluralsuffix}% +} +\newacronymstyle{sm-short-long}% +{% + \GlsUseAcrEntryDispStyle{short-long}% +}% +{% + \GlsUseAcrStyleDefs{short-long}% + \renewcommand{\acronymfont}[1]{\textsmaller{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsacrpluralsuffix}% +} +\newacronymstyle{long-short-desc}% +{% + \GlsUseAcrEntryDispStyle{long-short}% +}% +{% + \GlsUseAcrStyleDefs{long-short}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{long-sp-short-desc}% +{% + \GlsUseAcrEntryDispStyle{long-sp-short}% +}% +{% + \GlsUseAcrStyleDefs{long-sp-short}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\glsacspace{##1}(\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{long-sc-short-desc}% +{% + \GlsUseAcrEntryDispStyle{long-sc-short}% +}% +{% + \GlsUseAcrStyleDefs{long-sc-short}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{long-sm-short-desc}% +{% + \GlsUseAcrEntryDispStyle{long-sm-short}% +}% +{% + \GlsUseAcrStyleDefs{long-sm-short}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{short-long-desc}% +{% + \GlsUseAcrEntryDispStyle{short-long}% +}% +{% + \GlsUseAcrStyleDefs{short-long}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{sc-short-long-desc}% +{% + \GlsUseAcrEntryDispStyle{sc-short-long}% +}% +{% + \GlsUseAcrStyleDefs{sc-short-long}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{sm-short-long-desc}% +{% + \GlsUseAcrEntryDispStyle{sm-short-long}% +}% +{% + \GlsUseAcrStyleDefs{sm-short-long}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{dua}% +{% + \ifdefempty\glscustomtext + {% + \ifglshaslong{\glslabel}% + {% + \glsifplural + {% + \glscapscase + {% + \glsentrylongpl{\glslabel}\glsinsert + }% + {% + \Glsentrylongpl{\glslabel}\glsinsert + }% + {% + \mfirstucMakeUppercase + {\glsentrylongpl{\glslabel}\glsinsert}% + }% + }% + {% + \glscapscase + {% + \glsentrylong{\glslabel}\glsinsert + }% + {% + \Glsentrylong{\glslabel}\glsinsert + }% + {% + \mfirstucMakeUppercase + {\glsentrylong{\glslabel}\glsinsert}% + }% + }% + }% + {% + \glsgenentryfmt + }% + }% + {\glscustomtext\glsinsert}% +}% +{% + \renewcommand*{\GenericAcronymFields}{description={\the\glslongtok}}% + \renewcommand*{\acrfullfmt}[3]{% + \glslink[##1]{##2}{\glsentrylong{##2}##3\space + (\acronymfont{\glsentryshort{##2}})}}% + \renewcommand*{\Acrfullfmt}[3]{% + \glslink[##1]{##2}{\Glsentrylong{##2}##3\space + (\acronymfont{\glsentryshort{##2}})}}% + \renewcommand*{\ACRfullfmt}[3]{% + \glslink[##1]{##2}{% + \mfirstucMakeUppercase{\glsentrylong{##2}##3\space + (\acronymfont{\glsentryshort{##2}})}}}% + \renewcommand*{\acrfullplfmt}[3]{% + \glslink[##1]{##2}{\glsentrylongpl{##2}##3\space + (\acronymfont{\glsentryshortpl{##2}})}}% + \renewcommand*{\Acrfullplfmt}[3]{% + \glslink[##1]{##2}{\Glsentrylongpl{##2}##3\space + (\acronymfont{\glsentryshortpl{##2}})}}% + \renewcommand*{\ACRfullplfmt}[3]{% + \glslink[##1]{##2}{% + \mfirstucMakeUppercase{\glsentrylongpl{##2}##3\space + (\acronymfont{\glsentryshortpl{##2}})}}}% + \renewcommand*{\glsentryfull}[1]{% + \glsentrylong{##1}\space(\acronymfont{\glsentryshort{##1}})% + }% + \renewcommand*{\Glsentryfull}[1]{% + \Glsentrylong{##1}\space(\acronymfont{\glsentryshort{##1}})% + }% + \renewcommand*{\glsentryfullpl}[1]{% + \glsentrylongpl{##1}\space(\acronymfont{\glsentryshortpl{##1}})% + }% + \renewcommand*{\Glsentryfullpl}[1]{% + \Glsentrylongpl{##1}\space(\acronymfont{\glsentryshortpl{##1}})% + }% + \renewcommand*{\acronymentry}[1]{\acronymfont{\glsentryshort{##1}}}% + \renewcommand*{\acronymsort}[2]{##1}% + \renewcommand*{\acronymfont}[1]{##1}% + \renewcommand*{\acrpluralsuffix}{\glsacrpluralsuffix}% +} +\newacronymstyle{dua-desc}% +{% + \GlsUseAcrEntryDispStyle{dua}% +}% +{% + \GlsUseAcrStyleDefs{dua}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymentry}[1]{\acronymfont{\glsentrylong{##1}}}% + \renewcommand*{\acronymsort}[2]{##2}% +}% +\newacronymstyle{footnote}% +{% + \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}% +}% +{% + \renewcommand*{\GenericAcronymFields}{description={\the\glslongtok}}% + \glshyperfirstfalse + \renewcommand*{\genacrfullformat}[2]{% + \protect\firstacronymfont{\glsentryshort{##1}}##2% + \protect\footnote{\glsentrylong{##1}}% + }% + \renewcommand*{\Genacrfullformat}[2]{% + \firstacronymfont{\Glsentryshort{##1}}##2% + \protect\footnote{\glsentrylong{##1}}% + }% + \renewcommand*{\genplacrfullformat}[2]{% + \protect\firstacronymfont{\glsentryshortpl{##1}}##2% + \protect\footnote{\glsentrylongpl{##1}}% + }% + \renewcommand*{\Genplacrfullformat}[2]{% + \protect\firstacronymfont{\Glsentryshortpl{##1}}##2% + \protect\footnote{\glsentrylongpl{##1}}% + }% + \renewcommand*{\acronymentry}[1]{\acronymfont{\glsentryshort{##1}}}% + \renewcommand*{\acronymsort}[2]{##1}% + \renewcommand*{\acronymfont}[1]{##1}% + \renewcommand*{\acrpluralsuffix}{\glsacrpluralsuffix}% + \renewcommand*{\acrfullfmt}[3]{% + \glslink[##1]{##2}{\acronymfont{\glsentryshort{##2}}##3\space + (\glsentrylong{##2})}}% + \renewcommand*{\Acrfullfmt}[3]{% + \glslink[##1]{##2}{\acronymfont{\Glsentryshort{##2}}##3\space + (\glsentrylong{##2})}}% + \renewcommand*{\ACRfullfmt}[3]{% + \glslink[##1]{##2}{% + \mfirstucMakeUppercase{\acronymfont{\glsentryshort{##2}}##3\space + (\glsentrylong{##2})}}}% + \renewcommand*{\acrfullplfmt}[3]{% + \glslink[##1]{##2}{\acronymfont{\glsentryshortpl{##2}}##3\space + (\glsentrylongpl{##2})}}% + \renewcommand*{\Acrfullplfmt}[3]{% + \glslink[##1]{##2}{\acronymfont{\Glsentryshortpl{##2}}##3\space + (\glsentrylongpl{##2})}}% + \renewcommand*{\ACRfullplfmt}[3]{% + \glslink[##1]{##2}{% + \mfirstucMakeUppercase{\acronymfont{\glsentryshortpl{##2}}##3\space + (\glsentrylongpl{##2})}}}% + \renewcommand*{\glsentryfull}[1]{% + \acronymfont{\glsentryshort{##1}}\space(\glsentrylong{##1})}% + \renewcommand*{\Glsentryfull}[1]{% + \acronymfont{\Glsentryshort{##1}}\space(\glsentrylong{##1})}% + \renewcommand*{\glsentryfullpl}[1]{% + \acronymfont{\glsentryshortpl{##1}}\space(\glsentrylongpl{##1})}% + \renewcommand*{\Glsentryfullpl}[1]{% + \acronymfont{\Glsentryshortpl{##1}}\space(\glsentrylongpl{##1})}% +} +\newacronymstyle{footnote-sc}% +{% + \GlsUseAcrEntryDispStyle{footnote}% +}% +{% + \GlsUseAcrStyleDefs{footnote}% + \renewcommand{\acronymentry}[1]{\acronymfont{\glsentryshort{##1}}} + \renewcommand{\acronymfont}[1]{\textsc{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsupacrpluralsuffix}% +}% +\newacronymstyle{footnote-sm}% +{% + \GlsUseAcrEntryDispStyle{footnote}% +}% +{% + \GlsUseAcrStyleDefs{footnote}% + \renewcommand{\acronymentry}[1]{\acronymfont{\glsentryshort{##1}}} + \renewcommand{\acronymfont}[1]{\textsmaller{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsacrpluralsuffix}% +}% +\newacronymstyle{footnote-desc}% +{% + \GlsUseAcrEntryDispStyle{footnote}% +}% +{% + \GlsUseAcrStyleDefs{footnote}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{footnote-sc-desc}% +{% + \GlsUseAcrEntryDispStyle{footnote-sc}% +}% +{% + \GlsUseAcrStyleDefs{footnote-sc}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newacronymstyle{footnote-sm-desc}% +{% + \GlsUseAcrEntryDispStyle{footnote-sm}% +}% +{% + \GlsUseAcrStyleDefs{footnote-sm}% + \renewcommand*{\GenericAcronymFields}{}% + \renewcommand*{\acronymsort}[2]{##2}% + \renewcommand*{\acronymentry}[1]{% + \glsentrylong{##1}\space (\acronymfont{\glsentryshort{##1}})}% +} +\newcommand*{\DefineAcronymSynonyms}{% + \let\acs\acrshort + \let\Acs\Acrshort + \let\acsp\acrshortpl + \let\Acsp\Acrshortpl + \let\acl\acrlong + \let\aclp\acrlongpl + \let\Acl\Acrlong + \let\Aclp\Acrlongpl + \let\acf\acrfull + \let\acfp\acrfullpl + \let\Acf\Acrfull + \let\Acfp\Acrfullpl + \let\ac\gls + \let\Ac\Gls + \let\acp\glspl + \let\Acp\Glspl +} +\ifglsacrshortcuts + \DefineAcronymSynonyms +\fi +\newcommand*{\SetDefaultAcronymDisplayStyle}[1]{% + \defglsentryfmt[#1]{\glsgenentryfmt}% +} +\newcommand*{\DefaultNewAcronymDef}{% + \edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\the\glsshorttok},% + sort={\the\glsshorttok},% + text={\the\glsshorttok},% + first={\acrfullformat{\the\glslongtok}{\the\glsshorttok}},% + plural={\noexpand\expandonce\noexpand\@glo@shortpl},% + firstplural={\acrfullformat{\noexpand\expandonce\noexpand\@glo@longpl}% + {\noexpand\expandonce\noexpand\@glo@shortpl}},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + description={\the\glslongtok},% + descriptionplural={\noexpand\expandonce\noexpand\@glo@longpl},% + \the\glskeylisttok + }% + }% + \let\@org@gls@assign@firstpl\gls@assign@firstpl + \let\@org@gls@assign@plural\gls@assign@plural + \let\@org@gls@assign@descplural\gls@assign@descplural + \def\gls@assign@firstpl##1##2{% + \@@gls@expand@field{##1}{firstpl}{##2}% + }% + \def\gls@assign@plural##1##2{% + \@@gls@expand@field{##1}{plural}{##2}% + }% + \def\gls@assign@descplural##1##2{% + \@@gls@expand@field{##1}{descplural}{##2}% + }% + \@do@newglossaryentry + \let\gls@assign@firstpl\@org@gls@assign@firstpl + \let\gls@assign@plural\@org@gls@assign@plural + \let\gls@assign@symbolplural\@org@gls@assign@symbolplural +} +\newcommand*{\SetDefaultAcronymStyle}{% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetDefaultAcronymDisplayStyle{\@gls@type}% + }% + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetDefaultAcronymDisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \DefaultNewAcronymDef + }% + \renewcommand*{\acrpluralsuffix}{\glsacrpluralsuffix}% +} +\newcommand*{\acrfootnote}[3]{\acrlinkfootnote{#1}{#2}{#3}} +\newcommand*{\acrlinkfootnote}[3]{% + \footnote{\glslink[#1]{#2}{#3}}% +} +\newcommand*{\acrnolinkfootnote}[3]{% + \footnote{#3}% +} +\newcommand*{\SetDescriptionFootnoteAcronymDisplayStyle}[1]{% + \defglsentryfmt[#1]{% + \ifdefempty\glscustomtext + {% + \ifglsused{\glslabel}% + {% + \acronymfont{\glsgenentryfmt}% + }% + {% + \firstacronymfont{\glsgenentryfmt}% + \ifglshassymbol{\glslabel}% + {% + \expandafter\protect\expandafter\acrfootnote\expandafter + {\@gls@link@opts}{\@gls@link@label}% + {% + \glsifplural + {\glsentrysymbolplural{\glslabel}}% + {\glsentrysymbol{\glslabel}}% + }% + }% + }% + }% + {\glscustomtext\glsinsert}% + }% +} +\newcommand*{\DescriptionFootnoteNewAcronymDef}{% + \edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\noexpand\acronymfont{\the\glsshorttok}},% + sort={\the\glsshorttok},% + first={\the\glsshorttok},% + firstplural={\noexpand\expandonce\noexpand\@glo@shortpl},% + text={\the\glsshorttok},% + plural={\noexpand\expandonce\noexpand\@glo@shortpl},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + symbol={\the\glslongtok},% + symbolplural={\noexpand\expandonce\noexpand\@glo@longpl},% + \the\glskeylisttok + }% + }% + \let\@org@gls@assign@firstpl\gls@assign@firstpl + \let\@org@gls@assign@plural\gls@assign@plural + \let\@org@gls@assign@symbolplural\gls@assign@symbolplural + \def\gls@assign@firstpl##1##2{% + \@@gls@expand@field{##1}{firstpl}{##2}% + }% + \def\gls@assign@plural##1##2{% + \@@gls@expand@field{##1}{plural}{##2}% + }% + \def\gls@assign@symbolplural##1##2{% + \@@gls@expand@field{##1}{symbolplural}{##2}% + }% + \@do@newglossaryentry + \let\gls@assign@plural\@org@gls@assign@plural + \let\gls@assign@firstpl\@org@gls@assign@firstpl + \let\gls@assign@symbolplural\@org@gls@assign@symbolplural +} +\newcommand*{\SetDescriptionFootnoteAcronymStyle}{% + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetDescriptionFootnoteAcronymDisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \DescriptionFootnoteNewAcronymDef + }% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetDescriptionFootnoteAcronymDisplayStyle{\@gls@type}% + }% + \ifglsacrsmallcaps + \renewcommand*{\acronymfont}[1]{\textsc{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsupacrpluralsuffix}% + \else + \ifglsacrsmaller + \renewcommand*{\acronymfont}[1]{\textsmaller{##1}}% + \fi + \fi + \ifglsacrdua + \PackageError{glossaries}{Option clash: `footnote' and `dua' + can't both be set}{}% + \fi +}% +\newcommand*{\SetDescriptionDUAAcronymDisplayStyle}[1]{% + \defglsentryfmt[#1]{\glsgenentryfmt}% +} +\newcommand*{\DescriptionDUANewAcronymDef}{% + \edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\the\glslongtok},% + sort={\the\glslongtok}, + text={\the\glslongtok},% + first={\the\glslongtok},% + plural={\noexpand\expandonce\noexpand\@glo@longpl},% + firstplural={\noexpand\expandonce\noexpand\@glo@longpl},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + symbol={\the\glsshorttok},% + symbolplural={\noexpand\expandonce\noexpand\@glo@shortpl},% + \the\glskeylisttok + }% + }% + \let\@org@gls@assign@firstpl\gls@assign@firstpl + \let\@org@gls@assign@plural\gls@assign@plural + \let\@org@gls@assign@symbolplural\gls@assign@symbolplural + \def\gls@assign@firstpl##1##2{% + \@@gls@expand@field{##1}{firstpl}{##2}% + }% + \def\gls@assign@plural##1##2{% + \@@gls@expand@field{##1}{plural}{##2}% + }% + \def\gls@assign@symbolplural##1##2{% + \@@gls@expand@field{##1}{symbolplural}{##2}% + }% + \@do@newglossaryentry + \let\gls@assign@firstpl\@org@gls@assign@firstpl + \let\gls@assign@plural\@org@gls@assign@plural + \let\gls@assign@symbolplural\@org@gls@assign@symbolplural +} +\newcommand*{\SetDescriptionDUAAcronymStyle}{% + \ifglsacrsmallcaps + \PackageError{glossaries}{Option clash: `smallcaps' and `dua' + can't both be set}{}% + \else + \ifglsacrsmaller + \PackageError{glossaries}{Option clash: `smaller' and `dua' + can't both be set}{}% + \fi + \fi + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetDescriptionDUAAcronymDisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \DescriptionDUANewAcronymDef + }% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetDescriptionDUAAcronymDisplayStyle{\@gls@type}% + }% +}% +\newcommand*{\SetDescriptionAcronymDisplayStyle}[1]{% + \defglsentryfmt[#1]{% + \ifdefempty\glscustomtext + {% + \ifglsused{\glslabel}% + {% + \let\gls@org@insert\glsinsert + \let\glsinsert\@empty + \acronymfont{\glsgenentryfmt}\gls@org@insert + }% + {% + \glsgenentryfmt + \ifglshassymbol{\glslabel}% + {% + \glsifplural + {% + \def\@glo@symbol{\glsentrysymbolplural{\glslabel}}% + }% + {% + \def\@glo@symbol{\glsentrysymbol{\glslabel}}% + }% + \space(\protect\firstacronymfont + {\glscapscase + {\@glo@symbol} + {\@glo@symbol} + {\mfirstucMakeUppercase{\@glo@symbol}}})% + }% + {}% + }% + }% + {\glscustomtext\glsinsert}% + }% +} +\newcommand*{\DescriptionNewAcronymDef}{% + \edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\noexpand + \acrnameformat{\the\glsshorttok}{\the\glslongtok}},% + sort={\the\glsshorttok},% + first={\the\glslongtok},% + firstplural={\noexpand\expandonce\noexpand\@glo@longpl},% + text={\the\glsshorttok},% + plural={\noexpand\expandonce\noexpand\@glo@shortpl},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + symbol={\noexpand\@glo@text},% + symbolplural={\noexpand\expandonce\noexpand\@glo@shortpl},% + \the\glskeylisttok}% + }% + \let\@org@gls@assign@firstpl\gls@assign@firstpl + \let\@org@gls@assign@plural\gls@assign@plural + \let\@org@gls@assign@symbolplural\gls@assign@symbolplural + \def\gls@assign@firstpl##1##2{% + \@@gls@expand@field{##1}{firstpl}{##2}% + }% + \def\gls@assign@plural##1##2{% + \@@gls@expand@field{##1}{plural}{##2}% + }% + \def\gls@assign@symbolplural##1##2{% + \@@gls@expand@field{##1}{symbolplural}{##2}% + }% + \@do@newglossaryentry + \let\gls@assign@firstpl\@org@gls@assign@firstpl + \let\gls@assign@plural\@org@gls@assign@plural + \let\gls@assign@symbolplural\@org@gls@assign@symbolplural +} +\newcommand*{\SetDescriptionAcronymStyle}{% + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetDescriptionAcronymDisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \DescriptionNewAcronymDef + }% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetDescriptionAcronymDisplayStyle{\@gls@type}% + }% + \ifglsacrsmallcaps + \renewcommand{\acronymfont}[1]{\textsc{##1}} + \renewcommand*{\acrpluralsuffix}{\glsupacrpluralsuffix}% + \else + \ifglsacrsmaller + \renewcommand*{\acronymfont}[1]{\textsmaller{##1}}% + \fi + \fi +}% +\newcommand*{\SetFootnoteAcronymDisplayStyle}[1]{% + \defglsentryfmt[#1]{% + \ifdefempty\glscustomtext + {% + \let\gls@org@insert\glsinsert + \let\glsinsert\@empty + \ifglsused{\glslabel}% + {% + \acronymfont{\glsgenentryfmt}\gls@org@insert + }% + {% + \firstacronymfont{\glsgenentryfmt}\gls@org@insert + \ifglshaslong{\glslabel}% + {% + \expandafter\protect\expandafter\acrfootnote\expandafter + {\@gls@link@opts}{\@gls@link@label}% + {% + \glsifplural + {\glsentrylongpl{\glslabel}}% + {\glsentrylong{\glslabel}}% + }% + }% + {}% + }% + }% + {\glscustomtext\glsinsert}% + }% +} +\newcommand*{\FootnoteNewAcronymDef}{% + \edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\noexpand\acronymfont{\the\glsshorttok}},% + sort={\the\glsshorttok},% + text={\the\glsshorttok},% + plural={\noexpand\expandonce\noexpand\@glo@shortpl},% + first={\the\glsshorttok},% + firstplural={\noexpand\expandonce\noexpand\@glo@shortpl},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + description={\the\glslongtok},% + descriptionplural={\noexpand\expandonce\noexpand\@glo@longpl},% + \the\glskeylisttok + }% + }% + \let\@org@gls@assign@plural\gls@assign@plural + \let\@org@gls@assign@firstpl\gls@assign@firstpl + \let\@org@gls@assign@descplural\gls@assign@descplural + \def\gls@assign@firstpl##1##2{% + \@@gls@expand@field{##1}{firstpl}{##2}% + }% + \def\gls@assign@plural##1##2{% + \@@gls@expand@field{##1}{plural}{##2}% + }% + \def\gls@assign@descplural##1##2{% + \@@gls@expand@field{##1}{descplural}{##2}% + }% + \@do@newglossaryentry + \let\gls@assign@plural\@org@gls@assign@plural + \let\gls@assign@firstpl\@org@gls@assign@firstpl + \let\gls@assign@descplural\@org@gls@assign@descplural +} +\newcommand*{\SetFootnoteAcronymStyle}{% + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetFootnoteAcronymDisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \FootnoteNewAcronymDef + }% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetFootnoteAcronymDisplayStyle{\@gls@type}% + }% + \ifglsacrsmallcaps + \renewcommand*{\acronymfont}[1]{\textsc{##1}}% + \renewcommand*{\acrpluralsuffix}{\glsupacrpluralsuffix}% + \else + \ifglsacrsmaller + \renewcommand*{\acronymfont}[1]{\textsmaller{##1}}% + \fi + \fi + \ifglsacrdua + \PackageError{glossaries}{Option clash: `footnote' and `dua' + can't both be set}{}% + \fi +}% +\DeclareRobustCommand*{\glsdoparenifnotempty}[2]{% + \protected@edef\gls@tmp{#1}% + \ifdefempty\gls@tmp + {}% + {% + \ifx\gls@tmp\@gls@default@value + \else + \space (#2{#1})% + \fi + }% +} +\newcommand*{\SetSmallAcronymDisplayStyle}[1]{% + \defglsentryfmt[#1]{% + \ifdefempty\glscustomtext + {% + \let\gls@org@insert\glsinsert + \let\glsinsert\@empty + \ifglsused{\glslabel}% + {% + \acronymfont{\glsgenentryfmt}\gls@org@insert + }% + {% + \glsgenentryfmt + \ifglshassymbol{\glslabel}% + {% + \glsifplural + {% + \def\@glo@symbol{\glsentrysymbolplural{\glslabel}}% + }% + {% + \def\@glo@symbol{\glsentrysymbol{\glslabel}}% + }% + \space + (\glscapscase + {\firstacronymfont{\@glo@symbol}}% + {\firstacronymfont{\@glo@symbol}}% + {\firstacronymfont{\mfirstucMakeUppercase{\@glo@symbol}}})% + }% + {}% + }% + }% + {\glscustomtext\glsinsert}% + }% +} +\newcommand*{\SmallNewAcronymDef}{% + \edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\noexpand\acronymfont{\the\glsshorttok}},% + sort={\the\glsshorttok},% + text={\the\glsshorttok},% + plural={\noexpand\expandonce\noexpand\@glo@shortpl},% + first={\the\glslongtok},% + firstplural={\noexpand\expandonce\noexpand\@glo@longpl},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + description={\noexpand\@glo@first},% + descriptionplural={\noexpand\expandonce\noexpand\@glo@longpl},% + symbol={\the\glsshorttok},% + symbolplural={\noexpand\expandonce\noexpand\@glo@shortpl},% + \the\glskeylisttok + }% + }% + \let\@org@gls@assign@firstpl\gls@assign@firstpl + \let\@org@gls@assign@plural\gls@assign@plural + \let\@org@gls@assign@descplural\gls@assign@descplural + \let\@org@gls@assign@symbolplural\gls@assign@symbolplural + \def\gls@assign@firstpl##1##2{% + \@@gls@expand@field{##1}{firstpl}{##2}% + }% + \def\gls@assign@plural##1##2{% + \@@gls@expand@field{##1}{plural}{##2}% + }% + \def\gls@assign@descplural##1##2{% + \@@gls@expand@field{##1}{descplural}{##2}% + }% + \def\gls@assign@symbolplural##1##2{% + \@@gls@expand@field{##1}{symbolplural}{##2}% + }% + \@do@newglossaryentry + \let\gls@assign@firstpl\@org@gls@assign@firstpl + \let\gls@assign@plural\@org@gls@assign@plural + \let\gls@assign@descplural\@org@gls@assign@descplural + \let\gls@assign@symbolplural\@org@gls@assign@symbolplural +} +\newcommand*{\SetSmallAcronymStyle}{% + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetSmallAcronymDisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \SmallNewAcronymDef + }% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetSmallAcronymDisplayStyle{\@gls@type}% + }% + \ifglsacrsmallcaps + \renewcommand*{\acronymfont}[1]{\textsc{##1}} + \renewcommand*{\acrpluralsuffix}{\glsupacrpluralsuffix}% + \else + \renewcommand*{\acronymfont}[1]{\textsmaller{##1}} + \fi + \ifglsacrdua + \ifglsacrsmallcaps + \PackageError{glossaries}{Option clash: `smallcaps' and `dua' + can't both be set}{}% + \else + \PackageError{glossaries}{Option clash: `smaller' and `dua' + can't both be set}{}% + \fi + \fi +}% +\newcommand*{\SetDUADisplayStyle}[1]{% + \defglsentryfmt[#1]{\glsgenentryfmt}% +} +\newcommand*{\DUANewAcronymDef}{% + \edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + name={\the\glsshorttok},% + text={\the\glslongtok},% + first={\the\glslongtok},% + plural={\noexpand\expandonce\noexpand\@glo@longpl},% + firstplural={\noexpand\expandonce\noexpand\@glo@longpl},% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + description={\the\glslongtok},% + descriptionplural={\noexpand\expandonce\noexpand\@glo@longpl},% + symbol={\the\glsshorttok},% + symbolplural={\noexpand\expandonce\noexpand\@glo@shortpl},% + \the\glskeylisttok + }% + }% + \let\@org@gls@assign@firstpl\gls@assign@firstpl + \let\@org@gls@assign@plural\gls@assign@plural + \let\@org@gls@assign@symbolplural\gls@assign@symbolplural + \let\@org@gls@assign@descplural\gls@assign@descplural + \def\gls@assign@firstpl##1##2{% + \@@gls@expand@field{##1}{firstpl}{##2}% + }% + \def\gls@assign@plural##1##2{% + \@@gls@expand@field{##1}{plural}{##2}% + }% + \def\gls@assign@symbolplural##1##2{% + \@@gls@expand@field{##1}{symbolplural}{##2}% + }% + \def\gls@assign@descplural##1##2{% + \@@gls@expand@field{##1}{descplural}{##2}% + }% + \@do@newglossaryentry + \let\gls@assign@firstpl\@org@gls@assign@firstpl + \let\gls@assign@plural\@org@gls@assign@plural + \let\gls@assign@symbolplural\@org@gls@assign@symbolplural + \let\gls@assign@descplural\@org@gls@assign@descplural +} +\newcommand*{\SetDUAStyle}{% + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetDUADisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \DUANewAcronymDef + }% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetDUADisplayStyle{\@gls@type}% + }% +} +\newcommand*{\SetAcronymStyle}{% + \SetDefaultAcronymStyle + \ifglsacrdescription + \ifglsacrfootnote + \SetDescriptionFootnoteAcronymStyle + \else + \ifglsacrdua + \SetDescriptionDUAAcronymStyle + \else + \SetDescriptionAcronymStyle + \fi + \fi + \else + \ifglsacrfootnote + \SetFootnoteAcronymStyle + \else + \ifthenelse{\boolean{glsacrsmallcaps}\OR + \boolean{glsacrsmaller}}% + {% + \SetSmallAcronymStyle + }% + {% + \ifglsacrdua + \SetDUAStyle + \fi + }% + \fi + \fi +} +\SetAcronymStyle +\newcommand*{\SetCustomDisplayStyle}[1]{% + \defglsentryfmt[#1]{\glsgenentryfmt}% +} +\newcommand*{\CustomAcronymFields}{% + name={\the\glsshorttok},% + description={\the\glslongtok},% + first={\acrfullformat{\the\glslongtok}{\the\glsshorttok}},% + firstplural={\acrfullformat + {\noexpand\glsentrylongpl{\the\glslabeltok}}% + {\noexpand\glsentryshortpl{\the\glslabeltok}}},% + text={\the\glsshorttok},% + plural={\the\glsshorttok\noexpand\acrpluralsuffix}% +} +\newcommand*{\CustomNewAcronymDef}{% + \protected@edef\@do@newglossaryentry{% + \noexpand\newglossaryentry{\the\glslabeltok}% + {% + type=\acronymtype,% + short={\the\glsshorttok},% + shortplural={\the\glsshorttok\noexpand\acrpluralsuffix},% + long={\the\glslongtok},% + longplural={\the\glslongtok\noexpand\acrpluralsuffix},% + user1={\the\glsshorttok},% + user2={\the\glsshorttok\noexpand\acrpluralsuffix},% + user3={\the\glslongtok},% + user4={\the\glslongtok\noexpand\acrpluralsuffix},% + \CustomAcronymFields,% + \the\glskeylisttok + }% + }% + \@do@newglossaryentry +} +\newcommand*{\SetCustomStyle}{% + \renewcommand{\newacronym}[4][]{% + \ifx\@glsacronymlists\@empty + \def\@glo@type{\acronymtype}% + \setkeys{glossentry}{##1}% + \DeclareAcronymList{\@glo@type}% + \SetCustomDisplayStyle{\@glo@type}% + \fi + \glskeylisttok{##1}% + \glslabeltok{##2}% + \glsshorttok{##3}% + \glslongtok{##4}% + \newacronymhook + \CustomNewAcronymDef + }% + \@for\@gls@type:=\@glsacronymlists\do{% + \SetCustomDisplayStyle{\@gls@type}% + }% +} +\RequirePackage{glossary-hypernav} +\@gls@loadlist +\@gls@loadlong +\@gls@loadsuper +\@gls@loadtree +\ifx\@glossary@default@style\relax +\else + \setglossarystyle{\@glossary@default@style} +\fi +\newcommand*{\showgloparent}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@parent\endcsname +} +\newcommand*{\showglolevel}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@level\endcsname +} +\newcommand*{\showglotext}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@text\endcsname +} +\newcommand*{\showgloplural}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@plural\endcsname +} +\newcommand*{\showglofirst}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@first\endcsname +} +\newcommand*{\showglofirstpl}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@firstpl\endcsname +} +\newcommand*{\showglotype}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@type\endcsname +} +\newcommand*{\showglocounter}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@counter\endcsname +} +\newcommand*{\showglouseri}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@useri\endcsname +} +\newcommand*{\showglouserii}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@userii\endcsname +} +\newcommand*{\showglouseriii}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@useriii\endcsname +} +\newcommand*{\showglouseriv}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@useriv\endcsname +} +\newcommand*{\showglouserv}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@userv\endcsname +} +\newcommand*{\showglouservi}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@uservi\endcsname +} +\newcommand*{\showgloname}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@name\endcsname +} +\newcommand*{\showglodesc}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@desc\endcsname +} +\newcommand*{\showglodescplural}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@descplural\endcsname +} +\newcommand*{\showglosort}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@sort\endcsname +} +\newcommand*{\showglosymbol}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@symbol\endcsname +} +\newcommand*{\showglosymbolplural}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@symbolplural\endcsname +} +\newcommand*{\showgloshort}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@short\endcsname +} +\newcommand*{\showglolong}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@long\endcsname +} +\newcommand*{\showgloindex}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@index\endcsname +} +\newcommand*{\showgloflag}[1]{% + \expandafter\show\csname ifglo@\glsdetoklabel{#1}@flag\endcsname +} +\newcommand*{\showgloloclist}[1]{% + \expandafter\show\csname glo@\glsdetoklabel{#1}@loclist\endcsname +} +\newcommand*{\showglofield}[2]{% + \csshow{glo@\glsdetoklabel{#1}@#2}% +} +\newcommand*{\showacronymlists}{% + \show\@glsacronymlists +} +\newcommand*{\showglossaries}{% + \show\@glo@types +} +\newcommand*{\showglossaryin}[1]{% + \expandafter\show\csname @glotype@#1@in\endcsname +} +\newcommand*{\showglossaryout}[1]{% + \expandafter\show\csname @glotype@#1@out\endcsname +} +\newcommand*{\showglossarytitle}[1]{% + \expandafter\show\csname @glotype@#1@title\endcsname +} +\newcommand*{\showglossarycounter}[1]{% + \expandafter\show\csname @glotype@#1@counter\endcsname +} +\newcommand*{\showglossaryentries}[1]{% + \expandafter\show\csname glolist@#1\endcsname +} +\csname ifglscompatible-2.07\endcsname + \RequirePackage{glossaries-compatible-207} +\fi +% \end{macrocode} +%\iffalse +% \begin{macrocode} +%</glossaries-2020-03-19.sty> +% \end{macrocode} +%\fi +%\iffalse +% \begin{macrocode} %<*glossaries.perl> % \end{macrocode} %\fi diff --git a/macros/latex/contrib/glossaries/glossaries.ins b/macros/latex/contrib/glossaries/glossaries.ins index 30d939a39e..0c8f90881b 100644 --- a/macros/latex/contrib/glossaries/glossaries.ins +++ b/macros/latex/contrib/glossaries/glossaries.ins @@ -1,10 +1,10 @@ -% glossaries.ins generated using makedtx version 1.2 2020/3/19 17:03 +% glossaries.ins generated using makedtx version 1.2 2021/9/23 17:22 \input docstrip \preamble glossaries.dtx - Copyright 2020 Nicola Talbot + Copyright 2021 Nicola Talbot This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 @@ -18,7 +18,7 @@ The Current Maintainer of this work is Nicola Talbot. - This work consists of the files glossaries.dtx and glossaries.ins and the derived files glossaries.sty, glossaries-prefix.sty, glossary-hypernav.sty, glossary-inline.sty, glossary-list.sty, glossary-long.sty, glossary-longbooktabs.sty, glossary-longragged.sty, glossary-mcols.sty, glossary-super.sty, glossary-superragged.sty, glossary-tree.sty, glossaries-compatible-207.sty, glossaries-compatible-307.sty, glossaries-accsupp.sty, glossaries-babel.sty, glossaries-polyglossia.sty, example-glossaries-acronym-desc.tex, example-glossaries-acronym.tex, example-glossaries-acronyms-lang.tex, example-glossaries-brief.tex, example-glossaries-childnoname.tex, example-glossaries-cite.tex, example-glossaries-images.tex, example-glossaries-long.tex, example-glossaries-multipar.tex, example-glossaries-parent.tex, example-glossaries-symbolnames.tex, example-glossaries-symbols.tex, example-glossaries-url.tex, glossaries.perl. + This work consists of the files glossaries.dtx and glossaries.ins and the derived files glossaries.sty, glossaries-prefix.sty, glossary-hypernav.sty, glossary-inline.sty, glossary-list.sty, glossary-long.sty, glossary-longbooktabs.sty, glossary-longragged.sty, glossary-mcols.sty, glossary-super.sty, glossary-superragged.sty, glossary-tree.sty, glossaries-compatible-207.sty, glossaries-compatible-307.sty, glossaries-accsupp.sty, glossaries-babel.sty, glossaries-polyglossia.sty, example-glossaries-acronym-desc.tex, example-glossaries-acronym.tex, example-glossaries-acronyms-lang.tex, example-glossaries-brief.tex, example-glossaries-childmultipar.tex, example-glossaries-childnoname.tex, example-glossaries-cite.tex, example-glossaries-images.tex, example-glossaries-long.tex, example-glossaries-longchild.tex, example-glossaries-multipar.tex, example-glossaries-parent.tex, example-glossaries-symbolnames.tex, example-glossaries-symbols.tex, example-glossaries-url.tex, glossaries-2020-03-19.sty, glossaries.perl. \endpreamble @@ -62,15 +62,19 @@ \file{example-glossaries-acronym.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-acronym.tex}} \file{example-glossaries-acronyms-lang.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-acronyms-lang.tex}} \file{example-glossaries-brief.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-brief.tex}} +\file{example-glossaries-childmultipar.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-childmultipar.tex}} \file{example-glossaries-childnoname.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-childnoname.tex}} \file{example-glossaries-cite.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-cite.tex}} \file{example-glossaries-images.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-images.tex}} \file{example-glossaries-long.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-long.tex}} +\file{example-glossaries-longchild.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-longchild.tex}} \file{example-glossaries-multipar.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-multipar.tex}} \file{example-glossaries-parent.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-parent.tex}} \file{example-glossaries-symbolnames.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-symbolnames.tex}} \file{example-glossaries-symbols.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-symbols.tex}} \file{example-glossaries-url.tex}{\nopreamble\nopostamble\from{glossaries.dtx}{example-glossaries-url.tex}} +\file{glossaries-2020-03-19.sty}{\usepreamble\defaultpreamble +\usepostamble\defaultpostamble\from{glossaries.dtx}{glossaries-2020-03-19.sty,package}} \file{glossaries.perl}{\nopreamble\nopostamble\from{glossaries.dtx}{glossaries.perl}} } diff --git a/macros/latex/contrib/glossaries/glossariesbegin.html b/macros/latex/contrib/glossaries/glossariesbegin.html index 91e6cd7014..85fd72607d 100644 --- a/macros/latex/contrib/glossaries/glossariesbegin.html +++ b/macros/latex/contrib/glossaries/glossariesbegin.html @@ -6,8 +6,8 @@ > <head><title></title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)" /> -<meta name="originator" content="TeX4ht (http://www.tug.org/tex4ht/)" /> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" /> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)" /> <!-- xhtml,fn-in,css-in,uni-html4,utf8 --> <meta name="src" content="glossariesbegin.tex" /> @@ -40,9 +40,9 @@ .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;} +.cmitt-10{font-family: monospace,monospace; font-style: italic;} .tcrm-0900{font-size:90%;} .cmss-8{font-size:80%; font-family: sans-serif;} .cmss-8{ font-family: sans-serif;} @@ -53,15 +53,19 @@ p.indent{text-indent:0;} p + p{margin-top:1em;} p + div, p + pre {margin-top:1em;} div + p, pre + p {margin-top:1em;} +a { overflow-wrap: break-word; word-wrap: break-word; word-break: break-word; hyphens: auto; } @media print {div.crosslinks {visibility:hidden;}} a img { border-top: 0; border-left: 0; border-right: 0; } center { margin-top:1em; margin-bottom:1em; } td center { margin-top:0em; margin-bottom:0em; } .Canvas { position:relative; } img.math{vertical-align:middle;} +div.par-math-display, div.math-display{text-align:center;} li p.indent { text-indent: 0em } li p:first-child{ margin-top:0em; } +li p:first-child{ margin-bottom; } li p:last-child, li div:last-child { margin-bottom:0.5em; } +li p:first-child{ margin-bottom:0; } li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; } .enumerate1 {list-style-type:decimal;} .enumerate2 {list-style-type:lower-alpha;} @@ -75,7 +79,7 @@ div.obeylines-v p { margin-top:0; margin-bottom:0; } td.displaylines {text-align:center; white-space:nowrap;} .centerline {text-align:center;} .rightline {text-align:right;} -div.verbatim {font-family: monospace,monospace; white-space: nowrap; text-align:left; clear:both; } +pre.verbatim {font-family: monospace,monospace; text-align:left; clear:both; } .fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } div.fbox {display:table} div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } @@ -137,6 +141,7 @@ table.pmatrix {width:100%;} span.bar-css {text-decoration:overline;} img.cdots{vertical-align:middle;} .partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;} +.chapterToc a, .chapterToc, .likechapterToc a, .likechapterToc, .appendixToc a, .appendixToc {line-height: 200%; font-weight:bold;} .index-item, .index-subitem, .index-subsubitem {display:block} div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;} div.caption span.id{font-weight: bold; white-space: nowrap; } @@ -145,18 +150,17 @@ p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } .paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} .subparagraphHead, .likesubparagraphHead { font-weight: bold;} -.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;} .verse{white-space:nowrap; margin-left:2em} div.maketitle {text-align:center;} h2.titleHead{text-align:center;} div.maketitle{ margin-bottom: 2em; } div.author, div.date {text-align:center;} div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } -.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } -.abstract p {margin-left:5%; margin-right:5%;} +div.abstract p {margin-left:5%; margin-right:5%;} div.abstract {width:100%;} +.abstracttitle{text-align:center;margin-bottom:1em;} .alltt P { margin-bottom : 0em; margin-top : 0em; } -.alltt { margin-bottom : 1em; margin-top : 1em; } +.alltt { margin-bottom : 1em; margin-top : 1em; font-family:monospace,monospace; } div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } table.tabular td p{margin-top:0em;} table.tabular {margin-left: auto; margin-right: auto;} @@ -258,12 +262,12 @@ span#textcolor40{color:#00FF00} > <!--l. 59--><p class="noindent" > </p><!--l. 59--><p class="noindent" ><span -class="cmr-17">The glossaries package v4.46: a guide for</span> +class="cmr-17">The glossaries package v4.47: a guide for</span> <span class="cmr-17">beginners</span> </p> <div class="tabular"> <table id="TBL-1" class="tabular" -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" @@ -276,30 +280,29 @@ href="https://www.dickimaw-books.com/" ><span class="cmtt-12">dickimaw-books.com</span></a> </td></tr></table> </div> <!--l. 59--><p class="noindent" ><span -class="cmr-12">2020-03-19</span></p></div> +class="cmr-12">2021-09-20</span></p></div> <div class="abstract" > -<div class="center" -> -<!--l. 61--><p class="noindent" > -</p><!--l. 61--><p class="noindent" ><span -class="cmbx-9">Abstract</span></p></div> - <!--l. 62--><p class="indent" > <span + <h3 class="abstracttitle"> +<span +class="cmbx-9">Abstract</span> +</h3> + <!--l. 62--><p class="noindent" ><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 -class="cmr-9"> lot</span> +class="cmr-9"> lot of</span> <span -class="cmr-9">of options, and since a user guide is supposed to provide a complete list</span> +class="cmr-9">options, and since a user guide is supposed to provide a complete list of all</span> <span -class="cmr-9">of all the high-level user commands, the main user manual is quite big.</span> +class="cmr-9">the high-level user commands, the main user manual is quite big. This can</span> <span -class="cmr-9">This can be rather daunting for beginners, so this document is a brief</span> +class="cmr-9">be rather daunting for beginners, so this document is a brief introduction</span> <span -class="cmr-9">introduction just to help get you started. If you find yourself saying, “Yeah,</span> +class="cmr-9">just to help get you started. If you find yourself saying, “Yeah, but how</span> <span -class="cmr-9">but how can I do</span><span +class="cmr-9">can I do</span><span 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 @@ -320,26 +323,26 @@ class="cmr-9">that way may cause complications under certain circumstances” <h3 class="likesectionHead"><a id="x1-1000"></a>Contents</h3> <div class="tableofcontents"> - <span class="sectionToc" >1 <a -href="#sec:start" id="QQ2-1-2">Getting Started</a></span> -<br /> <span class="sectionToc" >2 <a +  <span class="sectionToc" >1 <a +href="#sec:start" id="QQ2-1-2">Getting Started</a></span> +<br />  <span class="sectionToc" >2 <a href="#sec:defterm" id="QQ2-1-3">Defining Terms</a></span> -<br /> <span class="sectionToc" >3 <a +<br />  <span class="sectionToc" >3 <a href="#sec:useterm" id="QQ2-1-4">Using Entries</a></span> -<br /> <span class="sectionToc" >4 <a +<br />  <span class="sectionToc" >4 <a href="#sec:printglossaries" id="QQ2-1-5">Displaying a List of Entries</a></span> -<br /> <span class="sectionToc" >5 <a +<br />  <span class="sectionToc" >5 <a href="#sec:glosstyle" id="QQ2-1-7">Customising the Glossary</a></span> -<br /> <span class="sectionToc" >6 <a +<br />  <span class="sectionToc" >6 <a href="#sec:multigloss" id="QQ2-1-8">Multiple Glossaries</a></span> -<br /> <span class="sectionToc" >7 <a +<br />  <span class="sectionToc" >7 <a href="#sec:hyperref" id="QQ2-1-9">glossaries and hyperref</a></span> -<br /> <span class="sectionToc" >8 <a +<br />  <span class="sectionToc" >8 <a href="#sec:xr" id="QQ2-1-10">Cross-References</a></span> -<br /> <span class="sectionToc" >9 <a +<br />  <span class="sectionToc" >9 <a href="#sec:moreinfo" id="QQ2-1-11">Further Information</a></span> </div> <!--l. 81--><p class="noindent" > @@ -388,34 +391,34 @@ example: </p> - <div class="verbatim" id="verbatim-1"> + <pre class="verbatim" id="verbatim-1">  \documentclass{article} - <br /> \usepackage{glossaries} - <br /> \newglossaryentry{ex}{name={sample},description={an example}} - <br /> \begin{document} - <br /> Here's my \gls{ex} term. - <br /> \end{document} -</div> + \usepackage{glossaries} + \newglossaryentry{ex}{name={sample},description={an example}} + \begin{document} + Here's my \gls{ex} term. + \end{document} +</pre> <!--l. 114--><p class="nopar" > This produces: - </p><div class="quote"> - <!--l. 117--><p class="noindent" >Here’s my sample term.</p></div> + </p><blockquote class="quote"> + <!--l. 117--><p class="noindent" >Here’s my sample term.</p></blockquote> <!--l. 119--><p class="noindent" >Here’s another example: </p> - <div class="verbatim" id="verbatim-2"> + <pre class="verbatim" id="verbatim-2">  \documentclass{article} - <br /> \usepackage{glossaries} - <br /> \setacronymstyle{long-short} - <br /> \newacronym{svm}{SVM}{support vector machine} - <br /> \begin{document} - <br /> First use: \gls{svm}. Second use: \gls{svm}. - <br /> \end{document} -</div> + \usepackage{glossaries} + \setacronymstyle{long-short} + \newacronym{svm}{SVM}{support vector machine} + \begin{document} + First use: \gls{svm}. Second use: \gls{svm}. + \end{document} +</pre> <!--l. 132--><p class="nopar" > This produces: - </p><div class="quote"> - <!--l. 135--><p class="noindent" >First use: support vector machine (SVM). Second use: SVM.</p></div> + </p><blockquote class="quote"> + <!--l. 135--><p class="noindent" >First use: support vector machine (SVM). Second use: SVM.</p></blockquote> <!--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 @@ -444,15 +447,15 @@ class="cmss-10">glossaries-extra</span><a </p> - <div class="verbatim" id="verbatim-3"> + <pre class="verbatim" id="verbatim-3">  \documentclass{article} - <br /> \usepackage{glossaries-extra} - <br /> \setabbreviationstyle{long-short}% glossaries-extra.sty - <br /> \newabbreviation{svm}{SVM}{support vector machine}% glossaries-extra.sty - <br /> \begin{document} - <br /> First use: \gls{svm}. Second use: \gls{svm}. - <br /> \end{document} -</div> + \usepackage{glossaries-extra} + \setabbreviationstyle{long-short}% glossaries-extra.sty + \newabbreviation{svm}{SVM}{support vector machine}% glossaries-extra.sty + \begin{document} + First use: \gls{svm}. Second use: \gls{svm}. + \end{document} +</pre> <!--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 @@ -469,15 +472,15 @@ class="cmtt-10">\setabbreviationstyle</span>: </p> - <div class="verbatim" id="verbatim-4"> + <pre class="verbatim" id="verbatim-4">  \documentclass{article} - <br /> \usepackage{glossaries-extra} - <br /> \setabbreviationstyle[acronym]{long-short}% glossaries-extra.sty only - <br /> \newacronym{svm}{SVM}{support vector machine} - <br /> \begin{document} - <br /> First use: \gls{svm}. Second use: \gls{svm}. - <br /> \end{document} -</div> + \usepackage{glossaries-extra} + \setabbreviationstyle[acronym]{long-short}% glossaries-extra.sty only + \newacronym{svm}{SVM}{support vector machine} + \begin{document} + First use: \gls{svm}. Second use: \gls{svm}. + \end{document} +</pre> <!--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 @@ -501,9 +504,9 @@ filename as the argument. For example: </p> - <div class="verbatim" id="verbatim-5"> + <pre class="verbatim" id="verbatim-5"> \loadglsentries{defns} -</div> +</pre> <!--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 @@ -525,15 +528,15 @@ style): </p> - <div class="verbatim" id="verbatim-6"> + <pre class="verbatim" id="verbatim-6">  \documentclass{article} - <br /> \usepackage{glossaries} - <br /> \setacronymstyle{long-sc-short} - <br /> \newacronym{svm}{svm}{support vector machine} - <br /> \begin{document} - <br /> First use: \gls{svm}. Second use: \gls{svm}. - <br /> \end{document} -</div> + \usepackage{glossaries} + \setacronymstyle{long-sc-short} + \newacronym{svm}{svm}{support vector machine} + \begin{document} + First use: \gls{svm}. Second use: \gls{svm}. + \end{document} +</pre> <!--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>: @@ -541,15 +544,15 @@ class="cmss-10">glossaries-extra</span><a </p> - <div class="verbatim" id="verbatim-7"> + <pre class="verbatim" id="verbatim-7">  \documentclass{article} - <br /> \usepackage{glossaries-extra} - <br /> \setabbreviationstyle{long-short-sc}% glossaries-extra.sty - <br /> \newabbreviation{svm}{svm}{support vector machine}% glossaries-extra.sty - <br /> \begin{document} - <br /> First use: \gls{svm}. Second use: \gls{svm}. - <br /> \end{document} -</div> + \usepackage{glossaries-extra} + \setabbreviationstyle{long-short-sc}% glossaries-extra.sty + \newabbreviation{svm}{svm}{support vector machine}% glossaries-extra.sty + \begin{document} + First use: \gls{svm}. Second use: \gls{svm}. + \end{document} +</pre> <!--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 @@ -559,34 +562,34 @@ can be redefined for minor adjustments. For example: </p> - <div class="verbatim" id="verbatim-8"> + <pre class="verbatim" id="verbatim-8">  \documentclass{article} - <br /> \usepackage{glossaries-extra} - <br /> \setabbreviationstyle[statistical]{long-short-sc} - <br /> \setabbreviationstyle[bacteria]{long-only-short-only} - <br /> % Formatting commands used by 'long-only-short-only' style: - <br /> \renewcommand*{\glsabbrvonlyfont}[1]{\emph{#1}} - <br /> \renewcommand*{\glslongonlyfont}[1]{\emph{#1}} - <br /> % Formatting command used by 'long-short-sc' style: - <br /> % (make sure abbreviation is converted to lower case) - <br /> \renewcommand*{\glsabbrvscfont}[1]{\textsc{\MakeLowercase{#1}}} - <br /> \newabbreviation - <br />  [ - <br />    category={statistical}% glossaries-extra.sty key - <br />  ] - <br />  {svm}{SVM}{support vector machine} - <br /> \newabbreviation - <br />  [ - <br />    category={bacteria}% glossaries-extra.sty key - <br />  ] - <br />  {cbot}{C.~botulinum}{Clostridium botulinum} - <br /> \begin{document} - <br /> First use: \gls{svm}, \gls{cbot}. - <br /> Next use: \gls{svm}, \gls{cbot}. - <br /> \end{document} -</div> + \usepackage{glossaries-extra} + \setabbreviationstyle[statistical]{long-short-sc} + \setabbreviationstyle[bacteria]{long-only-short-only} + % Formatting commands used by 'long-only-short-only' style: + \renewcommand*{\glsabbrvonlyfont}[1]{\emph{#1}} + \renewcommand*{\glslongonlyfont}[1]{\emph{#1}} + % Formatting command used by 'long-short-sc' style: + % (make sure abbreviation is converted to lower case) + \renewcommand*{\glsabbrvscfont}[1]{\textsc{\MakeLowercase{#1}}} + \newabbreviation +  [ +    category={statistical}% glossaries-extra.sty key +  ] +  {svm}{SVM}{support vector machine} + \newabbreviation +  [ +    category={bacteria}% glossaries-extra.sty key +  ] +  {cbot}{C.~botulinum}{Clostridium botulinum} + \begin{document} + First use: \gls{svm}, \gls{cbot}. + Next use: \gls{svm}, \gls{cbot}. + \end{document} +</pre> <!--l. 282--><p class="nopar" > This produces: - </p><div class="quote"> + </p><blockquote class="quote"> <!--l. 285--><p class="noindent" >First use: support vector machine (<span class="cmcsc-10"><span class="small-caps">s</span><span @@ -599,7 +602,7 @@ 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> +class="cmti-10"> botulinum</span>.</p></blockquote> <!--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 @@ -666,22 +669,22 @@ entries: </p> - <div class="verbatim" id="verbatim-9"> + <pre class="verbatim" id="verbatim-9">  \documentclass{article} - <br /> \usepackage[sort=none]{glossaries-extra} - <br /> \newglossaryentry{potato}{name={potato},plural={potatoes}, - <br />  description={starchy tuber}} - <br /> \newglossaryentry{cabbage}{name={cabbage}, - <br />  description={vegetable with thick green or purple leaves}} - <br /> \newglossaryentry{turnip}{name={turnip}, - <br />  description={round pale root vegetable}} - <br /> \newglossaryentry{carrot}{name={carrot}, - <br />  description={orange root}} - <br /> \begin{document} - <br /> Chop the \gls{cabbage}, \glspl{potato} and \glspl{carrot}. - <br /> \printunsrtglossaries % list all entries - <br /> \end{document} -</div> + \usepackage[sort=none]{glossaries-extra} + \newglossaryentry{potato}{name={potato},plural={potatoes}, +  description={starchy tuber}} + \newglossaryentry{cabbage}{name={cabbage}, +  description={vegetable with thick green or purple leaves}} + \newglossaryentry{turnip}{name={turnip}, +  description={round pale root vegetable}} + \newglossaryentry{carrot}{name={carrot}, +  description={orange root}} + \begin{document} + Chop the \gls{cabbage}, \glspl{potato} and \glspl{carrot}. + \printunsrtglossaries % list all entries + \end{document} +</pre> <!--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 @@ -741,23 +744,23 @@ place where you want your glossary. For example: </p> - <div class="verbatim" id="verbatim-10"> + <pre class="verbatim" id="verbatim-10">  \documentclass{article} - <br /> \usepackage{glossaries} - <br /> \makenoidxglossaries % use TeX to sort - <br /> \newglossaryentry{potato}{name={potato},plural={potatoes}, - <br />  description={starchy tuber}} - <br /> \newglossaryentry{cabbage}{name={cabbage}, - <br />  description={vegetable with thick green or purple leaves}} - <br /> \newglossaryentry{turnip}{name={turnip}, - <br />  description={round pale root vegetable}} - <br /> \newglossaryentry{carrot}{name={carrot}, - <br />  description={orange root}} - <br /> \begin{document} - <br /> Chop the \gls{cabbage}, \glspl{potato} and \glspl{carrot}. - <br /> \printnoidxglossaries - <br /> \end{document} -</div> + \usepackage{glossaries} + \makenoidxglossaries % use TeX to sort + \newglossaryentry{potato}{name={potato},plural={potatoes}, +  description={starchy tuber}} + \newglossaryentry{cabbage}{name={cabbage}, +  description={vegetable with thick green or purple leaves}} + \newglossaryentry{turnip}{name={turnip}, +  description={round pale root vegetable}} + \newglossaryentry{carrot}{name={carrot}, +  description={orange root}} + \begin{document} + Chop the \gls{cabbage}, \glspl{potato} and \glspl{carrot}. + \printnoidxglossaries + \end{document} +</pre> <!--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 @@ -782,17 +785,17 @@ options: </p> - <div class="verbatim" id="verbatim-11"> + <pre class="verbatim" id="verbatim-11"> \usepackage[nogroupskip]{glossaries} -</div> +</pre> <!--l. 427--><p class="nopar" > or you may want to try out a style that shows the group headings: </p> - <div class="verbatim" id="verbatim-12"> + <pre class="verbatim" id="verbatim-12"> \usepackage[style=indexgroup]{glossaries} -</div> +</pre> <!--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 @@ -805,9 +808,9 @@ option: </p> - <div class="verbatim" id="verbatim-13"> + <pre class="verbatim" id="verbatim-13"> \usepackage[nonumberlist]{glossaries} -</div> +</pre> <!--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> @@ -816,9 +819,9 @@ package option: </p> - <div class="verbatim" id="verbatim-14"> + <pre class="verbatim" id="verbatim-14"> \usepackage[nopostdot]{glossaries} -</div> +</pre> <!--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 @@ -830,17 +833,17 @@ lists. You can add the full stop back with </p> - <div class="verbatim" id="verbatim-15"> + <pre class="verbatim" id="verbatim-15"> \usepackage[nopostdot=false]{glossaries-extra} -</div> +</pre> <!--l. 453--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-16"> + <pre class="verbatim" id="verbatim-16"> \usepackage[postdot]{glossaries-extra} -</div> +</pre> <!--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 @@ -860,17 +863,18 @@ class="cmtt-10">xindy</span><a href="#option3">Option 3</a>) or <span class="cmtt-10">bib2gls</span><a id="dx1-2030"></a> (<a -href="#option4">Option 4</a>). If you are using -extended Latin or non-Latin characters, then <span +href="#option4">Option 4</a>). If you are +using extended Latin or non-Latin characters, then <span class="cmtt-10">xindy</span><a id="dx1-2031"></a> or <span class="cmtt-10">bib2gls</span><a - id="dx1-2032"></a> are the -recommended methods. These methods are described in more detail in <a + id="dx1-2032"></a> are +the recommended methods. These methods are described in more detail in +<a href="#sec:printglossaries"><span -class="tcrm-1000">§</span>4 </a><a -href="#sec:printglossaries">Displaying -a List of Entries<!--tex4ht:ref: sec:printglossaries --></a>. +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:printglossaries </a><a +href="#sec:printglossaries">Displaying a List of Entries<!--tex4ht:ref: sec:printglossaries --></a>. </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 @@ -961,62 +965,69 @@ class="cmtt-10">}</span> <!--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 +<li + class="enumerate" id="x1-3003x1"> + <!--l. 523--><p class="noindent" >Define the term “set” with the label <span class="cmtt-10">set</span>: - <div class="verbatim" id="verbatim-17"> +</p> + <pre class="verbatim" id="verbatim-17"> \newglossaryentry{set} -  <br />{ -  <br />  name={set}, -  <br />  description={a collection of objects} -  <br />} -</div> + { +   name={set}, +   description={a collection of objects} + } +</pre> <!--l. 530--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-3005x2">Define the symbol <span +<li + class="enumerate" id="x1-3005x2"> + <!--l. 532--><p class="noindent" >Define the symbol <span class="cmsy-10">∅ </span>with the label <span class="cmtt-10">emptyset</span>: - <div class="verbatim" id="verbatim-18"> +</p> + <pre class="verbatim" id="verbatim-18"> \newglossaryentry{emptyset} -  <br />{ -  <br />  name={\ensuremath{\emptyset}}, -  <br />  description={the empty set} -  <br />} -</div> + { +   name={\ensuremath{\emptyset}}, +   description={the empty set} + } +</pre> <!--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.) </p></li> - <li - class="enumerate" id="x1-3007x3">Define the phrase “Fish Age” with the label <span +<li + class="enumerate" id="x1-3007x3"> + <!--l. 544--><p class="noindent" >Define the phrase “Fish Age” with the label <span class="cmtt-10">fishage</span>: - <div class="verbatim" id="verbatim-19"> +</p> + <pre class="verbatim" id="verbatim-19"> \longnewglossaryentry{fishage} -  <br />{name={Fish Age}} -  <br />{% -  <br />  A common name for the Devonian geologic period -  <br />  spanning from the end of the Silurian Period to -  <br />  the beginning of the Carboniferous Period. -  <br />  This age was known for its remarkable variety of -  <br />  fish species. -  <br />} -</div> + {name={Fish Age}} + {% +   A common name for the Devonian geologic period +   spanning from the end of the Silurian Period to +   the beginning of the Carboniferous Period. +   This age was known for its remarkable variety of +   fish species. + } +</pre> <!--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 - class="enumerate" id="x1-3009x4">Take care if the first letter is an extended Latin or non-Latin character (either +<li + class="enumerate" id="x1-3009x4"> + <!--l. 562--><p class="noindent" >Take care if the first letter is an extended Latin or non-Latin character (either specified via a command such as <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\’e</span></span></span> or explicitly via the <span class="cmss-10">inputenc</span><a @@ -1026,13 +1037,14 @@ class="cmtt-10">é</span>). This first letter must be placed in a g - <div class="verbatim" id="verbatim-20"> +</p> + <pre class="verbatim" id="verbatim-20"> \newglossaryentry{elite} -  <br />{ -  <br />  name={{\'e}lite}, -  <br />  description={select group or class} -  <br />} -</div> + { +   name={{\'e}lite}, +   description={select group or class} + } +</pre> <!--l. 573--><p class="nopar" > or </p><div class="alltt"> <div class="obeylines-v"> <span class="verb"><span @@ -1129,6 +1141,9 @@ class="cmtt-10">Fish</span><span class="cmtt-10"> Age</span><span class="cmsy-10">}</span><span class="cmtt-10">,</span> + + + <br /><span class="cmtt-10"> </span><span class="cmtt-10"> description=</span><span @@ -1152,9 +1167,6 @@ 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 @@ -1217,9 +1229,9 @@ package option: - <div class="verbatim" id="verbatim-21"> + <pre class="verbatim" id="verbatim-21"> \usepackage[record]{glossaries-extra} -</div> +</pre> <!--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 @@ -1230,9 +1242,9 @@ preamble: </p> - <div class="verbatim" id="verbatim-22"> + <pre class="verbatim" id="verbatim-22"> \GlsXtrLoadResources[src={entries}] -</div> +</pre> <!--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>: @@ -1240,9 +1252,9 @@ class="cmtt-10">entries2.bib</span>: </p> - <div class="verbatim" id="verbatim-23"> + <pre class="verbatim" id="verbatim-23"> \GlsXtrLoadResources[src={entries,entries2}] -</div> +</pre> <!--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> @@ -1258,15 +1270,15 @@ class="cmtt-10">text </span>key as well. </p> - <div class="verbatim" id="verbatim-24"> + <pre class="verbatim" id="verbatim-24"> \newglossaryentry{latinalph} - <br />{ - <br />  name={Latin Alphabet}, - <br />  text={Latin alphabet}, - <br />  description={alphabet consisting of the letters - <br />  a, \ldots, z, A, \ldots, Z} - <br />} -</div> +{ +  name={Latin Alphabet}, +  text={Latin alphabet}, +  description={alphabet consisting of the letters +  a, \ldots, z, A, \ldots, Z} +} +</pre> <!--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 @@ -1277,14 +1289,14 @@ as: </p> - <div class="verbatim" id="verbatim-25"> + <pre class="verbatim" id="verbatim-25"> @entry{latinalph, - <br />  name={Latin Alphabet}, - <br />  text={Latin alphabet}, - <br />  description={alphabet consisting of the letters - <br />  a, \ldots, z, A, \ldots, Z} - <br />} -</div> +  name={Latin Alphabet}, +  text={Latin alphabet}, +  description={alphabet consisting of the letters +  a, \ldots, z, A, \ldots, Z} +} +</pre> <!--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 @@ -1296,14 +1308,14 @@ class="cmtt-10">plural </span>key to override it: </p> - <div class="verbatim" id="verbatim-26"> + <pre class="verbatim" id="verbatim-26"> \newglossaryentry{oesophagus} - <br />{ - <br />  name={{\oe}sophagus}, - <br />  plural={{\oe}sophagi}, - <br />  description={canal from mouth to stomach} - <br />} -</div> +{ +  name={{\oe}sophagus}, +  plural={{\oe}sophagi}, +  description={canal from mouth to stomach} +} +</pre> <!--l. 677--><p class="nopar" > (Remember from earlier that the initial ligature <span class="cmtt-10">\oe </span>needs to be grouped.) </p><!--l. 681--><p class="indent" > Abbreviations can be defined using: @@ -1328,9 +1340,9 @@ class="cmti-10">long</span>⟩ is the long form. For example, the following </p> - <div class="verbatim" id="verbatim-27"> + <pre class="verbatim" id="verbatim-27"> \newacronym{svm}{SVM}{support vector machine} -</div> +</pre> <!--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 @@ -1346,11 +1358,11 @@ the optional argument: </p> - <div class="verbatim" id="verbatim-28"> + <pre class="verbatim" id="verbatim-28"> \newacronym - <br /> [description={statistical pattern recognition technique}] - <br /> {svm}{SVM}{support vector machine} -</div> + [description={statistical pattern recognition technique}] + {svm}{SVM}{support vector machine} +</pre> <!--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: @@ -1457,11 +1469,11 @@ class="cmtt-10">shortplural </span>keys. For example: </p> - <div class="verbatim" id="verbatim-29"> + <pre class="verbatim" id="verbatim-29"> \newacronym - <br /> [longplural={diagonal matrices}] - <br /> {dm}{DM}{diagonal matrix} -</div> + [longplural={diagonal matrices}] + {dm}{DM}{diagonal matrix} +</pre> <!--l. 754--><p class="nopar" > or (with <span class="cmss-10">glossaries-extra</span><a id="dx1-3019"></a>): @@ -1469,11 +1481,11 @@ class="cmss-10">glossaries-extra</span><a </p> - <div class="verbatim" id="verbatim-30"> + <pre class="verbatim" id="verbatim-30"> \newabbreviation % glossaries-extra.sty - <br /> [longplural={diagonal matrices}] - <br /> {dm}{DM}{diagonal matrix} -</div> + [longplural={diagonal matrices}] + {dm}{DM}{diagonal matrix} +</pre> <!--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 @@ -1483,13 +1495,13 @@ class="cmtt-10">.bib </span>file is: </p> - <div class="verbatim" id="verbatim-31"> + <pre class="verbatim" id="verbatim-31"> @abbreviation{dm, - <br />  short={DM}, - <br />  long={diagonal matrix}, - <br />  longplural={diagonal matrices} - <br />} -</div> +  short={DM}, +  long={diagonal matrix}, +  longplural={diagonal matrices} +} +</pre> <!--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 @@ -1500,14 +1512,14 @@ example: </p> - <div class="verbatim" id="verbatim-32"> + <pre class="verbatim" id="verbatim-32"> \newglossaryentry{emptyset} - <br />{ - <br />  name={empty set}, - <br />  symbol={\ensuremath{\emptyset}}, - <br />  description={the set containing no elements} - <br />} -</div> +{ +  name={empty set}, +  symbol={\ensuremath{\emptyset}}, +  description={the set containing no elements} +} +</pre> <!--l. 782--><p class="nopar" > or with <span class="cmtt-10">bib2gls</span><a id="dx1-3021"></a> the definition in the <span @@ -1516,13 +1528,13 @@ class="cmtt-10">.bib </span>file is: </p> - <div class="verbatim" id="verbatim-33"> + <pre class="verbatim" id="verbatim-33"> @entry{emptyset, - <br />  name={empty set}, - <br />  symbol={\ensuremath{\emptyset}}, - <br />  description={the set containing no elements} - <br />} -</div> +  name={empty set}, +  symbol={\ensuremath{\emptyset}}, +  description={the set containing no elements} +} +</pre> <!--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 @@ -1541,14 +1553,14 @@ order is a little odd. For example: </p> - <div class="verbatim" id="verbatim-34"> + <pre class="verbatim" id="verbatim-34"> \newglossaryentry{emptyset} - <br />{ - <br />  name={\ensuremath{\emptyset}}, - <br />  sort={empty set}, - <br />  description={the set containing no elements} - <br />} -</div> +{ +  name={\ensuremath{\emptyset}}, +  sort={empty set}, +  description={the set containing no elements} +} +</pre> <!--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 @@ -1575,19 +1587,19 @@ class="cmti-10">label</span>⟩. For example: </p> - <div class="verbatim" id="verbatim-35"> + <pre class="verbatim" id="verbatim-35"> \documentclass{article} - <br />\usepackage[symbols]{glossaries-extra} - <br />\makeglossaries - <br />\glsxtrnewsymbol % requires glossaries-extra.sty 'symbols' option - <br /> [description={the set containing no elements}] - <br /> {emptyset}% label (and sort value) - <br /> {\ensuremath{\emptyset}}% symbol - <br />\begin{document} - <br />\gls{emptyset} - <br />\printglossaries - <br />\end{document} -</div> +\usepackage[symbols]{glossaries-extra} +\makeglossaries +\glsxtrnewsymbol % requires glossaries-extra.sty 'symbols' option + [description={the set containing no elements}] + {emptyset}% label (and sort value) + {\ensuremath{\emptyset}}% symbol +\begin{document} +\gls{emptyset} +\printglossaries +\end{document} +</pre> <!--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 @@ -1597,12 +1609,12 @@ class="cmtt-10">.bib </span>file as </p> - <div class="verbatim" id="verbatim-36"> + <pre class="verbatim" id="verbatim-36"> @entry{emptyset, - <br />  name={\ensuremath{\emptyset}}, - <br />  description={the set containing no elements} - <br />} -</div> +  name={\ensuremath{\emptyset}}, +  description={the set containing no elements} +} +</pre> <!--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 @@ -1612,12 +1624,12 @@ value. Alternatively you can use: </p> - <div class="verbatim" id="verbatim-37"> + <pre class="verbatim" id="verbatim-37"> @symbol{emptyset, - <br />  name={\ensuremath{\emptyset}}, - <br />  description={the set containing no elements} - <br />} -</div> +  name={\ensuremath{\emptyset}}, +  description={the set containing no elements} +} +</pre> <!--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 @@ -1630,15 +1642,15 @@ now: </p> - <div class="verbatim" id="verbatim-38"> + <pre class="verbatim" id="verbatim-38"> \documentclass{article} - <br />\usepackage[record]{glossaries-extra} - <br />\GlsXtrLoadResources[src=entries] - <br />\begin{document} - <br />\gls{emptyset} - <br />\printunsrtglossaries - <br />\end{document} -</div> +\usepackage[record]{glossaries-extra} +\GlsXtrLoadResources[src=entries] +\begin{document} +\gls{emptyset} +\printunsrtglossaries +\end{document} +</pre> <!--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 @@ -1744,9 +1756,9 @@ for the plural form. For example: </p> - <div class="verbatim" id="verbatim-39"> + <pre class="verbatim" id="verbatim-39"> \Glspl{set} are collections. -</div> +</pre> <!--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 @@ -1763,15 +1775,17 @@ href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span cla id="sec:printglossaries"></a>Displaying a List of Entries</h3> <!--l. 943--><p class="noindent" >In <a href="#sec:start"><span -class="tcrm-1000">§</span>1 </a><a +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:start </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> package. These are also available with the extension package <span -class="cmss-10">glossaries-extra</span> -along with a fourth option. These four options are listed below in a little -more detail. <a -href="#tab:optionsp+c">Table 1</a> summarises the main advantages and disadvantages. +class="cmss-10">glossaries-extra </span>along +with a fourth option. These four options are listed below in a little more detail. +<a +href="#tab:optionsp+c">Table <span +class="cmbx-10">??</span>tab:optionsp+c</a> summarises the main advantages and disadvantages. (There’s a more detailed summary in the main <span class="cmss-10">glossaries </span>user manual.) See also <a @@ -1792,7 +1806,7 @@ build</a>. ><span class="id">Table 1: </span><span class="content">Comparison of Glossary Options</span></div><!--tex4ht:label?: x1-50011 --> <div class="tabular"> <table id="TBL-2" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-2-1g"><col id="TBL-2-1" /><col id="TBL-2-2" /><col @@ -1974,12 +1988,14 @@ class="cmr-8">Requires some setting up.</span> </div><hr class="endfloat" /> </div> <dl class="description"><dt class="description"> - </dt><dd -class="description"><a + <!--l. 988--><p class="noindent" > + </p></dt><dd +class="description"> + <!--l. 988--><p class="noindent" ><a id="option1"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 1</span>: - <!--l. 990--><p class="noindent" >This is the simplest option but it’s slow and if you want a sorted list, + </p><!--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 @@ -1996,17 +2012,20 @@ class="cmtt-10">=</span><span class="cmss-10">use</span><a id="dx1-5005"></a>. </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-5007x1">Add <span +<li + class="enumerate" id="x1-5007x1"> + <!--l. 998--><p class="noindent" >Add <span class="cmtt-10">\makenoidxglossaries </span>to your preamble (before you start defining your entries, as described in <a href="#sec:defterm"><span -class="tcrm-1000">§</span>2 </a><a +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:defterm </a><a href="#sec:defterm">Defining Terms<!--tex4ht:ref: sec:defterm --></a>). - </li> - <li - class="enumerate" id="x1-5009x2">Put - <!--l. 1004--><p class="noindent" ><hr><div title="Definition"><span + </p></li> +<li + class="enumerate" id="x1-5009x2"> + <!--l. 1002--><p class="noindent" >Put + </p><!--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 @@ -2033,50 +2052,53 @@ class="cmtt-10">\printnoidxglossaries </span></div><hr> </p> - <div class="verbatim" id="verbatim-40"> + <pre class="verbatim" id="verbatim-40"> \printnoidxglossary[sort=word]% main glossary -  <br />\printnoidxglossary[type=symbols,sort=use]% symbols glossary -</div> + \printnoidxglossary[type=symbols,sort=use]% symbols glossary +</pre> <!--l. 1022--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-5011x3">Run LaTeX twice on your document. (As you would do to make a table +<li + class="enumerate" id="x1-5011x3"> + <!--l. 1024--><p class="noindent" >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> + or “PDFLaTeX” button in your editor.</p></li></ol> <!--l. 1028--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): </p> - <div class="verbatim" id="verbatim-41"> + <pre class="verbatim" id="verbatim-41"> \documentclass{article} -  <br />\usepackage{glossaries} -  <br />\makenoidxglossaries % use TeX to sort -  <br />\newglossaryentry{sample}{name={sample}, -  <br />  description={an example}} -  <br />\begin{document} -  <br />A \gls{sample}. -  <br />\printnoidxglossaries % iterate over all indexed entries -  <br />\end{document} -</div> + \usepackage{glossaries} + \makenoidxglossaries % use TeX to sort + \newglossaryentry{sample}{name={sample}, +   description={an example}} + \begin{document} + A \gls{sample}. + \printnoidxglossaries % iterate over all indexed entries + \end{document} +</pre> <!--l. 1044--><p class="nopar" > Document build: </p> - <div class="verbatim" id="verbatim-42"> + <pre class="verbatim" id="verbatim-42"> pdflatex myDoc -  <br />pdflatex myDoc -</div> + pdflatex myDoc +</pre> <!--l. 1049--><p class="nopar" > </p></dd><dt class="description"> - </dt><dd -class="description"><a + <!--l. 1051--><p class="noindent" > + </p></dt><dd +class="description"> + <!--l. 1051--><p class="noindent" ><a id="option2"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 2</span>: - <!--l. 1053--><p class="noindent" >This option uses an application called <span + </p><!--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 TeX distributions, but it’s hard-coded for @@ -2097,8 +2119,9 @@ class="cmtt-10">makeglossaries</span><a class="cmtt-10">.aux</span> file. </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-5018x1">If you are using <span +<li + class="enumerate" id="x1-5018x1"> + <!--l. 1065--><p class="noindent" >If you are using <span class="cmss-10">ngerman</span><a id="dx1-5019"></a><span class="footnote-mark"><a href="#fn1x0" id="fn1x0-bk"><sup class="textsuperscript">1</sup></a></span><a @@ -2111,21 +2134,24 @@ class="cmtt-10">\GlsSetQuote </span>to change this to some other character. - <div class="verbatim" id="verbatim-43"> +</p> + <pre class="verbatim" id="verbatim-43"> \GlsSetQuote{+} -</div> +</pre> <!--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> - <li - class="enumerate" id="x1-5023x2">Add <span +<li + class="enumerate" id="x1-5023x2"> + <!--l. 1076--><p class="noindent" >Add <span class="cmtt-10">\makeglossaries </span>to your preamble (before you start defining your entries). - </li> - <li - class="enumerate" id="x1-5025x3">Put - <!--l. 1081--><p class="noindent" ><hr><div title="Definition"><span + </p></li> +<li + class="enumerate" id="x1-5025x3"> + <!--l. 1079--><p class="noindent" >Put + </p><!--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> @@ -2156,8 +2182,9 @@ class="cmss-10">def</span><a id="dx1-5028"></a>. </div> </p><!--l. 1097--><p class="noindent" > </p></li> - <li - class="enumerate" id="x1-5030x4">Run LaTeX on your document. This creates files with the extensions <span +<li + class="enumerate" id="x1-5030x4"> + <!--l. 1099--><p class="noindent" >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 @@ -2167,22 +2194,27 @@ 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 + </p></li> +<li + class="enumerate" id="x1-5032x5"> + <!--l. 1106--><p class="noindent" >Run <span class="cmtt-10">makeglossaries</span><a id="dx1-5033"></a> with the base name of your document (without the <span class="cmtt-10">.tex</span>) extension. If you have access to a terminal or a command prompt + + + (for example, the MSDOS command prompt for Windows users or the bash console for Unix-like users) then you need to run the command: - <div class="verbatim" id="verbatim-44"> +</p> + <pre class="verbatim" id="verbatim-44"> makeglossaries myDoc -</div> +</pre> <!--l. 1113--><p class="nopar" > (Replace <span class="cmtt-10">myDoc </span>with the base name of your LaTeX document file without the <span @@ -2194,9 +2226,9 @@ class="cmtt-10">makeglossaries-lite</span><a </p> - <div class="verbatim" id="verbatim-45"> + <pre class="verbatim" id="verbatim-45"> makeglossaries-lite myDoc -</div> +</pre> <!--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 @@ -2226,9 +2258,9 @@ class="cmss-10">automake</span><a </p> - <div class="verbatim" id="verbatim-46"> + <pre class="verbatim" id="verbatim-46"> \usepackage[automake]{glossaries} -</div> +</pre> <!--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 @@ -2241,59 +2273,62 @@ class="cmss-10">letter</span><a </p> - <div class="verbatim" id="verbatim-47"> + <pre class="verbatim" id="verbatim-47"> \usepackage[order=letter]{glossaries} -</div> +</pre> <!--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 - LaTeX on your document again.</li></ol> +<li + class="enumerate" id="x1-5041x6"> + <!--l. 1153--><p class="noindent" >Once you have successfully completed the previous step, you can now run + LaTeX on your document again.</p></li></ol> <!--l. 1156--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): </p> - <div class="verbatim" id="verbatim-48"> + <pre class="verbatim" id="verbatim-48"> \documentclass{article} -  <br />\usepackage{glossaries} -  <br />\makeglossaries % create makeindex files -  <br />\newglossaryentry{sample}{name={sample}, -  <br />  description={an example}} -  <br />\begin{document} -  <br />A \gls{sample}. -  <br />\printglossaries % input files created by makeindex -  <br />\end{document} -</div> + \usepackage{glossaries} + \makeglossaries % create makeindex files + \newglossaryentry{sample}{name={sample}, +   description={an example}} + \begin{document} + A \gls{sample}. + \printglossaries % input files created by makeindex + \end{document} +</pre> <!--l. 1172--><p class="nopar" > Document build: </p> - <div class="verbatim" id="verbatim-49"> + <pre class="verbatim" id="verbatim-49"> pdflatex myDoc -  <br />makeglossaries myDoc -  <br />pdflatex myDoc -</div> + makeglossaries myDoc + pdflatex myDoc +</pre> <!--l. 1178--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-50"> + <pre class="verbatim" id="verbatim-50"> pdflatex myDoc -  <br />makeglossaries-lite myDoc -  <br />pdflatex myDoc -</div> + makeglossaries-lite myDoc + pdflatex myDoc +</pre> <!--l. 1184--><p class="nopar" > </p></dd><dt class="description"> - </dt><dd -class="description"><a + <!--l. 1187--><p class="noindent" > + </p></dt><dd +class="description"> + <!--l. 1187--><p class="noindent" ><a id="option3"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 3</span>: - <!--l. 1189--><p class="noindent" >This option uses an application called <span + </p><!--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 @@ -2321,8 +2356,9 @@ class="cmtt-10">makeglossaries</span><a class="cmtt-10">.aux</span> file. </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-5050x1">Add the <span +<li + class="enumerate" id="x1-5050x1"> + <!--l. 1204--><p class="noindent" >Add the <span class="cmss-10">xindy</span><a id="dx1-5051"></a> option to the <span class="cmss-10">glossaries</span><a @@ -2330,19 +2366,22 @@ class="cmss-10">glossaries</span><a - <div class="verbatim" id="verbatim-51"> +</p> + <pre class="verbatim" id="verbatim-51"> \usepackage[xindy]{glossaries} -</div> +</pre> <!--l. 1208--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-5054x2">Add <span +<li + class="enumerate" id="x1-5054x2"> + <!--l. 1210--><p class="noindent" >Add <span class="cmtt-10">\makeglossaries </span>to your preamble (before you start defining your entries). - </li> - <li - class="enumerate" id="x1-5056x3">Put - <!--l. 1215--><p class="noindent" ><hr><div title="Definition"><span + </p></li> +<li + class="enumerate" id="x1-5056x3"> + <!--l. 1213--><p class="noindent" >Put + </p><!--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> @@ -2371,8 +2410,9 @@ class="cmss-10">def</span><a id="dx1-5059"></a>. </div> </p><!--l. 1229--><p class="noindent" > </p></li> - <li - class="enumerate" id="x1-5061x4">Run LaTeX on your document. This creates files with the extensions <span +<li + class="enumerate" id="x1-5061x4"> + <!--l. 1231--><p class="noindent" >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 @@ -2382,9 +2422,10 @@ 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 + </p></li> +<li + class="enumerate" id="x1-5063x5"> + <!--l. 1238--><p class="noindent" >Run <span class="cmtt-10">makeglossaries</span><a id="dx1-5064"></a> with the base name of the document (omitting the <span @@ -2395,9 +2436,10 @@ class="cmtt-10">.tex </span>extension). If you have access to a terminal or a co - <div class="verbatim" id="verbatim-52"> +</p> + <pre class="verbatim" id="verbatim-52"> makeglossaries myDoc -</div> +</pre> <!--l. 1245--><p class="nopar" > (Replace <span class="cmtt-10">myDoc </span>with the base name of your LaTeX document file without the <span @@ -2415,14 +2457,16 @@ class="cmtt-10">order=letter </span>package </p> - <div class="verbatim" id="verbatim-53"> + <pre class="verbatim" id="verbatim-53"> \usepackage[xindy,order=letter]{glossaries} -</div> +</pre> <!--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 +<li + class="enumerate" id="x1-5067x6"> + <!--l. 1261--><p class="noindent" >Once you have successfully completed the previous step, you can now run LaTeX on your document again. +</p> </li></ol> <!--l. 1265--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): @@ -2430,35 +2474,37 @@ class="cmtt-10">myDoc.tex</span>): </p> - <div class="verbatim" id="verbatim-54"> + <pre class="verbatim" id="verbatim-54"> \documentclass{article} -  <br />\usepackage[xindy]{glossaries} -  <br />\makeglossaries % create xindy files -  <br />\newglossaryentry{sample}{name={sample}, -  <br />  description={an example}} -  <br />\begin{document} -  <br />A \gls{sample}. -  <br />\printglossaries % input files created by xindy -  <br />\end{document} -</div> + \usepackage[xindy]{glossaries} + \makeglossaries % create xindy files + \newglossaryentry{sample}{name={sample}, +   description={an example}} + \begin{document} + A \gls{sample}. + \printglossaries % input files created by xindy + \end{document} +</pre> <!--l. 1281--><p class="nopar" > Document build: </p> - <div class="verbatim" id="verbatim-55"> + <pre class="verbatim" id="verbatim-55"> pdflatex myDoc -  <br />makeglossaries myDoc -  <br />pdflatex myDoc -</div> + makeglossaries myDoc + pdflatex myDoc +</pre> <!--l. 1287--><p class="nopar" > </p></dd><dt class="description"> - </dt><dd -class="description"><a + <!--l. 1289--><p class="noindent" > + </p></dt><dd +class="description"> + <!--l. 1289--><p class="noindent" ><a id="option4"></a><span class="cmbx-10">Option</span><span class="cmbx-10"> 4</span>: - <!--l. 1291--><p class="noindent" >This requires the extension package <span + </p><!--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 @@ -2480,8 +2526,9 @@ class="cmtt-10">\printunsrtglossary </span>to class="cmtt-10">\printunsrtglossaries </span>to display them all). </p><ol class="enumerate1" > - <li - class="enumerate" id="x1-5071x1">Add the <span +<li + class="enumerate" id="x1-5071x1"> + <!--l. 1306--><p class="noindent" >Add the <span class="cmss-10">record</span><a id="dx1-5072"></a> option to the <span class="cmss-10">glossaries-extra</span><a @@ -2489,14 +2536,16 @@ class="cmss-10">glossaries-extra</span><a - <div class="verbatim" id="verbatim-56"> +</p> + <pre class="verbatim" id="verbatim-56"> \usepackage[record]{glossaries-extra} -</div> +</pre> <!--l. 1310--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-5075x2">Add one or more - <!--l. 1314--><p class="noindent" ><hr><div title="Definition"><span +<li + class="enumerate" id="x1-5075x2"> + <!--l. 1312--><p class="noindent" >Add one or more + </p><!--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 @@ -2512,34 +2561,34 @@ class="cmtt-10">.bib </span>files containing the </p> - <div class="verbatim" id="verbatim-57"> + <pre class="verbatim" id="verbatim-57"> \usepackage[record,% using bib2gls -  <br /> abbreviations, -  <br /> symbols, -  <br /> numbers -  <br />]{glossaries-extra} -  <br />\GlsXtrLoadResources[ -  <br />  src={terms},% entries in terms.bib -  <br />  type=main,% put these entries in the 'main' (default) list -  <br />  sort={de-CH-1996}% sort according to this locale -  <br />] -  <br />\GlsXtrLoadResources[ -  <br />  src={abbrvs},% entries in abbrvs.bib -  <br />  type=abbreviations,% put these entries in the 'abbreviations' list -  <br />  sort={letter-case}% case-sensitive letter (non-locale) sort -  <br />] -  <br />\GlsXtrLoadResources[ -  <br />  src={syms},% entries in syms.bib -  <br />  type=symbols,% put these entries in the 'symbols' list -  <br />  sort={use}% sort according to first use in the document -  <br />] -  <br />\GlsXtrLoadResources[ -  <br />  src={constants},% entries in constants.bib -  <br />  type=numbers,% put these entries in the 'numbers' list -  <br />  sort-field={user1},% sort according to this field -  <br />  sort={double}% double-precision sort -  <br />] -</div> +  abbreviations, +  symbols, +  numbers + ]{glossaries-extra} + \GlsXtrLoadResources[ +   src={terms},% entries in terms.bib +   type=main,% put these entries in the 'main' (default) list +   sort={de-CH-1996}% sort according to this locale + ] + \GlsXtrLoadResources[ +   src={abbrvs},% entries in abbrvs.bib +   type=abbreviations,% put these entries in the 'abbreviations' list +   sort={letter-case}% case-sensitive letter (non-locale) sort + ] + \GlsXtrLoadResources[ +   src={syms},% entries in syms.bib +   type=symbols,% put these entries in the 'symbols' list +   sort={use}% sort according to first use in the document + ] + \GlsXtrLoadResources[ +   src={constants},% entries in constants.bib +   type=numbers,% put these entries in the 'numbers' list +   sort-field={user1},% sort according to this field +   sort={double}% double-precision sort + ] +</pre> <!--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 @@ -2549,18 +2598,19 @@ class="cmtt-10">user1 </span>field. For </p> - <div class="verbatim" id="verbatim-58"> + <pre class="verbatim" id="verbatim-58"> @number{pi, -  <br />  name={\ensuremath{\pi}}, -  <br />  description={pi}, -  <br />  user1={3.141592654} -  <br />} -</div> +   name={\ensuremath{\pi}}, +   description={pi}, +   user1={3.141592654} + } +</pre> <!--l. 1357--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-5077x3">Put - <!--l. 1361--><p class="noindent" ><hr><div title="Definition"><span +<li + class="enumerate" id="x1-5077x3"> + <!--l. 1359--><p class="noindent" >Put + </p><!--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 @@ -2577,8 +2627,9 @@ class="cmtt-10">\GlsXtrLoadResources</span> class="cmtt-10">\printunsrtglossaries </span></div><hr> </p><!--l. 1369--><p class="noindent" > </p></li> - <li - class="enumerate" id="x1-5079x4">Run LaTeX on your document. The <span +<li + class="enumerate" id="x1-5079x4"> + <!--l. 1371--><p class="noindent" >Run LaTeX on your document. The <span class="cmss-10">record</span><a id="dx1-5080"></a> option adds information to the <span @@ -2590,76 +2641,80 @@ class="cmtt-10">myDoc.tex</span>: - <div class="verbatim" id="verbatim-59"> +</p> + <pre class="verbatim" id="verbatim-59"> pdflatex myDoc -</div> +</pre> <!--l. 1377--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-5083x5">Run <span +<li + class="enumerate" id="x1-5083x5"> + <!--l. 1379--><p class="noindent" >Run <span class="cmtt-10">bib2gls</span><a id="dx1-5084"></a> - <div class="verbatim" id="verbatim-60"> +</p> + <pre class="verbatim" id="verbatim-60"> bib2gls myDoc -</div> +</pre> <!--l. 1382--><p class="nopar" > or (if you need letter groups) </p> - <div class="verbatim" id="verbatim-61"> + <pre class="verbatim" id="verbatim-61"> bib2gls --group myDoc -</div> +</pre> <!--l. 1386--><p class="nopar" > </p></li> - <li - class="enumerate" id="x1-5086x6">Run LaTeX again.</li></ol> +<li + class="enumerate" id="x1-5086x6"> + <!--l. 1388--><p class="noindent" >Run LaTeX again.</p></li></ol> <!--l. 1390--><p class="noindent" >Here’s a complete document (<span class="cmtt-10">myDoc.tex</span>): </p> - <div class="verbatim" id="verbatim-62"> + <pre class="verbatim" id="verbatim-62"> \documentclass{article} -  <br />\usepackage[record]{glossaries-extra} -  <br />\GlsXtrLoadResources % input file created by bib2gls -  <br /> [% instructions to bib2gls: -  <br />   src={entries}, % terms defined in entries.bib -  <br />   sort={en-GB}% sort according to this locale -  <br /> ] -  <br />\newglossaryentry{sample}{name={sample}, -  <br />  description={an example}} -  <br />\begin{document} -  <br />A \gls{sample}. -  <br />\printunsrtglossaries % iterate over all defined entries -  <br />\end{document} -</div> + \usepackage[record]{glossaries-extra} + \GlsXtrLoadResources % input file created by bib2gls +  [% instructions to bib2gls: +    src={entries}, % terms defined in entries.bib +    sort={en-GB}% sort according to this locale +  ] + \newglossaryentry{sample}{name={sample}, +   description={an example}} + \begin{document} + A \gls{sample}. + \printunsrtglossaries % iterate over all defined entries + \end{document} +</pre> <!--l. 1410--><p class="nopar" > The accompanying <span class="cmtt-10">entries.bib </span>file: </p> - <div class="verbatim" id="verbatim-63"> + <pre class="verbatim" id="verbatim-63"> @entry{sample, -  <br />  name = {sample}, -  <br />  description = {an example} -  <br />} -</div> +   name = {sample}, +   description = {an example} + } +</pre> <!--l. 1417--><p class="nopar" > Document build: </p> - <div class="verbatim" id="verbatim-64"> + <pre class="verbatim" id="verbatim-64"> pdflatex myDoc -  <br />bib2gls myDoc -  <br />pdflatex myDoc -</div> + bib2gls myDoc + pdflatex myDoc +</pre> <!--l. 1423--><p class="nopar" > </p> </dd></dl> @@ -2678,22 +2733,22 @@ class="cmtt-10">myDoc.tex </span>might start with: </p> - <div class="verbatim" id="verbatim-65"> + <pre class="verbatim" id="verbatim-65">  % arara: pdflatex - <br /> % arara: makeglossaries - <br /> % arara: pdflatex - <br /> \documentclass{article} - <br /> \usepackage{glossaries} - <br /> \makeglossaries -</div> + % arara: makeglossaries + % arara: pdflatex + \documentclass{article} + \usepackage{glossaries} + \makeglossaries +</pre> <!--l. 1440--><p class="nopar" > then to build the document you just need the single system call: </p> - <div class="verbatim" id="verbatim-66"> + <pre class="verbatim" id="verbatim-66">  arara myDoc -</div> +</pre> <!--l. 1444--><p class="nopar" > (As from version 4.0, <span class="cmtt-10">arara</span><a id="dx1-5090"></a> also has directives for <span @@ -2713,70 +2768,77 @@ earlier definition: </p> - <div class="verbatim" id="verbatim-67"> + <pre class="verbatim" id="verbatim-67">  \newglossaryentry{elite} - <br /> { - <br />   name={{\'e}lite}, - <br />   description={select group or class} - <br /> } -</div> + { +   name={{\'e}lite}, +   description={select group or class} + } +</pre> <!--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 is interpreted depends on which option you have used: </p><dl class="description"><dt class="description"> + <!--l. 1464--><p class="noindent" > <a href="#option1"><span class="cmbx-10">Option</span><span class="cmbx-10"> 1</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description">By default, the accent command will be stripped so the sort value - will be <span -class="cmtt-10">elite</span>. This will put the entry in the “E” letter group. However - if you use the <span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1464--><p class="noindent" >By default, the accent command will be stripped so the sort value will be + <span +class="cmtt-10">elite</span>. This will put the entry in the “E” letter group. However if you use + the <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-5094"></a> package option, the sort value will be - interpreted as the sequence of characters: <span class="obeylines-h"><span class="verb"><span + id="dx1-5094"></a> package option, the sort value will be interpreted as + the sequence of characters: <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{</span></span></span> <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\</span></span></span> <span class="cmtt-10">’ e </span><span class="obeylines-h"><span class="verb"><span class="cmtt-10">}</span></span></span> <span class="cmtt-10">l i t </span>and <span -class="cmtt-10">e</span>. This will - place this entry in the “symbols” group since it starts with a symbol. - </dd><dt class="description"> +class="cmtt-10">e</span>. This will place this entry + in the “symbols” group since it starts with a symbol. + </p></dd><dt class="description"> + <!--l. 1472--><p class="noindent" > <a href="#option2"><span class="cmbx-10">Option</span><span class="cmbx-10"> 2</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description">The sort key will be interpreted the sequence of characters: <span class="obeylines-h"><span class="verb"><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1472--><p class="noindent" >The sort key will be interpreted the sequence of characters: <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{</span></span></span> <span class="obeylines-h"><span class="verb"><span class="cmtt-10">\</span></span></span> <span class="obeylines-h"><span class="verb"><span class="cmtt-10">’</span></span></span> <span -class="cmtt-10">e</span> - <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">}</span></span></span><span -class="cmtt-10">lit </span>and <span +class="cmtt-10">e </span><span class="obeylines-h"><span class="verb"><span +class="cmtt-10">}</span></span></span> <span +class="cmtt-10">l i</span> + <span +class="cmtt-10">t </span>and <span class="cmtt-10">e</span>. The first character is an opening curly brace <span class="obeylines-h"><span class="verb"><span class="cmtt-10">{</span></span></span> so <span class="cmtt-10">makeindex</span><a - id="dx1-5095"></a> - will put this entry in the “symbols” group. - </dd><dt class="description"> + id="dx1-5095"></a> will + put this entry in the “symbols” group. + </p></dd><dt class="description"> + <!--l. 1478--><p class="noindent" > <a href="#option3"><span class="cmbx-10">Option</span><span class="cmbx-10"> 3</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1478--><p class="noindent" ><span class="cmtt-10">xindy</span><a 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 +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 @@ -2786,7 +2848,7 @@ class="cmtt-10">sort </span>value that <span class="cmtt-10">xindy</span><a id="dx1-5098"></a> will accept. - <!--l. 1485--><p class="noindent" ><div class="important" title="Important Note"> <span + </p><!--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 @@ -2797,12 +2859,17 @@ class="cmtt-10">xindy</span><a has stripped all commands and braces. </div> </p><!--l. 1490--><p class="noindent" > </p></dd><dt class="description"> + + + + <!--l. 1492--><p class="noindent" > <a href="#option4"><span class="cmbx-10">Option</span><span class="cmbx-10"> 4</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1492--><p class="noindent" ><span class="cmtt-10">bib2gls</span><a 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 @@ -2814,14 +2881,11 @@ class="cmtt-10">lite</span>. It disregards unknown class="cmtt-10">bib2gls</span><a id="dx1-5103"></a> doesn’t mind that. - <!--l. 1499--><p class="noindent" >Note that even if the name is given as <span class="obeylines-h"><span class="verb"><span + </p><!--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 É depending on the locale used by the sort comparator. In this case you - - - will need to ensure the document can support this character either with <span class="cmss-10">inputenc</span><a @@ -2841,9 +2905,9 @@ class="cmss-10">inputenc</span><a </p> - <div class="verbatim" id="verbatim-68"> + <pre class="verbatim" id="verbatim-68">  \usepackage[utf8]{inputenc} -</div> +</pre> <!--l. 1516--><p class="nopar" > and the entry is defined as: </p><div class="alltt"> <div class="obeylines-v"> <span @@ -2873,59 +2937,70 @@ class="cmtt-10">}</span></span> </div> </div> then: <dl class="description"><dt class="description"> + <!--l. 1527--><p class="noindent" > <a href="#option1"><span class="cmbx-10">Option</span><span class="cmbx-10"> 1</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description">By default the sort value will be interpreted as <span -class="cmtt-10">elite </span>so the entry - will be put in the “E” letter group. If you use the <span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1527--><p class="noindent" >By default the sort value will be interpreted as <span +class="cmtt-10">elite </span>so the entry will be + put in the “E” letter group. If you use the <span class="cmss-10">sanitizesort</span><span class="cmtt-10">=</span><span class="cmss-10">true</span><a - id="dx1-5107"></a> package - option, the sort value will be interpreted as <span + 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 - sanitized (so it’s no longer an active character and is in fact seen as two - octets 0xC3 0xA9) which will put this entry before the “A” letter group. - (The group is determined by the first octet 0xC3.) - </dd><dt class="description"> +class="cmtt-10">lite </span>where é has been sanitized + (so it’s no longer an active character and is in fact seen as two octets 0xC3 + 0xA9) which will put this entry before the “A” letter group. (The group + is determined by the first octet 0xC3.) + </p></dd><dt class="description"> + <!--l. 1536--><p class="noindent" > <a href="#option2"><span class="cmbx-10">Option</span><span class="cmbx-10"> 2</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1536--><p class="noindent" ><span class="cmtt-10">makeindex</span><a - id="dx1-5108"></a> sees <span -class="cmtt-10">é</span> as two octets (0xC3 0xA9) rather than a single + 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 class="cmtt-10">lite </span>in the 0xC3 (“Ô) letter group (which, in this case, comes after “Z”). - </dd><dt class="description"> + </p></dd><dt class="description"> + <!--l. 1541--><p class="noindent" > <a href="#option3"><span class="cmbx-10">Option</span><span class="cmbx-10"> 3</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description"><span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1541--><p class="noindent" ><span class="cmtt-10">xindy</span><a 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. - (In English, this would just be the “E” letter group, but another language +class="cmtt-10">lite </span>and will place it in + whatever letter group is appropriate for the given language setting. (In + English, this would just be the “E” letter group, but another language might put it in the “É” letter group.) - </dd><dt class="description"> + + + + </p></dd><dt class="description"> + <!--l. 1547--><p class="noindent" > <a href="#option4"><span class="cmbx-10">Option</span><span class="cmbx-10"> 4</span></a><span -class="cmbx-10">:</span> </dt><dd -class="description">The <span +class="cmbx-10">:</span> </p></dt><dd +class="description"> + <!--l. 1547--><p class="noindent" >The <span class="cmss-10">inputenc</span><a id="dx1-5110"></a> package doesn’t affect the encoding used with <span class="cmtt-10">.bib </span>entry @@ -2936,15 +3011,12 @@ class="cmtt-10">.bib </span>file class="cmtt-10">bib2gls</span><a 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"> +class="cmtt-10">.bib </span>file: </p><div class="alltt"> <div class="obeylines-v"> <span class="cmtt-10">%</span><span class="cmtt-10"> Encoding:</span><span class="cmtt-10"> UTF-8</span> - - - </div> </div> <!--l. 1556--><p class="noindent" >With the correct encoding set up, <span @@ -2984,14 +3056,14 @@ this: </p> - <div class="verbatim" id="verbatim-69"> + <pre class="verbatim" id="verbatim-69"> \newglossaryentry{elite} - <br />{ - <br />  name={{\'e}lite}, - <br />  sort={elite}, - <br />  description={select group or class} - <br />} -</div> +{ +  name={{\'e}lite}, +  sort={elite}, +  description={select group or class} +} +</pre> <!--l. 1577--><p class="nopar" > or </p><div class="alltt"> <div class="obeylines-v"> <span @@ -3051,10 +3123,10 @@ example: </p> - <div class="verbatim" id="verbatim-70"> + <pre class="verbatim" id="verbatim-70">  \newglossaryentry{P}{name={\P},sort={P}, - <br />  description={paragraph symbol}} -</div> +  description={paragraph symbol}} +</pre> <!--l. 1598--><p class="nopar" > </p> <!--l. 1600--><p class="noindent" ><a @@ -3073,9 +3145,9 @@ class="cmtt-10">\glsnamefont</span>: </p> - <div class="verbatim" id="verbatim-71"> + <pre class="verbatim" id="verbatim-71"> \renewcommand*{\glsnamefont}[1]{\textmd{#1}} -</div> +</pre> <!--l. 1610--><p class="nopar" > Some classes and packages redefine the <span class="cmss-10">description</span><a id="dx1-6003"></a><a @@ -3094,18 +3166,18 @@ option: </p> - <div class="verbatim" id="verbatim-72"> + <pre class="verbatim" id="verbatim-72"> \usepackage[nopostdot]{glossaries} -</div> +</pre> <!--l. 1621--><p class="nopar" > or to add it with <span class="cmss-10">glossaries-extra</span>: </p> - <div class="verbatim" id="verbatim-73"> + <pre class="verbatim" id="verbatim-73"> \usepackage[postdot]{glossaries-extra} -</div> +</pre> <!--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 @@ -3117,31 +3189,32 @@ Options <a href="#option2">2</a> or <a href="#option3">3</a> described in <a href="#sec:printglossaries"><span -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 +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:printglossaries </a><a +href="#sec:printglossaries">Displaying a List of Entries<!--tex4ht:ref: sec:printglossaries --></a> or +<a +href="#option4">Option 4</a> (with <span class="cmtt-10">bib2gls</span><a id="dx1-6008"></a> and <span class="cmss-10">glossaries-extra</span><a - id="dx1-6009"></a>) then location ranges will be compressed. For example, if -an entry was used on pages 1, 2 and 3, with Options <a -href="#option2">2</a> or <a + id="dx1-6009"></a>) then location ranges will be +compressed. For example, if an entry was used on pages 1, 2 and 3, with Options <a +href="#option2">2</a> +or <a href="#option3">3</a> or <a -href="#option4">Option 4</a> the -location list will appear as 1–3, but with <a -href="#option1">Option 1</a> it will appear as 1, 2, 3. If you -don’t want the locations displayed you can hide them using the <span +href="#option4">Option 4</a> the location list will appear as 1–3, but with <a +href="#option1">Option 1</a> it will +appear as 1, 2, 3. If you don’t want the locations displayed you can hide them using +the <span class="cmss-10">nonumberlist</span><a - id="dx1-6010"></a> package -option: + id="dx1-6010"></a> package option: </p> - <div class="verbatim" id="verbatim-74"> + <pre class="verbatim" id="verbatim-74"> \usepackage[nonumberlist]{glossaries} -</div> +</pre> <!--l. 1639--><p class="nopar" > or with <span class="cmtt-10">bib2gls</span><a id="dx1-6011"></a> use <span @@ -3160,9 +3233,9 @@ option: </p> - <div class="verbatim" id="verbatim-75"> + <pre class="verbatim" id="verbatim-75"> \usepackage[nogroupskip]{glossaries} -</div> +</pre> <!--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: @@ -3180,9 +3253,9 @@ a style that suits your document. For example: </p> - <div class="verbatim" id="verbatim-76"> + <pre class="verbatim" id="verbatim-76"> \setglossarystyle{index} -</div> +</pre> <!--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: @@ -3190,14 +3263,15 @@ class="cmss-10">style</span><a </p> - <div class="verbatim" id="verbatim-77"> + <pre class="verbatim" id="verbatim-77"> \usepackage[style=index]{glossaries} -</div> +</pre> <!--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 +<li + class="enumerate" id="x1-6015x1"> + <!--l. 1674--><p class="noindent" >You have entries where the name is a symbol and the description is a brief phrase or short sentence. Try one of the “mcol” styles defined in the <span class="cmss-10">glossary-mcols</span><a @@ -3205,60 +3279,65 @@ class="cmss-10">glossary-mcols</span><a - <div class="verbatim" id="verbatim-78"> +</p> + <pre class="verbatim" id="verbatim-78"> \usepackage[nopostdot]{glossaries} -  <br />\usepackage{glossary-mcols} -  <br />\setglossarystyle{mcolindex} -</div> + \usepackage{glossary-mcols} + \setglossarystyle{mcolindex} +</pre> <!--l. 1681--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-79"> + <pre class="verbatim" id="verbatim-79"> \usepackage[stylemods={mcols},style=mcolindex]{glossaries-extra} -</div> +</pre> <!--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 +<li + class="enumerate" id="x1-6018x2"> + <!--l. 1687--><p class="noindent" >You have entries where the name is a word or phrase and the description spans multiple paragraphs. Try one of the “altlist” styles. For example: - <div class="verbatim" id="verbatim-80"> +</p> + <pre class="verbatim" id="verbatim-80"> \usepackage[nopostdot]{glossaries} -  <br />\setglossarystyle{altlist} -</div> + \setglossarystyle{altlist} +</pre> <!--l. 1693--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-81"> + <pre class="verbatim" id="verbatim-81"> \usepackage[stylemods,style=altlist]{glossaries-extra} -</div> +</pre> <!--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 +<li + class="enumerate" id="x1-6020x3"> + <!--l. 1699--><p class="noindent" >You have entries where the name is a single word, the description is brief, and an associated symbol has been set. Use one of the styles that display the symbol (not all of them do). For example, one of the tabular styles: - <div class="verbatim" id="verbatim-82"> +</p> + <pre class="verbatim" id="verbatim-82"> \usepackage[nopostdot,nonumberlist,style=long4col]{glossaries} -</div> +</pre> <!--l. 1705--><p class="nopar" > or one of the “tree” styles: </p> - <div class="verbatim" id="verbatim-83"> + <pre class="verbatim" id="verbatim-83"> \usepackage[nopostdot,nonumberlist,style=tree]{glossaries} -</div> +</pre> <!--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 @@ -3269,19 +3348,19 @@ style: </p> - <div class="verbatim" id="verbatim-84"> + <pre class="verbatim" id="verbatim-84"> \setacronymstyle{long-short-desc} -</div> +</pre> <!--l. 1718--><p class="nopar" > Define the acronyms with a description: </p> - <div class="verbatim" id="verbatim-85"> + <pre class="verbatim" id="verbatim-85"> \newacronym - <br /> [description={statistical pattern recognition technique}] - <br /> {svm}{SVM}{support vector machine} -</div> + [description={statistical pattern recognition technique}] + {svm}{SVM}{support vector machine} +</pre> <!--l. 1724--><p class="nopar" > Alternatively with <span class="cmss-10">glossaries-extra</span><a id="dx1-6021"></a>: @@ -3289,21 +3368,21 @@ class="cmss-10">glossaries-extra</span><a </p> - <div class="verbatim" id="verbatim-86"> + <pre class="verbatim" id="verbatim-86"> \setabbreviationstyle{long-short-desc} - <br />\newabbreviation - <br /> [description={statistical pattern recognition technique}] - <br /> {svm}{SVM}{support vector machine} -</div> +\newabbreviation + [description={statistical pattern recognition technique}] + {svm}{SVM}{support vector machine} +</pre> <!--l. 1732--><p class="nopar" > </p><!--l. 1734--><p class="indent" > Choose a glossary style that suits wide entry names. For example: </p> - <div class="verbatim" id="verbatim-87"> + <pre class="verbatim" id="verbatim-87"> \setglossarystyle{altlist} -</div> +</pre> <!--l. 1737--><p class="nopar" > </p><!--l. 1739--><p class="noindent" > </p> @@ -3316,12 +3395,13 @@ class="cmss-10">glossaries</span><a class="cmtt-10">main </span>glossary. When you define an entry (using one of the commands described in <a href="#sec:defterm"><span -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: +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:defterm </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. 1749--><p class="indent" > <hr><div title="Definition"><span class="cmtt-10">\newglossary[</span>⟨<span class="cmitt-10">glg</span>⟩<span @@ -3343,25 +3423,27 @@ argument ⟨<span class="cmti-10">title</span>⟩ is the section or chapter heading used by <span class="cmtt-10">\printglossary </span>or <span -class="cmtt-10">\printnoidxglossary</span>. The other arguments indicate the file extensions used by -<span +class="cmtt-10">\printnoidxglossary</span>. The other arguments indicate the file extensions +used by <span class="cmtt-10">makeindex</span><a id="dx1-7002"></a>/<span class="cmtt-10">xindy</span><a id="dx1-7003"></a> (described in <a href="#sec:printglossaries"><span -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 +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:printglossaries </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 class="cmtt-10">bib2gls</span><a - id="dx1-7004"></a> and <span + id="dx1-7004"></a> and +<span 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 aren’t relevant, in which case you may prefer to use the starred version -where you don’t specify the extensions: +class="cmti-10">glo</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 @@ -3393,9 +3475,9 @@ class="cmss-10">acronyms</span><a </p> - <div class="verbatim" id="verbatim-88"> + <pre class="verbatim" id="verbatim-88"> \newglossary[alg]{acronym}{acr}{acn}{\acronymname} -</div> +</pre> <!--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 @@ -3428,10 +3510,10 @@ a list of notation: </p> - <div class="verbatim" id="verbatim-89"> + <pre class="verbatim" id="verbatim-89">  \usepackage[acronyms]{glossaries} - <br /> \newglossary[nlg]{notation}{not}{ntn}{Notation} -</div> + \newglossary[nlg]{notation}{not}{ntn}{Notation} +</pre> <!--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 @@ -3440,36 +3522,36 @@ the preamble. For example: </p> - <div class="verbatim" id="verbatim-90"> + <pre class="verbatim" id="verbatim-90">  \newglossaryentry{gls:set} - <br /> {% This entry goes in the `main' glossary - <br />   name=set, - <br />   description={A collection of distinct objects} - <br /> } - <br /> % This entry goes in the `acronym' glossary: - <br /> \newacronym{svm}{svm}{support vector machine} - <br /> \newglossaryentry{not:set} - <br /> {% This entry goes in the `notation' glossary: - <br />   type=notation, - <br />   name={\ensuremath{\mathcal{S}}}, - <br />   description={A set}, - <br />   sort={S}} -</div> + {% This entry goes in the `main' glossary +   name=set, +   description={A collection of distinct objects} + } + % This entry goes in the `acronym' glossary: + \newacronym{svm}{svm}{support vector machine} + \newglossaryentry{not:set} + {% This entry goes in the `notation' glossary: +   type=notation, +   name={\ensuremath{\mathcal{S}}}, +   description={A set}, +   sort={S}} +</pre> <!--l. 1815--><p class="nopar" > or if you don’t like using <span class="cmtt-10">\ensuremath</span>: </p> - <div class="verbatim" id="verbatim-91"> + <pre class="verbatim" id="verbatim-91">  \newglossaryentry{not:set} - <br /> {% This entry goes in the `notation' glossary: - <br />   type=notation, - <br />   name={$\mathcal{S}$}, - <br />   text={\mathcal{S}}, - <br />   description={A set}, - <br />   sort={S}} -</div> + {% This entry goes in the `notation' glossary: +   type=notation, +   name={$\mathcal{S}$}, +   text={\mathcal{S}}, +   description={A set}, +   sort={S}} +</pre> <!--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 @@ -3506,31 +3588,31 @@ Instead you can assign the entry type with the resource command. For example: </p> - <div class="verbatim" id="verbatim-92"> + <pre class="verbatim" id="verbatim-92">  \usepackage[record,abbreviations,symbols]{glossaries-extra} - <br /> \GlsXtrLoadResources[ - <br />  src={terms}, % entries defined in terms.bib - <br />  type={main}% put in main glossary - <br /> ] - <br /> \GlsXtrLoadResources[ - <br />  src={abbrvs}, % entries defined in abbrvs.bib - <br />  type={abbreviations}% put in abbreviations glossary - <br /> ] - <br /> \GlsXtrLoadResources[ - <br />  src={syms}, % entries defined in syms.bib - <br />  type={symbols}% put in symbols glossary - <br /> ] -</div> + \GlsXtrLoadResources[ +  src={terms}, % entries defined in terms.bib +  type={main}% put in main glossary + ] + \GlsXtrLoadResources[ +  src={abbrvs}, % entries defined in abbrvs.bib +  type={abbreviations}% put in abbreviations glossary + ] + \GlsXtrLoadResources[ +  src={syms}, % entries defined in syms.bib +  type={symbols}% put in symbols glossary + ] +</pre> <!--l. 1861--><p class="nopar" > Later in the document: </p> - <div class="verbatim" id="verbatim-93"> + <pre class="verbatim" id="verbatim-93">  \printunsrtglossary % main - <br /> \printunsrtglossary[type=abbreviations] - <br /> \printunsrtglossary[type=symbols] -</div> + \printunsrtglossary[type=abbreviations] + \printunsrtglossary[type=symbols] +</pre> <!--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: @@ -3598,35 +3680,39 @@ class="cmtt-10">notation</span>), specified using: </p> - <div class="verbatim" id="verbatim-94"> + <pre class="verbatim" id="verbatim-94"> \usepackage[acronyms]{glossaries} - <br />\newglossary[nlg]{notation}{not}{ntn}{Notation} -</div> +\newglossary[nlg]{notation}{not}{ntn}{Notation} +</pre> <!--l. 1904--><p class="nopar" > Then (assuming your LaTeX document is in a file called <span class="cmtt-10">myDoc.tex</span>): </p><!--l. 1908--><p class="indent" > </p><dl class="description"><dt class="description"> - </dt><dd -class="description"><a + <!--l. 1909--><p class="noindent" > + </p></dt><dd +class="description"> + <!--l. 1909--><p class="noindent" ><a href="#option2">Option 2</a> Either use one <span class="cmtt-10">makeglossaries</span><a id="dx1-7023"></a> or <span class="cmtt-10">makeglossaries-lite</span><a - id="dx1-7024"></a> call: + id="dx1-7024"></a> + call: - <div class="verbatim" id="verbatim-95"> +</p> + <pre class="verbatim" id="verbatim-95"> makeglossaries myDoc -</div> +</pre> <!--l. 1914--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-96"> + <pre class="verbatim" id="verbatim-96"> makeglossaries-lite myDoc -</div> +</pre> <!--l. 1918--><p class="nopar" > Or you need to run <span class="cmtt-10">makeindex</span><a id="dx1-7025"></a> three times: @@ -3634,24 +3720,27 @@ class="cmtt-10">makeindex</span><a </p> - <div class="verbatim" id="verbatim-97"> + <pre class="verbatim" id="verbatim-97"> makeindex -t myDoc.glg -s myDoc.ist -o myDoc.gls myDoc.glo -  <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> + makeindex -t myDoc.alg -s myDoc.ist -o myDoc.acr myDoc.acn + makeindex -t myDoc.nlg -s myDoc.ist -o myDoc.not myDoc.ntn +</pre> <!--l. 1924--><p class="nopar" > </p></dd><dt class="description"> - </dt><dd -class="description"><a + <!--l. 1926--><p class="noindent" > + </p></dt><dd +class="description"> + <!--l. 1926--><p class="noindent" ><a href="#option3">Option 3</a> Either use one <span class="cmtt-10">makeglossaries</span><a id="dx1-7026"></a> call: - <div class="verbatim" id="verbatim-98"> +</p> + <pre class="verbatim" id="verbatim-98"> makeglossaries myDoc -</div> +</pre> <!--l. 1930--><p class="nopar" > Or you need to run <span class="cmtt-10">xindy</span><a id="dx1-7027"></a> three times (be careful not to insert line breaks @@ -3660,29 +3749,32 @@ class="cmtt-10">xindy</span><a </p> - <div class="verbatim" id="verbatim-99"> + <pre class="verbatim" id="verbatim-99"> xindy  -L english -C utf8 -I xindy -M myDoc -t myDoc.glg -  <br />-o myDoc.gls myDoc.glo -  <br />xindy  -L english -C utf8 -I xindy -M myDoc -t myDoc.alg -  <br />-o myDoc.acr myDoc.acn -  <br />xindy  -L english -C utf8 -I xindy -M myDoc -t myDoc.nlg -  <br />-o myDoc.not myDoc.ntn -</div> + -o myDoc.gls myDoc.glo + xindy  -L english -C utf8 -I xindy -M myDoc -t myDoc.alg + -o myDoc.acr myDoc.acn + xindy  -L english -C utf8 -I xindy -M myDoc -t myDoc.nlg + -o myDoc.not myDoc.ntn +</pre> <!--l. 1940--><p class="nopar" > </p></dd><dt class="description"> - </dt><dd -class="description"><a + <!--l. 1942--><p class="noindent" > + </p></dt><dd +class="description"> + <!--l. 1942--><p class="noindent" ><a href="#option4">Option 4</a> With <span class="cmtt-10">bib2gls</span><a id="dx1-7028"></a> only one call is required: - <div class="verbatim" id="verbatim-100"> +</p> + <pre class="verbatim" id="verbatim-100"> pdflatex myDoc -  <br />bib2gls --group myDoc -  <br />pdflatex myDoc -</div> + bib2gls --group myDoc + pdflatex myDoc +</pre> <!--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. 1953--><p class="noindent" > @@ -3712,10 +3804,10 @@ class="cmss-10">hyperref</span><a </p> - <div class="verbatim" id="verbatim-101"> + <pre class="verbatim" id="verbatim-101"> \usepackage[colorlinks]{hyperref} - <br />\usepackage{glossaries} -</div> +\usepackage{glossaries} +</pre> <!--l. 1963--><p class="nopar" > If you use <span class="cmss-10">hyperref</span><a id="dx1-8007"></a> make sure you use PDFLaTeX rather than the LaTeX to DVI @@ -3746,11 +3838,11 @@ glossary, then do: </p> - <div class="verbatim" id="verbatim-102"> + <pre class="verbatim" id="verbatim-102"> \usepackage[colorlinks]{hyperref} - <br />\usepackage[acronym,nohypertypes={acronym,notation}]{glossaries} - <br />\newglossary[nlg]{notation}{not}{ntn}{Notation} -</div> +\usepackage[acronym,nohypertypes={acronym,notation}]{glossaries} +\newglossary[nlg]{notation}{not}{ntn}{Notation} +</pre> <!--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 @@ -3763,10 +3855,10 @@ option: </p> - <div class="verbatim" id="verbatim-103"> + <pre class="verbatim" id="verbatim-103"> \usepackage[colorlinks]{hyperref} - <br />\usepackage[hyperfirst=false]{glossaries} -</div> +\usepackage[hyperfirst=false]{glossaries} +</pre> <!--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 @@ -3791,9 +3883,9 @@ class="cmtt-10">\texorpdfstring</span>. For example: </p> - <div class="verbatim" id="verbatim-104"> + <pre class="verbatim" id="verbatim-104"> \section{The \texorpdfstring{\gls{fishage}}{Fish Age}} -</div> +</pre> <!--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 page in your location list. Instead you can @@ -3810,9 +3902,9 @@ For example, the following works: </p> - <div class="verbatim" id="verbatim-105"> + <pre class="verbatim" id="verbatim-105"> \section{The \glsentrytext{fishage}} -</div> +</pre> <!--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 @@ -3822,9 +3914,9 @@ use in section headers. For example: </p> - <div class="verbatim" id="verbatim-106"> + <pre class="verbatim" id="verbatim-106"> \section{The \glsfmttext{fishage}} -</div> +</pre> <!--l. 2025--><p class="nopar" > </p><!--l. 2027--><p class="noindent" > </p> @@ -3842,21 +3934,21 @@ defined. </p> - <div class="verbatim" id="verbatim-107"> + <pre class="verbatim" id="verbatim-107"> \longnewglossaryentry{devonian}{name={Devonian}}% - <br />{% - <br />  The geologic period spanning from the end of the - <br />  Silurian Period to the beginning of the Carboniferous Period. - <br />  This age was known for its remarkable variety of - <br />  fish species. - <br />} - <br />\newglossaryentry{fishage} - <br />{ - <br />  name={Fish Age}, - <br />  description={Common name for the Devonian period}, - <br />  see={devonian} - <br />} -</div> +{% +  The geologic period spanning from the end of the +  Silurian Period to the beginning of the Carboniferous Period. +  This age was known for its remarkable variety of +  fish species. +} +\newglossaryentry{fishage} +{ +  name={Fish Age}, +  description={Common name for the Devonian period}, +  see={devonian} +} +</pre> <!--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 @@ -3868,21 +3960,21 @@ class="cmti-10">label</span>⟩. For example: </p> - <div class="verbatim" id="verbatim-108"> + <pre class="verbatim" id="verbatim-108"> \newglossaryentry{latinalph} - <br />{ - <br />  name={Latin alphabet}, - <br />  description={alphabet consisting of the letters - <br />  a, \ldots, z, A, \ldots, Z}, - <br />  see=[see also]{exlatinalph} - <br />} - <br />\newglossaryentry{exlatinalph} - <br />{ - <br />   name={extended Latin alphabet}, - <br />   description={The Latin alphabet extended to include - <br />   other letters such as ligatures or diacritics.} - <br />} -</div> +{ +  name={Latin alphabet}, +  description={alphabet consisting of the letters +  a, \ldots, z, A, \ldots, Z}, +  see=[see also]{exlatinalph} +} +\newglossaryentry{exlatinalph} +{ +   name={extended Latin alphabet}, +   description={The Latin alphabet extended to include +   other letters such as ligatures or diacritics.} +} +</pre> <!--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 @@ -3891,12 +3983,12 @@ enclose the value in braces. For example: </p> - <div class="verbatim" id="verbatim-109"> + <pre class="verbatim" id="verbatim-109"> \newacronym{ksvm}{ksvm}{kernel support vector machine} - <br />\newacronym - <br /> [see={[see also]{ksvm}}] - <br /> {svm}{svm}{support vector machine} -</div> +\newacronym + [see={[see also]{ksvm}}] + {svm}{svm}{support vector machine} +</pre> <!--l. 2078--><p class="nopar" > The <span class="cmss-10">glossaries-extra</span><a id="dx1-9001"></a> package provides a <span @@ -3912,12 +4004,12 @@ class="cmsy-10">}</span>. For example: </p> - <div class="verbatim" id="verbatim-110"> + <pre class="verbatim" id="verbatim-110"> \newabbreviation{ksvm}{ksvm}{kernel support vector machine} - <br />\newabbreviation - <br /> [seealso={ksvm}] - <br /> {svm}{svm}{support vector machine} -</div> +\newabbreviation + [seealso={ksvm}] + {svm}{svm}{support vector machine} +</pre> <!--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 @@ -3935,22 +4027,22 @@ example: </p> - <div class="verbatim" id="verbatim-111"> + <pre class="verbatim" id="verbatim-111"> \usepackage[record,abbreviations,symbols]{glossaries-extra} - <br />\GlsXtrLoadResources[ - <br /> src={terms}, % entries defined in terms.bib - <br /> type={main}% put in main glossary - <br />] - <br />\GlsXtrLoadResources[ - <br /> src={abbrvs}, % entries defined in abbrvs.bib - <br /> type={abbreviations},% put in abbreviations glossary - <br /> save-locations=false% no number list for these entries - <br />] - <br />\GlsXtrLoadResources[ - <br /> src={syms}, % entries defined in syms.bib - <br /> type={symbols}% put in symbols glossary - <br />] -</div> +\GlsXtrLoadResources[ + src={terms}, % entries defined in terms.bib + type={main}% put in main glossary +] +\GlsXtrLoadResources[ + src={abbrvs}, % entries defined in abbrvs.bib + type={abbreviations},% put in abbreviations glossary + save-locations=false% no number list for these entries +] +\GlsXtrLoadResources[ + src={syms}, % entries defined in syms.bib + type={symbols}% put in symbols glossary +] +</pre> <!--l. 2111--><p class="nopar" > </p><!--l. 2113--><p class="noindent" > </p> @@ -3958,38 +4050,48 @@ example: 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"> - <li class="itemize"><a + <li class="itemize"> + <!--l. 2117--><p class="noindent" ><a 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>. - </li> - <li class="itemize">The main <span + </p></li> + <li class="itemize"> + <!--l. 2119--><p class="noindent" >The main <span class="cmss-10">glossaries</span><a id="dx1-10001"></a> <a href="glossaries-user.html" >user manual</a>. - </li> - <li class="itemize">The <a + </p></li> + <li class="itemize"> + <!--l. 2120--><p class="noindent" >The <a href="http://www.dickimaw-books.com/faqs/glossariesfaq.html" >glossaries FAQ</a>. - </li> - <li class="itemize"><a + </p></li> + <li class="itemize"> + <!--l. 2121--><p class="noindent" ><a href="https://www.dickimaw-books.com/latex/buildglossaries/" >Incorporating makeglossaries or makeglossaries-lite or bib2gls into the document build</a>. - </li> - <li class="itemize">The <a + + + + </p></li> + <li class="itemize"> + <!--l. 2124--><p class="noindent" >The <a href="https://ctan.org/pkg/glossaries-extra" ><span class="cmss-10">glossaries-extra</span></a> package. - </li> - <li class="itemize">The <a + </p></li> + <li class="itemize"> + <!--l. 2125--><p class="noindent" >The <a href="https://ctan.org/pkg/bib2gls" ><span -class="cmtt-10">bib2gls</span></a> application.</li></ul> +class="cmtt-10">bib2gls</span></a> application.</p></li></ul> <!--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 +</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 b3fb491273..f0a162c069 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 c84ff3074e..1eee3c98e9 100644 --- a/macros/latex/contrib/glossaries/glossariesbegin.tex +++ b/macros/latex/contrib/glossaries/glossariesbegin.tex @@ -35,10 +35,10 @@ \texorpdfstring{{\frenchspacing\obeyspaces\ttfamily#1}}{#1}} \newcommand*{\file}[1]{\texorpdfstring{\texttt{#1}}{#1}} -\title{The glossaries package v4.46: +\title{The glossaries package v4.47: a guide for beginners} \author{Nicola L.C. Talbot\\\href{https://www.dickimaw-books.com/}{\nolinkurl{dickimaw-books.com}}} -\date{2020-03-19} +\date{2021-09-20} \ifpdf \externaldocument{glossaries-user} diff --git a/macros/latex/contrib/glossaries/glossary2glossaries.html b/macros/latex/contrib/glossaries/glossary2glossaries.html index 409159bbde..08942de272 100644 --- a/macros/latex/contrib/glossaries/glossary2glossaries.html +++ b/macros/latex/contrib/glossaries/glossary2glossaries.html @@ -6,8 +6,8 @@ > <head><title></title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)" /> -<meta name="originator" content="TeX4ht (http://www.tug.org/tex4ht/)" /> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" /> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)" /> <!-- xhtml,fn-in,css-in,uni-html4,utf8 --> <meta name="src" content="glossary2glossaries.tex" /> @@ -60,15 +60,19 @@ p.indent{text-indent:0;} p + p{margin-top:1em;} p + div, p + pre {margin-top:1em;} div + p, pre + p {margin-top:1em;} +a { overflow-wrap: break-word; word-wrap: break-word; word-break: break-word; hyphens: auto; } @media print {div.crosslinks {visibility:hidden;}} a img { border-top: 0; border-left: 0; border-right: 0; } center { margin-top:1em; margin-bottom:1em; } td center { margin-top:0em; margin-bottom:0em; } .Canvas { position:relative; } img.math{vertical-align:middle;} +div.par-math-display, div.math-display{text-align:center;} li p.indent { text-indent: 0em } li p:first-child{ margin-top:0em; } +li p:first-child{ margin-bottom; } li p:last-child, li div:last-child { margin-bottom:0.5em; } +li p:first-child{ margin-bottom:0; } li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; } .enumerate1 {list-style-type:decimal;} .enumerate2 {list-style-type:lower-alpha;} @@ -82,7 +86,7 @@ div.obeylines-v p { margin-top:0; margin-bottom:0; } td.displaylines {text-align:center; white-space:nowrap;} .centerline {text-align:center;} .rightline {text-align:right;} -div.verbatim {font-family: monospace,monospace; white-space: nowrap; text-align:left; clear:both; } +pre.verbatim {font-family: monospace,monospace; text-align:left; clear:both; } .fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } div.fbox {display:table} div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } @@ -144,6 +148,7 @@ table.pmatrix {width:100%;} span.bar-css {text-decoration:overline;} img.cdots{vertical-align:middle;} .partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;} +.chapterToc a, .chapterToc, .likechapterToc a, .likechapterToc, .appendixToc a, .appendixToc {line-height: 200%; font-weight:bold;} .index-item, .index-subitem, .index-subsubitem {display:block} div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;} div.caption span.id{font-weight: bold; white-space: nowrap; } @@ -152,16 +157,15 @@ p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } .paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} .subparagraphHead, .likesubparagraphHead { font-weight: bold;} -.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;} .verse{white-space:nowrap; margin-left:2em} div.maketitle {text-align:center;} h2.titleHead{text-align:center;} div.maketitle{ margin-bottom: 2em; } div.author, div.date {text-align:center;} div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } -.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } -.abstract p {margin-left:5%; margin-right:5%;} +div.abstract p {margin-left:5%; margin-right:5%;} div.abstract {width:100%;} +.abstracttitle{text-align:center;margin-bottom:1em;} .warningsymbol { color: red; font-weight: bold;} div.important { border : solid red; } div.verbatim { font-family: monospace; white-space: nowrap; text-align:left; clear:both; padding-top: 2ex; padding-bottom: 2ex;} @@ -192,7 +196,7 @@ class="cmr-17">Upgrading from the glossary package to the</span> class="cmr-17">glossaries package</span> </p> <div class="tabular"> <table id="TBL-1" class="tabular" -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" @@ -200,24 +204,23 @@ 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-03-19</span></p></div> +class="cmr-12">2021-09-20</span></p></div> <div class="abstract" > -<div class="center" -> -<!--l. 54--><p class="noindent" > -</p><!--l. 54--><p class="noindent" ><span -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> + <h3 class="abstracttitle"> +<span +class="cmbx-9">Abstract</span> +</h3> + <!--l. 55--><p class="noindent" ><span +class="cmr-9">The purpose of this document is to provide advice if you want to convert</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> +class="cmr-9">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 the</span> <span -class="cmr-9">the replacement </span><span +class="cmr-9">replacement </span><span class="cmss-9">glossaries </span><span class="cmr-9">package.</span> </p> @@ -225,53 +228,53 @@ class="cmr-9">package.</span> <h3 class="likesectionHead"><a id="x1-1000"></a>Contents</h3> <div class="tableofcontents"> - <span class="sectionToc" >1 <a +  <span class="sectionToc" >1 <a href="#whyglossaries" id="QQ2-1-2">Why the Need for a New Package?</a></span> -<br /> <span class="sectionToc" >2 <a +<br />  <span class="sectionToc" >2 <a href="#x1-30002" id="QQ2-1-3">Package Options</a></span> -<br /> <span class="sectionToc" >3 <a +<br />  <span class="sectionToc" >3 <a href="#x1-40003" id="QQ2-1-5">Defining new glossary types</a></span> -<br /> <span class="sectionToc" >4 <a +<br />  <span class="sectionToc" >4 <a href="#x1-50004" id="QQ2-1-6"><span class="cmtt-10">\make</span><span class="cmti-10">glossary name</span></a></span> -<br /> <span class="sectionToc" >5 <a +<br />  <span class="sectionToc" >5 <a href="#x1-60005" id="QQ2-1-7">Storing glossary information</a></span> -<br /> <span class="sectionToc" >6 <a +<br />  <span class="sectionToc" >6 <a href="#x1-70006" id="QQ2-1-8">Adding an entry to the glossary</a></span> -<br />  <span class="subsectionToc" >6.1 <a +<br />   <span class="subsectionToc" >6.1 <a href="#sec:useglosentry" id="QQ2-1-9"><span class="cmtt-10">\useglosentry</span></a></span> -<br />  <span class="subsectionToc" >6.2 <a -href="#x1-90006.2" id="QQ2-1-10"><span -class="cmtt-10">\useGlosentry</span></a></span> -<br />  <span class="subsectionToc" >6.3 <a +<br />   <span class="subsectionToc" >6.2 <a +href="#x1-90006.2" id="QQ2-1-10"><span +class="cmtt-10">\useGlosentry</span></a></span> +<br />   <span class="subsectionToc" >6.3 <a href="#x1-100006.3" id="QQ2-1-11"><span class="cmtt-10">\gls</span></a></span> -<br />  <span class="subsectionToc" >6.4 <a +<br />   <span class="subsectionToc" >6.4 <a href="#sec:csglossary" id="QQ2-1-12"><span class="cmtt-10">\glossary</span></a></span> -<br /> <span class="sectionToc" >7 <a +<br />  <span class="sectionToc" >7 <a href="#x1-120007" id="QQ2-1-13">Acronyms</a></span> -<br />  <span class="subsectionToc" >7.1 <a +<br />   <span class="subsectionToc" >7.1 <a href="#x1-130007.1" id="QQ2-1-14"><span class="cmtt-10">\acrln </span>and <span class="cmtt-10">\acrsh</span></a></span> -<br />  <span class="subsectionToc" >7.2 <a +<br />   <span class="subsectionToc" >7.2 <a href="#x1-140007.2" id="QQ2-1-15"><span class="cmtt-10">\ifacronymfirstuse</span></a></span> -<br />  <span class="subsectionToc" >7.3 <a +<br />   <span class="subsectionToc" >7.3 <a href="#x1-150007.3" id="QQ2-1-16"><span class="cmtt-10">\resetacronym </span>and <span class="cmtt-10">\unsetacronym</span></a></span> -<br /> <span class="sectionToc" >8 <a +<br />  <span class="sectionToc" >8 <a href="#x1-160008" id="QQ2-1-17">Displaying the glossary</a></span> -<br /> <span class="sectionToc" >9 <a +<br />  <span class="sectionToc" >9 <a href="#x1-170009" id="QQ2-1-18">Processing Your Document</a></span> -<br /> <span class="sectionToc" >10 <a +<br />  <span class="sectionToc" >10 <a href="#x1-1800010" id="QQ2-1-19">Troubleshooting</a></span> </div> <!--l. 62--><p class="noindent" > @@ -291,17 +294,25 @@ class="cmss-10">glossaries</span> package: </p> <ul class="itemize1"> - <li class="itemize">you can define irregular plurals; - </li> - <li class="itemize">glossary terms can have an associated symbol in addition to the name and + <li class="itemize"> + <!--l. 76--><p class="noindent" >you can define irregular plurals; + </p></li> + <li class="itemize"> + <!--l. 78--><p class="noindent" >glossary terms can have an associated symbol in addition to the name and description; - </li> - <li class="itemize">new glossary styles are much easier to design; - </li> - <li class="itemize">you can add dictionaries to supply translations for the fixed names used + </p></li> + <li class="itemize"> + <!--l. 81--><p class="noindent" >new glossary styles are much easier to design; + </p></li> + <li class="itemize"> + <!--l. 83--><p class="noindent" >you can add dictionaries to supply translations for the fixed names used in headings and by some of the glossary styles; - </li> - <li class="itemize">you can choose<span class="footnote-mark"><a + + + + </p></li> + <li class="itemize"> + <!--l. 86--><p class="noindent" >you can choose<span class="footnote-mark"><a href="#fn1x0" id="fn1x0-bk"><sup class="textsuperscript">1</sup></a></span><a id="x1-2001f1"></a> between using <span @@ -312,31 +323,40 @@ class="cmtt-10">xindy</span><a class="cmtt-10">xindy</span><a id="dx1-2005"></a> means that: - - - +</p> <ul class="itemize2"> - <li class="itemize">there is much better support for terms containing accented or + <li class="itemize"> + <!--l. 92--><p class="noindent" >there is much better support for terms containing accented or non-Latin characters; - </li> - <li class="itemize">there is support for non-standard location numbers;</li></ul> + </p></li> + <li class="itemize"> + <!--l. 95--><p class="noindent" >there is support for non-standard location numbers;</p></li></ul> </li> - <li class="itemize">you don’t need to remember to escape <span + <li class="itemize"> + <!--l. 98--><p class="noindent" >you don’t need to remember to escape <span class="cmtt-10">makeindex</span><a id="dx1-2006"></a>’s special characters as this is done internally; - </li> - <li class="itemize">hierarchical entries and homographs are + </p></li> + <li class="itemize"> + <!--l. 101--><p class="noindent" >hierarchical entries and homographs are supported;<span class="footnote-mark"><a href="#fn2x0" id="fn2x0-bk"><sup class="textsuperscript">2</sup></a></span><a id="x1-2007f2"></a> - </li> - <li class="itemize">there is better support for cross-referencing glossary entries; - </li> - <li class="itemize">acronyms are just another glossary term which helps to maintain consistency; - </li> - <li class="itemize">different acronym styles are supported. + </p></li> + <li class="itemize"> + <!--l. 104--><p class="noindent" >there is better support for cross-referencing glossary entries; + </p></li> + <li class="itemize"> + <!--l. 106--><p class="noindent" >acronyms are just another glossary term which helps to maintain consistency; + </p></li> + <li class="itemize"> + <!--l. 109--><p class="noindent" >different acronym styles are supported. +</p> </li></ul> + + + <!--l. 113--><p class="noindent" > </p> <!--l. 113--><p class="noindent" ><a @@ -376,7 +396,7 @@ class="cmss-10">glossaries </span>package options</span></div><!--tex4ht:label?: <!--l. 128--><p class="noindent" > </p> <div class="tabular"> <table id="TBL-2" class="tabular" -cellspacing="0" cellpadding="0" + ><colgroup id="TBL-2-1g"><col id="TBL-2-1" /><col id="TBL-2-2" /></colgroup><tr @@ -586,26 +606,26 @@ href="#tab:pkgopt">1<!--tex4ht:ref: tab:pkgopt --></a>. </p> - <div class="verbatim" id="verbatim-1"> + <pre class="verbatim" id="verbatim-1"> \newglossarytype[nlg]{notation}{not}{ntn}[style=long,header] - <br />\newcommand{\notationname}{Index of Notation} -</div> +\newcommand{\notationname}{Index of Notation} +</pre> <!--l. 191--><p class="nopar" > You will need to replace the above two lines with: </p> - <div class="verbatim" id="verbatim-2"> + <pre class="verbatim" id="verbatim-2"> \newglossary[nlg]{notation}{not}{ntn}{Index of Notation} -</div> +</pre> <!--l. 195--><p class="nopar" > in the preamble and </p> - <div class="verbatim" id="verbatim-3"> + <pre class="verbatim" id="verbatim-3"> \setglossarystyle{longheader} -</div> +</pre> <!--l. 199--><p class="nopar" > immediately prior to displaying this glossary. Alternatively, you can specify the style using the <span class="cmss-10">style</span><a @@ -617,9 +637,9 @@ example: </p> - <div class="verbatim" id="verbatim-4"> + <pre class="verbatim" id="verbatim-4"> \printglossary[type=notation,style=longheader] -</div> +</pre> <!--l. 205--><p class="nopar" > </p><!--l. 207--><p class="indent" > Note that the glossary title is no longer specified using <span class="cmtt-10">\</span>⟨<span @@ -666,18 +686,18 @@ document contained the following: </p> - <div class="verbatim" id="verbatim-5"> + <pre class="verbatim" id="verbatim-5"> \makeglossary - <br />\makeacronym -</div> +\makeacronym +</pre> <!--l. 226--><p class="nopar" > then you should replace both lines with the single line: </p> - <div class="verbatim" id="verbatim-6"> + <pre class="verbatim" id="verbatim-6"> \makeglossaries -</div> +</pre> <!--l. 230--><p class="nopar" > </p><!--l. 232--><p class="noindent" > </p> @@ -704,7 +724,8 @@ only used <span class="cmtt-10">\glossary</span><a id="dx1-6006"></a>, then see <a href="#sec:csglossary"><span -class="tcrm-1000">§</span>6.4 </a><a +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:csglossary </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 @@ -789,19 +810,19 @@ internally. For example, if your document contains the following: </p> - <div class="verbatim" id="verbatim-7"> + <pre class="verbatim" id="verbatim-7"> \storeglosentry{card}{name={$"|\mathcal{S}"|$}, - <br />description={The cardinality of the set $\mathcal{S}$}} -</div> +description={The cardinality of the set $\mathcal{S}$}} +</pre> <!--l. 276--><p class="nopar" > then you will need to replace it with: </p> - <div class="verbatim" id="verbatim-8"> + <pre class="verbatim" id="verbatim-8"> \newglossaryentry{card}{name={$|\mathcal{S}|$}, - <br />description={The cardinality of the set $\mathcal{S}$}} -</div> +description={The cardinality of the set $\mathcal{S}$}} +</pre> <!--l. 281--><p class="nopar" > </p><!--l. 283--><p class="indent" > The <span class="cmss-10">format</span><a @@ -930,10 +951,11 @@ class="cmtt-10">}</span> <br /></span> 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 +class="cmti-10">new options</span>⟩ is the same as that given +<a href="#sec:useglosentry"><span -class="tcrm-1000">§</span>6.1 -</a><a +class="tcrm-1000">§</span><span +class="cmbx-10">??</span>sec:useglosentry </a><a href="#sec:useglosentry"><span class="cmtt-10">\useglosentry</span><!--tex4ht:ref: sec:useglosentry --></a>. </p><!--l. 333--><p class="noindent" > @@ -1108,27 +1130,27 @@ class="cmtt-10">\newacronym</span><a </p> - <div class="verbatim" id="verbatim-9"> + <pre class="verbatim" id="verbatim-9"> \newacronym{SVM}{Support Vector Machine}{description=Statistical - <br />pattern recognition technique} -</div> +pattern recognition technique} +</pre> <!--l. 410--><p class="nopar" > Then you would need to first set the style: </p> - <div class="verbatim" id="verbatim-10"> + <pre class="verbatim" id="verbatim-10"> \setacronymstyle{long-short-desc} -</div> +</pre> <!--l. 414--><p class="nopar" > and change the acronym definition to: </p> - <div class="verbatim" id="verbatim-11"> + <pre class="verbatim" id="verbatim-11"> \newacronym[description=Statistical pattern recognition - <br />technique]{svm}{SVM}{Support Vector Machine} -</div> +technique]{svm}{SVM}{Support Vector Machine} +</pre> <!--l. 419--><p class="nopar" > You can then reference the acronym using any of the new referencing commands, such as <span class="cmtt-10">\gls</span><a @@ -1213,11 +1235,11 @@ class="cmss-10">glossary</span></span><span class="obeylines-h"> - <div class="verbatim" id="verbatim-12"> + <pre class="verbatim" id="verbatim-12"> <!--l. 455--><p class="noindent" >\newacronym{SVM}{Support Vector Machine}{description=Statistical </p><!--l. 455--><p class="noindent" >pattern recognition technique} -</p></div> +</p></pre> <!--l. 455--><p class="nopar" > </div><hr> </p><!--l. 456--><p class="noindent" ></p></span> @@ -1227,11 +1249,11 @@ class="cmss-10">glossaries</span></span><span class="obeylines-h"> - <div class="verbatim" id="verbatim-13"> + <pre class="verbatim" id="verbatim-13"> <!--l. 462--><p class="noindent" >\oldacronym{SVM}{Support Vector Machine}{description=Statistical </p><!--l. 462--><p class="noindent" >pattern recognition technique} -</p></div> +</p></pre> <!--l. 462--><p class="nopar" > </div><hr> </p><!--l. 463--><p class="noindent" ></p></span> @@ -1568,36 +1590,36 @@ say: </p> - <div class="verbatim" id="verbatim-14"> + <pre class="verbatim" id="verbatim-14"> \printglossary - <br />\printglossary[acronym] -</div> +\printglossary[acronym] +</pre> <!--l. 601--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-15"> + <pre class="verbatim" id="verbatim-15"> \printglossary - <br />\printacronym -</div> +\printacronym +</pre> <!--l. 606--><p class="nopar" > then you will need to replace this with either </p> - <div class="verbatim" id="verbatim-16"> + <pre class="verbatim" id="verbatim-16"> \printglossaries -</div> +</pre> <!--l. 610--><p class="nopar" > or </p> - <div class="verbatim" id="verbatim-17"> + <pre class="verbatim" id="verbatim-17"> \printglossary - <br />\printglossary[type=\acronymtype] -</div> +\printglossary[type=\acronymtype] +</pre> <!--l. 615--><p class="nopar" > </p><!--l. 617--><p class="indent" > The <span class="cmss-10">glossary </span>package allows you to specify a short title (for the table of contents @@ -1618,9 +1640,9 @@ class="cmtt-10">notation</span>, and you had defined </p> - <div class="verbatim" id="verbatim-18"> + <pre class="verbatim" id="verbatim-18"> \newcommand{\shortnotationname}{Notation} -</div> +</pre> <!--l. 627--><p class="nopar" > then you would need to use the <span class="cmss-10">toctitle</span><a id="dx1-16007"></a> key: @@ -1628,9 +1650,9 @@ class="cmss-10">toctitle</span><a </p> - <div class="verbatim" id="verbatim-19"> + <pre class="verbatim" id="verbatim-19"> \printglossary[type=notation,toctitle=Notation] -</div> +</pre> <!--l. 631--><p class="nopar" > The <span class="cmss-10">glossaries </span>package will ignore <span class="cmtt-10">\shortnotationname</span><a diff --git a/macros/latex/contrib/glossaries/glossary2glossaries.pdf b/macros/latex/contrib/glossaries/glossary2glossaries.pdf Binary files differindex 8c19ab6ef2..f129eb3c65 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 78c5090561..5eff3c4fdd 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-03-19} +\date{2021-09-20} \newenvironment{oldway}{% \begin{labelledbox}{\styfmt{glossary}}\ttfamily\obeylines diff --git a/macros/latex/contrib/glossaries/makeglossaries b/macros/latex/contrib/glossaries/makeglossaries index fe1e1248d9..2d60ff6688 100755 --- a/macros/latex/contrib/glossaries/makeglossaries +++ b/macros/latex/contrib/glossaries/makeglossaries @@ -2,7 +2,7 @@ # File : makeglossaries # Author : Nicola Talbot -# Version : 4.45 +# Version : 4.47 # Description: simple Perl script that calls makeindex or xindy. # Intended for use with "glossaries.sty" (saves having to remember # all the various switches) @@ -31,25 +31,15 @@ # glossaries-babel.sty, glossaries-polyglossia.sty, glossaries.perl. # Also makeglossaries and makeglossaries-lite.lua. -my $version="4.45 (2020-01-18)"; +my $version="4.47 (2021-09-20)"; # History: -# v4.43: -# * No change. -# v4.41: -# * No change. -# v4.40: -# * No change. -# v4.39: -# * No change. -# v4.38: -# * No change. -# v4.37: -# * No change. -# v4.36: -# * No change. -# v4.35: -# * No change. +# v4.47: +# * Added hybrid instructions if record option detected but not +# \makeglossaries +# * Added quote_if_spaced subroutine +# v4.35 - v4.46: +# * No change. (Version number updated in line with glossaries.sty) # v4.34: # * Added check for \glsxtr@resource # v4.33: @@ -350,9 +340,12 @@ unless ($istfile) { if ($foundbib2glsresource) { +# v4.47 added extra hybrid instructions die "Found \\glsxtr\@resource in '$name.aux',\n", "but not found \\\@istfilename.\n", - "You need to run bib2gls not makeglossaries.\n"; + "You need to run bib2gls not makeglossaries.\n", + "If you have used record=alsoindex or record=hybrid\n", + "then add \\makeglossaries to your preamble.\n"; } else { @@ -818,6 +811,21 @@ sub scan_aux{ } } +# v4.47 new +# Issue #129 was specifically about the Lua script but it's +# likely the same problem would occur with this Perl script given +# the same version of cmd.exe +sub quote_if_spaced{ + my ($str) = @_; + + if ($str=~/ /) + { + $str = "\"$str\""; + } + + $str; +} + # v2.01 new subroutine run_app added sub run_app{ my($appname, $appargs, $trans, $quiet, $dontexec) = @_; @@ -833,9 +841,12 @@ sub run_app{ return if ($dontexec); + # v4.47 + my $cmdstr = "e_if_spaced($appname) . " $appargs"; + # v2.11 added double-quotes around $appname # v2.14 added -k switch - if (not $opt_k and open (STATUS, "\"$appname\" $appargs 2>&1 |")) + if (not $opt_k and open (STATUS, "$cmdstr 2>&1 |")) { while (<STATUS>) { @@ -861,7 +872,7 @@ sub run_app{ "Retrying without redirection.\n" unless ($quiet or $opt_Q); } - $status = `\"$appname\" $appargs`; + $status = `$cmdstr`; $log = $status; diff --git a/macros/latex/contrib/glossaries/makeglossaries-lite.1 b/macros/latex/contrib/glossaries/makeglossaries-lite.1 index 5497796c45..4032c86bc4 100644 --- a/macros/latex/contrib/glossaries/makeglossaries-lite.1 +++ b/macros/latex/contrib/glossaries/makeglossaries-lite.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 4.12 (Pod::Simple 3.39) +.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "MAKEGLOSSARIES-LITE 1" -.TH MAKEGLOSSARIES-LITE 1 "2020-03-19" "perl v5.30.1" "makeglossaries-lite Lua Script" +.TH MAKEGLOSSARIES-LITE 1 "2021-09-23" "perl v5.32.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-lite.lua b/macros/latex/contrib/glossaries/makeglossaries-lite.lua index 5e2272ff09..bee21d2cfc 100755 --- a/macros/latex/contrib/glossaries/makeglossaries-lite.lua +++ b/macros/latex/contrib/glossaries/makeglossaries-lite.lua @@ -36,13 +36,13 @@ Also makeglossaries and makeglossaries-lite.lua. History: - * 4.45: - - no change. - * 4.44: - - no change. - * 4.41: - - no change. - * 4.40: + * 4.47: + - Added hybrid instructions if record option detected but not \makeglossaries + - Added extra info to error message on -d + - Fixed bug #183 that occurs when \@istfilename is missing + - Only add double-quotes if text contains any spaces which + may help address issue #129 + * 4.40 - 4.46: - no change. * 4.39: - corrected script name in version and help messages @@ -68,7 +68,7 @@ - changed first line from lua to texlua --]] -thisversion = "4.45 (2020-01-18)" +thisversion = "4.47 (2021-09-20)" quiet = false dryrun = false @@ -163,6 +163,17 @@ function dorun(name, glg, gls, glo, language, codepage) end +-- v4.47 only add double-quotes if text contains any spaces +function quote_if_spaced(str) + + if string.find(str, " ") then + str = '"' .. str .. '"' + end + + return str; + +end + function doxindy(name, glg, gls, glo, language, codepage) if codepage == nil @@ -170,14 +181,14 @@ function doxindy(name, glg, gls, glo, language, codepage) codepage = "utf8" end - cmd = string.format('"%s" -I xindy -L %s -C %s -M "%s" -t "%s" -o "%s"', - xindyexec, language, codepage, styfile, glg, gls) + cmd = string.format('%s -I xindy -L %s -C %s -M %s -t %s -o %s', + quote_if_spaced(xindyexec), language, codepage, quote_if_spaced(styfile), quote_if_spaced(glg), quote_if_spaced(gls)) if letterorder then cmd = string.format('%s -M ord/letorder', cmd) end if quiet then cmd = string.format('%s -q', cmd) end - cmd = string.format('%s "%s"', cmd, glo) + cmd = string.format('%s %s', cmd, quote_if_spaced(glo)) if dryrun then @@ -194,7 +205,7 @@ end function domakeindex(name, glg, gls, glo) - cmd = string.format('"%s"', makeindex_m) + cmd = quote_if_spaced(makeindex_m) if makeindex_c then cmd = cmd .. " -c" end @@ -206,19 +217,19 @@ function domakeindex(name, glg, gls, glo) if quiet then cmd = cmd .. " -q" end - if glg ~= nil then cmd = string.format('%s -t "%s"', cmd, glg) end + if glg ~= nil then cmd = string.format('%s -t %s', cmd, quote_if_spaced(glg)) end - if gls ~= nil then cmd = string.format('%s -o "%s"', cmd, gls) end + if gls ~= nil then cmd = string.format('%s -o %s', cmd, quote_if_spaced(gls)) end if makeindex_p ~= nil then cmd = string.format("%s -p %s", cmd, makeindex_p) end if styfile ~= nil then - cmd = string.format('%s -s "%s"', cmd, styfile) + cmd = string.format('%s -s %s', cmd, quote_if_spaced(styfile)) end - cmd = string.format('%s "%s"', cmd, glo) + cmd = string.format('%s %s', cmd, quote_if_spaced(glo)) if dryrun then print(cmd) @@ -275,7 +286,7 @@ while i <= #arg do elseif arg[i] == "-d" then error(string.format( - "The '%s' option isn't available for this light-weight version.\nYou will need to use the Perl version instead.", + "The '%s' option isn't available for this light-weight version. \n(Lua doesn't natively provide a function to change directory.) \nYou will need to use the Perl version instead \nor just change directory before running this script.", arg[i])) -- Xindy Options @@ -382,15 +393,23 @@ then -- v4.36: corrected check for double-quotes styfile = string.match(aux, "\\@istfilename{([^}]*)}") - styfile = string.gsub(styfile, "\"", ""); + +-- v4.47: added check for null styfile (missing \@istfilename) + if styfile ~= nil + then + styfile = string.gsub(styfile, "\"", ""); + end if styfile == nil then if isbib2gls then +-- v4.47 added extra hybrid instructions error([[ No \@istfilename found but found \glsxtr@resource. You need to run bib2gls not makeglossaries-lite. +If you have used record=alsoindex or record=hybrid +then add \makeglossaries to your preamble. ]]) else error([[ diff --git a/macros/latex/contrib/glossaries/makeglossaries.1 b/macros/latex/contrib/glossaries/makeglossaries.1 index 029cd23a56..00b3dc50c7 100644 --- a/macros/latex/contrib/glossaries/makeglossaries.1 +++ b/macros/latex/contrib/glossaries/makeglossaries.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 4.12 (Pod::Simple 3.39) +.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "MAKEGLOSSARIES 1" -.TH MAKEGLOSSARIES 1 "2020-03-19" "perl v5.30.1" "makeglossaries Perl Script" +.TH MAKEGLOSSARIES 1 "2021-09-23" "perl v5.32.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 4ede660f69..1a65598f02 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 0f9932375f..640631a1eb 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 bc356403a9..33500b13b0 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 1f007570c0..72a102b1a5 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 e965ca4065..f369987cd7 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 7ab3c2b318..5aff90266f 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 eed73e8ade..9e6d071e44 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 c8c6109af8..f3cb6b7e2b 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 431e2b1f12..4a5a72f4b1 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 a133b10a59..c7516f95b5 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 1641d2035a..a3efd9a6ee 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 c0809e795c..df1ff6c742 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 e3cfdc9f90..f2c2bfcfad 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 03b437a0ff..d066d60284 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 0e67c7f41f..11b1229470 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 eaa8b2cdd2..6a9b34124c 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 14a6b5a2f6..e814486676 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 28ac311328..af1555e9ff 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 c93fb606af..cbce49de84 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 509a5f4703..f22c15d4c9 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 683c4ed8f2..573100d011 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 1caec7d491..89136e7228 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 734c0abc0e..06f90a7d64 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 4310008784..437a5ffbc9 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 bf51182aec..b64598dd6d 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 0791bedabb..630fcf10f3 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 5b9c99c628..d556c94e3b 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 96c5e7362b..29e713d287 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 d8ed5cf314..dd7fe8e2c6 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 28ae1c1320..1bd305864b 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 4c3995525e..44ef7fb5be 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 a2118b973b..9e6af363a3 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 0c677ce3ff..bf24d05cad 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 0a649ea48c..e88a539966 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 da5b1210ec..9a4bd3cac5 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 4ea1b17797..aba5a2c89b 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 e8a47def42..6c2291ada3 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 076ad52791..e339d2a91c 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 b8b2b11295..4b56859d0c 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 d06551a306..b7683a71d6 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 d3dcdfada9..916bdd25bc 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 c955313619..0a00240e25 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 dc7db40a49..f04927587e 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 48099f51e5..ce9e4cb360 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 aa19448f78..d99b3536f8 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 6b67853660..1346e57359 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 340c46cd7b..61a1b71e7c 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 acf90a1303..6724b925bd 100644 --- a/macros/latex/contrib/glossaries/samples/samplexdy3.pdf +++ b/macros/latex/contrib/glossaries/samples/samplexdy3.pdf |