texlive[60814] trunk: glossaries (20oct21)
commits+karl at tug.org
commits+karl at tug.org
Wed Oct 20 23:19:03 CEST 2021
Revision: 60814
http://tug.org/svn/texlive?view=revision&revision=60814
Author: karl
Date: 2021-10-20 23:19:03 +0200 (Wed, 20 Oct 2021)
Log Message:
-----------
glossaries (20oct21)
Modified Paths:
--------------
trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries
trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua
trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES
trunk/Master/texmf-dist/doc/latex/glossaries/README.md
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-code.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.tex
trunk/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html
trunk/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.tex
trunk/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.html
trunk/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.tex
trunk/Master/texmf-dist/doc/latex/glossaries/samples/glossary-lipsum-examples.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/minimalgls.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/mwe-acr-desc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/mwe-acr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/mwe-gls.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-FnDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-chap-hyperfirst.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-crossref.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-custom-acronym.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-dot-abbr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-dual.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-entrycount.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-entryfmt.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-font-abbr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-ignored.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-index.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-inline.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-langdict.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-newkeys.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-noidxapp-utf8.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-noidxapp.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-nomathhyper.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-numberlist.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-prefix.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-si.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-storage-abbr-desc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-storage-abbr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample4col.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleAcr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleAcrDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleCustomAcr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleDB.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleEq.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleEqPg.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleFnAcrDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleNtn.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplePeople.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleSec.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleSort.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleaccsupp.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleacronyms.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampletree.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleutf8.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy2.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy3.pdf
trunk/Master/texmf-dist/doc/man/man1/makeglossaries-lite.1
trunk/Master/texmf-dist/doc/man/man1/makeglossaries-lite.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/makeglossaries.1
trunk/Master/texmf-dist/doc/man/man1/makeglossaries.man1.pdf
trunk/Master/texmf-dist/scripts/glossaries/makeglossaries
trunk/Master/texmf-dist/scripts/glossaries/makeglossaries-lite.lua
trunk/Master/texmf-dist/source/latex/glossaries/glossaries.dtx
trunk/Master/texmf-dist/source/latex/glossaries/glossaries.ins
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-babel.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-compatible-207.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-compatible-307.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-polyglossia.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-prefix.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries.sty
trunk/Master/texmf-dist/tex/latex/glossaries/expl/glossaries-accsupp.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-hypernav.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-inline.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-list.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-long.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-longbooktabs.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-longragged.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-mcols.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-super.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-superragged.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-tree.sty
Added Paths:
-----------
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-list-2020-03-19.sty
Modified: trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries
===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2021-10-20 21:18:16 UTC (rev 60813)
+++ trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2021-10-20 21:19:03 UTC (rev 60814)
@@ -2,7 +2,7 @@
# File : makeglossaries
# Author : Nicola Talbot
-# Version : 4.47
+# Version : 4.48
# Description: simple Perl script that calls makeindex or xindy.
# Intended for use with "glossaries.sty" (saves having to remember
# all the various switches)
@@ -31,9 +31,11 @@
# glossaries-babel.sty, glossaries-polyglossia.sty, glossaries.perl.
# Also makeglossaries and makeglossaries-lite.lua.
-my $version="4.47 (2021-09-20)";
+my $version="4.48 (2021-10-19)";
# History:
+# v4.48:
+# * No change. (Version number updated in line with glossaries.sty)
# v4.47:
# * Added hybrid instructions if record option detected but not
# \makeglossaries
Modified: trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua
===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2021-10-20 21:18:16 UTC (rev 60813)
+++ trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2021-10-20 21:19:03 UTC (rev 60814)
@@ -36,6 +36,8 @@
Also makeglossaries and makeglossaries-lite.lua.
History:
+ * 4.48:
+ - no change.
* 4.47:
- Added hybrid instructions if record option detected but not \makeglossaries
- Added extra info to error message on -d
@@ -68,7 +70,7 @@
- changed first line from lua to texlua
--]]
-thisversion = "4.47 (2021-09-20)"
+thisversion = "4.48 (2021-10-19)"
quiet = false
dryrun = false
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES 2021-10-20 21:18:16 UTC (rev 60813)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES 2021-10-20 21:19:03 UTC (rev 60814)
@@ -1,5 +1,25 @@
glossaries change log:
+v4.48 (2021-10-19):
+
+ * glossary-list.sty:
+
+ - bug fix #186: list style with entrycounter has problematic unexpanded content
+ https://www.dickimaw-books.com/bugtracker.php?key=186
+
+ This bug fix adds the following new commands:
+
+ \glslistinit
+ \glslistexpandedname
+
+ * glossaries.sty:
+
+ - new command \glsunexpandedfieldvalue (provided for use in
+ \glslistexpandedname)
+
+ - new command \glscapitalisewords (defaults to \capitalisewords)
+ provides a way to switch to \capitalisefmtwords if required
+
v4.47 (2021-09-20):
* added new files containing dummy entries for testing:
@@ -51,7 +71,7 @@
event that the sort value contains commands like \| or \! with
sanitizesort=true)
- - bug file #177 https://www.dickimaw-books.com/bugtracker.php?key=177
+ - bug fix #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'
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/README.md 2021-10-20 21:18:16 UTC (rev 60813)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/README.md 2021-10-20 21:19:03 UTC (rev 60814)
@@ -1,4 +1,4 @@
-# glossaries v4.47 (2021-09-20)
+# glossaries v4.48 (2021-10-19)
Author: Nicola Talbot ([contact](http://www.dickimaw-books.com/contact))
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-code.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2021-10-20 21:18:16 UTC (rev 60813)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2021-10-20 21:19:03 UTC (rev 60814)
@@ -101,7 +101,6 @@
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; }
@@ -155,6 +154,7 @@
.hline hr, .cline hr{ height : 0px; margin:0px; }
.hline td, .cline td{ padding: 0; }
.hline hr, .cline hr{border:none;border-top:1px solid black;}
+.hline {border-top: 1px solid black;}
.tabbing-right {text-align:right;}
div.float, div.figure {margin-left: auto; margin-right: auto;}
div.float img {text-align:center;}
@@ -216,6 +216,7 @@
.hline hr, .cline hr{ height : 0px; margin:0px; }
.hline td, .cline td{ padding: 0; }
.hline hr, .cline hr{border:none;border-top:1px solid black;}
+.hline {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; font-family:monospace,monospace; }
@@ -1339,7 +1340,7 @@
>
<!--l. 690--><p class="noindent" >
</p><!--l. 690--><p class="noindent" ><span
-class="cmr-17">User Manual for glossaries.sty v4.47</span>
+class="cmr-17">User Manual for glossaries.sty v4.48</span>
</p>
<div class="tabular"> <table id="TBL-1" class="tabular"
@@ -1355,7 +1356,7 @@
class="cmtt-12">dickimaw-books.com/contact</span></a> </td></tr></table>
</div>
<!--l. 690--><p class="noindent" ><span
-class="cmr-12">2021-09-20</span></p></div>
+class="cmr-12">2021-10-19</span></p></div>
<div
class="abstract"
>
@@ -1408,7 +1409,7 @@
class="cmtt-10">glossaries-german</span>. If a language module is required, the <span
class="cmss-10">glossaries</span>
package will automatically try to load it and will give a warning if the module isn’t found. See <a
-href="#sec:languages">§1.3 </a><a
+href="#sec:languages">§1.4 </a><a
href="#sec:languages">Multi-Lingual
Support<!--tex4ht:ref: sec:languages --></a> for further details. If there isn’t any support available for your language, use the <span
class="cmss-10">nolangwarn</span><a
@@ -1499,7 +1500,7 @@
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”.
+class="cmss-10">glossaries </span>bundle should read “Documented Code for glossaries v4.48”.
</p></dd><dt class="description">
<!--l. 780--><p class="noindent" >
<span
@@ -1627,224 +1628,226 @@
id="x1-1000"></a>Contents</h2>
<div class="tableofcontents">
<span class="chapterToc" > <a
-href="#Q1-1-3">Glossary</a></span>
+href="#glossary">Glossary</a></span>
<br /> <span class="chapterToc" >1 <a
href="#sec:intro" id="QQ2-1-5">Introduction</a></span>
<br />  <span class="sectionToc" >1.1 <a
-href="#sec:indexingoptions" id="QQ2-1-6">Indexing Options</a></span>
+href="#sec:rollback" id="QQ2-1-6">Rollback</a></span>
<br />  <span class="sectionToc" >1.2 <a
-href="#sec:lipsum" id="QQ2-1-14">Dummy Entries for Testing</a></span>
+href="#sec:indexingoptions" id="QQ2-1-7">Indexing Options</a></span>
<br />  <span class="sectionToc" >1.3 <a
-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>
+href="#sec:lipsum" id="QQ2-1-15">Dummy Entries for Testing</a></span>
<br />  <span class="sectionToc" >1.4 <a
-href="#sec:makeglossaries" id="QQ2-1-19">Generating the Associated Glossary Files</a></span>
+href="#sec:languages" id="QQ2-1-16">Multi-Lingual Support</a></span>
<br />   <span class="subsectionToc" >1.4.1 <a
-href="#sec:makeglossariesapp" id="QQ2-1-21">Using the makeglossaries Perl Script</a></span>
+href="#sec:fixednames" id="QQ2-1-17">Changing the Fixed Names</a></span>
<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 (Option3)</a></span>
-<br />   <span class="subsectionToc" >1.4.4 <a
-href="#sec:makeindexapp" id="QQ2-1-24">Using makeindex explicitly (Option2)</a></span>
+href="#sec:newlang" id="QQ2-1-19">Creating a New Language Module</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>
+href="#sec:makeglossaries" id="QQ2-1-20">Generating the Associated Glossary Files</a></span>
<br />   <span class="subsectionToc" >1.5.1 <a
-href="#sec:notedev.makeindex.xindy" id="QQ2-1-26">MakeIndex and Xindy</a></span>
+href="#sec:makeglossariesapp" id="QQ2-1-22">Using the makeglossaries Perl Script</a></span>
<br />   <span class="subsectionToc" >1.5.2 <a
-href="#sec:notedev.labels" id="QQ2-1-27">Entry Labels</a></span>
+href="#sec:makeglossarieslua" id="QQ2-1-23">Using the makeglossaries-lite Lua Script</a></span>
<br />   <span class="subsectionToc" >1.5.3 <a
-href="#sec:notedev.bib2gls" id="QQ2-1-28">Bib2Gls</a></span>
+href="#sec:xindyapp" id="QQ2-1-24">Using xindy explicitly (Option 3)</a></span>
+<br />   <span class="subsectionToc" >1.5.4 <a
+href="#sec:makeindexapp" id="QQ2-1-25">Using makeindex explicitly (Option 2)</a></span>
+<br />  <span class="sectionToc" >1.6 <a
+href="#sec:notedev" id="QQ2-1-26">Note to Front-End and Script Developers</a></span>
+<br />   <span class="subsectionToc" >1.6.1 <a
+href="#makeindexandxindy" id="QQ2-1-27">MakeIndex and Xindy</a></span>
+<br />   <span class="subsectionToc" >1.6.2 <a
+href="#entrylabels" id="QQ2-1-28">Entry Labels</a></span>
+<br />   <span class="subsectionToc" >1.6.3 <a
+href="#bib2gls" id="QQ2-1-29">Bib2Gls</a></span>
<br /> <span class="chapterToc" >2 <a
-href="#sec:pkgopts" id="QQ2-1-29">Package Options</a></span>
+href="#sec:pkgopts" id="QQ2-1-30">Package Options</a></span>
<br />  <span class="sectionToc" >2.1 <a
-href="#sec:pkgopts-general" id="QQ2-1-30">General Options</a></span>
+href="#sec:pkgopts-general" id="QQ2-1-31">General Options</a></span>
<br />  <span class="sectionToc" >2.2 <a
-href="#sec:pkgopts-sec" id="QQ2-1-43">Sectioning, Headings and TOC Options</a></span>
+href="#sec:pkgopts-sec" id="QQ2-1-44">Sectioning, Headings and TOC Options</a></span>
<br />  <span class="sectionToc" >2.3 <a
-href="#sec:pkgopts-printglos" id="QQ2-1-49">Glossary Appearance Options</a></span>
+href="#sec:pkgopts-printglos" id="QQ2-1-50">Glossary Appearance Options</a></span>
<br />  <span class="sectionToc" >2.4 <a
-href="#sec:pkgopts-indexing" id="QQ2-1-66">Indexing Options</a></span>
+href="#sec:pkgopts-indexing" id="QQ2-1-67">Indexing Options</a></span>
<br />  <span class="sectionToc" >2.5 <a
-href="#sec:pkgopts-sort" id="QQ2-1-76">Sorting Options</a></span>
+href="#sec:pkgopts-sort" id="QQ2-1-77">Sorting Options</a></span>
<br />  <span class="sectionToc" >2.6 <a
-href="#sec:pkgopts-type" id="QQ2-1-87">Glossary Type Options</a></span>
+href="#sec:pkgopts-type" id="QQ2-1-88">Glossary Type Options</a></span>
<br />  <span class="sectionToc" >2.7 <a
-href="#sec:pkgopts-acronym" id="QQ2-1-94">Acronym and Abbreviation Options</a></span>
+href="#sec:pkgopts-acronym" id="QQ2-1-95">Acronym and Abbreviation Options</a></span>
<br />  <span class="sectionToc" >2.8 <a
-href="#sec:pkgopts-old-acronym" id="QQ2-1-100">Deprecated Acronym Style Options</a></span>
+href="#sec:pkgopts-old-acronym" id="QQ2-1-101">Deprecated Acronym Style Options</a></span>
<br />  <span class="sectionToc" >2.9 <a
-href="#sec:pkgopts-other" id="QQ2-1-106">Other Options</a></span>
+href="#sec:pkgopts-other" id="QQ2-1-107">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>
+href="#sec:setupglossaries" id="QQ2-1-114">Setting Options After the Package is Loaded</a></span>
<br /> <span class="chapterToc" >3 <a
-href="#sec:setup" id="QQ2-1-114">Setting Up</a></span>
+href="#sec:setup" id="QQ2-1-115">Setting Up</a></span>
<br />  <span class="sectionToc" >3.1 <a
-href="#sec:setupopt1" id="QQ2-1-115">Option 1</a></span>
+href="#sec:setupopt1" id="QQ2-1-116">Option 1</a></span>
<br />  <span class="sectionToc" >3.2 <a
-href="#sec:setupopt23" id="QQ2-1-116">Options 2 and 3</a></span>
+href="#sec:setupopt23" id="QQ2-1-117">Options 2 and 3</a></span>
<br /> <span class="chapterToc" >4 <a
-href="#sec:newglosentry" id="QQ2-1-117">Defining Glossary Entries</a></span>
+href="#sec:newglosentry" id="QQ2-1-118">Defining Glossary Entries</a></span>
<br />  <span class="sectionToc" >4.1 <a
-href="#sec:plurals" id="QQ2-1-118">Plurals</a></span>
+href="#sec:plurals" id="QQ2-1-119">Plurals</a></span>
<br />  <span class="sectionToc" >4.2 <a
-href="#sec:grammar" id="QQ2-1-119">Other Grammatical Constructs</a></span>
+href="#sec:grammar" id="QQ2-1-120">Other Grammatical Constructs</a></span>
<br />  <span class="sectionToc" >4.3 <a
-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-121">Document Keys</a></span>
+href="#sec:addkey" id="QQ2-1-121">Additional Keys</a></span>
+<br />   <span class="subsectionToc" >4.3.1 <a
+href="#sec:glsaddkey" id="QQ2-1-122">Document Keys</a></span>
<br />   <span class="subsectionToc" >4.3.2 <a
-href="#sec:glsaddstoragekey" id="QQ2-1-122">Storage Keys</a></span>
+href="#sec:glsaddstoragekey" id="QQ2-1-123">Storage Keys</a></span>
<br />  <span class="sectionToc" >4.4 <a
-href="#sec:expansion" id="QQ2-1-123">Expansion</a></span>
+href="#sec:expansion" id="QQ2-1-124">Expansion</a></span>
<br />  <span class="sectionToc" >4.5 <a
-href="#sec:subentries" id="QQ2-1-125">Sub-Entries</a></span>
+href="#sec:subentries" id="QQ2-1-126">Sub-Entries</a></span>
<br />   <span class="subsectionToc" >4.5.1 <a
-href="#sec:hierarchical" id="QQ2-1-126">Hierarchical Categories</a></span>
+href="#sec:hierarchical" id="QQ2-1-127">Hierarchical Categories</a></span>
<br />   <span class="subsectionToc" >4.5.2 <a
-href="#sec:homographs" id="QQ2-1-127">Homographs</a></span>
+href="#sec:homographs" id="QQ2-1-128">Homographs</a></span>
<br />  <span class="sectionToc" >4.6 <a
-href="#sec:loadglsentries" id="QQ2-1-128">Loading Entries From a File</a></span>
+href="#sec:loadglsentries" id="QQ2-1-129">Loading Entries From a File</a></span>
<br />  <span class="sectionToc" >4.7 <a
-href="#sec:moveentry" id="QQ2-1-129">Moving Entries to Another Glossary</a></span>
+href="#sec:moveentry" id="QQ2-1-130">Moving Entries to Another Glossary</a></span>
<br />  <span class="sectionToc" >4.8 <a
-href="#sec:docdefs" id="QQ2-1-130">Drawbacks With Defining Entries in the Document Environment</a></span>
+href="#sec:docdefs" id="QQ2-1-131">Drawbacks With Defining Entries in the Document Environment</a></span>
<br />   <span class="subsectionToc" >4.8.1 <a
-href="#sec:techissues" id="QQ2-1-131">Technical Issues</a></span>
+href="#sec:techissues" id="QQ2-1-132">Technical Issues</a></span>
<br />   <span class="subsectionToc" >4.8.2 <a
-href="#sec:goodpractice" id="QQ2-1-132">Good Practice Issues</a></span>
+href="#sec:goodpractice" id="QQ2-1-133">Good Practice Issues</a></span>
<br /> <span class="chapterToc" >5 <a
-href="#sec:usingentries" id="QQ2-1-133">Referencing Entries in the Document</a></span>
+href="#sec:usingentries" id="QQ2-1-134">Referencing Entries in the Document</a></span>
<br />  <span class="sectionToc" >5.1 <a
-href="#sec:glslink" id="QQ2-1-134">Links to Glossary Entries</a></span>
+href="#sec:glslink" id="QQ2-1-135">Links to Glossary Entries</a></span>
<br />   <span class="subsectionToc" >5.1.1 <a
-href="#sec:gls-like" id="QQ2-1-136">The <span
+href="#x1-1310005.1.1" id="QQ2-1-137">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
+href="#x1-1320005.1.2" id="QQ2-1-138">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>
+href="#sec:glsdisplay" id="QQ2-1-139">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>
+href="#sec:disablehyperlinks" id="QQ2-1-140">Enabling and disabling hyperlinks to glossary entries</a></span>
<br />  <span class="sectionToc" >5.2 <a
-href="#sec:glsnolink" id="QQ2-1-140">Using Glossary Terms Without Links</a></span>
+href="#sec:glsnolink" id="QQ2-1-141">Using Glossary Terms Without Links</a></span>
<br /> <span class="chapterToc" >6 <a
-href="#sec:acronyms" id="QQ2-1-141">Acronyms and Other Abbreviations</a></span>
+href="#sec:acronyms" id="QQ2-1-142">Acronyms and Other Abbreviations</a></span>
<br />  <span class="sectionToc" >6.1 <a
-href="#sec:longshortfull" id="QQ2-1-142">Displaying the Long, Short and Full Forms (Independent of First Use)</a></span>
+href="#sec:longshortfull" id="QQ2-1-143">Displaying the Long, Short and Full Forms (Independent of First Use)</a></span>
<br />  <span class="sectionToc" >6.2 <a
-href="#sec:setacronymstyle" id="QQ2-1-144">Changing the Acronym Style</a></span>
+href="#sec:setacronymstyle" id="QQ2-1-145">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>
+href="#sec:predefinedacrstyles" id="QQ2-1-146">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>
+href="#sec:customacronym" id="QQ2-1-147">Defining A Custom Acronym Style</a></span>
<br />  <span class="sectionToc" >6.3 <a
-href="#sec:disploa" id="QQ2-1-147">Displaying the List of Acronyms</a></span>
+href="#sec:disploa" id="QQ2-1-148">Displaying the List of Acronyms</a></span>
<br />  <span class="sectionToc" >6.4 <a
-href="#sec:oldacronym" id="QQ2-1-148">Upgrading From the glossary Package</a></span>
+href="#sec:oldacronym" id="QQ2-1-149">Upgrading From the glossary Package</a></span>
<br /> <span class="chapterToc" >7 <a
-href="#sec:glsunset" id="QQ2-1-150">Unsetting and Resetting Entry Flags</a></span>
+href="#sec:glsunset" id="QQ2-1-151">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>
+href="#sec:enableentrycount" id="QQ2-1-152">Counting the Number of Times an Entry has been Used (First Use Flag Unset)</a></span>
<br /> <span class="chapterToc" >8 <a
-href="#sec:printglossary" id="QQ2-1-152">Displaying a Glossary</a></span>
+href="#sec:printglossary" id="QQ2-1-153">Displaying a Glossary</a></span>
<br /> <span class="chapterToc" >9 <a
-href="#sec:newglossary" id="QQ2-1-153">Defining New Glossaries</a></span>
+href="#sec:newglossary" id="QQ2-1-154">Defining New Glossaries</a></span>
<br /> <span class="chapterToc" >10 <a
-href="#sec:glsadd" id="QQ2-1-154">Adding an Entry to the Glossary Without Generating Text</a></span>
+href="#sec:glsadd" id="QQ2-1-155">Adding an Entry to the Glossary Without Generating Text</a></span>
<br /> <span class="chapterToc" >11 <a
-href="#sec:crossref" id="QQ2-1-155">Cross-Referencing Entries</a></span>
+href="#sec:crossref" id="QQ2-1-156">Cross-Referencing Entries</a></span>
<br />  <span class="sectionToc" >11.1 <a
-href="#sec:customxr" id="QQ2-1-156">Customising Cross-reference Text</a></span>
+href="#sec:customxr" id="QQ2-1-157">Customising Cross-reference Text</a></span>
<br /> <span class="chapterToc" >12 <a
-href="#sec:numberlists" id="QQ2-1-157">Number Lists</a></span>
+href="#sec:numberlists" id="QQ2-1-158">Number Lists</a></span>
<br />  <span class="sectionToc" >12.1 <a
-href="#sec:encap" id="QQ2-1-158">Encap Values (Location Formats)</a></span>
+href="#sec:encap" id="QQ2-1-159">Encap Values (Location Formats)</a></span>
<br />  <span class="sectionToc" >12.2 <a
-href="#sec:locationsyntax" id="QQ2-1-159">Locations</a></span>
+href="#sec:locationsyntax" id="QQ2-1-160">Locations</a></span>
<br />  <span class="sectionToc" >12.3 <a
-href="#sec:ranges" id="QQ2-1-160">Range Formations</a></span>
+href="#sec:ranges" id="QQ2-1-161">Range Formations</a></span>
<br />  <span class="sectionToc" >12.4 <a
-href="#sec:isthook" id="QQ2-1-161">Style Hook</a></span>
+href="#sec:isthook" id="QQ2-1-162">Style Hook</a></span>
<br /> <span class="chapterToc" >13 <a
-href="#sec:styles" id="QQ2-1-162">Glossary Styles</a></span>
+href="#sec:styles" id="QQ2-1-163">Glossary Styles</a></span>
<br />  <span class="sectionToc" >13.1 <a
-href="#sec:predefinedstyles" id="QQ2-1-163">Predefined Styles</a></span>
+href="#sec:predefinedstyles" id="QQ2-1-164">Predefined Styles</a></span>
<br />   <span class="subsectionToc" >13.1.1 <a
-href="#sec:liststyles" id="QQ2-1-165">List Styles</a></span>
+href="#sec:liststyles" id="QQ2-1-166">List Styles</a></span>
<br />   <span class="subsectionToc" >13.1.2 <a
-href="#sec:longstyles" id="QQ2-1-166">Longtable Styles</a></span>
+href="#sec:longstyles" id="QQ2-1-167">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>
+href="#sec:longraggedstyles" id="QQ2-1-168">Longtable Styles (Ragged Right)</a></span>
<br />   <span class="subsectionToc" >13.1.4 <a
-href="#sec:longbooktabsstyles" id="QQ2-1-168">Longtable Styles (<span
+href="#x1-16000013.1.4" id="QQ2-1-169">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>
+href="#sec:superstyles" id="QQ2-1-170">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>
+href="#sec:superraggedstyles" id="QQ2-1-171">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>
+href="#sec:treestyles" id="QQ2-1-172">Tree-Like Styles</a></span>
+<br />   <span class="subsectionToc" >13.1.8 <a
+href="#sec:mcolstyles" id="QQ2-1-173">Multicols Style</a></span>
<br />   <span class="subsectionToc" >13.1.9 <a
-href="#sec:inline" id="QQ2-1-174">In-Line Style</a></span>
+href="#sec:inline" id="QQ2-1-175">In-Line Style</a></span>
<br />  <span class="sectionToc" >13.2 <a
-href="#sec:newglossarystyle" id="QQ2-1-175">Defining your own glossary style</a></span>
+href="#sec:newglossarystyle" id="QQ2-1-176">Defining your own glossary style</a></span>
<br /> <span class="chapterToc" >14 <a
-href="#sec:xindy" id="QQ2-1-176">Xindy (Option 3)</a></span>
+href="#sec:xindy" id="QQ2-1-177">Xindy (Option 3)</a></span>
<br />  <span class="sectionToc" >14.1 <a
-href="#sec:langenc" id="QQ2-1-177">Language and Encodings</a></span>
+href="#sec:langenc" id="QQ2-1-178">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>
+href="#sec:xindyloc" id="QQ2-1-179">Locations and Number lists</a></span>
<br />  <span class="sectionToc" >14.3 <a
-href="#sec:groups" id="QQ2-1-179">Glossary Groups</a></span>
+href="#sec:groups" id="QQ2-1-180">Glossary Groups</a></span>
<br /> <span class="chapterToc" >15 <a
-href="#sec:utilities" id="QQ2-1-180">Utilities</a></span>
+href="#sec:utilities" id="QQ2-1-181">Utilities</a></span>
<br />  <span class="sectionToc" >15.1 <a
-href="#sec:loops" id="QQ2-1-181">Loops</a></span>
+href="#sec:loops" id="QQ2-1-182">Loops</a></span>
<br />  <span class="sectionToc" >15.2 <a
-href="#sec:conditionals" id="QQ2-1-182">Conditionals</a></span>
+href="#sec:conditionals" id="QQ2-1-183">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>
+href="#sec:fetchset" id="QQ2-1-184">Fetching and Updating the Value of a Field</a></span>
<br /> <span class="chapterToc" >16 <a
-href="#sec:prefix" id="QQ2-1-184">Prefixes or Determiners</a></span>
+href="#sec:prefix" id="QQ2-1-185">Prefixes or Determiners</a></span>
<br /> <span class="chapterToc" >17 <a
-href="#sec:accsupp" id="QQ2-1-185">Accessibility Support</a></span>
+href="#sec:accsupp" id="QQ2-1-186">Accessibility Support</a></span>
<br /> <span class="chapterToc" >18 <a
-href="#sec:samples" id="QQ2-1-186">Sample Documents</a></span>
+href="#sec:samples" id="QQ2-1-187">Sample Documents</a></span>
<br />  <span class="sectionToc" >18.1 <a
-href="#sec:samplesbasic" id="QQ2-1-187">Basic</a></span>
+href="#sec:samplesbasic" id="QQ2-1-188">Basic</a></span>
<br />  <span class="sectionToc" >18.2 <a
-href="#sec:sampleacronyms" id="QQ2-1-190">Acronyms and First Use</a></span>
+href="#sec:sampleacronyms" id="QQ2-1-191">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>
+href="#sec:samplecounter" id="QQ2-1-201">Non-Page Locations</a></span>
<br />  <span class="sectionToc" >18.4 <a
-href="#sec:samplestype" id="QQ2-1-204">Multiple Glossaries</a></span>
+href="#sec:samplestype" id="QQ2-1-205">Multiple Glossaries</a></span>
<br />  <span class="sectionToc" >18.5 <a
-href="#sec:samplessort" id="QQ2-1-209">Sorting</a></span>
+href="#sec:samplessort" id="QQ2-1-210">Sorting</a></span>
<br />  <span class="sectionToc" >18.6 <a
-href="#sec:samplesparent" id="QQ2-1-212">Child Entries</a></span>
+href="#sec:samplesparent" id="QQ2-1-213">Child Entries</a></span>
<br />  <span class="sectionToc" >18.7 <a
-href="#sec:samplescrossref" id="QQ2-1-216">Cross-Referencing</a></span>
+href="#sec:samplescrossref" id="QQ2-1-217">Cross-Referencing</a></span>
<br />  <span class="sectionToc" >18.8 <a
-href="#sec:samplescustomkeys" id="QQ2-1-218">Custom Keys</a></span>
+href="#sec:samplescustomkeys" id="QQ2-1-219">Custom Keys</a></span>
<br />  <span class="sectionToc" >18.9 <a
-href="#sec:samplesxindy" id="QQ2-1-223">Xindy (Option 3)</a></span>
+href="#sec:samplesxindy" id="QQ2-1-224">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>
+href="#sec:samplesnoidx" id="QQ2-1-229">No Indexing Application (Option 1)</a></span>
<br />  <span class="sectionToc" >18.11 <a
-href="#sec:samplesother" id="QQ2-1-231">Other</a></span>
+href="#sec:samplesother" id="QQ2-1-232">Other</a></span>
<br /> <span class="chapterToc" >19 <a
-href="#sec:trouble" id="QQ2-1-240">Troubleshooting</a></span>
+href="#sec:trouble" id="QQ2-1-241">Troubleshooting</a></span>
</div>
@@ -1877,7 +1880,7 @@
<!--l. 1--><p class="indent" > <a
id="likesection.1"></a><a
id="x1-2001x1"></a><a
- id="Q1-1-3"></a>
+ id="glossary"></a>
</p>
@@ -1934,13 +1937,13 @@
class="cmsy-10">}</span></td></tr></table>
<!--l. 1--><p class="indent" >
</p><dl class="description"><dt class="description">
- <!--l. 90--><p class="noindent" >
+ <!--l. 89--><p class="noindent" >
<a
id="glo:bib2gls"></a><span
class="cmtt-10">bib2gls</span><a
id="dx1-3001"></a> </p></dt><dd
class="description">
- <!--l. 90--><p class="noindent" ><br
+ <!--l. 89--><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
@@ -1963,24 +1966,24 @@
href="#option4">Option 4</a>. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 96--><p class="noindent" >
+ <!--l. 95--><p class="noindent" >
<a
id="glo:cli"></a><span
class="cmbx-10">Command Line Interface (CLI)</span> </p></dt><dd
class="description">
- <!--l. 96--><p class="noindent" ><br
+ <!--l. 95--><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" />
</p></dd><dt class="description">
- <!--l. 109--><p class="noindent" >
+ <!--l. 108--><p class="noindent" >
<a
id="glo:convertgls2bib"></a><span
class="cmtt-10">convertgls2bib</span><a
id="dx1-3006"></a> </p></dt><dd
class="description">
- <!--l. 109--><p class="noindent" ><br
+ <!--l. 108--><p class="noindent" ><br
class="newline" />An application provided with <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
@@ -2008,24 +2011,24 @@
v2.0). <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 113--><p class="noindent" >
+ <!--l. 112--><p class="noindent" >
<a
id="glo:entrylocation"></a><span
class="cmbx-10">Entry location</span><a
id="dx1-3013"></a> </p></dt><dd
class="description">
- <!--l. 113--><p class="noindent" ><br
+ <!--l. 112--><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" />
</p></dd><dt class="description">
- <!--l. 121--><p class="noindent" >
+ <!--l. 120--><p class="noindent" >
<a
id="glo:exlatinalph"></a><span
class="cmbx-10">Extended Latin Alphabet</span><a
id="dx1-3014"></a> </p></dt><dd
class="description">
- <!--l. 121--><p class="noindent" ><br
+ <!--l. 120--><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
@@ -2033,13 +2036,13 @@
id="dx1-3016"></a>s</a>. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 126--><p class="noindent" >
+ <!--l. 125--><p class="noindent" >
<a
id="glo:exlatinchar"></a><span
class="cmbx-10">Extended Latin Character</span><a
id="dx1-3017"></a> </p></dt><dd
class="description">
- <!--l. 126--><p class="noindent" ><br
+ <!--l. 125--><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
@@ -2049,13 +2052,13 @@
id="dx1-3020"></a></a>. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 161--><p class="noindent" >
+ <!--l. 160--><p class="noindent" >
<a
id="glo:firstuse"></a><span
class="cmbx-10">First use</span><a
id="dx1-3021"></a> </p></dt><dd
class="description">
- <!--l. 161--><p class="noindent" ><br
+ <!--l. 160--><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
@@ -2077,18 +2080,18 @@
href="#glo:firstusetext">first use text</a>.) <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 180--><p class="noindent" >
+ <!--l. 179--><p class="noindent" >
<a
id="glo:firstuseflag"></a><span
class="cmbx-10">First use flag</span><a
id="dx1-3029"></a> </p></dt><dd
class="description">
- <!--l. 180--><p class="noindent" ><br
+ <!--l. 179--><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">§<span
-class="cmbx-10">??</span>sec:glsunset </a><a
+class="cmbx-10">7</span> </a><a
href="#sec:glsunset">Unsetting
and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>. <br
class="newline" />
@@ -2095,13 +2098,13 @@
</p></dd><dt class="description">
- <!--l. 182--><p class="noindent" >
+ <!--l. 181--><p class="noindent" >
<a
id="glo:firstusetext"></a><span
class="cmbx-10">First use text</span><a
id="dx1-3030"></a> </p></dt><dd
class="description">
- <!--l. 182--><p class="noindent" ><br
+ <!--l. 181--><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
@@ -2117,12 +2120,12 @@
id="dx1-3035"></a>.) <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 278--><p class="noindent" >
+ <!--l. 277--><p class="noindent" >
<a
id="glo:glossaries-extra"></a><span
class="cmssbx-10">glossaries-extra</span> </p></dt><dd
class="description">
- <!--l. 278--><p class="noindent" ><br
+ <!--l. 277--><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
@@ -2195,13 +2198,13 @@
<br
class="newline" />
</p></dd><dt class="description">
- <!--l. 362--><p class="noindent" >
+ <!--l. 361--><p class="noindent" >
<a
id="glo:makeglossaries"></a><span
class="cmtt-10">makeglossaries</span><a
id="dx1-3044"></a> </p></dt><dd
class="description">
- <!--l. 362--><p class="noindent" ><br
+ <!--l. 361--><p class="noindent" ><br
class="newline" />A custom designed Perl script interface to <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
@@ -2216,13 +2219,13 @@
class="cmtt-10">makeglossaries.exe </span>for convenience (but Perl is still required). <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 365--><p class="noindent" >
+ <!--l. 364--><p class="noindent" >
<a
id="glo:makeglossariesgui"></a><span
class="cmtt-10">makeglossariesgui</span><a
id="dx1-3047"></a> </p></dt><dd
class="description">
- <!--l. 365--><p class="noindent" ><br
+ <!--l. 364--><p class="noindent" ><br
class="newline" />A Java GUI alternative to <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
@@ -2231,13 +2234,13 @@
href="http://ctan.org/pkg/makeglossariesgui" >CTAN</a>. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 385--><p class="noindent" >
+ <!--l. 383--><p class="noindent" >
<a
id="glo:makeglossaries-lite.lua"></a><span
class="cmtt-10">makeglossaries-lite</span><a
id="dx1-3049"></a> </p></dt><dd
class="description">
- <!--l. 385--><p class="noindent" ><br
+ <!--l. 383--><p class="noindent" ><br
class="newline" />A custom designed Lua script interface to <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
@@ -2260,19 +2263,19 @@
script. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 440--><p class="noindent" >
+ <!--l. 436--><p class="noindent" >
<a
id="glo:makeindex"></a><span
class="cmtt-10">makeindex</span><a
id="dx1-3053"></a> </p></dt><dd
class="description">
- <!--l. 440--><p class="noindent" ><br
+ <!--l. 436--><p class="noindent" ><br
class="newline" />An <a
href="#glo:indexingapp">indexing application</a>. See <a
href="#option2">Option 2</a>. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 448--><p class="noindent" >
+ <!--l. 444--><p class="noindent" >
<a
id="glo:nonlatinalph"></a><span
class="cmbx-10">Non-Latin Alphabet</span><a
@@ -2280,19 +2283,19 @@
class="description">
- <!--l. 448--><p class="noindent" ><br
+ <!--l. 444--><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" />
</p></dd><dt class="description">
- <!--l. 458--><p class="noindent" >
+ <!--l. 454--><p class="noindent" >
<a
id="glo:nonlatinchar"></a><span
class="cmbx-10">Non-Latin Character</span><a
id="dx1-3056"></a> </p></dt><dd
class="description">
- <!--l. 458--><p class="noindent" ><br
+ <!--l. 454--><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
@@ -2300,13 +2303,13 @@
id="dx1-3058"></a></a>. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 506--><p class="noindent" >
+ <!--l. 502--><p class="noindent" >
<a
id="glo:numberlist"></a><span
class="cmbx-10">Number list</span><a
id="dx1-3059"></a> </p></dt><dd
class="description">
- <!--l. 506--><p class="noindent" ><br
+ <!--l. 502--><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
@@ -2314,13 +2317,13 @@
id="dx1-3060"></a> package option. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 512--><p class="noindent" >
+ <!--l. 508--><p class="noindent" >
<a
id="glo:sanitize"></a><span
class="cmbx-10">Sanitize</span><a
id="dx1-3061"></a> </p></dt><dd
class="description">
- <!--l. 512--><p class="noindent" ><br
+ <!--l. 508--><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
@@ -2330,7 +2333,7 @@
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.
- </p><!--l. 512--><p class="noindent" >Earlier versions of <span
+ </p><!--l. 508--><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
@@ -2338,13 +2341,13 @@
key. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 521--><p class="noindent" >
+ <!--l. 517--><p class="noindent" >
<a
id="glo:smallcaps"></a><span
class="cmbx-10">Small caps</span><a
id="dx1-3063"></a> </p></dt><dd
class="description">
- <!--l. 521--><p class="noindent" ><br
+ <!--l. 517--><p class="noindent" ><br
class="newline" />Small capitals. The LaTeX kernel provides <span
class="cmtt-10">\textsc</span><a
id="dx1-3064"></a><span
@@ -2371,7 +2374,7 @@
</p></dd><dt class="description">
- <!--l. 525--><p class="noindent" >
+ <!--l. 521--><p class="noindent" >
<a
id="glo:latexexlatinchar"></a><span
class="cmbx-10">Standard LaTeX</span><span
@@ -2378,7 +2381,7 @@
class="cmbx-10"> Extended Latin Character</span><a
id="dx1-3067"></a> </p></dt><dd
class="description">
- <!--l. 525--><p class="noindent" ><br
+ <!--l. 521--><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
@@ -2387,13 +2390,13 @@
class="cmtt-10">\’e </span>(é). That is, the character can be produced without the need to load a particular package. <br
class="newline" />
</p></dd><dt class="description">
- <!--l. 535--><p class="noindent" >
+ <!--l. 531--><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
+ <!--l. 531--><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:
@@ -2401,13 +2404,13 @@
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" >
+ <!--l. 586--><p class="noindent" >
<a
id="glo:xindy"></a><span
class="cmtt-10">xindy</span><a
id="dx1-3070"></a> </p></dt><dd
class="description">
- <!--l. 590--><p class="noindent" ><br
+ <!--l. 586--><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
@@ -2720,19 +2723,19 @@
<li class="itemize">
<!--l. 1042--><p class="noindent" ><a
href="#sec:indexingoptions">§<span
-class="cmbx-10">??</span>sec:indexingoptions </a><a
+class="cmbx-10">1.2</span> </a><a
href="#sec:indexingoptions">Indexing Options<!--tex4ht:ref: sec:indexingoptions --></a> lists the available indexing options.
</p></li>
<li class="itemize">
<!--l. 1045--><p class="noindent" ><a
href="#sec:lipsum">§<span
-class="cmbx-10">??</span>sec:lipsum </a><a
+class="cmbx-10">1.3</span> </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.
</p></li>
<li class="itemize">
<!--l. 1048--><p class="noindent" ><a
href="#sec:languages">§<span
-class="cmbx-10">??</span>sec:languages </a><a
+class="cmbx-10">1.4</span> </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>
@@ -2739,7 +2742,7 @@
<li class="itemize">
<!--l. 1051--><p class="noindent" ><a
href="#sec:makeglossaries">§<span
-class="cmbx-10">??</span>sec:makeglossaries </a><a
+class="cmbx-10">1.5</span> </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
@@ -2749,14 +2752,52 @@
</li></ul>
<!--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
+class="cmbx-10">18</span> </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:rollback"></a>Rollback</h3>
+<!--l. 1063--><p class="noindent" >There is one rollback release: v4.46 (2020-03-19) for <span
+class="cmss-10">glossaries.sty </span>and <span
+class="cmss-10">glossary-list.sty</span>. The other associated
+packages haven’t been changed since that release (apart from the version numbers, which are always updated for
+each new release, regardless of whether or not the file has otherwise been changed). If you rollback to v4.46
+using:
+
+
+</p>
+ <pre class="verbatim" id="verbatim-5">
+\usepackage{glossaries}[=v4.46]
+</pre>
+<!--l. 1071--><p class="nopar" > then the 4.46 version of <span
+class="cmss-10">glossary-list.sty</span><a
+ id="dx1-5001"></a> will automatically be loaded. If you use <span
+class="cmss-10">nostyles</span><a
+ id="dx1-5002"></a> and subsequently load
+<span
+class="cmss-10">glossary-list</span><a
+ id="dx1-5003"></a> you will also need to add the rollback version:
+
+
+</p>
+ <pre class="verbatim" id="verbatim-6">
+\usepackage[nostyles]{glossaries}[=v4.46]
+\usepackage{glossary-list}[=v4.46]
+</pre>
+<!--l. 1078--><p class="nopar" > If you rollback using <span
+class="cmss-10">latexrelease</span><a
+ id="dx1-5004"></a> to an earlier date, then you will need to specify v4.46 for <span
+class="cmss-10">glossaries</span><a
+ id="dx1-5005"></a> as there are
+no earlier rollback versions available.
+</p><!--l. 1083--><p class="noindent" >
+</p>
+<!--l. 1083--><p class="noindent" ><a
+href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.2 </span> <a
id="sec:indexingoptions"></a>Indexing Options</h3>
-<!--l. 1063--><p class="noindent" >The basic idea behind the <span
+<!--l. 1086--><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
@@ -2774,17 +2815,17 @@
href="#option5">5</a>) as well as an option for standalone descriptions within the document body
(<a
href="#option6">Option 6</a>).
-</p><!--l. 1074--><p class="indent" > An overview of Options <a
+</p><!--l. 1097--><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 <span
-class="cmbx-10">??</span>tab:options</a>. <a
+class="cmbx-10">1.1</span></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. 1080--><p class="indent" > <div class="important" title="Important Note"> If you are developing a class or package that loads <span
+</p><!--l. 1103--><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>
@@ -2793,11 +2834,9 @@
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. 1089--><p class="noindent" >
-</p><!--l. 1091--><p class="indent" > Strictly speaking, Options <a
+</p><!--l. 1112--><p class="noindent" >
+</p><!--l. 1114--><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
@@ -2810,7 +2849,7 @@
<div class="table">
-<!--l. 1098--><p class="indent" > <a
+<!--l. 1121--><p class="indent" > <a
id="tab:options"></a></p><hr class="float" /><div class="float"
>
@@ -2817,7 +2856,7 @@
<div class="caption"
><span class="id">Table 1.1: </span><span
-class="content">Glossary Options: Pros and Cons</span></div><!--tex4ht:label?: x1-50011 -->
+class="content">Glossary Options: Pros and Cons</span></div><!--tex4ht:label?: x1-60011 -->
<div class="tabular"> <table id="TBL-2" class="tabular"
@@ -2830,7 +2869,7 @@
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. 1106--><p class="noindent" > </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-1-2"
+class="td01"><!--l. 1129--><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
@@ -2853,7 +2892,7 @@
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. 1108--><p class="noindent" ><span
+class="td01"><!--l. 1131--><p class="noindent" ><span
class="cmr-9">Requires</span>
<a
href="#glo:glossaries-extra"><span
@@ -2871,7 +2910,7 @@
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. 1110--><p class="noindent" ><span
+class="td01"><!--l. 1133--><p class="noindent" ><span
class="cmr-9">Requires</span>
<span
class="cmr-9">an</span>
@@ -2891,7 +2930,7 @@
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. 1112--><p class="noindent" ><span
+class="td01"><!--l. 1135--><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"
@@ -2907,7 +2946,7 @@
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. 1114--><p class="noindent" ><span
+class="td01"><!--l. 1137--><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"
@@ -2923,7 +2962,7 @@
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. 1116--><p class="noindent" ><span
+class="td01"><!--l. 1139--><p class="noindent" ><span
class="cmr-9">Can</span>
<span
class="cmr-9">sort</span>
@@ -2954,7 +2993,7 @@
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. 1119--><p class="noindent" ><span
+class="td01"><!--l. 1142--><p class="noindent" ><span
class="cmr-9">Efficient</span>
<span
class="cmr-9">sort</span>
@@ -2971,7 +3010,7 @@
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. 1121--><p class="noindent" ><span
+class="td01"><!--l. 1144--><p class="noindent" ><span
class="cmr-9">Can</span>
<span
class="cmr-9">use</span>
@@ -3002,7 +3041,7 @@
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. 1125--><p class="noindent" ><span
+class="td01"><!--l. 1148--><p class="noindent" ><span
class="cmr-9">Any</span>
<span
class="cmr-9">problematic</span>
@@ -3023,7 +3062,7 @@
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. 1127--><p class="noindent" ><span
+class="td01"><!--l. 1150--><p class="noindent" ><span
class="cmr-9">Are</span>
<span
class="cmr-9">entries</span>
@@ -3058,7 +3097,7 @@
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. 1130--><p class="noindent" ><span
+class="td01"><!--l. 1153--><p class="noindent" ><span
class="cmr-9">Can</span>
<span
class="cmr-9">automatically</span>
@@ -3086,7 +3125,7 @@
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. 1132--><p class="noindent" ><span
+class="td01"><!--l. 1155--><p class="noindent" ><span
class="cmr-9">Can</span>
<span
class="cmr-9">have</span>
@@ -3113,10 +3152,10 @@
class="pzdr-">✔</span></span> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-12-6"
class="td10"> <span id="textcolor67"><span
class="pzdr-">✔</span></span><sup class="textsuperscript"><span
-class="tcrm-0900">¶</span></sup> </td>
+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. 1137--><p class="noindent" ><span
+class="td01"><!--l. 1160--><p class="noindent" ><span
class="cmr-9">Maximum</span>
<span
class="cmr-9">hierarchical</span>
@@ -3136,9 +3175,9 @@
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. 1139--><p class="noindent" ><span
+class="td01"><!--l. 1162--><p class="noindent" ><span
class="cmtt-9">\glsdisplaynumberlist</span><a
- id="dx1-5002"></a>
+ id="dx1-6002"></a>
<span
class="cmr-9">reliable?</span> </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-14-2"
class="td11"> <span id="textcolor68"><span
@@ -3153,9 +3192,9 @@
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. 1141--><p class="noindent" ><span
+class="td01"><!--l. 1164--><p class="noindent" ><span
class="cmtt-9">\newglossaryentry</span><a
- id="dx1-5003"></a>
+ id="dx1-6003"></a>
<span
class="cmr-9">allowed</span>
<span
@@ -3162,8 +3201,8 @@
class="cmr-9">in</span>
<span
class="cmss-9">document</span><a
- id="dx1-5004"></a><a
- id="dx1-5005"></a>
+ id="dx1-6004"></a><a
+ id="dx1-6005"></a>
<span
class="cmr-9">environment?</span>
<span
@@ -3183,7 +3222,7 @@
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. 1144--><p class="noindent" ><span
+class="td01"><!--l. 1167--><p class="noindent" ><span
class="cmr-9">Requires</span>
<span
class="cmr-9">additional</span>
@@ -3204,7 +3243,7 @@
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. 1146--><p class="noindent" ><span
+class="td01"><!--l. 1169--><p class="noindent" ><span
class="cmr-9">Default</span>
<span
class="cmr-9">value</span>
@@ -3212,7 +3251,7 @@
class="cmr-9">of</span>
<span
class="cmss-9">sanitizesort</span><a
- id="dx1-5006"></a>
+ id="dx1-6006"></a>
<span
class="cmr-9">package</span>
<span
@@ -3232,93 +3271,93 @@
</tr></table>
</div>
-<!--l. 1154--><p class="noindent" >______________________________________________________________________________________
-</p><!--l. 1156--><p class="noindent" ><sup class="textsuperscript"><span
+<!--l. 1177--><p class="noindent" >______________________________________________________________________________________
+</p><!--l. 1179--><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
class="cmr-8"> commands) so, for example, </span><span
class="cmtt-8">\AA</span><a
- id="dx1-5007"></a> <span
+ id="dx1-6007"></a> <span
class="cmr-8">is treated the</span>
<span
class="cmr-8">same as A.</span>
-</p><!--l. 1159--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1182--><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. 1160--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1183--><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
class="cmtt-8">=</span><span
class="cmss-8">none</span><a
- id="dx1-5008"></a> <span
+ id="dx1-6008"></a> <span
class="cmr-8">is used.</span>
-</p><!--l. 1161--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1184--><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. 1162--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1185--><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. 1163--><p class="noindent" ><sup class="textsuperscript"><span
-class="tcrm-0900">¶</span></sup> <span
+</p><!--l. 1186--><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
- id="dx1-5009"></a> <span
+ id="dx1-6009"></a> <span
class="cmr-8">field provided by </span><span
class="cmss-8">glossaries-extra</span><span
class="cmr-8">.</span>
-</p><!--l. 1166--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1189--><p class="noindent" ><sup class="textsuperscript"><span
class="cmr-9">#</span></sup> <span
class="cmr-8">Unlimited but unreliable.</span>
-</p><!--l. 1167--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1190--><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
- id="dx1-5010"></a> <span
+ id="dx1-6010"></a> <span
class="cmr-8">format. </span><span
class="cmtt-8">\newglossaryentry </span><span
class="cmr-8">should not be used explicitly.</span>
-</p><!--l. 1169--><p class="noindent" ><sup class="textsuperscript">⁑</sup> <span
+</p><!--l. 1192--><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
class="cmss-8">true</span></span><a
- id="dx1-5011"></a> <span
+ id="dx1-6011"></a> <span
class="cmr-8">or </span><span id="textcolor80"><span
class="cmss-8">docdef</span><span
class="cmtt-8">=</span><span
class="cmss-8">restricted</span></span><a
- id="dx1-5012"></a> <span
+ id="dx1-6012"></a> <span
class="cmr-8">but not recommended.</span>
-</p><!--l. 1171--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1194--><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
class="cmtt-8">=</span><span
class="cmss-8">false</span></span><a
- id="dx1-5013"></a> <span
+ id="dx1-6013"></a> <span
class="cmr-8">or </span><span id="textcolor82"><span
class="cmss-8">docdef</span><span
class="cmtt-8">=</span><span
class="cmss-8">restricted</span></span><a
- id="dx1-5014"></a><span
+ id="dx1-6014"></a><span
class="cmr-8">.</span>
-</p><!--l. 1173--><p class="noindent" ><sup class="textsuperscript"><span
+</p><!--l. 1196--><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
class="cmtt-8">=</span><span
class="cmss-8">none</span><a
- id="dx1-5015"></a><span
+ id="dx1-6015"></a><span
class="cmr-8">. (The </span><span id="textcolor83"><span
class="cmss-8">record</span><span
class="cmtt-8">=</span><span
class="cmss-8">only</span></span><a
- id="dx1-5016"></a> <span
+ id="dx1-6016"></a> <span
class="cmr-8">option automatically switches this on.)</span>
@@ -3326,23 +3365,23 @@
</div><hr class="endfloat" />
</div>
<a
- id="x1-5017r1"></a>
+ id="x1-6017r1"></a>
<h4 class="likesubsectionHead"><a
- id="x1-60001"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option1">🔗</a><a
+ id="x1-70001"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option1">🔗</a><a
id="option1"></a>Option 1 (TeX)</h4>
-<!--l. 1180--><p class="noindent" >This option isn’t generally recommended for reasons given below. Example Document:
+<!--l. 1203--><p class="noindent" >This option isn’t generally recommended for reasons given below. Example Document:
</p>
- <pre class="verbatim" id="verbatim-5">
+ <pre class="verbatim" id="verbatim-7">
\documentclass{article}
\usepackage{glossaries}
</pre>
-<!--l. 1185--><p class="nopar" > </p><div class="alltt">
+<!--l. 1208--><p class="nopar" > </p><div class="alltt">
<div class="obeylines-v">
<strong><span
class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-6001"></a></strong><span
+ id="dx1-7001"></a></strong><span
class="cmtt-10"> %</span><span
class="cmtt-10"> use</span><span
class="cmtt-10"> TeX</span><span
@@ -3352,28 +3391,28 @@
</div>
- <pre class="verbatim" id="verbatim-6">
+ <pre class="verbatim" id="verbatim-8">
\newglossaryentry{sample}{name={sample},
  description={an example}}
\begin{document}
\gls{sample}.
</pre>
-<!--l. 1194--><p class="nopar" > </p><div class="alltt">
+<!--l. 1217--><p class="nopar" > </p><div class="alltt">
<div class="obeylines-v">
<strong><span
class="cmtt-10">\printnoidxglossary</span><a
- id="dx1-6002"></a></strong>
+ id="dx1-7002"></a></strong>
<br /><span
class="cmtt-10">\end{document}</span>
</div>
</div> You can place all your entry definitions in a separate file and load it in the preamble with <span
class="cmtt-10">\loadglsentries</span><a
- id="dx1-6003"></a>
+ id="dx1-7003"></a>
(<span
class="cmti-10">after </span><span
class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-6004"></a>).
-<!--l. 1203--><p class="indent" > This option doesn’t require an external <a
+ id="dx1-7004"></a>).
+<!--l. 1226--><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
@@ -3384,7 +3423,7 @@
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
+ id="dx1-7005"></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
@@ -3393,12 +3432,12 @@
class="cmss-10">sanitizesort</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-6006"></a> is used and will default to <span class="obeylines-h"><span class="verb"><span
+ id="dx1-7006"></a> is used and will default to <span class="obeylines-h"><span class="verb"><span
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
+ id="dx1-7007"></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
@@ -3406,23 +3445,23 @@
class="cmss-10">sanitizesort</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-6008"></a> or change the sort method (<span
+ id="dx1-7008"></a> or change the sort method (<span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">use</span><a
- id="dx1-6009"></a> or <span
+ id="dx1-7009"></a> or <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">def</span><a
- id="dx1-6010"></a>) in the
+ id="dx1-7010"></a>) in the
package options or explicitly set the <span
class="cmtt-10">sort</span><a
- id="dx1-6011"></a> key when you define the relevant entries. For example:
+ id="dx1-7011"></a> key when you define the relevant entries. For example:
</p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-6012"></a><span
+ id="dx1-7012"></a><span
class="cmtt-10">{alpha}{name={\ensuremath{\alpha}},</span>
<br /><span
class="cmtt-10"> </span><strong><span
@@ -3430,103 +3469,103 @@
class="cmtt-10">,description={...}}</span>
</div>
</div>
-<!--l. 1224--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+<!--l. 1247--><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
- id="dx1-6013"></a> package option that provides <span id="textcolor84"><span
+ id="dx1-7013"></a> package option that provides <span id="textcolor84"><span
class="cmtt-10">\glsxtrnewsymbol</span></span><a
- id="dx1-6014"></a>, which
+ id="dx1-7014"></a>, which
automatically sets the <span
class="cmtt-10">sort</span><a
- id="dx1-6015"></a> key to the entry label (instead of the <span
+ id="dx1-7015"></a> key to the entry label (instead of the <span
class="cmtt-10">name</span><a
- id="dx1-6016"></a>). </div>
-</p><!--l. 1228--><p class="noindent" >
-</p><!--l. 1230--><p class="indent" > This option works best with the <span
+ id="dx1-7016"></a>). </div>
+</p><!--l. 1251--><p class="noindent" >
+</p><!--l. 1253--><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
- id="dx1-6017"></a> or <span
+ id="dx1-7017"></a> or <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">use</span><a
- id="dx1-6018"></a> setting. For any other setting, be prepared for a long
+ id="dx1-7018"></a> setting. For any other setting, be prepared for a long
document build time, especially if you have a lot of entries defined. <strong>This option is intended as a last resort for
alphabetical sorting.</strong> This option allows a mixture of sort methods. (For example, sorting by word order for one
glossary and order of use for another.) This option is not suitable for hierarchical glossaries and does not form
ranges in the <a
href="#glo:numberlist">number list<a
- id="dx1-6019"></a>s</a>. If you really can’t use an <a
+ id="dx1-7019"></a>s</a>. If you really can’t use an <a
href="#glo:indexingapp">indexing application</a> consider using <a
href="#option5">Option 5</a>
instead.
-</p><!--l. 1241--><p class="indent" > Summary:
+</p><!--l. 1264--><p class="indent" > Summary:
</p><ol class="enumerate1" >
<li
- class="enumerate" id="x1-6021x1">
- <!--l. 1243--><p class="noindent" >Add
+ class="enumerate" id="x1-7021x1">
+ <!--l. 1266--><p class="noindent" >Add
</p>
- <pre class="verbatim" id="verbatim-7">
+ <pre class="verbatim" id="verbatim-9">
\makenoidxglossaries
</pre>
- <!--l. 1246--><p class="nopar" > to your preamble (before you start defining your entries, as described in <a
+ <!--l. 1269--><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
+class="cmbx-10">4</span> </a><a
href="#sec:newglosentry">Defining
Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>).
</p></li>
<li
- class="enumerate" id="x1-6023x2">
- <!--l. 1250--><p class="noindent" >Put
+ class="enumerate" id="x1-7023x2">
+ <!--l. 1273--><p class="noindent" >Put
</p>
- <pre class="verbatim" id="verbatim-8">
+ <pre class="verbatim" id="verbatim-10">
\printnoidxglossary
</pre>
- <!--l. 1253--><p class="nopar" > where you want your list of entries to appear (described in <a
+ <!--l. 1276--><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
+class="cmbx-10">8</span> </a><a
href="#sec:printglossary">Displaying a Glossary<!--tex4ht:ref: sec:printglossary --></a>).
Alternatively, to display all glossaries use the iterative command:
</p>
- <pre class="verbatim" id="verbatim-9">
+ <pre class="verbatim" id="verbatim-11">
\printnoidxglossaries
</pre>
- <!--l. 1259--><p class="nopar" >
+ <!--l. 1282--><p class="nopar" >
</p></li>
<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,
+ class="enumerate" id="x1-7025x3">
+ <!--l. 1284--><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. 1266--><p class="noindent" >
+ id="x1-7026r2"></a>
+<!--l. 1289--><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="x1-80002"></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. 1268--><p class="noindent" >Example document:
+<!--l. 1291--><p class="noindent" >Example document:
</p>
- <pre class="verbatim" id="verbatim-10">
+ <pre class="verbatim" id="verbatim-12">
\documentclass{article}
\usepackage{glossaries}
</pre>
-<!--l. 1272--><p class="nopar" > </p><div class="alltt">
+<!--l. 1295--><p class="nopar" > </p><div class="alltt">
<div class="obeylines-v">
<strong><span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-7001"></a></strong><span
+ id="dx1-8001"></a></strong><span
class="cmtt-10"> %</span><span
class="cmtt-10"> open</span><span
class="cmtt-10"> glossary</span><span
@@ -3535,35 +3574,35 @@
</div>
- <pre class="verbatim" id="verbatim-11">
+ <pre class="verbatim" id="verbatim-13">
\newglossaryentry{sample}{name={sample},
 description={an example}}
\begin{document}
\gls{sample}.
</pre>
-<!--l. 1281--><p class="nopar" > </p><div class="alltt">
+<!--l. 1304--><p class="nopar" > </p><div class="alltt">
<div class="obeylines-v">
<strong><span
class="cmtt-10">\printglossary</span><a
- id="dx1-7002"></a></strong>
+ id="dx1-8002"></a></strong>
<br /><span
class="cmtt-10">\end{document}</span>
</div>
</div> You can place all your entry definitions in a separate file and load it in the preamble with <span
class="cmtt-10">\loadglsentries</span><a
- id="dx1-7003"></a>
+ id="dx1-8003"></a>
(<span
class="cmti-10">after </span><span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-7004"></a>).
-<!--l. 1290--><p class="indent" > This option uses a <a
+ id="dx1-8004"></a>).
+<!--l. 1313--><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
- id="dx1-7005"></a></a> to sort the entries. This application comes with all
+ id="dx1-8005"></a></a> to sort the entries. This application comes with all
modern TeX distributions, but it’s hard-coded for the non-extended <a
href="#glo:latinalph">Latin alphabet<a
- id="dx1-7006"></a></a>. It can’t correctly sort
+ id="dx1-8006"></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 <a
@@ -3573,25 +3612,25 @@
making LaTeX write the glossary information to a temporary file which <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-7007"></a></a> reads. Then <a
+ id="dx1-8007"></a></a> reads. Then <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-7008"></a></a>
+ id="dx1-8008"></a></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. 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
+</p><!--l. 1325--><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
- id="dx1-7009"></a></a> is considered a
+ id="dx1-8009"></a></a> is considered a
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
+ id="dx1-8010"></a> package option provided the shell escape hasn’t
been completely disabled.)
-</p><!--l. 1309--><p class="indent" > This method can form ranges in the <a
+</p><!--l. 1332--><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
+ id="dx1-8011"></a></a> but only accepts limited number formats: <span
class="cmtt-10">\arabic</span>, <span
class="cmtt-10">\roman</span>,
<span
@@ -3598,14 +3637,14 @@
class="cmtt-10">\Roman</span>, <span
class="cmtt-10">\alph </span>and <span
class="cmtt-10">\Alph</span>.
-</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
+</p><!--l. 1336--><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
+ id="dx1-8012"></a></a> for each glossary
type.
-</p><!--l. 1320--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 1343--><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
@@ -3621,80 +3660,80 @@
href="#ex:sampleSort"><span
class="cmtt-10">sampleSort.tex</span></a> in <a
href="#sec:samplessort">§<span
-class="cmbx-10">??</span>sec:samplessort </a><a
+class="cmbx-10">18.5</span> </a><a
href="#sec:samplessort">Sorting<!--tex4ht:ref: sec:samplessort --></a>.
</div>
-</p><!--l. 1327--><p class="noindent" >
-</p><!--l. 1329--><p class="indent" > Summary:
+</p><!--l. 1350--><p class="noindent" >
+</p><!--l. 1352--><p class="indent" > Summary:
</p><ol class="enumerate1" >
<li
- class="enumerate" id="x1-7014x1">
- <!--l. 1331--><p class="noindent" >If you want to use <a
+ class="enumerate" id="x1-8014x1">
+ <!--l. 1354--><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
+ id="dx1-8015"></a>’s</a> <span
class="cmtt-10">-g</span><a
- id="dx1-7016"></a> option you must change the quote character using <span
+ id="dx1-8016"></a> option you must change the quote character using <span
class="cmtt-10">\GlsSetQuote</span><a
- id="dx1-7017"></a>. For
+ id="dx1-8017"></a>. For
example:
</p>
- <pre class="verbatim" id="verbatim-12">
+ <pre class="verbatim" id="verbatim-14">
\GlsSetQuote{+}
</pre>
- <!--l. 1335--><p class="nopar" > This must be used before <span
+ <!--l. 1358--><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
+ id="dx1-8018"></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">
- <!--l. 1341--><p class="noindent" >Add
+ class="enumerate" id="x1-8020x2">
+ <!--l. 1364--><p class="noindent" >Add
</p>
- <pre class="verbatim" id="verbatim-13">
+ <pre class="verbatim" id="verbatim-15">
\makeglossaries
</pre>
- <!--l. 1344--><p class="nopar" > to your preamble (before you start defining your entries, as described in <a
+ <!--l. 1367--><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
+class="cmbx-10">4</span> </a><a
href="#sec:newglosentry">Defining
Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>).
</p></li>
<li
- class="enumerate" id="x1-7022x3">
- <!--l. 1349--><p class="noindent" >Put
+ class="enumerate" id="x1-8022x3">
+ <!--l. 1372--><p class="noindent" >Put
</p>
- <pre class="verbatim" id="verbatim-14">
+ <pre class="verbatim" id="verbatim-16">
\printglossary
</pre>
- <!--l. 1352--><p class="nopar" > where you want your list of entries to appear (described in <a
+ <!--l. 1375--><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
+class="cmbx-10">8</span> </a><a
href="#sec:printglossary">Displaying a Glossary<!--tex4ht:ref: sec:printglossary --></a>).
Alternatively, to display all glossaries use the iterative command:
</p>
- <pre class="verbatim" id="verbatim-15">
+ <pre class="verbatim" id="verbatim-17">
\printglossaries
</pre>
- <!--l. 1358--><p class="nopar" >
+ <!--l. 1381--><p class="nopar" >
</p></li>
<li
- class="enumerate" id="x1-7024x4">
- <!--l. 1360--><p class="noindent" >Run LaTeX on your document. This creates files with the extensions <span
+ class="enumerate" id="x1-8024x4">
+ <!--l. 1383--><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
+ id="dx1-8025"></a> and <span
class="cmtt-10">ist</span><a
- id="dx1-7026"></a> (for example, if your
+ id="dx1-8026"></a> (for example, if your
LaTeX document is called <span
class="cmtt-10">myDoc.tex</span>, then you’ll have two extra files called <span
class="cmtt-10">myDoc.glo </span>and
@@ -3704,18 +3743,18 @@
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> you’ll see the section heading and some boilerplate
text.)
- </p><!--l. 1369--><p class="noindent" >If you have used package options such as <span
+ </p><!--l. 1392--><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
+ id="dx1-8027"></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">
- <!--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
+ class="enumerate" id="x1-8029x5">
+ <!--l. 1396--><p class="noindent" ><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#makeindex.run">🔗</a><a
+ id="x1-80285"></a> Run <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-7030"></a></a> with the <span
+ id="dx1-8030"></a></a> with the <span
class="cmtt-10">.glo </span>file as the input file and the <span
class="cmtt-10">.ist </span>file as the style so that it creates an
output file with the extension <span
@@ -3722,7 +3761,7 @@
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:
- </p><!--l. 1379--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ </p><!--l. 1402--><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>
@@ -3730,35 +3769,35 @@
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. 1386--><p class="noindent" ><div class="important" title="Important Note"> The file extensions vary according to the glossary <span
+ </p><!--l. 1409--><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
+ id="dx1-8031"></a>. See <a
href="#sec:makeindexapp">§<span
-class="cmbx-10">??</span>sec:makeindexapp </a><a
+class="cmbx-10">1.5.4</span> </a><a
href="#sec:makeindexapp">Using <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-7032"></a></a>
+ id="dx1-8032"></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. 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
+ id="dx1-8033"></a></a> must be called for each set of files. </div>
+ </p><!--l. 1413--><p class="noindent" >
+ </p><!--l. 1415--><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
+ id="dx1-8034"></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. 1398--><p class="noindent" >Alternatively, run <a
+ </p><!--l. 1421--><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
+ id="dx1-8035"></a></a> indirectly via the <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-7036"></a></a> script:
- </p><!--l. 1400--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-8036"></a></a> script:
+ </p><!--l. 1423--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
<br />makeglossaries myDoc
@@ -3767,21 +3806,21 @@
Note that the file extension isn’t supplied in this case. (Replace <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-7037"></a></a> with
+ id="dx1-8037"></a></a> with
<a
href="#glo:makeglossaries-lite.lua"><span
class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-7038"></a></a> if you don’t have Perl installed.) This will pick up all the file extensions
+ id="dx1-8038"></a></a> if you don’t have Perl installed.) This will pick up all the file extensions
from the <span
class="cmtt-10">aux</span><a
- id="dx1-7039"></a> file and run <a
+ id="dx1-8039"></a> file and run <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-7040"></a></a> the appropriate number of times with all the necessary
+ id="dx1-8040"></a></a> the appropriate number of times with all the necessary
switches.
- </p><!--l. 1410--><p class="noindent" >The simplest approach is to use <span
+ </p><!--l. 1433--><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:
+ id="dx1-8041"></a> and add the following comment lines to the start of your document:
</p><div class="alltt">
<div class="obeylines-v">
<span
@@ -3801,63 +3840,63 @@
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. 1421--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you want letter ordering you need to
+ <!--l. 1444--><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. 1424--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-8042"></a> switch:
+ </p><!--l. 1447--><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">§<span
-class="cmbx-10">??</span>sec:makeindexapp </a><a
+class="cmbx-10">1.5.4</span> </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
+ id="dx1-8043"></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>
+ id="dx1-8044"></a>
explicitly.) If you use <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-7045"></a></a> or <a
+ id="dx1-8045"></a></a> or <a
href="#glo:makeglossaries-lite.lua"><span
class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-7046"></a></a> then use the <span
+ id="dx1-8046"></a></a> then use the <span
class="cmss-10">order</span><span
class="cmtt-10">=</span><span
class="cmss-10">letter</span><a
- id="dx1-7047"></a> package option
+ id="dx1-8047"></a> package option
and the <span
class="cmtt-10">-l</span><a
- id="dx1-7048"></a> option will be added automatically.
+ id="dx1-8048"></a> option will be added automatically.
</p></li>
<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
+ class="enumerate" id="x1-8050x6">
+ <!--l. 1456--><p class="noindent" ><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#makeindex.relatex">🔗</a><a
+ id="x1-80496"></a> Once you have successfully completed the previous step, you can now run LaTeX on your document
again.</p></li></ol>
-<!--l. 1436--><p class="noindent" >You’ll need to repeat the last step if you have used the <span
+<!--l. 1459--><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
+ id="dx1-8051"></a> option (unless you’re using <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>) to ensure the
section heading is added to the table of contents. You’ll also need to repeat steps <a
-href="#makeindex.run">5<!--tex4ht:ref: makeindex.run --></a> and <a
-href="#makeindex.relatex">6<!--tex4ht:ref: makeindex.relatex --></a> if you have any
+href="#x1-80285">5<!--tex4ht:ref: makeindex.run --></a> and <a
+href="#x1-80496">6<!--tex4ht:ref: makeindex.relatex --></a> if you have any
cross-references which can’t be indexed until the glossary file has been created.
<a
- id="x1-7052r3"></a>
+ id="x1-8052r3"></a>
-</p><!--l. 1443--><p class="noindent" >
+</p><!--l. 1466--><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="x1-90003"></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. 1445--><p class="noindent" >Example document: </p><div class="alltt">
+<!--l. 1468--><p class="noindent" >Example document: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\documentclass{article}</span>
@@ -3867,7 +3906,7 @@
class="cmtt-10">]{glossaries}</span>
<br /><strong><span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-8001"></a></strong><span
+ id="dx1-9001"></a></strong><span
class="cmtt-10"> %</span><span
class="cmtt-10"> open</span><span
class="cmtt-10"> glossary</span><span
@@ -3876,89 +3915,89 @@
</div>
- <pre class="verbatim" id="verbatim-16">
+ <pre class="verbatim" id="verbatim-18">
\newglossaryentry{sample}{name={sample},
 description={an example}}
\begin{document}
\gls{sample}.
</pre>
-<!--l. 1456--><p class="nopar" > </p><div class="alltt">
+<!--l. 1479--><p class="nopar" > </p><div class="alltt">
<div class="obeylines-v">
<strong><span
class="cmtt-10">\printglossary</span><a
- id="dx1-8002"></a></strong>
+ id="dx1-9002"></a></strong>
<br /><span
class="cmtt-10">\end{document}</span>
</div>
</div> You can place all your entry definitions in a separate file and load it in the preamble with <span
class="cmtt-10">\loadglsentries</span><a
- id="dx1-8003"></a>
+ id="dx1-9003"></a>
(<span
class="cmti-10">after </span><span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-8004"></a>).
-<!--l. 1465--><p class="indent" > This option uses a <a
+ id="dx1-9004"></a>).
+<!--l. 1488--><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
- id="dx1-8005"></a></a> to sort the entries. This application is more flexible than
+ id="dx1-9005"></a></a> to sort the entries. This application is more flexible than
<span
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. 1470--><p class="indent" > The <a
+</p><!--l. 1493--><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
+ id="dx1-9006"></a></a> application comes with both TeX Live and MiKTeX, but since <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8007"></a></a> is a Perl script, you will
+ id="dx1-9007"></a></a> is a Perl script, you will
also need to install Perl, if you don’t already have it. In a similar way to <a
href="#option2">Option 2</a>, this option involves making
LaTeX write the glossary information to a temporary file which <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8008"></a></a> reads. Then <a
+ id="dx1-9008"></a></a> reads. Then <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8009"></a></a> writes a new file
+ id="dx1-9009"></a></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. 1478--><p class="indent" > This is the best option with just the base <span
+</p><!--l. 1501--><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
+class="cmbx-10">14</span> </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">
- <!--l. 1484--><p class="noindent" >entries with the same sort value are merged by <span
+ <!--l. 1507--><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
+ id="dx1-9010"></a> into a single glossary line so you must make
sure that each entry has a unique sort value;
</p></li>
<li class="itemize">
- <!--l. 1487--><p class="noindent" ><span
+ <!--l. 1510--><p class="noindent" ><span
class="cmtt-10">xindy</span><a
- id="dx1-8011"></a> forbids empty sort values;
+ id="dx1-9011"></a> forbids empty sort values;
</p></li>
<li class="itemize">
- <!--l. 1488--><p class="noindent" ><span
+ <!--l. 1511--><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
+ id="dx1-9012"></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
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.</p></li></ul>
-<!--l. 1493--><p class="noindent" >In these problematic cases, you must set the <span
+ id="dx1-9013"></a> forbids.</p></li></ul>
+<!--l. 1516--><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">
+ id="dx1-9014"></a> field explicitly. For example: </p><div class="alltt">
<div class="obeylines-v">
@@ -3970,22 +4009,22 @@
class="cmtt-10">description={...}}</span>
</div>
</div>
-<!--l. 1499--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+<!--l. 1522--><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
- id="dx1-8015"></a> package option that provides <span id="textcolor85"><span
+ id="dx1-9015"></a> package option that provides <span id="textcolor85"><span
class="cmtt-10">\glsxtrnewsymbol</span></span><a
- id="dx1-8016"></a>, which
+ id="dx1-9016"></a>, which
automatically sets the <span
class="cmtt-10">sort</span><a
- id="dx1-8017"></a> key to the entry label (instead of the <span
+ id="dx1-9017"></a> key to the entry label (instead of the <span
class="cmtt-10">name</span><a
- id="dx1-8018"></a>). </div>
-</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
+ id="dx1-9018"></a>). </div>
+</p><!--l. 1526--><p class="noindent" >
+</p><!--l. 1528--><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. 1508--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 1531--><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
@@ -3996,30 +4035,30 @@
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> documentation for further details.
</div>
-</p><!--l. 1513--><p class="noindent" >
-</p><!--l. 1515--><p class="indent" > Summary:
+</p><!--l. 1536--><p class="noindent" >
+</p><!--l. 1538--><p class="indent" > Summary:
</p><ol class="enumerate1" >
<li
- class="enumerate" id="x1-8020x1">
- <!--l. 1517--><p class="noindent" >Add the <span
+ class="enumerate" id="x1-9020x1">
+ <!--l. 1540--><p class="noindent" >Add the <span
class="cmss-10">xindy</span><a
- id="dx1-8021"></a> option to the <span
+ id="dx1-9021"></a> option to the <span
class="cmss-10">glossaries </span>package option list:
</p>
- <pre class="verbatim" id="verbatim-17">
+ <pre class="verbatim" id="verbatim-19">
\usepackage[xindy]{glossaries}
</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
+ <!--l. 1544--><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>
- <pre class="verbatim" id="verbatim-18">
+ <pre class="verbatim" id="verbatim-20">
\usepackage[xindy={glsnumbers=false}]{glossaries}
</pre>
- <!--l. 1526--><p class="nopar" > or use either <span
+ <!--l. 1549--><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
@@ -4029,25 +4068,25 @@
class="cmtt-10">} </span>to indicate where the number group should be placed (see
<a
href="#sec:xindy">§<span
-class="cmbx-10">??</span>sec:xindy </a><a
+class="cmbx-10">14</span> </a><a
href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a>).
</p></li>
<li
- class="enumerate" id="x1-8023x2">
- <!--l. 1532--><p class="noindent" >Add <span
+ class="enumerate" id="x1-9023x2">
+ <!--l. 1555--><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
+class="cmbx-10">4</span> </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="enumerate" id="x1-9025x3">
+ <!--l. 1558--><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
+ id="dx1-9026"></a> and <span
class="cmtt-10">xdy</span><a
- id="dx1-8027"></a> (for example, if your
+ id="dx1-9027"></a> (for example, if your
LaTeX document is called <span
class="cmtt-10">myDoc.tex</span>, then you’ll have two extra files called <span
class="cmtt-10">myDoc.glo </span>and <span
@@ -4057,17 +4096,17 @@
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> extension package, you’ll see the section header and some boilerplate
text.)
- </p><!--l. 1544--><p class="noindent" >If you have used package options such as <span
+ </p><!--l. 1567--><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
+ id="dx1-9028"></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">
- <!--l. 1548--><p class="noindent" >Run <a
+ class="enumerate" id="x1-9030x4">
+ <!--l. 1571--><p class="noindent" >Run <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8031"></a></a> with the <span
+ id="dx1-9031"></a></a> with the <span
class="cmtt-10">.glo </span>file as the input file and the <span
class="cmtt-10">.xdy </span>file as a module so that it creates an output
file with the extension <span
@@ -4075,7 +4114,7 @@
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):
- </p><!--l. 1556--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ </p><!--l. 1579--><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>
@@ -4086,78 +4125,78 @@
class="cmtt-10">utf8 </span>with your input encoding, for
example, <span
class="cmtt-10">-L</span><a
- id="dx1-8032"></a> <span
+ id="dx1-9032"></a> <span
class="cmtt-10">german -C</span><a
- id="dx1-8033"></a> <span
+ id="dx1-9033"></a> <span
class="cmtt-10">din5007-utf8</span>.)
- </p><!--l. 1565--><p class="noindent" ><div class="important" title="Important Note"> The file extensions vary according to the glossary <span
+ </p><!--l. 1588--><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
+ id="dx1-9034"></a>. See <a
href="#sec:xindyapp">§<span
-class="cmbx-10">??</span>sec:xindyapp </a><a
+class="cmbx-10">1.5.3</span> </a><a
href="#sec:xindyapp">Using <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8035"></a></a> explicitly
+ id="dx1-9035"></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. 1569--><p class="noindent" >
- </p><!--l. 1571--><p class="noindent" >It’s much simpler to use <a
+ id="dx1-9036"></a></a> must be called for each set of files. </div>
+ </p><!--l. 1592--><p class="noindent" >
+ </p><!--l. 1594--><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. 1572--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-9037"></a></a> instead:
+ </p><!--l. 1595--><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
class="cmtt-10">aux</span><a
- id="dx1-8038"></a>
+ id="dx1-9038"></a>
file and run <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. 1580--><p class="noindent" >There’s no benefit in using <a
+ id="dx1-9039"></a></a> the appropriate number of times with all the necessary switches.
+ </p><!--l. 1603--><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
+ id="dx1-9040"></a></a> with <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8041"></a></a>. (Remember that <a
+ id="dx1-9041"></a></a>. (Remember that <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8042"></a></a> is a Perl
+ id="dx1-9042"></a></a> is a Perl
script so if you can use <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8043"></a></a> then you can also use <a
+ id="dx1-9043"></a></a> then you can also use <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-8044"></a></a>, and if you don’t want
+ id="dx1-9044"></a></a>, and if you don’t want
to use <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-8045"></a></a> because you don’t want to install Perl, then you can’t use <a
+ id="dx1-9045"></a></a> because you don’t want to install Perl, then you can’t use <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8046"></a></a>
+ id="dx1-9046"></a></a>
either.)
- </p><!--l. 1586--><p class="noindent" >If you don’t know how to use the command prompt, then you can probably access <a
+ </p><!--l. 1609--><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
+ id="dx1-9047"></a></a> or
<a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-8048"></a></a> via your text editor, but each editor has a different method of doing this. See
+ id="dx1-9048"></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. 1592--><p class="noindent" >Again, a convenient method is to use <span
+ </p><!--l. 1615--><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">
@@ -4175,57 +4214,57 @@
class="cmtt-10"> pdflatex</span>
</div>
</div>
- <!--l. 1600--><p class="noindent" >The default sort is word order (“sea lion” comes before “seal”). If you want letter ordering you need to
+ <!--l. 1623--><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
class="cmss-10">letter</span><a
- id="dx1-8049"></a> package option:
+ id="dx1-9049"></a> package option:
</p>
- <pre class="verbatim" id="verbatim-19">
+ <pre class="verbatim" id="verbatim-21">
\usepackage[xindy,order=letter]{glossaries}
</pre>
- <!--l. 1605--><p class="nopar" > (and return to the previous step). This option is picked up by <a
+ <!--l. 1628--><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
+ id="dx1-9050"></a></a>. If you are explicitly using
<a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8051"></a></a> then you’ll need to add <span
+ id="dx1-9051"></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">§<span
-class="cmbx-10">??</span>sec:xindyapp </a><a
+class="cmbx-10">1.5.3</span> </a><a
href="#sec:xindyapp">Using <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-8052"></a></a>
+ id="dx1-9052"></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.
+ id="dx1-9053"></a> explicitly.
</p></li>
<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
+ class="enumerate" id="x1-9055x5">
+ <!--l. 1635--><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
+ id="dx1-9056"></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. 1619--><p class="noindent" >
+ id="x1-9057r4"></a>
+<!--l. 1642--><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="x1-100004"></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. 1621--><p class="noindent" ><br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a
+<!--l. 1644--><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
@@ -4233,10 +4272,10 @@
<a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-9001"></a></a> to both fetch entry definitions from <span
+ id="dx1-10001"></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. 1626--><p class="indent" > Example document: </p><div class="alltt">
+ id="dx1-10002"></a> files and to hierarchically sort and collate.
+</p><!--l. 1649--><p class="indent" > Example document: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\documentclass{article}</span>
@@ -4246,10 +4285,10 @@
class="cmtt-10">]{glossaries-extra}</span>
<br /><span id="textcolor87"><span
class="cmtt-10">\GlsXtrLoadResources</span></span><a
- id="dx1-9003"></a><span
+ id="dx1-10003"></a><span
class="cmtt-10">[</span><span id="textcolor88"><span
class="cmtt-10">src</span></span><a
- id="dx1-9004"></a><span
+ id="dx1-10004"></a><span
class="cmtt-10">={entries}]</span>
<br /><span
class="cmtt-10">\begin{document}</span>
@@ -4259,7 +4298,7 @@
class="cmtt-10"> \gls{html}.</span>
<br /><span id="textcolor89"><span
class="cmtt-10">\printunsrtglossary</span></span><a
- id="dx1-9005"></a>
+ id="dx1-10005"></a>
<br /><span
class="cmtt-10">\end{document}</span>
</div>
@@ -4270,7 +4309,7 @@
<div class="obeylines-v">
<span id="textcolor90"><span
class="cmtt-10">@entry</span></span><a
- id="dx1-9006"></a><span
+ id="dx1-10006"></a><span
class="cmtt-10">{sample,</span>
<br /><span
class="cmtt-10"> </span><span
@@ -4283,7 +4322,7 @@
class="cmtt-10">}</span>
<br /><span id="textcolor91"><span
class="cmtt-10">@symbol</span></span><a
- id="dx1-9007"></a><span
+ id="dx1-10007"></a><span
class="cmtt-10">{alpha,</span>
<br /><span
class="cmtt-10"> </span><span
@@ -4295,7 +4334,7 @@
class="cmtt-10">}</span>
<br /><span id="textcolor92"><span
class="cmtt-10">@abbreviation</span></span><a
- id="dx1-9008"></a><span
+ id="dx1-10008"></a><span
class="cmtt-10">{html,</span>
<br /><span
class="cmtt-10"> </span><span
@@ -4309,39 +4348,39 @@
class="cmtt-10">}</span>
</div>
</div>
-<!--l. 1652--><p class="indent" > All entries must be provided in one or more <span
+<!--l. 1675--><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
+ id="dx1-10009"></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
+ id="dx1-10010"></a></a> user manual for the required
format.
-</p><!--l. 1655--><p class="indent" > <div class="important" title="Important Note"> Note that the <span
+</p><!--l. 1678--><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
+ id="dx1-10011"></a> key should not be used. Each entry type (<span id="textcolor93"><span
class="cmtt-10">@entry</span></span><a
- id="dx1-9012"></a>, <span id="textcolor94"><span
+ id="dx1-10012"></a>, <span id="textcolor94"><span
class="cmtt-10">@symbol</span></span><a
- id="dx1-9013"></a>, <span id="textcolor95"><span
+ id="dx1-10013"></a>, <span id="textcolor95"><span
class="cmtt-10">@abbreviation</span></span><a
- id="dx1-9014"></a>)
+ id="dx1-10014"></a>)
has a particular field that’s used for the sort value by default (<span
class="cmtt-10">name</span><a
- id="dx1-9015"></a>, the label, <span
+ id="dx1-10015"></a>, the label, <span
class="cmtt-10">short</span><a
- id="dx1-9016"></a>). You will
+ id="dx1-10016"></a>). You will
break this mechanism if you explicitly use the <span
class="cmtt-10">sort</span><a
- id="dx1-9017"></a> key. See <a
+ id="dx1-10017"></a> key. See <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. 1662--><p class="noindent" >
-</p><!--l. 1664--><p class="indent" > The <a
+</p><!--l. 1685--><p class="noindent" >
+</p><!--l. 1687--><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
- id="dx1-9018"></a> package option: </p><div class="alltt">
+ id="dx1-10018"></a> package option: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\usepackage[</span><span id="textcolor97"><span
@@ -4360,7 +4399,7 @@
class="cmss-10">glossaries-extra</span></a> v1.37 and <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-9019"></a></a> v1.8): <div class="alltt">
+ id="dx1-10019"></a></a> v1.8): <div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\usepackage[</span><span id="textcolor99"><span
@@ -4371,18 +4410,18 @@
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. 1679--><p class="indent" > (It’s possible to use a hybrid of this method and Options <a
+ id="dx1-10020"></a> option is the best method.
+<!--l. 1702--><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">hybrid</span></span><a
- id="dx1-9021"></a> but in general there is
+ id="dx1-10021"></a> but in general there is
little need for this and it complicates the build process.)
-</p><!--l. 1683--><p class="indent" > Each resource set is loaded with <span id="textcolor102"><span
+</p><!--l. 1706--><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
+ id="dx1-10022"></a><span
class="cmtt-10">[</span>⟨<span
class="cmti-10">options</span>⟩<span
class="cmtt-10">]</span>. For example: </p><div class="alltt">
@@ -4391,7 +4430,7 @@
<div class="obeylines-v">
<span id="textcolor103"><span
class="cmtt-10">\GlsXtrLoadResources</span></span><a
- id="dx1-9023"></a>
+ id="dx1-10023"></a>
<br /><span
class="cmtt-10">[%</span><span
class="cmtt-10"> definitions</span><span
@@ -4402,12 +4441,12 @@
<br /><span
class="cmtt-10"> </span><span id="textcolor104"><span
class="cmtt-10">src</span></span><a
- id="dx1-9024"></a><span
+ id="dx1-10024"></a><span
class="cmtt-10">={entries1,entries2},</span>
<br /><span
class="cmtt-10"> </span><span id="textcolor105"><span
class="cmtt-10">sort</span></span><a
- id="dx1-9025"></a><span
+ id="dx1-10025"></a><span
class="cmtt-10">={de-CH-1996}%</span><span
class="cmtt-10"> sort</span><span
class="cmtt-10"> according</span><span
@@ -4419,38 +4458,38 @@
</div>
</div> The <span
class="cmtt-10">bib</span><a
- id="dx1-9026"></a> files are identified as a comma-separated list in the value of the <span id="textcolor106"><span
+ id="dx1-10026"></a> files are identified as a comma-separated list in the value of the <span id="textcolor106"><span
class="cmtt-10">src</span></span><a
- id="dx1-9027"></a> key. The <span id="textcolor107"><span
+ id="dx1-10027"></a> key. The <span id="textcolor107"><span
class="cmtt-10">sort</span></span><a
- id="dx1-9028"></a> option identifies the
+ id="dx1-10028"></a> option identifies the
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. 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
+<!--l. 1723--><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
- id="dx1-9029"></a>. (There are also ways of filtering the selection or you can even have a
+ id="dx1-10029"></a>. (There are also ways of filtering the selection or you can even have a
random selection by shuffling and truncating the list. See the <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-9030"></a></a> user manual for further
+ id="dx1-10030"></a></a> user manual for further
details.)
-</p><!--l. 1706--><p class="indent" > The glossary is displayed using: </p><div class="alltt">
+</p><!--l. 1729--><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
- id="dx1-9031"></a>
+ id="dx1-10031"></a>
</div>
</div> Alternatively all glossaries can be displayed using the iterative command: <div class="alltt">
<div class="obeylines-v">
<span id="textcolor110"><span
class="cmtt-10">\printunsrtglossaries</span></span><a
- id="dx1-9032"></a>
+ id="dx1-10032"></a>
</div>
</div> The document is built using:
-<!--l. 1716--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+<!--l. 1739--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
<br />pdflatex myDoc
<br />bib2gls myDoc
<br />pdflatex myDoc
@@ -4458,14 +4497,14 @@
<br /></span>
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. 1722--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-10033"></a> switch:
+</p><!--l. 1745--><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>
or with <span
class="cmtt-10">arara</span><a
- id="dx1-9034"></a>: </p><div class="alltt">
+ id="dx1-10034"></a>: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">%</span><span
@@ -4479,7 +4518,7 @@
</div>
</div> (You will also need an appropriate glossary style.)
-<!--l. 1731--><p class="indent" > Unlike Options <a
+<!--l. 1754--><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
@@ -4488,59 +4527,59 @@
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. 1740--><p class="indent" > This method supports Unicode and uses the Common Locale Data Repository, which provides more extensive language support
+</p><!--l. 1763--><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
- id="dx1-9035"></a></a>.<span class="footnote-mark"><a
+ id="dx1-10035"></a></a>.<span class="footnote-mark"><a
href="#fn2x1" id="fn2x1-bk"><sup class="textsuperscript">1.2</sup></a></span><a
- id="x1-9036f2"></a> The
+ id="x1-10036f2"></a> The
locations in the <a
href="#glo:numberlist">number list<a
- id="dx1-9038"></a></a> may be in any format. If <a
+ id="dx1-10038"></a></a> may be in any format. If <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-9039"></a></a> can deduce a numerical value it will attempt to
+ id="dx1-10039"></a></a> can deduce a numerical value it will attempt to
form ranges otherwise it will simply list the locations.
-</p><!--l. 1748--><p class="indent" > Summary:
+</p><!--l. 1771--><p class="indent" > Summary:
</p><ol class="enumerate1" >
<li
- class="enumerate" id="x1-9041x1">
- <!--l. 1750--><p class="noindent" >Use <a
+ class="enumerate" id="x1-10041x1">
+ <!--l. 1773--><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:
+ id="dx1-10042"></a>ackage option:
</p>
- <pre class="verbatim" id="verbatim-20">
+ <pre class="verbatim" id="verbatim-22">
\usepackage[record]{glossaries-extra}
</pre>
- <!--l. 1754--><p class="nopar" >
+ <!--l. 1777--><p class="nopar" >
</p></li>
<li
- class="enumerate" id="x1-9044x2">
- <!--l. 1756--><p class="noindent" >Use <span
+ class="enumerate" id="x1-10044x2">
+ <!--l. 1779--><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
+ id="dx1-10045"></a> file(s) and <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-9046"></a></a> options:
+ id="dx1-10046"></a></a> options:
</p>
- <pre class="verbatim" id="verbatim-21">
+ <pre class="verbatim" id="verbatim-23">
\GlsXtrLoadResources[src={terms.bib,abbreviations.bib},sort=en]
</pre>
- <!--l. 1760--><p class="nopar" >
+ <!--l. 1783--><p class="nopar" >
</p></li>
<li
- class="enumerate" id="x1-9048x3">
- <!--l. 1762--><p class="noindent" >Put </p><div class="alltt">
+ class="enumerate" id="x1-10048x3">
+ <!--l. 1785--><p class="noindent" >Put </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\*printunsrtglossary</span>
@@ -4554,41 +4593,41 @@
</div>
</li>
<li
- class="enumerate" id="x1-9050x4">
- <!--l. 1772--><p class="noindent" >Run LaTeX on your document.
+ class="enumerate" id="x1-10050x4">
+ <!--l. 1795--><p class="noindent" >Run LaTeX on your document.
</p></li>
<li
- class="enumerate" id="x1-9052x5">
- <!--l. 1774--><p class="noindent" >Run <a
+ class="enumerate" id="x1-10052x5">
+ <!--l. 1797--><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.
+ id="dx1-10053"></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.
+ class="enumerate" id="x1-10055x6">
+ <!--l. 1799--><p class="noindent" >Run LaTeX on your document.
</p>
</li></ol>
-<!--l. 1780--><p class="indent" > See <a
+<!--l. 1803--><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-9056"></a></a> user manual for further details of
+ id="dx1-10056"></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-9057r5"></a>
-</p><!--l. 1786--><p class="noindent" >
+ id="x1-10057r5"></a>
+</p><!--l. 1809--><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="x1-110005"></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. 1788--><p class="noindent" ><br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a
+<!--l. 1811--><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
@@ -4595,11 +4634,11 @@
class="cmss-10">glossaries-extra</span></a>. No <a
href="#glo:indexingapp">indexing application</a>
is required.
-</p><!--l. 1792--><p class="indent" > Example document:
+</p><!--l. 1815--><p class="indent" > Example document:
</p>
- <pre class="verbatim" id="verbatim-22">
+ <pre class="verbatim" id="verbatim-24">
\documentclass{article}
\usepackage[sort=none]{glossaries-extra}
\newglossaryentry{sample}{name={sample},
@@ -4609,20 +4648,20 @@
\begin{document}
\gls{sample}.
</pre>
-<!--l. 1802--><p class="nopar" > </p><div class="alltt">
+<!--l. 1825--><p class="nopar" > </p><div class="alltt">
<div class="obeylines-v">
<span id="textcolor113"><span
class="cmtt-10">\printunsrtglossary</span></span><a
- id="dx1-10001"></a>
+ id="dx1-11001"></a>
<br /><span
class="cmtt-10">\end{document}</span>
</div>
</div>
-<!--l. 1808--><p class="indent" > This method is best used with the package option <span
+<!--l. 1831--><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
- id="dx1-10002"></a> (as shown above). There’s no “activation”
+ id="dx1-11002"></a> (as shown above). There’s no “activation”
command (such as <span
class="cmtt-10">\makeglossaries </span>for Options <a
href="#option2">2</a> and <a
@@ -4631,7 +4670,7 @@
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
+</p><!--l. 1839--><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
@@ -4640,18 +4679,18 @@
order.) You can place all your entry definitions in a separate file and load it in the preamble with
<span
class="cmtt-10">\loadglsentries</span><a
- id="dx1-10003"></a>.
-</p><!--l. 1827--><p class="indent" > The glossary is displayed using: </p><div class="alltt">
+ id="dx1-11003"></a>.
+</p><!--l. 1850--><p class="indent" > The glossary is displayed using: </p><div class="alltt">
<div class="obeylines-v">
<span id="textcolor114"><span
class="cmtt-10">\printunsrtglossary</span></span><a
- id="dx1-10004"></a>
+ id="dx1-11004"></a>
</div>
</div> Alternatively all glossaries can be displayed using the iterative command: <div class="alltt">
<div class="obeylines-v">
<span id="textcolor115"><span
class="cmtt-10">\printunsrtglossaries</span></span><a
- id="dx1-10005"></a>
+ id="dx1-11005"></a>
</div>
@@ -4659,26 +4698,26 @@
class="cmti-10">all </span>defined entries, regardless of whether or not they have been used in the document. The
<a
href="#glo:numberlist">number list<a
- id="dx1-10006"></a>s</a> have to be set explicitly otherwise they won’t appear. Note that this uses the same command for
+ id="dx1-11006"></a>s</a> have to be set explicitly otherwise they won’t appear. Note that this uses the same command for
displaying the glossary as <a
href="#option4">Option 4</a>. This is because <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-10007"></a></a> takes advantage of this method by defining the
+ id="dx1-11007"></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. 1844--><p class="indent" > Therefore, the above example document has a glossary containing the entries: sample and <span
+<!--l. 1867--><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. 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">
+</p><!--l. 1872--><p class="indent" > This just requires a single LaTeX call:
+</p><!--l. 1873--><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. 1855--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 1878--><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>
@@ -4685,17 +4724,17 @@
<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. 1863--><p class="indent" > See the <a
+</p><!--l. 1886--><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. 1865--><p class="noindent" >
+ id="x1-11008r6"></a>
+</p><!--l. 1888--><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="x1-120006"></a><a title="anchor" style="font-size: x-small; text-decoration: none;" href="#option6">🔗</a><a
id="option6"></a>Option 6 (standalone)</h4>
-<!--l. 1867--><p class="noindent" ><br/><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em; "><a
+<!--l. 1890--><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
@@ -4702,18 +4741,18 @@
class="cmss-10">glossaries-extra</span></a> extension
package.<span class="footnote-mark"><a
href="#fn3x1" id="fn3x1-bk"><sup class="textsuperscript">1.3</sup></a></span><a
- id="x1-11001f3"></a>
+ id="x1-12001f3"></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. 1877--><p class="indent" > You can either define entries in the document preamble (or in an external file loaded with <span
+</p><!--l. 1900--><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
+ id="dx1-12004"></a>), as
with <a
href="#option5">Option 5</a>, for example:
</p>
- <pre class="verbatim" id="verbatim-23">
+ <pre class="verbatim" id="verbatim-25">
\documentclass{article}
\usepackage[colorlinks]{hyperref}
\usepackage[sort=none,
@@ -4729,7 +4768,7 @@
  symbol={\ensuremath{f(x)}}
}
</pre>
-<!--l. 1897--><p class="nopar" > </p><div class="alltt">
+<!--l. 1920--><p class="nopar" > </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newcommand*{\termdef}[1]{%</span>
@@ -4737,15 +4776,15 @@
class="cmtt-10"> </span><span
class="cmtt-10"> \section{</span><span id="textcolor116"><span
class="cmtt-10">\glsxtrglossentry</span></span><a
- id="dx1-11005"></a><span
+ id="dx1-12005"></a><span
class="cmtt-10">{#1}</span><span
class="cmtt-10"> \glsentrysymbol</span><a
- id="dx1-11006"></a><span
+ id="dx1-12006"></a><span
class="cmtt-10">{#1}}%</span>
<br /><span
class="cmtt-10"> </span><span
class="cmtt-10"> \begin{quote}\em\Glsentrydesc</span><a
- id="dx1-11007"></a><span
+ id="dx1-12007"></a><span
class="cmtt-10">{#1}.\end{quote}%</span>
<br /><span
class="cmtt-10">}</span>
@@ -4753,7 +4792,7 @@
</div>
- <pre class="verbatim" id="verbatim-24">
+ <pre class="verbatim" id="verbatim-26">
\begin{document}
\tableofcontents
\section{Introduction}
@@ -4764,10 +4803,10 @@
More detailed information about \glspl{function} with examples.
\end{document}
</pre>
-<!--l. 1920--><p class="nopar" > Or you can use <a
+<!--l. 1943--><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
+ id="dx1-12008"></a></a> if you want to manage a large database of terms. For example (requires <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>
v1.42, see below): </p><div class="alltt">
@@ -4797,16 +4836,16 @@
<br />
<br /><span id="textcolor118"><span
class="cmtt-10">\GlsXtrLoadResources</span></span><a
- id="dx1-11009"></a><span
+ id="dx1-12009"></a><span
class="cmtt-10">[</span><span id="textcolor119"><span
class="cmtt-10">src</span></span><a
- id="dx1-11010"></a><span
+ id="dx1-12010"></a><span
class="cmtt-10">=terms,</span><span id="textcolor120"><span
class="cmtt-10">sort</span></span><a
- id="dx1-11011"></a><span
+ id="dx1-12011"></a><span
class="cmtt-10">=none,</span><span id="textcolor121"><span
class="cmtt-10">save-locations</span></span><a
- id="dx1-11012"></a><span
+ id="dx1-12012"></a><span
class="cmtt-10">=false]</span>
<br />
<br /><span
@@ -4815,16 +4854,16 @@
class="cmtt-10"> </span><span
class="cmtt-10"> \section{</span><span id="textcolor122"><span
class="cmtt-10">\glsxtrglossentry</span></span><a
- id="dx1-11013"></a><span
+ id="dx1-12013"></a><span
class="cmtt-10">{#1}</span><span
class="cmtt-10"> </span><strong><span
class="cmtt-10">\glossentrysymbol</span><a
- id="dx1-11014"></a></strong><span
+ id="dx1-12014"></a></strong><span
class="cmtt-10">{#1}}%</span>
<br /><span
class="cmtt-10"> </span><span
class="cmtt-10"> \glsadd</span><a
- id="dx1-11015"></a><span
+ id="dx1-12015"></a><span
class="cmtt-10">{#1}%</span><span
class="cmtt-10"> <-</span><span
class="cmtt-10"> index</span><span
@@ -4833,7 +4872,7 @@
<br /><span
class="cmtt-10"> </span><span
class="cmtt-10"> \begin{quote}\em\Glsentrydesc</span><a
- id="dx1-11016"></a><span
+ id="dx1-12016"></a><span
class="cmtt-10">{#1}.\end{quote}%</span>
<br /><span
class="cmtt-10">}</span>
@@ -4841,7 +4880,7 @@
</div>
- <pre class="verbatim" id="verbatim-25">
+ <pre class="verbatim" id="verbatim-27">
\begin{document}
\tableofcontents
\section{Introduction}
@@ -4852,12 +4891,12 @@
More detailed information about \glspl{function} with examples.
\end{document}
</pre>
-<!--l. 1955--><p class="nopar" > Where the file <span
+<!--l. 1978--><p class="nopar" > Where the file <span
class="cmtt-10">terms.bib </span>contains: </p><div class="alltt">
<div class="obeylines-v">
<span id="textcolor123"><span
class="cmtt-10">@entry</span></span><a
- id="dx1-11017"></a><span
+ id="dx1-12017"></a><span
class="cmtt-10">{set,</span>
<br /><span
class="cmtt-10"> </span><span
@@ -4878,7 +4917,7 @@
class="cmtt-10">}</span>
<br /><span id="textcolor124"><span
class="cmtt-10">@entry</span></span><a
- id="dx1-11018"></a><span
+ id="dx1-12018"></a><span
class="cmtt-10">{function,</span>
<br /><span
class="cmtt-10"> </span><span
@@ -4912,24 +4951,24 @@
</div>
</div> The advantage in this approach (with <span
class="cmtt-10">\loadglsentries</span><a
- id="dx1-11019"></a> or <a
+ id="dx1-12019"></a> or <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-11020"></a></a>) is that you can use an existing database
+ id="dx1-12020"></a></a>) is that you can use an existing database
of entries shared across multiple documents, ensuring consistent notation for all of them.
-<!--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
+<!--l. 1998--><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. 1979--><p class="indent" > In the first case, you need the <span
+ id="dx1-12021"></a> package option to prevent them from being loaded.
+</p><!--l. 2002--><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
- id="dx1-11022"></a> package option (as in <a
+ id="dx1-12022"></a> package option (as in <a
href="#option5">Option 5</a>) and then define the terms in the
preamble. No external tool is required. Just run LaTeX as normal. (Twice to ensure that the table of contents is
up to date.)
-</p><!--l. 1983--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 2006--><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>
@@ -4936,21 +4975,21 @@
<br /></span>
-</p><!--l. 1988--><p class="indent" > In the second case, you need the <span id="textcolor125"><span
+</p><!--l. 2011--><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
+ id="dx1-12023"></a> package option (as in <a
href="#option4">Option 4</a>) since <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-11024"></a></a> is needed to select the
+ id="dx1-12024"></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="textcolor126"><span
class="cmtt-10">\GlsXtrLoadResources</span></span><a
- id="dx1-11025"></a><span
+ id="dx1-12025"></a><span
class="cmtt-10">[</span><span id="textcolor127"><span
class="cmtt-10">src</span></span><a
- id="dx1-11026"></a><span
+ id="dx1-12026"></a><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
@@ -4958,23 +4997,23 @@
</div>
</div> This will ensure that any entries indexed in the document (through commands like <span
class="cmtt-10">\gls</span><a
- id="dx1-11027"></a> or <span
+ id="dx1-12027"></a> or <span
class="cmtt-10">\glsadd</span><a
- id="dx1-11028"></a>) will be
+ id="dx1-12028"></a>) will be
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
+ id="dx1-12029"></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="textcolor129"><span
class="cmtt-10">save-locations</span></span><span
class="cmtt-10">=false</span><a
- id="dx1-11030"></a>.)
-<!--l. 2000--><p class="indent" > Remember that for this second case you need to run <a
+ id="dx1-12030"></a>.)
+<!--l. 2023--><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
+ id="dx1-12031"></a></a> as per <a
href="#option4">Option 4</a>:
-</p><!--l. 2001--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 2024--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
<br />pdflatex myDoc
<br />bib2gls myDoc
<br />pdflatex myDoc
@@ -4981,31 +5020,31 @@
<br />pdflatex myDoc
<br /></pre><spacer type=vertical size=10>
<br /></span>
-</p><!--l. 2008--><p class="indent" > For both cases (with or without <a
+</p><!--l. 2031--><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="textcolor130"><span
+ id="dx1-12032"></a></a>), instead of listing all the entries using <span id="textcolor130"><span
class="cmtt-10">\printunsrtglossary</span></span>, you
use <span id="textcolor131"><span
class="cmtt-10">\glsxtrglossentry</span></span><a
- id="dx1-11033"></a><span
+ id="dx1-12033"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
class="cmtt-10">} </span>where you want the name (and anchor with <span
class="cmss-10">hyperref</span><a
- id="dx1-11034"></a>) to appear in the
+ id="dx1-12034"></a>) to appear in the
document. This will allow the <a
href="#glo:linktext">link text<a
- id="dx1-11035"></a></a> created by commands like <span
+ id="dx1-12035"></a></a> created by commands like <span
class="cmtt-10">\gls </span>to link to that point in the document.
The description can simply be displayed with <span
class="cmtt-10">\glsentrydesc</span><a
- id="dx1-11036"></a><span
+ id="dx1-12036"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
class="cmtt-10">} </span>or <span
class="cmtt-10">\Glsentrydesc</span><a
- id="dx1-11037"></a><span
+ id="dx1-12037"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
class="cmtt-10">}</span>, as in the above
@@ -5013,30 +5052,30 @@
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. 2021--><p class="indent" > (Instead of using <span
+</p><!--l. 2044--><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
- id="dx1-11038"></a><span
+ id="dx1-12038"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
class="cmtt-10">}</span>, which
will obey attributes such as <span id="textcolor132"><span
class="cmss-10">glossdesc</span></span><a
- id="dx1-11039"></a> and <span id="textcolor133"><span
+ id="dx1-12039"></a> and <span id="textcolor133"><span
class="cmss-10">glossdescfont</span></span><a
- id="dx1-11040"></a>. See the <a
+ id="dx1-12040"></a>. See the <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> manual for further
details.)
-</p><!--l. 2026--><p class="indent" > The symbol (if required) can be displayed with either <span
+</p><!--l. 2049--><p class="indent" > The symbol (if required) can be displayed with either <span
class="cmtt-10">\glsentrysymbol</span><a
- id="dx1-11041"></a><span
+ id="dx1-12041"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
class="cmtt-10">} </span>or <span
class="cmtt-10">\glossentrysymbol</span><a
- id="dx1-11042"></a>
+ id="dx1-12042"></a>
<span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
@@ -5043,43 +5082,43 @@
class="cmtt-10">}</span>. In the first example, I’ve used <span
class="cmtt-10">\glsentrysymbol</span>. In the second I’ve used <span
class="cmtt-10">\glossentrysymbol</span><a
- id="dx1-11043"></a>. The
+ id="dx1-12043"></a>. The
latter is necessary with <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-11044"></a></a> if the symbol needs to go in a section title as the entries aren’t defined on the
+ id="dx1-12044"></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. 2033--><p class="indent" > In normal document text, <span
+</p><!--l. 2056--><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,
+ id="dx1-12045"></a> file,
which triggers an error.
-</p><!--l. 2038--><p class="indent" > The <span
+</p><!--l. 2061--><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.
+ id="dx1-12046"></a> command performs an existence check, which triggers a warning if the entry is undefined.
(All entries will be undefined before the first <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-11047"></a></a> call.) You need at least <a
+ id="dx1-12047"></a></a> call.) You need at least <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> v1.42 to use this command in
a section title.<span class="footnote-mark"><a
href="#fn4x1" id="fn4x1-bk"><sup class="textsuperscript">1.4</sup></a></span><a
- id="x1-11048f4"></a>
+ id="x1-12048f4"></a>
If <span
class="cmss-10">hyperref</span><a
- id="dx1-11049"></a> has been loaded, this will use <span
+ id="dx1-12049"></a> has been loaded, this will use <span
class="cmtt-10">\texorpdfstring</span><a
- id="dx1-11050"></a> to allow a simple expansion for the PDF bookmarks
+ id="dx1-12050"></a> to allow a simple expansion for the PDF bookmarks
(see the <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> user manual for further details).
-</p><!--l. 2049--><p class="indent" > If you want to test if the <span
+</p><!--l. 2072--><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
+ id="dx1-12051"></a> field has been set, you need to use <span
class="cmtt-10">\ifglshassymbol</span><a
- id="dx1-11052"></a> outside of the section
+ id="dx1-12052"></a> outside of the section
title. For example: </p><div class="alltt">
@@ -5097,17 +5136,17 @@
class="cmtt-10">{#1}}}</span>
</div>
</div>
-<!--l. 2058--><p class="indent" > In both of the above examples, the section titles start with a lowercase character (because the <span
+<!--l. 2081--><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
+ id="dx1-12053"></a> value is
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
+ id="dx1-12054"></a> attribute. For
example: </p><div class="alltt">
<div class="obeylines-v">
<span id="textcolor137"><span
class="cmtt-10">\glssetcategoryattribute</span></span><a
- id="dx1-11055"></a><span
+ id="dx1-12055"></a><span
class="cmtt-10">{general}{glossname}{firstuc}</span>
</div>
</div> or (for title-case) <div class="alltt">
@@ -5114,33 +5153,33 @@
<div class="obeylines-v">
<span id="textcolor138"><span
class="cmtt-10">\glssetcategoryattribute</span></span><a
- id="dx1-11056"></a><span
+ id="dx1-12056"></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. 2072--><p class="indent" > In the second example, you can instead use <a
+<!--l. 2095--><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">
+ id="dx1-12057"></a></a> to apply a case-change: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\GlsXtrLoadResources[</span><span id="textcolor139"><span
class="cmtt-10">src</span></span><a
- id="dx1-11058"></a><span
+ id="dx1-12058"></a><span
class="cmtt-10">=terms,</span>
<br /><span
class="cmtt-10"> </span><span id="textcolor140"><span
class="cmtt-10">sort</span></span><a
- id="dx1-11059"></a><span
+ id="dx1-12059"></a><span
class="cmtt-10">=none,</span><span id="textcolor141"><span
class="cmtt-10">save-locations</span></span><a
- id="dx1-11060"></a><span
+ id="dx1-12060"></a><span
class="cmtt-10">=false</span><strong><span
class="cmtt-10">,</span>
<br /><span
class="cmtt-10"> </span><span id="textcolor142"><span
class="cmtt-10">replicate-fields</span></span><a
- id="dx1-11061"></a><span
+ id="dx1-12061"></a><span
class="cmtt-10">={name=text},</span>
<br /><span
class="cmtt-10"> </span><span id="textcolor143"><span
@@ -5152,26 +5191,26 @@
</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
+ id="dx1-12062"></a> for title-case.) This copies the <span
class="cmtt-10">name</span><a
- id="dx1-11063"></a> value to the <span
+ id="dx1-12063"></a> value to the <span
class="cmtt-10">text</span><a
- id="dx1-11064"></a> field and
+ id="dx1-12064"></a> field and
then applies a case-change to the <span
class="cmtt-10">name</span><a
- id="dx1-11065"></a> field (leaving the <span
+ id="dx1-12065"></a> field (leaving the <span
class="cmtt-10">text</span><a
- id="dx1-11066"></a> field unchanged). The name in the
+ id="dx1-12066"></a> field unchanged). The name in the
section titles now starts with a capital but the <a
href="#glo:linktext">link text<a
- id="dx1-11067"></a></a> produced by commands like <span
+ id="dx1-12067"></a></a> produced by commands like <span
class="cmtt-10">\gls</span><a
- id="dx1-11068"></a> is still
+ id="dx1-12068"></a> is still
lowercase.
-<!--l. 2088--><p class="indent" > In the first example (without <a
+<!--l. 2111--><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">
+ id="dx1-12069"></a></a>) you need to do this manually. For example: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry{set}{name={</span><strong><span
@@ -5197,28 +5236,28 @@
</div>
</div>
-<!--l. 2097--><p class="indent" > Note that if you use the default <span id="textcolor145"><span
+<!--l. 2120--><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
+ id="dx1-12070"></a> with <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-11071"></a></a>, it’s possible to combine Options <a
+ id="dx1-12071"></a></a>, it’s possible to combine Options <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="textcolor146"><span
class="cmss-10">bookindex</span></span><a
- id="dx1-11072"></a>, which is provided in the <span
+ id="dx1-12072"></a>, which is provided in the <span
class="cmss-10">glossary-bookindex</span><a
- id="dx1-11073"></a> package (bundled with <a
+ id="dx1-12073"></a> package (bundled with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>). I don’t
need any of the other style packages, so I can still keep the <span
class="cmss-10">nostyles</span><a
- id="dx1-11074"></a> option and just load <span
+ id="dx1-12074"></a> option and just load <span
class="cmss-10">glossary-bookindex</span><a
- id="dx1-11075"></a>:
+ id="dx1-12075"></a>:
</p><div class="alltt">
<div class="obeylines-v">
<span
@@ -5261,10 +5300,10 @@
<div class="obeylines-v">
<span id="textcolor150"><span
class="cmtt-10">\GlsXtrLoadResources</span></span><a
- id="dx1-11076"></a><span
+ id="dx1-12076"></a><span
class="cmtt-10">[</span><span id="textcolor151"><span
class="cmtt-10">src</span></span><a
- id="dx1-11077"></a><span
+ id="dx1-12077"></a><span
class="cmtt-10">=terms,%</span><span
class="cmtt-10"> definitions</span><span
class="cmtt-10"> in</span><span
@@ -5272,7 +5311,7 @@
<br /><span
class="cmtt-10"> </span><span id="textcolor152"><span
class="cmtt-10">sort</span></span><a
- id="dx1-11078"></a><span
+ id="dx1-12078"></a><span
class="cmtt-10">=en-GB,%</span><span
class="cmtt-10"> sort</span><span
class="cmtt-10"> by</span><span
@@ -5281,7 +5320,7 @@
<br /><span
class="cmtt-10"> </span><span id="textcolor153"><span
class="cmtt-10">replicate-fields</span></span><a
- id="dx1-11079"></a><span
+ id="dx1-12079"></a><span
class="cmtt-10">={name=text},</span>
<br /><span
class="cmtt-10"> </span><span id="textcolor154"><span
@@ -5294,22 +5333,22 @@
<div class="obeylines-v">
<span id="textcolor155"><span
class="cmtt-10">\printunsrtglossary</span></span><a
- id="dx1-11080"></a><span
+ id="dx1-12080"></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="textcolor156"><span
+ id="dx1-12081"></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="textcolor157"><span
class="cmtt-10">--group</span></span><a
- id="dx1-11082"></a> switch:
-<!--l. 2128--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-12082"></a> switch:
+<!--l. 2151--><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>
or if you are using <span
class="cmtt-10">arara</span><a
- id="dx1-11083"></a>: </p><div class="alltt">
+ id="dx1-12083"></a>: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">%</span><span
@@ -5323,122 +5362,122 @@
</div>
-<!--l. 2136--><p class="indent" > The <span id="textcolor158"><span
+<!--l. 2159--><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
+ id="dx1-12084"></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="textcolor159"><span
class="cmss-10">bookindex</span></span><a
- id="dx1-11085"></a> style so that it uses the <span
+ id="dx1-12085"></a> style so that it uses the <span
class="cmtt-10">text</span><a
- id="dx1-11086"></a> field instead. For example:
+ id="dx1-12086"></a> field instead. For example:
</p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\renewcommand*{</span><span id="textcolor160"><span
class="cmtt-10">\glsxtrbookindexname</span></span><a
- id="dx1-11087"></a><span
+ id="dx1-12087"></a><span
class="cmtt-10">}[1]{%</span>
<br /><span
class="cmtt-10"> </span><span
class="cmtt-10"> </span><span id="textcolor161"><span
class="cmtt-10">\glossentrynameother</span></span><a
- id="dx1-11088"></a><span
+ id="dx1-12088"></a><span
class="cmtt-10">{#1}{text}}</span>
</div>
</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. 2149--><p class="indent" > Note that on the first LaTeX run none of the entries will be defined. Once they are defined, the page
+<!--l. 2172--><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. 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
+</p><!--l. 2177--><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
+ id="dx1-12089"></a> in the <span
class="cmtt-10">bib</span><a
- id="dx1-11090"></a> file. For example: </p><div class="alltt">
+ id="dx1-12090"></a> file. For example: </p><div class="alltt">
<div class="obeylines-v">
<span id="textcolor163"><span
class="cmtt-10">@index</span></span><a
- id="dx1-11091"></a><span
+ id="dx1-12091"></a><span
class="cmtt-10">{element}</span>
<br /><span id="textcolor164"><span
class="cmtt-10">@index</span></span><a
- id="dx1-11092"></a><span
+ id="dx1-12092"></a><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
+ id="dx1-12093"></a></span><span
class="cmtt-10">={element}}</span>
</div>
</div> They can be used in the document as usual:
- <pre class="verbatim" id="verbatim-26">
+ <pre class="verbatim" id="verbatim-28">
The objects that make up a set are the \glspl{element}
or \glspl{member}.
</pre>
-<!--l. 2165--><p class="nopar" > See <a
+<!--l. 2188--><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
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-11094"></a></a> user manual for further
+ id="dx1-12094"></a></a> user manual for further
details.
-</p><!--l. 2169--><p class="indent" > The <span
+</p><!--l. 2192--><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">§<span
-class="cmbx-10">??</span>sec:samples </a><a
+class="cmbx-10">18</span> </a><a
href="#sec:samples">Sample Documents<!--tex4ht:ref: sec:samples --></a>.
-</p><!--l. 2173--><p class="noindent" >
+</p><!--l. 2196--><p class="noindent" >
</p>
-<!--l. 2173--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.2 </span> <a
+<!--l. 2196--><p class="noindent" ><a
+href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.3 </span> <a
id="sec:lipsum"></a>Dummy Entries for Testing</h3>
-<!--l. 2176--><p class="noindent" >In addition to the sample files described above, <span
+<!--l. 2199--><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
+ id="dx1-13001"></a> also provides some files containing lorum
ipsum dummy entries. These are provided for testing purposes and are on TeX’s path (in
<span
class="cmtt-10">tex/latex/glossaries/test-entries</span>) so they can be included via <span
class="cmtt-10">\input</span><a
- id="dx1-12002"></a> or <span
+ id="dx1-13002"></a> or <span
class="cmtt-10">\loadglsentries</span><a
- id="dx1-12003"></a>. The
+ id="dx1-13003"></a>. The
<a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> package provides <span
class="cmtt-10">bib</span><a
- id="dx1-12004"></a> versions of all these files for use with <a
+ id="dx1-13004"></a> versions of all these files for use with <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-12005"></a></a>. The files are as
+ id="dx1-13005"></a></a>. The files are as
follows:
</p><dl class="description"><dt class="description">
- <!--l. 2186--><p class="noindent" >
+ <!--l. 2209--><p class="noindent" >
<span
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:
+ <!--l. 2209--><p class="noindent" >These entries all have brief descriptions. For example:
</p>
- <pre class="verbatim" id="verbatim-27">
+ <pre class="verbatim" id="verbatim-29">
\newglossaryentry{lorem}{name={lorem},description={ipsum}}
</pre>
- <!--l. 2190--><p class="nopar" >
+ <!--l. 2213--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2192--><p class="noindent" >
+ <!--l. 2215--><p class="noindent" >
<span
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:
+ <!--l. 2215--><p class="noindent" >These entries all have long descriptions. For example:
</p>
- <pre class="verbatim" id="verbatim-28">
+ <pre class="verbatim" id="verbatim-30">
\newglossaryentry{loremipsum}{name={lorem ipsum},
description={dolor sit amet, consectetuer adipiscing
elit. Ut purus elit, vestibulum ut, placerat ac,
@@ -5445,17 +5484,17 @@
adipiscing vitae, felis. Curabitur dictum gravida
mauris.}}
</pre>
- <!--l. 2200--><p class="nopar" >
+ <!--l. 2223--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2202--><p class="noindent" >
+ <!--l. 2225--><p class="noindent" >
<span
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:
+ <!--l. 2225--><p class="noindent" >These entries all have multi-paragraph descriptions. For example:
</p>
- <pre class="verbatim" id="verbatim-29">
+ <pre class="verbatim" id="verbatim-31">
\longnewglossaryentry{loremi-ii}{name={lorem 1--2}}%
{%
Lorem ipsum ...
@@ -5462,54 +5501,54 @@
Nam dui ligula...
}
</pre>
- <!--l. 2211--><p class="nopar" >
+ <!--l. 2234--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2213--><p class="noindent" >
+ <!--l. 2236--><p class="noindent" >
<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
+ <!--l. 2236--><p class="noindent" >These entries all use the <span
class="cmtt-10">symbol</span><a
- id="dx1-12006"></a> key. For example:
+ id="dx1-13006"></a> key. For example:
</p>
- <pre class="verbatim" id="verbatim-30">
+ <pre class="verbatim" id="verbatim-32">
\newglossaryentry{alpha}{name={alpha},
symbol={\ensuremath{\alpha}},
description={Quisque ullamcorper placerat ipsum.}}
</pre>
- <!--l. 2219--><p class="nopar" >
+ <!--l. 2242--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2221--><p class="noindent" >
+ <!--l. 2244--><p class="noindent" >
<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
+ <!--l. 2244--><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-13007"></a> key isn’t used. Instead the symbol is stored in the <span
class="cmtt-10">name</span><a
- id="dx1-12008"></a> key.
+ id="dx1-13008"></a> key.
For example:
</p>
- <pre class="verbatim" id="verbatim-31">
+ <pre class="verbatim" id="verbatim-33">
\newglossaryentry{sym.alpha}{sort={alpha},
name={\ensuremath{\alpha}},
description={Quisque ullamcorper placerat ipsum.}}
</pre>
- <!--l. 2228--><p class="nopar" >
+ <!--l. 2251--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2230--><p class="noindent" >
+ <!--l. 2253--><p class="noindent" >
<span
class="cmbx-10">example-glossaries-images.tex</span> </p></dt><dd
class="description">
- <!--l. 2230--><p class="noindent" >These entries use the <span
+ <!--l. 2253--><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-13009"></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>
+ id="dx1-13010"></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:
@@ -5516,7 +5555,7 @@
</p>
- <pre class="verbatim" id="verbatim-32">
+ <pre class="verbatim" id="verbatim-34">
\longnewglossaryentry{sedfeugiat}{name={sed feugiat},
user1={example-image}}%
{%
@@ -5524,31 +5563,31 @@
Etiam...
}
</pre>
- <!--l. 2244--><p class="nopar" >
+ <!--l. 2267--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2246--><p class="noindent" >
+ <!--l. 2269--><p class="noindent" >
<span
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:
+ <!--l. 2269--><p class="noindent" >These entries are all abbreviations. For example:
</p>
- <pre class="verbatim" id="verbatim-33">
+ <pre class="verbatim" id="verbatim-35">
\newacronym[type=\glsdefaulttype]{lid}{LID}{lorem ipsum
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
+ <!--l. 2274--><p class="nopar" >
+ </p><!--l. 2275--><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="textcolor167"><span
+ id="dx1-13011"></a> is redefined to use <span id="textcolor167"><span
class="cmtt-10">\newabbreviation</span></span><a
- id="dx1-12012"></a>
+ id="dx1-13012"></a>
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
+ id="dx1-13013"></a></span> key set to <span
class="cmtt-10">acronym </span>(rather than the default <span
class="cmtt-10">abbreviation</span>). This means that you need
to set the abbreviation style for the <span
@@ -5556,38 +5595,38 @@
</p>
- <pre class="verbatim" id="verbatim-34">
+ <pre class="verbatim" id="verbatim-36">
\setabbreviationstyle[acronym]{long-short}
</pre>
- <!--l. 2261--><p class="nopar" > </div>
- </p><!--l. 2262--><p class="noindent" >
+ <!--l. 2284--><p class="nopar" > </div>
+ </p><!--l. 2285--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 2264--><p class="noindent" >
+ <!--l. 2287--><p class="noindent" >
<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
+ <!--l. 2287--><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:
+ id="dx1-13014"></a> key. For example:
</p>
- <pre class="verbatim" id="verbatim-35">
+ <pre class="verbatim" id="verbatim-37">
\newacronym[type=\glsdefaulttype,
  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
+ <!--l. 2295--><p class="nopar" >
+ </p><!--l. 2296--><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="textcolor170"><span
+ id="dx1-13015"></a> is redefined to use <span id="textcolor170"><span
class="cmtt-10">\newabbreviation</span></span><a
- id="dx1-12016"></a>
+ id="dx1-13016"></a>
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
+ id="dx1-13017"></a></span> key set to <span
class="cmtt-10">acronym </span>(rather than the default <span
class="cmtt-10">abbreviation</span>). This means that you need
to set the abbreviation style for the <span
@@ -5595,38 +5634,38 @@
</p>
- <pre class="verbatim" id="verbatim-36">
+ <pre class="verbatim" id="verbatim-38">
\setabbreviationstyle[acronym]{long-short-desc}
</pre>
- <!--l. 2282--><p class="nopar" > </div>
- </p><!--l. 2283--><p class="noindent" >
+ <!--l. 2305--><p class="nopar" > </div>
+ </p><!--l. 2306--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 2285--><p class="noindent" >
+ <!--l. 2308--><p class="noindent" >
<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
+ <!--l. 2308--><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
+ id="dx1-13018"></a> key. For
example:
</p>
- <pre class="verbatim" id="verbatim-37">
+ <pre class="verbatim" id="verbatim-39">
\newacronym[type=\glsdefaulttype,user1={love itself}]
 {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
+ <!--l. 2315--><p class="nopar" >
+ </p><!--l. 2316--><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="textcolor173"><span
+ id="dx1-13019"></a> is redefined to use <span id="textcolor173"><span
class="cmtt-10">\newabbreviation</span></span><a
- id="dx1-12020"></a>
+ id="dx1-13020"></a>
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
+ id="dx1-13021"></a></span> key set to <span
class="cmtt-10">acronym </span>(rather than the default <span
class="cmtt-10">abbreviation</span>). This means that you need
to set the abbreviation style for the <span
@@ -5634,58 +5673,58 @@
</p>
- <pre class="verbatim" id="verbatim-38">
+ <pre class="verbatim" id="verbatim-40">
\setabbreviationstyle[acronym]{long-short-user}
</pre>
- <!--l. 2302--><p class="nopar" > </div>
- </p><!--l. 2303--><p class="noindent" >
+ <!--l. 2325--><p class="nopar" > </div>
+ </p><!--l. 2326--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 2305--><p class="noindent" >
+ <!--l. 2328--><p class="noindent" >
<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
+ <!--l. 2328--><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-13022"></a> key. For example:
</p>
- <pre class="verbatim" id="verbatim-39">
+ <pre class="verbatim" id="verbatim-41">
\newglossaryentry{sedmattis}{name={sed mattis},
description={erat sit amet}
\newglossaryentry{gravida}{parent={sedmattis},
  name={gravida},description={malesuada}}
</pre>
- <!--l. 2314--><p class="nopar" >
+ <!--l. 2337--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2316--><p class="noindent" >
+ <!--l. 2339--><p class="noindent" >
<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
+ <!--l. 2339--><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:
+ id="dx1-13023"></a> key. For example:
</p>
- <pre class="verbatim" id="verbatim-40">
+ <pre class="verbatim" id="verbatim-42">
\newglossaryentry{scelerisque}{name={scelerisque},
  description={at}}
\newglossaryentry{vestibulum}{parent={scelerisque},
  description={eu, nulla}}
</pre>
- <!--l. 2325--><p class="nopar" >
+ <!--l. 2348--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2327--><p class="noindent" >
+ <!--l. 2350--><p class="noindent" >
<span
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
+ <!--l. 2350--><p class="noindent" >(New to v4.47.) These entries all have long descriptions and there are some child entries. For
example:
</p>
- <pre class="verbatim" id="verbatim-41">
+ <pre class="verbatim" id="verbatim-43">
\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.
@@ -5696,23 +5735,23 @@
senectus et netus et malesuada fames ac turpis egestas. Mauris ut
leo.}}
</pre>
- <!--l. 2340--><p class="nopar" >
+ <!--l. 2363--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2342--><p class="noindent" >
+ <!--l. 2365--><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
+ <!--l. 2365--><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
+ id="dx1-13024"></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:
+ id="dx1-13025"></a> package. For example:
</p>
- <pre class="verbatim" id="verbatim-42">
+ <pre class="verbatim" id="verbatim-44">
\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
@@ -5727,15 +5766,15 @@
Nam dui ligula...
}
</pre>
- <!--l. 2363--><p class="nopar" >
+ <!--l. 2386--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2365--><p class="noindent" >
+ <!--l. 2388--><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
+ <!--l. 2388--><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
+ id="dx1-13026"></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:
@@ -5742,29 +5781,29 @@
</p>
- <pre class="verbatim" id="verbatim-43">
+ <pre class="verbatim" id="verbatim-45">
\newglossaryentry{fusce}{name={fusce},
description={suscipit cursus sem},user1={article-minimal}}
</pre>
- <!--l. 2375--><p class="nopar" >
+ <!--l. 2398--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 2377--><p class="noindent" >
+ <!--l. 2400--><p class="noindent" >
<span
class="cmbx-10">example-glossaries-url.tex</span> </p></dt><dd
class="description">
- <!--l. 2377--><p class="noindent" >These entries use the <span
+ <!--l. 2400--><p class="noindent" >These entries use the <span
class="cmtt-10">user1</span><a
- id="dx1-12027"></a> key to store an URL associated with the entry. For example:
+ id="dx1-13027"></a> key to store an URL associated with the entry. For example:
</p>
- <pre class="verbatim" id="verbatim-44">
+ <pre class="verbatim" id="verbatim-46">
\newglossaryentry{aenean-url}{name={aenean},
 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
+ <!--l. 2407--><p class="nopar" ></p></dd></dl>
+<!--l. 2410--><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
@@ -5771,24 +5810,24 @@
these files. See also <a
href="https://www.dickimaw-books.com/gallery/#glossaries" ><span
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
+</p><!--l. 2414--><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" >
+ <!--l. 2418--><p class="noindent" >
<span
class="cmbx-10">example-glossaries-xr.tex</span> </p></dt><dd
class="description">
- <!--l. 2395--><p class="noindent" >These entries use the <span
+ <!--l. 2418--><p class="noindent" >These entries use the <span
class="cmtt-10">see</span><a
- id="dx1-12028"></a> key provided by the base <span
+ id="dx1-13028"></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-12029"></a></span> and <span id="textcolor178"><span id="textcolor179"><span
+ id="dx1-13029"></a></span> and <span id="textcolor178"><span id="textcolor179"><span
class="cmtt-10">seealso</span></span><a
- id="dx1-12030"></a></span>
+ id="dx1-13030"></a></span>
keys that require <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>. For example:
@@ -5795,7 +5834,7 @@
</p>
- <pre class="verbatim" id="verbatim-45">
+ <pre class="verbatim" id="verbatim-47">
\newglossaryentry{alias-lorem}{name={alias-lorem},
 description={ipsum},alias={lorem}}
\newglossaryentry{amet}{name={amet},description={consectetuer},
@@ -5803,13 +5842,13 @@
\newglossaryentry{arcu}{name={arcu},description={libero},
 seealso={placerat,vitae,curabitur}}
</pre>
- <!--l. 2408--><p class="nopar" ></p></dd></dl>
-<!--l. 2411--><p class="noindent" >
+ <!--l. 2431--><p class="nopar" ></p></dd></dl>
+<!--l. 2434--><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
+<!--l. 2434--><p class="noindent" ><a
+href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.4 </span> <a
id="sec:languages"></a>Multi-Lingual Support</h3>
-<!--l. 2414--><p class="noindent" ><div class="important" title="Important Note"> The <span
+<!--l. 2437--><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
@@ -5819,45 +5858,45 @@
href="https://www.dickimaw-books.com/latex/tracklang/" >Localisation with <span
class="cmtt-10">tracklang.tex</span></a> for further details.
</div>
-</p><!--l. 2424--><p class="noindent" >
-</p><!--l. 2426--><p class="noindent" >As from version 1.17, the <span
+</p><!--l. 2447--><p class="noindent" >
+</p><!--l. 2449--><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
- id="dx1-13001"></a></a> as well as <a
+ id="dx1-14001"></a></a> as well as <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-13002"></a></a>. If you are writing in a
+ id="dx1-14002"></a></a>. If you are writing in a
language that uses an <a
href="#glo:exlatinalph">extended Latin alphabet</a> or <a
href="#glo:nonlatinalph">non-Latin alphabet</a> it’s best to use <a
href="#option3">Option 3</a> (<span
class="cmtt-10">xindy</span><a
- id="dx1-13003"></a>) or
+ id="dx1-14003"></a>) or
<a
href="#option4">Option 4</a> (<a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-13004"></a></a>) as <span
+ id="dx1-14004"></a></a>) as <span
class="cmtt-10">makeindex</span><a
- id="dx1-13005"></a> (<a
+ id="dx1-14005"></a> (<a
href="#option2">Option 2</a>) is hard-coded for the non-extended <a
href="#glo:latinalph">Latin alphabet<a
- id="dx1-13006"></a></a> and <a
+ id="dx1-14006"></a></a> and <a
href="#option1">Option 1</a>
can only perform limited ASCII comparisons.
-</p><!--l. 2434--><p class="indent" > This means that with Options <a
+</p><!--l. 2457--><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
class="cmtt-10">xindy</span><a
- id="dx1-13007"></a>, remember to use the <span
+ id="dx1-14007"></a>, remember to use the <span
class="cmss-10">xindy</span><a
- id="dx1-13008"></a> package option. For example:
+ id="dx1-14008"></a> package option. For example:
</p>
- <pre class="verbatim" id="verbatim-46">
+ <pre class="verbatim" id="verbatim-48">
\documentclass[french]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
@@ -5864,38 +5903,38 @@
\usepackage{babel}
\usepackage[xindy]{glossaries}
</pre>
-<!--l. 2443--><p class="nopar" > If you want to use <span
+<!--l. 2466--><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="textcolor180"><span
+ id="dx1-14009"></a>, you need to use the <span id="textcolor180"><span
class="cmss-10">record</span></span><a
- id="dx1-13010"></a> option with <a
+ id="dx1-14010"></a> option with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> and supply the definitions in
<span
class="cmtt-10">bib</span><a
- id="dx1-13011"></a> files. (See the <a
+ id="dx1-14011"></a> files. (See the <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-13012"></a></a> user manual for further details.)
-</p><!--l. 2449--><p class="indent" > <div class="important" title="Important Note"> Note that although a <a
+ id="dx1-14012"></a></a> user manual for further details.)
+</p><!--l. 2472--><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
+ id="dx1-14013"></a></a>, such as é, looks like a plain character in your <span
class="cmtt-10">tex</span><a
- id="dx1-13014"></a> file, with
+ id="dx1-14014"></a> file, with
standard LaTeX it’s actually a macro and can therefore cause expansion problems. You may need to switch off
the field expansions with <span
class="cmtt-10">\glsnoexpandfields</span>. This issue doesn’t occur with XeLaTeX or LuaLaTeX.
</div>
-</p><!--l. 2455--><p class="noindent" >
-</p><!--l. 2457--><p class="indent" > With <span
+</p><!--l. 2478--><p class="noindent" >
+</p><!--l. 2480--><p class="indent" > With <span
class="cmss-10">inputenc</span><a
- id="dx1-13015"></a>, if you use a <a
+ id="dx1-14015"></a>, if you use a <a
href="#glo:nonlatinchar">non-Latin character<a
- id="dx1-13016"></a></a> (or other expandable) character at the start of an entry
+ id="dx1-14016"></a></a> (or other expandable) character at the start of an entry
name, you must place it in a group, or it will cause a problem for commands that convert the first letter to
upper case (e.g. <span
class="cmtt-10">\Gls</span><a
- id="dx1-13017"></a>). For example: </p><div class="alltt">
+ id="dx1-14017"></a>). For example: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry{elite}{name={{</span><span
@@ -5909,61 +5948,61 @@
</div>
</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. 2468--><p class="indent" > If you are using <a
+ id="dx1-14018"></a> user manual.
+<!--l. 2491--><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
+ id="dx1-14019"></a></a> or <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-13020"></a></a>, the application needs to know the encoding of the <span
+ id="dx1-14020"></a></a>, the application needs to know the encoding of the <span
class="cmtt-10">tex</span><a
- id="dx1-13021"></a> file. This
+ id="dx1-14021"></a> file. This
information is added to the <span
class="cmtt-10">aux</span><a
- id="dx1-13022"></a> file and can be picked up by <a
+ id="dx1-14022"></a> file and can be picked up by <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-13023"></a></a> and <a
+ id="dx1-14023"></a></a> and <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-13024"></a></a>. If you use <a
+ id="dx1-14024"></a></a>. If you use <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-13025"></a></a>
+ id="dx1-14025"></a></a>
explicitly instead of via <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-13026"></a>, you may need to specify the encoding using the <span
+ id="dx1-14026"></a>, you may need to specify the encoding using the <span
class="cmtt-10">-C</span><a
- id="dx1-13027"></a> option. Read the
+ id="dx1-14027"></a> option. Read the
<span
class="cmtt-10">xindy</span><a
- id="dx1-13028"></a> manual for further details of this option.
-</p><!--l. 2477--><p class="indent" > As from v4.24, if you are writing in German (for example, using the <span
+ id="dx1-14028"></a> manual for further details of this option.
+</p><!--l. 2500--><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>
+ id="dx1-14029"></a>
package<span class="footnote-mark"><a
href="#fn5x1" id="fn5x1-bk"><sup class="textsuperscript">1.5</sup></a></span><a
- id="x1-13030f5"></a>
+ id="x1-14030f5"></a>
or <span
class="cmss-10">babel</span><a
- id="dx1-13031"></a> with the <span
+ id="dx1-14031"></a> with the <span
class="cmss-10">ngerman </span>package option), and you want to use <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-13032"></a>’s</a> <span
+ id="dx1-14032"></a>’s</a> <span
class="cmtt-10">-g</span><a
- id="dx1-13033"></a> option, you’ll need to change
+ id="dx1-14033"></a> option, you’ll need to change
<a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-13034"></a>’s</a> quote character using:
-</p><!--l. 2482--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-13035"></a> <span
+ id="dx1-14034"></a>’s</a> quote character using:
+</p><!--l. 2505--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-14035"></a> <span
class="cmtt-10">\GlsSetQuote{</span>⟨<span
class="cmitt-10">character</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 2484--><p class="noindent" >
+</p><!--l. 2507--><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
@@ -5973,47 +6012,47 @@
</p>
- <pre class="verbatim" id="verbatim-47">
+ <pre class="verbatim" id="verbatim-49">
\GlsSetQuote{+}
</pre>
-<!--l. 2490--><p class="nopar" > This must be done before <span
+<!--l. 2513--><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
+ id="dx1-14036"></a> and any entry definitions. It’s only applicable for <span
class="cmtt-10">makeindex</span><a
- id="dx1-13037"></a>. This
+ id="dx1-14037"></a>. This
option in conjunction with <span
class="cmss-10">ngerman</span><a
- id="dx1-13038"></a> will also cause <span
+ id="dx1-14038"></a> will also cause <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-13039"></a> to use the <span
+ id="dx1-14039"></a> to use the <span
class="cmtt-10">-g</span><a
- id="dx1-13040"></a> switch when invoking
+ id="dx1-14040"></a> switch when invoking
<span
class="cmtt-10">makeindex</span><a
- id="dx1-13041"></a>.
-</p><!--l. 2497--><p class="indent" > <div class="important" title="Important Note"> Be careful of <span
+ id="dx1-14041"></a>.
+</p><!--l. 2520--><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
+ id="dx1-14042"></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
document and any of those shorthands happen to be special characters for <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-13043"></a></a> or <a
+ id="dx1-14043"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-13044"></a></a> (such as the
+ id="dx1-14044"></a></a> (such as the
double-quote) then this will interfere with code that tries to escape any of those characters that occur in the
<span
class="cmtt-10">sort</span><a
- id="dx1-13045"></a> key. </div>
-</p><!--l. 2506--><p class="noindent" >
-</p><!--l. 2508--><p class="indent" > In general, it’s best not to use <span
+ id="dx1-14045"></a> key. </div>
+</p><!--l. 2529--><p class="noindent" >
+</p><!--l. 2531--><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:
+ id="dx1-14046"></a>’s shorthands in entry definitions. For example:
</p>
- <pre class="verbatim" id="verbatim-48">
+ <pre class="verbatim" id="verbatim-50">
\documentclass{article}
\usepackage[ngerman]{babel}
\usepackage{glossaries}
@@ -6027,19 +6066,19 @@
\printglossaries
\end{document}
</pre>
-<!--l. 2529--><p class="nopar" >
-</p><!--l. 2531--><p class="indent" > The <span
+<!--l. 2552--><p class="nopar" >
+</p><!--l. 2554--><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
+ id="dx1-14047"></a> package has the shorthands on in the preamble, so they can be used in definitions if
<span
class="cmtt-10">\GlsSetQuote </span>has been used to change the <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-13048"></a></a> quote character. Example:
+ id="dx1-14048"></a></a> quote character. Example:
</p>
- <pre class="verbatim" id="verbatim-49">
+ <pre class="verbatim" id="verbatim-51">
\documentclass{article}
\usepackage[ngerman]{babel}
\usepackage{glossaries}
@@ -6052,93 +6091,93 @@
\printglossaries
\end{document}
</pre>
-<!--l. 2552--><p class="nopar" >
-</p><!--l. 2554--><p class="noindent" >
+<!--l. 2575--><p class="nopar" >
+</p><!--l. 2577--><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
+<!--l. 2577--><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:fixednames"></a>Changing the Fixed Names</h4>
-<!--l. 2557--><p class="noindent" >The fixed names are produced using the commands listed in <a
+<!--l. 2580--><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
+class="cmbx-10">1.2</span></a>. If you aren’t using a
language package such as <span
class="cmss-10">babel</span><a
- id="dx1-14001"></a> or <span
+ id="dx1-15001"></a> or <span
class="cmss-10">polyglossia</span><a
- id="dx1-14002"></a> that uses caption hooks, you can just redefine these commands as
+ id="dx1-15002"></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
+ id="dx1-15003"></a> or <span
class="cmss-10">polyglossia</span><a
- id="dx1-14004"></a>, you need to use their caption hooks to change the defaults.
+ id="dx1-15004"></a>, you need to use their caption hooks to change the defaults.
See <a
href="https://texfaq.org/FAQ-latexwords" >changing the words babel uses</a> or read the <span
class="cmss-10">babel</span><a
- id="dx1-14005"></a> or <span
+ id="dx1-15005"></a> or <span
class="cmss-10">polyglossia</span><a
- id="dx1-14006"></a> documentation. If you have
+ id="dx1-15006"></a> documentation. If you have
loaded <span
class="cmss-10">babel</span><a
- id="dx1-14007"></a>, then <span
+ id="dx1-15007"></a>, then <span
class="cmss-10">glossaries</span><a
- id="dx1-14008"></a> will attempt to load <span
+ id="dx1-15008"></a> will attempt to load <span
class="cmss-10">translator</span><a
- id="dx1-14009"></a>, unless you have used the <span
+ id="dx1-15009"></a>, unless you have used the <span
class="cmss-10">notranslate</span><a
- id="dx1-14010"></a>,
+ id="dx1-15010"></a>,
<span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-14011"></a> or <span
+ id="dx1-15011"></a> or <span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">babel</span><a
- id="dx1-14012"></a> package options. If the <span
+ id="dx1-15012"></a> package options. If the <span
class="cmss-10">translator</span><a
- id="dx1-14013"></a> package is loaded, the translations
+ id="dx1-15013"></a> package is loaded, the translations
are provided by dictionary files (for example, <span
class="cmtt-10">glossaries-dictionary-English.dict</span>). See the
<span
class="cmss-10">translator</span><a
- id="dx1-14014"></a> package for advice on changing translations provided by <span
+ id="dx1-15014"></a> package for advice on changing translations provided by <span
class="cmss-10">translator</span><a
- id="dx1-14015"></a> dictionaries. If you
+ id="dx1-15015"></a> dictionaries. If you
can’t work out how to modify these dictionary definitions, try switching to <span
class="cmss-10">babel</span><a
- id="dx1-14016"></a>’s interface using
+ id="dx1-15016"></a>’s interface using
<span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">babel</span><a
- id="dx1-14017"></a>:
+ id="dx1-15017"></a>:
</p>
- <pre class="verbatim" id="verbatim-50">
+ <pre class="verbatim" id="verbatim-52">
\documentclass[english,french]{article}
\usepackage{babel}
\usepackage[translate=babel]{glossaries}
</pre>
-<!--l. 2578--><p class="nopar" > and then use <span
+<!--l. 2601--><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
+ id="dx1-15018"></a>’s caption hook mechanism. Note that if you pass the language options directly to <span
class="cmss-10">babel</span><a
- id="dx1-14019"></a>
+ id="dx1-15019"></a>
rather that using the document class options or otherwise passing the same options to <span
class="cmss-10">translator</span><a
- id="dx1-14020"></a>, then <span
+ id="dx1-15020"></a>, then <span
class="cmss-10">translator</span><a
- id="dx1-14021"></a>
+ id="dx1-15021"></a>
won’t pick up the language and no dictionaries will be loaded and <span
class="cmss-10">babel</span><a
- id="dx1-14022"></a>’s caption hooks will be used
+ id="dx1-15022"></a>’s caption hooks will be used
instead.
</p>
<div class="table">
-<!--l. 2586--><p class="indent" > <a
+<!--l. 2609--><p class="indent" > <a
id="tab:predefinednames"></a></p><hr class="float" /><div class="float"
>
@@ -6145,7 +6184,7 @@
<div class="caption"
><span class="id">Table 1.2: </span><span
-class="content">Customised Text</span></div><!--tex4ht:label?: x1-140232 -->
+class="content">Customised Text</span></div><!--tex4ht:label?: x1-150232 -->
<div class="tabular"> <table id="TBL-3" class="tabular"
@@ -6157,22 +6196,22 @@
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. 2592--><p class="noindent" ><span
+class="td11"> <!--l. 2615--><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. 2593--><p class="noindent" ><span
+class="td10"> <!--l. 2616--><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. 2594--><p class="noindent" ><span
+ id="dx1-15024"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-2-2"
+class="td11"> <!--l. 2617--><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. 2594--><p class="noindent" >Title
+class="td10"> <!--l. 2617--><p class="noindent" >Title
of
the
main
@@ -6181,10 +6220,10 @@
style="vertical-align:baseline;" id="TBL-3-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-1"
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. 2595--><p class="noindent" ><span
+ id="dx1-15025"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-3-2"
+class="td11"> <!--l. 2618--><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. 2595--><p class="noindent" >Title
+class="td10"> <!--l. 2618--><p class="noindent" >Title
of
the
list
@@ -6197,17 +6236,17 @@
option
<span
class="cmss-10">acronym</span><a
- id="dx1-14026"></a>). </p></td>
+ id="dx1-15026"></a>). </p></td>
</tr><tr
style="vertical-align:baseline;" id="TBL-3-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-1"
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. 2597--><p class="noindent" ><span
+ id="dx1-15027"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-4-2"
+class="td11"> <!--l. 2620--><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. 2598--><p class="noindent" >Header
+class="td10"> <!--l. 2621--><p class="noindent" >Header
for
first
column
@@ -6228,12 +6267,12 @@
style="vertical-align:baseline;" id="TBL-3-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-1"
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. 2600--><p class="noindent" ><span
+ id="dx1-15028"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-5-2"
+class="td11"> <!--l. 2623--><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. 2601--><p class="noindent" >Header
+class="td10"> <!--l. 2624--><p class="noindent" >Header
for
second
column
@@ -6254,12 +6293,12 @@
style="vertical-align:baseline;" id="TBL-3-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-1"
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. 2603--><p class="noindent" ><span
+ id="dx1-15029"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-6-2"
+class="td11"> <!--l. 2626--><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. 2603--><p class="noindent" >Header
+class="td10"> <!--l. 2626--><p class="noindent" >Header
for
symbol
column
@@ -6277,14 +6316,14 @@
style="vertical-align:baseline;" id="TBL-3-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-1"
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. 2605--><p class="noindent" ><span
+ id="dx1-15030"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-7-2"
+class="td11"> <!--l. 2628--><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. 2606--><p class="noindent" >Header
+class="td10"> <!--l. 2629--><p class="noindent" >Header
for
page
list
@@ -6302,12 +6341,12 @@
style="vertical-align:baseline;" id="TBL-3-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-1"
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. 2608--><p class="noindent" ><span
+ id="dx1-15031"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-8-2"
+class="td11"> <!--l. 2631--><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. 2609--><p class="noindent" >Header
+class="td10"> <!--l. 2632--><p class="noindent" >Header
for
symbols
section
@@ -6325,12 +6364,12 @@
style="vertical-align:baseline;" id="TBL-3-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-1"
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. 2611--><p class="noindent" ><span
+ id="dx1-15032"></a> </td><td style="white-space:normal; text-align:left;" id="TBL-3-9-2"
+class="td11"> <!--l. 2634--><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. 2611--><p class="noindent" >Header
+class="td10"> <!--l. 2634--><p class="noindent" >Header
for
numbers
section
@@ -6351,7 +6390,7 @@
</div><hr class="endfloat" />
</div>
-<!--l. 2617--><p class="indent" > As from version 4.12, multilingual support is provided by separate language modules that need to be
+<!--l. 2640--><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
@@ -6359,108 +6398,108 @@
href="http://www.dickimaw-books.com/contact.html" class="url" ><span
class="cmtt-10">http://www.dickimaw-books.com/contact.html</span></a>. The <span
class="cmss-10">translator</span><a
- id="dx1-14033"></a>
+ id="dx1-15033"></a>
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. 2629--><p class="indent" > Examples of use: </p>
+</p><!--l. 2652--><p class="indent" > Examples of use: </p>
<ul class="itemize1">
<li class="itemize">
- <!--l. 2631--><p class="noindent" >Using <span
+ <!--l. 2654--><p class="noindent" >Using <span
class="cmss-10">babel</span><a
- id="dx1-14034"></a> and <span
+ id="dx1-15034"></a> and <span
class="cmss-10">translator</span><a
- id="dx1-14035"></a>:
+ id="dx1-15035"></a>:
</p>
- <pre class="verbatim" id="verbatim-51">
+ <pre class="verbatim" id="verbatim-53">
\documentclass[english,french]{article}
\usepackage{babel}
\usepackage{glossaries}
</pre>
- <!--l. 2636--><p class="nopar" > (<span
+ <!--l. 2659--><p class="nopar" > (<span
class="cmss-10">translator</span><a
- id="dx1-14036"></a> is automatically loaded).
+ id="dx1-15036"></a> is automatically loaded).
</p></li>
<li class="itemize">
- <!--l. 2639--><p class="noindent" >Using <span
+ <!--l. 2662--><p class="noindent" >Using <span
class="cmss-10">babel</span><a
- id="dx1-14037"></a>:
+ id="dx1-15037"></a>:
</p>
- <pre class="verbatim" id="verbatim-52">
+ <pre class="verbatim" id="verbatim-54">
\documentclass[english,french]{article}
\usepackage{babel}
\usepackage[translate=babel]{glossaries}
</pre>
- <!--l. 2644--><p class="nopar" > (<span
+ <!--l. 2667--><p class="nopar" > (<span
class="cmss-10">translator</span><a
- id="dx1-14038"></a> isn’t loaded). The <a
+ id="dx1-15038"></a> isn’t loaded). The <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> package has <span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">babel</span><a
- id="dx1-14039"></a> as the default if <span
+ id="dx1-15039"></a> as the default if <span
class="cmss-10">babel</span><a
- id="dx1-14040"></a> has been
+ id="dx1-15040"></a> has been
loaded.
</p></li>
<li class="itemize">
- <!--l. 2649--><p class="noindent" >Using <span
+ <!--l. 2672--><p class="noindent" >Using <span
class="cmss-10">polyglossia</span><a
- id="dx1-14041"></a>:
+ id="dx1-15041"></a>:
</p>
- <pre class="verbatim" id="verbatim-53">
+ <pre class="verbatim" id="verbatim-55">
\documentclass{article}
\usepackage{polyglossia}
\setmainlanguage{english}
\usepackage{glossaries}
</pre>
- <!--l. 2655--><p class="nopar" >
+ <!--l. 2678--><p class="nopar" >
</p>
</li></ul>
-<!--l. 2659--><p class="indent" > Due to the varied nature of glossaries, it’s likely that the predefined translations may not be
+<!--l. 2682--><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
+ id="dx1-15042"></a> package and the <span
class="cmss-10">glossaries </span>package option <span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">babel</span><a
- id="dx1-14043"></a>, you
+ id="dx1-15043"></a>, you
need to be familiar with the advice given in <a
href="https://texfaq.org/FAQ-latexwords" >changing the words babel uses</a>. If you are using the
<span
class="cmss-10">translator</span><a
- id="dx1-14044"></a> package, then you can provide your own dictionary with the necessary modifications (using
+ id="dx1-15044"></a> package, then you can provide your own dictionary with the necessary modifications (using
<span
class="cmtt-10">\deftranslation</span>) and load it using <span
class="cmtt-10">\usedictionary</span>. If you simply want to change the title of a glossary, you
can use the <span
class="cmtt-10">title</span><a
- id="dx1-14045"></a> key in commands like <span
+ id="dx1-15045"></a> key in commands like <span
class="cmtt-10">\printglossary </span>(but not the iterative commands like
<span
class="cmtt-10">\printglossaries</span>).
-</p><!--l. 2671--><p class="indent" > <div class="important" title="Important Note"> Note that the <span
+</p><!--l. 2694--><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
+ id="dx1-15046"></a> dictionaries are loaded at the beginning of the document, so it won’t have any effect
if you put <span
class="cmtt-10">\deftranslation </span>in the preamble. It should be put in your personal dictionary instead (as in the
example below). See the <span
class="cmss-10">translator</span><a
- id="dx1-14047"></a> documentation for further details. (Now with <span
+ id="dx1-15047"></a> documentation for further details. (Now with <span
class="cmss-10">beamer</span><a
- id="dx1-14048"></a> documentation.)
+ id="dx1-15048"></a> documentation.)
</div>
-</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
+</p><!--l. 2701--><p class="noindent" >
+</p><!--l. 2703--><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,
@@ -6467,43 +6506,43 @@
</p>
- <pre class="verbatim" id="verbatim-54">
+ <pre class="verbatim" id="verbatim-56">
myinstitute-glossaries-dictionary-English.dict
</pre>
-<!--l. 2688--><p class="nopar" > that contains the following:
+<!--l. 2711--><p class="nopar" > that contains the following:
</p>
- <pre class="verbatim" id="verbatim-55">
+ <pre class="verbatim" id="verbatim-57">
\ProvidesDictionary{myinstitute-glossaries-dictionary}{English}
\deftranslation{Glossary}{Nomenclature}
\deftranslation{Page List (glossaries)}{Location}
</pre>
-<!--l. 2694--><p class="nopar" > You can now load it using:
+<!--l. 2717--><p class="nopar" > You can now load it using:
</p>
- <pre class="verbatim" id="verbatim-56">
+ <pre class="verbatim" id="verbatim-58">
\usedictionary{myinstitute-glossaries-dictionary}
</pre>
-<!--l. 2698--><p class="nopar" > (Make sure that <span
+<!--l. 2721--><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. 2703--><p class="indent" > If you are using <span
+</p><!--l. 2726--><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
+ id="dx1-15049"></a> and don’t want to use the <span
class="cmss-10">translator</span><a
- id="dx1-14050"></a> interface, you can use the package option
+ id="dx1-15050"></a> interface, you can use the package option
<span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">babel</span><a
- id="dx1-14051"></a>. For example:
+ id="dx1-15051"></a>. For example:
</p>
- <pre class="verbatim" id="verbatim-57">
+ <pre class="verbatim" id="verbatim-59">
\documentclass[british]{article}
\usepackage{babel}
\usepackage[translate=babel]{glossaries}
@@ -6512,68 +6551,68 @@
    \renewcommand*{\acronymname}{List of Acronyms}%
}
</pre>
-<!--l. 2716--><p class="nopar" >
-</p><!--l. 2718--><p class="indent" > Note that <a
+<!--l. 2739--><p class="nopar" >
+</p><!--l. 2741--><p class="indent" > Note that <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-14052"></a></a> and <a
+ id="dx1-15052"></a></a> and <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-14053"></a></a> provide much better multi-lingual support than <a
+ id="dx1-15053"></a></a> provide much better multi-lingual support than <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-14054"></a></a>, so I recommend
+ id="dx1-15054"></a></a>, so I recommend
that you use Options <a
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
+ id="dx1-15055"></a>s</a>. See <a
href="#sec:xindy">§<span
-class="cmbx-10">??</span>sec:xindy
+class="cmbx-10">14</span>
</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
+ id="dx1-15056"></a></a>, and see the <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-14057"></a></a> user manual for further details of that
+ id="dx1-15057"></a></a> user manual for further details of that
application.
</p>
-<!--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
+<!--l. 2748--><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:newlang"></a>Creating a New Language Module</h4>
+<!--l. 2751--><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
+ id="dx1-16001"></a> package to determine which language modules need
to be loaded. If you want to create a new language module, you should first read the <span
class="cmss-10">tracklang</span><a
- id="dx1-15002"></a>
+ id="dx1-16002"></a>
documentation.
-</p><!--l. 2733--><p class="indent" > To create a new language module, you need to at least create two files called: <span
+</p><!--l. 2756--><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
- id="dx1-15003"></a> and
+ id="dx1-16003"></a> and
<span
class="cmtt-10">glossaries-dictionary-</span>⟨<span
class="cmti-10">Lang</span>⟩<span
class="cmtt-10">.dict</span><a
- id="dx1-15004"></a> where ⟨<span
+ id="dx1-16004"></a> where ⟨<span
class="cmti-10">lang</span>⟩ is the root language name (for example, <span
class="cmtt-10">english</span>) and ⟨<span
class="cmti-10">Lang</span>⟩ is
the language name used by <span
class="cmss-10">translator</span><a
- id="dx1-15005"></a> (for example, <span
+ id="dx1-16005"></a> (for example, <span
class="cmtt-10">English</span>).
-</p><!--l. 2740--><p class="indent" > Here’s an example of <span
+</p><!--l. 2763--><p class="indent" > Here’s an example of <span
class="cmtt-10">glossaries-dictionary-English.dict</span>:
</p>
- <pre class="verbatim" id="verbatim-58">
+ <pre class="verbatim" id="verbatim-60">
\ProvidesDictionary{glossaries-dictionary}{English}
\providetranslation{Glossary}{Glossary}
\providetranslation{Acronyms}{Acronyms}
@@ -6584,10 +6623,10 @@
\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
+<!--l. 2775--><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
+ id="dx1-16006"></a> name for your
language (so that it matches the file name <span
class="cmtt-10">glossaries-dictionary-</span>⟨<span
class="cmti-10">Lang</span>⟩<span
@@ -6594,12 +6633,12 @@
class="cmtt-10">.dict</span>) and, for each
<span
class="cmtt-10">\providetranslation</span>, change the second argument to the appropriate translation.
-</p><!--l. 2760--><p class="indent" > Here’s an example of <span
+</p><!--l. 2783--><p class="indent" > Here’s an example of <span
class="cmtt-10">glossaries-english.ldf</span>:
</p>
- <pre class="verbatim" id="verbatim-59">
+ <pre class="verbatim" id="verbatim-61">
\ProvidesGlossariesLang{english}
\glsifusedtranslatordict{English}
{%
@@ -6658,10 +6697,10 @@
\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
+<!--l. 2841--><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>
+ id="dx1-16007"></a>
language label ⟨<span
class="cmti-10">Lang</span>⟩ used for the dictionary file and replace <span
class="cmtt-10">english </span>with the root language name ⟨<span
@@ -6670,7 +6709,7 @@
class="cmtt-10">\glossariescaptions</span>⟨<span
class="cmti-10">lang</span>⟩, replace the English text (such as “Glossaries”) with the
appropriate translation.
-</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
+</p><!--l. 2851--><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
@@ -6683,19 +6722,19 @@
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. 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
+</p><!--l. 2862--><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
class="cmtt-10">plural</span><a
- id="dx1-15008"></a>, <span
+ id="dx1-16008"></a>, <span
class="cmtt-10">longplural</span><a
- id="dx1-15009"></a>, <span
+ id="dx1-16009"></a>, <span
class="cmtt-10">shortplural</span><a
- id="dx1-15010"></a> etc keys to override exceptions.
+ id="dx1-16010"></a> etc keys to override exceptions.
</div>
-</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
+</p><!--l. 2871--><p class="noindent" >
+</p><!--l. 2873--><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
@@ -6710,7 +6749,7 @@
</p>
- <pre class="verbatim" id="verbatim-60">
+ <pre class="verbatim" id="verbatim-62">
 \ProvidesGlossariesLang{en-GB}
 \RequireGlossariesLang{english}
 \glsifusedtranslatordict{British}
@@ -6730,21 +6769,21 @@
   }%
 }
</pre>
-<!--l. 2875--><p class="nopar" >
-</p><!--l. 2877--><p class="indent" > If the translations includes <a
+<!--l. 2898--><p class="nopar" >
+</p><!--l. 2900--><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
+ id="dx1-16011"></a>s</a>, it’s necessary to provide code that’s independent of the
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 <a
href="#glo:UTF-8">UTF-8</a> version for XeLaTeX and LuaLaTeX users.
-</p><!--l. 2884--><p class="indent" > The <span
+</p><!--l. 2907--><p class="indent" > The <span
class="cmtt-10">glossaries-irish.ldf </span>file provides this as follows:
</p>
- <pre class="verbatim" id="verbatim-61">
+ <pre class="verbatim" id="verbatim-63">
\ProvidesGlossariesLang{irish}
\glsifusedtranslatordict{Irish}
{%
@@ -6780,24 +6819,24 @@
  \glossariescaptionsirish
}
</pre>
-<!--l. 2921--><p class="nopar" > (Again you can use this as a template. Replace <span
+<!--l. 2944--><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. 2926--><p class="indent" > There are now two extra files: <span
+ id="dx1-16012"></a> dictionary label.)
+</p><!--l. 2949--><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>(<a
href="#glo:UTF-8">UTF-8</a>).
-</p><!--l. 2930--><p class="indent" > These both define <span
+</p><!--l. 2953--><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>
- <pre class="verbatim" id="verbatim-62">
+ <pre class="verbatim" id="verbatim-64">
\@ifpackageloaded{polyglossia}%
{%
  \newcommand*{\glossariescaptionsirish}{%
@@ -6824,47 +6863,47 @@
  }%
}
</pre>
-<!--l. 2958--><p class="nopar" > whereas the <span
+<!--l. 2981--><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. 2986--><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
+<!--l. 2986--><p class="noindent" ><a
+href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.5 </span> <a
id="sec:makeglossaries"></a>Generating the Associated Glossary Files</h3>
-<!--l. 2966--><p class="noindent" ><div class="important" title="Important Note"> This section is only applicable if you have chosen Options <a
+<!--l. 2989--><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
use the <span
class="cmtt-10">sort</span><a
- id="dx1-16001"></a> key if the <span
+ id="dx1-17001"></a> key if the <span
class="cmtt-10">name</span><a
- id="dx1-16002"></a> contains any LaTeX commands (except if you’re using <a
+ id="dx1-17002"></a> contains any LaTeX commands (except if you’re using <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-16003"></a></a>).
+ id="dx1-17003"></a></a>).
</div>
-</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
+</p><!--l. 2995--><p class="noindent" >
+</p><!--l. 2997--><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
+ id="dx1-17004"></a></a> or
<a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16005"></a></a>, you can try using the <span
+ id="dx1-17005"></a></a>, you can try using the <span
class="cmss-10">automake</span><a
- id="dx1-16006"></a> package option, described in <a
+ id="dx1-17006"></a> package option, described in <a
href="#sec:pkgopts-sort">§<span
-class="cmbx-10">??</span>sec:pkgopts-sort </a><a
+class="cmbx-10">2.5</span> </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
+</p><!--l. 3006--><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
+ id="dx1-17007"></a>s</a>, it is necessary to use an external <a
href="#glo:indexingapp">indexing
@@ -6877,52 +6916,52 @@
<a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16008"></a></a> and <a
+ id="dx1-17008"></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
+ id="dx1-17009"></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="cmtt-10">makeindex</span><a
- id="dx1-16010"></a> only. With the <a
+ id="dx1-17010"></a> only. With the <a
href="#glo:glossaries-extra"><span
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
+ id="dx1-17011"></a></a> as the indexing application. (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-16012"></a></a>
+ id="dx1-17012"></a></a>
user manuals for further details.) Note that <span
class="cmtt-10">xindy</span><a
- id="dx1-16013"></a> and <span
+ id="dx1-17013"></a> and <span
class="cmtt-10">bib2gls</span><a
- id="dx1-16014"></a> have much better multi-lingual
+ id="dx1-17014"></a> have much better multi-lingual
support than <span
class="cmtt-10">makeindex</span><a
- id="dx1-16015"></a>, so <span
+ id="dx1-17015"></a>, so <span
class="cmtt-10">xindy</span><a
- id="dx1-16016"></a> or <span
+ id="dx1-17016"></a> or <span
class="cmtt-10">bib2gls</span><a
- id="dx1-16017"></a> are recommended if you’re not writing in English.
+ id="dx1-17017"></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
+ id="dx1-17018"></a> is used are described in <a
href="#sec:xindy">§<span
-class="cmbx-10">??</span>sec:xindy </a><a
+class="cmbx-10">14</span> </a><a
href="#sec:xindy">Xindy (Option
3)<!--tex4ht:ref: sec:xindy --></a>.
-</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
+</p><!--l. 3026--><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
+ id="dx1-17019"></a> and <span
class="cmtt-10">arara</span><a
- id="dx1-16020"></a>. With <span
+ id="dx1-17020"></a>. With <span
class="cmtt-10">arara</span><a
- id="dx1-16021"></a> you can just add special comments to your document source:
+ id="dx1-17021"></a> you can just add special comments to your document source:
</p><div class="alltt">
<div class="obeylines-v">
<span
@@ -6940,202 +6979,202 @@
</div>
</div> With <span
class="cmtt-10">latexmk</span><a
- id="dx1-16022"></a> you need to set up the required dependencies. </div>
-<!--l. 3014--><p class="noindent" >
-</p><!--l. 3016--><p class="indent" > The <span
+ id="dx1-17022"></a> you need to set up the required dependencies. </div>
+<!--l. 3037--><p class="noindent" >
+</p><!--l. 3039--><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
- id="dx1-16023"></a></a> which will run <a
+ id="dx1-17023"></a></a> which will run <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16024"></a></a> or <a
+ id="dx1-17024"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16025"></a></a>
+ id="dx1-17025"></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
+ id="dx1-17026"></a>). See
<a
href="#sec:makeglossariesapp">§<span
-class="cmbx-10">??</span>sec:makeglossariesapp </a><a
+class="cmbx-10">1.5.1</span> </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
+ id="dx1-17027"></a> and <span
class="cmtt-10">latexmk</span><a
- id="dx1-16028"></a>).
+ id="dx1-17028"></a>).
Most Unix-like operating systems come with a Perl interpreter. TeX Live also comes with a Perl
interpreter. MiKTeX doesn’t come with a Perl interpreter so if you are a Windows MiKTeX user
you will need to install Perl if you want to use <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16029"></a></a> or <a
+ id="dx1-17029"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16030"></a></a>. Further information is
+ id="dx1-17030"></a></a>. Further information is
available at <a
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. 3032--><p class="indent" > The advantages of using <span
+</p><!--l. 3055--><p class="indent" > The advantages of using <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16031"></a>: </p>
+ id="dx1-17031"></a>: </p>
<ul class="itemize1">
<li class="itemize">
- <!--l. 3034--><p class="noindent" >It automatically detects whether to use <span
+ <!--l. 3057--><p class="noindent" >It automatically detects whether to use <span
class="cmtt-10">makeindex</span><a
- id="dx1-16032"></a> or <span
+ id="dx1-17032"></a> or <span
class="cmtt-10">xindy</span><a
- id="dx1-16033"></a> and sets the relevant application
+ id="dx1-17033"></a> and sets the relevant application
switches.
</p></li>
<li class="itemize">
- <!--l. 3037--><p class="noindent" >One call of <span
+ <!--l. 3060--><p class="noindent" >One call of <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16034"></a> will run <span
+ id="dx1-17034"></a> will run <span
class="cmtt-10">makeindex</span><a
- id="dx1-16035"></a>/<span
+ id="dx1-17035"></a>/<span
class="cmtt-10">xindy</span><a
- id="dx1-16036"></a> for each glossary type.
+ id="dx1-17036"></a> for each glossary type.
</p></li>
<li class="itemize">
- <!--l. 3040--><p class="noindent" >If things go wrong, <a
+ <!--l. 3063--><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
+ id="dx1-17037"></a></a> will scan the messages from <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16038"></a></a> or <a
+ id="dx1-17038"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16039"></a></a> and attempt
+ id="dx1-17039"></a></a> and attempt
to diagnose the problem in relation to the <span
class="cmss-10">glossaries </span>package. This will hopefully provide more
helpful messages in some cases. If it can’t diagnose the problem, you will have to read the relevant
transcript file and see if you can work it out from the <span
class="cmtt-10">makeindex</span><a
- id="dx1-16040"></a> or <span
+ id="dx1-17040"></a> or <span
class="cmtt-10">xindy</span><a
- id="dx1-16041"></a> messages.
+ id="dx1-17041"></a> messages.
</p></li>
<li class="itemize">
- <!--l. 3048--><p class="noindent" >If <a
+ <!--l. 3071--><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
+ id="dx1-17042"></a></a> warns about multiple encap values, <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16043"></a></a> will detect this and attempt to
+ id="dx1-17043"></a></a> will detect this and attempt to
correct the problem.<span class="footnote-mark"><a
href="#fn6x1" id="fn6x1-bk"><sup class="textsuperscript">1.6</sup></a></span><a
- id="x1-16044f6"></a>
+ id="x1-17044f6"></a>
This correction is only provided by <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16046"></a></a> when <a
+ id="dx1-17046"></a></a> when <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16047"></a></a> is used since <a
+ id="dx1-17047"></a></a> is used since <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16048"></a></a> uses the
+ id="dx1-17048"></a></a> uses the
order of the <a
- id="dx1-16049"></a>attributes list to determine which format should take precedence. (see <a
+ id="dx1-17049"></a>attributes list to determine which format should take precedence. (see <a
href="#sec:xindyloc">§<span
-class="cmbx-10">??</span>sec:xindyloc
+class="cmbx-10">14.2</span>
</a><a
href="#sec:xindyloc">Locations and Number lists<!--tex4ht:ref: sec:xindyloc --></a>.)
</p>
</li></ul>
-<!--l. 3058--><p class="indent" > As from version 4.16, the <span
+<!--l. 3081--><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
- id="dx1-16050"></a></a>. This
+ id="dx1-17050"></a></a>. This
is a <span
class="cmti-10">trimmed-down </span>alternative to the <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16051"></a></a> Perl script. It doesn’t have some of the options that the
+ id="dx1-17051"></a></a> Perl script. It doesn’t have some of the options that the
Perl version has and it doesn’t attempt to diagnose any problems, but since modern TeX distributions come
with LuaTeX (and therefore have a Lua interpreter) you don’t need to install anything else in order to
use <a
href="#glo:makeglossaries-lite.lua"><span
class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-16052"></a></a> so it’s an alternative to <a
+ id="dx1-17052"></a></a> so it’s an alternative to <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16053"></a></a> if you want to use <a
+ id="dx1-17053"></a></a> if you want to use <a
href="#option2">Option 2</a>
(<a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16054"></a></a>).
-</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
+ id="dx1-17054"></a></a>).
+</p><!--l. 3091--><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
- id="dx1-16055"></a></a> as a diagnostic tool. Once you’ve fixed the problem, you can then go back to using
+ id="dx1-17055"></a></a> as a diagnostic tool. Once you’ve fixed the problem, you can then go back to using
<a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16056"></a></a> or <a
+ id="dx1-17056"></a></a> or <a
href="#glo:makeglossaries-lite.lua"><span
class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-16057"></a></a>.
-</p><!--l. 3074--><p class="indent" > Whilst I strongly recommended that you use the <a
+ id="dx1-17057"></a></a>.
+</p><!--l. 3097--><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
+ id="dx1-17058"></a></a> Perl script or the <a
href="#glo:makeglossaries-lite.lua"><span
class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-16059"></a></a>
+ id="dx1-17059"></a></a>
Lua script, it is possible to use the <span
class="cmss-10">glossaries </span>package without using those applications. However, note that some
commands and package options have no effect if you explicitly run <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16060"></a></a>/<a
+ id="dx1-17060"></a></a>/<a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16061"></a></a>. These are listed in
+ id="dx1-17061"></a></a>. These are listed in
<a
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="cmbx-10">1.3</span></a>.
+</p><!--l. 3104--><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
+ id="dx1-17062"></a> because you don’t want to install Perl, you will only be able
to use <span
class="cmtt-10">makeindex</span><a
- id="dx1-16063"></a> as <span
+ id="dx1-17063"></a> as <span
class="cmtt-10">xindy</span><a
- id="dx1-16064"></a> also requires Perl. (Other useful Perl scripts include <span
+ id="dx1-17064"></a> also requires Perl. (Other useful Perl scripts include <span
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. 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
+</p><!--l. 3110--><p class="noindent" >
+</p><!--l. 3112--><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
- id="dx1-16065"></a></a>, <a
+ id="dx1-17065"></a></a>, <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16066"></a></a> or <a
+ id="dx1-17066"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16067"></a></a> run, as appropriate. For example, suppose you have defined the following
+ id="dx1-17067"></a></a> run, as appropriate. For example, suppose you have defined the following
entries:<span class="footnote-mark"><a
href="#fn7x1" id="fn7x1-bk"><sup class="textsuperscript">1.7</sup></a></span><a
- id="x1-16068f7"></a>
+ id="x1-17068f7"></a>
</p>
- <pre class="verbatim" id="verbatim-63">
+ <pre class="verbatim" id="verbatim-65">
\newglossaryentry{citrusfruit}{name={citrus fruit},
description={fruit of any citrus tree. (See also
\gls{orange})}}
@@ -7142,7 +7181,7 @@
\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
+<!--l. 3125--><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
@@ -7150,16 +7189,16 @@
<a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-16070"></a></a>, <a
+ id="dx1-17070"></a></a>, <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16071"></a></a> or <a
+ id="dx1-17071"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16072"></a></a>. For example, if the document is called <span
+ id="dx1-17072"></a></a>. For example, if the document is called <span
class="cmtt-10">myDoc.tex</span>, then you must
do:
-</p><!--l. 3110--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3133--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
<br />pdflatex myDoc
<br />makeglossaries myDoc
<br />pdflatex myDoc
@@ -7171,35 +7210,35 @@
href="#option4">Option 4</a>, <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-16073"></a></a> will scan the description for instances of commands like <span
+ id="dx1-17073"></a></a> will scan the description for instances of commands like <span
class="cmtt-10">\gls </span>to ensure they
are selected but an extra <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-16074"></a></a> call is required to ensure the locations are included, if locations lists are
+ id="dx1-17074"></a></a> call is required to ensure the locations are included, if locations lists are
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. 3123--><p class="indent" > Likewise, an additional <a
+ id="dx1-17075"></a></a> manual for further details.)
+</p><!--l. 3146--><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
+ id="dx1-17076"></a></a> and LaTeX run may be required if the document pages shift with
re-runs. For example, if the page numbering is not reset after the table of contents, the insertion of the table of
contents on the second LaTeX run may push glossary entries across page boundaries, which means that the
<a
href="#glo:numberlist">number list<a
- id="dx1-16077"></a>s</a> in the glossary may need updating.
-</p><!--l. 3131--><p class="indent" > The examples in this document assume that you are accessing <a
+ id="dx1-17077"></a>s</a> in the glossary may need updating.
+</p><!--l. 3154--><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
+ id="dx1-17078"></a></a>, <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16079"></a></a> or <a
+ id="dx1-17079"></a></a> or <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16080"></a></a> via a
+ id="dx1-17080"></a></a> via a
terminal. Windows users can use the MSDOS Prompt which is usually accessed via the <span
class="cmss-10">Start-</span><span
class="cmmi-10">></span><span
@@ -7210,20 +7249,20 @@
class="cmss-10">All Programs-</span><span
class="cmmi-10">></span><span
class="cmss-10">Accessories </span>menu.
-</p><!--l. 3137--><p class="indent" > Alternatively, your text editor may have the facility to create a function that will call the required
+</p><!--l. 3160--><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. 3143--><p class="indent" > If any problems occur, remember to check the transcript files (e.g. <span
+</p><!--l. 3166--><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
+ id="dx1-17081"></a> or <span
class="cmtt-10">alg</span><a
- id="dx1-16082"></a>) for messages.
+ id="dx1-17082"></a>) for messages.
</p>
<div class="table">
-<!--l. 3146--><p class="indent" > <a
+<!--l. 3169--><p class="indent" > <a
id="tab:makeglossariesCmds"></a></p><hr class="float" /><div class="float"
>
@@ -7233,10 +7272,10 @@
class="content">Commands and package options that have no effect when using <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16084"></a></a> or <a
+ id="dx1-17084"></a></a> or <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16085"></a></a> explicitly</span></div><!--tex4ht:label?: x1-160833 -->
+ id="dx1-17085"></a></a> explicitly</span></div><!--tex4ht:label?: x1-170833 -->
<div class="tabular"> <table id="TBL-4" class="tabular"
><colgroup id="TBL-4-1g"><col
@@ -7249,11 +7288,11 @@
class="td11"> <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-16086"></a></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-3"
+ id="dx1-17086"></a></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-3"
class="td10"> <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-16087"></a></a> </td>
+ id="dx1-17087"></a></a> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-4-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-1"
class="td01"><span
@@ -7260,13 +7299,13 @@
class="cmss-10">order</span><span
class="cmtt-10">=</span><span
class="cmss-10">letter</span><a
- id="dx1-16088"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-2"
+ id="dx1-17088"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-2"
class="td11"> use <span
class="cmtt-10">-l</span><a
- id="dx1-16089"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-3"
+ id="dx1-17089"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-3"
class="td10"> use <span
class="cmtt-10">-M</span><a
- id="dx1-16090"></a> <span
+ id="dx1-17090"></a> <span
class="cmtt-10">ord/letorder</span></td>
</tr><tr
style="vertical-align:baseline;" id="TBL-4-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-1"
@@ -7274,7 +7313,7 @@
class="cmss-10">order</span><span
class="cmtt-10">=</span><span
class="cmss-10">word</span><a
- id="dx1-16091"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-2"
+ id="dx1-17091"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-2"
class="td11"> default </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-3"
class="td10"> default </td>
</tr><tr
@@ -7281,7 +7320,7 @@
style="vertical-align:baseline;" id="TBL-4-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-1"
class="td01"><span
class="cmss-10">xindy</span><a
- id="dx1-16092"></a>=<span
+ id="dx1-17092"></a>=<span
class="cmsy-10">{</span><span
class="cmss-10">language=</span>⟨<span
class="cmti-10">lang</span>⟩<span
@@ -7291,16 +7330,16 @@
class="td11"> N/A </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-3"
class="td10"> use <span
class="cmtt-10">-L</span><a
- id="dx1-16093"></a> ⟨<span
+ id="dx1-17093"></a> ⟨<span
class="cmti-10">lang</span>⟩ <span
class="cmtt-10">-C</span><a
- id="dx1-16094"></a> ⟨<span
+ id="dx1-17094"></a> ⟨<span
class="cmti-10">code</span>⟩ </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-4-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-1"
class="td01"><span
class="cmtt-10">\GlsSetXdyLanguage</span><a
- id="dx1-16095"></a><span
+ id="dx1-17095"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">lang</span>⟩<span
class="cmtt-10">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-2"
@@ -7307,13 +7346,13 @@
class="td11"> N/A </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-3"
class="td10"> use <span
class="cmtt-10">-L</span><a
- id="dx1-16096"></a> ⟨<span
+ id="dx1-17096"></a> ⟨<span
class="cmti-10">lang</span>⟩ </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-4-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-1"
class="td01"><span
class="cmtt-10">\GlsSetXdyCodePage</span><a
- id="dx1-16097"></a><span
+ id="dx1-17097"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">code</span>⟩<span
class="cmtt-10">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-2"
@@ -7320,7 +7359,7 @@
class="td11"> N/A </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-3"
class="td10"> use <span
class="cmtt-10">-C</span><a
- id="dx1-16098"></a> ⟨<span
+ id="dx1-17098"></a> ⟨<span
class="cmti-10">code</span>⟩ </td></tr></table>
</div>
@@ -7327,28 +7366,28 @@
</div><hr class="endfloat" />
</div>
-<!--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
+<!--l. 3192--><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:makeglossariesapp"></a>Using the makeglossaries Perl Script</h4>
-<!--l. 3172--><p class="noindent" >The <a
+<!--l. 3195--><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
+ id="dx1-18001"></a></a> script picks up the relevant information from the auxiliary (<span
class="cmtt-10">aux</span><a
- id="dx1-17002"></a>) file and will either call
+ id="dx1-18002"></a>) file and will either call
<a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-17003"></a></a> or <a
+ id="dx1-18003"></a></a> or <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-17004"></a></a>, depending on the supplied information. Therefore, you only need to pass the document’s
+ id="dx1-18004"></a></a>, depending on the supplied information. Therefore, you only need to pass the document’s
name without the extension to <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-17005"></a>. For example, if your document is called <span
+ id="dx1-18005"></a>. For example, if your document is called <span
class="cmtt-10">myDoc.tex</span>, type the
following in your terminal:
-</p><!--l. 3179--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3202--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
<br />pdflatex myDoc
<br />makeglossaries myDoc
<br />pdflatex myDoc
@@ -7357,17 +7396,17 @@
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. 3185--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-18006"></a></a> into Perl:
+</p><!--l. 3208--><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. 3189--><p class="indent" > Windows users: TeX Live on Windows has its own internal Perl interpreter and provides
+</p><!--l. 3212--><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
class="cmtt-10">makeglossaries</span><a
- id="dx1-17007"></a></a> Perl script. MiKTeX also
+ id="dx1-18007"></a></a> Perl script. MiKTeX also
provides a wrapper <span
class="cmtt-10">makeglossaries.exe </span>but doesn’t provide a Perl interpreter, which is still
required even if you run MiKTeX’s <span
@@ -7374,21 +7413,21 @@
class="cmtt-10">makeglossaries.exe</span>, so with MiKTeX you’ll need to install
Perl.<span class="footnote-mark"><a
href="#fn8x1" id="fn8x1-bk"><sup class="textsuperscript">1.8</sup></a></span><a
- id="x1-17008f8"></a>
+ id="x1-18008f8"></a>
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. 3201--><p class="indent" > The <a
+</p><!--l. 3224--><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
+ id="dx1-18009"></a></a> script attempts to fork the <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-17010"></a></a>/<a
+ id="dx1-18010"></a></a>/<a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-17011"></a></a> process using <span
+ id="dx1-18011"></a></a> process using <span
class="cmtt-10">open() </span>on the piped
redirection <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">2>&1</span><span
@@ -7396,31 +7435,31 @@
<a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-17012"></a></a> will print an “Unable to fork” warning and will retry without redirection. If you run
+ id="dx1-18012"></a></a> will print an “Unable to fork” warning and will retry without redirection. If you run
<a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-17013"></a></a> on an operating system that doesn’t support this form of redirection, then you can use the <span
+ id="dx1-18013"></a></a> on an operating system that doesn’t support this form of redirection, then you can use the <span
class="cmtt-10">-Q</span><a
- id="dx1-17014"></a>
+ id="dx1-18014"></a>
switch to suppress this warning or you can use the <span
class="cmtt-10">-k</span><a
- id="dx1-17015"></a> switch to make <a
+ id="dx1-18015"></a> switch to make <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-17016"></a></a> automatically use the
+ id="dx1-18016"></a></a> automatically use the
fallback method without attempting the redirection. Without this redirection, the <span
class="cmtt-10">-q</span><a
- id="dx1-17017"></a> (quiet) switch doesn’t
+ id="dx1-18017"></a> (quiet) switch doesn’t
work as well.
-</p><!--l. 3213--><p class="indent" > You can specify in which directory the <span
+</p><!--l. 3236--><p class="indent" > You can specify in which directory the <span
class="cmtt-10">aux</span><a
- id="dx1-17018"></a>, <span
+ id="dx1-18018"></a>, <span
class="cmtt-10">glo</span><a
- id="dx1-17019"></a> etc files are located using the <span
+ id="dx1-18019"></a> etc files are located using the <span
class="cmtt-10">-d </span>switch. For
example:
-</p><!--l. 3216--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3239--><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>
@@ -7427,40 +7466,40 @@
<br /></span>
Note that <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-17020"></a> assumes by default that <span
+ id="dx1-18020"></a> assumes by default that <span
class="cmtt-10">makeindex</span><a
- id="dx1-17021"></a>/<span
+ id="dx1-18021"></a>/<span
class="cmtt-10">xindy</span><a
- id="dx1-17022"></a> is on your operating system’s path. If
+ id="dx1-18022"></a> is on your operating system’s path. If
this isn’t the case, you can specify the full pathname using <span
class="cmtt-10">-m</span><a
- id="dx1-17023"></a> ⟨<span
+ id="dx1-18023"></a> ⟨<span
class="cmti-10">path/to/makeindex</span>⟩ for <span
class="cmtt-10">makeindex</span><a
- id="dx1-17024"></a> or <span
+ id="dx1-18024"></a> or <span
class="cmtt-10">-x</span><a
- id="dx1-17025"></a>
+ id="dx1-18025"></a>
⟨<span
class="cmti-10">path/to/xindy</span>⟩ for <span
class="cmtt-10">xindy</span><a
- id="dx1-17026"></a>.
+ id="dx1-18026"></a>.
-</p><!--l. 3226--><p class="indent" > As from <a
+</p><!--l. 3249--><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
+ id="dx1-18027"></a></a> v2.18, if you are using <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-17028"></a></a>, there’s a check for <span
+ id="dx1-18028"></a></a>, there’s a check for <span
class="cmtt-10">makeindex</span><a
- id="dx1-17029"></a>’s multiple encap
+ id="dx1-18029"></a>’s multiple encap
warning. This is where different encap values (location formats) are used on the same location for the same
entry. For example:
</p>
- <pre class="verbatim" id="verbatim-64">
+ <pre class="verbatim" id="verbatim-66">
\documentclass{article}
\usepackage{glossaries}
\makeglossaries
@@ -7470,72 +7509,72 @@
\printglossaries
\end{document}
</pre>
-<!--l. 3242--><p class="nopar" > If you explicitly use <a
+<!--l. 3265--><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
+ id="dx1-18030"></a></a>, this will cause a warning and the location list will be “1, <span
class="cmbx-10">1</span>”. That is, the page
number will be repeated with each format. As from v2.18, <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-17031"></a></a> will check for this warning
+ id="dx1-18031"></a></a> will check for this warning
and, if found, will attempt to correct the problem by removing duplicate locations and retrying.
There’s no similar check for <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-17032"></a></a> as <span
+ id="dx1-18032"></a></a> as <span
class="cmtt-10">xindy</span><a
- id="dx1-17033"></a> won’t produce any warning and will simply discard
+ id="dx1-18033"></a> won’t produce any warning and will simply discard
duplicates.
-</p><!--l. 3251--><p class="indent" > For a complete list of options do <span
+</p><!--l. 3274--><p class="indent" > For a complete list of options do <span
class="cmtt-10">makeglossaries --help</span>.
-</p><!--l. 3253--><p class="indent" > <div class="important" title="Important Note"> When upgrading the <span
+</p><!--l. 3276--><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.47. </div>
-</p><!--l. 3257--><p class="noindent" >
-</p><!--l. 3259--><p class="noindent" >
+ id="dx1-18034"></a></a>. The
+current version is 4.48. </div>
+</p><!--l. 3280--><p class="noindent" >
+</p><!--l. 3282--><p class="noindent" >
</p>
-<!--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
+<!--l. 3282--><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:makeglossarieslua"></a>Using the makeglossaries-lite Lua Script</h4>
-<!--l. 3262--><p class="noindent" >The Lua alternative to the <a
+<!--l. 3285--><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
+ id="dx1-19001"></a></a> Perl script requires a Lua interpreter, which should already be
available if you have a modern TeX distribution that includes LuaTeX. Lua is a light-weight, cross-platform
scripting language, but because it’s light-weight it doesn’t have the full-functionality of heavy-weight scripting
languages, such as Perl. The <a
href="#glo:makeglossaries-lite.lua"><span
class="cmtt-10">makeglossaries-lite</span><a
- id="dx1-18002"></a></a> script is therefore limited by this and some of the
+ id="dx1-19002"></a></a> script is therefore limited by this and some of the
options available to the <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-18003"></a></a> Perl script aren’t available here. (In particular the <span
+ id="dx1-19003"></a></a> Perl script aren’t available here. (In particular the <span
class="cmtt-10">-d</span><a
- id="dx1-18004"></a>
+ id="dx1-19004"></a>
option.)
-</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
+</p><!--l. 3295--><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
+ id="dx1-19005"></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. 3278--><p class="noindent" >
-</p><!--l. 3280--><p class="indent" > The <a
+</p><!--l. 3301--><p class="noindent" >
+</p><!--l. 3303--><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
+ id="dx1-19006"></a></a> script can be invoked in the same way as <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-18007"></a></a>. For example, if your
+ id="dx1-19007"></a></a>. For example, if your
document is called <span
class="cmtt-10">myDoc.tex</span>, then do
-</p><!--l. 3283--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3306--><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>
@@ -7542,73 +7581,73 @@
<br /></span>
or
-</p><!--l. 3287--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3310--><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. 3291--><p class="indent" > <span
+</p><!--l. 3314--><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
- id="dx1-18008"></a></a> script are also available with the Lua
+ id="dx1-19008"></a></a> script are also available with the Lua
<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. 3294--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-19009"></a></a> script. For a complete list of available options, do
+</p><!--l. 3317--><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. 3300--><p class="noindent" >
+</p><!--l. 3323--><p class="noindent" >
</p>
-<!--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
+<!--l. 3323--><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:xindyapp"></a>Using <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span></a> explicitly (Option 3)</h4>
-<!--l. 3303--><p class="noindent" ><a
+<!--l. 3326--><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
+ id="dx1-20001"></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. 3309--><p class="indent" > If you want to use <a
+</p><!--l. 3332--><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
+ id="dx1-20002"></a></a> to process the glossary files, you must make sure you have used the <span
class="cmss-10">xindy</span><a
- id="dx1-19003"></a> package
+ id="dx1-20003"></a> package
option:
</p>
- <pre class="verbatim" id="verbatim-65">
+ <pre class="verbatim" id="verbatim-67">
\usepackage[xindy]{glossaries}
</pre>
-<!--l. 3314--><p class="nopar" > This is required regardless of whether you use <a
+<!--l. 3337--><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
+ id="dx1-20004"></a></a> explicitly or whether it’s called implicitly via applications
such as <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-19005"></a></a>. This causes the glossary entries to be written in raw <span
+ id="dx1-20005"></a></a>. This causes the glossary entries to be written in raw <span
class="cmtt-10">xindy</span><a
- id="dx1-19006"></a> format, so you need to use
+ id="dx1-20006"></a> format, so you need to use
<span
class="cmtt-10">-I</span><a
- id="dx1-19007"></a> <span
+ id="dx1-20007"></a> <span
class="cmtt-10">xindy </span><span
class="cmti-10">not </span><span
class="cmtt-10">-I</span><a
- id="dx1-19008"></a> <span
+ id="dx1-20008"></a> <span
class="cmtt-10">tex</span>.
-</p><!--l. 3321--><p class="indent" > To run <a
+</p><!--l. 3344--><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. 3323--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-20009"></a></a> type the following in your terminal (all on one line):
+</p><!--l. 3346--><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
@@ -7624,46 +7663,46 @@
class="cmti-10">base</span>⟩ is the name of the document
without the <span
class="cmtt-10">tex</span><a
- id="dx1-19010"></a> extension and ⟨<span
+ id="dx1-20010"></a> extension and ⟨<span
class="cmti-10">style</span>⟩ is the name of the <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-19011"></a></a> style file without the <span
+ id="dx1-20011"></a></a> style file without the <span
class="cmtt-10">xdy</span><a
- id="dx1-19012"></a> extension. The default
+ id="dx1-20012"></a> extension. The default
name for this style file is ⟨<span
class="cmti-10">base</span>⟩<span
class="cmtt-10">xdy</span><a
- id="dx1-19013"></a> but can be changed via <span
+ id="dx1-20013"></a> but can be changed via <span
class="cmtt-10">\setStyleFile</span><a
- id="dx1-19014"></a><span
+ id="dx1-20014"></a><span
class="cmtt-10">{</span>⟨<span
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. 3336--><p class="indent" > For example, if your document is called <span
+</p><!--l. 3359--><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. 3339--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3362--><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. 3343--><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. 3366--><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
+ id="dx1-20015"></a> package option), substituting <span
class="cmtt-10">glg</span><a
- id="dx1-19016"></a>, <span
+ id="dx1-20016"></a>, <span
class="cmtt-10">gls</span><a
- id="dx1-19017"></a> and <span
+ id="dx1-20017"></a> and <span
class="cmtt-10">glo</span><a
- id="dx1-19018"></a>
+ id="dx1-20018"></a>
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
+ id="dx1-20019"></a> package option, then you would need to
do:
-</p><!--l. 3350--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3373--><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>
@@ -7670,18 +7709,18 @@
For additional glossaries, the extensions are those supplied when you created the glossary with
<span
class="cmtt-10">\newglossary</span><a
- id="dx1-19020"></a>.
-</p><!--l. 3356--><p class="indent" > Note that if you use <a
+ id="dx1-20020"></a>.
+</p><!--l. 3379--><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
+ id="dx1-20021"></a></a> instead, you can replace all those calls to <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-19022"></a></a> with just one call to
+ id="dx1-20022"></a></a> with just one call to
<span
class="cmtt-10">makeglossaries</span><a
- id="dx1-19023"></a>:
-</p><!--l. 3359--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-20023"></a>:
+</p><!--l. 3382--><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>
@@ -7688,32 +7727,32 @@
Note also that some commands and package options have no effect if you use <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-19024"></a></a> explicitly instead of using
+ id="dx1-20024"></a></a> explicitly instead of using
<span
class="cmtt-10">makeglossaries</span><a
- id="dx1-19025"></a>. These are listed in <a
+ id="dx1-20025"></a>. These are listed in <a
href="#tab:makeglossariesCmds">table <span
-class="cmbx-10">??</span>tab:makeglossariesCmds</a>.
+class="cmbx-10">1.3</span></a>.
-</p><!--l. 3369--><p class="noindent" >
+</p><!--l. 3392--><p class="noindent" >
</p>
-<!--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
+<!--l. 3392--><p class="noindent" ><a
+href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.5.4 </span> <a
id="sec:makeindexapp"></a>Using <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span></a> explicitly (Option 2)</h4>
-<!--l. 3372--><p class="noindent" >If you want to use <a
+<!--l. 3395--><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
+ id="dx1-21001"></a></a> explicitly, you must make sure that you haven’t used the <span
class="cmss-10">xindy</span><a
- id="dx1-20002"></a> package option or
+ id="dx1-21002"></a> package option or
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
+ id="dx1-21003"></a>, type the following in your
terminal:
-</p><!--l. 3377--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3400--><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
@@ -7724,31 +7763,31 @@
where ⟨<span
class="cmti-10">base</span>⟩ is the name of your document without the <span
class="cmtt-10">tex</span><a
- id="dx1-20004"></a> extension and ⟨<span
+ id="dx1-21004"></a> extension and ⟨<span
class="cmti-10">style</span>⟩<span
class="cmtt-10">ist</span><a
- id="dx1-20005"></a> is the name of the
+ id="dx1-21005"></a> is the name of the
<a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-20006"></a></a> style file. By default, this is ⟨<span
+ id="dx1-21006"></a></a> style file. By default, this is ⟨<span
class="cmti-10">base</span>⟩<span
class="cmtt-10">ist</span><a
- id="dx1-20007"></a>, but may be changed via <span
+ id="dx1-21007"></a>, but may be changed via <span
class="cmtt-10">\setStyleFile</span><a
- id="dx1-20008"></a><span
+ id="dx1-21008"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">style</span>⟩<span
class="cmtt-10">}</span>. Note
that there are other options, such as <span
class="cmtt-10">-l</span><a
- id="dx1-20009"></a> (letter ordering). See the <span
+ id="dx1-21009"></a> (letter ordering). See the <span
class="cmtt-10">makeindex</span><a
- id="dx1-20010"></a> manual for further
+ id="dx1-21010"></a> manual for further
details.
-</p><!--l. 3388--><p class="indent" > For example, if your document is called <span
+</p><!--l. 3411--><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. 3390--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3413--><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>
@@ -7755,21 +7794,21 @@
Note that this only creates the main glossary. If you have additional glossaries (for example, if you have used the
<span
class="cmss-10">acronym</span><a
- id="dx1-20011"></a> package option) then you must call <a
+ id="dx1-21011"></a> package option) then you must call <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-20012"></a></a> for each glossary, substituting <span
+ id="dx1-21012"></a></a> for each glossary, substituting <span
class="cmtt-10">glg</span><a
- id="dx1-20013"></a>, <span
+ id="dx1-21013"></a>, <span
class="cmtt-10">gls</span><a
- id="dx1-20014"></a> and <span
+ id="dx1-21014"></a> and <span
class="cmtt-10">glo</span><a
- id="dx1-20015"></a> with
+ id="dx1-21015"></a> with
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
+ id="dx1-21016"></a> package option, then you need to type the
following in your terminal:
-</p><!--l. 3401--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+</p><!--l. 3424--><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>
@@ -7776,59 +7815,59 @@
For additional glossaries, the extensions are those supplied when you created the glossary with
<span
class="cmtt-10">\newglossary</span><a
- id="dx1-20017"></a>.
-</p><!--l. 3407--><p class="indent" > Note that if you use <a
+ id="dx1-21017"></a>.
+</p><!--l. 3430--><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
+ id="dx1-21018"></a></a> instead, you can replace all those calls to <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-20019"></a></a> with just one call
+ id="dx1-21019"></a></a> with just one call
to <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-20020"></a>:
-</p><!--l. 3410--><p class="indent" > <spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
+ id="dx1-21020"></a>:
+</p><!--l. 3433--><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>
Note also that some commands and package options have no effect if you use <span
class="cmtt-10">makeindex</span><a
- id="dx1-20021"></a> explicitly instead of
+ id="dx1-21021"></a> explicitly instead of
using <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-20022"></a></a>. These are listed in <a
+ id="dx1-21022"></a></a>. These are listed in <a
href="#tab:makeglossariesCmds">table <span
-class="cmbx-10">??</span>tab:makeglossariesCmds</a>.
-</p><!--l. 3418--><p class="noindent" >
+class="cmbx-10">1.3</span></a>.
+</p><!--l. 3441--><p class="noindent" >
</p>
-<!--l. 3418--><p class="noindent" ><a
-href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.5 </span> <a
+<!--l. 3441--><p class="noindent" ><a
+href="#top">Top</a><h3 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">1.6 </span> <a
id="sec:notedev"></a>Note to Front-End and Script Developers</h3>
-<!--l. 3421--><p class="noindent" >The information needed to determine whether to use <a
+<!--l. 3444--><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
+ id="dx1-22001"></a></a>, <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-21002"></a></a> or <a
+ id="dx1-22002"></a></a> or <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-21003"></a></a> is stored in the <span
+ id="dx1-22003"></a></a> is stored in the <span
class="cmtt-10">aux</span><a
- id="dx1-21004"></a> file.
+ id="dx1-22004"></a> file.
This information can be gathered by a front-end, editor or script to make the glossaries where appropriate. This
section describes how the information is stored in the auxiliary file.
-</p><!--l. 3427--><p class="noindent" >
+</p><!--l. 3450--><p class="noindent" >
</p>
-<!--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. 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
+<!--l. 3450--><p class="noindent" ><a
+href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.6.1 </span> <a
+ id="makeindexandxindy"></a>MakeIndex and Xindy</h4>
+<!--l. 3453--><p class="noindent" >The file extensions used by each defined (but not ignored) glossary are given by
+</p><!--l. 3454--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-23001"></a> <span
class="cmtt-10">\@newglossary{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -7838,7 +7877,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">in-ext</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3433--><p class="noindent" >
+</p><!--l. 3456--><p class="noindent" >
where ⟨<span
class="cmti-10">in-ext</span>⟩ is the extension of the <a
href="#glo:indexingapp"><span
@@ -7853,19 +7892,19 @@
glossary is also given. This isn’t required with <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-22002"></a></a>, but with <a
+ id="dx1-23002"></a></a>, but with <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-22003"></a></a> it’s needed to pick up the associated
+ id="dx1-23003"></a></a> it’s needed to pick up the associated
language and encoding (see below). For example, the information for the default main glossary is written
as:
</p>
- <pre class="verbatim" id="verbatim-66">
+ <pre class="verbatim" id="verbatim-68">
\@newglossary{main}{glg}{gls}{glo}
</pre>
-<!--l. 3447--><p class="nopar" > If <a
+<!--l. 3470--><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
@@ -7875,39 +7914,39 @@
<div class="obeylines-v">
<span id="textcolor181"><span
class="cmtt-10">\glsxtr at makeglossaries</span></span><a
- id="dx1-22004"></a><span
+ id="dx1-23004"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">list</span>⟩<span
class="cmtt-10">}</span>
</div>
</div>
-<!--l. 3455--><p class="indent" > The <a
+<!--l. 3478--><p class="indent" > The <a
href="#glo:indexingapp">indexing application’s</a> style file is specified by
-</p><!--l. 3456--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22005"></a> <span
+</p><!--l. 3479--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-23005"></a> <span
class="cmtt-10">\@istfilename{</span>⟨<span
class="cmitt-10">filename</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3458--><p class="noindent" >
+</p><!--l. 3481--><p class="noindent" >
The file extension indicates whether to use <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-22006"></a></a> (<span
+ id="dx1-23006"></a></a> (<span
class="cmtt-10">ist</span><a
- id="dx1-22007"></a>) or <a
+ id="dx1-23007"></a>) or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-22008"></a></a> (<span
+ id="dx1-23008"></a></a> (<span
class="cmtt-10">xdy</span><a
- id="dx1-22009"></a>). Note that the glossary information
+ id="dx1-23009"></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. 3465--><p class="indent" > For example, with <span
+</p><!--l. 3488--><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
+ id="dx1-23010"></a> you can easily determine whether to run <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-22011"></a></a>: </p><div class="alltt">
+ id="dx1-23011"></a></a>: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">%</span><span
@@ -7920,40 +7959,40 @@
</div> It’s more complicated if you want to explicitly run <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-22012"></a></a> or <a
+ id="dx1-23012"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-22013"></a></a>
-<!--l. 3472--><p class="indent" > <div class="important" title="Important Note"> Note that if you choose to explicitly call <a
+ id="dx1-23013"></a></a>
+<!--l. 3495--><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
+ id="dx1-23014"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-22015"></a></a> then the user will miss out on the diagnostic
+ id="dx1-23015"></a></a> then the user will miss out on the diagnostic
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. 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
+ id="dx1-23016"></a></a> also provides. </div>
+</p><!--l. 3500--><p class="noindent" >
+</p><!--l. 3502--><p class="indent" > Word or letter ordering is specified by:
+</p><!--l. 3503--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-23017"></a> <span
class="cmtt-10">\@glsorder{</span>⟨<span
class="cmitt-10">order</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3482--><p class="noindent" >
+</p><!--l. 3505--><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. 3485--><p class="indent" > If <a
+</p><!--l. 3508--><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. 3487--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22019"></a><a
- id="dx1-22020"></a> <span
+ id="dx1-23018"></a></a> should be used, the language and code page for each glossary is specified by
+</p><!--l. 3510--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-23019"></a><a
+ id="dx1-23020"></a> <span
class="cmtt-10">\@xdylanguage{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -7965,7 +8004,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">code</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3490--><p class="noindent" >
+</p><!--l. 3513--><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
@@ -7975,13 +8014,13 @@
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. 3496--><p class="indent" > If <a
+ id="dx1-23021"></a></a> should be used.
+</p><!--l. 3519--><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. 3497--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-22023"></a> <span
+ id="dx1-23022"></a> file will contain
+</p><!--l. 3520--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-23023"></a> <span
class="cmtt-10">\@gls at reference{</span>⟨<span
class="cmitt-10">type</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -7989,54 +8028,54 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">location</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3499--><p class="noindent" >
+</p><!--l. 3522--><p class="noindent" >
for every time an entry has been referenced.
-</p><!--l. 3502--><p class="noindent" >
+</p><!--l. 3525--><p class="noindent" >
</p>
-<!--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. 3505--><p class="noindent" >If you need to gather labels for auto-completion, the <span
+<!--l. 3525--><p class="noindent" ><a
+href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.6.2 </span> <a
+ id="entrylabels"></a>Entry Labels</h4>
+<!--l. 3528--><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
+ id="dx1-24001"></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). 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
+ id="dx1-24002"></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
+</p><!--l. 3535--><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-23003"></a>, which will create the <span
+ id="dx1-24003"></a>, which will create the <span
class="cmtt-10">glsdefs</span><a
- id="dx1-23004"></a> file but will act like
+ id="dx1-24004"></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-23005"></a>. </div>
-</p><!--l. 3516--><p class="noindent" >
-</p><!--l. 3518--><p class="noindent" >
+ id="dx1-24005"></a>. </div>
+</p><!--l. 3539--><p class="noindent" >
+</p><!--l. 3541--><p class="noindent" >
</p>
-<!--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. 3521--><p class="noindent" ><span style="float: left; font-size: small; border: solid 2px green; margin-right: 1em;"><a
+<!--l. 3541--><p class="noindent" ><a
+href="#top">Top</a><h4 class="subsectionHead"></p><h4 class="subsectionHead"><span class="titlemark">1.6.3 </span> <a
+ id="bib2gls"></a>Bib2Gls</h4>
+<!--l. 3544--><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
+ id="dx1-25001"></a></a></span>If <a
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">
+ id="dx1-25002"></a> file will contain one or more instances of </p><div class="alltt">
<div class="obeylines-v">
<span id="textcolor184"><span
class="cmtt-10">\glsxtr at resource</span></span><a
- id="dx1-24003"></a><span
+ id="dx1-25003"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -8046,10 +8085,10 @@
</div> where ⟨<span
class="cmti-10">basename</span>⟩ is the basename of the <span
class="cmtt-10">glstex</span><a
- id="dx1-24004"></a> file that needs to be created by <a
+ id="dx1-25004"></a> file that needs to be created by <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-24005"></a></a>. If <span
+ id="dx1-25005"></a></a>. If <span
class="cmtt-10">src=</span>
<span
class="cmtt-10">{</span>⟨<span
@@ -8058,14 +8097,14 @@
class="cmti-10">options</span>⟩ then ⟨<span
class="cmti-10">basename</span>⟩ also indicates the name of the associated <span
class="cmtt-10">bib</span><a
- id="dx1-24006"></a>
+ id="dx1-25006"></a>
file.
-<!--l. 3531--><p class="indent" > For example, with <span
+<!--l. 3554--><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
+ id="dx1-25007"></a> you can easily determine whether or not to run <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-24008"></a></a>: </p><div class="alltt">
+ id="dx1-25008"></a></a>: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">%</span><span
@@ -8077,30 +8116,30 @@
</div>
</div> (It gets more complicated if both <span id="textcolor185"><span
class="cmtt-10">\glsxtr at resource</span></span><a
- id="dx1-24009"></a> and <span
+ id="dx1-25009"></a> and <span
class="cmtt-10">\@istfilename </span>are present as that indicates the
hybrid <span id="textcolor186"><span
class="cmss-10">record</span><span
class="cmtt-10">=</span><span
class="cmss-10">hybrid</span></span><a
- id="dx1-24010"></a> option.)
-<!--l. 3540--><p class="indent" > Remember that with <a
+ id="dx1-25010"></a> option.)
+<!--l. 3563--><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
+ id="dx1-25011"></a></a>, the entries will never be defined on the first LaTeX call (because their
definitions are contained in the <span
class="cmtt-10">glstex</span><a
- id="dx1-24012"></a> file created by <a
+ id="dx1-25012"></a> file created by <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-24013"></a></a>). You can also pick up labels from the records in
+ id="dx1-25013"></a></a>). You can also pick up labels from the records in
<span
class="cmtt-10">aux</span><a
- id="dx1-24014"></a> file, which will be in the form: </p><div class="alltt">
+ id="dx1-25014"></a> file, which will be in the form: </p><div class="alltt">
<div class="obeylines-v">
<span id="textcolor187"><span
class="cmtt-10">\glsxtr at record</span></span><a
- id="dx1-24015"></a><span
+ id="dx1-25015"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -8117,13 +8156,13 @@
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">
+ id="dx1-25016"></a>) <div class="alltt">
<div class="obeylines-v">
<span id="textcolor189"><span
class="cmtt-10">\glsxtr at record@nameref</span></span><a
- id="dx1-24017"></a><span
+ id="dx1-25017"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -8152,7 +8191,7 @@
<div class="obeylines-v">
<span id="textcolor190"><span
class="cmtt-10">\glsxtr at recordsee</span></span><a
- id="dx1-24018"></a><span
+ id="dx1-25018"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -8162,17 +8201,17 @@
</div>
</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
+ id="dx1-25019"></a>, which are added to the <span
class="cmtt-10">aux</span><a
- id="dx1-24020"></a> file for
+ id="dx1-25020"></a> file for
<a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-24021"></a>’s</a> benefit: <div class="alltt">
+ id="dx1-25021"></a>’s</a> benefit: <div class="alltt">
<div class="obeylines-v">
<span id="textcolor192"><span
class="cmtt-10">\@glsxtr at newglslike</span></span><a
- id="dx1-24022"></a><span
+ id="dx1-25022"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">label-prefix</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -8181,11 +8220,11 @@
</div>
</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">
+ id="dx1-25023"></a> is used, then the modifier is identified with: <div class="alltt">
<div class="obeylines-v">
<span id="textcolor194"><span
class="cmtt-10">\@glsxtr at altmodifier</span></span><a
- id="dx1-24024"></a><span
+ id="dx1-25024"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">character</span>⟩<span
class="cmtt-10">}</span>
@@ -8192,11 +8231,11 @@
</div>
</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">
+ id="dx1-25025"></a> set of commands) are identified with: <div class="alltt">
<div class="obeylines-v">
<span id="textcolor196"><span
class="cmtt-10">\@glsxtr at prefixlabellist</span></span><a
- id="dx1-24026"></a><span
+ id="dx1-25026"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">list</span>⟩<span
class="cmtt-10">}</span>
@@ -8204,21 +8243,21 @@
</div>
-<!--l. 3573--><p class="indent" > </div>
-</p><!--l. 3573--><p class="noindent" ><a
+<!--l. 3596--><p class="indent" > </div>
+</p><!--l. 3596--><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. 3576--><p class="indent" > This section describes the available <span
+</p><!--l. 3599--><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
class="cmss-10">acronym</span><a
- id="dx1-25001"></a> is equivalent to <span
+ id="dx1-26001"></a> is equivalent to <span
class="cmss-10">acronym</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-25002"></a>).
-</p><!--l. 3580--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+ id="dx1-26002"></a>).
+</p><!--l. 3603--><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
@@ -8227,57 +8266,57 @@
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. 3587--><p class="noindent" >
-</p><!--l. 3589--><p class="indent" > <div class="important" title="Important Note"> Note that ⟨<span
+</p><!--l. 3610--><p class="noindent" >
+</p><!--l. 3612--><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
class="cmti-10">value</span>⟩ part may be omitted, such as <span
class="cmss-10">acronym</span><a
- id="dx1-25003"></a>.) This is a general limitation not restricted to the
+ id="dx1-26003"></a>.) This is a general limitation not restricted to the
<span
class="cmss-10">glossaries </span>package. Options that aren’t ⟨<span
class="cmti-10">key</span>⟩=⟨<span
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
+ id="dx1-26004"></a>) may be passed via the document class
options. </div>
-</p><!--l. 3596--><p class="noindent" >
+</p><!--l. 3619--><p class="noindent" >
</p>
-<!--l. 3598--><p class="noindent" ><a
+<!--l. 3621--><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. 3601--><p class="noindent" >
+<!--l. 3624--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-270002.1"></a><a
+ id="x1-280002.1"></a><a
id="pkgopt:nowarn"></a><span
class="cmss-10">nowarn</span></h4>
-<!--l. 3601--><p class="noindent" >This suppresses all warnings generated by the <span
+<!--l. 3624--><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
<span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-27001"></a>). Note that if you use <span
+ id="dx1-28001"></a>). Note that if you use <span
class="cmss-10">debug</span><a
- id="dx1-27002"></a> with any value other than <span
+ id="dx1-28002"></a> with any value other than <span
class="cmss-10">false </span>it will override this
option.
-</p><!--l. 3608--><p class="noindent" >
+</p><!--l. 3631--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-280002.1"></a><a
+ id="x1-290002.1"></a><a
id="pkgopt:nolangwarn"></a><span
class="cmss-10">nolangwarn</span></h4>
-<!--l. 3608--><p class="noindent" >This suppresses the warning generated by a missing language module.
-</p><!--l. 3611--><p class="noindent" >
+<!--l. 3631--><p class="noindent" >This suppresses the warning generated by a missing language module.
+</p><!--l. 3634--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-290002.1"></a><a
+ id="x1-300002.1"></a><a
id="pkgopt:noredefwarn"></a><span
class="cmss-10">noredefwarn</span></h4>
-<!--l. 3611--><p class="noindent" >If you load <span
+<!--l. 3634--><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
@@ -8285,26 +8324,26 @@
class="cmss-10">glossaries </span>with that class or package and you don’t want to be warned about it, use this option to suppress those
warnings. Other warnings will still be issued unless you use the <span
class="cmss-10">nowarn</span><a
- id="dx1-29001"></a> option described above. (This option is
+ id="dx1-30001"></a> option described above. (This option is
automatically switched on by <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.)
-</p><!--l. 3621--><p class="noindent" >
+</p><!--l. 3644--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-300002.1"></a><a
+ id="x1-310002.1"></a><a
id="pkgopt:debug"></a><span
class="cmss-10">debug=</span><span
class="cmtt-10">{</span>⟨<span
class="cmssi-10">value</span>⟩<span
class="cmtt-10">}</span></h4>
-<!--l. 3621--><p class="noindent" >Introduced in version 4.24. The default setting is <span
+<!--l. 3644--><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
- id="dx1-30001"></a>. The following values are available: <span
+ id="dx1-31001"></a>. The following values are available: <span
class="cmss-10">false</span>, <span
class="cmss-10">true</span>,
<span
@@ -8313,37 +8352,37 @@
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. 3627--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+ id="dx1-31002"></a> is assumed.
+</p><!--l. 3650--><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="textcolor197"><span
class="cmss-10">showwrgloss</span></span><a
- id="dx1-30003"></a>, that may be used to show where the indexing
+ id="dx1-31003"></a>, that may be used to show where the indexing
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
+ id="dx1-31004"></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. 3633--><p class="noindent" >
-</p><!--l. 3635--><p class="indent" > All values other than <span
+</p><!--l. 3656--><p class="noindent" >
+</p><!--l. 3658--><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
- id="dx1-30005"></a> switch on the debug mode (and will automatically cancel the <span
+ id="dx1-31005"></a> switch on the debug mode (and will automatically cancel the <span
class="cmss-10">nowarn</span><a
- id="dx1-30006"></a>
+ id="dx1-31006"></a>
option). The <span
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. 3638--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-30008"></a> <span
+ id="dx1-31007"></a> option will additionally use:
+</p><!--l. 3661--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-31008"></a> <span
class="cmtt-10">\glsshowtarget{</span>⟨<span
class="cmitt-10">target name</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3640--><p class="noindent" >
+</p><!--l. 3663--><p class="noindent" >
to show the hypertarget or hyperlink name when <span
class="cmtt-10">\glsdohypertarget </span>is used by commands like
<span
@@ -8352,17 +8391,17 @@
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. 3646--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-30009"></a> <span
+</p><!--l. 3669--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-31009"></a> <span
class="cmtt-10">\glsshowtargetouter{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3648--><p class="noindent" >
+</p><!--l. 3671--><p class="noindent" >
which by default places the target name in the margin. The font is given by:
-</p><!--l. 3651--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-30010"></a> <span
+</p><!--l. 3674--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-31010"></a> <span
class="cmtt-10">\glsshowtargetfont </span></div><hr>
-</p><!--l. 3653--><p class="noindent" >
+</p><!--l. 3676--><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
@@ -8371,18 +8410,18 @@
</p>
- <pre class="verbatim" id="verbatim-67">
+ <pre class="verbatim" id="verbatim-69">
\renewcommand*{\glsshowtargetouter}[1]{%
 {\glsshowtargetfont [#1]}}
</pre>
-<!--l. 3661--><p class="nopar" >
-</p><!--l. 3663--><p class="indent" > Similarly, the <span
+<!--l. 3684--><p class="nopar" >
+</p><!--l. 3686--><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. 3665--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-30012"></a> <span
+ id="dx1-31011"></a> will add the accessibility support information using:
+</p><!--l. 3688--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-31012"></a> <span
class="cmtt-10">\glsshowaccsupp{</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -8390,13 +8429,13 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">replacement text</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 3667--><p class="noindent" >
+</p><!--l. 3690--><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
+ id="dx1-31013"></a>. This option is provided for use with <span
class="cmss-10">glossaries-accsupp</span><a
- id="dx1-30014"></a>.
-</p><!--l. 3671--><p class="indent" > The purpose of the debug mode can be demonstrated with the following example document:
+ id="dx1-31014"></a>.
+</p><!--l. 3694--><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
@@ -8409,7 +8448,7 @@
class="cmtt-10">\newglossaryentry{sample2}{name={sample2},description={example}}</span>
<br /><strong><span
class="cmtt-10">\glsadd</span><a
- id="dx1-30015"></a></strong><span
+ id="dx1-31015"></a></strong><span
class="cmtt-10">{sample2}%</span><span
class="cmtt-10"> <-</span><span
class="cmtt-10"> does</span><span
@@ -8417,7 +8456,7 @@
class="cmtt-10"> here</span>
<br /><strong><span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-30016"></a></strong>
+ id="dx1-31016"></a></strong>
<br /><span
class="cmtt-10">\begin{document}</span>
<br /><span
@@ -8434,16 +8473,16 @@
class="cmtt-10">\glsadd{sample2}</span></span></span> has been used before the associated file is opened by
<span
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
+ id="dx1-31017"></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. 3692--><p class="indent" > Without <span
+<!--l. 3715--><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. 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
+</p><!--l. 3718--><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
@@ -8456,7 +8495,7 @@
href="#option4">4</a> for indexing, which don’t use
<span
class="cmtt-10">\makeglossaries</span>.
-</p><!--l. 3705--><p class="indent" > Therefore <span
+</p><!--l. 3728--><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
@@ -8463,25 +8502,25 @@
<span
class="cmtt-10">\glsadd</span>. These commands must be enabled by default. (It does, however, enable the <span
class="cmtt-10">see</span><a
- id="dx1-30018"></a> key as that’s a more
+ id="dx1-31018"></a> key as that’s a more
common problem. See below.)
-</p><!--l. 3710--><p class="indent" > The debug mode, enabled with the <span
+</p><!--l. 3733--><p class="indent" > The debug mode, enabled with the <span
class="cmss-10">debug</span><a
- id="dx1-30019"></a> option,
+ id="dx1-31019"></a> option,
</p>
- <pre class="verbatim" id="verbatim-68">
+ <pre class="verbatim" id="verbatim-70">
\usepackage[debug]{glossaries}
</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
+<!--l. 3736--><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><blockquote class="quote">
- <!--l. 3718--><p class="noindent" >Package glossaries Info: wrglossary(⟨<span
+ <!--l. 3741--><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></blockquote>
-<!--l. 3721--><p class="noindent" >where ⟨<span
+<!--l. 3744--><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
@@ -8489,97 +8528,97 @@
or <span
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
+ id="dx1-31020"></a> option and see if any information has been written to the log
file.
-</p><!--l. 3728--><p class="noindent" >
+</p><!--l. 3751--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-310002.1"></a><a
+ id="x1-320002.1"></a><a
id="pkgopt:savewrites"></a><span
class="cmss-10">savewrites=</span><span
class="cmtt-10">{</span>⟨<span
class="cmssi-10">boolean</span>⟩<span
class="cmtt-10">}</span></h4>
-<!--l. 3728--><p class="noindent" >This is a boolean option to minimise the number of write registers used by the <span
+<!--l. 3751--><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
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-31001"></a>. With Options <a
+ id="dx1-32001"></a>. With Options <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. 3734--><p class="indent" > With all options except Options <a
+</p><!--l. 3757--><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
- id="dx1-31002"></a> file is needed to
+ id="dx1-32002"></a> file is needed to
save document definitions. With both Options <a
href="#option1">1</a> and <a
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
+ id="dx1-32003"></a> file). If you really need document definitions
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
- id="dx1-31004"></a> with
+ id="dx1-32004"></a> with
<a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.
-</p><!--l. 3743--><p class="indent" > There are only a limited number of write registers, and if you have a large number of glossaries
+</p><!--l. 3766--><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
+ id="dx1-32005"></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. 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
+</p><!--l. 3774--><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
+ id="dx1-32006"></a></a> will be incorrect on page boundaries due to TeX’s asynchronous output routine. As an
alternative, you can use the <span
class="cmss-10">scrwfile</span><a
- id="dx1-31007"></a> package (part of the KOMA-Script bundle) and not use this option.
+ id="dx1-32007"></a> package (part of the KOMA-Script bundle) and not use this option.
</div>
-</p><!--l. 3757--><p class="noindent" >
-</p><!--l. 3759--><p class="indent" > By way of comparison, <span
+</p><!--l. 3780--><p class="noindent" >
+</p><!--l. 3782--><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
- id="dx1-31008"></a></a> has a total of
+ id="dx1-32008"></a></a> has a total of
15 glossaries. With Options <a
href="#option2">2</a> or <a
href="#option3">3</a>, this would require 46 associated files and 16 write
registers.<span class="footnote-mark"><a
href="#fn1x2" id="fn1x2-bk"><sup class="textsuperscript">2.1</sup></a></span><a
- id="x1-31009f1"></a>
+ id="x1-32009f1"></a>
With <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-31011"></a></a>, no write registers are required and there are only 10 associated files for that particular document
+ id="dx1-32011"></a></a>, no write registers are required and there are only 10 associated files for that particular document
(9 resource files and 1 transcript file).
-</p><!--l. 3769--><p class="indent" > <span class="warningsymbol">⚠</span> If you want to use TeX’s <span
+</p><!--l. 3792--><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
+ id="dx1-32012"></a> mechanism to call <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-31013"></a></a> or <a
+ id="dx1-32013"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-31014"></a></a> from your document and use
+ id="dx1-32014"></a></a> from your document and use
<span
class="cmss-10">savewrites</span><a
- id="dx1-31015"></a>, you must create the external files with <span
+ id="dx1-32015"></a>, you must create the external files with <span
class="cmtt-10">\glswritefiles </span>before you call <span
class="cmtt-10">makeindex</span><a
- id="dx1-31016"></a>/<span
+ id="dx1-32016"></a>/<span
class="cmtt-10">xindy</span><a
- id="dx1-31017"></a>. Also set
+ id="dx1-32017"></a>. Also set
<span
class="cmtt-10">\glswritefiles </span>to nothing or <span
class="cmtt-10">\relax </span>before the end of the document to avoid rewriting the files. For
@@ -8587,259 +8626,259 @@
</p>
- <pre class="verbatim" id="verbatim-69">
+ <pre class="verbatim" id="verbatim-71">
\glswritefiles
\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" >
+<!--l. 3804--><p class="nopar" >
+</p><!--l. 3806--><p class="noindent" >In general, this package option is best avoided.
+</p><!--l. 3809--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-320002.1"></a><a
+ id="x1-330002.1"></a><a
id="pkgopt:translate"></a><span
class="cmss-10">translate=</span><span
class="cmtt-10">{</span>⟨<span
class="cmssi-10">value</span>⟩<span
class="cmtt-10">}</span></h4>
-<!--l. 3786--><p class="noindent" >This can take the following values:
+<!--l. 3809--><p class="noindent" >This can take the following values:
</p><dl class="description"><dt class="description">
- <!--l. 3789--><p class="noindent" >
+ <!--l. 3812--><p class="noindent" >
<span
class="cmssbx-10">true</span><a
- id="dx1-32001"></a> </p></dt><dd
+ id="dx1-33001"></a> </p></dt><dd
class="description">
- <!--l. 3789--><p class="noindent" >If <span
+ <!--l. 3812--><p class="noindent" >If <span
class="cmss-10">babel</span><a
- id="dx1-32002"></a> has been loaded and the <span
+ id="dx1-33002"></a> has been loaded and the <span
class="cmss-10">translator</span><a
- id="dx1-32003"></a> package is installed, <span
+ id="dx1-33003"></a> package is installed, <span
class="cmss-10">translator</span><a
- id="dx1-32004"></a> will be loaded and the
+ id="dx1-33004"></a> will be loaded and the
translations will be provided by the <span
class="cmss-10">translator</span><a
- id="dx1-32005"></a> package interface. You can modify the translations
+ id="dx1-33005"></a> package interface. You can modify the translations
by providing your own dictionary. If the <span
class="cmss-10">translator</span><a
- id="dx1-32006"></a> package isn’t installed and <span
+ id="dx1-33006"></a> package isn’t installed and <span
class="cmss-10">babel</span><a
- id="dx1-32007"></a> is loaded,
+ id="dx1-33007"></a> is loaded,
the <span
class="cmss-10">glossaries-babel</span><a
- id="dx1-32008"></a> package will be loaded and the translations will be provided using <span
+ id="dx1-33008"></a> package will be loaded and the translations will be provided using <span
class="cmss-10">babel</span>’s
<span
class="cmtt-10">\addto\caption</span>⟨<span
class="cmti-10">language</span>⟩ mechanism. If <span
class="cmss-10">polyglossia</span><a
- id="dx1-32009"></a> has been loaded, <span
+ id="dx1-33009"></a> has been loaded, <span
class="cmss-10">glossaries-polyglossia</span><a
- id="dx1-32010"></a> will be
+ id="dx1-33010"></a> will be
loaded.
</p></dd><dt class="description">
- <!--l. 3801--><p class="noindent" >
+ <!--l. 3824--><p class="noindent" >
<span
class="cmssbx-10">false</span><a
- id="dx1-32011"></a> </p></dt><dd
+ id="dx1-33011"></a> </p></dt><dd
class="description">
- <!--l. 3801--><p class="noindent" >Don’t provide translations, even if <span
+ <!--l. 3824--><p class="noindent" >Don’t provide translations, even if <span
class="cmss-10">babel</span><a
- id="dx1-32012"></a> or <span
+ id="dx1-33012"></a> or <span
class="cmss-10">polyglossia</span><a
- id="dx1-32013"></a> has been loaded. (Note that <span
+ id="dx1-33013"></a> has been loaded. (Note that <span
class="cmss-10">babel</span><a
- id="dx1-32014"></a> provides
+ id="dx1-33014"></a> provides
the command <span
class="cmtt-10">\glossaryname</span><a
- id="dx1-32015"></a> so that will still be translated if you have loaded <span
+ id="dx1-33015"></a> so that will still be translated if you have loaded <span
class="cmss-10">babel</span><a
- id="dx1-32016"></a>.)
+ id="dx1-33016"></a>.)
</p></dd><dt class="description">
- <!--l. 3806--><p class="noindent" >
+ <!--l. 3829--><p class="noindent" >
<span
class="cmssbx-10">babel</span><a
- id="dx1-32017"></a> </p></dt><dd
+ id="dx1-33017"></a> </p></dt><dd
class="description">
- <!--l. 3806--><p class="noindent" >Don’t load the <span
+ <!--l. 3829--><p class="noindent" >Don’t load the <span
class="cmss-10">translator</span><a
- id="dx1-32018"></a> package. Instead load <span
+ id="dx1-33018"></a> package. Instead load <span
class="cmss-10">glossaries-babel</span><a
- id="dx1-32019"></a>.
- </p><!--l. 3809--><p class="noindent" ><div class="important" title="Important Note"> I recommend you use <span
+ id="dx1-33019"></a>.
+ </p><!--l. 3832--><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
- id="dx1-32020"></a> if you have any problems with the translations or with PDF
+ id="dx1-33020"></a> if you have any problems with the translations or with PDF
bookmarks, but to maintain backward compatibility, if <span
class="cmss-10">babel</span><a
- id="dx1-32021"></a> has been loaded the default is <span
+ id="dx1-33021"></a> has been loaded the default is <span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-32022"></a>.
+ id="dx1-33022"></a>.
</div>
- </p><!--l. 3814--><p class="noindent" >
+ </p><!--l. 3837--><p class="noindent" >
</p>
</dd></dl>
-<!--l. 3818--><p class="indent" > If <span
+<!--l. 3841--><p class="indent" > If <span
class="cmss-10">translate</span><a
- id="dx1-32023"></a> is specified without a value, <span
+ id="dx1-33023"></a> is specified without a value, <span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-32024"></a> is assumed. If <span
+ id="dx1-33024"></a> is assumed. If <span
class="cmss-10">translate</span><a
- id="dx1-32025"></a> isn’t specified,
+ id="dx1-33025"></a> isn’t specified,
<span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-32026"></a> is assumed if <span
+ id="dx1-33026"></a> is assumed if <span
class="cmss-10">babel</span><a
- id="dx1-32027"></a>, <span
+ id="dx1-33027"></a>, <span
class="cmss-10">polyglossia</span><a
- id="dx1-32028"></a> or <span
+ id="dx1-33028"></a> or <span
class="cmss-10">translator</span><a
- id="dx1-32029"></a> have been loaded. Otherwise <span
+ id="dx1-33029"></a> have been loaded. Otherwise <span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-32030"></a> is
+ id="dx1-33030"></a> is
assumed.
-</p><!--l. 3824--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a
+</p><!--l. 3847--><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
- id="dx1-32031"></a> is detected then <span
+ id="dx1-33031"></a> is detected then <span
class="cmss-10">translate</span><span
class="cmtt-10">=</span><span
class="cmss-10">babel</span><a
- id="dx1-32032"></a> is automatically passed to the base <span
+ id="dx1-33032"></a> is automatically passed to the base <span
class="cmss-10">glossaries</span><a
- id="dx1-32033"></a>
+ id="dx1-33033"></a>
package. </div>
-</p><!--l. 3828--><p class="noindent" >
-</p><!--l. 3830--><p class="indent" > See <a
+</p><!--l. 3851--><p class="noindent" >
+</p><!--l. 3853--><p class="indent" > See <a
href="#sec:fixednames">§<span
-class="cmbx-10">??</span>sec:fixednames </a><a
+class="cmbx-10">1.4.1</span> </a><a
href="#sec:fixednames">Changing the Fixed Names<!--tex4ht:ref: sec:fixednames --></a> for further details.
-</p><!--l. 3832--><p class="noindent" >
+</p><!--l. 3855--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-330002.1"></a><a
+ id="x1-340002.1"></a><a
id="pkgopt:notranslate"></a><span
class="cmss-10">notranslate</span></h4>
-<!--l. 3832--><p class="noindent" >This is equivalent to <span
+<!--l. 3855--><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. 3836--><p class="noindent" >
+ id="dx1-34001"></a> and may be passed via the document class options.
+</p><!--l. 3859--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-340002.1"></a><a
+ id="x1-350002.1"></a><a
id="pkgopt:hyperfirst"></a><span
class="cmss-10">hyperfirst=</span><span
class="cmtt-10">{</span>⟨<span
class="cmssi-10">boolean</span>⟩<span
class="cmtt-10">}</span></h4>
-<!--l. 3836--><p class="noindent" >This is a boolean option that specifies whether each term has a hyperlink on <a
+<!--l. 3859--><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
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-34001"></a> (terms on <a
+ id="dx1-35001"></a> (terms on <a
href="#glo:firstuse">first use</a> have a hyperlink, unless explicitly suppressed using starred versions of
commands such as <span
class="cmtt-10">\gls*</span><a
- id="dx1-34002"></a> or by identifying the glossary with <span
+ id="dx1-35002"></a> or by identifying the glossary with <span
class="cmss-10">nohypertypes</span><a
- id="dx1-34003"></a>, described above). Note that
+ id="dx1-35003"></a>, described above). Note that
<span
class="cmss-10">nohypertypes</span><a
- id="dx1-34004"></a> overrides <span
+ id="dx1-35004"></a> overrides <span
class="cmss-10">hyperfirst</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-34005"></a>. This option only affects commands that check the <a
+ id="dx1-35005"></a>. This option only affects commands that check the <a
href="#glo:firstuseflag">first use flag</a>, such as
the <a
-href="#sec:gls-like"><span
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> commands (for example, <span
class="cmtt-10">\gls</span><a
- id="dx1-34006"></a> or <span
+ id="dx1-35006"></a> or <span
class="cmtt-10">\glsdisp</span><a
- id="dx1-34007"></a>), but not the <a
-href="#sec:glstext-like"><span
+ id="dx1-35007"></a>), but not the <a
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands (for example,
<span
class="cmtt-10">\glslink</span><a
- id="dx1-34008"></a> or <span
+ id="dx1-35008"></a> or <span
class="cmtt-10">\glstext</span><a
- id="dx1-34009"></a>).
-</p><!--l. 3848--><p class="indent" > The <span
+ id="dx1-35009"></a>).
+</p><!--l. 3871--><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
+ id="dx1-35010"></a> setting applies to all glossary types (unless identified by <span
class="cmss-10">nohypertypes</span><a
- id="dx1-34011"></a> or defined
+ id="dx1-35011"></a> or defined
with <span
class="cmtt-10">\newignoredglossary</span><a
- id="dx1-34012"></a>). It can be overridden on an individual basis by explicitly setting the
+ id="dx1-35012"></a>). It can be overridden on an individual basis by explicitly setting the
<span
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
+ id="dx1-35013"></a> key when referencing an entry (or by using the plus or starred version of the referencing
command).
-</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
+</p><!--l. 3878--><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
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-34014"></a> and apply <span
+ id="dx1-35014"></a> and apply <span
class="cmtt-10">\glsunsetall </span>to all the regular (non-acronym) glossaries. For
example:
</p>
- <pre class="verbatim" id="verbatim-70">
+ <pre class="verbatim" id="verbatim-72">
 \usepackage[acronym,hyperfirst=false]{glossaries}
 % 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
+<!--l. 3890--><p class="nopar" >
+</p><!--l. 3892--><p class="indent" > Alternatively you can redefine the hook
+</p><!--l. 3893--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-35015"></a> <span
class="cmtt-10">\glslinkcheckfirsthyperhook </span></div><hr>
-</p><!--l. 3872--><p class="noindent" >
+</p><!--l. 3895--><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
- id="dx1-34016"></a>. Within the definition of this
+ id="dx1-35016"></a>. Within the definition of this
command, you can use <span
class="cmtt-10">\glslabel</span><a
- id="dx1-34017"></a> to reference the entry label and <span
+ id="dx1-35017"></a> to reference the entry label and <span
class="cmtt-10">\glstype</span><a
- id="dx1-34018"></a> to reference the glossary type. You
+ id="dx1-35018"></a> to reference the glossary type. You
can also use <span
class="cmtt-10">\ifglsused</span><a
- id="dx1-34019"></a> to determine if the entry has been used. You can test if an entry is an acronym by
+ id="dx1-35019"></a> to determine if the entry has been used. You can test if an entry is an acronym by
checking if it has the <span
class="cmtt-10">long</span><a
- id="dx1-34020"></a> key set using <span
+ id="dx1-35020"></a> key set using <span
class="cmtt-10">\ifglshaslong</span><a
- id="dx1-34021"></a>. For example, to switch off the hyperlink on first use
+ id="dx1-35021"></a>. For example, to switch off the hyperlink on first use
just for acronyms:
</p>
- <pre class="verbatim" id="verbatim-71">
+ <pre class="verbatim" id="verbatim-73">
\renewcommand*{\glslinkcheckfirsthyperhook}{%
 \ifglsused{\glslabel}{}%
 {%
@@ -8847,20 +8886,20 @@
 }%
}
</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
+<!--l. 3911--><p class="nopar" >
+</p><!--l. 3913--><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
- id="dx1-34022"></a>. (You can, instead, redefine <span
+ id="dx1-35022"></a>. (You can, instead, redefine <span
class="cmtt-10">\glslinkpostsetkeys</span><a
- id="dx1-34023"></a>, which is used by both the <a
-href="#sec:gls-like"><span
+ id="dx1-35023"></a>, which is used by both the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> and
<a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands.)
-</p><!--l. 3895--><p class="indent" > The <a
+</p><!--l. 3918--><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
@@ -8868,58 +8907,58 @@
href="#glo:firstuse">first use</a> hyperlink for abbreviations and
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
+ id="dx1-35024"></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">nohyperfirst</span><a
- id="dx1-34025"></a> package option.) See the <a
+ id="dx1-35025"></a> package option.) See the <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> manual for further
details.
-</p><!--l. 3904--><p class="noindent" >
+</p><!--l. 3927--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-350002.1"></a><a
+ id="x1-360002.1"></a><a
id="pkgopt:writeglslabels"></a><span
class="cmss-10">writeglslabels</span></h4>
-<!--l. 3904--><p class="noindent" >This is a valueless option that will create a file called <span
+<!--l. 3927--><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
+ id="dx1-36001"></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>. If you also want the name, use
+ id="dx1-36002"></a>. If you also want the name, use
<span
class="cmss-10">writeglslabelnames</span><a
- id="dx1-35003"></a>. (See also <a
+ id="dx1-36003"></a>. (See also <a
href="#glo:glossaries-extra"><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-35004"></a> package option.)
-</p><!--l. 3913--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> Note that with <a
+ id="dx1-36004"></a> package option.)
+</p><!--l. 3936--><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-35005"></a></a> the file will only contain the entries that <a
+ id="dx1-36005"></a></a> the file will only contain the entries that <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-35006"></a></a> has selected from the <span
+ id="dx1-36006"></a></a> has selected from the <span
class="cmtt-10">bib</span><a
- id="dx1-35007"></a> files.
+ id="dx1-36007"></a> files.
</div>
-</p><!--l. 3916--><p class="noindent" >
-</p><!--l. 3918--><p class="noindent" >
+</p><!--l. 3939--><p class="noindent" >
+</p><!--l. 3941--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-360002.1"></a><a
+ id="x1-370002.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" >
+<!--l. 3941--><p class="noindent" >Similar to the above but writes both the label and name (separated by a tab).
+</p><!--l. 3944--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-370002.1"></a><span id="textcolor202"><a
+ id="x1-380002.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
@@ -8926,28 +8965,28 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">value</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 3923--><p class="noindent" >The value may be one of:
+<!--l. 3946--><p class="noindent" >The value may be one of:
</p><dl class="description"><dt class="description">
- <!--l. 3925--><p class="noindent" >
+ <!--l. 3948--><p class="noindent" >
<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
+ <!--l. 3948--><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>);
</p></dd><dt class="description">
- <!--l. 3928--><p class="noindent" >
+ <!--l. 3951--><p class="noindent" >
<span
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
+ <!--l. 3951--><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" >
+<!--l. 3955--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-380002.1"></a><span id="textcolor204"><a
+ id="x1-390002.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
@@ -8954,18 +8993,18 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">value</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 3934--><p class="noindent" >This option governs the use of <span
+<!--l. 3957--><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" >
+ <!--l. 3960--><p class="noindent" >
<span
class="cmssbx-10">false</span> </p></dt><dd
class="description">
- <!--l. 3937--><p class="noindent" ><span
+ <!--l. 3960--><p class="noindent" ><span
class="cmtt-10">\newglossaryentry </span>is not permitted in the <span
class="cmss-10">document</span><a
- id="dx1-38001"></a><a
- id="dx1-38002"></a> environment (default with <a
+ id="dx1-39001"></a><a
+ id="dx1-39002"></a> environment (default with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>
and for <a
@@ -8972,128 +9011,128 @@
href="#option1">Option 1</a> with just the base <span
class="cmss-10">glossaries </span>package);
</p></dd><dt class="description">
- <!--l. 3941--><p class="noindent" >
+ <!--l. 3964--><p class="noindent" >
<span
class="cmssbx-10">restricted</span> </p></dt><dd
class="description">
- <!--l. 3941--><p class="noindent" ><span
+ <!--l. 3964--><p class="noindent" ><span
class="cmtt-10">\newglossaryentry </span>is only permitted in the <span
class="cmss-10">document</span><a
- id="dx1-38003"></a><a
- id="dx1-38004"></a> environment if it occurs before
+ id="dx1-39003"></a><a
+ id="dx1-39004"></a> environment if it occurs before
<span
class="cmtt-10">\printglossary </span>(not available for some indexing options);
</p></dd><dt class="description">
- <!--l. 3945--><p class="noindent" >
+ <!--l. 3968--><p class="noindent" >
<span
class="cmssbx-10">atom</span> </p></dt><dd
class="description">
- <!--l. 3945--><p class="noindent" >as <span
+ <!--l. 3968--><p class="noindent" >as <span
class="cmss-10">restricted </span>but creates the <span
class="cmtt-10">docdefs</span><a
- id="dx1-38005"></a> file for use by <span
+ id="dx1-39005"></a> file for use by <span
class="cmtt-10">atom</span><a
- id="dx1-38006"></a> (without the limitations of <span id="textcolor206"><span
+ id="dx1-39006"></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-38007"></a>);
+ id="dx1-39007"></a>);
</p></dd><dt class="description">
- <!--l. 3949--><p class="noindent" >
+ <!--l. 3972--><p class="noindent" >
<span
class="cmssbx-10">true</span> </p></dt><dd
class="description">
- <!--l. 3949--><p class="noindent" ><span
+ <!--l. 3972--><p class="noindent" ><span
class="cmtt-10">\newglossaryentry </span>is permitted in the <span
class="cmss-10">document</span><a
- id="dx1-38008"></a><a
- id="dx1-38009"></a> environment where it would normally be
+ id="dx1-39008"></a><a
+ id="dx1-39009"></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-38010"></a> file if <span
+ id="dx1-39010"></a> file if <span
class="cmtt-10">\newglossaryentry</span>
is found in the <span
class="cmss-10">document</span><a
- id="dx1-38011"></a><a
- id="dx1-38012"></a> environment.</p></dd></dl>
+ id="dx1-39011"></a><a
+ id="dx1-39012"></a> environment.</p></dd></dl>
-<!--l. 3956--><p class="noindent" >
+<!--l. 3979--><p class="noindent" >
</p>
-<!--l. 3956--><p class="noindent" ><a
+<!--l. 3979--><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. 3959--><p class="noindent" >
+<!--l. 3982--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-400002.2"></a><a
+ id="x1-410002.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. 3959--><p class="noindent" >Add the glossaries to the table of contents. Note that an extra LaTeX run is required with this option.
+<!--l. 3982--><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. 3962--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-40001"></a> <span
+</p><!--l. 3985--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-41001"></a> <span
class="cmtt-10">\glstoctrue </span></div><hr>
-</p><!--l. 3964--><p class="noindent" >
+</p><!--l. 3987--><p class="noindent" >
and
-</p><!--l. 3966--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-40002"></a> <span
+</p><!--l. 3989--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-41002"></a> <span
class="cmtt-10">\glstocfalse </span></div><hr>
-</p><!--l. 3968--><p class="noindent" >
+</p><!--l. 3991--><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-40003"></a> for the base <span
+ id="dx1-41003"></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-40004"></a> for <a
+ id="dx1-41004"></a> for <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.
-</p><!--l. 3973--><p class="noindent" >
+</p><!--l. 3996--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-410002.2"></a><a
+ id="x1-420002.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. 3973--><p class="noindent" >When used with the above <span
+<!--l. 3996--><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-41001"></a> option, this will add <span
+ id="dx1-42001"></a> option, this will add <span
class="cmtt-10">\numberline</span><a
- id="dx1-41002"></a><span class="obeylines-h"><span class="verb"><span
+ id="dx1-42002"></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-41003"></a>. This will align the table of contents entry with the numbered section titles. Note that this
+ id="dx1-42003"></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-41004"></a> option is omitted. If <span
+ id="dx1-42004"></a> option is omitted. If <span
class="cmss-10">toc</span><a
- id="dx1-41005"></a> is used without <span
+ id="dx1-42005"></a> is used without <span
class="cmss-10">numberline</span><a
- id="dx1-41006"></a>, the title will be aligned with
+ id="dx1-42006"></a>, the title will be aligned with
the section numbers rather than the section titles.
-</p><!--l. 3982--><p class="noindent" >
+</p><!--l. 4005--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-420002.2"></a><a
+ id="x1-430002.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. 3984--><p class="noindent" >This option indicates the sectional unit to use for the glossary. The value should be the control
+<!--l. 4007--><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
@@ -9100,130 +9139,130 @@
class="cmtt-10">\chapter </span>or
<span
class="cmtt-10">chapter*</span>).
-</p><!--l. 3989--><p class="indent" > The default behaviour is for the glossary heading to use <span
+</p><!--l. 4012--><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-42001"></a> option.
-</p><!--l. 3993--><p class="indent" > Example:
+ id="dx1-43001"></a> option.
+</p><!--l. 4016--><p class="indent" > Example:
</p>
- <pre class="verbatim" id="verbatim-72">
+ <pre class="verbatim" id="verbatim-74">
\usepackage[section=subsection]{glossaries}
</pre>
-<!--l. 3996--><p class="nopar" > You can omit the value if you want to use <span
+<!--l. 4019--><p class="nopar" > You can omit the value if you want to use <span
class="cmtt-10">\section</span>, i.e. 
</p>
- <pre class="verbatim" id="verbatim-73">
+ <pre class="verbatim" id="verbatim-75">
\usepackage[section]{glossaries}
</pre>
-<!--l. 4000--><p class="nopar" > is equivalent to
+<!--l. 4023--><p class="nopar" > is equivalent to
</p>
- <pre class="verbatim" id="verbatim-74">
+ <pre class="verbatim" id="verbatim-76">
\usepackage[section=section]{glossaries}
</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
+<!--l. 4027--><p class="nopar" > You can change this value later in the document using
+</p><!--l. 4029--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-43002"></a> <span
class="cmtt-10">\setglossarysection{</span>⟨<span
class="cmitt-10">name</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 4008--><p class="noindent" >
+</p><!--l. 4031--><p class="noindent" >
where ⟨<span
class="cmti-10">name</span>⟩ is the sectional unit.
-</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
+</p><!--l. 4034--><p class="indent" > The start of each glossary adds information to the page header via
+</p><!--l. 4035--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-43003"></a> <span
class="cmtt-10">\glsglossarymark{</span>⟨<span
class="cmitt-10">glossary title</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 4014--><p class="noindent" >
+</p><!--l. 4037--><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-42004f2"></a>
+ id="x1-43004f2"></a>
but you may need to redefine it. For example, to only change the right header:
</p>
- <pre class="verbatim" id="verbatim-75">
+ <pre class="verbatim" id="verbatim-77">
\renewcommand{\glsglossarymark}[1]{\markright{#1}}
</pre>
-<!--l. 4021--><p class="nopar" > or to prevent it from changing the headers:
+<!--l. 4044--><p class="nopar" > or to prevent it from changing the headers:
</p>
- <pre class="verbatim" id="verbatim-76">
+ <pre class="verbatim" id="verbatim-78">
\renewcommand{\glsglossarymark}[1]{}
</pre>
-<!--l. 4025--><p class="nopar" > If you want <span
+<!--l. 4048--><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-42007"></a> option described
+ id="dx1-43007"></a> option described
below.
-</p><!--l. 4029--><p class="indent" > Occasionally you may find that another package defines <span
+</p><!--l. 4052--><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-42008"></a><span
+ id="dx1-43008"></a><span
class="cmtt-10">\glsclearpage</span>:
</p>
- <pre class="verbatim" id="verbatim-77">
+ <pre class="verbatim" id="verbatim-79">
\renewcommand*{\glsclearpage}{\clearpage}
</pre>
-<!--l. 4035--><p class="nopar" >
-</p><!--l. 4037--><p class="noindent" >
+<!--l. 4058--><p class="nopar" >
+</p><!--l. 4060--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-430002.2"></a><a
+ id="x1-440002.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. 4037--><p class="noindent" >This is a boolean option. The default is <span
+<!--l. 4060--><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-43001"></a>, unless <span
+ id="dx1-44001"></a>, unless <span
class="cmss-10">memoir</span><a
- id="dx1-43002"></a> has been loaded, in which case the default
+ id="dx1-44002"></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-43003"></a>.
-</p><!--l. 4041--><p class="indent" > If set, <span
+ id="dx1-44003"></a>.
+</p><!--l. 4064--><p class="indent" > If set, <span
class="cmtt-10">\glsglossarymark</span><a
- id="dx1-43004"></a> uses
+ id="dx1-44004"></a> uses
<span
class="cmtt-10">\MakeTextUppercase</span><a
- id="dx1-43005"></a><span class="footnote-mark"><a
+ id="dx1-44005"></a><span class="footnote-mark"><a
href="#fn3x2" id="fn3x2-bk"><sup class="textsuperscript">2.3</sup></a></span><a
- id="x1-43006f3"></a>.
+ id="x1-44006f3"></a>.
You can test whether this option has been set or not using
-</p><!--l. 4050--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 4073--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\ifglsucmark</span><a
- id="dx1-43011"></a> ⟨<span
+ id="dx1-44011"></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. 4051--><p class="noindent" >
+</p><!--l. 4074--><p class="noindent" >
For example:
</p>
- <pre class="verbatim" id="verbatim-78">
+ <pre class="verbatim" id="verbatim-80">
\renewcommand{\glsglossarymark}[1]{%
  \ifglsucmark
    \markright{\MakeTextUppercase{#1}}%
@@ -9231,59 +9270,59 @@
    \markright{#1}%
  \fi}
</pre>
-<!--l. 4060--><p class="nopar" > If <span
+<!--l. 4083--><p class="nopar" > If <span
class="cmss-10">memoir</span><a
- id="dx1-43012"></a> has been loaded and <span
+ id="dx1-44012"></a> has been loaded and <span
class="cmss-10">ucmark</span><a
- id="dx1-43013"></a> is set, then <span
+ id="dx1-44013"></a> is set, then <span
class="cmss-10">memoir</span><a
- id="dx1-43014"></a>’s <span
+ id="dx1-44014"></a>’s <span
class="cmtt-10">\memUChead</span><a
- id="dx1-43015"></a> is used.
-</p><!--l. 4064--><p class="noindent" >
+ id="dx1-44015"></a> is used.
+</p><!--l. 4087--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-440002.2"></a><a
+ id="x1-450002.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. 4065--><p class="noindent" >The glossaries are placed in unnumbered sectional units by default, but this can be changed using
+<!--l. 4088--><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-44001"></a>. This option can take one of the following values: </p>
+ id="dx1-45001"></a>. This option can take one of the following values: </p>
<ul class="itemize1">
<li class="itemize">
- <!--l. 4069--><p class="noindent" ><span
+ <!--l. 4092--><p class="noindent" ><span
class="cmss-10">false</span><a
- id="dx1-44002"></a>: no number, i.e. use starred form of sectioning command (e.g. <span
+ id="dx1-45002"></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>);
</p></li>
<li class="itemize">
- <!--l. 4072--><p class="noindent" ><span
+ <!--l. 4095--><p class="noindent" ><span
class="cmss-10">nolabel</span><a
- id="dx1-44003"></a>: use a numbered section, i.e. the unstarred form of sectioning command (e.g. <span
+ id="dx1-45003"></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;
</p></li>
<li class="itemize">
- <!--l. 4077--><p class="noindent" ><span
+ <!--l. 4100--><p class="noindent" ><span
class="cmss-10">autolabel</span><a
- id="dx1-44004"></a>: numbered with automatic labelling. Each glossary uses the unstarred form of a sectioning
+ id="dx1-45004"></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-44005"></a>). The label is formed
+ id="dx1-45005"></a>). The label is formed
from
- </p><!--l. 4081--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-44006"></a> <span
+ </p><!--l. 4104--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-45006"></a> <span
class="cmtt-10">\glsautoprefix </span>⟨<span
class="cmitt-10">type</span>⟩ </div><hr>
- </p><!--l. 4083--><p class="noindent" >
+ </p><!--l. 4106--><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
@@ -9292,170 +9331,170 @@
</p>
- <pre class="verbatim" id="verbatim-79">
+ <pre class="verbatim" id="verbatim-81">
\usepackage[section,numberedsection=autolabel]
  {glossaries}
</pre>
- <!--l. 4091--><p class="nopar" > then each glossary will appear in a numbered section, and can be referenced using something
+ <!--l. 4114--><p class="nopar" > then each glossary will appear in a numbered section, and can be referenced using something
like:
</p>
- <pre class="verbatim" id="verbatim-80">
+ <pre class="verbatim" id="verbatim-82">
The main glossary is in section~\ref{main} and
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
+ <!--l. 4120--><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-44007"></a> which is set to <span
+ id="dx1-45007"></a> which is set to <span
class="cmtt-10">main </span>if the <span
class="cmss-10">acronym</span><a
- id="dx1-44008"></a> option is not used and is set to <span
+ id="dx1-45008"></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-44009"></a> option is used. For example:
+ id="dx1-45009"></a> option is used. For example:
</p>
- <pre class="verbatim" id="verbatim-81">
+ <pre class="verbatim" id="verbatim-83">
The list of acronyms is in section~\ref{\acronymtype}.
</pre>
- <!--l. 4105--><p class="nopar" > You can redefine the prefix if the default label clashes with another label in your document. For
+ <!--l. 4128--><p class="nopar" > You can redefine the prefix if the default label clashes with another label in your document. For
example:
</p>
- <pre class="verbatim" id="verbatim-82">
+ <pre class="verbatim" id="verbatim-84">
\renewcommand*{\glsautoprefix}{glo:}
</pre>
- <!--l. 4111--><p class="nopar" > will add <span
+ <!--l. 4134--><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>
- <pre class="verbatim" id="verbatim-83">
+ <pre class="verbatim" id="verbatim-85">
The list of acronyms is in
section~\ref{glo:\acronymtype}.
</pre>
- <!--l. 4117--><p class="nopar" > Or, if you are undecided on a prefix:
+ <!--l. 4140--><p class="nopar" > Or, if you are undecided on a prefix:
</p>
- <pre class="verbatim" id="verbatim-84">
+ <pre class="verbatim" id="verbatim-86">
The list of acronyms is in
section~\ref{\glsautoprefix\acronymtype}.
</pre>
- <!--l. 4122--><p class="nopar" >
+ <!--l. 4145--><p class="nopar" >
</p></li>
<li class="itemize">
- <!--l. 4124--><p class="noindent" ><span
+ <!--l. 4147--><p class="noindent" ><span
class="cmss-10">nameref</span><a
- id="dx1-44010"></a>: this is like <span
+ id="dx1-45010"></a>: this is like <span
class="cmss-10">autolabel</span><a
- id="dx1-44011"></a> but uses an unnumbered sectioning command (e.g. <span
+ id="dx1-45011"></a> but uses an unnumbered sectioning command (e.g. <span
class="cmtt-10">\chapter*</span><a
- id="dx1-44012"></a> or
+ id="dx1-45012"></a> or
<span
class="cmtt-10">\section*</span><a
- id="dx1-44013"></a>). It’s designed for use with the <span
+ id="dx1-45013"></a>). It’s designed for use with the <span
class="cmss-10">nameref</span><a
- id="dx1-44014"></a> package. For example:
+ id="dx1-45014"></a> package. For example:
</p>
- <pre class="verbatim" id="verbatim-85">
+ <pre class="verbatim" id="verbatim-87">
\usepackage{nameref}
\usepackage[numberedsection=nameref]{glossaries}
</pre>
- <!--l. 4131--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span
+ <!--l. 4154--><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. 4137--><p class="noindent" >
+<!--l. 4160--><p class="noindent" >
</p>
-<!--l. 4137--><p class="noindent" ><a
+<!--l. 4160--><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. 4140--><p class="noindent" >
+<!--l. 4163--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-460002.3"></a><a
+ id="x1-470002.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. 4140--><p class="noindent" >This is a boolean option that specifies whether or not to gather and store the <a
+<!--l. 4163--><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-46001"></a></a> for each entry. The
+ id="dx1-47001"></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-46002"></a>. (See <span
+ id="dx1-47002"></a>. (See <span
class="cmtt-10">\glsentrynumberlist</span><a
- id="dx1-46003"></a> and <span
+ id="dx1-47003"></a> and <span
class="cmtt-10">\glsdisplaynumberlist</span><a
- id="dx1-46004"></a> in <a
+ id="dx1-47004"></a> in <a
href="#sec:glsnolink">§<span
-class="cmbx-10">??</span>sec:glsnolink
+class="cmbx-10">5.2</span>
</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. 4147--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you use the <span id="textcolor207"><span
+</p><!--l. 4170--><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-46005"></a> option (with either no value or <span id="textcolor208"><span
+ id="dx1-47005"></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-46006"></a> or <span id="textcolor209"><span
+ id="dx1-47006"></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-46007"></a>) then this package option
+ id="dx1-47007"></a>) then this package option
has no effect. With <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-46008"></a></a>, the <a
+ id="dx1-47008"></a></a>, the <a
href="#glo:numberlist">number list<a
- id="dx1-46009"></a>s</a> are automatically saved with the default <span id="textcolor210"><span
+ id="dx1-47009"></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-46010"></a>
+ id="dx1-47010"></a>
and <span id="textcolor211"><span
class="cmtt-10">save-loclist</span></span><span
class="cmtt-10">=true</span><a
- id="dx1-46011"></a> resource settings. </div>
-</p><!--l. 4154--><p class="noindent" >
-</p><!--l. 4156--><p class="noindent" >
+ id="dx1-47011"></a> resource settings. </div>
+</p><!--l. 4177--><p class="noindent" >
+</p><!--l. 4179--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-470002.3"></a><a
+ id="x1-480002.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. 4156--><p class="noindent" >This is a boolean option. (Default is <span
+<!--l. 4179--><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-47001"></a>.) If set, each main (level 0) glossary entry will be
+ id="dx1-48001"></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-47002"></a><a
- id="dx1-47003"></a><span
+ id="dx1-48002"></a><a
+ id="dx1-48003"></a><span
class="cmss-10">glossaryentry</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
+</p><!--l. 4185--><p class="indent" > If you use this option, you can reference the entry number within the document using
+</p><!--l. 4187--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-48004"></a> <span
class="cmtt-10">\glsrefentry{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 4166--><p class="noindent" >
+</p><!--l. 4189--><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
@@ -9463,37 +9502,37 @@
class="cmti-10">label</span>⟩ is
the entry’s label and ⟨<span
class="cmti-10">prefix</span>⟩ is given by
-</p><!--l. 4170--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-47005"></a> <span
+</p><!--l. 4193--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-48005"></a> <span
class="cmtt-10">\GlsEntryCounterLabelPrefix </span></div><hr>
-</p><!--l. 4172--><p class="noindent" >
+</p><!--l. 4195--><p class="noindent" >
(which defaults to <span
class="cmtt-10">glsentry-</span>).
-</p><!--l. 4175--><p class="indent" > <div class="important" title="Important Note"> If you use <span
+</p><!--l. 4198--><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-47006"></a></a>, <a
+ id="dx1-48006"></a></a>, <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-47007"></a></a> or <a
+ id="dx1-48007"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- 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" >
+ id="dx1-48008"></a></a> to ensure the cross-references are up-to-date. </div>
+</p><!--l. 4203--><p class="noindent" >
+</p><!--l. 4205--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-480002.3"></a><a
+ id="x1-490002.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. 4182--><p class="noindent" >This is a ⟨<span
+<!--l. 4205--><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
@@ -9501,45 +9540,45 @@
class="cmss-10">entrycounter</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-48001"></a> and the <span
+ id="dx1-49001"></a> and the <span
class="cmss-10">glossaryentry</span><a
- id="dx1-48002"></a> counter will be reset every time ⟨<span
+ id="dx1-49002"></a> counter will be reset every time ⟨<span
class="cmti-10">value</span>⟩ is incremented.
-</p><!--l. 4189--><p class="indent" > <div class="important" title="Important Note"> The <span
+</p><!--l. 4212--><p class="indent" > <div class="important" title="Important Note"> The <span
class="cmss-10">glossaryentry</span><a
- id="dx1-48003"></a> counter isn’t automatically reset at the start of each glossary, except when glossary section
+ id="dx1-49003"></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-48004"></a> is the same as the counter used in the glossary’s
+ id="dx1-49004"></a> is the same as the counter used in the glossary’s
sectioning command. </div>
-</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
+</p><!--l. 4217--><p class="noindent" >
+</p><!--l. 4219--><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-48005"></a>) to use
-</p><!--l. 4198--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-48006"></a> <span
+ id="dx1-49005"></a>) to use
+</p><!--l. 4221--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-49006"></a> <span
class="cmtt-10">\glsresetentrycounter </span></div><hr>
-</p><!--l. 4200--><p class="noindent" >
+</p><!--l. 4223--><p class="noindent" >
which sets <span
class="cmss-10">glossaryentry</span><a
- id="dx1-48007"></a> to zero:
+ id="dx1-49007"></a> to zero:
</p>
- <pre class="verbatim" id="verbatim-86">
+ <pre class="verbatim" id="verbatim-88">
\renewcommand{\glossarypreamble}{%
  \glsresetentrycounter
}
</pre>
-<!--l. 4206--><p class="nopar" > or if you are using <span
+<!--l. 4229--><p class="nopar" > or if you are using <span
class="cmtt-10">\setglossarypreamble</span><a
- id="dx1-48008"></a>, add it to each glossary preamble, as required. For
+ id="dx1-49008"></a>, add it to each glossary preamble, as required. For
example:
</p>
- <pre class="verbatim" id="verbatim-87">
+ <pre class="verbatim" id="verbatim-89">
\setglossarypreamble[acronym]{%
  \glsresetentrycounter
  The preamble text here for the list of acronyms.
@@ -9549,204 +9588,204 @@
  The preamble text here for the main glossary.
}
</pre>
-<!--l. 4218--><p class="nopar" >
-</p><!--l. 4220--><p class="noindent" >
+<!--l. 4241--><p class="nopar" >
+</p><!--l. 4243--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-490002.3"></a><a
+ id="x1-500002.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. 4220--><p class="noindent" >This is a boolean option. (Default is <span
+<!--l. 4243--><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-49001"></a>.) If set, each level 1 glossary entry will be numbered
+ id="dx1-50001"></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-49002"></a><a
- id="dx1-49003"></a><span
+ id="dx1-50002"></a><a
+ id="dx1-50003"></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-49004"></a>. You can reference
+ id="dx1-50004"></a>. You can reference
the number within the document using <span
class="cmtt-10">\glsrefentry</span><a
- id="dx1-49005"></a><span
+ id="dx1-50005"></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. 4231--><p class="noindent" >
+</p><!--l. 4254--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-500002.3"></a><a
+ id="x1-510002.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. 4231--><p class="noindent" >This is a ⟨<span
+<!--l. 4254--><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-50001"></a>, unless <span
+ id="dx1-51001"></a>, unless <span
class="cmss-10">classicthesis</span><a
- id="dx1-50002"></a> has been loaded, in which case the default is
+ id="dx1-51002"></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-50003"></a>.) Its value should be the name of the glossary style to use. This key may only be used for styles
+ id="dx1-51003"></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-50004"></a>, <span
+ id="dx1-51004"></a>, <span
class="cmss-10">glossary-long</span><a
- id="dx1-50005"></a>, <span
+ id="dx1-51005"></a>, <span
class="cmss-10">glossary-super</span><a
- id="dx1-50006"></a> or <span
+ id="dx1-51006"></a> or <span
class="cmss-10">glossary-tree</span><a
- id="dx1-50007"></a>. Alternatively, you can set the style
+ id="dx1-51007"></a>. Alternatively, you can set the style
using
-</p><!--l. 4239--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 4262--><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. 4240--><p class="noindent" >
+</p><!--l. 4263--><p class="noindent" >
(See <a
href="#sec:styles">§<span
-class="cmbx-10">??</span>sec:styles </a><a
+class="cmbx-10">13</span> </a><a
href="#sec:styles">Glossary Styles<!--tex4ht:ref: sec:styles --></a> for further details.)
-</p><!--l. 4243--><p class="noindent" >
+</p><!--l. 4266--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-510002.3"></a><a
+ id="x1-520002.3"></a><a
id="pkgopt:nolong"></a><span
class="cmss-10">nolong</span></h4>
-<!--l. 4243--><p class="noindent" >This prevents the <span
+<!--l. 4266--><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-51001"></a> (which means that the <span
+ id="dx1-52001"></a> (which means that the <span
class="cmss-10">longtable</span><a
- id="dx1-51002"></a>
+ 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-long </span>package
(unless you explicitly load <span
class="cmss-10">glossary-long</span><a
- id="dx1-51003"></a>).
+ id="dx1-52003"></a>).
-</p><!--l. 4251--><p class="noindent" >
+</p><!--l. 4274--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-520002.3"></a><a
+ id="x1-530002.3"></a><a
id="pkgopt:nosuper"></a><span
class="cmss-10">nosuper</span></h4>
-<!--l. 4251--><p class="noindent" >This prevents the <span
+<!--l. 4274--><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-52001"></a> (which means that the
+ id="dx1-53001"></a> (which means that the
<span
class="cmss-10">supertabular</span><a
- id="dx1-52002"></a> package also won’t be loaded). This reduces overhead by not defining unwanted styles and
+ id="dx1-53002"></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-52003"></a>).
-</p><!--l. 4259--><p class="noindent" >
+ id="dx1-53003"></a>).
+</p><!--l. 4282--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-530002.3"></a><a
+ id="x1-540002.3"></a><a
id="pkgopt:nolist"></a><span
class="cmss-10">nolist</span></h4>
-<!--l. 4259--><p class="noindent" >This prevents the <span
+<!--l. 4282--><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-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-list </span>package (unless you explicitly load <span
class="cmss-10">glossary-list</span><a
- id="dx1-53002"></a>). Note that since the default style is <span
+ id="dx1-54002"></a>). Note that since the default style is <span
class="cmss-10">list</span><a
- id="dx1-53003"></a>
+ id="dx1-54003"></a>
(unless <span
class="cmss-10">classicthesis</span><a
- id="dx1-53004"></a> has been loaded), you will also need to use the <span
+ id="dx1-54004"></a> has been loaded), you will also need to use the <span
class="cmss-10">style</span><a
- id="dx1-53005"></a> option to set the style to something
+ id="dx1-54005"></a> option to set the style to something
else.
-</p><!--l. 4270--><p class="noindent" >
+</p><!--l. 4293--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-540002.3"></a><a
+ id="x1-550002.3"></a><a
id="pkgopt:notree"></a><span
class="cmss-10">notree</span></h4>
-<!--l. 4270--><p class="noindent" >This prevents the <span
+<!--l. 4293--><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-54001"></a>. This reduces overhead by not
+ id="dx1-55001"></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-54002"></a>). Note that if <span
+ id="dx1-55002"></a>). Note that if <span
class="cmss-10">classicthesis</span><a
- id="dx1-54003"></a> has been
+ id="dx1-55003"></a> has been
loaded, the default style is <span
class="cmss-10">index</span><a
- id="dx1-54004"></a>, which is provided by <span
+ id="dx1-55004"></a>, which is provided by <span
class="cmss-10">glossary-tree</span><a
- id="dx1-54005"></a>.
-</p><!--l. 4279--><p class="noindent" >
+ id="dx1-55005"></a>.
+</p><!--l. 4302--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-550002.3"></a><a
+ id="x1-560002.3"></a><a
id="pkgopt:nostyles"></a><span
class="cmss-10">nostyles</span></h4>
-<!--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
+<!--l. 4302--><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-55001"></a>). Also if you use this option, you can’t use the <span
+ id="dx1-56001"></a>). Also if you use this option, you can’t use the <span
class="cmss-10">style</span><a
- id="dx1-55002"></a> package option. Instead
+ id="dx1-56002"></a> package option. Instead
you must either use <span
class="cmtt-10">\setglossarystyle</span><a
- id="dx1-55003"></a><span
+ id="dx1-56003"></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-55004"></a> key in the optional argument to <span
+ id="dx1-56004"></a> key in the optional argument to <span
class="cmtt-10">\printglossary</span><a
- id="dx1-55005"></a>.
+ id="dx1-56005"></a>.
Example:
</p>
- <pre class="verbatim" id="verbatim-88">
+ <pre class="verbatim" id="verbatim-90">
\usepackage[nostyles]{glossaries}
\usepackage{glossary-mcols}
\setglossarystyle{mcoltree}
</pre>
-<!--l. 4290--><p class="nopar" >
-</p><!--l. 4292--><p class="noindent" >
+<!--l. 4313--><p class="nopar" >
+</p><!--l. 4315--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-560002.3"></a><a
+ id="x1-570002.3"></a><a
id="pkgopt:nonumberlist"></a><span
class="cmss-10">nonumberlist</span></h4>
-<!--l. 4292--><p class="noindent" >This option will suppress the associated <a
+<!--l. 4315--><p class="noindent" >This option will suppress the associated <a
href="#glo:numberlist">number list<a
- id="dx1-56001"></a>s</a> in the glossaries (see also <a
+ id="dx1-57001"></a>s</a> in the glossaries (see also <a
href="#sec:numberlists">§<span
-class="cmbx-10">??</span>sec:numberlists </a><a
+class="cmbx-10">12</span> </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
@@ -9753,132 +9792,132 @@
href="#option3">3</a> (<a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-56002"></a></a> or <a
+ id="dx1-57002"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-56003"></a></a>) then the locations must still be valid. This
+ id="dx1-57003"></a></a>) then the locations must still be valid. This
package option merely prevents the <a
href="#glo:numberlist">number list<a
- id="dx1-56004"></a></a> from being displayed, but both <a
+ id="dx1-57004"></a></a> from being displayed, but both <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-56005"></a></a> and <a
+ id="dx1-57005"></a></a> and <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-56006"></a></a>
+ id="dx1-57006"></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-56007"></a></a>
+ id="dx1-57007"></a></a>
includes any cross-references, so suppressing the <a
href="#glo:numberlist">number list<a
- id="dx1-56008"></a></a> will also hide the cross-references (see
+ id="dx1-57008"></a></a> will also hide the cross-references (see
below).
-</p><!--l. 4303--><p class="noindent" >
+</p><!--l. 4326--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-570002.3"></a><a
+ id="x1-580002.3"></a><a
id="pkgopt:seeautonumberlist"></a><span
class="cmss-10">seeautonumberlist</span></h4>
-<!--l. 4303--><p class="noindent" >If you suppress the <a
+<!--l. 4326--><p class="noindent" >If you suppress the <a
href="#glo:numberlist">number list<a
- id="dx1-57001"></a>s</a> with <span
+ id="dx1-58001"></a>s</a> with <span
class="cmss-10">nonumberlist</span><a
- id="dx1-57002"></a>, described above, this will also suppress any
+ id="dx1-58002"></a>, described above, this will also suppress any
cross-referencing information supplied by the <span
class="cmtt-10">see</span><a
- id="dx1-57003"></a> key in <span
+ id="dx1-58003"></a> key in <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-57004"></a> or <span
+ id="dx1-58004"></a> or <span
class="cmtt-10">\glssee</span><a
- id="dx1-57005"></a>. If you
+ id="dx1-58005"></a>. If you
use <span
class="cmss-10">seeautonumberlist</span><a
- id="dx1-57006"></a>, the <span
+ id="dx1-58006"></a>, the <span
class="cmtt-10">see</span><a
- id="dx1-57007"></a> key will automatically implement <span
+ id="dx1-58007"></a> key will automatically implement <span
class="cmtt-10">nonumberlist=false</span><a
- id="dx1-57008"></a> for that
+ id="dx1-58008"></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
+class="cmbx-10">11</span> </a><a
href="#sec:crossref">Cross-Referencing
Entries<!--tex4ht:ref: sec:crossref --></a>.
-</p><!--l. 4312--><p class="noindent" >
+</p><!--l. 4335--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-580002.3"></a><a
+ id="x1-590002.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. 4312--><p class="noindent" >This is a ⟨<span
+<!--l. 4335--><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-58001"></a>.) The value should be the name of the default counter to
+ id="dx1-59001"></a>.) The value should be the name of the default counter to
use in the <a
href="#glo:numberlist">number list<a
- id="dx1-58002"></a>s</a> (see <a
+ id="dx1-59002"></a>s</a> (see <a
href="#sec:numberlists">§<span
-class="cmbx-10">??</span>sec:numberlists </a><a
+class="cmbx-10">12</span> </a><a
href="#sec:numberlists">Number Lists<!--tex4ht:ref: sec:numberlists --></a>).
-</p><!--l. 4317--><p class="noindent" >
+</p><!--l. 4340--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-590002.3"></a><a
+ id="x1-600002.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. 4317--><p class="noindent" >This is a boolean option. If no value is specified, <span
+<!--l. 4340--><p class="noindent" >This is a boolean option. If no value is specified, <span
class="cmss-10">true</span><a
- id="dx1-59001"></a> is assumed. When set to <span
+ id="dx1-60001"></a> is assumed. When set to <span
class="cmss-10">true</span><a
- id="dx1-59002"></a>, this option suppresses the
+ id="dx1-60002"></a>, this option suppresses the
default post description dot used by some of the predefined styles.
-</p><!--l. 4322--><p class="indent" > The default setting is <span
+</p><!--l. 4345--><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-59003"></a> for the base <span
+ id="dx1-60003"></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-59004"></a> for
+ id="dx1-60004"></a> for
<a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.
-</p><!--l. 4326--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 4349--><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="textcolor212"><span
class="cmss-10">postdot</span></span><a
- id="dx1-59005"></a>, which is equivalent to <span
+ id="dx1-60005"></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-59006"></a>, and also <span id="textcolor213"><span
+ id="dx1-60006"></a>, and also <span id="textcolor213"><span
class="cmss-10">postpunc</span></span><a
- id="dx1-59007"></a>,
+ id="dx1-60007"></a>,
which allows you to choose a different punctuation character. </div>
-</p><!--l. 4331--><p class="noindent" >
-</p><!--l. 4333--><p class="noindent" >
+</p><!--l. 4354--><p class="noindent" >
+</p><!--l. 4356--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-600002.3"></a><a
+ id="x1-610002.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. 4333--><p class="noindent" >This is a boolean option. If no value is specified, <span
+<!--l. 4356--><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
@@ -9886,11 +9925,11 @@
class="cmss-10">nogroupskip</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-60001"></a>.
-</p><!--l. 4339--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you are using <a
+ id="dx1-61001"></a>.
+</p><!--l. 4362--><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-60002"></a></a> without the <span
+ id="dx1-61002"></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
@@ -9897,11 +9936,11 @@
class="cmtt-10">=</span><span
class="cmss-10">true </span>as
there won’t be any letter groups. </div>
-</p><!--l. 4344--><p class="noindent" >
-</p><!--l. 4346--><p class="noindent" >
+</p><!--l. 4367--><p class="noindent" >
+</p><!--l. 4369--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-610002.3"></a><span id="textcolor214"><a
+ id="x1-620002.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
@@ -9908,9 +9947,9 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">list</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 4348--><p class="noindent" >Load the <span
+<!--l. 4371--><p class="noindent" >Load the <span
class="cmss-10">glossaries-extra-stylemods</span><a
- id="dx1-61001"></a> package, which patches the predefined styles. The ⟨<span
+ id="dx1-62001"></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
@@ -9919,158 +9958,158 @@
class="cmti-10">element</span>⟩ in the comma-separated
⟨<span
class="cmti-10">list</span>⟩.
-</p><!--l. 4353--><p class="noindent" >
+</p><!--l. 4376--><p class="noindent" >
</p>
-<!--l. 4353--><p class="noindent" ><a
+<!--l. 4376--><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. 4356--><p class="noindent" >
+<!--l. 4379--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-630002.4"></a><a
+ id="x1-640002.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. 4356--><p class="noindent" >Introduced in version 4.24, this option may take one of three values: <span
+<!--l. 4379--><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-63001"></a> key
+ id="dx1-64001"></a> key
automatically indexes the cross-referenced entry using <span
class="cmtt-10">\glssee</span><a
- id="dx1-63002"></a>. This means that if this key is
+ id="dx1-64002"></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-63003"></a> key is used before <span
+ id="dx1-64003"></a> key is used before <span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-63004"></a>. This option allows you to change the error into just a
+ id="dx1-64004"></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-63005"></a>) or ignore it (<span
+ id="dx1-64005"></a>) or ignore it (<span
class="cmss-10">seenoindex</span><span
class="cmtt-10">=</span><span
class="cmss-10">ignore</span><a
- id="dx1-63006"></a>) if, for example, you want to temporarily
+ id="dx1-64006"></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. 4370--><p class="noindent" >
+</p><!--l. 4393--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-640002.4"></a><a
+ id="x1-650002.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. 4370--><p class="noindent" >This is a boolean option. The default is <span
+<!--l. 4393--><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-64001"></a>, which is needed for Options <a
+ id="dx1-65001"></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-64002"></a> changes it to <span
+ id="dx1-65002"></a> changes it to <span
class="cmss-10">esclocations</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-64003"></a>. With <a
+ id="dx1-65003"></a>. With <a
href="#option4">Option 4</a> (<a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-64004"></a></a>), this setting is
+ id="dx1-65004"></a></a>), this setting is
ignored.
-</p><!--l. 4376--><p class="indent" > Both <a
+</p><!--l. 4399--><p class="indent" > Both <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-64005"></a></a> and <a
+ id="dx1-65005"></a></a> and <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-64006"></a></a> are fussy about the location formats (<a
+ id="dx1-65006"></a></a> are fussy about the location formats (<a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-64007"></a></a> more so than <a
+ id="dx1-65007"></a></a> more so than <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-64008"></a></a>) so the
+ id="dx1-65008"></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. 4385--><p class="indent" > If you’re sure that your locations will always expand to an acceptable format (or you’re prepared to
+</p><!--l. 4408--><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-64009"></a> to
+ id="dx1-65009"></a> to
avoid the complex escaping of location values. (See “Writing information to associated files” in the documented
code for further details.)
-</p><!--l. 4393--><p class="indent" > This isn’t an issue for Options <a
+</p><!--l. 4416--><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-64010"></a> file so no syntax conversion is
+ id="dx1-65010"></a> file so no syntax conversion is
required.
-</p><!--l. 4396--><p class="noindent" >
+</p><!--l. 4419--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-650002.4"></a><a
+ id="x1-660002.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. 4396--><p class="noindent" >This is a boolean option that specifies whether to only add information to the external glossary file on <a
+<!--l. 4419--><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-65001"></a>, which will add a line to the file every time one of the <a
-href="#sec:gls-like"><span
+ id="dx1-66001"></a>, which will add a line to the file every time one of the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> or
<a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands are used. Note that <span
class="cmtt-10">\glsadd</span><a
- id="dx1-65002"></a> will always add information to the external glossary
+ id="dx1-66002"></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-65003f4"></a> (since
+ id="x1-66003f4"></a> (since
that’s the purpose of that command).
-</p><!--l. 4405--><p class="indent" > <div class="important" title="Important Note"> Resetting the <a
+</p><!--l. 4428--><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-65004"></a> after an entry has been indexed will cause that
+ id="dx1-66004"></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. 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
+</p><!--l. 4435--><p class="noindent" >
+</p><!--l. 4437--><p class="indent" > You can customise this by redefining
+</p><!--l. 4438--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-66005"></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. 4417--><p class="noindent" >
+</p><!--l. 4440--><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.
@@ -10079,7 +10118,7 @@
</p>
- <pre class="verbatim" id="verbatim-89">
+ <pre class="verbatim" id="verbatim-91">
\newcommand*{\glswriteentry}[2]{%
  \ifglsindexonlyfirst
    \ifglsused{#1}{}{#2}%
@@ -10088,15 +10127,15 @@
  \fi
}
</pre>
-<!--l. 4429--><p class="nopar" > This checks the <span
+<!--l. 4452--><p class="nopar" > This checks the <span
class="cmss-10">indexonlyfirst</span><a
- id="dx1-65006"></a> package option (using <span
+ id="dx1-66006"></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. 4435--><p class="indent" > For example, suppose you only want to index the first use for entries in the <span
+</p><!--l. 4458--><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:
@@ -10103,7 +10142,7 @@
</p>
- <pre class="verbatim" id="verbatim-90">
+ <pre class="verbatim" id="verbatim-92">
\renewcommand*{\glswriteentry}[2]{%
 \ifthenelse{\equal{\glsentrytype{#1}}{acronym}}
 {\ifglsused{#1}{}{#2}}%
@@ -10110,29 +10149,29 @@
 {#2}%
}
</pre>
-<!--l. 4444--><p class="nopar" > Here I’ve used <span
+<!--l. 4467--><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. 4448--><p class="indent" > With the <a
+</p><!--l. 4471--><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="textcolor216"><span
class="cmss-10">indexonlyfirst</span></span><a
- id="dx1-65007"></a> attribute for the
+ id="dx1-66007"></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-65008"></a> package option.) See the
+ id="dx1-66008"></a> package option.) See the
<a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> manual for further details.
-</p><!--l. 4456--><p class="noindent" >
+</p><!--l. 4479--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-660002.4"></a><span id="textcolor217"><a
+ id="x1-670002.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
@@ -10139,28 +10178,28 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">boolean</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 4458--><p class="noindent" >If <span
+<!--l. 4481--><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
+ id="dx1-67001"></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. 4463--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> Note that <a
+</p><!--l. 4486--><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
+ id="dx1-67002"></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>
+ id="dx1-67003"></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" >
+ id="dx1-67004"></a> to determine the selection of dependencies. </div>
+</p><!--l. 4491--><p class="noindent" >
+</p><!--l. 4493--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-670002.4"></a><span id="textcolor221"><a
+ id="x1-680002.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
@@ -10167,28 +10206,28 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">boolean</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 4472--><p class="noindent" >If <span
+<!--l. 4495--><p class="noindent" >If <span
class="cmss-10">true</span>, makes the <span
class="cmtt-10">see</span><a
- id="dx1-67001"></a> and <span id="textcolor223"><span id="textcolor224"><span
+ id="dx1-68001"></a> and <span id="textcolor223"><span id="textcolor224"><span
class="cmtt-10">seealso</span></span><a
- id="dx1-67002"></a></span> keys automatically index the cross-reference (with <span
+ id="dx1-68002"></a></span> keys automatically index the cross-reference (with <span
class="cmtt-10">\glssee</span><a
- id="dx1-67003"></a>) when the entry
+ id="dx1-68003"></a>) when the entry
is defined (default, and the only option with just the base <span
class="cmss-10">glossaries </span>package).
-</p><!--l. 4477--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a
+</p><!--l. 4500--><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
+ id="dx1-68004"></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
+ id="dx1-68005"></a> to determine the selection of
dependencies. </div>
-</p><!--l. 4481--><p class="noindent" >
-</p><!--l. 4483--><p class="noindent" >
+</p><!--l. 4504--><p class="noindent" >
+</p><!--l. 4506--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-680002.4"></a><span id="textcolor227"><a
+ id="x1-690002.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
@@ -10195,73 +10234,73 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">value</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 4485--><p class="noindent" >If not <span
+<!--l. 4508--><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-68001"></a></a> is required. If the value is omitted, <span
+ id="dx1-69001"></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" >
+ <!--l. 4511--><p class="noindent" >
<span
class="cmssbx-10">off</span> </p></dt><dd
class="description">
- <!--l. 4488--><p class="noindent" ><a
+ <!--l. 4511--><p class="noindent" ><a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-68002"></a></a> isn’t being used;
+ id="dx1-69002"></a></a> isn’t being used;
</p></dd><dt class="description">
- <!--l. 4490--><p class="noindent" >
+ <!--l. 4513--><p class="noindent" >
<span
class="cmssbx-10">only</span> </p></dt><dd
class="description">
- <!--l. 4490--><p class="noindent" ><a
+ <!--l. 4513--><p class="noindent" ><a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-68003"></a></a> is being used to fetch entries from a <span
+ id="dx1-69003"></a></a> is being used to fetch entries from a <span
class="cmtt-10">bib</span><a
- id="dx1-68004"></a> file, to sort the entries and collate the <a
+ id="dx1-69004"></a> file, to sort the entries and collate the <a
href="#glo:numberlist">number
list<a
- id="dx1-68005"></a>s</a>, where the location information is the same as for Options <a
+ id="dx1-69005"></a>s</a>, where the location information is the same as for Options <a
href="#option1">1</a>–<a
href="#option3">3</a>;
</p></dd><dt class="description">
- <!--l. 4495--><p class="noindent" >
+ <!--l. 4518--><p class="noindent" >
<span
class="cmssbx-10">nameref</span> </p></dt><dd
class="description">
- <!--l. 4495--><p class="noindent" >like <span
+ <!--l. 4518--><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" >
+ <!--l. 4523--><p class="noindent" >
<span
class="cmssbx-10">hybrid</span> </p></dt><dd
class="description">
- <!--l. 4500--><p class="noindent" >a hybrid approach where <a
+ <!--l. 4523--><p class="noindent" >a hybrid approach where <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-68006"></a></a> is used to fetch entries from a <span
+ id="dx1-69006"></a></a> is used to fetch entries from a <span
class="cmtt-10">bib</span><a
- id="dx1-68007"></a> file but <a
+ id="dx1-69007"></a> file but <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-68008"></a></a> or <a
+ id="dx1-69008"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-68009"></a></a>
+ id="dx1-69009"></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
+<!--l. 4528--><p class="noindent" >See <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> manual for further details.
-</p><!--l. 4507--><p class="noindent" >
+</p><!--l. 4530--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-690002.4"></a><span id="textcolor229"><a
+ id="x1-700002.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
@@ -10268,14 +10307,14 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">boolean</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 4509--><p class="noindent" >If <span
+<!--l. 4532--><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. 4513--><p class="noindent" >
+</p><!--l. 4536--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-700002.4"></a><span id="textcolor231"><a
+ id="x1-710002.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
@@ -10282,7 +10321,7 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">boolean</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 4515--><p class="noindent" >If <span
+<!--l. 4538--><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
@@ -10289,85 +10328,85 @@
location will be incorrect if an entry is indexed within the float before the caption.)
-</p><!--l. 4521--><p class="noindent" >
+</p><!--l. 4544--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-710002.4"></a><span id="textcolor233"><a
+ id="x1-720002.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. 4523--><p class="noindent" >This valueless option is primarily intended for use with <a
+<!--l. 4546--><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-71001"></a></a> and <span
+ id="dx1-72001"></a></a> and <span
class="cmss-10">hyperref</span><a
- id="dx1-71002"></a> allowing the page location
+ id="dx1-72002"></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. 4530--><p class="noindent" >
+</p><!--l. 4553--><p class="noindent" >
</p>
-<!--l. 4530--><p class="noindent" ><a
+<!--l. 4553--><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. 4533--><p class="noindent" >This section is mostly for Options <a
+<!--l. 4556--><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-72001"></a> and <span
+ id="dx1-73001"></a> and <span
class="cmss-10">order</span><a
- id="dx1-72002"></a> options are applicable for
+ id="dx1-73002"></a> options are applicable for
<a
href="#option1">Option 1</a>.
-</p><!--l. 4536--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With Options <a
+</p><!--l. 4559--><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-72003"></a> is applicable (and this is automatically implemented by
+ id="dx1-73003"></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-72004"></a> and <span id="textcolor236"><span
+ id="dx1-73004"></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-72005"></a>). With <a
+ id="dx1-73005"></a>). With <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-72006"></a></a>, the sort method is provided in the optional argument of
+ id="dx1-73006"></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-72007"></a> not with the <span
+ id="dx1-73007"></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. 4543--><p class="noindent" >
-</p><!--l. 4545--><p class="noindent" >
+</p><!--l. 4566--><p class="noindent" >
+</p><!--l. 4568--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-730002.5"></a><a
+ id="x1-740002.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. 4545--><p class="noindent" >This is a boolean option that determines whether or not to <a
+<!--l. 4568--><p class="noindent" >This is a boolean option that determines whether or not to <a
href="#glo:sanitize">sanitize<a
- id="dx1-73001"></a></a> the sort value when writing to the external
+ id="dx1-74001"></a></a> the sort value when writing to the external
glossary file. For example, suppose you define an entry as follows:
</p>
- <pre class="verbatim" id="verbatim-91">
+ <pre class="verbatim" id="verbatim-93">
\newglossaryentry{hash}{name={\#},sort={#},
 description={hash symbol}}
</pre>
-<!--l. 4552--><p class="nopar" > The sort value (<span class="obeylines-h"><span class="verb"><span
+<!--l. 4575--><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:
@@ -10374,7 +10413,7 @@
</p>
- <pre class="verbatim" id="verbatim-92">
+ <pre class="verbatim" id="verbatim-94">
\newcommand{\mysortvalue}{AAA}
\newglossaryentry{sample}{%
  name={sample},
@@ -10381,7 +10420,7 @@
  sort={\mysortvalue},
  description={an example}}
</pre>
-<!--l. 4564--><p class="nopar" > and you actually want <span
+<!--l. 4587--><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
@@ -10388,118 +10427,118 @@
class="cmss-10">sanitizesort</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-73002"></a>.
-</p><!--l. 4569--><p class="indent" > The default for Options <a
+ id="dx1-74002"></a>.
+</p><!--l. 4592--><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-73003"></a>, and the default for <a
+ id="dx1-74003"></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-73004"></a>.
-</p><!--l. 4572--><p class="noindent" >
+ id="dx1-74004"></a>.
+</p><!--l. 4595--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-740002.5"></a><a
+ id="x1-750002.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. 4572--><p class="noindent" >If you use Options <a
+<!--l. 4595--><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-74001"></a> key in the optional argument
+ id="dx1-75001"></a> key in the optional argument
of <span
class="cmtt-10">\printnoidxglossary</span><a
- id="dx1-74002"></a>. If you have multiple glossaries in your document and you are using <a
+ id="dx1-75002"></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-74003"></a> or <span
+ id="dx1-75003"></a> or <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">use</span><a
- id="dx1-74004"></a> if you want to set this sort method for <span
+ id="dx1-75004"></a> if you want to set this sort method for <span
class="cmti-10">all </span>your
glossaries.
-</p><!--l. 4582--><p class="indent" > This is a ⟨<span
+</p><!--l. 4605--><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">
- <!--l. 4585--><p class="noindent" ><span
+ <!--l. 4608--><p class="noindent" ><span
class="cmss-10">standard</span><a
- id="dx1-74005"></a> : entries are sorted according to the value of the <span
+ id="dx1-75005"></a> : entries are sorted according to the value of the <span
class="cmtt-10">sort</span><a
- id="dx1-74006"></a> key used in <span
+ id="dx1-75006"></a> key used in <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-74007"></a> (if
+ id="dx1-75007"></a> (if
present) or the <span
class="cmtt-10">name</span><a
- id="dx1-74008"></a> key (if <span
+ id="dx1-75008"></a> key (if <span
class="cmtt-10">sort</span><a
- id="dx1-74009"></a> key is missing);
+ id="dx1-75009"></a> key is missing);
</p></li>
<li class="itemize">
- <!--l. 4590--><p class="noindent" ><span
+ <!--l. 4613--><p class="noindent" ><span
class="cmss-10">def</span><a
- id="dx1-74010"></a> : entries are sorted in the order in which they were defined (the <span
+ id="dx1-75010"></a> : entries are sorted in the order in which they were defined (the <span
class="cmtt-10">sort</span><a
- id="dx1-74011"></a> key in <span
+ id="dx1-75011"></a> key in <span
class="cmtt-10">\newglossaryentry</span>
is ignored);
</p></li>
<li class="itemize">
- <!--l. 4594--><p class="noindent" ><span
+ <!--l. 4617--><p class="noindent" ><span
class="cmss-10">use</span><a
- id="dx1-74012"></a> : entries are sorted according to the order in which they are used in the document (the <span
+ id="dx1-75012"></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-74013"></a>
+ id="dx1-75013"></a>
key in <span
class="cmtt-10">\newglossaryentry </span>is ignored).
- </p><!--l. 4598--><p class="noindent" >Both <span
+ </p><!--l. 4621--><p class="noindent" >Both <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">def</span><a
- id="dx1-74014"></a> and <span
+ id="dx1-75014"></a> and <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">use</span><a
- 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
+ id="dx1-75015"></a> set the sort key to a six digit number via
+ </p><!--l. 4623--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-75016"></a> <span
class="cmtt-10">\glssortnumberfmt{</span>⟨<span
class="cmitt-10">number</span>⟩<span
class="cmtt-10">} </span></div><hr>
- </p><!--l. 4602--><p class="noindent" >
+ </p><!--l. 4625--><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-74017"></a>) or before the entries are used (in the case of <span
+ id="dx1-75017"></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-74018"></a>).
+ id="dx1-75018"></a>).
</p></li>
<li class="itemize">
- <!--l. 4608--><p class="noindent" ><span
+ <!--l. 4631--><p class="noindent" ><span
class="cmss-10">none</span><a
- id="dx1-74019"></a> : this setting is new to version 4.30 and is only for documents that don’t use <span
+ id="dx1-75019"></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
@@ -10508,7 +10547,7 @@
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.
- </p><!--l. 4615--><p class="noindent" >This option can’t be used with <span
+ </p><!--l. 4638--><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
@@ -10519,25 +10558,25 @@
<span
class="cmtt-10">\printunsrtglossary </span>(<a
href="#option5">Option 5</a>).</p></li></ul>
-<!--l. 4621--><p class="noindent" >Note that the group styles (such as <span
+<!--l. 4644--><p class="noindent" >Note that the group styles (such as <span
class="cmss-10">listgroup</span><a
- id="dx1-74020"></a>) are incompatible with the <span
+ id="dx1-75020"></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-74021"></a> and <span
+ id="dx1-75021"></a> and <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">def</span><a
- id="dx1-74022"></a> options.
-</p><!--l. 4625--><p class="indent" > The default is <span
+ id="dx1-75022"></a> options.
+</p><!--l. 4648--><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-74023"></a>. When the standard sort option is in use, you can hook into the sort mechanism
+ id="dx1-75023"></a>. When the standard sort option is in use, you can hook into the sort mechanism
by redefining:
-</p><!--l. 4628--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74024"></a> <span
+</p><!--l. 4651--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-75024"></a> <span
class="cmtt-10">\glsprestandardsort{</span>⟨<span
class="cmitt-10">sort cs</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -10545,38 +10584,38 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 4630--><p class="noindent" >
+</p><!--l. 4653--><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-74025"></a> key or implicitly set via the <span
+ id="dx1-75025"></a> key or implicitly set via the <span
class="cmtt-10">name</span><a
- id="dx1-74026"></a> key) before any escaping of the <a
+ id="dx1-75026"></a> key) before any escaping of the <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-74027"></a></a>/<a
+ id="dx1-75027"></a></a>/<a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-74028"></a></a> special characters is
+ id="dx1-75028"></a></a> special characters is
performed. By default <span
class="cmtt-10">\glsprestandardsort </span>just does:
-</p><!--l. 4636--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-74029"></a> <span
+</p><!--l. 4659--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-75029"></a> <span
class="cmtt-10">\glsdosanitizesort </span></div><hr>
-</p><!--l. 4638--><p class="noindent" >
+</p><!--l. 4661--><p class="noindent" >
which <a
href="#glo:sanitize">sanitize<a
- id="dx1-74030"></a>s</a> ⟨<span
+ id="dx1-75030"></a>s</a> ⟨<span
class="cmti-10">sort cs</span>⟩ if the <span
class="cmss-10">sanitizesort</span><a
- id="dx1-74031"></a> package option is set (or does nothing if the package option
+ id="dx1-75031"></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-74032"></a> is used).
-</p><!--l. 4643--><p class="indent" > The other arguments, ⟨<span
+ id="dx1-75032"></a> is used).
+</p><!--l. 4666--><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
@@ -10584,26 +10623,26 @@
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-74033"></a>.
-</p><!--l. 4648--><p class="indent" > <div class="important" title="Important Note"> Redefining <span
+ id="dx1-75033"></a>.
+</p><!--l. 4671--><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-74034"></a> or <span
+ id="dx1-75034"></a> or <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">use</span><a
- id="dx1-74035"></a>. </div>
-</p><!--l. 4652--><p class="noindent" >
+ id="dx1-75035"></a>. </div>
+</p><!--l. 4675--><p class="noindent" >
<a
- id="ex:diffsorts"></a>
-</p><!--l. 4654--><p class="noindent" ><span
+ id="x1-75036r1"></a>
+</p><!--l. 4677--><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-74037"></a>
-</p><!--l. 4655--><p class="indent" > Suppose I have three glossaries: <span
+ id="x1-75037"></a>
+</p><!--l. 4678--><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
@@ -10612,22 +10651,22 @@
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. 4661--><p class="indent" > For <a
+</p><!--l. 4684--><p class="indent" > For <a
href="#option1">Option 1</a>, the <span
class="cmtt-10">sort</span><a
- id="dx1-74038"></a> option can be used in <span
+ id="dx1-75038"></a> option can be used in <span
class="cmtt-10">\printnoidxglossary</span><a
- id="dx1-74039"></a>:
+ id="dx1-75039"></a>:
</p>
- <pre class="verbatim" id="verbatim-93">
+ <pre class="verbatim" id="verbatim-95">
\printnoidxglossary[sort=word]
\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
+<!--l. 4690--><p class="nopar" >
+</p><!--l. 4692--><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
@@ -10635,7 +10674,7 @@
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">standard</span><a
- id="dx1-74040"></a>), and I can either define all my <span
+ id="dx1-75040"></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
@@ -10648,11 +10687,11 @@
⟨<span
class="cmti-10">type</span>⟩ is <span
class="cmtt-10">notation</span>.
-</p><!--l. 4679--><p class="indent" > The first option can be achieved as follows:
+</p><!--l. 4702--><p class="indent" > The first option can be achieved as follows:
</p>
- <pre class="verbatim" id="verbatim-94">
+ <pre class="verbatim" id="verbatim-96">
\newcounter{sortcount}
\renewcommand{\glsprestandardsort}[3]{%
  \stepcounter{sortcount}%
@@ -10659,11 +10698,11 @@
  \edef#1{\glssortnumberfmt{\arabic{sortcount}}}%
}
</pre>
-<!--l. 4687--><p class="nopar" > The second option can be achieved as follows:
+<!--l. 4710--><p class="nopar" > The second option can be achieved as follows:
</p>
- <pre class="verbatim" id="verbatim-95">
+ <pre class="verbatim" id="verbatim-97">
\newcounter{sortcount}
\renewcommand{\glsprestandardsort}[3]{%
  \ifdefstring{#2}{notation}%
@@ -10676,24 +10715,24 @@
  }%
}
</pre>
-<!--l. 4702--><p class="nopar" > (<span
+<!--l. 4725--><p class="nopar" > (<span
class="cmtt-10">\ifdefstring </span>is defined by the <span
class="cmss-10">etoolbox</span><a
- id="dx1-74041"></a> package.) For a complete document, see the sample file
+ id="dx1-75041"></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. 4705--><p class="noindent" >
-</p><!--l. 4705--><p class="noindent" >____________________________</p></div>
+<!--l. 4728--><p class="noindent" >
+</p><!--l. 4728--><p class="noindent" >____________________________</p></div>
<a
- id="ex:customsort"></a>
-<!--l. 4707--><p class="noindent" ><span
+ id="x1-75042r2"></a>
+<!--l. 4730--><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-74043"></a>
-</p><!--l. 4708--><p class="indent" > Suppose you want a glossary of people and you want the names listed as ⟨<span
+ id="x1-75043"></a>
+</p><!--l. 4731--><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
@@ -10706,28 +10745,28 @@
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-74044"></a> key when you define the entry, but
+ id="dx1-75044"></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. 4717--><p class="indent" > First, define two commands to set the person’s name:
+</p><!--l. 4740--><p class="indent" > First, define two commands to set the person’s name:
</p>
- <pre class="verbatim" id="verbatim-96">
+ <pre class="verbatim" id="verbatim-98">
\newcommand{\sortname}[2]{#2, #1}
\newcommand{\textname}[2]{#1 #2}
</pre>
-<!--l. 4721--><p class="nopar" > and <span
+<!--l. 4744--><p class="nopar" > and <span
class="cmtt-10">\name </span>needs to be initialised to <span
class="cmtt-10">\textname</span>:
</p>
- <pre class="verbatim" id="verbatim-97">
+ <pre class="verbatim" id="verbatim-99">
\let\name\textname
</pre>
-<!--l. 4725--><p class="nopar" > Now redefine <span
+<!--l. 4748--><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
@@ -10740,7 +10779,7 @@
</p>
- <pre class="verbatim" id="verbatim-98">
+ <pre class="verbatim" id="verbatim-100">
\renewcommand{\glsprestandardsort}[3]{%
 \let\name\sortname
 \edef#1{\expandafter\expandonce\expandafter{#1}}%
@@ -10748,145 +10787,145 @@
 \glsdosanitizesort
}
</pre>
-<!--l. 4737--><p class="nopar" > (The somewhat complicate use of <span
+<!--l. 4760--><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. 4741--><p class="indent" > Now the entries can be defined:
+</p><!--l. 4764--><p class="indent" > Now the entries can be defined:
</p>
- <pre class="verbatim" id="verbatim-99">
+ <pre class="verbatim" id="verbatim-101">
\newglossaryentry{joebloggs}{name={\name{Joe}{Bloggs}},
  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
+<!--l. 4771--><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. 4750--><p class="noindent" >
-</p><!--l. 4750--><p class="noindent" >____________________________</p></div>
-<!--l. 4752--><p class="noindent" >
+<!--l. 4773--><p class="noindent" >
+</p><!--l. 4773--><p class="noindent" >____________________________</p></div>
+<!--l. 4775--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-750002.5"></a><a
+ id="x1-760002.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. 4752--><p class="noindent" >This may take two values: <span
+<!--l. 4775--><p class="noindent" >This may take two values: <span
class="cmss-10">word</span><a
- id="dx1-75001"></a> or <span
+ id="dx1-76001"></a> or <span
class="cmss-10">letter</span><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
+ id="dx1-76002"></a>. The default is word ordering.
+</p><!--l. 4779--><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-75003"></a> option has no effect if you don’t use <a
+ id="dx1-76003"></a> option has no effect if you don’t use <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-75004"></a></a>.
+ id="dx1-76004"></a></a>.
</div>
-</p><!--l. 4759--><p class="noindent" >
-</p><!--l. 4761--><p class="indent" > If you use <a
+</p><!--l. 4782--><p class="noindent" >
+</p><!--l. 4784--><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-75005"></a><span
+ id="dx1-76005"></a><span
class="cmtt-10">=standard </span>in the optional argument of
<span
class="cmtt-10">\printnoidxglossary</span><a
- id="dx1-75006"></a>:
+ id="dx1-76006"></a>:
</p>
- <pre class="verbatim" id="verbatim-100">
+ <pre class="verbatim" id="verbatim-102">
\printnoidxglossary[sort=standard]
</pre>
-<!--l. 4766--><p class="nopar" > Alternatively, you can specify the order for individual glossaries:
+<!--l. 4789--><p class="nopar" > Alternatively, you can specify the order for individual glossaries:
</p>
- <pre class="verbatim" id="verbatim-101">
+ <pre class="verbatim" id="verbatim-103">
\printnoidxglossary[sort=word]
\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
+<!--l. 4794--><p class="nopar" >
+</p><!--l. 4796--><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-75007"></a></a>, use the <span id="textcolor238"><span
+ id="dx1-76007"></a></a>, use the <span id="textcolor238"><span
class="cmtt-10">break-at</span></span><a
- id="dx1-75008"></a> option in <span id="textcolor239"><span
+ id="dx1-76008"></a> option in <span id="textcolor239"><span
class="cmtt-10">\GlsXtrLoadResources</span></span><a
- id="dx1-75009"></a> instead of <span
+ id="dx1-76009"></a> instead of <span
class="cmss-10">order</span>. </div>
-</p><!--l. 4776--><p class="noindent" >
-</p><!--l. 4778--><p class="noindent" >
+</p><!--l. 4799--><p class="noindent" >
+</p><!--l. 4801--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-760002.5"></a><a
+ id="x1-770002.5"></a><a
id="pkgopt:makeindex"></a><span
class="cmss-10">makeindex</span></h4>
-<!--l. 4778--><p class="noindent" >(<a
+<!--l. 4801--><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-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">makeindex</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">makeindex</span><a
- id="dx1-76005"></a> not <a
+ id="dx1-77005"></a> not <a
href="#glo:xindy"><span
class="cmtt-10">xindy</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">ist</span><a
- id="dx1-76007"></a>
+ id="dx1-77007"></a>
extension.
-</p><!--l. 4786--><p class="indent" > You may omit this package option if you are using <a
+</p><!--l. 4809--><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-76008"></a> in the package option list.
-</p><!--l. 4790--><p class="noindent" >
+ id="dx1-77008"></a> in the package option list.
+</p><!--l. 4813--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-770002.5"></a><a
+ id="x1-780002.5"></a><a
id="pkgopt:xindy"></a><span
class="cmss-10">xindy</span></h4>
-<!--l. 4790--><p class="noindent" >(<a
+<!--l. 4813--><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-77001"></a></a> format. If you use
+ id="dx1-78001"></a></a> format. If you use
<a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-77002"></a></a>, it will automatically detect that it needs to call <span
+ id="dx1-78002"></a></a>, it will automatically detect that it needs to call <span
class="cmtt-10">xindy</span><a
- id="dx1-77003"></a>. If you don’t use <span
+ id="dx1-78003"></a>. If you don’t use <span
class="cmtt-10">makeglossaries</span><a
- id="dx1-77004"></a>,
+ id="dx1-78004"></a>,
you need to remember to use <span
class="cmtt-10">xindy</span><a
- id="dx1-77005"></a> not <a
+ id="dx1-78005"></a> not <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-77006"></a></a>. The indexing style file will been given a <span
+ id="dx1-78006"></a></a>. The indexing style file will been given a <span
class="cmtt-10">xdy</span><a
- id="dx1-77007"></a>
+ id="dx1-78007"></a>
extension.
-</p><!--l. 4797--><p class="indent" > This package option may additionally have a value that is a ⟨<span
+</p><!--l. 4820--><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:
@@ -10893,70 +10932,70 @@
</p>
- <pre class="verbatim" id="verbatim-102">
+ <pre class="verbatim" id="verbatim-104">
\usepackage[xindy={language=english,codepage=utf8}]
  {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
+<!--l. 4826--><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>
- <pre class="verbatim" id="verbatim-103">
+ <pre class="verbatim" id="verbatim-105">
\usepackage[xindy={glsnumbers=false}]{glossaries}
</pre>
-<!--l. 4808--><p class="nopar" > If no value is supplied to this package option (either simply writing <span
+<!--l. 4831--><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">§<span
-class="cmbx-10">??</span>sec:xindy </a><a
+class="cmbx-10">14</span> </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-77008"></a></a> with the <span
+ id="dx1-78008"></a></a> with the <span
class="cmss-10">glossaries </span>package.
-</p><!--l. 4815--><p class="noindent" >
+</p><!--l. 4838--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-780002.5"></a><a
+ id="x1-790002.5"></a><a
id="pkgopt:xindygloss"></a><span
class="cmss-10">xindygloss</span></h4>
-<!--l. 4815--><p class="noindent" >(<a
+<!--l. 4838--><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-78001"></a> option without any value supplied) and may be
+ id="dx1-79001"></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-78002"></a> and
+ id="dx1-79002"></a> and
<span
class="cmtt-10">\GlsSetXdyCodePage</span><a
- id="dx1-78003"></a> (see <a
+ id="dx1-79003"></a> (see <a
href="#sec:langenc">§<span
-class="cmbx-10">??</span>sec:langenc </a><a
+class="cmbx-10">14.1</span> </a><a
href="#sec:langenc">Language and Encodings<!--tex4ht:ref: sec:langenc --></a>.)
-</p><!--l. 4821--><p class="noindent" >
+</p><!--l. 4844--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-790002.5"></a><a
+ id="x1-800002.5"></a><a
id="pkgopt:xindynoglsnumbers"></a><span
class="cmss-10">xindynoglsnumbers</span></h4>
-<!--l. 4821--><p class="noindent" >(<a
+<!--l. 4844--><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. 4825--><p class="noindent" >
+</p><!--l. 4848--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-800002.5"></a><a
+ id="x1-810002.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. 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
+<!--l. 4848--><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
@@ -10966,36 +11005,36 @@
class="cmss-10">automake</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-80001"></a> will attempt to run <a
+ id="dx1-81001"></a> will attempt to run <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-80002"></a></a> or <a
+ id="dx1-81002"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-80003"></a></a> using TeX’s <span
+ id="dx1-81003"></a></a> using TeX’s <span
class="cmtt-10">\write18</span><a
- id="dx1-80004"></a> mechanism
+ id="dx1-81004"></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-80005"></a> will attempt to run <a
+ id="dx1-81005"></a> will attempt to run <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-80006"></a></a> or
+ id="dx1-81006"></a></a> or
<a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-80007"></a></a> at the start of <span
+ id="dx1-81007"></a></a> at the start of <span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-80008"></a> using <span
+ id="dx1-81008"></a> using <span
class="cmtt-10">\immediate </span>(before the glossary files have been
opened).
-</p><!--l. 4836--><p class="indent" > In the case of <span
+</p><!--l. 4859--><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-80009"></a>, the associated files are created at the end of the document ready
+ id="dx1-81009"></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
@@ -11007,50 +11046,50 @@
class="cmss-10">automake</span><span
class="cmtt-10">=</span><span
class="cmss-10">immediate</span><a
- id="dx1-80010"></a>
+ id="dx1-81010"></a>
instead.
-</p><!--l. 4846--><p class="indent" > With <span
+</p><!--l. 4869--><p class="indent" > With <span
class="cmss-10">automake</span><span
class="cmtt-10">=</span><span
class="cmss-10">immediate</span><a
- id="dx1-80011"></a>, you will get a warning on the first LaTeX run as the associated glossary files
+ id="dx1-81011"></a>, you will get a warning on the first LaTeX run as the associated glossary files
don’t exist yet.
-</p><!--l. 4850--><p class="indent" > Since this mechanism can be a security risk, some TeX distributions disable it completely, in which case this
+</p><!--l. 4873--><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. 4856--><p class="indent" > Some distributions allow <span
+</p><!--l. 4879--><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-80012"></a></a> but may not include <a
+ id="dx1-81012"></a></a> but may not include <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-80013"></a></a>. So if you have the restricted mode
+ id="dx1-81013"></a></a>. So if you have the restricted mode
on, <span
class="cmss-10">automake</span><a
- id="dx1-80014"></a> should work with <span
+ id="dx1-81014"></a> should work with <span
class="cmtt-10">makeindex</span><a
- id="dx1-80015"></a> but may not work with <a
+ id="dx1-81015"></a> but may not work with <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-80016"></a></a>.
-</p><!--l. 4862--><p class="indent" > However even in unrestricted mode this option may not work with <span
+ id="dx1-81016"></a></a>.
+</p><!--l. 4885--><p class="indent" > However even in unrestricted mode this option may not work with <span
class="cmtt-10">xindy</span><a
- id="dx1-80017"></a> as <span
+ id="dx1-81017"></a> as <span
class="cmtt-10">xindy</span><a
- id="dx1-80018"></a> uses language names that
+ id="dx1-81018"></a> uses language names that
don’t always correspond with <span
class="cmss-10">babel</span><a
- id="dx1-80019"></a>’s language names. (The <a
+ id="dx1-81019"></a>’s language names. (The <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-80020"></a></a> script applies mappings to assist
+ id="dx1-81020"></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. 4869--><p class="indent" > Since this package option attempts to run the <a
+</p><!--l. 4892--><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
@@ -11057,54 +11096,54 @@
class="cmss-10">automake</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-80021"></a>.
-</p><!--l. 4875--><p class="noindent" >
+ id="dx1-81021"></a>.
+</p><!--l. 4898--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-810002.5"></a><a
+ id="x1-820002.5"></a><a
id="pkgopt:disablemakegloss"></a><span
class="cmss-10">disablemakegloss</span></h4>
-<!--l. 4875--><p class="noindent" >This valueless option indicates that <span
+<!--l. 4898--><p class="noindent" >This valueless option indicates that <span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-81001"></a> and <span
+ id="dx1-82001"></a> and <span
class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-81002"></a> should be disabled.
+ id="dx1-82002"></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
+class="cmbx-10">1.2</span> </a><a
href="#sec:indexingoptions">Indexing Options<!--tex4ht:ref: sec:indexingoptions --></a> and automatically performs <span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-81003"></a> or
+ id="dx1-82003"></a> or
<span
class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-81004"></a> but you don’t want this. (For example, you want to use a different indexing method or
+ id="dx1-82004"></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
+</p><!--l. 4908--><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-81005"></a> is loaded. Note that this does nothing if <span
+ id="dx1-82005"></a> is loaded. Note that this does nothing if <span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-81006"></a> or <span
+ id="dx1-82006"></a> or <span
class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-81007"></a> has
+ id="dx1-82007"></a> has
already been used whilst enabled.
-</p><!--l. 4891--><p class="noindent" >
+</p><!--l. 4914--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-820002.5"></a><a
+ id="x1-830002.5"></a><a
id="pkgopt:restoremakegloss"></a><span
class="cmss-10">restoremakegloss</span></h4>
-<!--l. 4891--><p class="noindent" >Cancels the effect of <span
+<!--l. 4914--><p class="noindent" >Cancels the effect of <span
class="cmss-10">disablemakegloss</span><a
- id="dx1-82001"></a>. This option may be used in <span
+ id="dx1-83001"></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-82002"></a> or <span
+ id="dx1-83002"></a> or <span
class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-82003"></a> has already been used whilst enabled. For
+ id="dx1-83003"></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
@@ -11115,17 +11154,17 @@
</p>
- <pre class="verbatim" id="verbatim-104">
+ <pre class="verbatim" id="verbatim-106">
\documentclass[disablemakegloss]{customclass}
\newglossary*{functions}{Functions}
\setupglossaries{restoremakegloss}
\makeglossaries
</pre>
-<!--l. 4904--><p class="nopar" > or
+<!--l. 4927--><p class="nopar" > or
</p>
- <pre class="verbatim" id="verbatim-105">
+ <pre class="verbatim" id="verbatim-107">
\PassOptionsToPackage{disablemakegloss}{glossaries}
\documentclass{customclass}
\newglossary*{functions}{Functions}
@@ -11132,17 +11171,17 @@
\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
+<!--l. 4935--><p class="nopar" >
+</p><!--l. 4937--><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-82004"></a> or <span id="textcolor241"><span
+ id="dx1-83004"></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-82005"></a>
+ id="dx1-83005"></a>
options with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> then you can’t use <span
@@ -11150,90 +11189,90 @@
class="cmtt-10">\makenoidxglossaries </span>regardless of
<span
class="cmss-10">restoremakegloss</span><a
- id="dx1-82006"></a>.
-</p><!--l. 4921--><p class="noindent" >
+ id="dx1-83006"></a>.
+</p><!--l. 4944--><p class="noindent" >
</p>
-<!--l. 4921--><p class="noindent" ><a
+<!--l. 4944--><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. 4924--><p class="noindent" >
+<!--l. 4947--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-840002.6"></a><a
+ id="x1-850002.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. 4924--><p class="noindent" >Use this option if you have multiple glossaries and you want to suppress the entry hyperlinks for a particular
+<!--l. 4947--><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-84001"></a>
+ id="dx1-85001"></a>
etc shouldn’t have hyperlinks by default. Make sure you enclose the value in braces if it contains any commas.
Example:
</p>
- <pre class="verbatim" id="verbatim-106">
+ <pre class="verbatim" id="verbatim-108">
\usepackage[acronym,nohypertypes={acronym,notation}]
  {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
+<!--l. 4957--><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-84002"></a>. You may also
+ id="dx1-85002"></a>. You may also
use
-</p><!--l. 4938--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 4961--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\GlsDeclareNoHyperList</span><a
- id="dx1-84003"></a><span
+ id="dx1-85003"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">list</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 4939--><p class="noindent" >
+</p><!--l. 4962--><p class="noindent" >
instead or additionally. See <a
href="#sec:glslink">§<span
-class="cmbx-10">??</span>sec:glslink </a><a
+class="cmbx-10">5.1</span> </a><a
href="#sec:glslink">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> for further details.
-</p><!--l. 4943--><p class="noindent" >
+</p><!--l. 4966--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-850002.6"></a><a
+ id="x1-860002.6"></a><a
id="pkgopt:nomain"></a><span
class="cmss-10">nomain</span></h4>
-<!--l. 4943--><p class="noindent" >This suppresses the creation of the main glossary and associated <span
+<!--l. 4966--><p class="noindent" >This suppresses the creation of the main glossary and associated <span
class="cmtt-10">glo</span><a
- id="dx1-85001"></a> file, if unrequired. Note that if you use this
+ id="dx1-86001"></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-85002"></a> (or <span
+ id="dx1-86002"></a> (or <span
class="cmss-10">acronyms</span><a
- id="dx1-85003"></a>)
+ id="dx1-86003"></a>)
package option described in <a
href="#sec:pkgopts-acronym">§<span
-class="cmbx-10">??</span>sec:pkgopts-acronym </a><a
+class="cmbx-10">2.7</span> </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-85004"></a>,
+ id="dx1-86004"></a>,
<span
class="cmss-10">numbers</span><a
- id="dx1-85005"></a> or <span
+ id="dx1-86005"></a> or <span
class="cmss-10">index</span><a
- id="dx1-85006"></a> options described in <a
+ id="dx1-86006"></a> options described in <a
href="#sec:pkgopts-other">§<span
-class="cmbx-10">??</span>sec:pkgopts-other </a><a
+class="cmbx-10">2.9</span> </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-85007"></a> described in
+ id="dx1-86007"></a> described in
<a
href="#sec:newglossary">§<span
-class="cmbx-10">??</span>sec:newglossary </a><a
+class="cmbx-10">9</span> </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
+</p><!--l. 4976--><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-85008"></a></a> will produce a warning.
+ id="dx1-86008"></a></a> will produce a warning.
</div>
-</p><!--l. 4956--><p class="noindent" >
+</p><!--l. 4979--><p class="noindent" >
</p><div class="alltt">
<div class="obeylines-v">
<span
@@ -11276,153 +11315,153 @@
</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-85009"></a>.
-<!--l. 4968--><p class="noindent" >
+ id="dx1-86009"></a>.
+<!--l. 4991--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-860002.6"></a><a
+ id="x1-870002.6"></a><a
id="pkgopt:symbols"></a><span
class="cmss-10">symbols</span></h4>
-<!--l. 4968--><p class="noindent" >This valueless option defines a new glossary type with the label <span
+<!--l. 4991--><p class="noindent" >This valueless option defines a new glossary type with the label <span
class="cmtt-10">symbols </span>via
</p>
- <pre class="verbatim" id="verbatim-107">
+ <pre class="verbatim" id="verbatim-109">
\newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname}
</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
+<!--l. 4995--><p class="nopar" > It also defines
+</p><!--l. 4997--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-87001"></a> <span
class="cmtt-10">\printsymbols[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 4976--><p class="noindent" >
+</p><!--l. 4999--><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=symbols,</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
</div>
</div>
-<!--l. 4982--><p class="indent" > If you use <a
+<!--l. 5005--><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=symbols,</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
</div>
</div> to display the list of symbols.
-<!--l. 4988--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span
+<!--l. 5011--><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">symbols </span>glossary and
don’t intend to use the <span
class="cmtt-10">main </span>glossary. </div>
-</p><!--l. 4992--><p class="noindent" >
-</p><!--l. 4994--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 5015--><p class="noindent" >
+</p><!--l. 5017--><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="textcolor242"><span
class="cmtt-10">\glsxtrnewsymbol</span></span><a
- id="dx1-86005"></a> as a convenient shortcut method for defining symbols. See the <a
+ id="dx1-87005"></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. 4999--><p class="noindent" >
-</p><!--l. 5001--><p class="noindent" >
+</p><!--l. 5022--><p class="noindent" >
+</p><!--l. 5024--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-870002.6"></a><a
+ id="x1-880002.6"></a><a
id="pkgopt:numbers"></a><span
class="cmss-10">numbers</span></h4>
-<!--l. 5001--><p class="noindent" >This valueless option defines a new glossary type with the label <span
+<!--l. 5024--><p class="noindent" >This valueless option defines a new glossary type with the label <span
class="cmtt-10">numbers </span>via
</p>
- <pre class="verbatim" id="verbatim-108">
+ <pre class="verbatim" id="verbatim-110">
\newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname}
</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
+<!--l. 5028--><p class="nopar" > It also defines
+</p><!--l. 5030--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-88001"></a> <span
class="cmtt-10">\printnumbers[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 5009--><p class="noindent" >
+</p><!--l. 5032--><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-87002"></a><span
+ id="dx1-88002"></a><span
class="cmtt-10">[type=numbers,</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
</div>
</div>
-<!--l. 5015--><p class="indent" > If you use <a
+<!--l. 5038--><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-87003"></a><span
+ id="dx1-88003"></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. 5021--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span
+<!--l. 5044--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span
class="cmss-10">nomain</span><a
- id="dx1-87004"></a> package option if you’re only interested in using this <span
+ id="dx1-88004"></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. 5025--><p class="noindent" >
-</p><!--l. 5027--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 5048--><p class="noindent" >
+</p><!--l. 5050--><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="textcolor243"><span
class="cmtt-10">\glsxtrnewnumber</span></span><a
- id="dx1-87005"></a> as a convenient shortcut method for defining numbers. See the <a
+ id="dx1-88005"></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. 5032--><p class="noindent" >
-</p><!--l. 5034--><p class="noindent" >
+</p><!--l. 5055--><p class="noindent" >
+</p><!--l. 5057--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-880002.6"></a><a
+ id="x1-890002.6"></a><a
id="pkgopt:index"></a><span
class="cmss-10">index</span></h4>
-<!--l. 5034--><p class="noindent" >This valueless option defines a new glossary type with the label <span
+<!--l. 5057--><p class="noindent" >This valueless option defines a new glossary type with the label <span
class="cmtt-10">index </span>via
</p>
- <pre class="verbatim" id="verbatim-109">
+ <pre class="verbatim" id="verbatim-111">
\newglossary[ilg]{index}{ind}{idx}{\indexname}%
</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
+<!--l. 5061--><p class="nopar" > It also defines
+</p><!--l. 5063--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-89001"></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. 5042--><p class="noindent" >
+</p><!--l. 5065--><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-88002"></a><span
+ id="dx1-89002"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">term</span>⟩<span
class="cmtt-10">}[type=index,name={</span>⟨<span
@@ -11430,126 +11469,126 @@
class="cmtt-10">},%</span>
<br /><span
class="cmtt-10">description=\nopostdesc</span><a
- id="dx1-88003"></a><span
+ id="dx1-89003"></a><span
class="cmtt-10">,</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
</div>
</div> and
-<!--l. 5049--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-88004"></a> <span
+<!--l. 5072--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-89004"></a> <span
class="cmtt-10">\printindex[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 5051--><p class="noindent" >
+</p><!--l. 5074--><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-88005"></a><span
+ id="dx1-89005"></a><span
class="cmtt-10">[type=index,</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
</div>
</div>
-<!--l. 5057--><p class="indent" > If you use <a
+<!--l. 5080--><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-88006"></a><span
+ id="dx1-89006"></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. 5063--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span
+<!--l. 5086--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span
class="cmss-10">nomain</span><a
- id="dx1-88007"></a> package option if you’re only interested in using this <span
+ id="dx1-89007"></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-88008"></a>. Either use
+ id="dx1-89008"></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-88009"></a>, <span
+ id="dx1-89009"></a>, <span
class="cmss-10">index</span><a
- id="dx1-88010"></a> or <span
+ id="dx1-89010"></a> or <span
class="cmss-10">imakeidx</span><a
- id="dx1-88011"></a>. (You
+ id="dx1-89011"></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-88012"></a> package option.)
+ id="dx1-89012"></a> package option.)
</div>
-</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
+</p><!--l. 5095--><p class="noindent" >
+</p><!--l. 5097--><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-88013"></a> or the command <spacer type=vertical size=10><span class="obeylines-h">
+ id="dx1-89013"></a> or the command <spacer type=vertical size=10><span class="obeylines-h">
<br /><span
class="cmtt-10">\GlsDeclareNoHyperList</span><a
- id="dx1-88014"></a><span class="verb"><span
+ id="dx1-89014"></a><span class="verb"><span
class="cmtt-10">{index}</span></span>
<br /><spacer type=vertical size=10></span>
-</p><!--l. 5081--><p class="indent" > The example file <a
+</p><!--l. 5104--><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-88015"></a> package option.
+ id="dx1-89015"></a> package option.
-</p><!--l. 5084--><p class="noindent" >
+</p><!--l. 5107--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-890002.6"></a><a
+ id="x1-900002.6"></a><a
id="pkgopt:noglossaryindex"></a><span
class="cmss-10">noglossaryindex</span></h4>
-<!--l. 5084--><p class="noindent" >This valueless option switches off <span
+<!--l. 5107--><p class="noindent" >This valueless option switches off <span
class="cmss-10">index</span><a
- id="dx1-89001"></a> if <span
+ id="dx1-90001"></a> if <span
class="cmss-10">index</span><a
- id="dx1-89002"></a> has been passed implicitly (for example, through global
+ id="dx1-90002"></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. 5090--><p class="noindent" >
+</p><!--l. 5113--><p class="noindent" >
</p>
-<!--l. 5090--><p class="noindent" ><a
+<!--l. 5113--><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. 5093--><p class="noindent" >
+<!--l. 5116--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-910002.7"></a><a
+ id="x1-920002.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. 5093--><p class="noindent" >If true, this creates a new glossary with the label <span
+<!--l. 5116--><p class="noindent" >If true, this creates a new glossary with the label <span
class="cmtt-10">acronym</span>. This is equivalent to:
</p>
- <pre class="verbatim" id="verbatim-110">
+ <pre class="verbatim" id="verbatim-112">
\newglossary[alg]{acronym}{acr}{acn}{\acronymname}
</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
+<!--l. 5120--><p class="nopar" > It will also define
+</p><!--l. 5122--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-92001"></a> <span
class="cmtt-10">\printacronyms[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 5101--><p class="noindent" >
+</p><!--l. 5124--><p class="noindent" >
that’s equivalent to </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\printglossary</span><a
- id="dx1-91002"></a><span
+ id="dx1-92002"></a><span
class="cmtt-10">[type=acronym,</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
@@ -11557,162 +11596,162 @@
</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-91003"></a> is used).
-<!--l. 5109--><p class="indent" > If you are using <a
+ id="dx1-92003"></a> is used).
+<!--l. 5132--><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-91004"></a><span
+ id="dx1-92004"></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. 5115--><p class="indent" > If the <span
+<!--l. 5138--><p class="indent" > If the <span
class="cmss-10">acronym</span><a
- id="dx1-91005"></a> package option is used, <span
+ id="dx1-92005"></a> package option is used, <span
class="cmtt-10">\acronymtype</span><a
- id="dx1-91006"></a> is set to <span
+ id="dx1-92006"></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-91007f5"></a>
+ id="x1-92007f5"></a>
Entries that are defined using <span
class="cmtt-10">\newacronym</span><a
- id="dx1-91013"></a> are placed in the glossary whose label is given by <span
+ id="dx1-92013"></a> are placed in the glossary whose label is given by <span
class="cmtt-10">\acronymtype</span><a
- id="dx1-91014"></a>,
+ id="dx1-92014"></a>,
unless another glossary is explicitly specified.
-</p><!--l. 5125--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span
+</p><!--l. 5148--><p class="indent" > <div class="important" title="Important Note"> Remember to use the <span
class="cmss-10">nomain</span><a
- id="dx1-91015"></a> package option if you’re only interested in using this <span
+ id="dx1-92015"></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. 5129--><p class="noindent" >
-</p><!--l. 5131--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 5152--><p class="noindent" >
+</p><!--l. 5154--><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="textcolor244"><span
class="cmss-10">abbreviations</span></span><a
- id="dx1-91016"></a> option, which creates a new
+ id="dx1-92016"></a> option, which creates a new
glossary with the label <span
class="cmtt-10">abbreviations </span>and sets the command <span id="textcolor245"><span
class="cmtt-10">\glsxtrabbrvtype</span></span><a
- id="dx1-91017"></a> to this. If the <span
+ id="dx1-92017"></a> to this. If the <span
class="cmss-10">acronym</span><a
- id="dx1-91018"></a> option
+ id="dx1-92018"></a> option
hasn’t also been used, then <span
class="cmtt-10">\acronymtype</span><a
- id="dx1-91019"></a> will be set to <span id="textcolor246"><span
+ id="dx1-92019"></a> will be set to <span id="textcolor246"><span
class="cmtt-10">\glsxtrabbrvtype</span></span><a
- id="dx1-91020"></a>. This enables both <span
+ id="dx1-92020"></a>. This enables both <span
class="cmtt-10">\newacronym</span><a
- id="dx1-91021"></a>
+ id="dx1-92021"></a>
and <span id="textcolor247"><span
class="cmtt-10">\newabbreviation</span></span><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
+ id="dx1-92022"></a> to use the same glossary.
+</p><!--l. 5163--><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-91023"></a> (or <span
+ id="dx1-92023"></a> (or <span
class="cmss-10">acronyms</span><a
- id="dx1-91024"></a>) package option
+ id="dx1-92024"></a>) package option
with the extension package to avoid a bug that interferes with the abbreviation style. </div>
-</p><!--l. 5144--><p class="noindent" >
-</p><!--l. 5146--><p class="noindent" >
+</p><!--l. 5167--><p class="noindent" >
+</p><!--l. 5169--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-920002.7"></a><a
+ id="x1-930002.7"></a><a
id="pkgopt:acronyms"></a><span
class="cmss-10">acronyms</span></h4>
-<!--l. 5146--><p class="noindent" >This is equivalent to <span
+<!--l. 5169--><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-92001"></a> and may be used in the document class option list.
+ id="dx1-93001"></a> and may be used in the document class option list.
-</p><!--l. 5150--><p class="noindent" >
+</p><!--l. 5173--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-930002.7"></a><span id="textcolor248"><a
+ id="x1-940002.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. 5152--><p class="noindent" >This valueless option creates a new glossary type using:
+<!--l. 5175--><p class="noindent" >This valueless option creates a new glossary type using:
</p>
- <pre class="verbatim" id="verbatim-111">
+ <pre class="verbatim" id="verbatim-113">
\newglossary[glg-abr]{abbreviations}{gls-abr}{glo-abr}{\abbreviationsname}
</pre>
-<!--l. 5155--><p class="nopar" > The label can be accessed with <span id="textcolor250"><span
+<!--l. 5178--><p class="nopar" > The label can be accessed with <span id="textcolor250"><span
class="cmtt-10">\glsxtrabbrvtype</span></span><a
- id="dx1-93001"></a>, which is analogous to <span
+ id="dx1-94001"></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. 5160--><p class="noindent" >
+</p><!--l. 5183--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-940002.7"></a><a
+ id="x1-950002.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. 5160--><p class="noindent" >By default, only the <span
+<!--l. 5183--><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-94001"></a>. For example, if you use
+ id="dx1-95001"></a>. For example, if you use
the <span
class="cmss-10">acronym</span><a
- id="dx1-94002"></a> package option but you also want the <span
+ id="dx1-95002"></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>
- <pre class="verbatim" id="verbatim-112">
+ <pre class="verbatim" id="verbatim-114">
\usepackage[acronym,acronymlists={main}]{glossaries}
</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
+<!--l. 5191--><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>
- <pre class="verbatim" id="verbatim-113">
+ <pre class="verbatim" id="verbatim-115">
\usepackage[acronym,acronymlists={main,acronym2}]
  {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
+<!--l. 5199--><p class="nopar" > You can use
+</p><!--l. 5201--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-95003"></a> <span
class="cmtt-10">\DeclareAcronymList{</span>⟨<span
class="cmitt-10">list</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 5180--><p class="noindent" >
+</p><!--l. 5203--><p class="noindent" >
instead of or in addition to the <span
class="cmss-10">acronymlists</span><a
- id="dx1-94004"></a> option. This will add the glossaries given in ⟨<span
+ id="dx1-95004"></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. 5185--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-94005"></a> <span
+</p><!--l. 5208--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-95005"></a> <span
class="cmtt-10">\SetAcronymLists{</span>⟨<span
class="cmitt-10">list</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</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
+</p><!--l. 5210--><p class="noindent" >
+</p><!--l. 5212--><p class="indent" > You can determine if a glossary has been identified as being a list of acronyms using:
+</p><!--l. 5214--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-95006"></a> <span
class="cmtt-10">\glsIfListOfAcronyms{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -11720,324 +11759,324 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">false part</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</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
+</p><!--l. 5216--><p class="noindent" >
+</p><!--l. 5218--><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. 5198--><p class="noindent" >
-</p><!--l. 5200--><p class="noindent" >
+</p><!--l. 5221--><p class="noindent" >
+</p><!--l. 5223--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-950002.7"></a><a
+ id="x1-960002.7"></a><a
id="pkgopt:shortcuts"></a><span
class="cmss-10">shortcuts</span></h4>
-<!--l. 5200--><p class="noindent" >This option provides shortcut commands for acronyms. See <a
+<!--l. 5223--><p class="noindent" >This option provides shortcut commands for acronyms. See <a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </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
+</p><!--l. 5226--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-96001"></a> <span
class="cmtt-10">\DefineAcronymSynonyms </span></div><hr>
-</p><!--l. 5205--><p class="noindent" >
-</p><!--l. 5207--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 5228--><p class="noindent" >
+</p><!--l. 5230--><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. 5209--><p class="noindent" >
-</p><!--l. 5211--><p class="noindent" >
+</p><!--l. 5232--><p class="noindent" >
+</p><!--l. 5234--><p class="noindent" >
</p>
-<!--l. 5211--><p class="noindent" ><a
+<!--l. 5234--><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
+<!--l. 5237--><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-96001"></a> instead. See <a
+ id="dx1-97001"></a> instead. See <a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </a><a
href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a> for further
details.
-</p><!--l. 5218--><p class="noindent" >
+</p><!--l. 5241--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-970002.8"></a><a
+ id="x1-980002.8"></a><a
id="pkgopt:description"></a><span
class="cmss-10">description</span></h4>
-<!--l. 5218--><p class="noindent" >This option changes the definition of <span
+<!--l. 5241--><p class="noindent" >This option changes the definition of <span
class="cmtt-10">\newacronym</span><a
- id="dx1-97001"></a> to allow a description. This option may be replaced
+ id="dx1-98001"></a> to allow a description. This option may be replaced
by
</p>
- <pre class="verbatim" id="verbatim-114">
+ <pre class="verbatim" id="verbatim-116">
\setacronymstyle{long-short-desc}
</pre>
-<!--l. 5223--><p class="nopar" > or (with <span
+<!--l. 5246--><p class="nopar" > or (with <span
class="cmss-10">smallcaps</span><a
- id="dx1-97002"></a>)
+ id="dx1-98002"></a>)
</p>
- <pre class="verbatim" id="verbatim-115">
+ <pre class="verbatim" id="verbatim-117">
\setacronymstyle{long-sc-short-desc}
</pre>
-<!--l. 5227--><p class="nopar" > or (with <span
+<!--l. 5250--><p class="nopar" > or (with <span
class="cmss-10">smaller</span><a
- id="dx1-97003"></a>)
+ id="dx1-98003"></a>)
</p>
- <pre class="verbatim" id="verbatim-116">
+ <pre class="verbatim" id="verbatim-118">
\setacronymstyle{long-sm-short-desc}
</pre>
-<!--l. 5231--><p class="nopar" > or (with <span
+<!--l. 5254--><p class="nopar" > or (with <span
class="cmss-10">footnote</span><a
- id="dx1-97004"></a>)
+ id="dx1-98004"></a>)
</p>
- <pre class="verbatim" id="verbatim-117">
+ <pre class="verbatim" id="verbatim-119">
\setacronymstyle{footnote-desc}
</pre>
-<!--l. 5235--><p class="nopar" > or (with <span
+<!--l. 5258--><p class="nopar" > or (with <span
class="cmss-10">footnote</span><a
- id="dx1-97005"></a> and <span
+ id="dx1-98005"></a> and <span
class="cmss-10">smallcaps</span><a
- id="dx1-97006"></a>)
+ id="dx1-98006"></a>)
</p>
- <pre class="verbatim" id="verbatim-118">
+ <pre class="verbatim" id="verbatim-120">
\setacronymstyle{footnote-sc-desc}
</pre>
-<!--l. 5239--><p class="nopar" > or (with <span
+<!--l. 5262--><p class="nopar" > or (with <span
class="cmss-10">footnote</span><a
- id="dx1-97007"></a> and <span
+ id="dx1-98007"></a> and <span
class="cmss-10">smaller</span><a
- id="dx1-97008"></a>)
+ id="dx1-98008"></a>)
</p>
- <pre class="verbatim" id="verbatim-119">
+ <pre class="verbatim" id="verbatim-121">
\setacronymstyle{footnote-sm-desc}
</pre>
-<!--l. 5243--><p class="nopar" > or (with <span
+<!--l. 5266--><p class="nopar" > or (with <span
class="cmss-10">dua</span><a
- id="dx1-97009"></a>)
+ id="dx1-98009"></a>)
</p>
- <pre class="verbatim" id="verbatim-120">
+ <pre class="verbatim" id="verbatim-122">
\setacronymstyle{dua-desc}
</pre>
-<!--l. 5247--><p class="nopar" >
-</p><!--l. 5249--><p class="noindent" >
+<!--l. 5270--><p class="nopar" >
+</p><!--l. 5272--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-980002.8"></a><a
+ id="x1-990002.8"></a><a
id="pkgopt:smallcaps"></a><span
class="cmss-10">smallcaps</span></h4>
-<!--l. 5249--><p class="noindent" >This option changes the definition of <span
+<!--l. 5272--><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. This option may
+ id="dx1-99001"></a> and the way that acronyms are displayed. This option may
be replaced by:
</p>
- <pre class="verbatim" id="verbatim-121">
+ <pre class="verbatim" id="verbatim-123">
\setacronymstyle{long-sc-short}
</pre>
-<!--l. 5254--><p class="nopar" > or (with <span
+<!--l. 5277--><p class="nopar" > or (with <span
class="cmss-10">description</span><a
- id="dx1-98002"></a>)
+ id="dx1-99002"></a>)
</p>
- <pre class="verbatim" id="verbatim-122">
+ <pre class="verbatim" id="verbatim-124">
\setacronymstyle{long-sc-short-desc}
</pre>
-<!--l. 5258--><p class="nopar" > or (with <span
+<!--l. 5281--><p class="nopar" > or (with <span
class="cmss-10">description</span><a
- id="dx1-98003"></a> and <span
+ id="dx1-99003"></a> and <span
class="cmss-10">footnote</span><a
- id="dx1-98004"></a>)
+ id="dx1-99004"></a>)
</p>
- <pre class="verbatim" id="verbatim-123">
+ <pre class="verbatim" id="verbatim-125">
\setacronymstyle{footnote-sc-desc}
</pre>
-<!--l. 5262--><p class="nopar" >
-</p><!--l. 5264--><p class="noindent" >
+<!--l. 5285--><p class="nopar" >
+</p><!--l. 5287--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-990002.8"></a><a
+ id="x1-1000002.8"></a><a
id="pkgopt:smaller"></a><span
class="cmss-10">smaller</span></h4>
-<!--l. 5264--><p class="noindent" >This option changes the definition of <span
+<!--l. 5287--><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.
-</p><!--l. 5266--><p class="indent" > <div class="important" title="Important Note"> If you use this option, you will need to include the <span
+ id="dx1-100001"></a> and the way that acronyms are displayed.
+</p><!--l. 5289--><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-99002"></a> package or otherwise define <span
+ id="dx1-100002"></a> package or otherwise define <span
class="cmtt-10">\textsmaller</span><a
- id="dx1-99003"></a> or
+ id="dx1-100003"></a> or
redefine <span
class="cmtt-10">\acronymfont</span><a
- id="dx1-99004"></a>. </div>
-</p><!--l. 5270--><p class="noindent" >
+ id="dx1-100004"></a>. </div>
+</p><!--l. 5293--><p class="noindent" >
This option may be replaced by:
</p>
- <pre class="verbatim" id="verbatim-124">
+ <pre class="verbatim" id="verbatim-126">
\setacronymstyle{long-sm-short}
</pre>
-<!--l. 5274--><p class="nopar" > or (with <span
+<!--l. 5297--><p class="nopar" > or (with <span
class="cmss-10">description</span><a
- id="dx1-99005"></a>)
+ id="dx1-100005"></a>)
</p>
- <pre class="verbatim" id="verbatim-125">
+ <pre class="verbatim" id="verbatim-127">
\setacronymstyle{long-sm-short-desc}
</pre>
-<!--l. 5278--><p class="nopar" > or (with <span
+<!--l. 5301--><p class="nopar" > or (with <span
class="cmss-10">description</span><a
- id="dx1-99006"></a> and <span
+ id="dx1-100006"></a> and <span
class="cmss-10">footnote</span><a
- id="dx1-99007"></a>)
+ id="dx1-100007"></a>)
</p>
- <pre class="verbatim" id="verbatim-126">
+ <pre class="verbatim" id="verbatim-128">
\setacronymstyle{footnote-sm-desc}
</pre>
-<!--l. 5282--><p class="nopar" >
-</p><!--l. 5284--><p class="noindent" >
+<!--l. 5305--><p class="nopar" >
+</p><!--l. 5307--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1000002.8"></a><a
+ id="x1-1010002.8"></a><a
id="pkgopt:footnote"></a><span
class="cmss-10">footnote</span></h4>
-<!--l. 5284--><p class="noindent" >This option changes the definition of <span
+<!--l. 5307--><p class="noindent" >This option changes the definition of <span
class="cmtt-10">\newacronym</span><a
- id="dx1-100001"></a> and the way that acronyms are displayed. This option may
+ id="dx1-101001"></a> and the way that acronyms are displayed. This option may
be replaced by:
</p>
- <pre class="verbatim" id="verbatim-127">
+ <pre class="verbatim" id="verbatim-129">
\setacronymstyle{footnote}
</pre>
-<!--l. 5289--><p class="nopar" > or (with <span
+<!--l. 5312--><p class="nopar" > or (with <span
class="cmss-10">smallcaps</span><a
- id="dx1-100002"></a>)
+ id="dx1-101002"></a>)
</p>
- <pre class="verbatim" id="verbatim-128">
+ <pre class="verbatim" id="verbatim-130">
\setacronymstyle{footnote-sc}
</pre>
-<!--l. 5293--><p class="nopar" > or (with <span
+<!--l. 5316--><p class="nopar" > or (with <span
class="cmss-10">smaller</span><a
- id="dx1-100003"></a>)
+ id="dx1-101003"></a>)
</p>
- <pre class="verbatim" id="verbatim-129">
+ <pre class="verbatim" id="verbatim-131">
\setacronymstyle{footnote-sm}
</pre>
-<!--l. 5297--><p class="nopar" > or (with <span
+<!--l. 5320--><p class="nopar" > or (with <span
class="cmss-10">description</span><a
- id="dx1-100004"></a>)
+ id="dx1-101004"></a>)
</p>
- <pre class="verbatim" id="verbatim-130">
+ <pre class="verbatim" id="verbatim-132">
\setacronymstyle{footnote-desc}
</pre>
-<!--l. 5301--><p class="nopar" > or (with <span
+<!--l. 5324--><p class="nopar" > or (with <span
class="cmss-10">smallcaps</span><a
- id="dx1-100005"></a> and <span
+ id="dx1-101005"></a> and <span
class="cmss-10">description</span><a
- id="dx1-100006"></a>)
+ id="dx1-101006"></a>)
</p>
- <pre class="verbatim" id="verbatim-131">
+ <pre class="verbatim" id="verbatim-133">
\setacronymstyle{footnote-sc-desc}
</pre>
-<!--l. 5305--><p class="nopar" > or (with <span
+<!--l. 5328--><p class="nopar" > or (with <span
class="cmss-10">smaller</span><a
- id="dx1-100007"></a> and <span
+ id="dx1-101007"></a> and <span
class="cmss-10">description</span><a
- id="dx1-100008"></a>)
+ id="dx1-101008"></a>)
</p>
- <pre class="verbatim" id="verbatim-132">
+ <pre class="verbatim" id="verbatim-134">
\setacronymstyle{footnote-sm-desc}
</pre>
-<!--l. 5309--><p class="nopar" >
-</p><!--l. 5311--><p class="noindent" >
+<!--l. 5332--><p class="nopar" >
+</p><!--l. 5334--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1010002.8"></a><a
+ id="x1-1020002.8"></a><a
id="pkgopt:dua"></a><span
class="cmss-10">dua</span></h4>
-<!--l. 5311--><p class="noindent" >This option changes the definition of <span
+<!--l. 5334--><p class="noindent" >This option changes the definition of <span
class="cmtt-10">\newacronym</span><a
- id="dx1-101001"></a> so that acronyms are always expanded. This option may be
+ id="dx1-102001"></a> so that acronyms are always expanded. This option may be
replaced by:
</p>
- <pre class="verbatim" id="verbatim-133">
+ <pre class="verbatim" id="verbatim-135">
\setacronymstyle{dua}
</pre>
-<!--l. 5316--><p class="nopar" > or (with <span
+<!--l. 5339--><p class="nopar" > or (with <span
class="cmss-10">description</span><a
- id="dx1-101002"></a>)
+ id="dx1-102002"></a>)
</p>
- <pre class="verbatim" id="verbatim-134">
+ <pre class="verbatim" id="verbatim-136">
\setacronymstyle{dua-desc}
</pre>
-<!--l. 5320--><p class="nopar" >
-</p><!--l. 5322--><p class="noindent" >
+<!--l. 5343--><p class="nopar" >
+</p><!--l. 5345--><p class="noindent" >
</p>
-<!--l. 5322--><p class="noindent" ><a
+<!--l. 5345--><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. 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" >
+<!--l. 5348--><p class="noindent" >Other available options that don’t fit any of the above categories are described below.
+</p><!--l. 5351--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1030002.9"></a><span id="textcolor251"><a
+ id="x1-1040002.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. 5330--><p class="noindent" >Load the <span
+<!--l. 5353--><p class="noindent" >Load the <span
class="cmss-10">glossaries-accsupp</span><a
- id="dx1-103001"></a> package.
-</p><!--l. 5332--><p class="noindent" >
+ id="dx1-104001"></a> package.
+</p><!--l. 5355--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1040002.9"></a><span id="textcolor253"><a
+ id="x1-1050002.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. 5334--><p class="noindent" >Load the <span
+<!--l. 5357--><p class="noindent" >Load the <span
class="cmss-10">glossaries-prefix</span><a
- id="dx1-104001"></a> package.
-</p><!--l. 5336--><p class="noindent" >
+ id="dx1-105001"></a> package.
+</p><!--l. 5359--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1050002.9"></a><span id="textcolor255"><a
+ id="x1-1060002.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
@@ -12044,43 +12083,43 @@
class="cmtt-10">{</span>⟨<span
class="cmssi-10">boolean</span>⟩<span
class="cmtt-10">} </span>(glossaries-extra.sty)</span></h4>
-<!--l. 5338--><p class="noindent" >This option may be used to suppress the boilerplate text generated by <span
+<!--l. 5361--><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. 5341--><p class="noindent" >
+</p><!--l. 5364--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1060002.9"></a><a
+ id="x1-1070002.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. 5341--><p class="noindent" >Compatibility mode for old documents created using version 2.07 or below.
+<!--l. 5364--><p class="noindent" >Compatibility mode for old documents created using version 2.07 or below.
-</p><!--l. 5344--><p class="noindent" >
+</p><!--l. 5367--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1070002.9"></a><a
+ id="x1-1080002.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. 5344--><p class="noindent" >Compatibility mode for old documents created using version 3.07 or below.
-</p><!--l. 5347--><p class="noindent" >
+<!--l. 5367--><p class="noindent" >Compatibility mode for old documents created using version 3.07 or below.
+</p><!--l. 5370--><p class="noindent" >
</p>
<h4 class="likesubsectionHead"><a
- id="x1-1080002.9"></a><a
+ id="x1-1090002.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. 5347--><p class="noindent" >As a legacy from the precursor <span
+<!--l. 5370--><p class="noindent" >As a legacy from the precursor <span
class="cmss-10">glossary</span><a
- id="dx1-108001"></a> package, the standard glossary commands provided by the LaTeX kernel
+ id="dx1-109001"></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
@@ -12088,9 +12127,9 @@
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. 5356--><p class="indent" > The use of those kernel commands (instead of the appropriate commands documented in this user guide) are
+</p><!--l. 5379--><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. 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
+</p><!--l. 5383--><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
@@ -12099,19 +12138,19 @@
class="cmss-10">kernelglossredefs</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-108002"></a>. You may also need to use the <span
+ id="dx1-109002"></a>. You may also need to use the <span
class="cmss-10">nomain</span><a
- id="dx1-108003"></a> option in the event of file
+ id="dx1-109003"></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-108004"></a>
+ id="dx1-109004"></a>
package.)
-</p><!--l. 5371--><p class="indent" > This option may take one of three values: <span
+</p><!--l. 5394--><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. 5376--><p class="indent" > The only glossary-related commands provided by the LaTeX kernel are <span
+</p><!--l. 5399--><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
@@ -12119,103 +12158,103 @@
class="cmss-10">glossaries </span>(such as <span
class="cmtt-10">\printglossary </span>and <span
class="cmss-10">theglossary</span><a
- id="dx1-108005"></a><a
- id="dx1-108006"></a>). These non-kernel commands aren’t affected by this
+ id="dx1-109005"></a><a
+ id="dx1-109006"></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-108007"></a> package will override the existing definitions of <span
+ id="dx1-109007"></a> package will override the existing definitions of <span
class="cmtt-10">\printglossary </span>and
<span
class="cmss-10">theglossary</span><a
- 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
+ id="dx1-109008"></a><a
+ id="dx1-109009"></a>.)
+</p><!--l. 5409--><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-108010"></a> package and patches <span
+ id="dx1-109010"></a> package and patches <span
class="cmtt-10">\PrintChanges</span>.)
-</p><!--l. 5390--><p class="noindent" >
+</p><!--l. 5413--><p class="noindent" >
</p>
-<!--l. 5390--><p class="noindent" ><a
+<!--l. 5413--><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. 5393--><p class="noindent" >Some of the options described above may also be set after the <span
+<!--l. 5416--><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. 5395--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-109001"></a> <span
+</p><!--l. 5418--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-110001"></a> <span
class="cmtt-10">\setupglossaries{</span>⟨<span
class="cmitt-10">key-val list</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 5397--><p class="noindent" >
+</p><!--l. 5420--><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-109002"></a>, <span
+ id="dx1-110002"></a>, <span
class="cmss-10">xindygloss</span><a
- id="dx1-109003"></a>, <span
+ id="dx1-110003"></a>, <span
class="cmss-10">xindynoglsnumbers</span><a
- id="dx1-109004"></a>,
+ id="dx1-110004"></a>,
<span
class="cmss-10">makeindex</span><a
- id="dx1-109005"></a>, <span
+ id="dx1-110005"></a>, <span
class="cmss-10">nolong</span><a
- id="dx1-109006"></a>, <span
+ id="dx1-110006"></a>, <span
class="cmss-10">nosuper</span><a
- id="dx1-109007"></a>, <span
+ id="dx1-110007"></a>, <span
class="cmss-10">nolist</span><a
- id="dx1-109008"></a>, <span
+ id="dx1-110008"></a>, <span
class="cmss-10">notree</span><a
- id="dx1-109009"></a>, <span
+ id="dx1-110009"></a>, <span
class="cmss-10">nostyles</span><a
- id="dx1-109010"></a>, <span
+ id="dx1-110010"></a>, <span
class="cmss-10">nomain</span><a
- id="dx1-109011"></a>, <span
+ id="dx1-110011"></a>, <span
class="cmss-10">compatible-2.07</span><a
- id="dx1-109012"></a>, <span
+ id="dx1-110012"></a>, <span
class="cmss-10">translate</span><a
- id="dx1-109013"></a>, <span
+ id="dx1-110013"></a>, <span
class="cmss-10">notranslate</span><a
- id="dx1-109014"></a>, <span
+ id="dx1-110014"></a>, <span
class="cmss-10">acronym</span><a
- id="dx1-109015"></a>. These
+ id="dx1-110015"></a>. These
options have to be set while the package is loading, except for the <span
class="cmss-10">xindy</span><a
- id="dx1-109016"></a> sub-options which can
+ id="dx1-110016"></a> sub-options which can
be set using commands like <span
class="cmtt-10">\GlsSetXdyLanguage</span><a
- id="dx1-109017"></a> (see <a
+ id="dx1-110017"></a> (see <a
href="#sec:xindy">§<span
-class="cmbx-10">??</span>sec:xindy </a><a
+class="cmbx-10">14</span> </a><a
href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a> for further
details).
-</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
+</p><!--l. 5432--><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-109018"></a>) after you have started defining your acronyms, you are likely to get unexpected results. If you try
+ id="dx1-110018"></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. 5417--><p class="noindent" >
-</p><!--l. 5419--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a
+</p><!--l. 5440--><p class="noindent" >
+</p><!--l. 5442--><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" >
+ id="dx1-110019"></a> instead. </div>
+</p><!--l. 5445--><p class="noindent" >
</p>
-<!--l. 5424--><p class="indent" > </div>
-</p><!--l. 5424--><p class="noindent" ><a
+<!--l. 5447--><p class="indent" > </div>
+</p><!--l. 5447--><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. 5427--><p class="indent" > In the preamble you need to indicate which method you want to use to generate the glossary
+</p><!--l. 5450--><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
@@ -12222,7 +12261,7 @@
class="cmss-10">glossaries-extra</span></a> are summarized in
<a
href="#sec:indexingoptions">§<span
-class="cmbx-10">??</span>sec:indexingoptions </a><a
+class="cmbx-10">1.2</span> </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
@@ -12231,54 +12270,54 @@
class="cmss-10">glossaries-extra</span></a> and <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-110001"></a></a> manuals for the full documentation of the other
+ id="dx1-111001"></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
+</p><!--l. 5458--><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
+class="cmbx-10">4</span> </a><a
href="#sec:newglosentry">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>.
</p>
-<!--l. 5439--><p class="noindent" ><a
+<!--l. 5462--><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. 5442--><p class="noindent" >The command
-</p><!--l. 5443--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-111001"></a> <span
+<!--l. 5465--><p class="noindent" >The command
+</p><!--l. 5466--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-112001"></a> <span
class="cmtt-10">\makenoidxglossaries </span></div><hr>
-</p><!--l. 5445--><p class="noindent" >
+</p><!--l. 5468--><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. 5451--><p class="noindent" >
+</p><!--l. 5474--><p class="noindent" >
</p>
-<!--l. 5451--><p class="noindent" ><a
+<!--l. 5474--><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. 5454--><p class="noindent" >The command
-</p><!--l. 5455--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-112001"></a> <span
+<!--l. 5477--><p class="noindent" >The command
+</p><!--l. 5478--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-113001"></a> <span
class="cmtt-10">\makeglossaries </span></div><hr>
-</p><!--l. 5457--><p class="noindent" >
+</p><!--l. 5480--><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-112002"></a></a> (<span
+ id="dx1-113002"></a></a> (<span
class="cmtt-10">ist</span><a
- id="dx1-112003"></a>) or <a
+ id="dx1-113003"></a>) or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-112004"></a></a> (<span
+ id="dx1-113004"></a></a> (<span
class="cmtt-10">xdy</span><a
- id="dx1-112005"></a>) style file (for
+ id="dx1-113005"></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. 5465--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you are using <a
+</p><!--l. 5488--><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
@@ -12290,8 +12329,8 @@
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> manual for further details.
</div>
-</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
+</p><!--l. 5492--><p class="noindent" >
+</p><!--l. 5495--><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
@@ -12299,122 +12338,122 @@
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. 5480--><p class="indent" > You can suppress the creation of the customised <a
+</p><!--l. 5503--><p class="indent" > You can suppress the creation of the customised <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-112006"></a></a> or <a
+ id="dx1-113006"></a></a> or <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-112007"></a></a> style file using
-</p><!--l. 5482--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-112008"></a> <span
+ id="dx1-113007"></a></a> style file using
+</p><!--l. 5505--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-113008"></a> <span
class="cmtt-10">\noist </span></div><hr>
-</p><!--l. 5484--><p class="noindent" >
+</p><!--l. 5507--><p class="noindent" >
That this command must not be used after <span
class="cmtt-10">\makeglossaries</span>.
-</p><!--l. 5486--><p class="indent" > <div class="important" title="Important Note"> Note that if you have a custom <span
+</p><!--l. 5509--><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-112009"></a> file created when using <span
+ id="dx1-113009"></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-112010"></a> package option with it. </div>
+ id="dx1-113010"></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
+</p><!--l. 5513--><p class="noindent" >
+</p><!--l. 5515--><p class="indent" > The default name for the customised style file is given by <span
class="cmtt-10">\jobname</span><a
- id="dx1-112011"></a><span
+ id="dx1-113011"></a><span
class="cmtt-10">.ist</span><a
- id="dx1-112012"></a> (<a
+ id="dx1-113012"></a> (<a
href="#option2">Option 2</a>) or <span
class="cmtt-10">\jobname</span><a
- id="dx1-112013"></a><span
+ id="dx1-113013"></a><span
class="cmtt-10">.xdy</span><a
- id="dx1-112014"></a>
+ id="dx1-113014"></a>
(<a
href="#option3">Option 3</a>). This name may be changed using:
-</p><!--l. 5496--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-112015"></a> <span
+</p><!--l. 5519--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-113015"></a> <span
class="cmtt-10">\setStyleFile{</span>⟨<span
class="cmitt-10">name</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 5498--><p class="noindent" >
+</p><!--l. 5521--><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. 5503--><p class="indent" > Each glossary entry is assigned a <a
+</p><!--l. 5526--><p class="indent" > Each glossary entry is assigned a <a
href="#glo:numberlist">number list<a
- id="dx1-112016"></a></a> that lists all the locations in the document where that entry
+ id="dx1-113016"></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-112017"></a> package option. The default form of the location number assumes a full stop compositor
+ id="dx1-113017"></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. 5510--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-112018"></a> <span
+</p><!--l. 5533--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-113018"></a> <span
class="cmtt-10">\glsSetCompositor{</span>⟨<span
class="cmitt-10">symbol</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 5512--><p class="noindent" >
+</p><!--l. 5535--><p class="noindent" >
For example:
</p>
- <pre class="verbatim" id="verbatim-135">
+ <pre class="verbatim" id="verbatim-137">
\glsSetCompositor{-}
</pre>
-<!--l. 5516--><p class="nopar" > This command must not be used after <span
+<!--l. 5539--><p class="nopar" > This command must not be used after <span
class="cmtt-10">\makeglossaries</span>.
-</p><!--l. 5519--><p class="indent" > If you use <a
+</p><!--l. 5542--><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. 5521--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-112019"></a> <span
+</p><!--l. 5544--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-113019"></a> <span
class="cmtt-10">\glsSetAlphaCompositor{</span>⟨<span
class="cmitt-10">symbol</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 5523--><p class="noindent" >
+</p><!--l. 5546--><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-112020"></a>s</a> containing a mixture of
+ id="dx1-113020"></a>s</a> containing a mixture of
A-1 and 2.3 style formats, then do:
</p>
- <pre class="verbatim" id="verbatim-136">
+ <pre class="verbatim" id="verbatim-138">
\glsSetCompositor{.}\glsSetAlphaCompositor{-}
</pre>
-<!--l. 5529--><p class="nopar" > See <a
+<!--l. 5552--><p class="nopar" > See <a
href="#sec:numberlists">§<span
-class="cmbx-10">??</span>sec:numberlists </a><a
+class="cmbx-10">12</span> </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-112021"></a>s</a>.
+ id="dx1-113021"></a>s</a>.
</p>
-<!--l. 5533--><p class="indent" > </div>
-</p><!--l. 5533--><p class="noindent" ><a
+<!--l. 5556--><p class="indent" > </div>
+</p><!--l. 5556--><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. 5536--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> If you want to use <a
+</p><!--l. 5559--><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
+ id="dx1-114001"></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
+ id="dx1-114002"></a> files using the syntax described in the <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-113003"></a></a>
+ id="dx1-114003"></a></a>
user manual. </div>
-</p><!--l. 5540--><p class="noindent" >
-</p><!--l. 5542--><p class="indent" > Acronyms are covered in <a
+</p><!--l. 5563--><p class="noindent" >
+</p><!--l. 5565--><p class="indent" > Acronyms are covered in <a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </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
@@ -12422,15 +12461,15 @@
class="cmtt-10">\newacronym</span>, although some of them,
such as <span
class="cmtt-10">first</span><a
- id="dx1-113004"></a> and <span
+ id="dx1-114004"></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
+ id="dx1-114005"></a>, interfere with the acronym styles.
+</p><!--l. 5572--><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
+class="cmbx-10">4.8</span> </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
@@ -12438,48 +12477,48 @@
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
+class="cmbx-10">4.8</span> </a><a
href="#sec:docdefs">Drawbacks With Defining Entries in the Document
Environment<!--tex4ht:ref: sec:docdefs --></a>.)
-</p><!--l. 5558--><p class="indent" > <div class="important" title="Important Note"> <a
+</p><!--l. 5581--><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-113006"></a>. <a
+ id="dx1-114006"></a>. <a
href="#option4">Option 4</a> requires that definitions
are provided in <span
class="cmtt-10">bib</span><a
- id="dx1-113007"></a> format. <a
+ id="dx1-114007"></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. 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
+</p><!--l. 5587--><p class="noindent" >
+</p><!--l. 5589--><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
+class="cmbx-10">5.1</span>
</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
+class="cmbx-10">10</span> </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
+class="cmbx-10">11</span> </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
+class="cmbx-10">8</span> </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
+</p><!--l. 5597--><p class="indent" > New glossary entries are defined using the command:
+</p><!--l. 5598--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-114008"></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. 5577--><p class="noindent" >
+</p><!--l. 5600--><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
@@ -12486,9 +12525,9 @@
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. 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
+</p><!--l. 5606--><p class="indent" > If you have a long description that needs to span multiple paragraphs, use
+</p><!--l. 5608--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-114009"></a> <span
class="cmtt-10">\longnewglossaryentry{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -12496,7 +12535,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">long description</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 5588--><p class="noindent" >
+</p><!--l. 5611--><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
@@ -12510,18 +12549,18 @@
doesn’t append either <span
class="cmtt-10">\unskip </span>or <span
class="cmtt-10">\nopostdesc</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
+</p><!--l. 5621--><p class="indent" > There are also commands that will only define the entry if it hasn’t already been defined:
+</p><!--l. 5623--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-114010"></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. 5602--><p class="noindent" >
+</p><!--l. 5625--><p class="noindent" >
and
-</p><!--l. 5604--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-113011"></a> <span
+</p><!--l. 5627--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-114011"></a> <span
class="cmtt-10">\longprovideglossaryentry{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -12531,9 +12570,9 @@
class="cmtt-10">} </span></div><hr>
-</p><!--l. 5607--><p class="noindent" >
+</p><!--l. 5630--><p class="noindent" >
(These are both preamble-only commands.)
-</p><!--l. 5610--><p class="indent" > For all the above commands, the first argument, ⟨<span
+</p><!--l. 5633--><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
@@ -12540,189 +12579,189 @@
(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. 5618--><p class="indent" > <div class="important" title="Important Note"> Note that although an <a
+</p><!--l. 5641--><p class="indent" > <div class="important" title="Important Note"> Note that although an <a
href="#glo:exlatinchar">extended Latin character<a
- id="dx1-113012"></a></a> or other <a
+ id="dx1-114012"></a></a> or other <a
href="#glo:nonlatinchar">non-Latin character<a
- id="dx1-113013"></a></a>, such as é or
+ id="dx1-114013"></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-113014"></a>’s options that change certain punctuation characters (such as <span
+ id="dx1-114014"></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. 5626--><p class="noindent" >
-</p><!--l. 5628--><p class="indent" > The second argument, ⟨<span
+</p><!--l. 5649--><p class="noindent" >
+</p><!--l. 5651--><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-113015"></a> and either <span
+ id="dx1-114015"></a> and either <span
class="cmtt-10">name</span><a
- id="dx1-113016"></a> or <span
+ id="dx1-114016"></a> or <span
class="cmtt-10">parent</span><a
- id="dx1-113017"></a>. The description is set in the third
+ id="dx1-114017"></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-113018"></a> key. As is typical with ⟨<span
+ id="dx1-114018"></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="cmss-10">glossaries-prefix</span><a
- id="dx1-113019"></a> (<a
+ id="dx1-114019"></a> (<a
href="#sec:prefix">§<span
-class="cmbx-10">??</span>sec:prefix </a><a
+class="cmbx-10">16</span> </a><a
href="#sec:prefix">Prefixes or Determiners<!--tex4ht:ref: sec:prefix --></a>) and <span
class="cmss-10">glossaries-accsupp</span><a
- id="dx1-113020"></a> (<a
+ id="dx1-114020"></a> (<a
href="#sec:accsupp">§<span
-class="cmbx-10">??</span>sec:accsupp
+class="cmbx-10">17</span>
</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">§<span
-class="cmbx-10">??</span>sec:addkey
+class="cmbx-10">4.3</span>
</a><a
href="#sec:addkey">Additional Keys<!--tex4ht:ref: sec:addkey --></a>).
</p><dl class="description"><dt class="description">
- <!--l. 5645--><p class="noindent" >
+ <!--l. 5668--><p class="noindent" >
<span
class="cmtt-10">name</span><a
- id="dx1-113021"></a> </p></dt><dd
+ id="dx1-114021"></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
+ <!--l. 5668--><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-113022"></a> key
+ id="dx1-114022"></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
+ </p><!--l. 5672--><p class="noindent" ><div class="important" title="Important Note"> If the <span
class="cmtt-10">name</span><a
- id="dx1-113023"></a> key contains any commands, you must also use the <span
+ id="dx1-114023"></a> key contains any commands, you must also use the <span
class="cmtt-10">sort</span><a
- id="dx1-113024"></a> key (described below) if
+ id="dx1-114024"></a> key (described below) if
you intend sorting the entries alphabetically, otherwise the entries can’t be sorted correctly.
</div>
- </p><!--l. 5653--><p class="noindent" >
+ </p><!--l. 5676--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 5655--><p class="noindent" >
+ <!--l. 5678--><p class="noindent" >
<span
class="cmtt-10">description</span><a
- id="dx1-113025"></a> </p></dt><dd
+ id="dx1-114025"></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
+ <!--l. 5678--><p class="noindent" >A brief description of this term (to appear in the glossary). Within this value, you can use:
+ </p><!--l. 5680--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-114026"></a> <span
class="cmtt-10">\nopostdesc </span></div><hr>
- </p><!--l. 5659--><p class="noindent" >
+ </p><!--l. 5682--><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. 5665--><p class="noindent" ><hr><div title="Definition"><a
- id="dx1-113027"></a> <span
+ </p><!--l. 5688--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-114027"></a> <span
class="cmtt-10">\glspar </span></div><hr>
- </p><!--l. 5667--><p class="noindent" >
+ </p><!--l. 5690--><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-113028"></a> not <span class="obeylines-h"><span class="verb"><span
+ id="dx1-114028"></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. 5674--><p class="noindent" ><div title="glossaries-extra.sty" style="border: solid 2pt green;"> With <a
+ </p><!--l. 5697--><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="textcolor258"><span
class="cmtt-10">\glsxtrnopostpunc</span></span><a
- id="dx1-113029"></a> instead of <span
+ id="dx1-114029"></a> instead of <span
class="cmtt-10">\nopostdesc </span>to suppress the post-description
punctuation. </div>
- </p><!--l. 5677--><p class="noindent" >
+ </p><!--l. 5700--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 5679--><p class="noindent" >
+ <!--l. 5702--><p class="noindent" >
<span
class="cmtt-10">parent</span><a
- id="dx1-113030"></a> </p></dt><dd
+ id="dx1-114030"></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
+ <!--l. 5702--><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
+class="cmbx-10">4.5</span> </a><a
href="#sec:subentries">Sub-Entries<!--tex4ht:ref: sec:subentries --></a> for further details.
</p></dd><dt class="description">
- <!--l. 5683--><p class="noindent" >
+ <!--l. 5706--><p class="noindent" >
<span
class="cmtt-10">descriptionplural</span><a
- id="dx1-113031"></a> </p></dt><dd
+ id="dx1-114031"></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
+ <!--l. 5706--><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-113032"></a>
+ id="dx1-114032"></a>
key.
</p></dd><dt class="description">
- <!--l. 5687--><p class="noindent" >
+ <!--l. 5710--><p class="noindent" >
<span
class="cmtt-10">text</span><a
- id="dx1-113033"></a> </p></dt><dd
+ id="dx1-114033"></a> </p></dt><dd
class="description">
- <!--l. 5687--><p class="noindent" >How this entry will appear in the document text when using <span
+ <!--l. 5710--><p class="noindent" >How this entry will appear in the document text when using <span
class="cmtt-10">\gls</span><a
- id="dx1-113034"></a> (or one of its upper case variants). If
+ id="dx1-114034"></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-113035"></a> key is used.
- </p><!--l. 5691--><p class="noindent" >This key is automatically set by <span
+ id="dx1-114035"></a> key is used.
+ </p><!--l. 5714--><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
+ id="dx1-114036"></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" >
+ <!--l. 5719--><p class="noindent" >
<span
class="cmtt-10">first</span><a
- id="dx1-113037"></a> </p></dt><dd
+ id="dx1-114037"></a> </p></dt><dd
class="description">
- <!--l. 5696--><p class="noindent" >How the entry will appear in the document text on <a
+ <!--l. 5719--><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-113038"></a> (or one of its upper
+ id="dx1-114038"></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-113039"></a> key is used. Note that if you use
+ id="dx1-114039"></a> key is used. Note that if you use
<span
class="cmtt-10">\glspl</span><a
- id="dx1-113040"></a>, <span
+ id="dx1-114040"></a>, <span
class="cmtt-10">\Glspl</span><a
- id="dx1-113041"></a>, <span
+ id="dx1-114041"></a>, <span
class="cmtt-10">\GLSpl</span><a
- id="dx1-113042"></a>, <span
+ id="dx1-114042"></a>, <span
class="cmtt-10">\glsdisp</span><a
- id="dx1-113043"></a> before using <span
+ id="dx1-114043"></a> before using <span
class="cmtt-10">\gls</span><a
- id="dx1-113044"></a>, the <span
+ id="dx1-114044"></a>, the <span
class="cmtt-10">first</span><a
- id="dx1-113045"></a> value won’t be used with
+ id="dx1-114045"></a> value won’t be used with
<span
class="cmtt-10">\gls</span><a
- id="dx1-113046"></a>.
- </p><!--l. 5703--><p class="noindent" >You may prefer to use abbreviations (<a
+ id="dx1-114046"></a>.
+ </p><!--l. 5726--><p class="noindent" >You may prefer to use abbreviations (<a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </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
+ id="dx1-114047"></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
@@ -12730,151 +12769,151 @@
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
+ </p><!--l. 5733--><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
+ id="dx1-114048"></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" >
+ <!--l. 5737--><p class="noindent" >
<span
class="cmtt-10">plural</span><a
- id="dx1-113049"></a> </p></dt><dd
+ id="dx1-114049"></a> </p></dt><dd
class="description">
- <!--l. 5714--><p class="noindent" >How the entry will appear in the document text when using <span
+ <!--l. 5737--><p class="noindent" >How the entry will appear in the document text when using <span
class="cmtt-10">\glspl</span><a
- id="dx1-113050"></a> (or one of its upper case variants). If
+ id="dx1-114050"></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-113051"></a> to the value of the <span
+ id="dx1-114051"></a> to the value of the <span
class="cmtt-10">text</span><a
- id="dx1-113052"></a> field.
+ id="dx1-114052"></a> field.
The default value of <span
class="cmtt-10">\glspluralsuffix</span><a
- id="dx1-113053"></a> is the letter “s”.
- </p><!--l. 5720--><p class="noindent" >Although it is possible to use <span
+ id="dx1-114053"></a> is the letter “s”.
+ </p><!--l. 5743--><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
+ id="dx1-114054"></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
+ id="dx1-114055"></a> instead, if the default value is
inappropriate.
</p></dd><dt class="description">
- <!--l. 5725--><p class="noindent" >
+ <!--l. 5748--><p class="noindent" >
<span
class="cmtt-10">firstplural</span><a
- id="dx1-113056"></a> </p></dt><dd
+ id="dx1-114056"></a> </p></dt><dd
class="description">
- <!--l. 5725--><p class="noindent" >How the entry will appear in the document text on <a
+ <!--l. 5748--><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-113057"></a> (or one of its upper case
+ id="dx1-114057"></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-113058"></a> key, if the <span
+ id="dx1-114058"></a> key, if the <span
class="cmtt-10">first</span><a
- id="dx1-113059"></a> key is omitted, or
+ id="dx1-114059"></a> key is omitted, or
by appending <span
class="cmtt-10">\glspluralsuffix</span><a
- id="dx1-113060"></a> to the value of the <span
+ id="dx1-114060"></a> to the value of the <span
class="cmtt-10">first</span><a
- id="dx1-113061"></a> field, if the <span
+ id="dx1-114061"></a> field, if the <span
class="cmtt-10">first</span><a
- id="dx1-113062"></a> field is present. Note that if
+ id="dx1-114062"></a> field is present. Note that if
you use <span
class="cmtt-10">\gls</span><a
- id="dx1-113063"></a>, <span
+ id="dx1-114063"></a>, <span
class="cmtt-10">\Gls</span><a
- id="dx1-113064"></a>, <span
+ id="dx1-114064"></a>, <span
class="cmtt-10">\GLS</span><a
- id="dx1-113065"></a>, <span
+ id="dx1-114065"></a>, <span
class="cmtt-10">\glsdisp </span>before using <span
class="cmtt-10">\glspl</span><a
- id="dx1-113066"></a>, the <span
+ id="dx1-114066"></a>, the <span
class="cmtt-10">firstplural</span><a
- id="dx1-113067"></a> value won’t be used with
+ id="dx1-114067"></a> value won’t be used with
<span
class="cmtt-10">\glspl</span><a
- id="dx1-113068"></a>.
- </p><!--l. 5735--><p class="noindent" >Although it is possible to use <span
+ id="dx1-114068"></a>.
+ </p><!--l. 5758--><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
+ id="dx1-114069"></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
+ id="dx1-114070"></a> and <span
class="cmtt-10">longplural</span><a
- id="dx1-113071"></a> instead, if the default
+ id="dx1-114071"></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
+ </p><!--l. 5764--><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-113072"></a> was always taken by appending “s” to the
+ id="dx1-114072"></a> was always taken by appending “s” to the
<span
class="cmtt-10">first</span><a
- id="dx1-113073"></a> key, which meant that you had to specify both <span
+ id="dx1-114073"></a> key, which meant that you had to specify both <span
class="cmtt-10">plural</span><a
- id="dx1-113074"></a> and <span
+ id="dx1-114074"></a> and <span
class="cmtt-10">firstplural</span><a
- id="dx1-113075"></a>, even if you hadn’t used
+ id="dx1-114075"></a>, even if you hadn’t used
the <span
class="cmtt-10">first</span><a
- id="dx1-113076"></a> key.
+ id="dx1-114076"></a> key.
</p></dd><dt class="description">
- <!--l. 5747--><p class="noindent" >
+ <!--l. 5770--><p class="noindent" >
<span
class="cmtt-10">symbol</span><a
- id="dx1-113077"></a> </p></dt><dd
+ id="dx1-114077"></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
+ <!--l. 5770--><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.
</p></dd><dt class="description">
- <!--l. 5751--><p class="noindent" >
+ <!--l. 5774--><p class="noindent" >
<span
class="cmtt-10">symbolplural</span><a
- id="dx1-113078"></a> </p></dt><dd
+ id="dx1-114078"></a> </p></dt><dd
class="description">
- <!--l. 5751--><p class="noindent" >This is the plural form of the symbol (as passed to <span
+ <!--l. 5774--><p class="noindent" >This is the plural form of the symbol (as passed to <span
class="cmtt-10">\glsdisplay</span><a
- id="dx1-113079"></a> and <span
+ id="dx1-114079"></a> and <span
class="cmtt-10">\glsdisplayfirst</span><a
- id="dx1-113080"></a> by <span
+ id="dx1-114080"></a> by <span
class="cmtt-10">\glspl</span><a
- id="dx1-113081"></a>,
+ id="dx1-114081"></a>,
<span
class="cmtt-10">\Glspl</span><a
- id="dx1-113082"></a> and <span
+ id="dx1-114082"></a> and <span
class="cmtt-10">\GLSpl</span><a
- id="dx1-113083"></a>). If omitted, the value is set to the same as the <span
+ id="dx1-114083"></a>). If omitted, the value is set to the same as the <span
class="cmtt-10">symbol</span><a
- id="dx1-113084"></a> key.
+ id="dx1-114084"></a> key.
</p></dd><dt class="description">
- <!--l. 5756--><p class="noindent" >
+ <!--l. 5779--><p class="noindent" >
<span
class="cmtt-10">sort</span><a
- id="dx1-113085"></a> </p></dt><dd
+ id="dx1-114085"></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,
+ <!--l. 5779--><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-113086"></a> field unless one of the package options <span
+ id="dx1-114086"></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-113087"></a> and <span
+ id="dx1-114087"></a> and <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">use</span><a
- id="dx1-113088"></a> have been used.
+ id="dx1-114088"></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-113089"></a> key if the <span
+ id="dx1-114089"></a> key if the <span
class="cmtt-10">name</span><a
- id="dx1-113090"></a> contains commands (e.g. <span class="obeylines-h"><span class="verb"><span
+ id="dx1-114090"></a> contains commands (e.g. <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">\ensuremath{\alpha}</span></span></span>)
@@ -12882,52 +12921,52 @@
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
+ </p><!--l. 5788--><p class="noindent" >You can also override the <span
class="cmtt-10">sort</span><a
- id="dx1-113091"></a> key by redefining <span
+ id="dx1-114091"></a> key by redefining <span
class="cmtt-10">\glsprestandardsort</span><a
- id="dx1-113092"></a> (see <a
+ id="dx1-114092"></a> (see <a
href="#sec:pkgopts-sort">§<span
-class="cmbx-10">??</span>sec:pkgopts-sort </a><a
+class="cmbx-10">2.5</span> </a><a
href="#sec:pkgopts-sort">Sorting
Options<!--tex4ht:ref: sec:pkgopts-sort --></a>).
- </p><!--l. 5768--><p class="noindent" ><div title="bib2gls" style="border: solid 2pt green;"> The <span
+ </p><!--l. 5791--><p class="noindent" ><div title="bib2gls" style="border: solid 2pt green;"> The <span
class="cmtt-10">sort</span><a
- id="dx1-113093"></a> key shouldn’t be used with <a
+ id="dx1-114093"></a> key shouldn’t be used with <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-113094"></a></a>. It has a system of fallbacks that allow different types of
+ id="dx1-114094"></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-113095"></a></a> manual for further details
+ id="dx1-114095"></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. 5774--><p class="noindent" >
- </p><!--l. 5776--><p class="noindent" ><a
+ </p><!--l. 5797--><p class="noindent" >
+ </p><!--l. 5799--><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-113096"></a> key when it sets the <span
+ id="dx1-114096"></a> key when it sets the <span
class="cmtt-10">sort</span><a
- id="dx1-113097"></a> key. So with <a
+ id="dx1-114097"></a> key. So with <a
href="#option1">Option 1</a>:
</p>
- <pre class="verbatim" id="verbatim-137">
+ <pre class="verbatim" id="verbatim-139">
\newglossaryentry{elite}{%
  name={{\'e}lite},
  description={select group of people}
}
</pre>
- <!--l. 5785--><p class="nopar" > This is equivalent to:
+ <!--l. 5808--><p class="nopar" > This is equivalent to:
</p>
- <pre class="verbatim" id="verbatim-138">
+ <pre class="verbatim" id="verbatim-140">
\newglossaryentry{elite}{%
  name={{\'e}lite},
  description={select group of people},
@@ -12934,15 +12973,15 @@
  sort={elite}
}
</pre>
- <!--l. 5793--><p class="nopar" > Unless you use the package option <span
+ <!--l. 5816--><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-113098"></a>, in which case it’s equivalent to:
+ id="dx1-114098"></a>, in which case it’s equivalent to:
</p>
- <pre class="verbatim" id="verbatim-139">
+ <pre class="verbatim" id="verbatim-141">
\newglossaryentry{elite}{%
  name={{\'e}lite},
  description={select group of people},
@@ -12949,10 +12988,10 @@
  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
+ <!--l. 5825--><p class="nopar" > This will place the entry before the “A” letter group since the sort value starts with a symbol.
+ </p><!--l. 5829--><p class="noindent" >Similarly if you use the <span
class="cmss-10">inputenc</span><a
- id="dx1-113099"></a> package: </p><div class="alltt">
+ id="dx1-114099"></a> package: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry{elite}{%</span>
@@ -12995,7 +13034,7 @@
class="cmss-10">sanitizesort</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-113100"></a>, in which case it’s equivalent to: <div class="alltt">
+ id="dx1-114100"></a>, in which case it’s equivalent to: <div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry{elite}{%</span>
@@ -13019,129 +13058,129 @@
class="cmtt-10">}</span>
</div>
</div> Again, this will place the entry before the “A” group.
- <!--l. 5832--><p class="noindent" >With Options <a
+ <!--l. 5855--><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-113101"></a> will either be set to the <span
+ id="dx1-114101"></a> will either be set to the <span
class="cmtt-10">name</span><a
- id="dx1-113102"></a> key (if <span
+ id="dx1-114102"></a> key (if <span
class="cmss-10">sanitizesort</span><span
class="cmtt-10">=</span><span
class="cmss-10">true</span><a
- id="dx1-113103"></a>) or
+ id="dx1-114103"></a>) or
it will set it to the expansion of the <span
class="cmtt-10">name</span><a
- id="dx1-113104"></a> key (if <span
+ id="dx1-114104"></a> key (if <span
class="cmss-10">sanitizesort</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-113105"></a>).
+ id="dx1-114105"></a>).
- </p><!--l. 5837--><p class="noindent" ><div class="important" title="Important Note"> Take care with <a
+ </p><!--l. 5860--><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-113106"></a></a> (<a
+ id="dx1-114106"></a></a> (<a
href="#option3">Option 3</a>): if you have entries with the same <span
class="cmtt-10">sort</span><a
- id="dx1-113107"></a> value they will be treated as
+ id="dx1-114107"></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-113108"></a></a> and aren’t using the <span
+ id="dx1-114108"></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-113109"></a> key for entries where the name just consists of a control sequence (for example
+ id="dx1-114109"></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. 5845--><p class="noindent" >Take care if you use <a
+ </p><!--l. 5868--><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-113110"></a> contains fragile commands. You will either need to explicitly
+ id="dx1-114110"></a> contains fragile commands. You will either need to explicitly
set the <span
class="cmtt-10">sort</span><a
- id="dx1-113111"></a> key or use the <span
+ id="dx1-114111"></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-113112"></a> package option (unless you use the <span
+ id="dx1-114112"></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. 5849--><p class="noindent" >
+ </p><!--l. 5872--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 5851--><p class="noindent" >
+ <!--l. 5874--><p class="noindent" >
<span
class="cmtt-10">type</span><a
- id="dx1-113113"></a> </p></dt><dd
+ id="dx1-114113"></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
+ <!--l. 5874--><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-113114"></a> is used (see <a
+ id="dx1-114114"></a> is used (see <a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </a><a
href="#sec:acronyms">Acronyms and Other
Abbreviations<!--tex4ht:ref: sec:acronyms --></a>).
</p></dd><dt class="description">
- <!--l. 5857--><p class="noindent" >
+ <!--l. 5880--><p class="noindent" >
<span
class="cmtt-10">user1</span><a
- id="dx1-113115"></a><span
+ id="dx1-114115"></a><span
class="cmbx-10">, </span><span
class="cmbx-10">…, </span><span
class="cmtt-10">user6</span><a
- 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
+ id="dx1-114116"></a><a
+ id="dx1-114117"></a><a
+ id="dx1-114118"></a><a
+ id="dx1-114119"></a><a
+ id="dx1-114120"></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
+ <!--l. 5880--><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-113121"></a> or <span
+ id="dx1-114121"></a> or <span
class="cmtt-10">\glsaddstoragekey</span><a
- id="dx1-113122"></a> (see <a
+ id="dx1-114122"></a> (see <a
href="#sec:addkey">§<span
-class="cmbx-10">??</span>sec:addkey </a><a
+class="cmbx-10">4.3</span> </a><a
href="#sec:addkey">Additional
Keys<!--tex4ht:ref: sec:addkey --></a>).
</p></dd><dt class="description">
- <!--l. 5863--><p class="noindent" >
+ <!--l. 5886--><p class="noindent" >
<span
class="cmtt-10">nonumberlist</span><a
- id="dx1-113123"></a> </p></dt><dd
+ id="dx1-114123"></a> </p></dt><dd
class="description">
- <!--l. 5863--><p class="noindent" >A boolean key. If the value is missing or is <span
+ <!--l. 5886--><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-113124"></a></a> just for this
+ id="dx1-114124"></a></a> just for this
entry. Conversely, if you have used the package option <span
class="cmss-10">nonumberlist</span><a
- id="dx1-113125"></a>, you can activate the
+ id="dx1-114125"></a>, you can activate the
number list<a
- id="dx1-113126"></a> just for this entry with <span
+ id="dx1-114126"></a> just for this entry with <span
class="cmtt-10">nonumberlist=false</span><a
- id="dx1-113127"></a>. (See <a
+ id="dx1-114127"></a>. (See <a
href="#sec:numberlists">§<span
-class="cmbx-10">??</span>sec:numberlists </a><a
+class="cmbx-10">12</span> </a><a
href="#sec:numberlists">Number
Lists<!--tex4ht:ref: sec:numberlists --></a>.)
</p></dd><dt class="description">
- <!--l. 5870--><p class="noindent" >
+ <!--l. 5893--><p class="noindent" >
<span
class="cmtt-10">see</span><a
- id="dx1-113128"></a> </p></dt><dd
+ id="dx1-114128"></a> </p></dt><dd
class="description">
- <!--l. 5870--><p class="noindent" >This key essentially provides a convenient shortcut that performs </p><div class="alltt">
+ <!--l. 5893--><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
@@ -13157,24 +13196,24 @@
</div> after the entry has been defined. (See <a
href="#sec:crossref">§<span
-class="cmbx-10">??</span>sec:crossref </a><a
+class="cmbx-10">11</span> </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
+ id="dx1-114129"></a>s</a>.
+ <!--l. 5904--><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
+ id="dx1-114130"></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><!--l. 5908--><p class="noindent" >
+ </p><!--l. 5910--><p class="noindent" >For example:
</p>
- <pre class="verbatim" id="verbatim-140">
+ <pre class="verbatim" id="verbatim-142">
\newglossaryentry{courgette}{name={courgette},
  description={variety of small marrow}}
\newglossaryentry{zucchini}{name={zucchini},
@@ -13181,72 +13220,72 @@
  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
+ <!--l. 5917--><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
+ id="dx1-114131"></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
+ id="dx1-114132"></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><!--l. 5925--><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">
+ <pre class="verbatim" id="verbatim-143">
\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
+ <!--l. 5930--><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
+ </p><!--l. 5935--><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
+ id="dx1-114133"></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
+ id="dx1-114134"></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
+ id="dx1-114135"></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
+ id="dx1-114136"></a> package option. For further details, see <a
href="#sec:crossref">§<span
-class="cmbx-10">??</span>sec:crossref </a><a
+class="cmbx-10">11</span> </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
+ </p><!--l. 5946--><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-113137"></a> must be used before any occurrence of <span
+ id="dx1-114137"></a> must be used before any occurrence of <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-113138"></a> that
+ id="dx1-114138"></a> that
contains the <span
class="cmtt-10">see</span><a
- id="dx1-113139"></a> key. This key should not be used with entries defined in the <span
+ id="dx1-114139"></a> key. This key should not be used with entries defined in the <span
class="cmss-10">document</span><a
- id="dx1-113140"></a><a
- id="dx1-113141"></a> environment.
+ id="dx1-114140"></a><a
+ id="dx1-114141"></a> environment.
</div>
- </p><!--l. 5927--><p class="noindent" >
+ </p><!--l. 5950--><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-113142"></a> package option to warn or ignore the <span
+ id="dx1-114142"></a> package option to warn or ignore the <span
class="cmtt-10">see</span><a
- id="dx1-113143"></a> key while <span
+ id="dx1-114143"></a> key while <span
class="cmtt-10">\makeglossaries </span>is commented
out.
- </p><!--l. 5933--><p class="noindent" >If you use the <span
+ </p><!--l. 5956--><p class="noindent" >If you use the <span
class="cmtt-10">see</span><a
- id="dx1-113144"></a> key, you may want to consider using the <a
+ id="dx1-114144"></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
@@ -13253,39 +13292,39 @@
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-113145"></a> key,
+ id="dx1-114145"></a> key,
consider using <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
+ </p><!--l. 5963--><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
+ id="dx1-114146"></a></a> <span
class="cmtt-10">see</span><a
- id="dx1-113147"></a> field (and <span id="textcolor260"><span id="textcolor261"><span
+ id="dx1-114147"></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
+ id="dx1-114148"></a></span>) have a slightly different meaning. The <span id="textcolor262"><span
class="cmtt-10">selection</span></span><a
- id="dx1-113149"></a>
+ id="dx1-114149"></a>
resource option determines the behaviour. </div>
- </p><!--l. 5944--><p class="noindent" >
+ </p><!--l. 5967--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 5946--><p class="noindent" >
+ <!--l. 5969--><p class="noindent" >
<span id="textcolor263"><span id="textcolor264"><span
class="cmtt-10">seealso</span></span><a
- id="dx1-113150"></a></span> </p></dt><dd
+ id="dx1-114150"></a></span> </p></dt><dd
class="description">
- <!--l. 5946--><p class="noindent" >This key is only available with <a
+ <!--l. 5969--><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-113151"></a> but it doesn’t allow for the optional
+ id="dx1-114151"></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="textcolor265"><span
class="cmtt-10">\seealsoname</span></span><a
- id="dx1-113152"></a> and <span
+ id="dx1-114152"></a> and <span
class="cmtt-10">seealso={</span>⟨<span
class="cmitt-10">list</span>⟩<span
class="cmtt-10">} </span>is essentially like
@@ -13292,20 +13331,20 @@
<span
class="cmtt-10">see=[</span><span id="textcolor266"><span
class="cmtt-10">\seealsoname</span></span><a
- id="dx1-113153"></a><span
+ id="dx1-114153"></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).
</p></dd><dt class="description">
- <!--l. 5954--><p class="noindent" >
+ <!--l. 5977--><p class="noindent" >
<span id="textcolor267"><span id="textcolor268"><span
class="cmtt-10">alias</span></span><a
- id="dx1-113154"></a></span> </p></dt><dd
+ id="dx1-114154"></a></span> </p></dt><dd
class="description">
- <!--l. 5954--><p class="noindent" >This key is only available with <a
+ <!--l. 5977--><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
@@ -13320,18 +13359,18 @@
class="cmti-10">label</span>⟩ instead of the original entry.
(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
+ </p><!--l. 5986--><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-113155"></a></a>. </div>
- </p><!--l. 5965--><p class="noindent" >
+ id="dx1-114155"></a></a>. </div>
+ </p><!--l. 5988--><p class="noindent" >
</p></dd><dt class="description">
- <!--l. 5967--><p class="noindent" >
+ <!--l. 5990--><p class="noindent" >
<span id="textcolor269"><span id="textcolor270"><span
class="cmtt-10">category</span></span><a
- id="dx1-113156"></a></span> </p></dt><dd
+ id="dx1-114156"></a></span> </p></dt><dd
class="description">
- <!--l. 5967--><p class="noindent" >This key is only available with <a
+ <!--l. 5990--><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
@@ -13340,90 +13379,90 @@
details.
</p>
</dd></dl>
-<!--l. 5975--><p class="indent" > The following keys are reserved for <span
+<!--l. 5998--><p class="indent" > The following keys are reserved for <span
class="cmtt-10">\newacronym</span><a
- id="dx1-113157"></a> (see <a
+ id="dx1-114157"></a> (see <a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </a><a
href="#sec:acronyms">Acronyms and Other Abbreviations<!--tex4ht:ref: sec:acronyms --></a>)
and also for <span id="textcolor271"><span
class="cmtt-10">\newabbreviation</span></span><a
- id="dx1-113158"></a> (see the <a
+ id="dx1-114158"></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-113159"></a>, <span
+ id="dx1-114159"></a>, <span
class="cmtt-10">longplural</span><a
- id="dx1-113160"></a>, <span
+ id="dx1-114160"></a>, <span
class="cmtt-10">short</span><a
- id="dx1-113161"></a> and
+ id="dx1-114161"></a> and
<span
class="cmtt-10">shortplural</span><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
+ id="dx1-114162"></a>.
+</p><!--l. 6003--><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-113163"></a></a>. See the <a
+ id="dx1-114163"></a></a>. See the <a
href="#glo:bib2gls"><span
class="cmtt-10">bib2gls</span><a
- id="dx1-113164"></a></a> manual for further details.
+ id="dx1-114164"></a></a> manual for further details.
</div>
-</p><!--l. 5983--><p class="noindent" >
-</p><!--l. 5985--><p class="indent" > The supplementary packages <span
+</p><!--l. 6006--><p class="noindent" >
+</p><!--l. 6008--><p class="indent" > The supplementary packages <span
class="cmss-10">glossaries-prefix </span>(<a
href="#sec:prefix">§<span
-class="cmbx-10">??</span>sec:prefix </a><a
+class="cmbx-10">16</span> </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">§<span
-class="cmbx-10">??</span>sec:accsupp </a><a
+class="cmbx-10">17</span> </a><a
href="#sec:accsupp">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a>) provide additional keys.
-</p><!--l. 5988--><p class="indent" > <div class="important" title="Important Note"> Avoid using any of the <a
-href="#sec:gls-like"><span
+</p><!--l. 6011--><p class="indent" > <div class="important" title="Important Note"> Avoid using any of the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> or <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands within the <span
class="cmtt-10">text</span><a
- id="dx1-113165"></a>, <span
+ id="dx1-114165"></a>, <span
class="cmtt-10">first</span><a
- id="dx1-113166"></a>, <span
+ id="dx1-114166"></a>, <span
class="cmtt-10">short</span><a
- id="dx1-113167"></a> or <span
+ id="dx1-114167"></a> or <span
class="cmtt-10">long</span><a
- id="dx1-113168"></a> keys
+ id="dx1-114168"></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-113169"></a> key if you intend to use <span
+ id="dx1-114169"></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-113170"></a> key if you don’t
+ id="dx1-114170"></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. 6001--><p class="noindent" >
-</p><!--l. 6003--><p class="indent" > Note that if the name starts with <a
+</p><!--l. 6024--><p class="noindent" >
+</p><!--l. 6026--><p class="indent" > Note that if the name starts with <a
href="#glo:nonlatinchar">non-Latin character<a
- id="dx1-113171"></a></a>, you must group the character, otherwise it will cause
+ id="dx1-114171"></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-113172"></a> and <span
+ id="dx1-114172"></a> and <span
class="cmtt-10">\Glspl</span><a
- id="dx1-113173"></a>. For example:
+ id="dx1-114173"></a>. For example:
</p>
- <pre class="verbatim" id="verbatim-142">
+ <pre class="verbatim" id="verbatim-144">
\newglossaryentry{elite}{name={{\'e}lite},
description={select group or class}}
</pre>
-<!--l. 6010--><p class="nopar" > Note that the same applies if you are using the <span
+<!--l. 6033--><p class="nopar" > Note that the same applies if you are using the <span
class="cmss-10">inputenc</span><a
- id="dx1-113174"></a> package: </p><div class="alltt">
+ id="dx1-114174"></a> package: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry{elite}{name={{</span><span
@@ -13438,64 +13477,64 @@
</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-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
+ id="dx1-114175"></a> user manual.)
+<!--l. 6044--><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-113176"></a> key if you are
+ id="dx1-114176"></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-113177"></a></a> (<a
+ id="dx1-114177"></a></a> (<a
href="#option3">Option 3</a>) is usually able to sort <a
href="#glo:nonlatinchar">non-Latin character<a
- id="dx1-113178"></a>s</a> correctly.
+ id="dx1-114178"></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-113179"></a>s</a> unless you use the
+ id="dx1-114179"></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-113180"></a>.
+ id="dx1-114180"></a>.
</p>
-<!--l. 6029--><p class="noindent" ><a
+<!--l. 6052--><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. 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,
+<!--l. 6055--><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. 6035--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-114001"></a> <span
+</p><!--l. 6058--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-115001"></a> <span
class="cmtt-10">\glspluralsuffix </span></div><hr>
-</p><!--l. 6037--><p class="noindent" >
+</p><!--l. 6060--><p class="noindent" >
to the singular form. This command defaults to the letter “s”. For example:
</p>
- <pre class="verbatim" id="verbatim-143">
+ <pre class="verbatim" id="verbatim-145">
\newglossaryentry{cow}{name=cow,description={a fully grown
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
+<!--l. 6066--><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>
- <pre class="verbatim" id="verbatim-144">
+ <pre class="verbatim" id="verbatim-146">
\newglossaryentry{cow}{name=cow,plural=kine,
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
+<!--l. 6074--><p class="nopar" >
+</p><!--l. 6076--><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-114002"></a> key for
+ id="dx1-115002"></a> key for
one of them and one of the user keys to specify the other plural form. For example:
</p>
- <pre class="verbatim" id="verbatim-145">
+ <pre class="verbatim" id="verbatim-147">
\newglossaryentry{cow}{%
  name=cow,%
  description={a fully grown female of any bovine animal
@@ -13502,7 +13541,7 @@
               (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
+<!--l. 6086--><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:
@@ -13509,17 +13548,17 @@
</p>
- <pre class="verbatim" id="verbatim-146">
+ <pre class="verbatim" id="verbatim-148">
\let\glsaltpl\glsuseri
</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
+<!--l. 6092--><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-114003"></a>, described in <a
+ id="dx1-115003"></a>, described in <a
href="#sec:addkey">§<span
-class="cmbx-10">??</span>sec:addkey </a><a
+class="cmbx-10">4.3</span> </a><a
href="#sec:addkey">Additional Keys<!--tex4ht:ref: sec:addkey --></a>.
-</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,
+</p><!--l. 6097--><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
@@ -13526,19 +13565,19 @@
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-114004"></a> key (and the <span
+ id="dx1-115004"></a> key (and the <span
class="cmtt-10">firstplural</span><a
- id="dx1-114005"></a> key where necessary).
-</p><!--l. 6082--><p class="noindent" >
+ id="dx1-115005"></a> key where necessary).
+</p><!--l. 6105--><p class="noindent" >
</p>
-<!--l. 6082--><p class="noindent" ><a
+<!--l. 6105--><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. 6085--><p class="noindent" >You can use the six user keys to provide alternatives, such as participles. For example:
+<!--l. 6108--><p class="noindent" >You can use the six user keys to provide alternatives, such as participles. For example:
</p>
- <pre class="verbatim" id="verbatim-147">
+ <pre class="verbatim" id="verbatim-149">
\let\glsing\glsuseri
\let\glsd\glsuserii
\newcommand*{\ingkey}{user1}
@@ -13552,45 +13591,45 @@
  }%
}
</pre>
-<!--l. 6102--><p class="nopar" > With the above definitions, I can now define terms like this:
+<!--l. 6125--><p class="nopar" > With the above definitions, I can now define terms like this:
</p>
- <pre class="verbatim" id="verbatim-148">
+ <pre class="verbatim" id="verbatim-150">
\newword{play}{to take part in activities for enjoyment}
\newword[\edkey={ran},\ingkey={running}]{run}{to move fast using
the legs}
</pre>
-<!--l. 6108--><p class="nopar" > and use them in the text:
+<!--l. 6131--><p class="nopar" > and use them in the text:
</p>
- <pre class="verbatim" id="verbatim-149">
+ <pre class="verbatim" id="verbatim-151">
Peter is \glsing{play} in the park today.
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
+<!--l. 6139--><p class="nopar" >
+</p><!--l. 6141--><p class="indent" > Alternatively, you can define your own keys using <span
class="cmtt-10">\glsaddkey</span><a
- id="dx1-115001"></a>, described below in <a
+ id="dx1-116001"></a>, described below in <a
href="#sec:addkey">§<span
-class="cmbx-10">??</span>sec:addkey </a><a
+class="cmbx-10">4.3</span> </a><a
href="#sec:addkey">Additional
Keys<!--tex4ht:ref: sec:addkey --></a>.
-</p><!--l. 6121--><p class="noindent" >
+</p><!--l. 6144--><p class="noindent" >
</p>
-<!--l. 6121--><p class="noindent" ><a
+<!--l. 6144--><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. 6124--><p class="noindent" >You can now also define your own custom keys using the commands described in this section. There are two
+<!--l. 6147--><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. 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
+</p><!--l. 6152--><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">§<span
-class="cmbx-10">??</span>sec:glsaddkey </a><a
+class="cmbx-10">4.3.1</span> </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
@@ -13597,9 +13636,9 @@
class="cmtt-10">\glsaddstoragekey </span>described in
<a
href="#sec:glsaddstoragekey">§<span
-class="cmbx-10">??</span>sec:glsaddstoragekey </a><a
+class="cmbx-10">4.3.2</span> </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
+</p><!--l. 6160--><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
@@ -13607,14 +13646,14 @@
class="cmtt-10">\glsaddkey </span>or
<span
class="cmtt-10">\glsaddstoragekey </span>before glossary entries are defined.
-</p><!--l. 6144--><p class="noindent" >
+</p><!--l. 6167--><p class="noindent" >
</p>
-<!--l. 6144--><p class="noindent" ><a
+<!--l. 6167--><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. 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
+<!--l. 6170--><p class="noindent" >A custom key that can be used in the document is defined using:
+</p><!--l. 6171--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-118001"></a> <span
class="cmtt-10">\glsaddkey{</span>⟨<span
class="cmitt-10">key</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -13632,81 +13671,81 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">link allcaps cs</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 6156--><p class="noindent" >
+</p><!--l. 6179--><p class="noindent" >
where:
</p><dl class="description"><dt class="description">
- <!--l. 6159--><p class="noindent" >
+ <!--l. 6182--><p class="noindent" >
⟨<span
class="cmbxti-10">key</span>⟩ </p></dt><dd
class="description">
- <!--l. 6159--><p class="noindent" >is the new key to use in <span
+ <!--l. 6182--><p class="noindent" >is the new key to use in <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-117002"></a> (or similar commands such as
+ id="dx1-118002"></a> (or similar commands such as
<span
class="cmtt-10">\longnewglossaryentry</span><a
- id="dx1-117003"></a>);
+ id="dx1-118003"></a>);
</p></dd><dt class="description">
- <!--l. 6161--><p class="noindent" >
+ <!--l. 6184--><p class="noindent" >
⟨<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
+ <!--l. 6184--><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);
</p></dd><dt class="description">
- <!--l. 6166--><p class="noindent" >
+ <!--l. 6189--><p class="noindent" >
⟨<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
+ <!--l. 6189--><p class="noindent" >is the control sequence to use analogous to commands like <span
class="cmtt-10">\glsentrytext</span><a
- id="dx1-117004"></a>;
+ id="dx1-118004"></a>;
</p></dd><dt class="description">
- <!--l. 6168--><p class="noindent" >
+ <!--l. 6191--><p class="noindent" >
⟨<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
+ <!--l. 6191--><p class="noindent" >is the control sequence to use analogous to commands like <span
class="cmtt-10">\Glsentrytext</span><a
- id="dx1-117005"></a>;
+ id="dx1-118005"></a>;
</p></dd><dt class="description">
- <!--l. 6170--><p class="noindent" >
+ <!--l. 6193--><p class="noindent" >
⟨<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
+ <!--l. 6193--><p class="noindent" >is the control sequence to use analogous to commands like <span
class="cmtt-10">\glstext</span><a
- id="dx1-117006"></a>;
+ id="dx1-118006"></a>;
</p></dd><dt class="description">
- <!--l. 6172--><p class="noindent" >
+ <!--l. 6195--><p class="noindent" >
⟨<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
+ <!--l. 6195--><p class="noindent" >is the control sequence to use analogous to commands like <span
class="cmtt-10">\Glstext</span><a
- id="dx1-117007"></a>;
+ id="dx1-118007"></a>;
</p></dd><dt class="description">
- <!--l. 6174--><p class="noindent" >
+ <!--l. 6197--><p class="noindent" >
⟨<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
+ <!--l. 6197--><p class="noindent" >is the control sequence to use analogous to commands like <span
class="cmtt-10">\GLStext</span><a
- id="dx1-117008"></a>.</p></dd></dl>
-<!--l. 6177--><p class="noindent" >The starred version of <span
+ id="dx1-118008"></a>.</p></dd></dl>
+<!--l. 6200--><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. 6181--><p class="noindent" ><span
+ id="x1-118009r3"></a>
+</p><!--l. 6204--><p class="noindent" ><span
class="cmbx-12">Example 3</span><span
class="cmbx-12"> (Defining Custom Keys)</span><a
- id="x1-117010"></a>
-</p><!--l. 6182--><p class="indent" > Suppose I want to define two new keys, <span
+ id="x1-118010"></a>
+</p><!--l. 6205--><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
@@ -13714,7 +13753,7 @@
</p>
- <pre class="verbatim" id="verbatim-150">
+ <pre class="verbatim" id="verbatim-152">
 % Define "ed" key:
 \glsaddkey*
  {ed}% key
@@ -13734,11 +13773,11 @@
  {\Glsing}% command analogous to \Glstext
  {\GLSing}% command analogous to \GLStext
</pre>
-<!--l. 6206--><p class="nopar" > Now I can define some entries:
+<!--l. 6229--><p class="nopar" > Now I can define some entries:
</p>
- <pre class="verbatim" id="verbatim-151">
+ <pre class="verbatim" id="verbatim-153">
 % No need to override defaults for this entry:
 \newglossaryentry{jump}{name={jump},description={}}
 % Need to override defaults on these entries:
@@ -13751,31 +13790,31 @@
   ing={waddling},%
   description={}}
</pre>
-<!--l. 6224--><p class="nopar" >
-</p><!--l. 6226--><p class="indent" > These entries can later be used in the document:
+<!--l. 6247--><p class="nopar" >
+</p><!--l. 6249--><p class="indent" > These entries can later be used in the document:
</p>
- <pre class="verbatim" id="verbatim-152">
+ <pre class="verbatim" id="verbatim-154">
The dog \glsed{jump} over the duck.
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
+<!--l. 6256--><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. 6235--><p class="noindent" >
-</p><!--l. 6235--><p class="noindent" >____________________________</p></div>
-<!--l. 6237--><p class="noindent" >
+<!--l. 6258--><p class="noindent" >
+</p><!--l. 6258--><p class="noindent" >____________________________</p></div>
+<!--l. 6260--><p class="noindent" >
</p>
-<!--l. 6237--><p class="noindent" ><a
+<!--l. 6260--><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. 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
+<!--l. 6263--><p class="noindent" >A custom key that can be used for simply storing information is defined using:
+</p><!--l. 6265--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-119001"></a> <span
class="cmtt-10">\glsaddstoragekey{</span>⟨<span
class="cmitt-10">key</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -13783,33 +13822,33 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">no link cs</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 6244--><p class="noindent" >
+</p><!--l. 6267--><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">§<span
-class="cmbx-10">??</span>sec:glsaddkey
+class="cmbx-10">4.3.1</span>
</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
+</p><!--l. 6271--><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">§<span
-class="cmbx-10">??</span>sec:fetchset </a><a
+class="cmbx-10">15.3</span> </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. 6253--><p class="noindent" ><span
+ id="x1-119002r4"></a>
+</p><!--l. 6276--><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-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
+ id="x1-119003"></a>
+</p><!--l. 6277--><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. 6261--><p class="indent" > Here I can define a new key that determines whether the term is actually an acronym rather
+</p><!--l. 6284--><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
@@ -13817,19 +13856,19 @@
</p>
- <pre class="verbatim" id="verbatim-153">
+ <pre class="verbatim" id="verbatim-155">
\glsaddstoragekey
 {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
+<!--l. 6293--><p class="nopar" >
+</p><!--l. 6295--><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>
- <pre class="verbatim" id="verbatim-154">
+ <pre class="verbatim" id="verbatim-156">
\newacronymstyle
 {mystyle}% style name
 {% Use the generic display
@@ -13903,31 +13942,31 @@
  \renewcommand*{\acrpluralsuffix}{\glspluralsuffix}%
 }
</pre>
-<!--l. 6345--><p class="nopar" > Remember that the new style needs to be set before defining any terms:
+<!--l. 6368--><p class="nopar" > Remember that the new style needs to be set before defining any terms:
</p>
- <pre class="verbatim" id="verbatim-155">
+ <pre class="verbatim" id="verbatim-157">
\setacronymstyle{mystyle}
</pre>
-<!--l. 6350--><p class="nopar" >
-</p><!--l. 6352--><p class="indent" > Since it’s a bit confusing to use <span
+<!--l. 6373--><p class="nopar" >
+</p><!--l. 6375--><p class="indent" > Since it’s a bit confusing to use <span
class="cmtt-10">\newacronym</span><a
- id="dx1-118004"></a> for something that’s not technically an acronym, let’s define a
+ id="dx1-119004"></a> for something that’s not technically an acronym, let’s define a
new command for initialisms:
</p>
- <pre class="verbatim" id="verbatim-156">
+ <pre class="verbatim" id="verbatim-158">
\newcommand*{\newinitialism}[4][]{%
  \newacronym[abbrtype=initialism,#1]{#2}{#3}{#4}%
}
</pre>
-<!--l. 6359--><p class="nopar" > Now the entries can all be defined:
+<!--l. 6382--><p class="nopar" > Now the entries can all be defined:
</p>
- <pre class="verbatim" id="verbatim-157">
+ <pre class="verbatim" id="verbatim-159">
\newacronym{radar}{radar}{radio detecting and ranging}
\newacronym{laser}{laser}{light amplification by stimulated
emission of radiation}
@@ -13936,19 +13975,19 @@
\newinitialism{dsp}{DSP}{digital signal processing}
\newinitialism{atm}{ATM}{automated teller machine}
</pre>
-<!--l. 6369--><p class="nopar" > On <a
+<!--l. 6392--><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. 6374--><p class="indent" > For a complete document, see the sample file <a
+</p><!--l. 6397--><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. 6376--><p class="noindent" >
-</p><!--l. 6376--><p class="noindent" >____________________________</p></div>
-<!--l. 6378--><p class="indent" > In the above example, if <span
+<!--l. 6399--><p class="noindent" >
+</p><!--l. 6399--><p class="noindent" >____________________________</p></div>
+<!--l. 6401--><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
@@ -13956,131 +13995,131 @@
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-118005"></a> key hasn’t been set) so the display style will switch to that given by
+ id="dx1-119005"></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. 6387--><p class="noindent" ><span
+ id="x1-119006r5"></a>
+</p><!--l. 6410--><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-118007"></a>
-</p><!--l. 6388--><p class="indent" > The previous example can be modified if the <span
+ id="x1-119007"></a>
+</p><!--l. 6411--><p class="indent" > The previous example can be modified if the <span
class="cmtt-10">description</span><a
- id="dx1-118008"></a> also needs to be provided. Here I’ve changed
+ id="dx1-119008"></a> also needs to be provided. Here I’ve changed
“word” to “acronym”:
</p>
- <pre class="verbatim" id="verbatim-158">
+ <pre class="verbatim" id="verbatim-160">
\glsaddstoragekey
 {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
+<!--l. 6419--><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-118009"></a> can be used to determine whether or not to reference the value of this new <span
+ id="dx1-119009"></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. 6402--><p class="indent" > The new acronym style has a minor modification that forces the user to specify a description. In the
+</p><!--l. 6425--><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>
- <pre class="verbatim" id="verbatim-159">
+ <pre class="verbatim" id="verbatim-161">
   \renewcommand*{\GenericAcronymFields}{%
     description={\the\glslongtok}}%
</pre>
-<!--l. 6407--><p class="nopar" > needs to be changed to:
+<!--l. 6430--><p class="nopar" > needs to be changed to:
</p>
- <pre class="verbatim" id="verbatim-160">
+ <pre class="verbatim" id="verbatim-162">
   \renewcommand*{\GenericAcronymFields}{}%
</pre>
-<!--l. 6411--><p class="nopar" > Additionally, to accommodate the change in the default value of the <span
+<!--l. 6434--><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>
- <pre class="verbatim" id="verbatim-161">
+ <pre class="verbatim" id="verbatim-163">
    \ifglsfieldeq{##1}{abbrtype}{word}
</pre>
-<!--l. 6416--><p class="nopar" > need to be changed to:
+<!--l. 6439--><p class="nopar" > need to be changed to:
</p>
- <pre class="verbatim" id="verbatim-162">
+ <pre class="verbatim" id="verbatim-164">
    \ifglsfieldeq{##1}{abbrtype}{acronym}
</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
+<!--l. 6443--><p class="nopar" >
+</p><!--l. 6445--><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>
- <pre class="verbatim" id="verbatim-163">
+ <pre class="verbatim" id="verbatim-165">
\newacronym[description={system for detecting the position and
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
+<!--l. 6451--><p class="nopar" >
+</p><!--l. 6453--><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>
- <pre class="verbatim" id="verbatim-164">
+ <pre class="verbatim" id="verbatim-166">
\newinitialism[description={mathematical manipulation of an
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:
+<!--l. 6458--><p class="nopar" >
+</p><!--l. 6460--><p class="indent" > We can also accommodate contractions in a similar manner to the initialisms:
</p>
- <pre class="verbatim" id="verbatim-165">
+ <pre class="verbatim" id="verbatim-167">
\newcommand*{\newcontraction}[4][]{%
  \newacronym[abbrtype=contraction,#1]{#2}{#3}{#4}%
}
</pre>
-<!--l. 6443--><p class="nopar" > The contractions can similarly been defined using this new command:
+<!--l. 6466--><p class="nopar" > The contractions can similarly been defined using this new command:
</p>
- <pre class="verbatim" id="verbatim-166">
+ <pre class="verbatim" id="verbatim-168">
\newcontraction[description={front part of a ship below the
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
+<!--l. 6471--><p class="nopar" >
+</p><!--l. 6473--><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. 6455--><p class="indent" > To test regular non-abbreviated entries, I’ve also defined a simple word:
+</p><!--l. 6478--><p class="indent" > To test regular non-abbreviated entries, I’ve also defined a simple word:
</p>
- <pre class="verbatim" id="verbatim-167">
+ <pre class="verbatim" id="verbatim-169">
\newglossaryentry{apple}{name={apple},description={a fruit}}
</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
+<!--l. 6482--><p class="nopar" >
+</p><!--l. 6484--><p class="indent" > Now for a new glossary style that provides information about the abbreviation (in addition to the
description):
</p>
- <pre class="verbatim" id="verbatim-168">
+ <pre class="verbatim" id="verbatim-170">
\newglossarystyle
 {mystyle}% style name
 {% base it on the "list" style
@@ -14093,98 +14132,98 @@
       \glossentrydesc{##1}\glspostdescription\space ##2}%
 }
</pre>
-<!--l. 6475--><p class="nopar" > This uses <span
+<!--l. 6498--><p class="nopar" > This uses <span
class="cmtt-10">\ifglshaslong</span><a
- id="dx1-118010"></a> to determine whether or not the term is an abbreviation. If it has an abbreviation,
+ id="dx1-119010"></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. 6482--><p class="indent" > With this style set, the <span
+</p><!--l. 6505--><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" >
+ <!--l. 6508--><p class="noindent" >
<span
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
+ <!--l. 6508--><p class="noindent" >a fruit.</p></dd></dl>
+<!--l. 6510--><p class="noindent" >but the abbreviations are displayed in the form
</p><dl class="description"><dt class="description">
- <!--l. 6489--><p class="noindent" >
+ <!--l. 6512--><p class="noindent" >
<span
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
+ <!--l. 6512--><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
+<!--l. 6516--><p class="noindent" >(for acronyms) or
</p><dl class="description"><dt class="description">
- <!--l. 6495--><p class="noindent" >
+ <!--l. 6518--><p class="noindent" >
<span
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
+ <!--l. 6518--><p class="noindent" >(initialism: digital signal processing) mathematical manipulation of an information signal.</p></dd></dl>
+<!--l. 6521--><p class="noindent" >(for initalisms) or
</p><dl class="description"><dt class="description">
- <!--l. 6500--><p class="noindent" >
+ <!--l. 6523--><p class="noindent" >
<span
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. 6523--><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
+<!--l. 6526--><p class="noindent" >(for contractions).
+</p><!--l. 6528--><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. 6506--><p class="noindent" >
-</p><!--l. 6506--><p class="noindent" >____________________________</p></div>
-<!--l. 6508--><p class="noindent" >
+<!--l. 6529--><p class="noindent" >
+</p><!--l. 6529--><p class="noindent" >____________________________</p></div>
+<!--l. 6531--><p class="noindent" >
</p>
-<!--l. 6508--><p class="noindent" ><a
+<!--l. 6531--><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. 6511--><p class="noindent" >When you define new glossary entries expansion is performed by default, except for the <span
+<!--l. 6534--><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-119001"></a>, <span
+ id="dx1-120001"></a>, <span
class="cmtt-10">description</span><a
- id="dx1-119002"></a>,
+ id="dx1-120002"></a>,
<span
class="cmtt-10">descriptionplural</span><a
- id="dx1-119003"></a>, <span
+ id="dx1-120003"></a>, <span
class="cmtt-10">symbol</span><a
- id="dx1-119004"></a>, <span
+ id="dx1-120004"></a>, <span
class="cmtt-10">symbolplural</span><a
- id="dx1-119005"></a> and <span
+ id="dx1-120005"></a> and <span
class="cmtt-10">sort</span><a
- id="dx1-119006"></a> keys (these keys all have expansion suppressed via
+ id="dx1-120006"></a> keys (these keys all have expansion suppressed via
<span
class="cmtt-10">\glssetnoexpandfield</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
+</p><!--l. 6540--><p class="indent" > You can switch expansion on or off for individual keys using
+</p><!--l. 6541--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-120007"></a> <span
class="cmtt-10">\glssetexpandfield{</span>⟨<span
class="cmitt-10">field</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 6520--><p class="noindent" >
+</p><!--l. 6543--><p class="noindent" >
or
-</p><!--l. 6522--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-119008"></a> <span
+</p><!--l. 6545--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-120008"></a> <span
class="cmtt-10">\glssetnoexpandfield{</span>⟨<span
class="cmitt-10">field</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 6524--><p class="noindent" >
+</p><!--l. 6547--><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 <span
-class="cmbx-10">??</span>tab:fieldmap</a>.
+class="cmbx-10">4.1</span></a>.
</p>
<div class="table">
-<!--l. 6529--><p class="indent" > <a
+<!--l. 6552--><p class="indent" > <a
id="tab:fieldmap"></a></p><hr class="float" /><div class="float"
>
@@ -14191,7 +14230,7 @@
<div class="caption"
><span class="id">Table 4.1: </span><span
-class="content">Key to Field Mappings</span></div><!--tex4ht:label?: x1-1190091 -->
+class="content">Key to Field Mappings</span></div><!--tex4ht:label?: x1-1200091 -->
<div class="tabular"> <table id="TBL-5" class="tabular"
><colgroup id="TBL-5-1g"><col
@@ -14206,13 +14245,13 @@
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-119010"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-2"
+ id="dx1-120010"></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-119011"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-2"
+ id="dx1-120011"></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
@@ -14219,7 +14258,7 @@
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-119012"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-2"
+ id="dx1-120012"></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
@@ -14226,7 +14265,7 @@
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-119013"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-2"
+ id="dx1-120013"></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
@@ -14233,7 +14272,7 @@
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-119014"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-2"
+ id="dx1-120014"></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
@@ -14240,7 +14279,7 @@
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-119015"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-2"
+ id="dx1-120015"></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
@@ -14247,7 +14286,7 @@
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-119016"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-2"
+ id="dx1-120016"></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
@@ -14254,7 +14293,7 @@
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-119017"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-2"
+ id="dx1-120017"></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
@@ -14261,7 +14300,7 @@
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-119018"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-2"
+ id="dx1-120018"></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
@@ -14268,7 +14307,7 @@
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-119019"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-11-2"
+ id="dx1-120019"></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
@@ -14275,7 +14314,7 @@
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-119020"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-12-2"
+ id="dx1-120020"></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
@@ -14282,7 +14321,7 @@
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-119021"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-13-2"
+ id="dx1-120021"></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>
@@ -14290,27 +14329,27 @@
</div><hr class="endfloat" />
</div>
-<!--l. 6550--><p class="indent" > Any keys that haven’t had the expansion explicitly set using <span
+<!--l. 6573--><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. 6552--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-119022"></a> <span
+</p><!--l. 6575--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-120022"></a> <span
class="cmtt-10">\glsexpandfields </span></div><hr>
-</p><!--l. 6554--><p class="noindent" >
+</p><!--l. 6577--><p class="noindent" >
and
-</p><!--l. 6556--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-119023"></a> <span
+</p><!--l. 6579--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-120023"></a> <span
class="cmtt-10">\glsnoexpandfields </span></div><hr>
-</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
+</p><!--l. 6581--><p class="noindent" >
+</p><!--l. 6583--><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. 6564--><p class="noindent" ><a
+<!--l. 6587--><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. 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
+<!--l. 6590--><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
@@ -14317,62 +14356,62 @@
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">§<span
-class="cmbx-10">??</span>sec:styles </a><a
+class="cmbx-10">13</span> </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-120001"></a> package option (see <a
+ id="dx1-121001"></a> package option (see <a
href="#sec:pkgopts-printglos">§<span
-class="cmbx-10">??</span>sec:pkgopts-printglos </a><a
+class="cmbx-10">2.3</span> </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
+</p><!--l. 6605--><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-120002"></a></a>. Note also
+ id="dx1-121002"></a></a>. Note also
that <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-120003"></a></a> has a restriction on the maximum sub-entry depth.
-</p><!--l. 6588--><p class="noindent" >
+ id="dx1-121003"></a></a> has a restriction on the maximum sub-entry depth.
+</p><!--l. 6611--><p class="noindent" >
</p>
-<!--l. 6588--><p class="noindent" ><a
+<!--l. 6611--><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. 6591--><p class="noindent" >To arrange a glossary with hierarchical categories, you need to first define the category and then define the
+<!--l. 6614--><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-121001"></a> key.
+ id="dx1-122001"></a> key.
<a
- id="ex:hierarchical"></a>
-</p><!--l. 6596--><p class="noindent" ><span
+ id="x1-122002r6"></a>
+</p><!--l. 6619--><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-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.
+ id="x1-122003"></a>
+</p><!--l. 6621--><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>
- <pre class="verbatim" id="verbatim-169">
+ <pre class="verbatim" id="verbatim-171">
\newglossaryentry{greekletter}{name={Greek letters},
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
+<!--l. 6630--><p class="nopar" >
+</p><!--l. 6632--><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-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:
+ id="dx1-122004"></a>. This gives a blank description and suppresses the description terminator.
+</p><!--l. 6637--><p class="indent" > I can now define my sub-entries as follows:
</p>
- <pre class="verbatim" id="verbatim-170">
+ <pre class="verbatim" id="verbatim-172">
\newglossaryentry{pi}{name={\ensuremath{\pi}},sort={pi},
description={ratio of the circumference of a circle to
the diameter},
@@ -14381,40 +14420,40 @@
description={Euler's constant},
parent=romanletter}
</pre>
-<!--l. 6624--><p class="nopar" > For a complete document, see the sample file <a
+<!--l. 6647--><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. 6626--><p class="noindent" >
-</p><!--l. 6626--><p class="noindent" >____________________________</p></div>
-<!--l. 6628--><p class="noindent" >
+<!--l. 6649--><p class="noindent" >
+</p><!--l. 6649--><p class="noindent" >____________________________</p></div>
+<!--l. 6651--><p class="noindent" >
</p>
-<!--l. 6628--><p class="noindent" ><a
+<!--l. 6651--><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. 6631--><p class="noindent" >Sub-entries that have the same name as the parent entry, don’t need to have the <span
+<!--l. 6654--><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-122001"></a> key. For example, the
+ id="dx1-123001"></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>
- <pre class="verbatim" id="verbatim-171">
+ <pre class="verbatim" id="verbatim-173">
\newglossaryentry{glossary}{name=glossary,
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
+<!--l. 6663--><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-122002"></a>.
-</p><!--l. 6644--><p class="indent" > Now define the two different meanings of the word:
+ id="dx1-123002"></a>.
+</p><!--l. 6667--><p class="indent" > Now define the two different meanings of the word:
</p>
- <pre class="verbatim" id="verbatim-172">
+ <pre class="verbatim" id="verbatim-174">
\newglossaryentry{glossarylist}{
description={list of technical words},
sort={1},
@@ -14424,41 +14463,41 @@
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
+<!--l. 6678--><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-122003"></a></a>, whereas if I
+ id="dx1-123003"></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-122004"></a> key is required unless you are using the <span
+ id="dx1-123004"></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-122005"></a> or <span
+ id="dx1-123005"></a> or <span
class="cmss-10">sort</span><span
class="cmtt-10">=</span><span
class="cmss-10">def</span><a
- id="dx1-122006"></a>
+ id="dx1-123006"></a>
package options (see <a
href="#sec:pkgopts-sort">§<span
-class="cmbx-10">??</span>sec:pkgopts-sort </a><a
+class="cmbx-10">2.5</span> </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-122007"></a> package option to
+ id="dx1-123007"></a> package option to
automatically number the first-level child entries. See <a
href="#sec:pkgopts-printglos">§<span
-class="cmbx-10">??</span>sec:pkgopts-printglos </a><a
+class="cmbx-10">2.3</span> </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
+</p><!--l. 6690--><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-122008"></a> key was not required for the child entries. However, if the sub-entries have different plurals, they will
+ id="dx1-123008"></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>
- <pre class="verbatim" id="verbatim-173">
+ <pre class="verbatim" id="verbatim-175">
\newglossaryentry{bravo}{name={bravo},
description={\nopostdesc}}
\newglossaryentry{bravocry}{description={cry of approval
@@ -14472,85 +14511,85 @@
plural={bravoes},
parent=bravo}
</pre>
-<!--l. 6686--><p class="nopar" >
-</p><!--l. 6689--><p class="noindent" >
+<!--l. 6709--><p class="nopar" >
+</p><!--l. 6712--><p class="noindent" >
</p>
-<!--l. 6689--><p class="noindent" ><a
+<!--l. 6712--><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. 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
+<!--l. 6715--><p class="noindent" >You can store all your glossary entry definitions in another file and use:
+</p><!--l. 6717--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-124001"></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. 6696--><p class="noindent" >
+</p><!--l. 6719--><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-123002"></a> or <span
+ id="dx1-124002"></a> or <span
class="cmtt-10">\longnewglossaryentry</span><a
- id="dx1-123003"></a>
+ id="dx1-124003"></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-123004"></a> key has been omitted (or, more specifically, for those entries
+ id="dx1-124004"></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-123005"></a>, which is what <span
+ id="dx1-124005"></a>, which is what <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-123006"></a> uses by
+ id="dx1-124006"></a> uses by
default).
-</p><!--l. 6706--><p class="indent" > This is a preamble-only command. You may also use <span
+</p><!--l. 6729--><p class="indent" > This is a preamble-only command. You may also use <span
class="cmtt-10">\input</span><a
- id="dx1-123007"></a> to load the file but don’t use <span
+ id="dx1-124007"></a> to load the file but don’t use <span
class="cmtt-10">\include</span><a
- id="dx1-123008"></a>. If you
+ id="dx1-124008"></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-123009"></a></a> and use an
+ id="dx1-124009"></a></a> and use an
application such as JabRef to manage the entry definitions.
-</p><!--l. 6712--><p class="indent" > <div class="important" title="Important Note"> If you want to use <span
+</p><!--l. 6735--><p class="indent" > <div class="important" title="Important Note"> If you want to use <span
class="cmtt-10">\AtBeginDocument</span><a
- id="dx1-123010"></a> to <span
+ id="dx1-124010"></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-123011"></a> package (and <span
+ id="dx1-124011"></a> package (and <span
class="cmss-10">babel</span><a
- id="dx1-123012"></a>, if you are also loading
+ id="dx1-124012"></a>, if you are also loading
that) to avoid the creation of the <span
class="cmtt-10">glsdefs</span><a
- id="dx1-123013"></a> file and any associated problems that are caused by defining
+ id="dx1-124013"></a> file and any associated problems that are caused by defining
commands in the <span
class="cmss-10">document</span><a
- id="dx1-123014"></a><a
- id="dx1-123015"></a> environment. (See <a
+ id="dx1-124014"></a><a
+ id="dx1-124015"></a> environment. (See <a
href="#sec:docdefs">§<span
-class="cmbx-10">??</span>sec:docdefs </a><a
+class="cmbx-10">4.8</span> </a><a
href="#sec:docdefs">Drawbacks With Defining Entries in the Document
Environment<!--tex4ht:ref: sec:docdefs --></a>.) </div>
-</p><!--l. 6721--><p class="noindent" >
+</p><!--l. 6744--><p class="noindent" >
<a
- id="ex:loadgls"></a>
-</p><!--l. 6723--><p class="noindent" ><span
+ id="x1-124016r7"></a>
+</p><!--l. 6746--><p class="noindent" ><span
class="cmbx-12">Example 7</span><span
class="cmbx-12"> (Loading Entries from Another File)</span><a
- id="x1-123017"></a>
-</p><!--l. 6724--><p class="indent" > Suppose I have a file called <span
+ id="x1-124017"></a>
+</p><!--l. 6747--><p class="indent" > Suppose I have a file called <span
class="cmtt-10">myentries.tex </span>which contains:
</p>
- <pre class="verbatim" id="verbatim-174">
+ <pre class="verbatim" id="verbatim-176">
\newglossaryentry{perl}{type=main,
name={Perl},
description={A scripting language}}
@@ -14560,14 +14599,14 @@
name={html},
description={A mark up language}}
</pre>
-<!--l. 6736--><p class="nopar" > and suppose in my document preamble I use the command:
+<!--l. 6759--><p class="nopar" > and suppose in my document preamble I use the command:
</p>
- <pre class="verbatim" id="verbatim-175">
+ <pre class="verbatim" id="verbatim-177">
\loadglsentries[languages]{myentries}
</pre>
-<!--l. 6740--><p class="nopar" > then this will add the entries <span
+<!--l. 6763--><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>,
@@ -14577,13 +14616,13 @@
</p>
<div class="center"
>
-<!--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
+<!--l. 6768--><p class="noindent" >
+</p><!--l. 6768--><p class="noindent" >____________________________</p></div>
+<!--l. 6771--><p class="indent" > <span class="warningsymbol">⚠</span> Note: if you use <span
class="cmtt-10">\newacronym</span><a
- id="dx1-123018"></a> (see <a
+ id="dx1-124018"></a> (see <a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </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
@@ -14592,76 +14631,76 @@
</p>
- <pre class="verbatim" id="verbatim-176">
+ <pre class="verbatim" id="verbatim-178">
\newacronym{aca}{aca}{a contrived acronym}
</pre>
-<!--l. 6753--><p class="nopar" > then (supposing I have defined a new glossary type called <span
+<!--l. 6776--><p class="nopar" > then (supposing I have defined a new glossary type called <span
class="cmtt-10">altacronym</span>)
</p>
- <pre class="verbatim" id="verbatim-177">
+ <pre class="verbatim" id="verbatim-179">
\loadglsentries[altacronym]{myacronyms}
</pre>
-<!--l. 6758--><p class="nopar" > will add <span
+<!--l. 6781--><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-123019"></a> has been specified,
+ id="dx1-124019"></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-123020"></a> is not
+ id="dx1-124020"></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-123021f1"></a>
-</p><!--l. 6766--><p class="indent" > If you have used the <span
+ id="x1-124021f1"></a>
+</p><!--l. 6789--><p class="indent" > If you have used the <span
class="cmss-10">acronym</span><a
- id="dx1-123025"></a> package option, there are two possible solutions to this problem:
+ id="dx1-124025"></a> package option, there are two possible solutions to this problem:
</p><ol class="enumerate1" >
<li
- class="enumerate" id="x1-123027x1">
- <!--l. 6769--><p class="noindent" >Change <span
+ class="enumerate" id="x1-124027x1">
+ <!--l. 6792--><p class="noindent" >Change <span
class="cmtt-10">myacronyms.tex </span>so that entries are defined in the form:
</p>
- <pre class="verbatim" id="verbatim-178">
+ <pre class="verbatim" id="verbatim-180">
\newacronym[type=\glsdefaulttype]{aca}{aca}{a
contrived acronym}
</pre>
- <!--l. 6774--><p class="nopar" > and do:
+ <!--l. 6797--><p class="nopar" > and do:
</p>
- <pre class="verbatim" id="verbatim-179">
+ <pre class="verbatim" id="verbatim-181">
\loadglsentries[altacronym]{myacronyms}
</pre>
- <!--l. 6778--><p class="nopar" >
+ <!--l. 6801--><p class="nopar" >
</p></li>
<li
- class="enumerate" id="x1-123029x2">
- <!--l. 6780--><p class="noindent" >Temporarily change <span
+ class="enumerate" id="x1-124029x2">
+ <!--l. 6803--><p class="noindent" >Temporarily change <span
class="cmtt-10">\acronymtype </span>to the target glossary:
</p>
- <pre class="verbatim" id="verbatim-180">
+ <pre class="verbatim" id="verbatim-182">
\let\orgacronymtype\acronymtype
\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
+ <!--l. 6809--><p class="nopar" ></p></li></ol>
+<!--l. 6812--><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. 6794--><p class="indent" > Remember that you can use <span
+</p><!--l. 6817--><p class="indent" > Remember that you can use <span
class="cmtt-10">\provideglossaryentry</span><a
- id="dx1-123030"></a> rather than <span
+ id="dx1-124030"></a> rather than <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-123031"></a>. Suppose you want
+ id="dx1-124031"></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
@@ -14673,15 +14712,15 @@
</p>
- <pre class="verbatim" id="verbatim-181">
+ <pre class="verbatim" id="verbatim-183">
\provideglossaryentry{mallard}{name=mallard,
 description={a type of duck}}
</pre>
-<!--l. 6807--><p class="nopar" > but suppose your document requires a more detailed description, you can do:
+<!--l. 6830--><p class="nopar" > but suppose your document requires a more detailed description, you can do:
</p>
- <pre class="verbatim" id="verbatim-182">
+ <pre class="verbatim" id="verbatim-184">
\usepackage{glossaries}
\makeglossaries
\newglossaryentry{mallard}{name=mallard,
@@ -14688,54 +14727,54 @@
 description={a dabbling duck where the male has a green head}}
\loadglsentries{terms}
</pre>
-<!--l. 6818--><p class="nopar" > Now the <span
+<!--l. 6841--><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. 6822--><p class="noindent" >
+</p><!--l. 6845--><p class="noindent" >
</p>
-<!--l. 6822--><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.7 </span> <a
id="sec:moveentry"></a>Moving Entries to Another Glossary</h3>
-<!--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
+<!--l. 6848--><p class="noindent" >As from version 3.02, you can move an entry from one glossary to another using:
+</p><!--l. 6850--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-125001"></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. 6829--><p class="noindent" >
+</p><!--l. 6852--><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. 6834--><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. 6857--><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-124002"></a>, then define an ignored glossary with
+ id="dx1-125002"></a>, then define an ignored glossary with
<span
class="cmtt-10">\newignoredglossary</span><a
- id="dx1-124003"></a>. (See <a
+ id="dx1-125003"></a>. (See <a
href="#sec:newglossary">§<span
-class="cmbx-10">??</span>sec:newglossary </a><a
+class="cmbx-10">9</span> </a><a
href="#sec:newglossary">Defining New Glossaries<!--tex4ht:ref: sec:newglossary --></a>.)
-</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.
+</p><!--l. 6863--><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. 6843--><p class="noindent" >
-</p><!--l. 6845--><p class="noindent" >
+</p><!--l. 6866--><p class="noindent" >
+</p><!--l. 6868--><p class="noindent" >
</p>
-<!--l. 6845--><p class="noindent" ><a
+<!--l. 6868--><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. 6848--><p class="noindent" >Originally, <span
+<!--l. 6871--><p class="noindent" >Originally, <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-125001"></a> (and <span
+ id="dx1-126001"></a> (and <span
class="cmtt-10">\newacronym</span><a
- id="dx1-125002"></a>) could only be used in the preamble. I reluctantly removed
+ id="dx1-126002"></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-125003"></a><a
- id="dx1-125004"></a> environment
+ id="dx1-126003"></a><a
+ id="dx1-126004"></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
@@ -14748,40 +14787,40 @@
necessary.)
-</p><!--l. 6858--><p class="noindent" >
+</p><!--l. 6881--><p class="noindent" >
</p>
-<!--l. 6858--><p class="noindent" ><a
+<!--l. 6881--><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. 6861--><p class="noindent" >
+<!--l. 6884--><p class="noindent" >
</p><ol class="enumerate1" >
<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,
+ class="enumerate" id="x1-127002x1">
+ <!--l. 6885--><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.
</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
+ class="enumerate" id="x1-127004x2">
+ <!--l. 6889--><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. 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
+ id="dx1-127005"></a><a
+ id="dx1-127006"></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="enumerate" id="x1-127008x3">
+ <!--l. 6898--><p class="noindent" >If you use a package, such as <span
class="cmss-10">babel</span><a
- id="dx1-126009"></a>, that makes certain characters active at the start of the <span
+ id="dx1-127009"></a>, that makes certain characters active at the start of the <span
class="cmss-10">document</span><a
- id="dx1-126010"></a><a
- id="dx1-126011"></a>
+ id="dx1-127010"></a><a
+ id="dx1-127011"></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
@@ -14791,7 +14830,7 @@
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-126012"></a> key (and they should be avoided in the label
+ id="dx1-127012"></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
@@ -14800,29 +14839,29 @@
class="cmti-10">value</span>⟩ arguments.
</p>
</li></ol>
-<!--l. 6891--><p class="noindent" >To overcome the first two problems, as from version 4.0 the <span
+<!--l. 6914--><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-126013"></a><a
- id="dx1-126014"></a> environment so that the definitions are written to an
+ id="dx1-127013"></a><a
+ id="dx1-127014"></a> environment so that the definitions are written to an
external file (<span
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
+ id="dx1-127015"></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. 6900--><p class="indent" > There are drawbacks to this mechanism: if you modify an entry definition, you need a second run to see the
+</p><!--l. 6923--><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
+</p><!--l. 6930--><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
+</p><!--l. 6934--><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
@@ -14830,25 +14869,25 @@
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-126016"></a> file. This circumvents some problems but
+ id="dx1-127016"></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. 6919--><p class="noindent" >
+</p><!--l. 6942--><p class="noindent" >
</p>
-<!--l. 6919--><p class="noindent" ><a
+<!--l. 6942--><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. 6922--><p class="noindent" >The above section covers technical issues that can cause your document to have compilation errors or produce
+<!--l. 6945--><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-127001"></a><a
- id="dx1-127002"></a> environment rather than in the preamble is that they want to
+ id="dx1-128001"></a><a
+ id="dx1-128002"></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. 6931--><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. 6954--><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,
@@ -14859,21 +14898,21 @@
</p>
-<!--l. 6944--><p class="indent" > </div>
-</p><!--l. 6944--><p class="noindent" ><a
+<!--l. 6967--><p class="indent" > </div>
+</p><!--l. 6967--><p class="noindent" ><a
href="#top">Top</a><div class="chapter"><h2 class="chapterHead">5. <a
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
+</p><!--l. 6970--><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
+ id="dx1-129001"></a> (<a
href="#sec:newglosentry">§<span
-class="cmbx-10">??</span>sec:newglosentry
+class="cmbx-10">4</span>
</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
+ id="dx1-129002"></a> (<a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </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
@@ -14882,94 +14921,94 @@
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
+</p><!--l. 6980--><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><!--l. 6984--><p class="indent" > The commands are broadly divided into:
</p><ol class="enumerate1" >
<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
+ class="enumerate" id="x1-129004x1">
+ <!--l. 6986--><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
+class="cmbx-10">5.1</span>
</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
+href="#x1-1310005.1.1">§<span
+class="cmbx-10">5.1.1</span> </a><a
+href="#x1-1310005.1.1">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
+href="#x1-1320005.1.2">§<span
+class="cmbx-10">5.1.2</span>
</a><a
-href="#sec:glstext-like">The <span
+href="#x1-1320005.1.2">The <span
class="cmtt-10">\glstext</span>-Like Commands (First Use Flag Not Queried)<!--tex4ht:ref: sec:glstext-like --></a>).
</p></li>
<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
+ class="enumerate" id="x1-129006x2">
+ <!--l. 6994--><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
+class="cmbx-10">5.2</span> </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
+<!--l. 6997--><p class="noindent" >There are additional commands specific to entries defined with <span
class="cmtt-10">\newacronym </span>that are described in
<a
href="#sec:longshortfull">§<span
-class="cmbx-10">??</span>sec:longshortfull </a><a
+class="cmbx-10">6.1</span> </a><a
href="#sec:longshortfull">Displaying the Long, Short and Full Forms (Independent of First Use)<!--tex4ht:ref: sec:longshortfull --></a>.
</p>
-<!--l. 6977--><p class="noindent" ><a
+<!--l. 7000--><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
+<!--l. 7003--><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
+href="#x1-1310005.1.1">§<span
+class="cmbx-10">5.1.1</span> </a><a
+href="#x1-1310005.1.1">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">§<span
-class="cmbx-10">??</span>sec:glstext-like </a><a
-href="#sec:glstext-like">The <span
+href="#x1-1320005.1.2">§<span
+class="cmbx-10">5.1.2</span> </a><a
+href="#x1-1320005.1.2">The <span
class="cmtt-10">\glstext</span>-Like
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-129001"></a></a> (even if there are no hyperlinks). These
+ id="dx1-130001"></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-129002"></a></a> for that entry. By default, the
+ id="dx1-130002"></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
+class="cmbx-10">12</span> </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-129003"></a></a> or <a
+ id="dx1-130003"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-129004"></a></a> unless you have chosen Options <a
+ id="dx1-130004"></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-129005"></a> these external files won’t be created. (Options <a
+ id="dx1-130005"></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
class="cmtt-10">aux</span><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
+ id="dx1-130006"></a> file.)
+</p><!--l. 7017--><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-129007"></a></a> to become quite
+ id="dx1-130007"></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">§<span
-class="cmbx-10">??</span>sec:glsnolink </a><a
+class="cmbx-10">5.2</span> </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
@@ -14977,74 +15016,74 @@
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
+</p><!--l. 7025--><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. 7007--><p class="indent" > Aside from problems with expansion issues, PDF bookmarks and possible nested hyperlinks in the table of
+</p><!--l. 7030--><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">§<span
-class="cmbx-10">??</span>sec:gls-like </a><a
-href="#sec:gls-like">The <span
+href="#x1-1310005.1.1">§<span
+class="cmbx-10">5.1.1</span> </a><a
+href="#x1-1310005.1.1">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
+</p><!--l. 7035--><p class="noindent" >
+</p><!--l. 7037--><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-129008"></a> package. Instead, use one of the <span
+ id="dx1-130008"></a> package. Instead, use one of the <span
class="cmti-10">expandable </span>commands listed in <a
href="#sec:glsnolink">§<span
-class="cmbx-10">??</span>sec:glsnolink </a><a
+class="cmbx-10">5.2</span> </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-129009"></a> <span
+ id="dx1-130009"></a> <span
class="cmti-10">but not </span>the non-expandable case changing versions like
<span
class="cmtt-10">\Glsentrytext</span><a
- id="dx1-129010"></a>). Alternatively, provide an alternative via the optional argument to the sectioning/caption
+ id="dx1-130010"></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-129011"></a>’s <span
+ id="dx1-130011"></a>’s <span
class="cmtt-10">\texorpdfstring</span><a
- id="dx1-129012"></a>. Examples:
+ id="dx1-130012"></a>. Examples:
</p>
- <pre class="verbatim" id="verbatim-183">
+ <pre class="verbatim" id="verbatim-185">
\chapter{An overview of \glsentrytext{perl}}
\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
+<!--l. 7049--><p class="nopar" >
+</p><!--l. 7050--><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
+</p><!--l. 7056--><p class="noindent" >
+</p><!--l. 7058--><p class="indent" > If you want the <a
href="#glo:linktext">link text<a
- id="dx1-129013"></a></a> to produce a hyperlink to the corresponding entry details in the glossary, you
+ id="dx1-130013"></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-129014"></a> package <span
+ id="dx1-130014"></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-129015"></a></a>, you can click on the word or phrase and it will take you to a brief
+ id="dx1-130015"></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. 7043--><p class="indent" > <div class="important" title="Important Note"> If you use the <span
+</p><!--l. 7066--><p class="indent" > <div class="important" title="Important Note"> If you use the <span
class="cmss-10">hyperref</span><a
- id="dx1-129016"></a> package, I strongly recommend you use <span
+ id="dx1-130016"></a> package, I strongly recommend you use <span
class="cmtt-10">pdflatex</span><a
- id="dx1-129017"></a> rather than <span
+ id="dx1-130017"></a> rather than <span
class="cmtt-10">latex</span><a
- id="dx1-129018"></a> to compile your
+ id="dx1-130018"></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
@@ -15053,78 +15092,78 @@
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. 7057--><p class="indent" > These are limitations of the DVI format not of the <span
+</p><!--l. 7080--><p class="indent" > These are limitations of the DVI format not of the <span
class="cmss-10">glossaries</span><a
- 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
+ id="dx1-130019"></a> package. </div>
+</p><!--l. 7082--><p class="noindent" >
+</p><!--l. 7084--><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-129020"></a> to identify the glossary lists
+ id="dx1-130020"></a> to identify the glossary lists
that shouldn’t have hyperlinked <a
href="#glo:linktext">link text<a
- id="dx1-129021"></a></a>. See <a
+ id="dx1-130021"></a></a>. See <a
href="#sec:pkgopts-general">§<span
-class="cmbx-10">??</span>sec:pkgopts-general </a><a
+class="cmbx-10">2.1</span> </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
+</p><!--l. 7090--><p class="indent" > The way the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-130022"></a></a> is displayed depends on
+</p><!--l. 7091--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-130023"></a> <span
class="cmtt-10">\glstextformat{</span>⟨<span
class="cmitt-10">text</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 7070--><p class="noindent" >
+</p><!--l. 7093--><p class="noindent" >
For example, to make all <a
href="#glo:linktext">link text<a
- id="dx1-129024"></a></a> appear in a sans-serif font, do:
+ id="dx1-130024"></a></a> appear in a sans-serif font, do:
</p>
- <pre class="verbatim" id="verbatim-184">
+ <pre class="verbatim" id="verbatim-186">
\renewcommand*{\glstextformat}[1]{\textsf{#1}}
</pre>
-<!--l. 7075--><p class="nopar" > Further customisation can be done via <span
+<!--l. 7098--><p class="nopar" > Further customisation can be done via <span
class="cmtt-10">\defglsentryfmt</span><a
- id="dx1-129025"></a> or by redefining <span
+ id="dx1-130025"></a> or by redefining <span
class="cmtt-10">\glsentryfmt</span><a
- id="dx1-129026"></a>. See <a
+ id="dx1-130026"></a>. See <a
href="#sec:glsdisplay">§<span
-class="cmbx-10">??</span>sec:glsdisplay
+class="cmbx-10">5.1.3</span>
</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
+</p><!--l. 7103--><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
-href="#sec:gls-like"><span
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> commands and are described in <a
-href="#sec:gls-like">§<span
-class="cmbx-10">??</span>sec:gls-like </a><a
-href="#sec:gls-like">The <span
+href="#x1-1310005.1.1">§<span
+class="cmbx-10">5.1.1</span> </a><a
+href="#x1-1310005.1.1">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
href="#glo:firstuseflag">first use flag</a> are
<a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands and are described in <a
-href="#sec:glstext-like">§<span
-class="cmbx-10">??</span>sec:glstext-like </a><a
-href="#sec:glstext-like">The <span
+href="#x1-1320005.1.2">§<span
+class="cmbx-10">5.1.2</span> </a><a
+href="#x1-1320005.1.2">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">§<span
-class="cmbx-10">??</span>sec:glsunset </a><a
+class="cmbx-10">7</span> </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. 7092--><p class="indent" > The <a
-href="#sec:gls-like"><span
+</p><!--l. 7115--><p class="indent" > The <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> and <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands all take a first optional argument that is a comma-separated
list of ⟨<span
class="cmti-10">key</span>⟩=⟨<span
@@ -15142,15 +15181,15 @@
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-129027"></a> list). You can override the <span
+ id="dx1-130027"></a> list). You can override the <span
class="cmtt-10">hyper</span><a
- id="dx1-129028"></a> key in the variant’s optional argument, for example,
+ id="dx1-130028"></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. 7109--><p class="indent" > <div class="important" title="Important Note"> Avoid nesting these commands. For example don’t do <span
+</p><!--l. 7132--><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
@@ -15162,69 +15201,69 @@
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-129029"></a>, <span
+ id="dx1-130029"></a>, <span
class="cmtt-10">first</span><a
- id="dx1-129030"></a>, <span
+ id="dx1-130030"></a>, <span
class="cmtt-10">short</span><a
- id="dx1-129031"></a> or <span
+ id="dx1-130031"></a> or <span
class="cmtt-10">long</span><a
- id="dx1-129032"></a> keys (or their plural equivalent) or any other key that you plan to
+ id="dx1-130032"></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-129033"></a> key if you intend to use <span
+ id="dx1-130033"></a> key if you intend to use <span
class="cmtt-10">\glssymbol</span>.)
</div>
-</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
+</p><!--l. 7142--><p class="noindent" >
+</p><!--l. 7144--><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" >
+ <!--l. 7148--><p class="noindent" >
<span
class="cmtt-10">hyper</span><a
- id="dx1-129034"></a> </p></dt><dd
+ id="dx1-130034"></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
+ <!--l. 7148--><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
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> command, if this is the first use and the <span
class="cmss-10">hyperfirst</span><span
class="cmtt-10">=</span><span
class="cmss-10">false</span><a
- id="dx1-129035"></a>
+ id="dx1-130035"></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-129036"></a>. You
+ id="dx1-130036"></a>. You
must load the <span
class="cmss-10">hyperref</span><a
- id="dx1-129037"></a> package before the <span
+ id="dx1-130037"></a> package before the <span
class="cmss-10">glossaries</span><a
- id="dx1-129038"></a> package to ensure the hyperlinks work.
+ id="dx1-130038"></a> package to ensure the hyperlinks work.
</p></dd><dt class="description">
- <!--l. 7136--><p class="noindent" >
+ <!--l. 7159--><p class="noindent" >
<span
class="cmtt-10">format</span><a
- id="dx1-129039"></a> </p></dt><dd
+ id="dx1-130039"></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
+ <!--l. 7159--><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-129040"></a></a> encap value, and (as with <span
+ id="dx1-130040"></a></a> encap value, and (as with <span
class="cmtt-10">\index</span><a
- id="dx1-129041"></a>) the value needs to be the name of a
+ id="dx1-130041"></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-129042"></a>, the characters <span class="obeylines-h"><span class="verb"><span
+ id="dx1-130042"></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,
@@ -15233,7 +15272,7 @@
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-129043"></a>, the command should be the name of a command
+ id="dx1-130043"></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
@@ -15246,18 +15285,18 @@
</p>
- <pre class="verbatim" id="verbatim-185">
+ <pre class="verbatim" id="verbatim-187">
\newcommand*{\textbfem}[1]{\textbf{\emph{#1}}}
</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
+ <!--l. 7178--><p class="nopar" > and use that command.
+ </p><!--l. 7181--><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-129044"></a> or
+ id="dx1-130044"></a> or
<span
class="cmtt-10">\emph</span><a
- id="dx1-129045"></a> or any of the commands listed in <a
+ id="dx1-130045"></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
+class="cmbx-10">5.1</span></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
@@ -15267,61 +15306,61 @@
<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. 7165--><p class="noindent" ><div class="important" title="Important Note"> If you use <a
+ </p><!--l. 7188--><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-129046"></a></a> instead of <a
+ id="dx1-130046"></a></a> instead of <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-129047"></a></a>, you must specify any non-standard formats that you want to use
+ id="dx1-130047"></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-129048"></a> key using <span
+ id="dx1-130048"></a> key using <span
class="cmtt-10">\GlsAddXdyAttribute</span><a
- id="dx1-129049"></a><span
+ id="dx1-130049"></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-129050"></a> with the above example,
+ id="dx1-130050"></a> with the above example,
you would need to add:
</p>
- <pre class="verbatim" id="verbatim-186">
+ <pre class="verbatim" id="verbatim-188">
\GlsAddXdyAttribute{textbfem}
</pre>
- <!--l. 7173--><p class="nopar" > See <a
+ <!--l. 7196--><p class="nopar" > See <a
href="#sec:xindy">§<span
-class="cmbx-10">??</span>sec:xindy </a><a
+class="cmbx-10">14</span> </a><a
href="#sec:xindy">Xindy (Option 3)<!--tex4ht:ref: sec:xindy --></a> for further details. </div>
- </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
+ </p><!--l. 7198--><p class="noindent" >
+ </p><!--l. 7200--><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-129051"></a> (provided by the <span
+ id="dx1-130051"></a> (provided by the <span
class="cmss-10">hyperref</span><a
- id="dx1-129052"></a> package) as the locations may not refer to a page number. Instead,
+ id="dx1-130052"></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 <span
-class="cmbx-10">??</span>tab:hyperxx</a>. These commands are
+class="cmbx-10">5.1</span></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-129053"></a></a> and <a
+ id="dx1-130053"></a></a> and <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-129054"></a></a> and shouldn’t be
+ id="dx1-130054"></a></a> and shouldn’t be
used in other contexts.
</p>
<div class="table">
- <!--l. 7186--><p class="noindent" ><a
+ <!--l. 7209--><p class="noindent" ><a
id="tab:hyperxx"></a></p><hr class="float" /><div class="float"
>
<div class="caption"
><span class="id">Table 5.1: </span><span
-class="content">Predefined Hyperlinked Location Formats</span></div><!--tex4ht:label?: x1-1290551 -->
+class="content">Predefined Hyperlinked Location Formats</span></div><!--tex4ht:label?: x1-1300551 -->
<div class="tabular"> <table id="TBL-6" class="tabular"
><colgroup id="TBL-6-1g"><col
@@ -15330,68 +15369,68 @@
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-129056"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-2"
+ id="dx1-130056"></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-129057"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-2"
+ id="dx1-130057"></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-129058"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-2"
+ id="dx1-130058"></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-129059"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-2"
+ id="dx1-130059"></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-129060"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-2"
+ id="dx1-130060"></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-129061"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-2"
+ id="dx1-130061"></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-129062"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-2"
+ id="dx1-130062"></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-129063"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-2"
+ id="dx1-130063"></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-129064"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-2"
+ id="dx1-130064"></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-129065"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-2"
+ id="dx1-130065"></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. 7206--><p class="noindent" >Note that if the <span
+ <!--l. 7229--><p class="noindent" >Note that if the <span
class="cmtt-10">\hyperlink</span><a
- id="dx1-129066"></a> command hasn’t been defined, the <span
+ id="dx1-130066"></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
@@ -15403,65 +15442,65 @@
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-129067"></a>:
+ id="dx1-130067"></a>:
</p>
- <pre class="verbatim" id="verbatim-187">
+ <pre class="verbatim" id="verbatim-189">
\newcommand{\hyperbsf}[1]{\textbf{\hypersf{#1}}}
</pre>
- <!--l. 7216--><p class="nopar" > and then use <span
+ <!--l. 7239--><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-129068"></a>
+ id="dx1-130068"></a>
key.<span class="footnote-mark"><a
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
+ id="x1-130069f1"></a>
+ </p><!--l. 7245--><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-129070"></a> commands, make sure
+ id="dx1-130070"></a> commands, make sure
that the argument of <span
class="cmtt-10">\hyper</span>⟨<span
class="cmitt-10">xx</span>⟩<a
- id="dx1-129071"></a> is just the location. Any formatting must be outside of <span
+ id="dx1-130071"></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-129072"></a> (as in
+ id="dx1-130072"></a> (as in
the above <span
class="cmtt-10">\hyperbfsf </span>example). </div>
- </p><!--l. 7228--><p class="noindent" >
- </p><!--l. 7230--><p class="noindent" >Remember that if you use <a
+ </p><!--l. 7251--><p class="noindent" >
+ </p><!--l. 7253--><p class="noindent" >Remember that if you use <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-129073"></a></a>, you will need to add this to the list of location <a
- id="dx1-129074"></a>attributes:
+ id="dx1-130073"></a></a>, you will need to add this to the list of location <a
+ id="dx1-130074"></a>attributes:
</p>
- <pre class="verbatim" id="verbatim-188">
+ <pre class="verbatim" id="verbatim-190">
\GlsAddXdyAttribute{hyperbsf}
</pre>
- <!--l. 7234--><p class="nopar" >
+ <!--l. 7257--><p class="nopar" >
</p></dd><dt class="description">
- <!--l. 7236--><p class="noindent" >
+ <!--l. 7259--><p class="noindent" >
<span
class="cmtt-10">counter</span><a
- id="dx1-129075"></a> </p></dt><dd
+ id="dx1-130075"></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.
+ <!--l. 7259--><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
+class="cmbx-10">12</span> </a><a
href="#sec:numberlists">Number Lists<!--tex4ht:ref: sec:numberlists --></a>.)
</p></dd><dt class="description">
- <!--l. 7240--><p class="noindent" >
+ <!--l. 7263--><p class="noindent" >
<span
class="cmtt-10">local</span><a
- id="dx1-129076"></a> </p></dt><dd
+ id="dx1-130076"></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
+ <!--l. 7263--><p class="noindent" >This is a boolean key that only makes a difference when used with <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> commands that change the
entry’s <a
href="#glo:firstuseflag">first use flag</a>. If <span
@@ -15469,102 +15508,102 @@
The default is <span
class="cmtt-10">local=false</span>.
</p></dd><dt class="description">
- <!--l. 7246--><p class="noindent" >
+ <!--l. 7269--><p class="noindent" >
<span id="textcolor272"><span id="textcolor273"><span
class="cmtt-10">noindex</span></span><a
- id="dx1-129077"></a></span> </p></dt><dd
+ id="dx1-130077"></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
+ <!--l. 7269--><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>.
</p></dd><dt class="description">
- <!--l. 7249--><p class="noindent" >
+ <!--l. 7272--><p class="noindent" >
<span id="textcolor274"><span id="textcolor275"><span
class="cmtt-10">hyperoutside</span></span><a
- id="dx1-129078"></a></span> </p></dt><dd
+ id="dx1-130078"></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
+ <!--l. 7272--><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-129079"></a>. Only
+ id="dx1-130079"></a>. Only
available with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.
</p></dd><dt class="description">
- <!--l. 7253--><p class="noindent" >
+ <!--l. 7276--><p class="noindent" >
<span id="textcolor276"><span id="textcolor277"><span
class="cmtt-10">wrgloss</span></span><a
- id="dx1-129080"></a></span> </p></dt><dd
+ id="dx1-130080"></a></span> </p></dt><dd
class="description">
- <!--l. 7253--><p class="noindent" >This key determines whether to index before (<span
+ <!--l. 7276--><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-129081"></a></a>.
+ id="dx1-130081"></a></a>.
Only available with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.
</p></dd><dt class="description">
- <!--l. 7258--><p class="noindent" >
+ <!--l. 7281--><p class="noindent" >
<span id="textcolor278"><span id="textcolor279"><span
class="cmtt-10">textformat</span></span><a
- id="dx1-129082"></a></span> </p></dt><dd
+ id="dx1-130082"></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
+ <!--l. 7281--><p class="noindent" >This key identifies the name of the control sequence to encapsulate the <a
href="#glo:linktext">link text<a
- id="dx1-129083"></a></a> instead of the default
+ id="dx1-130083"></a></a> instead of the default
<span
class="cmtt-10">\glstextformat</span><a
- id="dx1-129084"></a>. Only available with <a
+ id="dx1-130084"></a>. Only available with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.
</p></dd><dt class="description">
- <!--l. 7263--><p class="noindent" >
+ <!--l. 7286--><p class="noindent" >
<span id="textcolor280"><span id="textcolor281"><span
class="cmtt-10">prefix</span></span><a
- id="dx1-129085"></a></span> </p></dt><dd
+ id="dx1-130085"></a></span> </p></dt><dd
class="description">
- <!--l. 7263--><p class="noindent" >This key locally redefines <span
+ <!--l. 7286--><p class="noindent" >This key locally redefines <span
class="cmtt-10">\glolinkprefix</span><a
- id="dx1-129086"></a> to the given value. Only available with <a
+ id="dx1-130086"></a> to the given value. Only available with <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a>.
</p></dd><dt class="description">
- <!--l. 7267--><p class="noindent" >
+ <!--l. 7290--><p class="noindent" >
<span id="textcolor282"><span id="textcolor283"><span
class="cmtt-10">thevalue</span></span><a
- id="dx1-129087"></a></span> </p></dt><dd
+ id="dx1-130087"></a></span> </p></dt><dd
class="description">
- <!--l. 7267--><p class="noindent" >This key explicitly sets the location. Only available with <a
+ <!--l. 7290--><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>.
</p></dd><dt class="description">
- <!--l. 7271--><p class="noindent" >
+ <!--l. 7294--><p class="noindent" >
<span id="textcolor284"><span id="textcolor285"><span
class="cmtt-10">theHvalue</span></span><a
- id="dx1-129088"></a></span> </p></dt><dd
+ id="dx1-130088"></a></span> </p></dt><dd
class="description">
- <!--l. 7271--><p class="noindent" >This key explicitly sets the hyperlink location. Only available with <a
+ <!--l. 7294--><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. 7277--><p class="indent" > <div class="important" title="Important Note"> The <a
+<!--l. 7300--><p class="indent" > <div class="important" title="Important Note"> The <a
href="#glo:linktext">link text<a
- id="dx1-129089"></a></a> isn’t scoped by default with just the base <span
+ id="dx1-130089"></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-129090"></a></a> may affect subsequent text. </div>
-</p><!--l. 7281--><p class="noindent" >
-</p><!--l. 7283--><p class="noindent" >
+ id="dx1-130090"></a></a> may affect subsequent text. </div>
+</p><!--l. 7304--><p class="noindent" >
+</p><!--l. 7306--><p class="noindent" >
</p>
-<!--l. 7283--><p class="noindent" ><a
+<!--l. 7306--><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
+ id="x1-1310005.1.1"></a>The <span
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
+<!--l. 7309--><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
@@ -15574,21 +15613,21 @@
class="cmti-10">key</span>⟩=⟨<span
class="cmti-10">value</span>⟩ list. These commands use <span
class="cmtt-10">\glsentryfmt</span><a
- id="dx1-130001"></a> or the equivalent definition provided by
+ id="dx1-131001"></a> or the equivalent definition provided by
<span
class="cmtt-10">\defglsentryfmt</span><a
- id="dx1-130002"></a> to determine the automatically generated text and its format (see <a
+ id="dx1-131002"></a> to determine the automatically generated text and its format (see <a
href="#sec:glsdisplay">§<span
-class="cmbx-10">??</span>sec:glsdisplay </a><a
+class="cmbx-10">5.1.3</span> </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
+</p><!--l. 7319--><p class="indent" > Apart from <span
class="cmtt-10">\glsdisp</span><a
- id="dx1-130003"></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.
-</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
+</p><!--l. 7323--><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
@@ -15596,48 +15635,48 @@
</p>
- <pre class="verbatim" id="verbatim-189">
+ <pre class="verbatim" id="verbatim-191">
\gls{sample} {}[Editor's comment]
</pre>
-<!--l. 7309--><p class="nopar" >
-</p><!--l. 7311--><p class="indent" > Don’t use any of the <a
-href="#sec:gls-like"><span
+<!--l. 7332--><p class="nopar" >
+</p><!--l. 7334--><p class="indent" > Don’t use any of the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> or <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands in the ⟨<span
class="cmti-10">insert</span>⟩ argument. </div>
-</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
+</p><!--l. 7336--><p class="noindent" >
+</p><!--l. 7338--><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-130004"></a> and the
+ id="dx1-131004"></a> and the
<span
class="cmss-10">tabularx </span>environment provided by <span
class="cmss-10">tabularx</span><a
- id="dx1-130005"></a>. The <span
+ id="dx1-131005"></a>. The <span
class="cmss-10">glossaries </span>package automatically deals with this issue in
<span
class="cmss-10">amsmath</span><a
- id="dx1-130006"></a>’s <span
+ id="dx1-131006"></a>’s <span
class="cmss-10">align </span>environment. You can apply a patch to <span
class="cmss-10">tabularx</span><a
- id="dx1-130007"></a> by placing the following command (new to
+ id="dx1-131007"></a> by placing the following command (new to
v4.28) in the preamble:
-</p><!--l. 7323--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-130008"></a> <span
+</p><!--l. 7346--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131008"></a> <span
class="cmtt-10">\glspatchtabularx </span></div><hr>
-</p><!--l. 7325--><p class="noindent" >
+</p><!--l. 7348--><p class="noindent" >
This does nothing if <span
class="cmss-10">tabularx</span><a
- id="dx1-130009"></a> hasn’t been loaded. There’s no patch available for <span
+ id="dx1-131009"></a> hasn’t been loaded. There’s no patch available for <span
class="cmss-10">beamer</span><a
- id="dx1-130010"></a>. See <a
+ id="dx1-131010"></a>. See <a
href="#sec:glsunset">§<span
-class="cmbx-10">??</span>sec:glsunset
+class="cmbx-10">7</span>
</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
+</p><!--l. 7353--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131011"></a> <span
class="cmtt-10">\gls[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -15645,31 +15684,31 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7332--><p class="noindent" >
+</p><!--l. 7355--><p class="noindent" >
This command typically determines the <a
href="#glo:linktext">link text<a
- id="dx1-130012"></a></a> from the values of the <span
+ id="dx1-131012"></a></a> from the values of the <span
class="cmtt-10">text</span><a
- id="dx1-130013"></a> or <span
+ id="dx1-131013"></a> or <span
class="cmtt-10">first</span><a
- id="dx1-130014"></a> keys supplied when the
+ id="dx1-131014"></a> keys supplied when the
entry was defined using <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-130015"></a>. However, if the entry was defined using <span
+ id="dx1-131015"></a>. However, if the entry was defined using <span
class="cmtt-10">\newacronym</span><a
- id="dx1-130016"></a> and
+ id="dx1-131016"></a> and
<span
class="cmtt-10">\setacronymstyle</span><a
- id="dx1-130017"></a> was used, then the link text<a
- id="dx1-130018"></a> will usually be determined from the <span
+ id="dx1-131017"></a> was used, then the link text<a
+ id="dx1-131018"></a> will usually be determined from the <span
class="cmtt-10">long</span><a
- id="dx1-130019"></a> or <span
+ id="dx1-131019"></a> or <span
class="cmtt-10">short</span><a
- id="dx1-130020"></a>
+ id="dx1-131020"></a>
keys.
-</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
+</p><!--l. 7363--><p class="indent" > There are two upper case variants:
+</p><!--l. 7364--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131021"></a> <span
class="cmtt-10">\Gls[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -15677,10 +15716,10 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7343--><p class="noindent" >
+</p><!--l. 7366--><p class="noindent" >
and
-</p><!--l. 7345--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-130022"></a> <span
+</p><!--l. 7368--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131022"></a> <span
class="cmtt-10">\GLS[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -15688,59 +15727,59 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7347--><p class="noindent" >
+</p><!--l. 7370--><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-130023"></a>.
-</p><!--l. 7352--><p class="indent" > <div class="important" title="Important Note"> The first letter uppercasing command <span
+ id="dx1-131023"></a>.
+</p><!--l. 7375--><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. 7357--><p class="noindent" >
+</p><!--l. 7380--><p class="noindent" >
The upper casing is performed as follows: </p>
<ul class="itemize1">
<li class="itemize">
- <!--l. 7360--><p class="noindent" >If the first thing in the <a
+ <!--l. 7383--><p class="noindent" >If the first thing in the <a
href="#glo:linktext">link text<a
- id="dx1-130024"></a></a> is a command follow by a group, the upper casing is performed on the
+ id="dx1-131024"></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
</p>
- <pre class="verbatim" id="verbatim-190">
+ <pre class="verbatim" id="verbatim-192">
\newglossaryentry{sample}{
 name={\emph{sample} phrase},
 sort={sample phrase},
 description={an example}}
</pre>
- <!--l. 7368--><p class="nopar" > Then <span
+ <!--l. 7391--><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-130025"></a></a> to<span class="footnote-mark"><a
+ id="dx1-131025"></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>
+ id="x1-131026f2"></a>
</p>
- <pre class="verbatim" id="verbatim-191">
+ <pre class="verbatim" id="verbatim-193">
\emph{\MakeUppercase sample} phrase
</pre>
- <!--l. 7374--><p class="nopar" > which will appear as <span
+ <!--l. 7397--><p class="nopar" > which will appear as <span
class="cmti-10">Sample </span>phrase.
</p></li>
<li class="itemize">
- <!--l. 7377--><p class="noindent" >If the first thing in the <a
+ <!--l. 7400--><p class="noindent" >If the first thing in the <a
href="#glo:linktext">link text<a
- id="dx1-130027"></a></a> isn’t a command or is a command but isn’t followed by a group, then the
+ id="dx1-131027"></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:
</p>
- <pre class="verbatim" id="verbatim-192">
+ <pre class="verbatim" id="verbatim-194">
\newglossaryentry{sample}{
  name={\oe-ligature},
  sort={oe-ligature},
@@ -15747,51 +15786,51 @@
  description={an example}
}
</pre>
- <!--l. 7387--><p class="nopar" > Then <span
+ <!--l. 7410--><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-130028"></a></a> to
+ id="dx1-131028"></a></a> to
</p>
- <pre class="verbatim" id="verbatim-193">
+ <pre class="verbatim" id="verbatim-195">
\MakeUppercase \oe-ligature
</pre>
- <!--l. 7391--><p class="nopar" > which will appear as Œ-ligature.
+ <!--l. 7414--><p class="nopar" > which will appear as Œ-ligature.
</p></li>
<li class="itemize">
- <!--l. 7394--><p class="noindent" >If you have <span
+ <!--l. 7417--><p class="noindent" >If you have <span
class="cmss-10">mfirstuc</span><a
- id="dx1-130029"></a> v2.01 or above, an extra case is added. If the first thing is <span
+ id="dx1-131029"></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. 7399--><p class="noindent" >(Note the use of the <span
+<!--l. 7422--><p class="noindent" >(Note the use of the <span
class="cmtt-10">sort</span><a
- 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
+ id="dx1-131030"></a> key in the above examples.)
+</p><!--l. 7424--><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-130031"></a> to take them all into account. The above rules are
+ id="dx1-131031"></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-130032"></a></a> that starts with a text-block command (such as
+ id="dx1-131032"></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-130033"></a></a>
+ id="dx1-131033"></a></a>
starts with something that doesn’t adhere to <span
class="cmss-10">mfirstuc</span><a
- id="dx1-130034"></a>’s assumptions then things are likely to go
+ id="dx1-131034"></a>’s assumptions then things are likely to go
wrong.
-</p><!--l. 7410--><p class="indent" > For example, starting with a math-shift symbol:
+</p><!--l. 7433--><p class="indent" > For example, starting with a math-shift symbol:
</p>
- <pre class="verbatim" id="verbatim-194">
+ <pre class="verbatim" id="verbatim-196">
\newglossaryentry{sample}{
  name={$a$},
  sort={a},
@@ -15798,16 +15837,16 @@
  description={an example}
}
</pre>
-<!--l. 7417--><p class="nopar" > This falls into case 2 above, so the <a
+<!--l. 7440--><p class="nopar" > This falls into case 2 above, so the <a
href="#glo:linktext">link text<a
- id="dx1-130035"></a></a> will be set to
+ id="dx1-131035"></a></a> will be set to
</p>
- <pre class="verbatim" id="verbatim-195">
+ <pre class="verbatim" id="verbatim-197">
\MakeUppercase $a$
</pre>
-<!--l. 7421--><p class="nopar" > This attempts to uppercase the math-shift <span class="obeylines-h"><span class="verb"><span
+<!--l. 7444--><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
@@ -15816,7 +15855,7 @@
</p>
- <pre class="verbatim" id="verbatim-196">
+ <pre class="verbatim" id="verbatim-198">
\newglossaryentry{sample}{
  name={{}$a$},
  sort={a},
@@ -15823,36 +15862,36 @@
  description={an example}
}
</pre>
-<!--l. 7434--><p class="nopar" > Now the <a
+<!--l. 7457--><p class="nopar" > Now the <a
href="#glo:linktext">link text<a
- id="dx1-130036"></a></a> will be set to
+ id="dx1-131036"></a></a> will be set to
</p>
- <pre class="verbatim" id="verbatim-197">
+ <pre class="verbatim" id="verbatim-199">
\MakeUppercase{}$a$
</pre>
-<!--l. 7438--><p class="nopar" > and the <span
+<!--l. 7461--><p class="nopar" > and the <span
class="cmtt-10">\uppercase </span>becomes harmless.
-</p><!--l. 7441--><p class="indent" > Another issue occurs when the <a
+</p><!--l. 7464--><p class="indent" > Another issue occurs when the <a
href="#glo:linktext">link text<a
- id="dx1-130037"></a></a> starts with a command followed by an argument (case 1) but the
+ id="dx1-131037"></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-130038"></a></a> starts with one of the commands described in this chapter. (But you haven’t done that, have you?
+ id="dx1-131038"></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-130039"></a></a> starts with one of
+ id="dx1-131039"></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
+class="cmbx-10">5.2</span> </a><a
href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>. For
example:
</p>
- <pre class="verbatim" id="verbatim-198">
+ <pre class="verbatim" id="verbatim-200">
\newglossaryentry{sample}{name={sample},description={an example}}
\newglossaryentry{sample2}{
   name={\glsentrytext{sample} two},
@@ -15860,31 +15899,31 @@
   description={another example}
 }
</pre>
-<!--l. 7456--><p class="nopar" > Now the <a
+<!--l. 7479--><p class="nopar" > Now the <a
href="#glo:linktext">link text<a
- id="dx1-130040"></a></a> will be set to:
+ id="dx1-131040"></a></a> will be set to:
</p>
- <pre class="verbatim" id="verbatim-199">
+ <pre class="verbatim" id="verbatim-201">
\glsentrytext{\MakeUppercase sample} two
</pre>
-<!--l. 7460--><p class="nopar" > This will generate an error because there’s no entry with the label “<span
+<!--l. 7483--><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-130041"></a> field and use the command in the <span
+ id="dx1-131041"></a> field and use the command in the <span
class="cmtt-10">name</span><a
- id="dx1-130042"></a> field. If you don’t use
+ id="dx1-131042"></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-130043"></a> field:
+ id="dx1-131043"></a> field:
</p>
- <pre class="verbatim" id="verbatim-200">
+ <pre class="verbatim" id="verbatim-202">
\newglossaryentry{sample}{name={sample},description={an example}}
\newglossaryentry{sample2}{
   name={\gls{sample} two},
@@ -15893,31 +15932,31 @@
   description={another example}
 }
</pre>
-<!--l. 7474--><p class="nopar" >
-</p><!--l. 7476--><p class="indent" > If the <a
+<!--l. 7497--><p class="nopar" >
+</p><!--l. 7499--><p class="indent" > If the <a
href="#glo:linktext">link text<a
- id="dx1-130044"></a></a> starts with a command that has an optional argument or with multiple arguments where the
+ id="dx1-131044"></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>
- <pre class="verbatim" id="verbatim-201">
+ <pre class="verbatim" id="verbatim-203">
\newglossaryentry{sample}{
 name={\textcolor{blue}{sample} phrase},
 sort={sample phrase},
 description={an example}}
</pre>
-<!--l. 7485--><p class="nopar" > Now the <a
+<!--l. 7508--><p class="nopar" > Now the <a
href="#glo:linktext">link text<a
- id="dx1-130045"></a></a> will be set to:
+ id="dx1-131045"></a></a> will be set to:
</p>
- <pre class="verbatim" id="verbatim-202">
+ <pre class="verbatim" id="verbatim-204">
\textcolor{\MakeUppercase blue}{sample} phrase
</pre>
-<!--l. 7489--><p class="nopar" > This won’t work because <span class="obeylines-h"><span class="verb"><span
+<!--l. 7512--><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:
@@ -15924,7 +15963,7 @@
</p>
- <pre class="verbatim" id="verbatim-203">
+ <pre class="verbatim" id="verbatim-205">
\newglossaryentry{sample}{
\newcommand*{\blue}[1]{\textcolor{blue}{#1}}
 name={\blue{sample} phrase},
@@ -15931,12 +15970,12 @@
 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
+<!--l. 7522--><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>
- <pre class="verbatim" id="verbatim-204">
+ <pre class="verbatim" id="verbatim-206">
\newglossaryentry{sample}{
\newcommand*{\keyword}[1]{\textcolor{blue}{#1}}
 name={\keyword{sample} phrase},
@@ -15943,13 +15982,13 @@
 sort={sample phrase},
 description={an example}}
</pre>
-<!--l. 7509--><p class="nopar" > For further details see the <span
+<!--l. 7532--><p class="nopar" > For further details see the <span
class="cmss-10">mfirstuc</span><a
- id="dx1-130046"></a> user manual.
-</p><!--l. 7512--><p class="indent" > There are plural forms that are analogous to <span
+ id="dx1-131046"></a> user manual.
+</p><!--l. 7535--><p class="indent" > There are plural forms that are analogous to <span
class="cmtt-10">\gls</span>:
-</p><!--l. 7513--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-130047"></a> <span
+</p><!--l. 7536--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131047"></a> <span
class="cmtt-10">\glspl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -15957,9 +15996,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7515--><p class="noindent" >
-</p><!--l. 7516--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-130048"></a> <span
+</p><!--l. 7538--><p class="noindent" >
+</p><!--l. 7539--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131048"></a> <span
class="cmtt-10">\Glspl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -15967,9 +16006,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7518--><p class="noindent" >
-</p><!--l. 7519--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-130049"></a> <span
+</p><!--l. 7541--><p class="noindent" >
+</p><!--l. 7542--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131049"></a> <span
class="cmtt-10">\GLSpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -15977,41 +16016,41 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7521--><p class="noindent" >
+</p><!--l. 7544--><p class="noindent" >
These typically determine the link text from the <span
class="cmtt-10">plural</span><a
- id="dx1-130050"></a> or <span
+ id="dx1-131050"></a> or <span
class="cmtt-10">firstplural</span><a
- id="dx1-130051"></a> keys supplied when the entry was
+ id="dx1-131051"></a> keys supplied when the entry was
defined using <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-130052"></a> or, if the entry is an abbreviation and <span
+ id="dx1-131052"></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-130053"></a> or <span
+ id="dx1-131053"></a> or <span
class="cmtt-10">shortplural</span><a
- 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
+ id="dx1-131054"></a> keys.
+</p><!--l. 7551--><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-130055"></a> as it can affect
+ id="dx1-131055"></a> as it can affect
the spacing of subscripts and superscripts. For example, suppose you have defined the following
entry:
</p>
- <pre class="verbatim" id="verbatim-205">
+ <pre class="verbatim" id="verbatim-207">
\newglossaryentry{Falpha}{name={F_\alpha},
description=sample}
</pre>
-<!--l. 7536--><p class="nopar" > and later you use it in math mode:
+<!--l. 7559--><p class="nopar" > and later you use it in math mode:
</p>
- <pre class="verbatim" id="verbatim-206">
+ <pre class="verbatim" id="verbatim-208">
$\gls{Falpha}^2$
</pre>
-<!--l. 7540--><p class="nopar" > This will result in <span
+<!--l. 7563--><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
@@ -16023,13 +16062,13 @@
</p>
- <pre class="verbatim" id="verbatim-207">
+ <pre class="verbatim" id="verbatim-209">
$\gls{Falpha}[^2]$
</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
+<!--l. 7569--><p class="nopar" > </div>
+</p><!--l. 7570--><p class="noindent" >
+</p><!--l. 7572--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-131056"></a> <span
class="cmtt-10">\glsdisp[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16037,27 +16076,27 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">link text</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 7551--><p class="noindent" >
+</p><!--l. 7574--><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. 7557--><p class="indent" > <div class="important" title="Important Note"> Don’t use any of the <a
-href="#sec:gls-like"><span
+</p><!--l. 7580--><p class="indent" > <div class="important" title="Important Note"> Don’t use any of the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> or <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
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. 7560--><p class="noindent" >
-</p><!--l. 7562--><p class="noindent" >
+</p><!--l. 7583--><p class="noindent" >
+</p><!--l. 7585--><p class="noindent" >
</p>
-<!--l. 7562--><p class="noindent" ><a
+<!--l. 7585--><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
+ id="x1-1320005.1.2"></a>The <span
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
+<!--l. 7588--><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
@@ -16066,31 +16105,31 @@
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-131001"></a> or the equivalent
+ id="dx1-132001"></a> or the equivalent
definition provided by <span
class="cmtt-10">\defglsentryfmt</span><a
- id="dx1-131002"></a> (see <a
+ id="dx1-132002"></a> (see <a
href="#sec:glsdisplay">§<span
-class="cmbx-10">??</span>sec:glsdisplay </a><a
+class="cmbx-10">5.1.3</span> </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
+class="cmbx-10">6</span> </a><a
href="#sec:acronyms">Acronyms and Other
Abbreviations<!--tex4ht:ref: sec:acronyms --></a>.
-</p><!--l. 7575--><p class="indent" > Apart from <span
+</p><!--l. 7598--><p class="indent" > Apart from <span
class="cmtt-10">\glslink</span><a
- id="dx1-131003"></a>, the commands described in this section also have a <span
+ id="dx1-132003"></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">§<span
-class="cmbx-10">??</span>sec:gls-like </a><a
-href="#sec:gls-like">The <span
+href="#x1-1310005.1.1">§<span
+class="cmbx-10">5.1.1</span> </a><a
+href="#x1-1310005.1.1">The <span
class="cmtt-10">\gls</span>-Like Commands (First Use Flag Queried)<!--tex4ht:ref: sec:gls-like --></a>.
-</p><!--l. 7580--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131004"></a> <span
+</p><!--l. 7603--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132004"></a> <span
class="cmtt-10">\glslink[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16098,23 +16137,23 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">link text</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 7582--><p class="noindent" >
+</p><!--l. 7605--><p class="noindent" >
This command explicitly sets the <a
href="#glo:linktext">link text<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
+ id="dx1-132005"></a></a> as given in the final argument.
+</p><!--l. 7609--><p class="indent" > <div class="important" title="Important Note"> Don’t use any of the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> or <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands in the argument of <span
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-131006"></a></a>.
+ id="dx1-132006"></a></a>.
</div>
-</p><!--l. 7591--><p class="noindent" >
-</p><!--l. 7593--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131007"></a> <span
+</p><!--l. 7614--><p class="noindent" >
+</p><!--l. 7616--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132007"></a> <span
class="cmtt-10">\glstext[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16122,15 +16161,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7595--><p class="noindent" >
+</p><!--l. 7618--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">text</span><a
- id="dx1-131008"></a> key as the <a
+ id="dx1-132008"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132009"></a></a>.
+</p><!--l. 7622--><p class="indent" > There are also analogous commands:
+</p><!--l. 7623--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132010"></a> <span
class="cmtt-10">\Glstext[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16138,11 +16177,11 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7602--><p class="noindent" >
+</p><!--l. 7625--><p class="noindent" >
-</p><!--l. 7603--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131011"></a> <span
+</p><!--l. 7626--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132011"></a> <span
class="cmtt-10">\GLStext[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16150,27 +16189,27 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7605--><p class="noindent" >
+</p><!--l. 7628--><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. 7610--><p class="indent" > There’s no equivalent command for title-casing, but you can use the more generic command
+</p><!--l. 7633--><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-131012"></a> in combination with <span
+ id="dx1-132012"></a> in combination with <span
class="cmtt-10">\glslink</span>. For example:
</p>
- <pre class="verbatim" id="verbatim-208">
+ <pre class="verbatim" id="verbatim-210">
\glslink{sample}{\glsentrytitlecase{sample}{text}}
</pre>
-<!--l. 7615--><p class="nopar" > (See <a
+<!--l. 7638--><p class="nopar" > (See <a
href="#sec:glsnolink">§<span
-class="cmbx-10">??</span>sec:glsnolink </a><a
+class="cmbx-10">5.2</span> </a><a
href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>.)
-</p><!--l. 7618--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131013"></a> <span
+</p><!--l. 7641--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132013"></a> <span
class="cmtt-10">\glsfirst[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16178,15 +16217,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7620--><p class="noindent" >
+</p><!--l. 7643--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">first</span><a
- id="dx1-131014"></a> key as the <a
+ id="dx1-132014"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132015"></a></a>.
+</p><!--l. 7647--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7648--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132016"></a> <span
class="cmtt-10">\Glsfirst[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16194,9 +16233,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7627--><p class="noindent" >
-</p><!--l. 7628--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131017"></a> <span
+</p><!--l. 7650--><p class="noindent" >
+</p><!--l. 7651--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132017"></a> <span
class="cmtt-10">\GLSfirst[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16204,36 +16243,36 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7630--><p class="noindent" >
-</p><!--l. 7632--><p class="indent" > <div class="important" title="Important Note"> The value of the <span
+</p><!--l. 7653--><p class="noindent" >
+</p><!--l. 7655--><p class="indent" > <div class="important" title="Important Note"> The value of the <span
class="cmtt-10">first</span><a
- id="dx1-131018"></a> key (and <span
+ id="dx1-132018"></a> key (and <span
class="cmtt-10">firstplural</span><a
- id="dx1-131019"></a> key) doesn’t necessarily match the text produced by <span
+ id="dx1-132019"></a> key) doesn’t necessarily match the text produced by <span
class="cmtt-10">\gls</span><a
- id="dx1-131020"></a> (or
+ id="dx1-132020"></a> (or
<span
class="cmtt-10">\glspl</span><a
- id="dx1-131021"></a>) on <a
+ id="dx1-132021"></a>) on <a
href="#glo:firstuse">first use</a> as the <a
href="#glo:linktext">link text<a
- id="dx1-131022"></a></a> used by <span
+ id="dx1-132022"></a></a> used by <span
class="cmtt-10">\gls</span><a
- id="dx1-131023"></a> may be modified through commands like <span
+ id="dx1-132023"></a> may be modified through commands like <span
class="cmtt-10">\defglsentry</span><a
- id="dx1-131024"></a>.
+ id="dx1-132024"></a>.
(Similarly, the value of the <span
class="cmtt-10">text</span><a
- id="dx1-131025"></a> and <span
+ id="dx1-132025"></a> and <span
class="cmtt-10">plural</span><a
- id="dx1-131026"></a> keys don’t necessarily match the link text<a
- id="dx1-131027"></a> used by <span
+ id="dx1-132026"></a> keys don’t necessarily match the link text<a
+ id="dx1-132027"></a> used by <span
class="cmtt-10">\gls </span>or <span
class="cmtt-10">\glspl</span>
on subsequent use.) </div>
-</p><!--l. 7640--><p class="noindent" >
-</p><!--l. 7642--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131028"></a> <span
+</p><!--l. 7663--><p class="noindent" >
+</p><!--l. 7665--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132028"></a> <span
class="cmtt-10">\glsplural[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16241,15 +16280,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7644--><p class="noindent" >
+</p><!--l. 7667--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">plural</span><a
- id="dx1-131029"></a> key as the <a
+ id="dx1-132029"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132030"></a></a>.
+</p><!--l. 7671--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7672--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132031"></a> <span
class="cmtt-10">\Glsplural[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16257,9 +16296,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7651--><p class="noindent" >
-</p><!--l. 7652--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131032"></a> <span
+</p><!--l. 7674--><p class="noindent" >
+</p><!--l. 7675--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132032"></a> <span
class="cmtt-10">\GLSplural[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16267,9 +16306,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7654--><p class="noindent" >
-</p><!--l. 7656--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131033"></a> <span
+</p><!--l. 7677--><p class="noindent" >
+</p><!--l. 7679--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132033"></a> <span
class="cmtt-10">\glsfirstplural[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16277,15 +16316,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7658--><p class="noindent" >
+</p><!--l. 7681--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">firstplural</span><a
- id="dx1-131034"></a> key as the <a
+ id="dx1-132034"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132035"></a></a>.
+</p><!--l. 7685--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7686--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132036"></a> <span
class="cmtt-10">\Glsfirstplural[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16293,9 +16332,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7665--><p class="noindent" >
-</p><!--l. 7666--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131037"></a> <span
+</p><!--l. 7688--><p class="noindent" >
+</p><!--l. 7689--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132037"></a> <span
class="cmtt-10">\GLSfirstplural[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16303,9 +16342,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7668--><p class="noindent" >
-</p><!--l. 7670--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131038"></a> <span
+</p><!--l. 7691--><p class="noindent" >
+</p><!--l. 7693--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132038"></a> <span
class="cmtt-10">\glsname[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16313,26 +16352,26 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7672--><p class="noindent" >
+</p><!--l. 7695--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">name</span><a
- id="dx1-131039"></a> key as the <a
+ id="dx1-132039"></a> key as the <a
href="#glo:linktext">link text<a
- id="dx1-131040"></a></a>. Note that this may be different from the
+ id="dx1-132040"></a></a>. Note that this may be different from the
values of the <span
class="cmtt-10">text</span><a
- id="dx1-131041"></a> or <span
+ id="dx1-132041"></a> or <span
class="cmtt-10">first</span><a
- id="dx1-131042"></a> keys. In general it’s better to use <span
+ id="dx1-132042"></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. 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
+</p><!--l. 7701--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7702--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132043"></a> <span
class="cmtt-10">\Glsname[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16340,9 +16379,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7681--><p class="noindent" >
-</p><!--l. 7682--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131044"></a> <span
+</p><!--l. 7704--><p class="noindent" >
+</p><!--l. 7705--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132044"></a> <span
class="cmtt-10">\GLSname[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16350,16 +16389,16 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</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
+</p><!--l. 7707--><p class="noindent" >
+</p><!--l. 7709--><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. 7689--><p class="noindent" >
-</p><!--l. 7691--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131045"></a> <span
+</p><!--l. 7712--><p class="noindent" >
+</p><!--l. 7714--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132045"></a> <span
class="cmtt-10">\glssymbol[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16367,15 +16406,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7693--><p class="noindent" >
+</p><!--l. 7716--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">symbol</span><a
- id="dx1-131046"></a> key as the <a
+ id="dx1-132046"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132047"></a></a>.
+</p><!--l. 7720--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7721--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132048"></a> <span
class="cmtt-10">\Glssymbol[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16383,9 +16422,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7700--><p class="noindent" >
-</p><!--l. 7701--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131049"></a> <span
+</p><!--l. 7723--><p class="noindent" >
+</p><!--l. 7724--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132049"></a> <span
class="cmtt-10">\GLSsymbol[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16393,9 +16432,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7703--><p class="noindent" >
-</p><!--l. 7705--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131050"></a> <span
+</p><!--l. 7726--><p class="noindent" >
+</p><!--l. 7728--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132050"></a> <span
class="cmtt-10">\glsdesc[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16403,15 +16442,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7707--><p class="noindent" >
+</p><!--l. 7730--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">description</span><a
- id="dx1-131051"></a> key as the <a
+ id="dx1-132051"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132052"></a></a>.
+</p><!--l. 7734--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7735--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132053"></a> <span
class="cmtt-10">\Glsdesc[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16419,9 +16458,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7714--><p class="noindent" >
-</p><!--l. 7715--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131054"></a> <span
+</p><!--l. 7737--><p class="noindent" >
+</p><!--l. 7738--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132054"></a> <span
class="cmtt-10">\GLSdesc[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16429,17 +16468,17 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7717--><p class="noindent" >
-</p><!--l. 7719--><p class="indent" > If you want the title case version you can use
+</p><!--l. 7740--><p class="noindent" >
+</p><!--l. 7742--><p class="indent" > If you want the title case version you can use
</p>
- <pre class="verbatim" id="verbatim-209">
+ <pre class="verbatim" id="verbatim-211">
\glslink{sample}{\glsentrytitlecase{sample}{desc}}
</pre>
-<!--l. 7722--><p class="nopar" >
-</p><!--l. 7724--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131055"></a> <span
+<!--l. 7745--><p class="nopar" >
+</p><!--l. 7747--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132055"></a> <span
class="cmtt-10">\glsuseri[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16447,15 +16486,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7726--><p class="noindent" >
+</p><!--l. 7749--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">user1</span><a
- id="dx1-131056"></a> key as the <a
+ id="dx1-132056"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132057"></a></a>.
+</p><!--l. 7753--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7754--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132058"></a> <span
class="cmtt-10">\Glsuseri[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16463,9 +16502,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7733--><p class="noindent" >
-</p><!--l. 7734--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131059"></a> <span
+</p><!--l. 7756--><p class="noindent" >
+</p><!--l. 7757--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132059"></a> <span
class="cmtt-10">\GLSuseri[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16473,9 +16512,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7736--><p class="noindent" >
-</p><!--l. 7738--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131060"></a> <span
+</p><!--l. 7759--><p class="noindent" >
+</p><!--l. 7761--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132060"></a> <span
class="cmtt-10">\glsuserii[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16483,15 +16522,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7740--><p class="noindent" >
+</p><!--l. 7763--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">user2</span><a
- id="dx1-131061"></a> key as the <a
+ id="dx1-132061"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132062"></a></a>.
+</p><!--l. 7767--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7768--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132063"></a> <span
class="cmtt-10">\Glsuserii[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16499,9 +16538,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7747--><p class="noindent" >
-</p><!--l. 7748--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131064"></a> <span
+</p><!--l. 7770--><p class="noindent" >
+</p><!--l. 7771--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132064"></a> <span
class="cmtt-10">\GLSuserii[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16509,9 +16548,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7750--><p class="noindent" >
-</p><!--l. 7752--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131065"></a> <span
+</p><!--l. 7773--><p class="noindent" >
+</p><!--l. 7775--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132065"></a> <span
class="cmtt-10">\glsuseriii[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16519,15 +16558,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7754--><p class="noindent" >
+</p><!--l. 7777--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">user3</span><a
- id="dx1-131066"></a> key as the <a
+ id="dx1-132066"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132067"></a></a>.
+</p><!--l. 7781--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7782--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132068"></a> <span
class="cmtt-10">\Glsuseriii[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16535,9 +16574,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7761--><p class="noindent" >
-</p><!--l. 7762--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131069"></a> <span
+</p><!--l. 7784--><p class="noindent" >
+</p><!--l. 7785--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132069"></a> <span
class="cmtt-10">\GLSuseriii[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16545,9 +16584,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7764--><p class="noindent" >
-</p><!--l. 7766--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131070"></a> <span
+</p><!--l. 7787--><p class="noindent" >
+</p><!--l. 7789--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132070"></a> <span
class="cmtt-10">\glsuseriv[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16555,15 +16594,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7768--><p class="noindent" >
+</p><!--l. 7791--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">user4</span><a
- id="dx1-131071"></a> key as the <a
+ id="dx1-132071"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132072"></a></a>.
+</p><!--l. 7795--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7796--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132073"></a> <span
class="cmtt-10">\Glsuseriv[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16571,9 +16610,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7775--><p class="noindent" >
-</p><!--l. 7776--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131074"></a> <span
+</p><!--l. 7798--><p class="noindent" >
+</p><!--l. 7799--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132074"></a> <span
class="cmtt-10">\GLSuseriv[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16583,9 +16622,9 @@
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7778--><p class="noindent" >
-</p><!--l. 7780--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131075"></a> <span
+</p><!--l. 7801--><p class="noindent" >
+</p><!--l. 7803--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132075"></a> <span
class="cmtt-10">\glsuserv[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16593,15 +16632,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7782--><p class="noindent" >
+</p><!--l. 7805--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">user5</span><a
- id="dx1-131076"></a> key as the <a
+ id="dx1-132076"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132077"></a></a>.
+</p><!--l. 7809--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7810--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132078"></a> <span
class="cmtt-10">\Glsuserv[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16609,9 +16648,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7789--><p class="noindent" >
-</p><!--l. 7790--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131079"></a> <span
+</p><!--l. 7812--><p class="noindent" >
+</p><!--l. 7813--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132079"></a> <span
class="cmtt-10">\GLSuserv[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16619,9 +16658,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7792--><p class="noindent" >
-</p><!--l. 7794--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131080"></a> <span
+</p><!--l. 7815--><p class="noindent" >
+</p><!--l. 7817--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132080"></a> <span
class="cmtt-10">\glsuservi[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16629,15 +16668,15 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7796--><p class="noindent" >
+</p><!--l. 7819--><p class="noindent" >
This command always uses the value of the <span
class="cmtt-10">user6</span><a
- id="dx1-131081"></a> key as the <a
+ id="dx1-132081"></a> key as the <a
href="#glo:linktext">link text<a
- 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
+ id="dx1-132082"></a></a>.
+</p><!--l. 7823--><p class="indent" > There are also analogous uppercasing commands:
+</p><!--l. 7824--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132083"></a> <span
class="cmtt-10">\Glsuservi[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16645,9 +16684,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7803--><p class="noindent" >
-</p><!--l. 7804--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-131084"></a> <span
+</p><!--l. 7826--><p class="noindent" >
+</p><!--l. 7827--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-132084"></a> <span
class="cmtt-10">\GLSuservi[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -16655,120 +16694,120 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 7806--><p class="noindent" >
-</p><!--l. 7808--><p class="noindent" >
+</p><!--l. 7829--><p class="noindent" >
+</p><!--l. 7831--><p class="noindent" >
</p>
-<!--l. 7808--><p class="noindent" ><a
+<!--l. 7831--><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
+<!--l. 7834--><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. 7815--><p class="noindent" >
-</p><!--l. 7817--><p class="noindent" >The default format of the <a
+</p><!--l. 7838--><p class="noindent" >
+</p><!--l. 7840--><p class="noindent" >The default format of the <a
href="#glo:linktext">link text<a
- id="dx1-132001"></a></a> for the <a
-href="#sec:gls-like"><span
+ id="dx1-133001"></a></a> for the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> commands is governed
by<span class="footnote-mark"><a
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
+ id="x1-133002f3"></a>:
+</p><!--l. 7844--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133006"></a> <span
class="cmtt-10">\glsentryfmt </span></div><hr>
-</p><!--l. 7823--><p class="noindent" >
+</p><!--l. 7846--><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. 7826--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132007"></a> <span
+</p><!--l. 7849--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133007"></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. 7828--><p class="noindent" >
+</p><!--l. 7851--><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-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
+ id="dx1-133008"></a> if omitted. The second argument is the entry format definition.
+</p><!--l. 7857--><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-132009"></a>, redefining <span
+ id="dx1-133009"></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-132010"></a> or the command <span
+ id="dx1-133010"></a> or the command <span
class="cmtt-10">\DeclareAcronymList</span><a
- id="dx1-132011"></a>, see
+ id="dx1-133011"></a>, see
<a
href="#sec:pkgopts-acronym">§<span
-class="cmbx-10">??</span>sec:pkgopts-acronym </a><a
+class="cmbx-10">2.7</span> </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. 7844--><p class="noindent" >
-</p><!--l. 7846--><p class="indent" > Within the ⟨<span
+</p><!--l. 7867--><p class="noindent" >
+</p><!--l. 7869--><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. 7850--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132012"></a> <span
+</p><!--l. 7873--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133012"></a> <span
class="cmtt-10">\glslabel </span></div><hr>
-</p><!--l. 7852--><p class="noindent" >
+</p><!--l. 7875--><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. 7855--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132013"></a> <span
+</p><!--l. 7878--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133013"></a> <span
class="cmtt-10">\glstype </span></div><hr>
-</p><!--l. 7857--><p class="noindent" >
+</p><!--l. 7880--><p class="noindent" >
This is defined using <span
class="cmtt-10">\edef</span><a
- id="dx1-132014"></a> so the replacement text is the actual glossary type rather than
+ id="dx1-133014"></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. 7861--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132015"></a> <span
+</p><!--l. 7884--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133015"></a> <span
class="cmtt-10">\glscustomtext </span></div><hr>
-</p><!--l. 7863--><p class="noindent" >
+</p><!--l. 7886--><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-132016"></a>, <span
+ id="dx1-133016"></a>, <span
class="cmtt-10">\glspl</span><a
- id="dx1-132017"></a> and their upper case variants.
+ id="dx1-133017"></a> and their upper case variants.
(You can use <span
class="cmss-10">etoolbox</span><a
- id="dx1-132018"></a>’s <span
+ id="dx1-133018"></a>’s <span
class="cmtt-10">\ifdefempty </span>to determine if <span
class="cmtt-10">\glscustomtext </span>is empty.)
-</p><!--l. 7869--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132019"></a> <span
+</p><!--l. 7892--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133019"></a> <span
class="cmtt-10">\glsinsert </span></div><hr>
-</p><!--l. 7871--><p class="noindent" >
+</p><!--l. 7894--><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. 7875--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132020"></a> <span
+</p><!--l. 7898--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133020"></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. 7877--><p class="noindent" >
+</p><!--l. 7900--><p class="noindent" >
If <span
class="cmtt-10">\glspl</span>, <span
class="cmtt-10">\Glspl </span>or <span
@@ -16775,8 +16814,8 @@
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. 7881--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132021"></a> <span
+</p><!--l. 7904--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133021"></a> <span
class="cmtt-10">\glscapscase{</span>⟨<span
class="cmitt-10">no case</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -16784,7 +16823,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">all caps</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 7883--><p class="noindent" >
+</p><!--l. 7906--><p class="noindent" >
If <span
class="cmtt-10">\gls</span>, <span
class="cmtt-10">\glspl </span>or <span
@@ -16797,41 +16836,41 @@
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. 7888--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132022"></a> <span
+</p><!--l. 7911--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133022"></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. 7890--><p class="noindent" >
+</p><!--l. 7913--><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-132023"></a> key or the use of a starred
+ id="dx1-133023"></a> key or the use of a starred
command. It may be off because the <span
class="cmss-10">hyperref</span><a
- id="dx1-132024"></a> package hasn’t been loaded or because <span
+ id="dx1-133024"></a> package hasn’t been loaded or because <span
class="cmtt-10">\glsdisablehyper</span><a
- id="dx1-132025"></a>
+ id="dx1-133025"></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-132026"></a>) or because it’s the <a
+ id="dx1-133026"></a>) or because it’s the <a
href="#glo:firstuse">first use</a> and the hyperlinks have been suppressed on first
use.
-</p><!--l. 7901--><p class="indent" > <div class="important" title="Important Note"> The <span
+</p><!--l. 7924--><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-132027"></a>, which is now deprecated (and no
+ id="dx1-133027"></a>, which is now deprecated (and no
longer documented). </div>
-</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
+</p><!--l. 7927--><p class="noindent" >
+</p><!--l. 7929--><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. 7908--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132028"></a> <span
+</p><!--l. 7931--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133028"></a> <span
class="cmtt-10">\glslinkvar{</span>⟨<span
class="cmitt-10">unmodified</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -16839,7 +16878,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">plus</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 7910--><p class="noindent" >
+</p><!--l. 7933--><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
@@ -16846,58 +16885,58 @@
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-132029"></a> key was used to
+ id="dx1-133029"></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. 7919--><p class="indent" > Note that you can also use commands such as <span
+</p><!--l. 7942--><p class="indent" > Note that you can also use commands such as <span
class="cmtt-10">\ifglsused</span><a
- id="dx1-132030"></a> within the definition of <span
+ id="dx1-133030"></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
+class="cmbx-10">7</span> </a><a
href="#sec:glsunset">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>).
-</p><!--l. 7922--><p class="indent" > The commands <span
+</p><!--l. 7945--><p class="indent" > The commands <span
class="cmtt-10">\glslabel</span><a
- id="dx1-132031"></a>, <span
+ id="dx1-133031"></a>, <span
class="cmtt-10">\glstype</span><a
- id="dx1-132032"></a>, <span
+ id="dx1-133032"></a>, <span
class="cmtt-10">\glsifplural</span><a
- id="dx1-132033"></a>, <span
+ id="dx1-133033"></a>, <span
class="cmtt-10">\glscapscase</span><a
- id="dx1-132034"></a>, <span
+ id="dx1-133034"></a>, <span
class="cmtt-10">\glsinsert</span><a
- id="dx1-132035"></a> and <span
+ id="dx1-133035"></a> and <span
class="cmtt-10">\glscustomtext</span><a
- id="dx1-132036"></a> are
+ id="dx1-133036"></a> are
typically updated at the start of the <a
-href="#sec:gls-like"><span
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> and <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><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-132037"></a> and <span
+ id="dx1-133037"></a> and <span
class="cmtt-10">\glslinkpostsetkeys</span><a
- id="dx1-132038"></a>.
-</p><!--l. 7928--><p class="indent" > <div class="important" title="Important Note"> This means that using commands like <span
+ id="dx1-133038"></a>.
+</p><!--l. 7951--><p class="indent" > <div class="important" title="Important Note"> This means that using commands like <span
class="cmtt-10">\gls</span><a
- id="dx1-132039"></a> within the fields that are accessed using the <a
-href="#sec:gls-like"><span
+ id="dx1-133039"></a> within the fields that are accessed using the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> or
<a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands (such as the <span
class="cmtt-10">first</span><a
- id="dx1-132040"></a>, <span
+ id="dx1-133040"></a>, <span
class="cmtt-10">text</span><a
- id="dx1-132041"></a>, <span
+ id="dx1-133041"></a>, <span
class="cmtt-10">long</span><a
- id="dx1-132042"></a> or <span
+ id="dx1-133042"></a> or <span
class="cmtt-10">short</span><a
- id="dx1-132043"></a> keys) will cause a problem. The entry
+ id="dx1-133043"></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
@@ -16905,200 +16944,200 @@
means that any nested commands will, at the very least, change the label stored in <span
class="cmtt-10">\glslabel</span>.
</div>
-</p><!--l. 7938--><p class="noindent" >
-</p><!--l. 7940--><p class="indent" > If you only want to make minor modifications to <span
+</p><!--l. 7961--><p class="noindent" >
+</p><!--l. 7963--><p class="indent" > If you only want to make minor modifications to <span
class="cmtt-10">\glsentryfmt</span>, you can use
-</p><!--l. 7942--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132044"></a> <span
+</p><!--l. 7965--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133044"></a> <span
class="cmtt-10">\glsgenentryfmt </span></div><hr>
-</p><!--l. 7944--><p class="noindent" >
+</p><!--l. 7967--><p class="noindent" >
This uses the above commands to display just the <span
class="cmtt-10">first</span><a
- id="dx1-132045"></a>, <span
+ id="dx1-133045"></a>, <span
class="cmtt-10">text</span><a
- id="dx1-132046"></a>, <span
+ id="dx1-133046"></a>, <span
class="cmtt-10">plural</span><a
- id="dx1-132047"></a> or <span
+ id="dx1-133047"></a> or <span
class="cmtt-10">firstplural</span><a
- id="dx1-132048"></a> keys (or the custom
+ id="dx1-133048"></a> keys (or the custom
text) with the insert text appended.
-</p><!--l. 7949--><p class="indent" > Alternatively, if you want to change the entry format for abbreviations (defined via <span
+</p><!--l. 7972--><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-132049"></a>) you can
+ id="dx1-133049"></a>) you can
use:
-</p><!--l. 7951--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132050"></a> <span
+</p><!--l. 7974--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133050"></a> <span
class="cmtt-10">\glsgenacfmt </span></div><hr>
-</p><!--l. 7953--><p class="noindent" >
+</p><!--l. 7976--><p class="noindent" >
This uses the values from the <span
class="cmtt-10">long</span><a
- id="dx1-132051"></a>, <span
+ id="dx1-133051"></a>, <span
class="cmtt-10">short</span><a
- id="dx1-132052"></a>, <span
+ id="dx1-133052"></a>, <span
class="cmtt-10">longplural</span><a
- id="dx1-132053"></a> and <span
+ id="dx1-133053"></a> and <span
class="cmtt-10">shortplural</span><a
- id="dx1-132054"></a> keys, rather than using the <span
+ id="dx1-133054"></a> keys, rather than using the <span
class="cmtt-10">text</span><a
- id="dx1-132055"></a>,
+ id="dx1-133055"></a>,
<span
class="cmtt-10">plural</span><a
- id="dx1-132056"></a>, <span
+ id="dx1-133056"></a>, <span
class="cmtt-10">first</span><a
- id="dx1-132057"></a> and <span
+ id="dx1-133057"></a> and <span
class="cmtt-10">firstplural</span><a
- 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
+ id="dx1-133058"></a> keys. The first use singular text is obtained via:
+</p><!--l. 7981--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133059"></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. 7960--><p class="noindent" >
+</p><!--l. 7983--><p class="noindent" >
instead of from the <span
class="cmtt-10">first</span><a
- 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
+ id="dx1-133060"></a> key, and the first use plural text is obtained via:
+</p><!--l. 7986--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133061"></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. 7965--><p class="noindent" >
+</p><!--l. 7988--><p class="noindent" >
instead of from the <span
class="cmtt-10">firstplural</span><a
- id="dx1-132062"></a> key. In both cases, ⟨<span
+ id="dx1-133062"></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-132063"></a>. The default behaviour is to do the long form (or
+ id="dx1-133063"></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-132064"></a>. There are also first letter upper case
+ id="dx1-133064"></a>. There are also first letter upper case
versions:
-</p><!--l. 7974--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132065"></a> <span
+</p><!--l. 7997--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133065"></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. 7976--><p class="noindent" >
+</p><!--l. 7999--><p class="noindent" >
and
-</p><!--l. 7978--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132066"></a> <span
+</p><!--l. 8001--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133066"></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. 7980--><p class="noindent" >
+</p><!--l. 8003--><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-132067"></a> to convert the first character to upper case. If there are issues caused by this expansion, you
+ id="dx1-133067"></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-132068"></a> (which is
+ id="dx1-133068"></a> (which is
what the predefined acronym styles, such as <span
class="cmss-10">long-short</span><a
- id="dx1-132069"></a>, do). Otherwise, you only need to redefine
+ id="dx1-133069"></a>, do). Otherwise, you only need to redefine
<span
class="cmtt-10">\genacrfullformat</span><a
- id="dx1-132070"></a> and <span
+ id="dx1-133070"></a> and <span
class="cmtt-10">\genplacrfullformat</span><a
- id="dx1-132071"></a> to change the behaviour of <span
+ id="dx1-133071"></a> to change the behaviour of <span
class="cmtt-10">\glsgenacfmt</span><a
- id="dx1-132072"></a>. See
+ id="dx1-133072"></a>. See
<a
href="#sec:acronyms">§<span
-class="cmbx-10">??</span>sec:acronyms </a><a
+class="cmbx-10">6</span> </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
+</p><!--l. 8015--><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
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands. </div>
-</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
+</p><!--l. 8018--><p class="noindent" >
+</p><!--l. 8020--><p class="indent" > As from version 4.16, both the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> and <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands use
-</p><!--l. 7999--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132073"></a> <span
+</p><!--l. 8022--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133073"></a> <span
class="cmtt-10">\glslinkpostsetkeys </span></div><hr>
-</p><!--l. 8001--><p class="noindent" >
+</p><!--l. 8024--><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. 8005--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-132074"></a> <span
+</p><!--l. 8028--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-133074"></a> <span
class="cmtt-10">\glspostlinkhook </span></div><hr>
-</p><!--l. 8007--><p class="noindent" >
+</p><!--l. 8030--><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">18<!--tex4ht:ref: ex:dotabbr --></a>).
+href="#x1-140078r18">18<!--tex4ht:ref: ex:dotabbr --></a>).
<a
- id="ex:customfmt"></a>
-</p><!--l. 8012--><p class="noindent" ><span
+ id="x1-133075r8"></a>
+</p><!--l. 8035--><p class="noindent" ><span
class="cmbx-12">Example 8</span><span
class="cmbx-12"> (Custom Entry Display in Text)</span><a
- id="x1-132076"></a>
-</p><!--l. 8013--><p class="indent" > Suppose you want a glossary of measurements and units, you can use the <span
+ id="x1-133076"></a>
+</p><!--l. 8036--><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-132077"></a> key to store the
+ id="dx1-133077"></a> key to store the
unit:
</p>
- <pre class="verbatim" id="verbatim-210">
+ <pre class="verbatim" id="verbatim-212">
\newglossaryentry{distance}{name=distance,
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
+<!--l. 8042--><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-132078"></a> as follows:
+ id="dx1-133078"></a> as follows:
</p>
- <pre class="verbatim" id="verbatim-211">
+ <pre class="verbatim" id="verbatim-213">
\renewcommand*{\glsentryfmt}{%
  \glsgenentryfmt
  \ifglsused{\glslabel}{}{\space (\glsentrysymbol{\glslabel})}%
}
</pre>
-<!--l. 8028--><p class="nopar" >
-</p><!--l. 8030--><p class="indent" > (Note that I’ve used <span
+<!--l. 8051--><p class="nopar" >
+</p><!--l. 8053--><p class="indent" > (Note that I’ve used <span
class="cmtt-10">\glsentrysymbol</span><a
- id="dx1-132079"></a> rather than <span
+ id="dx1-133079"></a> rather than <span
class="cmtt-10">\glssymbol</span><a
- id="dx1-132080"></a> to avoid nested hyperlinks.)
-</p><!--l. 8033--><p class="indent" > Note also that all of the <a
+ id="dx1-133080"></a> to avoid nested hyperlinks.)
+</p><!--l. 8056--><p class="indent" > Note also that all of the <a
href="#glo:linktext">link text<a
- id="dx1-132081"></a></a> will be formatted according to <span
+ id="dx1-133081"></a></a> will be formatted according to <span
class="cmtt-10">\glstextformat</span><a
- id="dx1-132082"></a> (described earlier). So if
+ id="dx1-133082"></a> (described earlier). So if
you do, say:
</p>
- <pre class="verbatim" id="verbatim-212">
+ <pre class="verbatim" id="verbatim-214">
\renewcommand{\glstextformat}[1]{\textbf{#1}}
\renewcommand*{\glsentryfmt}{%
  \glsgenentryfmt
@@ -17105,23 +17144,23 @@
  \ifglsused{\glslabel}{}{\space(\glsentrysymbol{\glslabel})}%
}
</pre>
-<!--l. 8041--><p class="nopar" > then <span class="obeylines-h"><span class="verb"><span
+<!--l. 8064--><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. 8044--><p class="indent" > For a complete document, see the sample file <a
+</p><!--l. 8067--><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. 8045--><p class="noindent" >
-</p><!--l. 8045--><p class="noindent" >____________________________</p></div>
+<!--l. 8068--><p class="noindent" >
+</p><!--l. 8068--><p class="noindent" >____________________________</p></div>
<a
- id="ex:defglsentryfmt"></a>
-<!--l. 8047--><p class="noindent" ><span
+ id="x1-133083r9"></a>
+<!--l. 8070--><p class="noindent" ><span
class="cmbx-12">Example 9</span><span
class="cmbx-12"> (Custom Format for Particular Glossary)</span><a
- id="x1-132084"></a>
-</p><!--l. 8048--><p class="indent" > Suppose you have created a new glossary called <span
+ id="x1-133084"></a>
+</p><!--l. 8071--><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:
@@ -17128,16 +17167,16 @@
</p>
- <pre class="verbatim" id="verbatim-213">
+ <pre class="verbatim" id="verbatim-215">
\defglsentryfmt[notation]{\glsgenentryfmt
 \ifglsused{\glslabel}{}{\space
   (denoted \glsentrysymbol{\glslabel})}}
</pre>
-<!--l. 8055--><p class="nopar" > Now suppose you have defined an entry as follows:
+<!--l. 8078--><p class="nopar" > Now suppose you have defined an entry as follows:
</p>
- <pre class="verbatim" id="verbatim-214">
+ <pre class="verbatim" id="verbatim-216">
\newglossaryentry{set}{type=notation,
  name=set,
  description={A collection of objects},
@@ -17144,26 +17183,26 @@
  symbol={$S$}
}
</pre>
-<!--l. 8063--><p class="nopar" > The <a
+<!--l. 8086--><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-132085"></a> was
+ id="dx1-133085"></a> was
used).
-</p><!--l. 8067--><p class="indent" > Alternatively, if you expect all the symbols to be set in math mode, you can do:
+</p><!--l. 8090--><p class="indent" > Alternatively, if you expect all the symbols to be set in math mode, you can do:
</p>
- <pre class="verbatim" id="verbatim-215">
+ <pre class="verbatim" id="verbatim-217">
\defglsentryfmt[notation]{\glsgenentryfmt
 \ifglsused{\glslabel}{}{\space
   (denoted $\glsentrysymbol{\glslabel}$)}}
</pre>
-<!--l. 8073--><p class="nopar" > and define entries like this:
+<!--l. 8096--><p class="nopar" > and define entries like this:
</p>
- <pre class="verbatim" id="verbatim-216">
+ <pre class="verbatim" id="verbatim-218">
\newglossaryentry{set}{type=notation,
  name=set,
  description={A collection of objects},
@@ -17170,132 +17209,132 @@
  symbol={S}
}
</pre>
-<!--l. 8081--><p class="nopar" > </p>
+<!--l. 8104--><p class="nopar" > </p>
<div class="center"
>
-<!--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
+<!--l. 8105--><p class="noindent" >
+</p><!--l. 8105--><p class="noindent" >____________________________</p></div>
+<!--l. 8107--><p class="indent" > Remember that if you use the <span
class="cmtt-10">symbol</span><a
- id="dx1-132086"></a> key, you need to use a glossary style that displays the symbol, as many
+ id="dx1-133086"></a> key, you need to use a glossary style that displays the symbol, as many
of the styles ignore it.
-</p><!--l. 8088--><p class="noindent" >
+</p><!--l. 8111--><p class="noindent" >
</p>
-<!--l. 8088--><p class="noindent" ><a
+<!--l. 8111--><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
+<!--l. 8114--><p class="noindent" >If you load the <span
class="cmss-10">hyperref</span><a
- id="dx1-133001"></a> or <span
+ id="dx1-134001"></a> or <span
class="cmss-10">html</span><a
- id="dx1-133002"></a> packages prior to loading the <span
+ id="dx1-134002"></a> packages prior to loading the <span
class="cmss-10">glossaries </span>package, the <a
-href="#sec:gls-like"><span
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> and
<a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><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-133003"></a>
+ id="dx1-134003"></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-133004"></a> package
+ id="dx1-134004"></a> package
option).
-</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
+</p><!--l. 8121--><p class="indent" > You can disable or enable links using:
+</p><!--l. 8122--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-134005"></a> <span
class="cmtt-10">\glsdisablehyper </span></div><hr>
-</p><!--l. 8101--><p class="noindent" >
+</p><!--l. 8124--><p class="noindent" >
and
-</p><!--l. 8103--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-133006"></a> <span
+</p><!--l. 8126--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-134006"></a> <span
class="cmtt-10">\glsenablehyper </span></div><hr>
-</p><!--l. 8105--><p class="noindent" >
+</p><!--l. 8128--><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-133007"></a> and <span
+ id="dx1-134007"></a> and <span
class="cmtt-10">\hypertarget</span><a
- id="dx1-133008"></a> have been defined (for example, by the
+ id="dx1-134008"></a> have been defined (for example, by the
<span
class="cmss-10">hyperref</span><a
- id="dx1-133009"></a> package).
-</p><!--l. 8111--><p class="indent" > You can disable just the <a
+ id="dx1-134009"></a> package).
+</p><!--l. 8134--><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-133010"></a>. Note that this option only
+ id="dx1-134010"></a>. Note that this option only
affects the <a
-href="#sec:gls-like"><span
+href="#x1-1310005.1.1"><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. 8115--><p class="noindent" ><span
+ id="x1-134011r10"></a>
+</p><!--l. 8138--><p class="noindent" ><span
class="cmbx-12">Example 10</span><span
class="cmbx-12"> (First Use With Hyperlinked Footnote Description)</span><a
- 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
+ id="x1-134012"></a>
+</p><!--l. 8139--><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-133013"></a>:
+ id="dx1-134013"></a>:
</p>
- <pre class="verbatim" id="verbatim-217">
+ <pre class="verbatim" id="verbatim-219">
\usepackage[hyperfirst=false]{glossaries}
</pre>
-<!--l. 8122--><p class="nopar" > Now I need to redefine <span
+<!--l. 8145--><p class="nopar" > Now I need to redefine <span
class="cmtt-10">\glsentryfmt</span><a
- id="dx1-133014"></a> (see <a
+ id="dx1-134014"></a> (see <a
href="#sec:glsdisplay">§<span
-class="cmbx-10">??</span>sec:glsdisplay </a><a
+class="cmbx-10">5.1.3</span> </a><a
href="#sec:glsdisplay">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>):
</p>
- <pre class="verbatim" id="verbatim-218">
+ <pre class="verbatim" id="verbatim-220">
\renewcommand*{\glsentryfmt}{%
  \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
+<!--l. 8153--><p class="nopar" >
+</p><!--l. 8155--><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. 8135--><p class="noindent" >
-</p><!--l. 8135--><p class="noindent" >____________________________</p></div>
-<!--l. 8137--><p class="indent" > Note that the <span
+<!--l. 8158--><p class="noindent" >
+</p><!--l. 8158--><p class="noindent" >____________________________</p></div>
+<!--l. 8160--><p class="indent" > Note that the <span
class="cmss-10">hyperfirst</span><a
- id="dx1-133015"></a> option applies to all defined glossaries. It may be that you only want to disable the
+ id="dx1-134015"></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-133016"></a> (see <a
+ id="dx1-134016"></a> (see <a
href="#sec:glsunset">§<span
-class="cmbx-10">??</span>sec:glsunset </a><a
+class="cmbx-10">7</span> </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-133017"></a> option
+ id="dx1-134017"></a> option
doesn’t get applied.
<a
- id="ex:hyperfirst"></a>
-</p><!--l. 8147--><p class="noindent" ><span
+ id="x1-134018r11"></a>
+</p><!--l. 8170--><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-133019"></a>
-</p><!--l. 8148--><p class="indent" > Suppose I want to suppress the hyperlink on <a
+ id="x1-134019"></a>
+</p><!--l. 8171--><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:
@@ -17302,55 +17341,55 @@
</p>
- <pre class="verbatim" id="verbatim-219">
+ <pre class="verbatim" id="verbatim-221">
\usepackage[hyperfirst=false,acronym]{glossaries}
</pre>
-<!--l. 8153--><p class="nopar" > Once all glossary entries have been defined I then do:
+<!--l. 8176--><p class="nopar" > Once all glossary entries have been defined I then do:
</p>
- <pre class="verbatim" id="verbatim-220">
+ <pre class="verbatim" id="verbatim-222">
\glsunsetall[main]
</pre>
-<!--l. 8157--><p class="nopar" >
+<!--l. 8180--><p class="nopar" >
</p>
<div class="center"
>
-<!--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
+<!--l. 8182--><p class="noindent" >
+</p><!--l. 8182--><p class="noindent" >____________________________</p></div>
+<!--l. 8184--><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-133020"></a>
+ id="dx1-134020"></a>
and put the hyperlinks (where required) within the definition of <span
class="cmtt-10">\glsentryfmt</span><a
- id="dx1-133021"></a> (see <a
+ id="dx1-134021"></a> (see <a
href="#sec:glsdisplay">§<span
-class="cmbx-10">??</span>sec:glsdisplay </a><a
+class="cmbx-10">5.1.3</span> </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-133022"></a> (see <a
+ id="dx1-134022"></a> (see <a
href="#sec:glsnolink">§<span
-class="cmbx-10">??</span>sec:glsnolink </a><a
+class="cmbx-10">5.2</span> </a><a
href="#sec:glsnolink">Using Glossary Terms Without
Links<!--tex4ht:ref: sec:glsnolink --></a>).
<a
- id="ex:nomathhyper"></a>
-</p><!--l. 8168--><p class="noindent" ><span
+ id="x1-134023r12"></a>
+</p><!--l. 8191--><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-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
+ id="x1-134024"></a>
+</p><!--l. 8192--><p class="indent" > This is a bit of a contrived example, but suppose, for some reason, I only want the <a
+href="#x1-1310005.1.1"><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-133025"></a>:
+ id="dx1-134025"></a>:
</p>
- <pre class="verbatim" id="verbatim-221">
+ <pre class="verbatim" id="verbatim-223">
\GlsDeclareNoHyperList{main}
\renewcommand*{\glsentryfmt}{%
  \ifmmode
@@ -17362,48 +17401,48 @@
  \fi
}
</pre>
-<!--l. 8186--><p class="nopar" > Note that this doesn’t affect the <a
-href="#sec:glstext-like"><span
+<!--l. 8209--><p class="nopar" > Note that this doesn’t affect the <a
+href="#x1-1320005.1.2"><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. 8191--><p class="indent" > See the sample file <a
+</p><!--l. 8214--><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. 8193--><p class="noindent" >
-</p><!--l. 8193--><p class="noindent" >____________________________</p></div>
+<!--l. 8216--><p class="noindent" >
+</p><!--l. 8216--><p class="noindent" >____________________________</p></div>
<a
- id="ex:chap-hyperfirst"></a>
-<!--l. 8195--><p class="noindent" ><span
+ id="x1-134026r13"></a>
+<!--l. 8218--><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-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
+ id="x1-134027"></a>
+</p><!--l. 8219--><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-133028"></a>
+ id="dx1-134028"></a>
(see <a
href="#sec:glsaddstoragekey">§<span
-class="cmbx-10">??</span>sec:glsaddstoragekey </a><a
+class="cmbx-10">4.3.2</span> </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>
- <pre class="verbatim" id="verbatim-222">
+ <pre class="verbatim" id="verbatim-224">
\glsaddstoragekey{chapter}{0}{\glschapnum}
</pre>
-<!--l. 8203--><p class="nopar" > This creates a new user command called <span
+<!--l. 8226--><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. 8208--><p class="indent" > Next I redefine the hook <span
+</p><!--l. 8231--><p class="indent" > Next I redefine the hook <span
class="cmtt-10">\glslinkpostsetkeys</span><a
- id="dx1-133029"></a> (see <a
+ id="dx1-134029"></a> (see <a
href="#sec:glsdisplay">§<span
-class="cmbx-10">??</span>sec:glsdisplay </a><a
+class="cmbx-10">5.1.3</span> </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
@@ -17412,15 +17451,15 @@
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-133030"></a>’s <span
+ id="dx1-134030"></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-133031"></a> (<a
+ id="dx1-134031"></a> (<a
href="#sec:fetchset">§<span
-class="cmbx-10">??</span>sec:fetchset </a><a
+class="cmbx-10">15.3</span> </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
@@ -17428,7 +17467,7 @@
</p>
- <pre class="verbatim" id="verbatim-223">
+ <pre class="verbatim" id="verbatim-225">
\renewcommand*{\glslinkpostsetkeys}{%
 \edef\currentchap{\arabic{chapter}}%
 \ifnum\currentchap=\glschapnum{\glslabel}\relax
@@ -17438,94 +17477,109 @@
 \fi
}
</pre>
-<!--l. 8229--><p class="nopar" > Note that this will be confused if you use <span
+<!--l. 8252--><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. 8233--><p class="indent" > See the sample file <a
+</p><!--l. 8256--><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. 8235--><p class="noindent" >
-</p><!--l. 8235--><p class="noindent" >____________________________</p></div>
-<!--l. 8237--><p class="noindent" >
+<!--l. 8258--><p class="noindent" >
+</p><!--l. 8258--><p class="noindent" >____________________________</p></div>
+<!--l. 8260--><p class="noindent" >
</p>
-<!--l. 8237--><p class="noindent" ><a
+<!--l. 8260--><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.
+<!--l. 8263--><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-134001"></a>, they don’t have any optional arguments, they don’t affect the <a
+ id="dx1-135001"></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-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
+ id="dx1-135002"></a>, they don’t produce hyperlinks.
+</p><!--l. 8269--><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-134003"></a>’s <span
+ id="dx1-135003"></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-134004"></a> documentation for further details. All the commands that convert the
+ id="dx1-135004"></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. 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
+</p><!--l. 8278--><p class="noindent" >
+</p><!--l. 8280--><p class="indent" > If you want to title case a field, you can use:
+</p><!--l. 8281--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135005"></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. 8260--><p class="noindent" >
+</p><!--l. 8283--><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 <span
-class="cmbx-10">??</span>tab:fieldmap</a>). For
-example:
+class="cmbx-10">4.1</span></a>). This
+internally uses:
+</p><!--l. 8287--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135006"></a> <span
+class="cmtt-10">\glscapitalisewords{</span>⟨<span
+class="cmitt-10">text</span>⟩<span
+class="cmtt-10">} </span></div><hr>
+</p><!--l. 8289--><p class="noindent" >
+which defaults to <span
+class="cmtt-10">\capitalisewords{</span>⟨<span
+class="cmti-10">text</span>⟩<span
+class="cmtt-10">}</span>. If your field contains formatting commands, you will need to
+redefine this to use <span
+class="cmtt-10">\capitalisefmtwords</span>. See the <span
+class="cmss-10">mfirstuc</span><a
+ id="dx1-135007"></a> manual for further details.
+</p><!--l. 8295--><p class="indent" > For example:
</p>
- <pre class="verbatim" id="verbatim-224">
+ <pre class="verbatim" id="verbatim-226">
\glsentrytitlecase{sample}{desc}
</pre>
-<!--l. 8266--><p class="nopar" > (If you want title-casing in your glossary style, you might want to investigate the <a
+<!--l. 8298--><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. 8271--><p class="indent" > Note that this command has the same limitations as <span
+</p><!--l. 8303--><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">§<span
-class="cmbx-10">??</span>sec:gls-like </a><a
-href="#sec:gls-like">The <span
+href="#x1-1310005.1.1">§<span
+class="cmbx-10">5.1.1</span> </a><a
+href="#x1-1310005.1.1">The <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
+</p><!--l. 8307--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135008"></a> <span
class="cmtt-10">\glsentryname{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8277--><p class="noindent" >
-</p><!--l. 8278--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134007"></a> <span
+</p><!--l. 8309--><p class="noindent" >
+</p><!--l. 8310--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135009"></a> <span
class="cmtt-10">\Glsentryname{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8280--><p class="noindent" >
+</p><!--l. 8312--><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-134008"></a> key.
+ id="dx1-135010"></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>⟩.
@@ -17533,26 +17587,26 @@
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-134009"></a> or <span
+ id="dx1-135011"></a> or <span
class="cmtt-10">first</span><a
- id="dx1-134010"></a> keys. In general it’s better to use <span
+ id="dx1-135012"></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. 8291--><p class="indent" > <div class="important" title="Important Note"> In general it’s best to avoid <span
+</p><!--l. 8323--><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. 8294--><p class="noindent" >
-</p><!--l. 8296--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134011"></a> <span
+</p><!--l. 8326--><p class="noindent" >
+</p><!--l. 8328--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135013"></a> <span
class="cmtt-10">\glossentryname{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8298--><p class="noindent" >
+</p><!--l. 8330--><p class="noindent" >
This is like <span
class="cmtt-10">\glsnamefont</span><span
class="cmsy-10">{</span><span
@@ -17568,100 +17622,100 @@
</p>
- <pre class="verbatim" id="verbatim-225">
+ <pre class="verbatim" id="verbatim-227">
\renewcommand*{\glsnamefont}[1]{\textmd{\sffamily #1}}
</pre>
-<!--l. 8307--><p class="nopar" >
-</p><!--l. 8308--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134012"></a> <span
+<!--l. 8339--><p class="nopar" >
+</p><!--l. 8340--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135014"></a> <span
class="cmtt-10">\Glossentryname{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8310--><p class="noindent" >
+</p><!--l. 8342--><p class="noindent" >
This is like <span
class="cmtt-10">\glossentryname </span>but makes the first letter of the name upper case.
-</p><!--l. 8314--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134013"></a> <span
+</p><!--l. 8346--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135015"></a> <span
class="cmtt-10">\glsentrytext{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8316--><p class="noindent" >
-</p><!--l. 8317--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134014"></a> <span
+</p><!--l. 8348--><p class="noindent" >
+</p><!--l. 8349--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135016"></a> <span
class="cmtt-10">\Glsentrytext{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8319--><p class="noindent" >
+</p><!--l. 8351--><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-134015"></a>
+ id="dx1-135017"></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. 8327--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134016"></a> <span
+</p><!--l. 8359--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135018"></a> <span
class="cmtt-10">\glsentryplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8329--><p class="noindent" >
-</p><!--l. 8330--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134017"></a> <span
+</p><!--l. 8361--><p class="noindent" >
+</p><!--l. 8362--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135019"></a> <span
class="cmtt-10">\Glsentryplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8332--><p class="noindent" >
+</p><!--l. 8364--><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-134018"></a> key. <span
+ id="dx1-135020"></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. 8341--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134019"></a> <span
+</p><!--l. 8373--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135021"></a> <span
class="cmtt-10">\glsentryfirst{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8343--><p class="noindent" >
-</p><!--l. 8344--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134020"></a> <span
+</p><!--l. 8375--><p class="noindent" >
+</p><!--l. 8376--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135022"></a> <span
class="cmtt-10">\Glsentryfirst{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8346--><p class="noindent" >
+</p><!--l. 8378--><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-134021"></a> key.
+ id="dx1-135023"></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. 8354--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134022"></a> <span
+</p><!--l. 8386--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135024"></a> <span
class="cmtt-10">\glsentryfirstplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8356--><p class="noindent" >
-</p><!--l. 8357--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134023"></a> <span
+</p><!--l. 8388--><p class="noindent" >
+</p><!--l. 8389--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135025"></a> <span
class="cmtt-10">\Glsentryfirstplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8359--><p class="noindent" >
+</p><!--l. 8391--><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-134024"></a> key. <span
+ id="dx1-135026"></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
@@ -17668,31 +17722,31 @@
class="cmti-10">label</span>⟩.
-</p><!--l. 8368--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134025"></a> <span
+</p><!--l. 8400--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135027"></a> <span
class="cmtt-10">\glsentrydesc{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8370--><p class="noindent" >
-</p><!--l. 8371--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134026"></a> <span
+</p><!--l. 8402--><p class="noindent" >
+</p><!--l. 8403--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135028"></a> <span
class="cmtt-10">\Glsentrydesc{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8373--><p class="noindent" >
+</p><!--l. 8405--><p class="noindent" >
These commands display the description for the glossary entry given by ⟨<span
class="cmti-10">label</span>⟩.
-</p><!--l. 8377--><p class="indent" > <span
+</p><!--l. 8409--><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. 8382--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134027"></a> <span
+</p><!--l. 8414--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135029"></a> <span
class="cmtt-10">\glossentrydesc{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8384--><p class="noindent" >
+</p><!--l. 8416--><p class="noindent" >
This is like <span
class="cmtt-10">\glsentrydesc{</span>⟨<span
class="cmti-10">label</span>⟩<span
@@ -17699,27 +17753,27 @@
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. 8389--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134028"></a> <span
+</p><!--l. 8421--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135030"></a> <span
class="cmtt-10">\Glossentrydesc{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8391--><p class="noindent" >
+</p><!--l. 8423--><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. 8395--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134029"></a> <span
+</p><!--l. 8427--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135031"></a> <span
class="cmtt-10">\glsentrydescplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8397--><p class="noindent" >
-</p><!--l. 8398--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134030"></a> <span
+</p><!--l. 8429--><p class="noindent" >
+</p><!--l. 8430--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135032"></a> <span
class="cmtt-10">\Glsentrydescplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8400--><p class="noindent" >
+</p><!--l. 8432--><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>
@@ -17727,27 +17781,27 @@
unexpandable commands). The second form is not expandable. Neither checks for the existence of
⟨<span
class="cmti-10">label</span>⟩.
-</p><!--l. 8409--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134031"></a> <span
+</p><!--l. 8441--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135033"></a> <span
class="cmtt-10">\glsentrysymbol{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8411--><p class="noindent" >
-</p><!--l. 8412--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134032"></a> <span
+</p><!--l. 8443--><p class="noindent" >
+</p><!--l. 8444--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135034"></a> <span
class="cmtt-10">\Glsentrysymbol{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8414--><p class="noindent" >
+</p><!--l. 8446--><p class="noindent" >
These commands display the symbol for the glossary entry given by ⟨<span
class="cmti-10">label</span>⟩.
-</p><!--l. 8418--><p class="indent" > <span
+</p><!--l. 8450--><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. 8424--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134033"></a> <span
+</p><!--l. 8456--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135035"></a> <span
class="cmtt-10">\glsletentryfield{</span>⟨<span
class="cmitt-10">cs</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -17755,11 +17809,11 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">field</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8426--><p class="noindent" >
+</p><!--l. 8458--><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="cmbx-10">4.1</span></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
@@ -17767,16 +17821,16 @@
</p>
- <pre class="verbatim" id="verbatim-226">
+ <pre class="verbatim" id="verbatim-228">
\glsletentryfield{\tmp}{apple}{desc}
</pre>
-<!--l. 8435--><p class="nopar" >
-</p><!--l. 8437--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134034"></a> <span
+<!--l. 8467--><p class="nopar" >
+</p><!--l. 8469--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135036"></a> <span
class="cmtt-10">\glossentrysymbol{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8439--><p class="noindent" >
+</p><!--l. 8471--><p class="noindent" >
This is like <span
class="cmtt-10">\glsentrysymbol{</span>⟨<span
class="cmti-10">label</span>⟩<span
@@ -17783,27 +17837,27 @@
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. 8444--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134035"></a> <span
+</p><!--l. 8476--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135037"></a> <span
class="cmtt-10">\Glossentrysymbol{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8446--><p class="noindent" >
+</p><!--l. 8478--><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. 8450--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134036"></a> <span
+</p><!--l. 8482--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135038"></a> <span
class="cmtt-10">\glsentrysymbolplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8452--><p class="noindent" >
-</p><!--l. 8453--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134037"></a> <span
+</p><!--l. 8484--><p class="noindent" >
+</p><!--l. 8485--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135039"></a> <span
class="cmtt-10">\Glsentrysymbolplural{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8455--><p class="noindent" >
+</p><!--l. 8487--><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>
@@ -17811,80 +17865,80 @@
unexpandable commands). The second form is not expandable. Neither checks for the existence of
⟨<span
class="cmti-10">label</span>⟩.
-</p><!--l. 8463--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134038"></a> <span
+</p><!--l. 8495--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135040"></a> <span
class="cmtt-10">\glsentryuseri{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8465--><p class="noindent" >
-</p><!--l. 8466--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134039"></a> <span
+</p><!--l. 8497--><p class="noindent" >
+</p><!--l. 8498--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135041"></a> <span
class="cmtt-10">\Glsentryuseri{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8468--><p class="noindent" >
-</p><!--l. 8469--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134040"></a> <span
+</p><!--l. 8500--><p class="noindent" >
+</p><!--l. 8501--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135042"></a> <span
class="cmtt-10">\glsentryuserii{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8471--><p class="noindent" >
-</p><!--l. 8472--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134041"></a> <span
+</p><!--l. 8503--><p class="noindent" >
+</p><!--l. 8504--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135043"></a> <span
class="cmtt-10">\Glsentryuserii{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8474--><p class="noindent" >
-</p><!--l. 8475--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134042"></a> <span
+</p><!--l. 8506--><p class="noindent" >
+</p><!--l. 8507--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135044"></a> <span
class="cmtt-10">\glsentryuseriii{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8477--><p class="noindent" >
-</p><!--l. 8478--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134043"></a> <span
+</p><!--l. 8509--><p class="noindent" >
+</p><!--l. 8510--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135045"></a> <span
class="cmtt-10">\Glsentryuseriii{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8480--><p class="noindent" >
-</p><!--l. 8481--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134044"></a> <span
+</p><!--l. 8512--><p class="noindent" >
+</p><!--l. 8513--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135046"></a> <span
class="cmtt-10">\glsentryuseriv{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8483--><p class="noindent" >
-</p><!--l. 8484--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134045"></a> <span
+</p><!--l. 8515--><p class="noindent" >
+</p><!--l. 8516--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135047"></a> <span
class="cmtt-10">\Glsentryuseriv{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8486--><p class="noindent" >
-</p><!--l. 8487--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134046"></a> <span
+</p><!--l. 8518--><p class="noindent" >
+</p><!--l. 8519--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135048"></a> <span
class="cmtt-10">\glsentryuserv{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8489--><p class="noindent" >
-</p><!--l. 8490--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134047"></a> <span
+</p><!--l. 8521--><p class="noindent" >
+</p><!--l. 8522--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135049"></a> <span
class="cmtt-10">\Glsentryuserv{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8492--><p class="noindent" >
-</p><!--l. 8493--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134048"></a> <span
+</p><!--l. 8524--><p class="noindent" >
+</p><!--l. 8525--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135050"></a> <span
class="cmtt-10">\glsentryuservi{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8495--><p class="noindent" >
-</p><!--l. 8496--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134049"></a> <span
+</p><!--l. 8527--><p class="noindent" >
+</p><!--l. 8528--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135051"></a> <span
class="cmtt-10">\Glsentryuservi{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8498--><p class="noindent" >
+</p><!--l. 8530--><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
@@ -17891,63 +17945,63 @@
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. 8507--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134050"></a> <span
+</p><!--l. 8539--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135052"></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. 8509--><p class="noindent" >
+</p><!--l. 8541--><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-134051"></a><span
+ id="dx1-135053"></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="#fn4x5" id="fn4x5-bk"><sup class="textsuperscript">5.4</sup></a></span><a
- id="x1-134052f4"></a>,
+ id="x1-135054f4"></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-134056"></a> or if you haven’t loaded the <span
+ id="dx1-135058"></a> or if you haven’t loaded the <span
class="cmss-10">hyperref</span><a
- id="dx1-134057"></a> package.
-</p><!--l. 8520--><p class="indent" > <div class="important" title="Important Note"> If you use <span
+ id="dx1-135059"></a> package.
+</p><!--l. 8552--><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">§<span
-class="cmbx-10">??</span>sec:glslink </a><a
+class="cmbx-10">5.1</span> </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
+class="cmbx-10">10</span> </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
+</p><!--l. 8557--><p class="noindent" >
+</p><!--l. 8559--><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-134058"></a> package
+ id="dx1-135060"></a> package
option:
-</p><!--l. 8529--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134059"></a> <span
+</p><!--l. 8561--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135061"></a> <span
class="cmtt-10">\glsentrynumberlist{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8531--><p class="noindent" >
-</p><!--l. 8532--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134060"></a> <span
+</p><!--l. 8563--><p class="noindent" >
+</p><!--l. 8564--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135062"></a> <span
class="cmtt-10">\glsdisplaynumberlist{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8534--><p class="noindent" >
+</p><!--l. 8566--><p class="noindent" >
Both display the <a
href="#glo:numberlist">number list<a
- id="dx1-134061"></a></a> for the entry given by ⟨<span
+ id="dx1-135063"></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
@@ -17955,33 +18009,33 @@
href="#option3">3</a> a run of <a
href="#glo:makeglossaries"><span
class="cmtt-10">makeglossaries</span><a
- id="dx1-134062"></a></a> (or <a
+ id="dx1-135064"></a></a> (or <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-134063"></a></a>/<a
+ id="dx1-135065"></a></a>/<a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-134064"></a></a>)
+ id="dx1-135066"></a></a>)
followed by one or two runs of LaTeX is required.
-</p><!--l. 8541--><p class="indent" > The first command, <span
+</p><!--l. 8573--><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. 8544--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134065"></a> <span
+</p><!--l. 8576--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135067"></a> <span
class="cmtt-10">\glsnumlistsep </span></div><hr>
-</p><!--l. 8546--><p class="noindent" >
+</p><!--l. 8578--><p class="noindent" >
as the separator between all but the last two elements and
-</p><!--l. 8548--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-134066"></a> <span
+</p><!--l. 8580--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-135068"></a> <span
class="cmtt-10">\glsnumlistlastsep </span></div><hr>
-</p><!--l. 8550--><p class="noindent" >
+</p><!--l. 8582--><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. 8554--><p class="indent" > <div class="important" title="Important Note"> <span
+</p><!--l. 8586--><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
@@ -17989,11 +18043,11 @@
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-134067"></a> key is set to
+ id="dx1-135069"></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-134068"></a> if you choose Options <a
+ id="dx1-135070"></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
@@ -18000,61 +18054,61 @@
href="#option2">2</a> or <a
href="#option3">3</a> and <span
class="cmss-10">hyperref</span><a
- id="dx1-134069"></a>, <span
+ id="dx1-135071"></a>, <span
class="cmtt-10">\glsentrynumberlist </span>will be used instead.
</div>
-</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
+</p><!--l. 8594--><p class="noindent" >
+</p><!--l. 8596--><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. 8568--><p class="indent" > </div>
-</p><!--l. 8568--><p class="noindent" ><a
+<!--l. 8600--><p class="indent" > </div>
+</p><!--l. 8600--><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. 8571--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 8603--><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. 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
+</p><!--l. 8607--><p class="noindent" >
+</p><!--l. 8609--><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-135001"></a> (see <a
+ id="dx1-136001"></a> (see <a
href="#sec:languages">§<span
-class="cmbx-10">??</span>sec:languages
+class="cmbx-10">1.4</span>
</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-135002"></a> key in the optional argument of <span
+ id="dx1-136002"></a> key in the optional argument of <span
class="cmtt-10">\printglossary</span><a
- id="dx1-135003"></a> (or
+ id="dx1-136003"></a> (or
<span
class="cmtt-10">\printacronyms</span><a
- id="dx1-135004"></a>). Alternatively consider using the <a
+ id="dx1-136004"></a>). Alternatively consider using the <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> package’s <span id="textcolor286"><span
class="cmss-10">abbreviations</span></span><a
- id="dx1-135005"></a> option instead.
+ id="dx1-136005"></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
+</p><!--l. 8621--><p class="noindent" >
+</p><!--l. 8623--><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
+ id="dx1-136006"></a> and <span
class="cmtt-10">\glspl</span><a
- id="dx1-135007"></a>. The way the acronym is displayed on <a
+ id="dx1-136007"></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">
+ <pre class="verbatim" id="verbatim-229">
\documentclass{article}
\usepackage{glossaries}
\setacronymstyle{long-short}
@@ -18065,18 +18119,18 @@
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
+<!--l. 8638--><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
+ id="dx1-136008"></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
+</p><!--l. 8645--><p class="indent" > Acronyms are defined using:
+</p><!--l. 8646--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-136009"></a> <span
class="cmtt-10">\newacronym[</span>⟨<span
class="cmitt-10">key-val list</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18086,26 +18140,26 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">long</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</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
+</p><!--l. 8648--><p class="noindent" >
+</p><!--l. 8650--><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-135010"></a>. You can specify a different
+ id="dx1-136010"></a>. You can specify a different
glossary using the <span
class="cmtt-10">type</span><a
- id="dx1-135011"></a> key within the optional argument. The <span
+ id="dx1-136011"></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-135012"></a>,
+ id="dx1-136012"></a>,
<span
class="cmtt-10">longplural</span><a
- id="dx1-135013"></a>, <span
+ id="dx1-136013"></a>, <span
class="cmtt-10">short</span><a
- id="dx1-135014"></a> and <span
+ id="dx1-136014"></a> and <span
class="cmtt-10">shortplural</span><a
- id="dx1-135015"></a> keys in <span
+ id="dx1-136015"></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
+</p><!--l. 8658--><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">
@@ -18112,130 +18166,130 @@
<div class="obeylines-v">
<span id="textcolor288"><span
class="cmtt-10">\setabbreviationstyle</span></span><a
- id="dx1-135016"></a><span
+ id="dx1-136016"></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
+<!--l. 8664--><p class="noindent" >
+</p><!--l. 8666--><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-135017"></a> also apply to <span
+ id="dx1-136017"></a> also apply to <span
class="cmtt-10">\newacronym </span>(see
<a
href="#sec:newglosentry">§<span
-class="cmbx-10">??</span>sec:newglosentry </a><a
+class="cmbx-10">4</span> </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
+ id="dx1-136018"></a> works like <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-135019"></a>, you can use
+ id="dx1-136019"></a>, you can use
<span
class="cmtt-10">\glsreset</span><a
- id="dx1-135020"></a> to reset the <a
+ id="dx1-136020"></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
+</p><!--l. 8672--><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-135021"></a>
+ id="dx1-136021"></a>
or the command <span
class="cmtt-10">\DeclareAcronymList</span><a
- id="dx1-135022"></a>, see <a
+ id="dx1-136022"></a>, see <a
href="#sec:pkgopts-acronym">§<span
-class="cmbx-10">??</span>sec:pkgopts-acronym </a><a
+class="cmbx-10">2.7</span> </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-135023"></a>. If you
+ id="dx1-136023"></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-135024"></a> (not
+ id="dx1-136024"></a> (not
redefine <span
class="cmtt-10">\glsentryfmt</span><a
- id="dx1-135025"></a>) before defining your entries. Alternatively, use <a
+ id="dx1-136025"></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
+</p><!--l. 8684--><p class="noindent" >
+</p><!--l. 8686--><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-135026"></a> can also be used here in ⟨<span
+ id="dx1-136026"></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-135027"></a>
+ id="dx1-136027"></a>
(when used with one of the styles that require a description, described in <a
href="#sec:setacronymstyle">§<span
-class="cmbx-10">??</span>sec:setacronymstyle </a><a
+class="cmbx-10">6.2</span> </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-135028"></a> or <span
+ id="dx1-136028"></a> or <span
class="cmtt-10">longplural</span><a
- id="dx1-135029"></a> keys.
+ id="dx1-136029"></a> keys.
For example:
</p>
- <pre class="verbatim" id="verbatim-228">
+ <pre class="verbatim" id="verbatim-230">
\newacronym[longplural={diagonal matrices}]%
  {dm}{DM}{diagonal matrix}
</pre>
-<!--l. 8667--><p class="nopar" > If the <a
+<!--l. 8699--><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-135030"></a> or <span
+ id="dx1-136030"></a> or <span
class="cmtt-10">shortplural</span><a
- id="dx1-135031"></a> keys, I recommend you use <span
+ id="dx1-136031"></a> keys, I recommend you use <span
class="cmtt-10">\setacronymstyle</span><a
- id="dx1-135032"></a> to set the display style rather than
+ id="dx1-136032"></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
+class="cmbx-10">2.8</span> </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
+</p><!--l. 8707--><p class="indent" > As with <span
class="cmtt-10">plural</span><a
- id="dx1-135033"></a>, if <span
+ id="dx1-136033"></a>, if <span
class="cmtt-10">longplural</span><a
- id="dx1-135034"></a> is missing, it’s obtained by appending <span
+ id="dx1-136034"></a> is missing, it’s obtained by appending <span
class="cmtt-10">\glspluralsuffix</span><a
- id="dx1-135035"></a> to the singular
+ id="dx1-136035"></a> to the singular
form. The short plural <span
class="cmtt-10">shortplural</span><a
- id="dx1-135036"></a> is obtained (if not explicitly set) by appending <span
+ id="dx1-136036"></a> is obtained (if not explicitly set) by appending <span
class="cmtt-10">\glsacrpluralsuffix</span><a
- id="dx1-135037"></a> to
+ id="dx1-136037"></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
+href="#sec:newlang">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
+</p><!--l. 8716--><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
+ id="dx1-136038"></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-135039"></a>. </div>
-</p><!--l. 8689--><p class="noindent" >
-</p><!--l. 8691--><p class="indent" > <div class="important" title="Important Note"> Since <span
+ id="dx1-136039"></a>. </div>
+</p><!--l. 8721--><p class="noindent" >
+</p><!--l. 8723--><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-135040"></a><span
+ id="dx1-136040"></a><span
class="cmtt-10">[</span>⟨<span
class="cmti-10">type</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18245,44 +18299,44 @@
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-135041"></a>. See <a
+ id="dx1-136041"></a>. See <a
href="#sec:loadglsentries">§<span
-class="cmbx-10">??</span>sec:loadglsentries </a><a
+class="cmbx-10">4.6</span> </a><a
href="#sec:loadglsentries">Loading
Entries From a File<!--tex4ht:ref: sec:loadglsentries --></a>. </div>
-</p><!--l. 8698--><p class="noindent" >
+</p><!--l. 8730--><p class="noindent" >
<a
- id="ex:newacronym"></a>
-</p><!--l. 8700--><p class="noindent" ><span
+ id="x1-136042r14"></a>
+</p><!--l. 8732--><p class="noindent" ><span
class="cmbx-12">Example 14</span><span
class="cmbx-12"> (Defining an Abbreviation)</span><a
- id="x1-135043"></a>
-</p><!--l. 8701--><p class="indent" > The following defines the abbreviation IDN:
+ id="x1-136043"></a>
+</p><!--l. 8733--><p class="indent" > The following defines the abbreviation IDN:
</p>
- <pre class="verbatim" id="verbatim-229">
+ <pre class="verbatim" id="verbatim-231">
\setacronymstyle{long-short}
\newacronym{idn}{IDN}{identification number}
</pre>
-<!--l. 8705--><p class="nopar" > <span class="obeylines-h"><span class="verb"><span
+<!--l. 8737--><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-135044"></a></a> acronym styles, described in <a
+ id="dx1-136044"></a></a> acronym styles, described in <a
href="#sec:setacronymstyle">§<span
-class="cmbx-10">??</span>sec:setacronymstyle </a><a
+class="cmbx-10">6.2</span> </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>
- <pre class="verbatim" id="verbatim-230">
+ <pre class="verbatim" id="verbatim-232">
\setacronymstyle{long-sc-short}
\newacronym{idn}{idn}{identification number}
</pre>
-<!--l. 8714--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span
+<!--l. 8746--><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
@@ -18296,100 +18350,100 @@
</p>
<div class="center"
>
-<!--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
+<!--l. 8750--><p class="noindent" >
+</p><!--l. 8750--><p class="noindent" >____________________________</p></div>
+<!--l. 8752--><p class="indent" > <div class="important" title="Important Note"> Avoid nested definitions. </div>
+</p><!--l. 8754--><p class="noindent" >
+</p><!--l. 8756--><p class="indent" > Recall from the warning in <a
href="#sec:newglosentry">§<span
-class="cmbx-10">??</span>sec:newglosentry </a><a
+class="cmbx-10">4</span> </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
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> and <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands within the value of keys like <span
class="cmtt-10">text</span><a
- id="dx1-135045"></a> and <span
+ id="dx1-136045"></a> and <span
class="cmtt-10">first</span><a
- id="dx1-135046"></a>
+ id="dx1-136046"></a>
due to complications arising from nested links. The same applies to abbreviations defined using
<span
class="cmtt-10">\newacronym</span>.
-</p><!--l. 8731--><p class="indent" > For example, suppose you have defined:
+</p><!--l. 8763--><p class="indent" > For example, suppose you have defined:
</p>
- <pre class="verbatim" id="verbatim-231">
+ <pre class="verbatim" id="verbatim-233">
\newacronym{ssi}{SSI}{server side includes}
\newacronym{html}{HTML}{hypertext markup language}
</pre>
-<!--l. 8735--><p class="nopar" > you may be tempted to do:
+<!--l. 8767--><p class="nopar" > you may be tempted to do:
</p>
- <pre class="verbatim" id="verbatim-232">
+ <pre class="verbatim" id="verbatim-234">
\newacronym{shtml}{S\gls{html}}{\gls{ssi} enabled \gls{html}}
</pre>
-<!--l. 8739--><p class="nopar" > <strong>Don’t!</strong> This will break the case-changing commands, such as <span
+<!--l. 8771--><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-135047"></a>, it will cause inconsistencies on <a
+ id="dx1-136047"></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-135048"></a>).
-</p><!--l. 8746--><p class="indent" > Instead, consider doing:
+ id="dx1-136048"></a>).
+</p><!--l. 8778--><p class="indent" > Instead, consider doing:
</p>
- <pre class="verbatim" id="verbatim-233">
+ <pre class="verbatim" id="verbatim-235">
\newacronym
 [description={\gls{ssi} enabled \gls{html}}]
 {shtml}{SHTML}{SSI enabled HTML}
</pre>
-<!--l. 8751--><p class="nopar" > or
+<!--l. 8783--><p class="nopar" > or
</p>
- <pre class="verbatim" id="verbatim-234">
+ <pre class="verbatim" id="verbatim-236">
\newacronym
 [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
+<!--l. 8790--><p class="nopar" > Similarly for the <a
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands.
-</p><!--l. 8761--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> Other approaches are available with <a
+</p><!--l. 8793--><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. </div>
-</p><!--l. 8765--><p class="noindent" >
+</p><!--l. 8797--><p class="noindent" >
</p>
-<!--l. 8768--><p class="noindent" ><a
+<!--l. 8800--><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
+<!--l. 8803--><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
+</p><!--l. 8808--><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
+href="#x1-1320005.1.2"><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-136001"></a> with <span
+ id="dx1-137001"></a> with <span
class="cmtt-10">\glscustomtext</span><a
- id="dx1-136002"></a> set as appropriate. All caveats that apply to the
+ id="dx1-137002"></a> set as appropriate. All caveats that apply to the
<a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><span
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
+</p><!--l. 8816--><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
@@ -18404,20 +18458,20 @@
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
+</p><!--l. 8823--><p class="noindent" >
+</p><!--l. 8825--><p class="indent" > The optional arguments are the same as those for the <a
+href="#x1-1320005.1.2"><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
+href="#x1-1320005.1.2"><span
class="cmtt-10">\glstext</span>-like</a> commands, the <a
href="#glo:linktext">link text<a
- id="dx1-136003"></a></a> is
+ id="dx1-137003"></a></a> is
placed in the argument of <span
class="cmtt-10">\glstextformat</span><a
- id="dx1-136004"></a>.
-</p><!--l. 8798--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136005"></a> <span
+ id="dx1-137004"></a>.
+</p><!--l. 8830--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137005"></a> <span
class="cmtt-10">\acrshort[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18425,21 +18479,21 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8800--><p class="noindent" >
+</p><!--l. 8832--><p class="noindent" >
This sets the <a
href="#glo:linktext">link text<a
- id="dx1-136006"></a></a> to the short form (within the argument of <span
+ id="dx1-137006"></a></a> to the short form (within the argument of <span
class="cmtt-10">\acronymfont</span><a
- id="dx1-136007"></a>) for the entry given by ⟨<span
+ id="dx1-137007"></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-136008"></a> key, which <span
+ id="dx1-137008"></a> key, which <span
class="cmtt-10">\newacronym</span><a
- 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
+ id="dx1-137009"></a> implicitly sets.
+</p><!--l. 8838--><p class="indent" > There are also analogous upper case variants:
+</p><!--l. 8839--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137010"></a> <span
class="cmtt-10">\Acrshort[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18447,9 +18501,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8809--><p class="noindent" >
-</p><!--l. 8810--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136011"></a> <span
+</p><!--l. 8841--><p class="noindent" >
+</p><!--l. 8842--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137011"></a> <span
class="cmtt-10">\ACRshort[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18457,10 +18511,10 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8812--><p class="noindent" >
+</p><!--l. 8844--><p class="noindent" >
There are also plural versions:
-</p><!--l. 8814--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136012"></a> <span
+</p><!--l. 8846--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137012"></a> <span
class="cmtt-10">\acrshortpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18468,11 +18522,11 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8816--><p class="noindent" >
+</p><!--l. 8848--><p class="noindent" >
-</p><!--l. 8817--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136013"></a> <span
+</p><!--l. 8849--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137013"></a> <span
class="cmtt-10">\Acrshortpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18480,9 +18534,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8819--><p class="noindent" >
-</p><!--l. 8820--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136014"></a> <span
+</p><!--l. 8851--><p class="noindent" >
+</p><!--l. 8852--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137014"></a> <span
class="cmtt-10">\ACRshortpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18490,14 +18544,14 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8822--><p class="noindent" >
+</p><!--l. 8854--><p class="noindent" >
The short plural form is as supplied by the <span
class="cmtt-10">shortplural</span><a
- id="dx1-136015"></a> key, which <span
+ id="dx1-137015"></a> key, which <span
class="cmtt-10">\newacronym</span><a
- id="dx1-136016"></a> implicitly sets.
-</p><!--l. 8826--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136017"></a> <span
+ id="dx1-137016"></a> implicitly sets.
+</p><!--l. 8858--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137017"></a> <span
class="cmtt-10">\acrlong[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18505,19 +18559,19 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8828--><p class="noindent" >
+</p><!--l. 8860--><p class="noindent" >
This sets the <a
href="#glo:linktext">link text<a
- id="dx1-136018"></a></a> to the long form for the entry given by ⟨<span
+ id="dx1-137018"></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-136019"></a>
+ id="dx1-137019"></a>
key, which <span
class="cmtt-10">\newacronym</span><a
- 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
+ id="dx1-137020"></a> implicitly sets.
+</p><!--l. 8865--><p class="indent" > There are also analogous upper case variants:
+</p><!--l. 8866--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137021"></a> <span
class="cmtt-10">\Acrlong[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18525,9 +18579,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8836--><p class="noindent" >
-</p><!--l. 8837--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136022"></a> <span
+</p><!--l. 8868--><p class="noindent" >
+</p><!--l. 8869--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137022"></a> <span
class="cmtt-10">\ACRlong[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18535,10 +18589,10 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8839--><p class="noindent" >
+</p><!--l. 8871--><p class="noindent" >
Again there are also plural versions:
-</p><!--l. 8841--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136023"></a> <span
+</p><!--l. 8873--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137023"></a> <span
class="cmtt-10">\acrlongpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18546,9 +18600,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8843--><p class="noindent" >
-</p><!--l. 8844--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136024"></a> <span
+</p><!--l. 8875--><p class="noindent" >
+</p><!--l. 8876--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137024"></a> <span
class="cmtt-10">\Acrlongpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18556,9 +18610,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8846--><p class="noindent" >
-</p><!--l. 8847--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136025"></a> <span
+</p><!--l. 8878--><p class="noindent" >
+</p><!--l. 8879--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137025"></a> <span
class="cmtt-10">\ACRlongpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18566,21 +18620,21 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8849--><p class="noindent" >
+</p><!--l. 8881--><p class="noindent" >
The long plural form is as supplied by the <span
class="cmtt-10">longplural</span><a
- id="dx1-136026"></a> key, which <span
+ id="dx1-137026"></a> key, which <span
class="cmtt-10">\newacronym</span><a
- 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
+ id="dx1-137027"></a> implicitly sets.
+</p><!--l. 8885--><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-136028"></a></a> from the complete full form. These full-form commands have star and plus variants and
+ id="dx1-137028"></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. 8860--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136029"></a> <span
+</p><!--l. 8892--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137029"></a> <span
class="cmtt-10">\acrfull[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18588,10 +18642,10 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8862--><p class="noindent" >
+</p><!--l. 8894--><p class="noindent" >
This is a shortcut for
-</p><!--l. 8864--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136030"></a> <span
+</p><!--l. 8896--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137030"></a> <span
class="cmtt-10">\acrfullfmt{</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -18599,7 +18653,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8866--><p class="noindent" >
+</p><!--l. 8898--><p class="noindent" >
which by default does </p><div class="alltt">
<div class="obeylines-v">
<span
@@ -18620,8 +18674,8 @@
class="cmtt-10">}}</span>
</div>
</div> where
-<!--l. 8874--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136031"></a> <span
+<!--l. 8906--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137031"></a> <span
class="cmtt-10">\acrfullformat{</span>⟨<span
class="cmitt-10">long</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -18629,7 +18683,7 @@
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8876--><p class="noindent" >
+</p><!--l. 8908--><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 default
@@ -18636,14 +18690,14 @@
for backward compatibility if <span
class="cmtt-10">\setacronymstyle </span>(<a
href="#sec:setacronymstyle">§<span
-class="cmbx-10">??</span>sec:setacronymstyle </a><a
+class="cmbx-10">6.2</span> </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. 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
+</p><!--l. 8917--><p class="indent" > There are also analogous upper case variants:
+</p><!--l. 8918--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137032"></a> <span
class="cmtt-10">\Acrfull[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18651,9 +18705,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8888--><p class="noindent" >
-</p><!--l. 8889--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136033"></a> <span
+</p><!--l. 8920--><p class="noindent" >
+</p><!--l. 8921--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137033"></a> <span
class="cmtt-10">\ACRfull[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18661,10 +18715,10 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8891--><p class="noindent" >
+</p><!--l. 8923--><p class="noindent" >
and plural versions:
-</p><!--l. 8893--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136034"></a> <span
+</p><!--l. 8925--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137034"></a> <span
class="cmtt-10">\acrfullpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18672,9 +18726,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</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-136035"></a> <span
+</p><!--l. 8927--><p class="noindent" >
+</p><!--l. 8928--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137035"></a> <span
class="cmtt-10">\Acrfullpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18682,9 +18736,9 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 8898--><p class="noindent" >
-</p><!--l. 8899--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136036"></a> <span
+</p><!--l. 8930--><p class="noindent" >
+</p><!--l. 8931--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137036"></a> <span
class="cmtt-10">\ACRfullpl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -18692,18 +18746,18 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</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
+</p><!--l. 8933--><p class="noindent" >
+</p><!--l. 8935--><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-136037"></a> package option to
+ id="dx1-137037"></a> package option to
activate the shorter command names listed in <a
href="#tab:shortcuts">table <span
-class="cmbx-10">??</span>tab:shortcuts</a>.
+class="cmbx-10">6.1</span></a>.
</p>
<div class="table">
-<!--l. 8907--><p class="indent" > <a
+<!--l. 8939--><p class="indent" > <a
id="tab:shortcuts"></a></p><hr class="float" /><div class="float"
>
@@ -18711,7 +18765,7 @@
<div class="caption"
><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-1360381 -->
+class="cmss-10">shortcuts</span></span></div><!--tex4ht:label?: x1-1370381 -->
<div class="tabular"> <table id="TBL-7" class="tabular"
><colgroup id="TBL-7-1g"><col
@@ -18726,276 +18780,276 @@
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-136039"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-2"
+ id="dx1-137039"></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-136040"></a> </td>
+ id="dx1-137040"></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-136041"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-2"
+ id="dx1-137041"></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-136042"></a> </td>
+ id="dx1-137042"></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-136043"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-2"
+ id="dx1-137043"></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-136044"></a> </td>
+ id="dx1-137044"></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-136045"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-2"
+ id="dx1-137045"></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-136046"></a> </td>
+ id="dx1-137046"></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-136047"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-2"
+ id="dx1-137047"></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-136048"></a> </td>
+ id="dx1-137048"></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-136049"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-2"
+ id="dx1-137049"></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-136050"></a> </td>
+ id="dx1-137050"></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-136051"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-2"
+ id="dx1-137051"></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-136052"></a> </td>
+ id="dx1-137052"></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-136053"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-2"
+ id="dx1-137053"></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-136054"></a> </td>
+ id="dx1-137054"></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-136055"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-10-2"
+ id="dx1-137055"></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-136056"></a> </td>
+ id="dx1-137056"></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-136057"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-11-2"
+ id="dx1-137057"></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-136058"></a> </td>
+ id="dx1-137058"></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-136059"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-12-2"
+ id="dx1-137059"></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-136060"></a> </td>
+ id="dx1-137060"></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-136061"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-13-2"
+ id="dx1-137061"></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-136062"></a> </td>
+ id="dx1-137062"></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-136063"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-14-2"
+ id="dx1-137063"></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-136064"></a> </td>
+ id="dx1-137064"></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-136065"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-15-2"
+ id="dx1-137065"></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-136066"></a> </td>
+ id="dx1-137066"></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-136067"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-16-2"
+ id="dx1-137067"></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-136068"></a> </td>
+ id="dx1-137068"></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-136069"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-17-2"
+ id="dx1-137069"></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-136070"></a> </td></tr></table>
+ id="dx1-137070"></a> </td></tr></table>
</div>
</div><hr class="endfloat" />
</div>
-<!--l. 8933--><p class="indent" > It is also possible to access the long and short forms without adding information to the glossary using
+<!--l. 8965--><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-136071"></a> (described in <a
+ id="dx1-137071"></a> (described in <a
href="#sec:glsnolink">§<span
-class="cmbx-10">??</span>sec:glsnolink </a><a
+class="cmbx-10">5.2</span> </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
+</p><!--l. 8969--><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-136072"></a> (non-expandable, can’t be used in PDF bookmarks, care needs to be taken if the
+ id="dx1-137072"></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
+class="cmbx-10">5.2</span> </a><a
href="#sec:glsnolink">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>.
</div>
-</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
+</p><!--l. 8975--><p class="noindent" >
+</p><!--l. 8977--><p class="indent" > The long form can be accessed using:
+</p><!--l. 8978--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137073"></a> <span
class="cmtt-10">\glsentrylong{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8948--><p class="noindent" >
+</p><!--l. 8980--><p class="noindent" >
or, with the first letter converted to upper case:
-</p><!--l. 8950--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136074"></a> <span
+</p><!--l. 8982--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137074"></a> <span
class="cmtt-10">\Glsentrylong{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8952--><p class="noindent" >
+</p><!--l. 8984--><p class="noindent" >
Plural forms:
-</p><!--l. 8954--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136075"></a> <span
+</p><!--l. 8986--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137075"></a> <span
class="cmtt-10">\glsentrylongpl{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8956--><p class="noindent" >
-</p><!--l. 8957--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136076"></a> <span
+</p><!--l. 8988--><p class="noindent" >
+</p><!--l. 8989--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137076"></a> <span
class="cmtt-10">\Glsentrylongpl{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</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
+</p><!--l. 8991--><p class="noindent" >
+</p><!--l. 8993--><p class="indent" > Similarly, to access the short form:
+</p><!--l. 8994--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137077"></a> <span
class="cmtt-10">\glsentryshort{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8964--><p class="noindent" >
+</p><!--l. 8996--><p class="noindent" >
or, with the first letter converted to upper case:
-</p><!--l. 8966--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136078"></a> <span
+</p><!--l. 8998--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137078"></a> <span
class="cmtt-10">\Glsentryshort{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8968--><p class="noindent" >
+</p><!--l. 9000--><p class="noindent" >
Plural forms:
-</p><!--l. 8970--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136079"></a> <span
+</p><!--l. 9002--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137079"></a> <span
class="cmtt-10">\glsentryshortpl{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8972--><p class="noindent" >
-</p><!--l. 8973--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136080"></a> <span
+</p><!--l. 9004--><p class="noindent" >
+</p><!--l. 9005--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137080"></a> <span
class="cmtt-10">\Glsentryshortpl{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</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
+</p><!--l. 9007--><p class="noindent" >
+</p><!--l. 9009--><p class="indent" > And the full form can be obtained using:
+</p><!--l. 9010--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137081"></a> <span
class="cmtt-10">\glsentryfull{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8980--><p class="noindent" >
-</p><!--l. 8981--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136082"></a> <span
+</p><!--l. 9012--><p class="noindent" >
+</p><!--l. 9013--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137082"></a> <span
class="cmtt-10">\Glsentryfull{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8983--><p class="noindent" >
-</p><!--l. 8984--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136083"></a> <span
+</p><!--l. 9015--><p class="noindent" >
+</p><!--l. 9016--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137083"></a> <span
class="cmtt-10">\glsentryfullpl{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8986--><p class="noindent" >
-</p><!--l. 8987--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-136084"></a> <span
+</p><!--l. 9018--><p class="noindent" >
+</p><!--l. 9019--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-137084"></a> <span
class="cmtt-10">\Glsentryfullpl{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 8989--><p class="noindent" >
+</p><!--l. 9021--><p class="noindent" >
These again use <span
class="cmtt-10">\acrfullformat</span><a
- id="dx1-136085"></a> by default, but the new styles described in the section below use different
+ id="dx1-137085"></a> by default, but the new styles described in the section below use different
formatting commands.
</p>
-<!--l. 8994--><p class="noindent" ><a
+<!--l. 9026--><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
+<!--l. 9029--><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
+ id="dx1-138001"></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
+ id="dx1-138002"></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
+ id="dx1-138003"></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
+</p><!--l. 9037--><p class="noindent" >
+</p><!--l. 9039--><p class="noindent" >The acronym style is set using:
+</p><!--l. 9040--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-138004"></a> <span
class="cmtt-10">\setacronymstyle{</span>⟨<span
class="cmitt-10">style name</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9010--><p class="noindent" >
+</p><!--l. 9042--><p class="noindent" >
where ⟨<span
class="cmti-10">style name</span>⟩ is the name of the required style.
-</p><!--l. 9013--><p class="indent" > <div class="important" title="Important Note"> You must use <span
+</p><!--l. 9045--><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. 9016--><p class="noindent" >
-</p><!--l. 9018--><p class="indent" > For example:
+</p><!--l. 9048--><p class="noindent" >
+</p><!--l. 9050--><p class="indent" > For example:
</p>
- <pre class="verbatim" id="verbatim-235">
+ <pre class="verbatim" id="verbatim-237">
\usepackage[acronym]{glossaries}
\makeglossaries
\setacronymstyle{long-sc-short}
@@ -19002,88 +19056,88 @@
\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
+<!--l. 9060--><p class="nopar" > Unpredictable results can occur if you try to use multiple styles.
+</p><!--l. 9063--><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
+</p><!--l. 9068--><p class="noindent" >
+</p><!--l. 9070--><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-137005"></a> or <span
+ id="dx1-138005"></a> or <span
class="cmtt-10">text</span><a
- id="dx1-137006"></a> keys, but instead they use <span
+ id="dx1-138006"></a> keys, but instead they use <span
class="cmtt-10">\defglsentryfmt</span><a
- id="dx1-137007"></a> to set a custom format
+ id="dx1-138007"></a> to set a custom format
that uses the <span
class="cmtt-10">long</span><a
- id="dx1-137008"></a> and <span
+ id="dx1-138008"></a> and <span
class="cmtt-10">short</span><a
- id="dx1-137009"></a> keys (or their plural equivalents). This means that these styles cope
+ id="dx1-138009"></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-137010"></a> and modify the definitions of commands like
+ id="dx1-138010"></a> and modify the definitions of commands like
<span
class="cmtt-10">\genacrfullformat</span><a
- id="dx1-137011"></a>.
-</p><!--l. 9048--><p class="indent" > Note that when you use <span
+ id="dx1-138011"></a>.
+</p><!--l. 9080--><p class="indent" > Note that when you use <span
class="cmtt-10">\setacronymstyle </span>the <span
class="cmtt-10">name</span><a
- id="dx1-137012"></a> key is set to
-</p><!--l. 9050--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-137013"></a> <span
+ id="dx1-138012"></a> key is set to
+</p><!--l. 9082--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-138013"></a> <span
class="cmtt-10">\acronymentry{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9052--><p class="noindent" >
+</p><!--l. 9084--><p class="noindent" >
and the <span
class="cmtt-10">sort</span><a
- id="dx1-137014"></a> key is set to
-</p><!--l. 9054--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-137015"></a> <span
+ id="dx1-138014"></a> key is set to
+</p><!--l. 9086--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-138015"></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. 9056--><p class="noindent" >
+</p><!--l. 9088--><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. 9062--><p class="noindent" >
+</p><!--l. 9094--><p class="noindent" >
</p>
-<!--l. 9062--><p class="noindent" ><a
+<!--l. 9094--><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. 9065--><p class="noindent" >The <span
+<!--l. 9097--><p class="noindent" >The <span
class="cmss-10">glossaries </span>package provides a number of predefined styles. These styles apply
-</p><!--l. 9067--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-138001"></a> <span
+</p><!--l. 9099--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-139001"></a> <span
class="cmtt-10">\firstacronymfont{</span>⟨<span
class="cmitt-10">text</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9069--><p class="noindent" >
+</p><!--l. 9101--><p class="noindent" >
to the short form on first use and
-</p><!--l. 9071--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-138002"></a> <span
+</p><!--l. 9103--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-139002"></a> <span
class="cmtt-10">\acronymfont{</span>⟨<span
class="cmitt-10">text</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9073--><p class="noindent" >
+</p><!--l. 9105--><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-138003"></a> is
+ id="dx1-139003"></a> is
only set once by the package when it’s loaded. By default <span
class="cmtt-10">\firstacronymfont</span><a
- id="dx1-138004"></a><span
+ id="dx1-139004"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">text</span>⟩<span
class="cmtt-10">} </span>is the same as
@@ -19091,107 +19145,107 @@
<span
class="cmtt-10">\acronymfont</span><a
- id="dx1-138005"></a><span
+ id="dx1-139005"></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-138006"></a> independently of the acronym style.
-</p><!--l. 9083--><p class="indent" > The predefined styles that contain <span
+ id="dx1-139006"></a> independently of the acronym style.
+</p><!--l. 9115--><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-138007"></a>) redefine <span
+ id="dx1-139007"></a>) redefine <span
class="cmtt-10">\acronymfont </span>to use
<span
class="cmtt-10">\textsc</span><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="dx1-139008"></a>, which means that the short form needs to be specified in lower case.
+</p><!--l. 9121--><p class="indent" > <a
id="boldsc"></a>
-</p><!--l. 9090--><p class="indent" > <div class="important" title="Important Note">Some fonts don’t support bold <a
+</p><!--l. 9122--><p class="indent" > <div class="important" title="Important Note">Some fonts don’t support bold <a
href="#glo:smallcaps">small caps<a
- id="dx1-138009"></a></a>, so you may need to redefine <span
+ id="dx1-139009"></a></a>, so you may need to redefine <span
class="cmtt-10">\glsnamefont</span><a
- id="dx1-138010"></a> (see
+ id="dx1-139010"></a> (see
<a
href="#sec:printglossary">§<span
-class="cmbx-10">??</span>sec:printglossary </a><a
+class="cmbx-10">8</span> </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-138011"></a>.
+ id="dx1-139011"></a>.
</div>
-</p><!--l. 9096--><p class="noindent" >
-</p><!--l. 9098--><p class="indent" > The predefined styles that contain <span
+</p><!--l. 9128--><p class="noindent" >
+</p><!--l. 9130--><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-138012"></a>) redefine <span
+ id="dx1-139012"></a>) redefine <span
class="cmtt-10">\acronymfont </span>to
use <span
class="cmtt-10">\textsmaller</span><a
- id="dx1-138013"></a>.
-</p><!--l. 9102--><p class="indent" > <a
+ id="dx1-139013"></a>.
+</p><!--l. 9134--><p class="indent" > <a
id="smaller"></a>
-</p><!--l. 9103--><p class="indent" > <div class="important" title="Important Note"> Note that the <span
+</p><!--l. 9135--><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-138014"></a>. If you use
+ id="dx1-139014"></a>. If you use
one of the acronym styles that set <span
class="cmtt-10">\acronymfont</span><a
- id="dx1-138015"></a> to <span
+ id="dx1-139015"></a> to <span
class="cmtt-10">\textsmaller </span>you must explicitly load the <span
class="cmss-10">relsize</span><a
- id="dx1-138016"></a> package
+ id="dx1-139016"></a> package
or otherwise define <span
class="cmtt-10">\textsmaller</span>. </div>
-</p><!--l. 9109--><p class="noindent" >
-</p><!--l. 9111--><p class="indent" > The remaining predefined styles redefine <span
+</p><!--l. 9141--><p class="noindent" >
+</p><!--l. 9143--><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. 9114--><p class="indent" > <div class="important" title="Important Note"> In most cases, the predefined styles adjust <span
+</p><!--l. 9146--><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-138017"></a> and <span
+ id="dx1-139017"></a> and <span
class="cmtt-10">\glsentryfull</span><a
- id="dx1-138018"></a> (and their plural and upper case
+ id="dx1-139018"></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-138019"></a> and <span
+ id="dx1-139019"></a> and <span
class="cmss-10">footnote</span><a
- id="dx1-138020"></a> styles (and their variants).
+ id="dx1-139020"></a> styles (and their variants).
</div>
-</p><!--l. 9119--><p class="noindent" >
-</p><!--l. 9121--><p class="indent" > The following styles are supplied by the <span
+</p><!--l. 9151--><p class="noindent" >
+</p><!--l. 9153--><p class="indent" > The following styles are supplied by the <span
class="cmss-10">glossaries </span>package: </p>
<ul class="itemize1">
<li class="itemize">
- <!--l. 9124--><p class="noindent" ><span
+ <!--l. 9156--><p class="noindent" ><span
class="cmss-10">long-short</span><a
- id="dx1-138021"></a>, <span
+ id="dx1-139021"></a>, <span
class="cmss-10">long-sc-short</span><a
- id="dx1-138022"></a>, <span
+ id="dx1-139022"></a>, <span
class="cmss-10">long-sm-short</span><a
- id="dx1-138023"></a>, <span
+ id="dx1-139023"></a>, <span
class="cmss-10">long-sp-short</span><a
- 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
+ id="dx1-139024"></a>:
+ </p><!--l. 9159--><p class="noindent" >With these three styles, acronyms are displayed in the form
+ </p><!--l. 9161--><p class="noindent" ><hr><div title="Definition">⟨<span
class="cmitt-10">long</span>⟩ <span
class="cmtt-10">(\firstacronymfont</span><a
- id="dx1-138025"></a><span
+ id="dx1-139025"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">short</span>⟩<span
class="cmtt-10">}) </span></div><hr>
- </p><!--l. 9130--><p class="noindent" >
+ </p><!--l. 9162--><p class="noindent" >
on first use and
- </p><!--l. 9133--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 9165--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\acronymfont</span><a
- id="dx1-138026"></a><span
+ id="dx1-139026"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">short</span>⟩<span
class="cmtt-10">} </span></div><hr>
- </p><!--l. 9134--><p class="noindent" >
+ </p><!--l. 9166--><p class="noindent" >
on subsequent use. They also set <span
class="cmtt-10">\acronymsort{</span>⟨<span
class="cmti-10">short</span>⟩<span
@@ -19206,17 +19260,17 @@
just the short form (enclosed in <span
class="cmtt-10">\acronymfont</span>) and the <span
class="cmtt-10">description</span><a
- id="dx1-138027"></a> key is set to the long
+ id="dx1-139027"></a> key is set to the long
form.
- </p><!--l. 9142--><p class="noindent" >The <span
+ </p><!--l. 9174--><p class="noindent" >The <span
class="cmss-10">long-sp-short</span><a
- 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
+ id="dx1-139028"></a> style was introduced in version 4.16 and uses
+ </p><!--l. 9176--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-139029"></a> <span
class="cmtt-10">\glsacspace{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
- </p><!--l. 9146--><p class="noindent" >
+ </p><!--l. 9178--><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
@@ -19229,67 +19283,67 @@
</p>
- <pre class="verbatim" id="verbatim-236">
+ <pre class="verbatim" id="verbatim-238">
\renewcommand*{\glsacspace}[1]{~}
</pre>
- <!--l. 9154--><p class="nopar" >
+ <!--l. 9186--><p class="nopar" >
</p></li>
<li class="itemize">
- <!--l. 9156--><p class="noindent" ><span
+ <!--l. 9188--><p class="noindent" ><span
class="cmss-10">short-long</span><a
- id="dx1-138030"></a>, <span
+ id="dx1-139030"></a>, <span
class="cmss-10">sc-short-long</span><a
- id="dx1-138031"></a>, <span
+ id="dx1-139031"></a>, <span
class="cmss-10">sm-short-long</span><a
- 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
+ id="dx1-139032"></a>:
+ </p><!--l. 9191--><p class="noindent" >These three styles are analogous to the above three styles, except the display order is swapped
to
- </p><!--l. 9162--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 9194--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\firstacronymfont</span><a
- id="dx1-138033"></a><span
+ id="dx1-139033"></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. 9163--><p class="noindent" >
+ </p><!--l. 9195--><p class="noindent" >
on first use.
- </p><!--l. 9166--><p class="noindent" >Note, however, that <span
+ </p><!--l. 9198--><p class="noindent" >Note, however, that <span
class="cmtt-10">\acronymsort</span><a
- id="dx1-138034"></a> and <span
+ id="dx1-139034"></a> and <span
class="cmtt-10">\acronymentry</span><a
- id="dx1-138035"></a> are the same as for the ⟨<span
+ id="dx1-139035"></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">
- <!--l. 9170--><p class="noindent" ><span
+ <!--l. 9202--><p class="noindent" ><span
class="cmss-10">long-short-desc</span><a
- id="dx1-138036"></a>, <span
+ id="dx1-139036"></a>, <span
class="cmss-10">long-sc-short-desc</span><a
- id="dx1-138037"></a>, <span
+ id="dx1-139037"></a>, <span
class="cmss-10">long-sm-short-desc</span><a
- id="dx1-138038"></a>, <span
+ id="dx1-139038"></a>, <span
class="cmss-10">long-sp-short-desc</span><a
- id="dx1-138039"></a>:
- </p><!--l. 9173--><p class="noindent" >These are like the <span
+ id="dx1-139039"></a>:
+ </p><!--l. 9205--><p class="noindent" >These are like the <span
class="cmss-10">long-short</span><a
- id="dx1-138040"></a>, <span
+ id="dx1-139040"></a>, <span
class="cmss-10">long-sc-short</span><a
- id="dx1-138041"></a>, <span
+ id="dx1-139041"></a>, <span
class="cmss-10">long-sm-short</span><a
- id="dx1-138042"></a> and <span
+ id="dx1-139042"></a> and <span
class="cmss-10">long-sp-short</span><a
- id="dx1-138043"></a> styles described above, except
+ id="dx1-139043"></a> styles described above, except
that the <span
class="cmtt-10">description</span><a
- id="dx1-138044"></a> key must be supplied in the optional argument of <span
+ id="dx1-139044"></a> key must be supplied in the optional argument of <span
class="cmtt-10">\newacronym</span><a
- id="dx1-138045"></a>. They also redefine
+ id="dx1-139045"></a>. They also redefine
<span
class="cmtt-10">\acronymentry</span><a
- id="dx1-138046"></a> to <span
+ id="dx1-139046"></a> to <span
class="cmtt-10">{</span>⟨<span
class="cmti-10">long</span>⟩<span
class="cmtt-10">} </span>(<span
@@ -19297,7 +19351,7 @@
class="cmti-10">short</span>⟩<span
class="cmtt-10">}</span>) and redefine <span
class="cmtt-10">\acronymsort</span><a
- id="dx1-138047"></a><span
+ id="dx1-139047"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">short</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -19308,48 +19362,48 @@
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-138048"></a> with these acronym styles to allow for the long name
+ id="dx1-139048"></a> with these acronym styles to allow for the long name
field.
</p></li>
<li class="itemize">
- <!--l. 9185--><p class="noindent" ><span
+ <!--l. 9217--><p class="noindent" ><span
class="cmss-10">short-long-desc</span><a
- id="dx1-138049"></a>, <span
+ id="dx1-139049"></a>, <span
class="cmss-10">sc-short-long-desc</span><a
- id="dx1-138050"></a>, <span
+ id="dx1-139050"></a>, <span
class="cmss-10">sm-short-long-desc</span><a
- 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
+ id="dx1-139051"></a>:
+ </p><!--l. 9220--><p class="noindent" >These styles are analogous to the above three styles, but the first use display style is:
+ </p><!--l. 9223--><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. 9192--><p class="noindent" >
+ </p><!--l. 9224--><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-138052"></a>
+ id="dx1-139052"></a>
etc.
</p></li>
<li class="itemize">
- <!--l. 9196--><p class="noindent" ><span
+ <!--l. 9228--><p class="noindent" ><span
class="cmss-10">dua</span><a
- id="dx1-138053"></a>, <span
+ id="dx1-139053"></a>, <span
class="cmss-10">dua-desc</span><a
- id="dx1-138054"></a>:
+ id="dx1-139054"></a>:
- </p><!--l. 9198--><p class="noindent" >With these styles, the <a
-href="#sec:gls-like"><span
+ </p><!--l. 9230--><p class="noindent" >With these styles, the <a
+href="#x1-1310005.1.1"><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-138055"></a> and <span
+ id="dx1-139055"></a> and <span
class="cmtt-10">\glsentryfull</span><a
- id="dx1-138056"></a> will display ⟨<span
+ id="dx1-139056"></a> will display ⟨<span
class="cmti-10">long</span>⟩
(<span
class="cmtt-10">\acronymfont{</span>⟨<span
@@ -19356,178 +19410,178 @@
class="cmti-10">short</span>⟩<span
class="cmtt-10">}</span>). In the case of <span
class="cmss-10">dua</span><a
- id="dx1-138057"></a>, the <span
+ id="dx1-139057"></a>, the <span
class="cmtt-10">name</span><a
- id="dx1-138058"></a> and <span
+ id="dx1-139058"></a> and <span
class="cmtt-10">sort</span><a
- id="dx1-138059"></a> keys are set to the short
+ id="dx1-139059"></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-138060"></a>, the <span
+ id="dx1-139060"></a>, the <span
class="cmtt-10">name</span><a
- id="dx1-138061"></a> and <span
+ id="dx1-139061"></a> and <span
class="cmtt-10">sort</span><a
- id="dx1-138062"></a>
+ id="dx1-139062"></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-138063"></a>.
+ id="dx1-139063"></a>.
</p></li>
<li class="itemize">
- <!--l. 9207--><p class="noindent" ><span
+ <!--l. 9239--><p class="noindent" ><span
class="cmss-10">footnote</span><a
- id="dx1-138064"></a>, <span
+ id="dx1-139064"></a>, <span
class="cmss-10">footnote-sc</span><a
- id="dx1-138065"></a>, <span
+ id="dx1-139065"></a>, <span
class="cmss-10">footnote-sm</span><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
+ id="dx1-139066"></a>:
+ </p><!--l. 9242--><p class="noindent" >With these three styles, on first use the <a
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> commands display:
- </p><!--l. 9212--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 9244--><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-138067"></a><span
+ id="dx1-139067"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">long</span>⟩<span
class="cmtt-10">} </span></div><hr>
- </p><!--l. 9213--><p class="noindent" >
+ </p><!--l. 9245--><p class="noindent" >
However, <span
class="cmtt-10">\acrfull</span><a
- id="dx1-138068"></a> and <span
+ id="dx1-139068"></a> and <span
class="cmtt-10">\glsentryfull</span><a
- id="dx1-138069"></a> are set to <span
+ id="dx1-139069"></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. 9217--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 9249--><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. 9218--><p class="noindent" >
+ </p><!--l. 9250--><p class="noindent" >
The <span
class="cmtt-10">sort</span><a
- id="dx1-138070"></a> and <span
+ id="dx1-139070"></a> and <span
class="cmtt-10">name</span><a
- id="dx1-138071"></a> keys are set to the short form, and the <span
+ id="dx1-139071"></a> keys are set to the short form, and the <span
class="cmtt-10">description</span><a
- id="dx1-138072"></a> is set to the long
+ id="dx1-139072"></a> is set to the long
form.
- </p><!--l. 9223--><p class="noindent" ><div class="important" title="Important Note"> In order to avoid nested hyperlinks on <a
+ </p><!--l. 9255--><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-138073"></a> for the acronym lists. </div>
- </p><!--l. 9227--><p class="noindent" >
+ id="dx1-139073"></a> for the acronym lists. </div>
+ </p><!--l. 9259--><p class="noindent" >
</p></li>
<li class="itemize">
- <!--l. 9229--><p class="noindent" ><span
+ <!--l. 9261--><p class="noindent" ><span
class="cmss-10">footnote-desc</span><a
- id="dx1-138074"></a>, <span
+ id="dx1-139074"></a>, <span
class="cmss-10">footnote-sc-desc</span><a
- id="dx1-138075"></a>, <span
+ id="dx1-139075"></a>, <span
class="cmss-10">footnote-sm-desc</span><a
- 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
+ id="dx1-139076"></a>:
+ </p><!--l. 9264--><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-138077"></a>. The <span
+ id="dx1-139077"></a>. The <span
class="cmtt-10">name</span><a
- id="dx1-138078"></a> key is set to the long form followed by the short form in
+ id="dx1-139078"></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-138079"></a> key is set to the long form. This means that the acronyms will be sorted
+ id="dx1-139079"></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-138080"></a> will typically be quite wide it’s best to choose a
+ id="dx1-139080"></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-138081"></a>.
+ id="dx1-139081"></a>.
</p>
</li></ul>
<a
- id="ex:acrstyle"></a>
-<!--l. 9243--><p class="noindent" ><span
+ id="x1-139082r15"></a>
+<!--l. 9275--><p class="noindent" ><span
class="cmbx-12">Example 15</span><span
class="cmbx-12"> (Adapting a Predefined Acronym Style)</span><a
- id="x1-138083"></a>
-</p><!--l. 9244--><p class="indent" > Suppose I want to use the <span
+ id="x1-139083"></a>
+</p><!--l. 9276--><p class="indent" > Suppose I want to use the <span
class="cmss-10">footnote-sc-desc</span><a
- id="dx1-138084"></a> style, but I want the <span
+ id="dx1-139084"></a> style, but I want the <span
class="cmtt-10">name</span><a
- id="dx1-138085"></a> key set to the short form followed by
+ id="dx1-139085"></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-138086"></a> key set to the short form. Then I need to specify the <span
+ id="dx1-139086"></a> key set to the short form. Then I need to specify the <span
class="cmss-10">footnote-sc-desc</span><a
- id="dx1-138087"></a>
+ id="dx1-139087"></a>
style:
</p>
- <pre class="verbatim" id="verbatim-237">
+ <pre class="verbatim" id="verbatim-239">
\setacronymstyle{footnote-sc-desc}
</pre>
-<!--l. 9250--><p class="nopar" > and then redefine <span
+<!--l. 9282--><p class="nopar" > and then redefine <span
class="cmtt-10">\acronymsort</span><a
- id="dx1-138088"></a> and <span
+ id="dx1-139088"></a> and <span
class="cmtt-10">\acronymentry</span><a
- id="dx1-138089"></a>:
+ id="dx1-139089"></a>:
</p>
- <pre class="verbatim" id="verbatim-238">
+ <pre class="verbatim" id="verbatim-240">
\renewcommand*{\acronymsort}[2]{#1}% sort by short form
\renewcommand*{\acronymentry}[1]{%
  \acronymfont{\glsentryshort{#1}}\space (\glsentrylong{#1})}%
</pre>
-<!--l. 9256--><p class="nopar" > (I’ve used <span
+<!--l. 9288--><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. 9260--><p class="indent" > Note that the default Computer Modern fonts don’t support bold <a
+</p><!--l. 9292--><p class="indent" > Note that the default Computer Modern fonts don’t support bold <a
href="#glo:smallcaps">small caps<a
- id="dx1-138090"></a></a>, so another font is required. For
+ id="dx1-139090"></a></a>, so another font is required. For
example:
</p>
- <pre class="verbatim" id="verbatim-239">
+ <pre class="verbatim" id="verbatim-241">
\usepackage[T1]{fontenc}
</pre>
-<!--l. 9264--><p class="nopar" > The alternative is to redefine <span
+<!--l. 9296--><p class="nopar" > The alternative is to redefine <span
class="cmtt-10">\acronymfont</span><a
- id="dx1-138091"></a> so that it always switches to medium weight to ensure the <a
+ id="dx1-139091"></a> so that it always switches to medium weight to ensure the <a
href="#glo:smallcaps">small
caps<a
- id="dx1-138092"></a></a> setting is used. For example:
+ id="dx1-139092"></a></a> setting is used. For example:
</p>
- <pre class="verbatim" id="verbatim-240">
+ <pre class="verbatim" id="verbatim-242">
\renewcommand*{\acronymfont}[1]{\textmd{\scshape #1}}
</pre>
-<!--l. 9270--><p class="nopar" >
-</p><!--l. 9272--><p class="indent" > The sample file <a
+<!--l. 9302--><p class="nopar" >
+</p><!--l. 9304--><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. 9274--><p class="noindent" >
-</p><!--l. 9274--><p class="noindent" >____________________________</p></div>
-<!--l. 9276--><p class="noindent" >
+<!--l. 9306--><p class="noindent" >
+</p><!--l. 9306--><p class="noindent" >____________________________</p></div>
+<!--l. 9308--><p class="noindent" >
</p>
-<!--l. 9276--><p class="noindent" ><a
+<!--l. 9308--><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. 9279--><p class="noindent" >You may find that the predefined acronyms styles that come with the <span
+<!--l. 9311--><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. 9282--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-139001"></a> <span
+</p><!--l. 9314--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-140001"></a> <span
class="cmtt-10">\newacronymstyle{</span>⟨<span
class="cmitt-10">style name</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -19535,149 +19589,149 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">definitions</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9284--><p class="noindent" >
+</p><!--l. 9316--><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-139002"></a>. You can simply use <span
+ id="dx1-140002"></a>. You can simply use <span
class="cmtt-10">\glsgenacfmt</span><a
- id="dx1-139003"></a> or you can
+ id="dx1-140003"></a> or you can
customize the display using commands like <span
class="cmtt-10">\ifglsused</span><a
- id="dx1-139004"></a>, <span
+ id="dx1-140004"></a>, <span
class="cmtt-10">\glsifplural</span><a
- id="dx1-139005"></a> and <span
+ id="dx1-140005"></a> and <span
class="cmtt-10">\glscapscase</span><a
- id="dx1-139006"></a>. (See
+ id="dx1-140006"></a>. (See
<a
href="#sec:glsdisplay">§<span
-class="cmbx-10">??</span>sec:glsdisplay </a><a
+class="cmbx-10">5.1.3</span> </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-139007"></a> and <span
+ id="dx1-140007"></a> and <span
class="cmtt-10">\newglossaryentry</span><a
- id="dx1-139008"></a>)
+ id="dx1-140008"></a>)
then you can test if the entry is an acronym and use <span
class="cmtt-10">\glsgenacfmt</span><a
- id="dx1-139009"></a> if it is or <span
+ id="dx1-140009"></a> if it is or <span
class="cmtt-10">\glsgenentryfmt</span><a
- id="dx1-139010"></a> if it isn’t. For
+ id="dx1-140010"></a> if it isn’t. For
example, the <span
class="cmss-10">long-short</span><a
- id="dx1-139011"></a> style sets ⟨<span
+ id="dx1-140011"></a> style sets ⟨<span
class="cmti-10">display</span>⟩ as
</p>
- <pre class="verbatim" id="verbatim-241">
+ <pre class="verbatim" id="verbatim-243">
\ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}%
</pre>
-<!--l. 9299--><p class="nopar" > (You can use <span
+<!--l. 9331--><p class="nopar" > (You can use <span
class="cmtt-10">\ifglshasshort</span><a
- id="dx1-139012"></a> instead of <span
+ id="dx1-140012"></a> instead of <span
class="cmtt-10">\ifglshaslong</span><a
- id="dx1-139013"></a> to test if the entry is an acronym if you
+ id="dx1-140013"></a> to test if the entry is an acronym if you
prefer.)
-</p><!--l. 9303--><p class="indent" > The third argument, ⟨<span
+</p><!--l. 9335--><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-139014"></a> or, if ⟨<span
+ id="dx1-140014"></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-139015"></a> and its variants.
-</p><!--l. 9308--><p class="indent" > Note that <span
+ id="dx1-140015"></a> and its variants.
+</p><!--l. 9340--><p class="indent" > Note that <span
class="cmtt-10">\setacronymstyle</span><a
- id="dx1-139016"></a> redefines <span
+ id="dx1-140016"></a> redefines <span
class="cmtt-10">\glsentryfull</span><a
- id="dx1-139017"></a> and <span
+ id="dx1-140017"></a> and <span
class="cmtt-10">\acrfullfmt</span><a
- id="dx1-139018"></a> to use <span
+ id="dx1-140018"></a> to use <span
class="cmtt-10">\genacrfullformat</span><a
- id="dx1-139019"></a> (and
+ id="dx1-140019"></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-139020"></a> and <span
+ id="dx1-140020"></a> and <span
class="cmss-10">dua</span><a
- id="dx1-139021"></a>) <span
+ id="dx1-140021"></a>) <span
class="cmtt-10">\newacronymstyle </span>should redefine these commands within
⟨<span
class="cmti-10">definitions</span>⟩.
-</p><!--l. 9316--><p class="indent" > Within <span
+</p><!--l. 9348--><p class="indent" > Within <span
class="cmtt-10">\newacronymstyle</span>’s ⟨<span
class="cmti-10">definitions</span>⟩ argument you can also redefine
-</p><!--l. 9318--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-139022"></a> <span
+</p><!--l. 9350--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-140022"></a> <span
class="cmtt-10">\GenericAcronymFields </span></div><hr>
-</p><!--l. 9320--><p class="noindent" >
+</p><!--l. 9352--><p class="noindent" >
This is a list of additional fields to be set in <span
class="cmtt-10">\newacronym</span><a
- id="dx1-139023"></a>. You can use the following token registers to access
+ id="dx1-140023"></a>. You can use the following token registers to access
the entry label, long form and short form: <a
- id="dx1-139024"></a><span
+ id="dx1-140024"></a><span
class="cmtt-10">\glslabeltok</span>, <a
- id="dx1-139025"></a><span
+ id="dx1-140025"></a><span
class="cmtt-10">\glslongtok </span>and <a
- id="dx1-139026"></a><span
+ id="dx1-140026"></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-139027"></a>. For example, the <span
+ id="dx1-140027"></a>. For example, the <span
class="cmss-10">long-short</span><a
- id="dx1-139028"></a> style
+ id="dx1-140028"></a> style
does:
</p>
- <pre class="verbatim" id="verbatim-242">
+ <pre class="verbatim" id="verbatim-244">
\renewcommand*{\GenericAcronymFields}{%
   description={\the\glslongtok}}%
</pre>
-<!--l. 9331--><p class="nopar" > which sets the <span
+<!--l. 9363--><p class="nopar" > which sets the <span
class="cmtt-10">description</span><a
- id="dx1-139029"></a> field to the long form of the acronym whereas the <span
+ id="dx1-140029"></a> field to the long form of the acronym whereas the <span
class="cmss-10">long-short-desc</span><a
- id="dx1-139030"></a> style
+ id="dx1-140030"></a> style
does:
</p>
- <pre class="verbatim" id="verbatim-243">
+ <pre class="verbatim" id="verbatim-245">
\renewcommand*{\GenericAcronymFields}{}%
</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
+<!--l. 9368--><p class="nopar" > since the description needs to be specified by the user.
+</p><!--l. 9371--><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. 9341--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-139031"></a> <span
+</p><!--l. 9373--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-140031"></a> <span
class="cmtt-10">\GlsUseAcrEntryDispStyle{</span>⟨<span
class="cmitt-10">style name</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9343--><p class="noindent" >
+</p><!--l. 9375--><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. 9346--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-139032"></a> <span
+</p><!--l. 9378--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-140032"></a> <span
class="cmtt-10">\GlsUseAcrStyleDefs{</span>⟨<span
class="cmitt-10">style name</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9348--><p class="noindent" >
+</p><!--l. 9380--><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-139033"></a> acronym style is
+ id="dx1-140033"></a> acronym style is
based on the <span
class="cmss-10">long-short</span><a
- id="dx1-139034"></a> style with minor modifications (remember to use <span class="obeylines-h"><span class="verb"><span
+ id="dx1-140034"></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
@@ -19685,7 +19739,7 @@
</p>
- <pre class="verbatim" id="verbatim-244">
+ <pre class="verbatim" id="verbatim-246">
\newacronymstyle{long-sc-short}%
{% use the same display as "long-short"
  \GlsUseAcrEntryDispStyle{long-short}%
@@ -19697,15 +19751,15 @@
  \renewcommand*{\acrpluralsuffix}{\glstextup{\glspluralsuffix}}%
}
</pre>
-<!--l. 9365--><p class="nopar" > (<a
- id="dx1-139035"></a><span
+<!--l. 9397--><p class="nopar" > (<a
+ id="dx1-140035"></a><span
class="cmtt-10">\glstextup </span>is used to cancel the effect of <span
class="cmtt-10">\textsc</span><a
- id="dx1-139036"></a>. This defaults to <span
+ id="dx1-140036"></a>. This defaults to <span
class="cmtt-10">\textulc</span><a
- id="dx1-139037"></a>, if defined, otherwise <span
+ id="dx1-140037"></a>, if defined, otherwise <span
class="cmtt-10">\textup</span><a
- id="dx1-139038"></a>.
+ id="dx1-140038"></a>.
For example, the plural of <span
class="cmcsc-10"><span
class="small-caps">s</span><span
@@ -19721,23 +19775,23 @@
class="small-caps">m</span><span
class="small-caps">s</span></span>.)
<a
- id="ex:customacrstyle"></a>
-</p><!--l. 9371--><p class="noindent" ><span
+ id="x1-140039r16"></a>
+</p><!--l. 9403--><p class="noindent" ><span
class="cmbx-12">Example 16</span><span
class="cmbx-12"> (Defining a Custom Acronym Style)</span><a
- id="x1-139040"></a>
-</p><!--l. 9372--><p class="indent" > Suppose I want my acronym on <a
+ id="x1-140040"></a>
+</p><!--l. 9404--><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-139041"></a>
+ id="dx1-140041"></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-139042"></a><span
+ id="dx1-140042"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">abbrv</span>⟩<span
class="cmtt-10">}\footnote</span><span class="verb"><span
@@ -19749,7 +19803,7 @@
on subsequent use: <spacer type=vertical size=10><span class="obeylines-h">
<br /><span
class="cmtt-10">\textsc</span><a
- id="dx1-139043"></a><span
+ id="dx1-140043"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">abbrv</span>⟩<span
class="cmtt-10">}</span>
@@ -19760,27 +19814,27 @@
class="cmti-10">short</span>⟩) ⟨<span
class="cmti-10">description</span>⟩
<br /><spacer type=vertical size=10></span>
-</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
+</p><!--l. 9425--><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-139044"></a> using:
+ id="dx1-140044"></a> using:
</p>
- <pre class="verbatim" id="verbatim-245">
+ <pre class="verbatim" id="verbatim-247">
\ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}%
</pre>
-<!--l. 9397--><p class="nopar" > This will use <span
+<!--l. 9429--><p class="nopar" > This will use <span
class="cmtt-10">\glsgenentryfmt</span><a
- id="dx1-139045"></a> if the entry isn’t an acronym, otherwise it will use <span
+ id="dx1-140045"></a> if the entry isn’t an acronym, otherwise it will use <span
class="cmtt-10">\glsgenacfmt</span><a
- id="dx1-139046"></a>. The third
+ id="dx1-140046"></a>. The third
argument (⟨<span
class="cmti-10">definitions</span>⟩) of <span
class="cmtt-10">\newacronymstyle</span><a
- id="dx1-139047"></a> needs to redefine <span
+ id="dx1-140047"></a> needs to redefine <span
class="cmtt-10">\genacrfullformat</span><a
- id="dx1-139048"></a> etc so that the <a
+ id="dx1-140048"></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
@@ -19789,7 +19843,7 @@
</p>
- <pre class="verbatim" id="verbatim-246">
+ <pre class="verbatim" id="verbatim-248">
 % No case change, singular first use:
  \renewcommand*{\genacrfullformat}[2]{%
   \firstacronymfont{\glsentryshort{##1}}##2%
@@ -19811,12 +19865,12 @@
   \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
+<!--l. 9458--><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>
- <pre class="verbatim" id="verbatim-247">
+ <pre class="verbatim" id="verbatim-249">
 % No case change, singular first use:
  \renewcommand*{\genacrfullformat}[2]{%
   \firstacronymfont{\glsentryshort{##1}}##2%
@@ -19830,33 +19884,33 @@
 \let\Genacrfullformat\genacrfullformat
 \let\Genplacrfullformat\genplacrfullformat
</pre>
-<!--l. 9442--><p class="nopar" > Another variation is to use <span
+<!--l. 9474--><p class="nopar" > Another variation is to use <span
class="cmtt-10">\Glsentrylong</span><a
- id="dx1-139049"></a> and <span
+ id="dx1-140049"></a> and <span
class="cmtt-10">\Glsentrylongpl</span><a
- id="dx1-139050"></a> in the footnote instead of <span
+ id="dx1-140050"></a> in the footnote instead of <span
class="cmtt-10">\glsentrylong</span><a
- id="dx1-139051"></a>
+ id="dx1-140051"></a>
and <span
class="cmtt-10">\glsentrylongpl</span><a
- id="dx1-139052"></a>.
-</p><!--l. 9447--><p class="indent" > Now let’s suppose that commands such as <span
+ id="dx1-140052"></a>.
+</p><!--l. 9479--><p class="indent" > Now let’s suppose that commands such as <span
class="cmtt-10">\glsentryfull</span><a
- id="dx1-139053"></a> and <span
+ id="dx1-140053"></a> and <span
class="cmtt-10">\acrfull</span><a
- id="dx1-139054"></a> shouldn’t use a footnote, but
+ id="dx1-140054"></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-139055"></a>
+ id="dx1-140055"></a>
and their plural and upper case variants.
-</p><!--l. 9454--><p class="indent" > First, the non-linking commands:
+</p><!--l. 9486--><p class="indent" > First, the non-linking commands:
</p>
- <pre class="verbatim" id="verbatim-248">
+ <pre class="verbatim" id="verbatim-250">
  \renewcommand*{\glsentryfull}[1]{%
    \glsentrylong{##1}\space
      (\acronymfont{\glsentryshort{##1}})%
@@ -19874,11 +19928,11 @@
      (\acronymfont{\glsentryshortpl{##1}})%
  }%
</pre>
-<!--l. 9472--><p class="nopar" > Now for the linking commands:
+<!--l. 9504--><p class="nopar" > Now for the linking commands:
</p>
- <pre class="verbatim" id="verbatim-249">
+ <pre class="verbatim" id="verbatim-251">
  \renewcommand*{\acrfullfmt}[3]{%
    \glslink[##1]{##2}{%
     \glsentrylong{##2}##3\space
@@ -19920,100 +19974,100 @@
    }%
  }%
</pre>
-<!--l. 9515--><p class="nopar" > (This may cause problems with long hyperlinks, in which case adjust the definitions so that, for example, only
+<!--l. 9547--><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-139056"></a>.)
-</p><!--l. 9520--><p class="indent" > The style also needs to redefine <span
+ id="dx1-140056"></a>.)
+</p><!--l. 9552--><p class="indent" > The style also needs to redefine <span
class="cmtt-10">\acronymsort</span><a
- id="dx1-139057"></a> so that the acronyms are sorted according to the long
+ id="dx1-140057"></a> so that the acronyms are sorted according to the long
form:
</p>
- <pre class="verbatim" id="verbatim-250">
+ <pre class="verbatim" id="verbatim-252">
  \renewcommand*{\acronymsort}[2]{##2}%
</pre>
-<!--l. 9524--><p class="nopar" > If you prefer them to be sorted according to the short form you can change the above to:
+<!--l. 9556--><p class="nopar" > If you prefer them to be sorted according to the short form you can change the above to:
</p>
- <pre class="verbatim" id="verbatim-251">
+ <pre class="verbatim" id="verbatim-253">
  \renewcommand*{\acronymsort}[2]{##1}%
</pre>
-<!--l. 9529--><p class="nopar" > The acronym font needs to be set to <span
+<!--l. 9561--><p class="nopar" > The acronym font needs to be set to <span
class="cmtt-10">\textsc</span><a
- id="dx1-139058"></a> and the plural suffix adjusted so that the “s” suffix in the plural
+ id="dx1-140058"></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-139059"></a></a>:
+ id="dx1-140059"></a></a>:
</p>
- <pre class="verbatim" id="verbatim-252">
+ <pre class="verbatim" id="verbatim-254">
  \renewcommand*{\acronymfont}[1]{\textsc{##1}}%
  \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
+<!--l. 9568--><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-139060"></a> to the long form followed by the upper case short form in parentheses:
+ id="dx1-140060"></a> to the long form followed by the upper case short form in parentheses:
</p>
- <pre class="verbatim" id="verbatim-253">
+ <pre class="verbatim" id="verbatim-255">
 \renewcommand*{\acronymentry}[1]{%
   \Glsentrylong{##1}\space
     (\MakeTextUppercase{\glsentryshort{##1}})}%
</pre>
-<!--l. 9544--><p class="nopar" > (I’ve used <span
+<!--l. 9576--><p class="nopar" > (I’ve used <span
class="cmtt-10">\Glsentrylong</span><a
- id="dx1-139061"></a> instead of <span
+ id="dx1-140061"></a> instead of <span
class="cmtt-10">\glsentrylong</span><a
- id="dx1-139062"></a> to capitalise the name in the glossary.)
-</p><!--l. 9548--><p class="indent" > An alternative approach is to set <span
+ id="dx1-140062"></a> to capitalise the name in the glossary.)
+</p><!--l. 9580--><p class="indent" > An alternative approach is to set <span
class="cmtt-10">\acronymentry</span><a
- id="dx1-139063"></a> to just the long form and redefine <span
+ id="dx1-140063"></a> to just the long form and redefine <span
class="cmtt-10">\GenericAcronymFields</span><a
- id="dx1-139064"></a> to
+ id="dx1-140064"></a> to
set the <span
class="cmtt-10">symbol</span><a
- id="dx1-139065"></a> key to the short form and use a glossary style that displays the symbol in parentheses after the
+ id="dx1-140065"></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-139066"></a> (such as the <span
+ id="dx1-140066"></a> (such as the <span
class="cmss-10">tree</span><a
- id="dx1-139067"></a> style) like this:
+ id="dx1-140067"></a> style) like this:
</p>
- <pre class="verbatim" id="verbatim-254">
+ <pre class="verbatim" id="verbatim-256">
 \renewcommand*{\acronymentry}[1]{\Glsentrylong{##1}}%
 \renewcommand*{\GenericAcronymFields}{%
    symbol={\protect\MakeTextUppercase{\the\glsshorttok}}}%
</pre>
-<!--l. 9557--><p class="nopar" > I’m going to use the first approach and set <span
+<!--l. 9589--><p class="nopar" > I’m going to use the first approach and set <span
class="cmtt-10">\GenericAcronymFields</span><a
- id="dx1-139068"></a> to do nothing:
+ id="dx1-140068"></a> to do nothing:
</p>
- <pre class="verbatim" id="verbatim-255">
+ <pre class="verbatim" id="verbatim-257">
 \renewcommand*{\GenericAcronymFields}{}%
</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:
+<!--l. 9594--><p class="nopar" >
+</p><!--l. 9596--><p class="indent" > Finally, this style needs to switch off hyperlinks on first use to avoid nested links:
</p>
- <pre class="verbatim" id="verbatim-256">
+ <pre class="verbatim" id="verbatim-258">
 \glshyperfirstfalse
</pre>
-<!--l. 9568--><p class="nopar" > Putting this all together:
+<!--l. 9600--><p class="nopar" > Putting this all together:
</p>
- <pre class="verbatim" id="verbatim-257">
+ <pre class="verbatim" id="verbatim-259">
\newacronymstyle{custom-fn}% new style name
{%
  \ifglshaslong{\glslabel}{\glsgenacfmt}{\glsgenentryfmt}%
@@ -20103,29 +20157,29 @@
     (\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:
+<!--l. 9689--><p class="nopar" >
+</p><!--l. 9691--><p class="indent" > Now I need to specify that I want to use this new style:
</p>
- <pre class="verbatim" id="verbatim-258">
+ <pre class="verbatim" id="verbatim-260">
\setacronymstyle{custom-fn}
</pre>
-<!--l. 9662--><p class="nopar" > I also need to use a glossary style that suits this acronym style, for example <span
+<!--l. 9694--><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-139069"></a>:
+ id="dx1-140069"></a>:
</p>
- <pre class="verbatim" id="verbatim-259">
+ <pre class="verbatim" id="verbatim-261">
\setglossarystyle{altlist}
</pre>
-<!--l. 9667--><p class="nopar" >
-</p><!--l. 9669--><p class="indent" > Once the acronym style has been set, I can define my acronyms:
+<!--l. 9699--><p class="nopar" >
+</p><!--l. 9701--><p class="indent" > Once the acronym style has been set, I can define my acronyms:
</p>
- <pre class="verbatim" id="verbatim-260">
+ <pre class="verbatim" id="verbatim-262">
\newacronym[description={set of tags for use in
developing hypertext documents}]{html}{html}{Hyper
Text Markup Language}
@@ -20133,44 +20187,44 @@
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
+<!--l. 9710--><p class="nopar" >
+</p><!--l. 9712--><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. 9682--><p class="noindent" >
-</p><!--l. 9682--><p class="noindent" >____________________________</p></div>
+<!--l. 9714--><p class="noindent" >
+</p><!--l. 9714--><p class="noindent" >____________________________</p></div>
<a
- id="ex:font-abbr"></a>
-<!--l. 9684--><p class="noindent" ><span
+ id="x1-140070r17"></a>
+<!--l. 9716--><p class="noindent" ><span
class="cmbx-12">Example 17</span><span
class="cmbx-12"> (Italic and Upright Abbreviations)</span><a
- 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.
+ id="x1-140071"></a>
+</p><!--l. 9717--><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. 9689--><p class="indent" > This example uses <span
+</p><!--l. 9721--><p class="indent" > This example uses <span
class="cmtt-10">\glsaddstoragekey</span><a
- id="dx1-139072"></a> to add an extra field that can be used to store the formatting
+ id="dx1-140072"></a> to add an extra field that can be used to store the formatting
declaration (such as <span
class="cmtt-10">\em</span>).
</p>
- <pre class="verbatim" id="verbatim-261">
+ <pre class="verbatim" id="verbatim-263">
\glsaddstoragekey{font}{}{\entryfont}
</pre>
-<!--l. 9693--><p class="nopar" > This defines a new field/key called <span
+<!--l. 9725--><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. 9699--><p class="indent" > There are two ways to do this. The first is to create a style that doesn’t use <span
+</p><!--l. 9731--><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-139073"></a>
+ id="dx1-140073"></a>
but instead provides a modified version that doesn’t use <span
class="cmtt-10">\acronymfont{</span>⟨<span
class="cmti-10">short</span>⟩<span
@@ -20186,19 +20240,19 @@
</p>
- <pre class="verbatim" id="verbatim-262">
+ <pre class="verbatim" id="verbatim-264">
  \renewcommand*{\genacrfullformat}[2]{%
   \glsentrylong{##1}##2\space
   ({\entryfont{##1}\glsentryshort{##1}})%
  }%
</pre>
-<!--l. 9711--><p class="nopar" > This will deal with commands like <span
+<!--l. 9743--><p class="nopar" > This will deal with commands like <span
class="cmtt-10">\gls</span><a
- id="dx1-139074"></a> but not commands like <span
+ id="dx1-140074"></a> but not commands like <span
class="cmtt-10">\acrshort</span><a
- id="dx1-139075"></a> which still use <span
+ id="dx1-140075"></a> which still use <span
class="cmtt-10">\acronymfont</span><a
- id="dx1-139076"></a>.
+ id="dx1-140076"></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>
@@ -20206,7 +20260,7 @@
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-139077"></a>. This is true in <span
+ id="dx1-140077"></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
@@ -20214,14 +20268,14 @@
</p>
- <pre class="verbatim" id="verbatim-263">
+ <pre class="verbatim" id="verbatim-265">
\renewcommand*{\acronymfont}[1]{{\entryfont{\glslabel}#1}}%
</pre>
-<!--l. 9722--><p class="nopar" > So the new style can be defined as:
+<!--l. 9754--><p class="nopar" > So the new style can be defined as:
</p>
- <pre class="verbatim" id="verbatim-264">
+ <pre class="verbatim" id="verbatim-266">
\newacronymstyle{long-font-short}
{%
  \GlsUseAcrEntryDispStyle{long-short}%
@@ -20248,22 +20302,22 @@
  \renewcommand*{\acronymentry}[1]{{\entryfont{##1}\glsentryshort{##1}}}%
}
</pre>
-<!--l. 9750--><p class="nopar" > Remember the style needs to be set before defining the entries:
+<!--l. 9782--><p class="nopar" > Remember the style needs to be set before defining the entries:
</p>
- <pre class="verbatim" id="verbatim-265">
+ <pre class="verbatim" id="verbatim-267">
\setacronymstyle{long-font-short}
</pre>
-<!--l. 9754--><p class="nopar" >
-</p><!--l. 9756--><p class="indent" > The complete document is contained in the sample file <a
+<!--l. 9786--><p class="nopar" >
+</p><!--l. 9788--><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. 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
+<!--l. 9790--><p class="noindent" >
+</p><!--l. 9790--><p class="noindent" >____________________________</p></div>
+<!--l. 9792--><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,
@@ -20275,14 +20329,14 @@
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. 9775--><p class="indent" > For example:
+</p><!--l. 9807--><p class="indent" > For example:
</p>
- <pre class="verbatim" id="verbatim-266">
+ <pre class="verbatim" id="verbatim-268">
I was awarded a B.Sc. and a Ph.D. (From the same place.)
</pre>
-<!--l. 9778--><p class="nopar" > is typeset as <spacer type=vertical size=10><span class="obeylines-h">
+<!--l. 9810--><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:
@@ -20289,11 +20343,11 @@
</p>
- <pre class="verbatim" id="verbatim-267">
+ <pre class="verbatim" id="verbatim-269">
\ttfamily
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">
+<!--l. 9819--><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>
@@ -20303,11 +20357,11 @@
</p>
- <pre class="verbatim" id="verbatim-268">
+ <pre class="verbatim" id="verbatim-270">
I was awarded a B.Sc.\ and a Ph.D\@. (From the same place.)
</pre>
-<!--l. 9799--><p class="nopar" >
-</p><!--l. 9801--><p class="indent" > This situation is a bit problematic for <span
+<!--l. 9831--><p class="nopar" >
+</p><!--l. 9833--><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
@@ -20320,7 +20374,7 @@
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. 9811--><p class="indent" > The next example shows one way of achieving this. (Note that the supplemental <a
+</p><!--l. 9843--><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 <a
@@ -20327,55 +20381,55 @@
href="https://www.dickimaw-books.com/gallery/sample-initialisms.shtml" >Gallery:
Initialisms</a>.)
<a
- id="ex:dotabbr"></a>
-</p><!--l. 9816--><p class="noindent" ><span
+ id="x1-140078r18"></a>
+</p><!--l. 9848--><p class="noindent" ><span
class="cmbx-12">Example 18</span><span
class="cmbx-12"> (Abbreviations with Full Stops (Periods))</span><a
- id="x1-139079"></a>
-</p><!--l. 9817--><p class="indent" > As from version 4.16, there’s now a hook (<span
+ id="x1-140079"></a>
+</p><!--l. 9849--><p class="indent" > As from version 4.16, there’s now a hook (<span
class="cmtt-10">\glspostlinkhook</span><a
- id="dx1-139080"></a>) that’s called at the very end of the
+ id="dx1-140080"></a>) that’s called at the very end of the
<a
-href="#sec:gls-like"><span
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> and <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><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-139081"></a> package (which is automatically loaded by <span
+ id="dx1-140081"></a> package (which is automatically loaded by <span
class="cmss-10">glossaries</span>) provides an internal command called
<span
class="cmtt-10">\new at 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-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
+ id="dx1-140082"></a> documentation.)
+</p><!--l. 9858--><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
+href="#x1-119002r4">4<!--tex4ht:ref: ex:addstoragekey --></a> where a new field is defined
to indicate the type of abbreviation:
</p>
- <pre class="verbatim" id="verbatim-269">
+ <pre class="verbatim" id="verbatim-271">
\glsaddstoragekey{abbrtype}{word}{\abbrtype}
\newcommand*{\newabbr}[1][]{\newacronym[abbrtype=initials,#1]}
</pre>
-<!--l. 9835--><p class="nopar" > Now I just use <span
+<!--l. 9867--><p class="nopar" > Now I just use <span
class="cmtt-10">\newacronym</span><a
- id="dx1-139083"></a> for the acronyms, for example,
+ id="dx1-140083"></a> for the acronyms, for example,
</p>
- <pre class="verbatim" id="verbatim-270">
+ <pre class="verbatim" id="verbatim-272">
\newacronym{laser}{laser}{light amplification by stimulated
emission of radiation}
</pre>
-<!--l. 9840--><p class="nopar" > and my new command <span
+<!--l. 9872--><p class="nopar" > and my new command <span
class="cmtt-10">\newabbr </span>for initials, for example,
</p>
- <pre class="verbatim" id="verbatim-271">
+ <pre class="verbatim" id="verbatim-273">
\newabbr{eg}{e.g.}{exempli gratia}
\newabbr{ie}{i.e.}{id est}
\newabbr{bsc}{B.Sc.}{Bachelor of Science}
@@ -20382,26 +20436,26 @@
\newabbr{ba}{B.A.}{Bachelor of Arts}
\newabbr{agm}{A.G.M.}{annual general meeting}
</pre>
-<!--l. 9848--><p class="nopar" > Within <span
+<!--l. 9880--><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-139084"></a> and <span
+ id="dx1-140084"></a> and <span
class="cmtt-10">\ifglsfieldeq</span><a
- id="dx1-139085"></a> can be used
+ id="dx1-140085"></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. 9857--><p class="indent" > Remember that internal commands within the document file (rather than in a class or package) need to be
+</p><!--l. 9889--><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-139086"></a> and <span
+ id="dx1-140086"></a> and <span
class="cmtt-10">\makeatother</span><a
- id="dx1-139087"></a>:
+ id="dx1-140087"></a>:
</p>
- <pre class="verbatim" id="verbatim-272">
+ <pre class="verbatim" id="verbatim-274">
\makeatletter
\renewcommand{\glspostlinkhook}{%
 \ifglsfieldeq{\glslabel}{abbrtype}{initials}%
@@ -20410,7 +20464,7 @@
}
\makeatother
</pre>
-<!--l. 9868--><p class="nopar" > In the event that a full stop is found <span
+<!--l. 9900--><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
@@ -20418,11 +20472,11 @@
</p>
- <pre class="verbatim" id="verbatim-273">
+ <pre class="verbatim" id="verbatim-275">
\newcommand{\doendsentence}[1]{\spacefactor=10000{}}
\newcommand{\doendword}{\spacefactor=1000{}}
</pre>
-<!--l. 9877--><p class="nopar" > Now, I can just do <span class="obeylines-h"><span class="verb"><span
+<!--l. 9909--><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
@@ -20429,7 +20483,7 @@
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. 9884--><p class="indent" > This also works on first use when the style is set to one of the ⟨<span
+</p><!--l. 9916--><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
@@ -20436,39 +20490,39 @@
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-139088"></a> is
+ id="dx1-140088"></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-139089"></a>. One possible solution to this is to redefine <span
+ id="dx1-140089"></a>. One possible solution to this is to redefine <span
class="cmtt-10">\glslinkpostsetkeys</span><a
- id="dx1-139090"></a> to check for the <a
+ id="dx1-140090"></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-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
+ id="dx1-140091"></a>.
+</p><!--l. 9926--><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-139092"></a>) and put the full stop back if the plural has been
+ id="dx1-140092"></a>) and put the full stop back if the plural has been
used.
-</p><!--l. 9899--><p class="indent" > The complete document is contained in the sample file <a
+</p><!--l. 9931--><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. 9901--><p class="noindent" >
-</p><!--l. 9901--><p class="noindent" >____________________________</p></div>
-<!--l. 9903--><p class="noindent" >
+<!--l. 9933--><p class="noindent" >
+</p><!--l. 9933--><p class="noindent" >____________________________</p></div>
+<!--l. 9935--><p class="noindent" >
</p>
-<!--l. 9903--><p class="noindent" ><a
+<!--l. 9935--><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. 9906--><p class="noindent" >The list of acronyms is just like any other type of glossary and can be displayed on its own using:
+<!--l. 9938--><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" >
+ <!--l. 9941--><p class="noindent" >
<a
href="#option1"><span
class="cmbx-10">Option</span><span
@@ -20475,15 +20529,15 @@
class="cmbx-10"> 1</span></a><span
class="cmbx-10">:</span> </p></dt><dd
class="description">
- <!--l. 9909--><p class="noindent" >
+ <!--l. 9941--><p class="noindent" >
</p>
<div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\printnoidxglossary</span><a
- id="dx1-140001"></a><span
+ id="dx1-141001"></a><span
class="cmtt-10">[type=\acronymtype</span><a
- id="dx1-140002"></a><span
+ id="dx1-141002"></a><span
class="cmtt-10">]</span>
</div>
</div>
@@ -20490,7 +20544,7 @@
</dd><dt class="description">
- <!--l. 9914--><p class="noindent" >
+ <!--l. 9946--><p class="noindent" >
<span
class="cmbx-10">Options</span><span
class="cmbx-10"> </span><a
@@ -20502,25 +20556,25 @@
class="cmbx-10">3</span></a><span
class="cmbx-10">:</span> </p></dt><dd
class="description">
- <!--l. 9914--><p class="noindent" >
+ <!--l. 9946--><p class="noindent" >
</p>
<div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\printglossary</span><a
- id="dx1-140003"></a><span
+ id="dx1-141003"></a><span
class="cmtt-10">[type=\acronymtype</span><a
- id="dx1-140004"></a><span
+ id="dx1-141004"></a><span
class="cmtt-10">]</span>
</div>
</div>
- <!--l. 9919--><p class="noindent" >(If you use the <span
+ <!--l. 9951--><p class="noindent" >(If you use the <span
class="cmss-10">acronym</span><a
- id="dx1-140005"></a> package option you can also use </p><div class="alltt">
+ id="dx1-141005"></a> package option you can also use </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\printacronyms</span><a
- id="dx1-140006"></a><span
+ id="dx1-141006"></a><span
class="cmtt-10">[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
@@ -20529,9 +20583,9 @@
<div class="obeylines-v">
<span
class="cmtt-10">\printglossary</span><a
- id="dx1-140007"></a><span
+ id="dx1-141007"></a><span
class="cmtt-10">[type=\acronymtype</span><a
- id="dx1-140008"></a><span
+ id="dx1-141008"></a><span
class="cmtt-10">,</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]</span>
@@ -20538,12 +20592,12 @@
</div>
</div> See <a
href="#sec:pkgopts-acronym">§<span
-class="cmbx-10">??</span>sec:pkgopts-acronym </a><a
+class="cmbx-10">2.7</span> </a><a
href="#sec:pkgopts-acronym">Acronym and Abbreviation Options<!--tex4ht:ref: sec:pkgopts-acronym --></a>.)
</dd></dl>
-<!--l. 9931--><p class="noindent" >Alternatively the list of acronyms can be displayed with all the other glossaries using:
+<!--l. 9963--><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" >
+ <!--l. 9966--><p class="noindent" >
<a
href="#option1"><span
class="cmbx-10">Option</span><span
@@ -20550,11 +20604,11 @@
class="cmbx-10"> 1</span></a><span
class="cmbx-10">:</span> </p></dt><dd
class="description">
- <!--l. 9934--><p class="noindent" ><span
+ <!--l. 9966--><p class="noindent" ><span
class="cmtt-10">\printnoidxglossaries</span><a
- id="dx1-140009"></a>
+ id="dx1-141009"></a>
</p></dd><dt class="description">
- <!--l. 9936--><p class="noindent" >
+ <!--l. 9968--><p class="noindent" >
<span
class="cmbx-10">Options</span><span
class="cmbx-10"> </span><a
@@ -20566,41 +20620,41 @@
class="cmbx-10">3</span></a><span
class="cmbx-10">:</span> </p></dt><dd
class="description">
- <!--l. 9936--><p class="noindent" ><span
+ <!--l. 9968--><p class="noindent" ><span
class="cmtt-10">\printglossaries</span><a
- 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.
+ id="dx1-141010"></a></p></dd></dl>
+<!--l. 9971--><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">§<span
-class="cmbx-10">??</span>sec:newglossarystyle </a><a
+class="cmbx-10">13.2</span> </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. 9976--><p class="noindent" >
</p>
-<!--l. 9944--><p class="noindent" ><a
+<!--l. 9976--><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. 9947--><p class="noindent" >Users of the obsolete <span
+<!--l. 9979--><p class="noindent" >Users of the obsolete <span
class="cmss-10">glossary</span><a
- id="dx1-141001"></a> package may recall that the syntax used to define new acronyms has changed with
+ id="dx1-142001"></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-141002"></a> package created the command <span
+ id="dx1-142002"></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. 9953--><p class="indent" > In order to facilitate migrating from the old package to the new one, the <span
+</p><!--l. 9985--><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="#fn1x6" id="fn1x6-bk"><sup class="textsuperscript">6.1</sup></a></span><a
- id="x1-141003f1"></a>
+ id="x1-142003f1"></a>
provides the command:
-</p><!--l. 9956--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-141004"></a> <span
+</p><!--l. 9988--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-142004"></a> <span
class="cmtt-10">\oldacronym[</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -20610,14 +20664,14 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">key-val list</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 9958--><p class="noindent" >
+</p><!--l. 9990--><p class="noindent" >
This uses the same syntax as the <span
class="cmss-10">glossary</span><a
- id="dx1-141005"></a> package’s method of defining acronyms. It is equivalent to:
+ id="dx1-142005"></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-141006"></a><span
+ id="dx1-142006"></a><span
class="cmtt-10">[</span>⟨<span
class="cmti-10">key-val list</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -20630,11 +20684,11 @@
<br /><spacer type=vertical size=10></span>
In addition, <span
class="cmtt-10">\oldacronym</span><a
- id="dx1-141007"></a> also defines the commands <span
+ id="dx1-142007"></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-141008"></a><span
+ id="dx1-142008"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
class="cmtt-10">}</span>, and <span
@@ -20643,7 +20697,7 @@
class="cmtt-10">*</span>,
which is equivalent to <span
class="cmtt-10">\Gls</span><a
- id="dx1-141009"></a><span
+ id="dx1-142009"></a><span
class="cmtt-10">{</span>⟨<span
class="cmti-10">label</span>⟩<span
class="cmtt-10">}</span>. If ⟨<span
@@ -20655,38 +20709,38 @@
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-141010"></a> or <span
+ id="dx1-142010"></a> or <span
class="cmtt-10">\Gls</span><a
- id="dx1-141011"></a> — you will need to explicitly use <span
+ id="dx1-142011"></a> — you will need to explicitly use <span
class="cmtt-10">\gls</span><a
- id="dx1-141012"></a> or <span
+ id="dx1-142012"></a> or <span
class="cmtt-10">\Gls</span><a
- id="dx1-141013"></a> to change
+ id="dx1-142013"></a> to change
the settings.
-</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
+</p><!--l. 10007--><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-141014"></a> package, but be aware that there
+ id="dx1-142014"></a> package, but be aware that there
are some issues with using <span
class="cmss-10">xspace</span><a
- id="dx1-141015"></a>.<span class="footnote-mark"><a
+ id="dx1-142015"></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" >
+</p><!--l. 10013--><p class="noindent" >
<a
- id="x1-141016f2"></a>
-</p><!--l. 9986--><p class="indent" > The <span
+ id="x1-142016f2"></a>
+</p><!--l. 10018--><p class="indent" > The <span
class="cmss-10">glossaries </span>package doesn’t load the <span
class="cmss-10">xspace</span><a
- id="dx1-141017"></a> package since there are both advantages and disadvantages to
+ id="dx1-142017"></a> package since there are both advantages and disadvantages to
using <span
class="cmtt-10">\xspace</span><a
- id="dx1-141018"></a> in <span
+ id="dx1-142018"></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-141019"></a> package you need to explicitly force a space
+ id="dx1-142019"></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
@@ -20693,38 +20747,38 @@
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-141020"></a>). If you use the <span
+ id="dx1-142020"></a>). If you use the <span
class="cmss-10">xspace</span><a
- id="dx1-141021"></a> package you don’t need to escape
+ id="dx1-142021"></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-141022"></a>).
-</p><!--l. 9997--><p class="indent" > To illustrate this, suppose I define the acronym “abc” as follows:
+ id="dx1-142022"></a>).
+</p><!--l. 10029--><p class="indent" > To illustrate this, suppose I define the acronym “abc” as follows:
</p>
- <pre class="verbatim" id="verbatim-274">
+ <pre class="verbatim" id="verbatim-276">
\oldacronym{abc}{example acronym}{}
</pre>
-<!--l. 10001--><p class="nopar" > This will create the command <span
+<!--l. 10033--><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 <span
-class="cmbx-10">??</span>tab:xspace</a> illustrates the effect of
+class="cmbx-10">6.2</span></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-141023"></a> package has been loaded. As can be seen
+ id="dx1-142023"></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-141024"></a> package prevents the optional argument from being
+ id="dx1-142024"></a> package prevents the optional argument from being
recognised.
</p>
<div class="table">
-<!--l. 10009--><p class="indent" > <a
+<!--l. 10041--><p class="indent" > <a
id="tab:xspace"></a></p><hr class="float" /><div class="float"
>
@@ -20733,7 +20787,7 @@
><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-1410252 -->
+class="cmtt-10">\oldacronym</span></span></div><!--tex4ht:label?: x1-1420252 -->
<div class="tabular"> <table id="TBL-8" class="tabular"
><colgroup id="TBL-8-1g"><col
@@ -20790,71 +20844,71 @@
</div>
-<!--l. 10027--><p class="indent" > </div>
-</p><!--l. 10027--><p class="noindent" ><a
+<!--l. 10059--><p class="indent" > </div>
+</p><!--l. 10059--><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. 10030--><p class="indent" > When using the <a
-href="#sec:gls-like"><span
+</p><!--l. 10062--><p class="indent" > When using the <a
+href="#x1-1310005.1.1"><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-142001"></a>
+ id="dx1-143001"></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-142002"></a> key, even though you haven’t used the glossary entry. The former can be achieved by one of the
+ id="dx1-143002"></a> key, even though you haven’t used the glossary entry. The former can be achieved by one of the
following commands:
-</p><!--l. 10036--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142003"></a> <span
+</p><!--l. 10068--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143003"></a> <span
class="cmtt-10">\glsreset{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10038--><p class="noindent" >
-</p><!--l. 10039--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142004"></a> <span
+</p><!--l. 10070--><p class="noindent" >
+</p><!--l. 10071--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143004"></a> <span
class="cmtt-10">\glslocalreset{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10041--><p class="noindent" >
+</p><!--l. 10073--><p class="noindent" >
while the latter can be achieved by one of the following commands:
-</p><!--l. 10043--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142005"></a> <span
+</p><!--l. 10075--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143005"></a> <span
class="cmtt-10">\glsunset{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10045--><p class="noindent" >
-</p><!--l. 10046--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142006"></a> <span
+</p><!--l. 10077--><p class="noindent" >
+</p><!--l. 10078--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143006"></a> <span
class="cmtt-10">\glslocalunset{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10048--><p class="noindent" >
+</p><!--l. 10080--><p class="noindent" >
You can also reset or unset all entries for a given glossary or list of glossaries using:
-</p><!--l. 10051--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142007"></a> <span
+</p><!--l. 10083--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143007"></a> <span
class="cmtt-10">\glsresetall[</span>⟨<span
class="cmitt-10">glossary list</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10053--><p class="noindent" >
-</p><!--l. 10054--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142008"></a> <span
+</p><!--l. 10085--><p class="noindent" >
+</p><!--l. 10086--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143008"></a> <span
class="cmtt-10">\glslocalresetall[</span>⟨<span
class="cmitt-10">glossary list</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10056--><p class="noindent" >
-</p><!--l. 10057--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142009"></a> <span
+</p><!--l. 10088--><p class="noindent" >
+</p><!--l. 10089--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143009"></a> <span
class="cmtt-10">\glsunsetall[</span>⟨<span
class="cmitt-10">glossary list</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10059--><p class="noindent" >
-</p><!--l. 10060--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142010"></a> <span
+</p><!--l. 10091--><p class="noindent" >
+</p><!--l. 10092--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143010"></a> <span
class="cmtt-10">\glslocalunsetall[</span>⟨<span
class="cmitt-10">glossary list</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10062--><p class="noindent" >
+</p><!--l. 10094--><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
@@ -20862,14 +20916,14 @@
</p>
- <pre class="verbatim" id="verbatim-275">
+ <pre class="verbatim" id="verbatim-277">
\glsresetall[main,acronym]
</pre>
-<!--l. 10070--><p class="nopar" >
-</p><!--l. 10072--><p class="indent" > You can determine whether an entry’s <a
+<!--l. 10102--><p class="nopar" >
+</p><!--l. 10104--><p class="indent" > You can determine whether an entry’s <a
href="#glo:firstuseflag">first use flag</a> is set using:
-</p><!--l. 10073--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-142011"></a> <span
+</p><!--l. 10105--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-143011"></a> <span
class="cmtt-10">\ifglsused{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -20877,7 +20931,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">false part</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10075--><p class="noindent" >
+</p><!--l. 10107--><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
@@ -20884,18 +20938,18 @@
class="cmti-10">false</span>
<span
class="cmti-10">part</span>⟩ will be done.
-</p><!--l. 10080--><p class="indent" > Note that <span
+</p><!--l. 10112--><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,
+ id="dx1-143012"></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
+</p><!--l. 10117--><p class="indent" > <hr><div title="Definition"><span id="textcolor291"><span
class="cmtt-10">\GlsXtrIfUnusedOrUndefined</span></span><a
- id="dx1-142013"></a><span
+ id="dx1-143013"></a><span
class="cmtt-10">{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">}{</span>⟨<span
@@ -20903,27 +20957,27 @@
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
+</p><!--l. 10118--><p class="noindent" >
+</p><!--l. 10120--><p class="indent" > <div class="important" title="Important Note"> Be careful when using <a
+href="#x1-1310005.1.1"><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. 10093--><p class="noindent" >
-</p><!--l. 10095--><p class="indent" > For example, the <span
+</p><!--l. 10125--><p class="noindent" >
+</p><!--l. 10127--><p class="indent" > For example, the <span
class="cmss-10">frame</span><a
- id="dx1-142014"></a><a
- id="dx1-142015"></a> environment in <span
+ id="dx1-143014"></a><a
+ id="dx1-143015"></a> environment in <span
class="cmss-10">beamer</span><a
- id="dx1-142016"></a> processes its argument for each overlay. This means that the
+ id="dx1-143016"></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. 10100--><p class="indent" > Consider the following example:
+</p><!--l. 10132--><p class="indent" > Consider the following example:
</p>
- <pre class="verbatim" id="verbatim-276">
+ <pre class="verbatim" id="verbatim-278">
\documentclass{beamer}
\usepackage{glossaries}
\newacronym{svm}{SVM}{support vector machine}
@@ -20937,21 +20991,21 @@
\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
+<!--l. 10152--><p class="nopar" >
+</p><!--l. 10154--><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. 10128--><p class="indent" > Firstly, unset all acronyms at the start of the document and explicitly use <span
+</p><!--l. 10160--><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-142017"></a> when you want the full
+ id="dx1-143017"></a> when you want the full
version to be displayed:
</p>
- <pre class="verbatim" id="verbatim-277">
+ <pre class="verbatim" id="verbatim-279">
\documentclass{beamer}
\usepackage{glossaries}
\newacronym{svm}{SVM}{support vector machine}
@@ -20966,12 +21020,12 @@
\end{frame}
\end{document}
</pre>
-<!--l. 10150--><p class="nopar" >
-</p><!--l. 10152--><p class="indent" > Secondly, explicitly reset each acronym on first use:
+<!--l. 10182--><p class="nopar" >
+</p><!--l. 10184--><p class="indent" > Secondly, explicitly reset each acronym on first use:
</p>
- <pre class="verbatim" id="verbatim-278">
+ <pre class="verbatim" id="verbatim-280">
\begin{frame}
 \frametitle{Frame 1}
 \begin{itemize}
@@ -20980,32 +21034,32 @@
 \end{itemize}
\end{frame}
</pre>
-<!--l. 10162--><p class="nopar" > These are non-optimal, but the <span
+<!--l. 10194--><p class="nopar" > These are non-optimal, but the <span
class="cmss-10">beamer</span><a
- id="dx1-142018"></a> class is too complex for me to provide a programmatic solution. Other
+ id="dx1-143018"></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-142019"></a><a
- id="dx1-142020"></a>-like environments (but not <span
+ id="dx1-143019"></a><a
+ id="dx1-143020"></a>-like environments (but not <span
class="cmss-10">tabular</span><a
- id="dx1-142021"></a><a
- id="dx1-142022"></a> itself) that process the
+ id="dx1-143021"></a><a
+ id="dx1-143022"></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. 10170--><p class="indent" > The <span
+</p><!--l. 10202--><p class="indent" > The <span
class="cmss-10">amsmath</span><a
- id="dx1-142023"></a> environments, such as <span
+ id="dx1-143023"></a> environments, such as <span
class="cmss-10">align</span><a
- id="dx1-142024"></a><a
- id="dx1-142025"></a>, also process their contents multiple times, but the <span
+ id="dx1-143024"></a><a
+ id="dx1-143025"></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-142026"></a>, you need to explicitly patch it by placing <span
+ id="dx1-143026"></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. 10176--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> If you need to use commands like <span
+</p><!--l. 10208--><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
@@ -21014,12 +21068,12 @@
the <a
href="#glo:glossaries-extra"><span
class="cmss-10">glossaries-extra</span></a> manual. </div>
-</p><!--l. 10181--><p class="noindent" >
+</p><!--l. 10213--><p class="noindent" >
</p>
-<!--l. 10184--><p class="noindent" ><a
+<!--l. 10216--><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. 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,
+<!--l. 10219--><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
@@ -21027,23 +21081,23 @@
improves this function and also provides per-unit counting, which isn’t available with the <span
class="cmss-10">glossaries</span>
package.
-</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
+</p><!--l. 10225--><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-143001"></a> (and therefore <span
+ id="dx1-144001"></a> (and therefore <span
class="cmtt-10">\newacronym</span><a
- id="dx1-143002"></a>) into a preamble-only command.
+ id="dx1-144002"></a>) into a preamble-only command.
</div>
-</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
+</p><!--l. 10230--><p class="noindent" >
+</p><!--l. 10232--><p class="indent" > To enable this function, use
+</p><!--l. 10233--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144003"></a> <span
class="cmtt-10">\glsenableentrycount </span></div><hr>
-</p><!--l. 10203--><p class="noindent" >
+</p><!--l. 10235--><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. 10207--><p class="indent" > The <span
+</p><!--l. 10239--><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
@@ -21051,7 +21105,7 @@
class="cmtt-10">currcount</span>. Remember that
not all commands use <span
class="cmtt-10">\glsunset</span>. Only the <a
-href="#sec:gls-like"><span
+href="#x1-1310005.1.1"><span
class="cmtt-10">\gls</span>-like</a> commands do this. The reset commands
<span
class="cmtt-10">\glsreset </span>and <span
@@ -21060,41 +21114,41 @@
change).
-</p><!--l. 10215--><p class="indent" > The <span
+</p><!--l. 10247--><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-143004"></a> file at the beginning of the <span
+ id="dx1-144004"></a> file at the beginning of the <span
class="cmss-10">document</span><a
- 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
+ id="dx1-144005"></a><a
+ id="dx1-144006"></a> environment.
+</p><!--l. 10252--><p class="indent" > You can access these fields using
+</p><!--l. 10253--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144007"></a> <span
class="cmtt-10">\glsentrycurrcount{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10223--><p class="noindent" >
+</p><!--l. 10255--><p class="noindent" >
for the <span
class="cmtt-10">currcount </span>field, and
-</p><!--l. 10225--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143008"></a> <span
+</p><!--l. 10257--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144008"></a> <span
class="cmtt-10">\glsentryprevcount{</span>⟨<span
class="cmitt-10">label</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10227--><p class="noindent" >
+</p><!--l. 10259--><p class="noindent" >
for the <span
class="cmtt-10">prevcount </span>field.
-</p><!--l. 10230--><p class="indent" > <div class="important" title="Important Note"> These commands are only defined if you have used <span
+</p><!--l. 10262--><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. 10232--><p class="noindent" >
-</p><!--l. 10234--><p class="indent" > For example:
+</p><!--l. 10264--><p class="noindent" >
+</p><!--l. 10266--><p class="indent" > For example:
</p>
- <pre class="verbatim" id="verbatim-279">
+ <pre class="verbatim" id="verbatim-281">
\documentclass{article}
\usepackage{glossaries}
\makeglossaries
@@ -21107,7 +21161,7 @@
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
+<!--l. 10284--><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
@@ -21128,11 +21182,11 @@
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. 10265--><p class="indent" > When you enable the entry count using <span
+</p><!--l. 10297--><p class="indent" > When you enable the entry count using <span
class="cmtt-10">\glsenableentrycount</span>, you also enable the following
commands:
-</p><!--l. 10267--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143009"></a> <span
+</p><!--l. 10299--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144009"></a> <span
class="cmtt-10">\cgls[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -21140,10 +21194,10 @@
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. 10301--><p class="noindent" >
(no case-change, singular)
-</p><!--l. 10271--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143010"></a> <span
+</p><!--l. 10303--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144010"></a> <span
class="cmtt-10">\cglspl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -21151,10 +21205,10 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10273--><p class="noindent" >
+</p><!--l. 10305--><p class="noindent" >
(no case-change, plural)
-</p><!--l. 10275--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143011"></a> <span
+</p><!--l. 10307--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144011"></a> <span
class="cmtt-10">\cGls[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -21162,10 +21216,10 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10277--><p class="noindent" >
+</p><!--l. 10309--><p class="noindent" >
(first letter uppercase, singular), and
-</p><!--l. 10279--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143012"></a> <span
+</p><!--l. 10311--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144012"></a> <span
class="cmtt-10">\cGlspl[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -21173,7 +21227,7 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">insert</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10281--><p class="noindent" >
+</p><!--l. 10313--><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
@@ -21180,7 +21234,7 @@
class="cmtt-10">\Gls</span>
and <span
class="cmtt-10">\Glspl </span>commands.
-</p><!--l. 10286--><p class="indent" > If you don’t use <span
+</p><!--l. 10318--><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
@@ -21216,14 +21270,14 @@
class="cmtt-10">\cglspl</span>, <span
class="cmtt-10">\cGls </span>or <span
class="cmtt-10">\cGlspl</span>.
-<!--l. 10301--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143013"></a> <span
+<!--l. 10333--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144013"></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. 10303--><p class="noindent" >
+</p><!--l. 10335--><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">
@@ -21243,14 +21297,14 @@
class="cmitt-10">insert</span>⟩
</div>
</div> otherwise.
-<!--l. 10315--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143014"></a> <span
+<!--l. 10347--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144014"></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. 10317--><p class="noindent" >
+</p><!--l. 10349--><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">
@@ -21270,14 +21324,14 @@
class="cmitt-10">insert</span>⟩
</div>
</div> otherwise.
-<!--l. 10329--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143015"></a> <span
+<!--l. 10361--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144015"></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. 10331--><p class="noindent" >
+</p><!--l. 10363--><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">
@@ -21299,14 +21353,14 @@
class="cmitt-10">insert</span>⟩
</div>
</div> otherwise.
-<!--l. 10342--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-143016"></a> <span
+<!--l. 10374--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-144016"></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. 10344--><p class="noindent" >
+</p><!--l. 10376--><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">
@@ -21326,15 +21380,15 @@
class="cmitt-10">insert</span>⟩
</div>
</div> otherwise.
-<!--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
+<!--l. 10387--><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 the glossary file (such as <span
class="cmtt-10">\glsadd </span>or the <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><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
+</p><!--l. 10394--><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
@@ -21343,18 +21397,18 @@
<span
class="cmtt-10">(pdf)latex</span>.
<a
- id="sec:entrycount"></a>
-</p><!--l. 10367--><p class="noindent" ><span
+ id="x1-144017r19"></a>
+</p><!--l. 10399--><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-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
+ id="x1-144018"></a>
+</p><!--l. 10400--><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>
- <pre class="verbatim" id="verbatim-280">
+ <pre class="verbatim" id="verbatim-282">
\documentclass{article}
\usepackage[colorlinks]{hyperref}
\usepackage[acronym]{glossaries}
@@ -21375,7 +21429,7 @@
\printglossaries
\end{document}
</pre>
-<!--l. 10396--><p class="nopar" > After a complete document build (<span
+<!--l. 10428--><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
@@ -21384,38 +21438,38 @@
displayed and don’t have a hyperlink. </p>
<div class="center"
>
-<!--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
+<!--l. 10434--><p class="noindent" >
+</p><!--l. 10434--><p class="noindent" >____________________________</p></div>
+<!--l. 10436--><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>
- <pre class="verbatim" id="verbatim-281">
+ <pre class="verbatim" id="verbatim-283">
\let\ac\cgls
</pre>
-<!--l. 10408--><p class="nopar" >
-</p><!--l. 10410--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> With <a
+<!--l. 10440--><p class="nopar" >
+</p><!--l. 10442--><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-143019"></a></a> there’s an analogous record counting set of commands. See <a
+ id="dx1-144019"></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-143020"></a></a>
+ id="dx1-144020"></a></a>
manuals for further details. </div>
-</p><!--l. 10413--><p class="noindent" >
+</p><!--l. 10445--><p class="noindent" >
</p>
-<!--l. 10415--><p class="indent" > </div>
-</p><!--l. 10415--><p class="noindent" ><a
+<!--l. 10447--><p class="indent" > </div>
+</p><!--l. 10447--><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><!--l. 10450--><p class="indent" > All defined glossaries may be displayed using:
</p><dl class="description"><dt class="description">
- <!--l. 10420--><p class="noindent" >
+ <!--l. 10452--><p class="noindent" >
<a
href="#option1"><span
class="cmbx-10">Option</span><span
@@ -21422,17 +21476,17 @@
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
+ <!--l. 10452--><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
+ id="dx1-145001"></a> in the preamble.)
+ </p><!--l. 10454--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-145002"></a> <span
class="cmtt-10">\printnoidxglossaries </span></div><hr>
- </p><!--l. 10424--><p class="noindent" >
+ </p><!--l. 10456--><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" >
+ <!--l. 10459--><p class="noindent" >
<span
class="cmbx-10">Options</span><span
class="cmbx-10"> </span><a
@@ -21444,17 +21498,17 @@
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
+ <!--l. 10459--><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
+ id="dx1-145003"></a> in the preamble.)
+ </p><!--l. 10461--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-145004"></a> <span
class="cmtt-10">\printglossaries </span></div><hr>
- </p><!--l. 10431--><p class="noindent" >
+ </p><!--l. 10463--><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" >
+ <!--l. 10466--><p class="noindent" >
<span
class="cmbx-10">Options</span><span
class="cmbx-10"> </span><a
@@ -21465,49 +21519,49 @@
class="cmbx-10">6</span></a><span
class="cmbx-10">:</span> </p></dt><dd
class="description">
- <!--l. 10434--><p class="noindent" >(<a
+ <!--l. 10466--><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
+ </p><!--l. 10467--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-145005"></a> <span
class="cmtt-10">\printunsrtglossaries </span></div><hr>
- </p><!--l. 10437--><p class="noindent" >
+ </p><!--l. 10469--><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
+<!--l. 10472--><p class="noindent" >These commands will display all the glossaries in the order in which they were defined.
+</p><!--l. 10475--><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-144006"></a></a> or Lua script <a
+ id="dx1-145006"></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
+ id="dx1-145007"></a></a> or have directly used <a
href="#glo:makeindex"><span
class="cmtt-10">makeindex</span><a
- id="dx1-144008"></a></a> or <a
+ id="dx1-145008"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-144009"></a></a> (as described
+ id="dx1-145009"></a></a> (as described
in <a
href="#sec:makeglossaries">§<span
-class="cmbx-10">??</span>sec:makeglossaries </a><a
+class="cmbx-10">1.5</span> </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
+ id="dx1-145010"></a></a>.
+</p><!--l. 10482--><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
+ id="dx1-145011"></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
+ id="dx1-145012"></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
@@ -21514,8 +21568,8 @@
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
+</p><!--l. 10493--><p class="noindent" >
+</p><!--l. 10495--><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
@@ -21523,23 +21577,23 @@
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
+</p><!--l. 10499--><p class="noindent" >
+</p><!--l. 10501--><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
+ id="dx1-145013"></a>, <span
class="cmtt-10">xindy</span><a
- id="dx1-144014"></a> or
+ id="dx1-145014"></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
+ id="dx1-145015"></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>
+ id="dx1-145016"></a>s</a>
up-to-date.
-</p><!--l. 10475--><p class="indent" > An individual glossary can be displayed using:
+</p><!--l. 10507--><p class="indent" > An individual glossary can be displayed using:
</p><dl class="description"><dt class="description">
- <!--l. 10477--><p class="noindent" >
+ <!--l. 10509--><p class="noindent" >
<a
href="#option1"><span
class="cmbx-10">Option</span><span
@@ -21546,18 +21600,18 @@
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
+ <!--l. 10509--><p class="noindent" >
+ </p><!--l. 10510--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-145017"></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" >
+ </p><!--l. 10512--><p class="noindent" >
(Must be used with <span
class="cmtt-10">\makenoidxglossaries</span><a
- id="dx1-144018"></a> in the preamble.)
+ id="dx1-145018"></a> in the preamble.)
</p></dd><dt class="description">
- <!--l. 10483--><p class="noindent" >
+ <!--l. 10515--><p class="noindent" >
<span
class="cmbx-10">Options</span><span
class="cmbx-10"> </span><a
@@ -21569,18 +21623,18 @@
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
+ <!--l. 10515--><p class="noindent" >
+ </p><!--l. 10516--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-145019"></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" >
+ </p><!--l. 10518--><p class="noindent" >
(Must be used with <span
class="cmtt-10">\makeglossaries</span><a
- id="dx1-144020"></a> in the preamble.)
+ id="dx1-145020"></a> in the preamble.)
</p></dd><dt class="description">
- <!--l. 10489--><p class="noindent" >
+ <!--l. 10521--><p class="noindent" >
<span
class="cmbx-10">Options</span><span
class="cmbx-10"> </span><a
@@ -21591,30 +21645,30 @@
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
+ <!--l. 10521--><p class="noindent" >
+ </p><!--l. 10523--><p class="noindent" ><hr><div title="Definition"><span id="textcolor292"><span
class="cmtt-10">\printunsrtglossary</span></span><a
- id="dx1-144021"></a><span
+ id="dx1-145021"></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" >
+ </p><!--l. 10524--><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
+ id="dx1-145022"></a></a>.)</p></dd></dl>
+<!--l. 10527--><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
+</p><!--l. 10531--><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
+</p><!--l. 10534--><p class="indent" > <hr><div title="Definition"><span id="textcolor293"><span
class="cmtt-10">\printunsrtinnerglossary</span></span><a
- id="dx1-144023"></a><span
+ id="dx1-145023"></a><span
class="cmtt-10">[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -21622,7 +21676,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">post code</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10504--><p class="noindent" >
+</p><!--l. 10536--><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
@@ -21629,8 +21683,8 @@
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
+</p><!--l. 10541--><p class="noindent" >
+</p><!--l. 10543--><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>:
@@ -21637,89 +21691,89 @@
</p><dl class="description"><dt class="description">
- <!--l. 10513--><p class="noindent" >
+ <!--l. 10545--><p class="noindent" >
<span
class="cmtt-10">type</span><a
- id="dx1-144024"></a> </p></dt><dd
+ id="dx1-145024"></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
+ <!--l. 10545--><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">
+ <pre class="verbatim" id="verbatim-284">
\printglossary[type=\acronymtype]
</pre>
- <!--l. 10518--><p class="nopar" > Note that you can’t display an ignored glossary, so don’t try setting <span
+ <!--l. 10550--><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
+ id="dx1-145025"></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
+ id="dx1-145026"></a>, described in <a
href="#sec:newglossary">§<span
-class="cmbx-10">??</span>sec:newglossary </a><a
+class="cmbx-10">9</span> </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
+ id="dx1-145027"></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" >
+ <!--l. 10557--><p class="noindent" >
<span
class="cmtt-10">title</span><a
- id="dx1-144028"></a> </p></dt><dd
+ id="dx1-145028"></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).
+ <!--l. 10557--><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" >
+ <!--l. 10561--><p class="noindent" >
<span
class="cmtt-10">toctitle</span><a
- id="dx1-144029"></a> </p></dt><dd
+ id="dx1-145029"></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
+ <!--l. 10561--><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
+ id="dx1-145030"></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
+ id="dx1-145031"></a> is
used.
</p></dd><dt class="description">
- <!--l. 10535--><p class="noindent" >
+ <!--l. 10567--><p class="noindent" >
<span
class="cmtt-10">style</span><a
- id="dx1-144032"></a> </p></dt><dd
+ id="dx1-145032"></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
+ <!--l. 10567--><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
+ id="dx1-145033"></a> package option
or <span
class="cmtt-10">\glossarystyle</span><a
- id="dx1-144034"></a>.
+ id="dx1-145034"></a>.
</p></dd><dt class="description">
- <!--l. 10539--><p class="noindent" >
+ <!--l. 10571--><p class="noindent" >
<span
class="cmtt-10">numberedsection</span><a
- id="dx1-144035"></a> </p></dt><dd
+ id="dx1-145035"></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
+ <!--l. 10571--><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
+ id="dx1-145036"></a> package option. This key has the same syntax as the <span
class="cmss-10">numberedsection</span><a
- id="dx1-144037"></a> package option,
+ id="dx1-145037"></a> package option,
described in <a
href="#sec:pkgopts-sec">§<span
-class="cmbx-10">??</span>sec:pkgopts-sec </a><a
+class="cmbx-10">2.2</span> </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" >
+ <!--l. 10577--><p class="noindent" >
<span
class="cmtt-10">nonumberlist</span><a
- id="dx1-144038"></a> </p></dt><dd
+ id="dx1-145038"></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
+ <!--l. 10577--><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.
@@ -21726,53 +21780,53 @@
</p></dd><dt class="description">
- <!--l. 10550--><p class="noindent" >
+ <!--l. 10582--><p class="noindent" >
<span
class="cmtt-10">nogroupskip</span><a
- id="dx1-144039"></a> </p></dt><dd
+ id="dx1-145039"></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.
+ <!--l. 10582--><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" >
+ <!--l. 10586--><p class="noindent" >
<span
class="cmtt-10">nopostdot</span><a
- id="dx1-144040"></a> </p></dt><dd
+ id="dx1-145040"></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.
+ <!--l. 10586--><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" >
+ <!--l. 10590--><p class="noindent" >
<span
class="cmtt-10">entrycounter</span><a
- id="dx1-144041"></a> </p></dt><dd
+ id="dx1-145041"></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
+ <!--l. 10590--><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.
+ id="dx1-145042"></a> work correctly.
</p></dd><dt class="description">
- <!--l. 10563--><p class="noindent" >
+ <!--l. 10595--><p class="noindent" >
<span
class="cmtt-10">subentrycounter</span><a
- id="dx1-144043"></a> </p></dt><dd
+ id="dx1-145043"></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
+ <!--l. 10595--><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
+ id="dx1-145044"></a> and <span
class="cmtt-10">subentrycounter</span><a
- id="dx1-144045"></a>, make sure you specify <span
+ id="dx1-145045"></a>, make sure you specify <span
class="cmtt-10">entrycounter</span><a
- id="dx1-144046"></a> first. The corresponding
+ id="dx1-145046"></a> first. The corresponding
package option must be used to make <span
class="cmtt-10">\glsrefentry</span><a
- id="dx1-144047"></a> work correctly.
+ id="dx1-145047"></a> work correctly.
</p></dd><dt class="description">
- <!--l. 10570--><p class="noindent" >
+ <!--l. 10602--><p class="noindent" >
<span
class="cmtt-10">sort</span><a
- id="dx1-144048"></a> </p></dt><dd
+ id="dx1-145048"></a> </p></dt><dd
class="description">
- <!--l. 10570--><p class="noindent" >This key is only available for <a
+ <!--l. 10602--><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),
@@ -21779,7 +21833,7 @@
<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
+ id="dx1-145049"></a> package option), <span
class="cmtt-10">use </span>(order of use), <span
class="cmtt-10">def </span>(order of
definition) <span
@@ -21791,25 +21845,25 @@
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
+ id="dx1-145050"></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
+ id="dx1-145051"></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>
+ id="dx1-145052"></a></a>
provides many other sort options.
- </p><!--l. 10582--><p class="noindent" ><div class="important" title="Important Note"> If you use the <span
+ </p><!--l. 10614--><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.
+ id="dx1-145053"></a> option.
</div>
- </p><!--l. 10587--><p class="noindent" >
- </p><!--l. 10590--><p class="noindent" >The
+ </p><!--l. 10619--><p class="noindent" >
+ </p><!--l. 10622--><p class="noindent" >The
word
and
letter
@@ -21821,14 +21875,14 @@
<span
class="cmss-10">datatool</span><a
- id="dx1-144054"></a>’s
+ id="dx1-145054"></a>’s
<span
class="cmtt-10">\dtlwordindexcompare</span><a
- id="dx1-144055"></a>
+ id="dx1-145055"></a>
and
<span
class="cmtt-10">\dtlletterindexcompare</span><a
- id="dx1-144056"></a>
+ id="dx1-145056"></a>
handlers.
The
case-insensitive
@@ -21837,10 +21891,10 @@
uses
<span
class="cmss-10">datatool</span><a
- id="dx1-144057"></a>’s
+ id="dx1-145057"></a>’s
<span
class="cmtt-10">\dtlicompare</span><a
- id="dx1-144058"></a>
+ id="dx1-145058"></a>
handler.
The
case-sensitive
@@ -21849,21 +21903,21 @@
uses
<span
class="cmss-10">datatool</span><a
- id="dx1-144059"></a>’s
+ id="dx1-145059"></a>’s
<span
class="cmtt-10">\dtlcompare</span><a
- id="dx1-144060"></a>
+ id="dx1-145060"></a>
handler.
See
the
<span
class="cmss-10">datatool</span><a
- id="dx1-144061"></a>
+ id="dx1-145061"></a>
documentation
for
further
details.
- </p><!--l. 10599--><p class="noindent" >If you don’t get an error with <span
+ </p><!--l. 10631--><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
@@ -21870,19 +21924,19 @@
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
+ id="dx1-145062"></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.
+ id="dx1-145063"></a> field.
</p></dd><dt class="description">
- <!--l. 10605--><p class="noindent" >
+ <!--l. 10637--><p class="noindent" >
<a
- id="dx1-144064"></a><span id="textcolor295"><span
+ id="dx1-145064"></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
+ <!--l. 10637--><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
@@ -21892,16 +21946,16 @@
class="cmss-10">numberedsection</span><span
class="cmtt-10">=</span><span
class="cmss-10">autolabel</span><a
- id="dx1-144065"></a>
+ id="dx1-145065"></a>
</p></dd><dt class="description">
- <!--l. 10610--><p class="noindent" >
+ <!--l. 10642--><p class="noindent" >
<a
- id="dx1-144066"></a><span id="textcolor296"><span
+ id="dx1-145066"></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
+ <!--l. 10642--><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
@@ -21908,26 +21962,26 @@
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
+ </p><!--l. 10647--><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
+ id="dx1-145067"></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" >
+ <!--l. 10651--><p class="noindent" >
<a
- id="dx1-144068"></a><span id="textcolor298"><span
+ id="dx1-145068"></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
+ <!--l. 10651--><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
+ id="dx1-145069"></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
@@ -21934,30 +21988,30 @@
class="cmtt-10">\glslink </span>or <span
class="cmtt-10">\glshypertarget</span>.
</p></dd><dt class="description">
- <!--l. 10627--><p class="noindent" >
+ <!--l. 10659--><p class="noindent" >
<a
- id="dx1-144070"></a><span id="textcolor299"><span
+ id="dx1-145070"></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
+ <!--l. 10659--><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
+ id="dx1-145071"></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" >
+ <!--l. 10666--><p class="noindent" >
<a
- id="dx1-144072"></a><span id="textcolor300"><span
+ id="dx1-145072"></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
+ <!--l. 10666--><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
@@ -21964,113 +22018,113 @@
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" >
+ <!--l. 10671--><p class="noindent" >
<a
- id="dx1-144073"></a><span id="textcolor301"><span
+ id="dx1-145073"></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
+ <!--l. 10671--><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
+ id="dx1-145074"></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
+<!--l. 10678--><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
+ id="dx1-145075"></a> or by <span
class="cmtt-10">\section*</span><a
- id="dx1-144076"></a>, depending on whether or not
+ id="dx1-145076"></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
+ id="dx1-145077"></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
+ id="dx1-145078"></a> package option or the <span
class="cmtt-10">\setglossarysection</span><a
- id="dx1-144079"></a>
+ id="dx1-145079"></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
+ id="dx1-145080"></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
+</p><!--l. 10684--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-145081"></a> <span
class="cmtt-10">\glsglossarymark</span><a
- id="dx1-144082"></a><span
+ id="dx1-145082"></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" >
+</p><!--l. 10686--><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
+ id="dx1-145083"></a>. Further information about these options and commands is given in <a
href="#sec:pkgopts-sec">§<span
-class="cmbx-10">??</span>sec:pkgopts-sec
+class="cmbx-10">2.2</span>
</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
+</p><!--l. 10692--><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
+</p><!--l. 10694--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-145084"></a> <span
class="cmtt-10">\glossarypreamble </span></div><hr>
-</p><!--l. 10664--><p class="noindent" >
+</p><!--l. 10696--><p class="noindent" >
For example:
</p>
- <pre class="verbatim" id="verbatim-283">
+ <pre class="verbatim" id="verbatim-285">
\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
+<!--l. 10701--><p class="nopar" > This needs to be done before the glossary is displayed.
+</p><!--l. 10704--><p class="indent" > If you want a different preamble per glossary you can use
+</p><!--l. 10705--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-145085"></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" >
+</p><!--l. 10707--><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><!--l. 10710--><p class="indent" > For example:
</p>
- <pre class="verbatim" id="verbatim-284">
+ <pre class="verbatim" id="verbatim-286">
\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
+<!--l. 10714--><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
+</p><!--l. 10718--><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
+</p><!--l. 10719--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-145086"></a> <span
class="cmtt-10">\glossarypostamble </span></div><hr>
-</p><!--l. 10689--><p class="noindent" >
+</p><!--l. 10721--><p class="noindent" >
which is placed at the end of each glossary.
<a
- id="ex:twocolumn"></a>
-</p><!--l. 10692--><p class="noindent" ><span
+ id="x1-145087r20"></a>
+</p><!--l. 10724--><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
+ id="x1-145088"></a>
+</p><!--l. 10725--><p class="indent" > Suppose you are using the <span
class="cmss-10">superheaderborder</span><a
- id="dx1-144089"></a>
+ id="dx1-145089"></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>,
+ id="x1-145090f1"></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">
+ <pre class="verbatim" id="verbatim-287">
\renewcommand*{\glossarysection}[2][]{%
  \twocolumn[{\chapter*{#2}}]%
  \setlength\glsdescwidth{0.6\linewidth}%
@@ -22078,99 +22132,99 @@
}
\renewcommand*{\glossarypostamble}{\onecolumn}
</pre>
-<!--l. 10707--><p class="nopar" >
+<!--l. 10739--><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
+<!--l. 10741--><p class="noindent" >
+</p><!--l. 10741--><p class="noindent" >____________________________</p></div>
+<!--l. 10743--><p class="indent" > Within each glossary, each entry name is formatted according to
+</p><!--l. 10744--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-145094"></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" >
+</p><!--l. 10746--><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
+ id="dx1-145095"></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
+ id="dx1-145096"></a> and <span
class="cmss-10">glossary-super</span><a
- id="dx1-144097"></a> style files) the name will appear in the normal
+ id="dx1-145097"></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
+ id="dx1-145098"></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
+</p><!--l. 10759--><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
+ id="x1-145099r21"></a>
+</p><!--l. 10765--><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
+ id="x1-145100"></a>
+</p><!--l. 10766--><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">
+ <pre class="verbatim" id="verbatim-288">
\renewcommand{\glsnamefont}[1]{\textsc{\mdseries #1}}
</pre>
-<!--l. 10738--><p class="nopar" > </p>
+<!--l. 10770--><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
+<!--l. 10771--><p class="noindent" >
+</p><!--l. 10771--><p class="noindent" >____________________________</p></div>
+<!--l. 10773--><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
+</p><!--l. 10776--><p class="noindent" >
+</p><!--l. 10778--><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
+ id="dx1-145101"></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
+ id="dx1-145102"></a>, (see <a
href="#sec:fixednames">§<span
-class="cmbx-10">??</span>sec:fixednames
+class="cmbx-10">1.4.1</span>
</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
+ id="dx1-145103"></a> and
<span id="textcolor304"><span
class="cmtt-10">\glsxtrlocalsetgrouptitle</span></span><a
- id="dx1-144104"></a>. The ⟨<span
+ id="dx1-145104"></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
+<!--l. 10786--><p class="indent" > </div>
+</p><!--l. 10786--><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
+</p><!--l. 10789--><p class="indent" > A new glossary can be defined using:
+</p><!--l. 10790--><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
@@ -22186,7 +22240,7 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">counter</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10760--><p class="noindent" >
+</p><!--l. 10792--><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
@@ -22196,23 +22250,23 @@
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
+ id="dx1-146002"></a>s</a> (see also
<a
href="#sec:numberlists">§<span
-class="cmbx-10">??</span>sec:numberlists </a><a
+class="cmbx-10">12</span> </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>
+ 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-145004"></a></a> (<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-145005"></a></a> which picks
+ 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
@@ -22219,16 +22273,16 @@
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
+</p><!--l. 10806--><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).
+ id="dx1-146006"></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
+</p><!--l. 10811--><p class="noindent" >
+</p><!--l. 10813--><p class="indent" > There is also a starred version (new to v4.08):
+</p><!--l. 10814--><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
@@ -22236,7 +22290,7 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">counter</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10784--><p class="noindent" >
+</p><!--l. 10816--><p class="noindent" >
which is equivalent to </p><div class="alltt">
<div class="obeylines-v">
<span
@@ -22259,8 +22313,8 @@
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
+<!--l. 10822--><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
@@ -22270,7 +22324,7 @@
class="cmtt-10">}[</span>⟨<span
class="cmitt-10">counter</span>⟩<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 10792--><p class="noindent" >
+</p><!--l. 10824--><p class="noindent" >
which is equivalent to </p><div class="alltt">
<div class="obeylines-v">
<span
@@ -22293,42 +22347,42 @@
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
+<!--l. 10830--><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
+ id="dx1-146009"></a>. To
define an ignored glossary, use
-</p><!--l. 10804--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-145010"></a> <span
+</p><!--l. 10836--><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. 10806--><p class="noindent" >
+</p><!--l. 10838--><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
+ 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. 10813--><p class="indent" > <div title="glossaries-extra.sty" style="border: solid 2pt green;"> The <a
+</p><!--l. 10845--><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
+ id="dx1-146012"></a></a>). There is also an analogous <span id="textcolor305"><span
class="cmtt-10">\provideignoredglossary</span></span><a
- id="dx1-145013"></a>
+ id="dx1-146013"></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
+</p><!--l. 10850--><p class="noindent" >
+</p><!--l. 10852--><p class="indent" > You can test if a glossary is an ignored one using:
+</p><!--l. 10853--><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
@@ -22336,181 +22390,181 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">false</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 10823--><p class="noindent" >
+</p><!--l. 10855--><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><!--l. 10859--><p class="indent" > Note that the main (default) glossary is automatically created as:
</p>
- <pre class="verbatim" id="verbatim-287">
+ <pre class="verbatim" id="verbatim-289">
\newglossary{main}{gls}{glo}{\glossaryname}
</pre>
-<!--l. 10830--><p class="nopar" > so it can be identified by the label <span
+<!--l. 10862--><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
+ id="dx1-146015"></a> package option is used). Using the <span
class="cmss-10">acronym</span><a
- id="dx1-145016"></a> package
+ id="dx1-146016"></a> package
option is equivalent to:
</p>
- <pre class="verbatim" id="verbatim-288">
+ <pre class="verbatim" id="verbatim-290">
\newglossary[alg]{acronym}{acr}{acn}{\acronymname}
</pre>
-<!--l. 10836--><p class="nopar" > so it can be identified by the label <span
+<!--l. 10868--><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
+ id="dx1-146017"></a> option has been used, you
can identify the list of acronyms by the command <a
- id="dx1-145018"></a><span
+ 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-145019"></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-145020"></a>.
-</p><!--l. 10847--><p class="indent" > The <span
+ id="dx1-146020"></a>.
+</p><!--l. 10879--><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
+ id="dx1-146021"></a> package option creates a new glossary with the label <span
class="cmtt-10">symbols </span>using:
</p>
- <pre class="verbatim" id="verbatim-289">
+ <pre class="verbatim" id="verbatim-291">
\newglossary[slg]{symbols}{sls}{slo}{\glssymbolsgroupname}
</pre>
-<!--l. 10851--><p class="nopar" > The <span
+<!--l. 10883--><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
+ id="dx1-146022"></a> package option creates a new glossary with the label <span
class="cmtt-10">numbers </span>using:
</p>
- <pre class="verbatim" id="verbatim-290">
+ <pre class="verbatim" id="verbatim-292">
\newglossary[nlg]{numbers}{nls}{nlo}{\glsnumbersgroupname}
</pre>
-<!--l. 10856--><p class="nopar" > The <span
+<!--l. 10888--><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
+ id="dx1-146023"></a> package option creates a new glossary with the label <span
class="cmtt-10">index </span>using:
</p>
- <pre class="verbatim" id="verbatim-291">
+ <pre class="verbatim" id="verbatim-293">
\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
+<!--l. 10893--><p class="nopar" >
+</p><!--l. 10895--><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
+ id="dx1-146024"></a> to ensure that the relevant output
files are opened.
-</p><!--l. 10867--><p class="indent" > See <a
+</p><!--l. 10899--><p class="indent" > See <a
href="#sec:fixednames">§<span
-class="cmbx-10">??</span>sec:fixednames </a><a
+class="cmbx-10">1.4.1</span> </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
+ id="dx1-146025"></a> or <span
class="cmss-10">translator</span><a
- id="dx1-145026"></a>. (Similarly for <span
+ 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-145027"></a>, just follow the advice in <a
+ id="dx1-146027"></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. 10906--><p class="noindent" >
</p>
-<!--l. 10876--><p class="indent" > </div>
-</p><!--l. 10876--><p class="noindent" ><a
+<!--l. 10908--><p class="indent" > </div>
+</p><!--l. 10908--><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
+</p><!--l. 10911--><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
+</p><!--l. 10913--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-147001"></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" >
+</p><!--l. 10915--><p class="noindent" >
This is similar to the <a
-href="#sec:glstext-like"><span
+href="#x1-1320005.1.2"><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>
+ id="dx1-147002"></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
+href="#x1-1320005.1.2"><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
+</p><!--l. 10921--><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
+ id="dx1-147003"></a> key. (See <a
href="#sec:encap">§<span
-class="cmbx-10">??</span>sec:encap </a><a
+class="cmbx-10">12.1</span> </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
+</p><!--l. 10927--><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">
+ <pre class="verbatim" id="verbatim-294">
\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
+<!--l. 10933--><p class="nopar" >
+</p><!--l. 10935--><p class="indent" > To add all entries that have been defined, use:
+</p><!--l. 10936--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-147004"></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" >
+</p><!--l. 10938--><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
+ id="dx1-147005"></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
+ id="dx1-147006"></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">
+ <pre class="verbatim" id="verbatim-295">
\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
+<!--l. 10949--><p class="nopar" >
+</p><!--l. 10951--><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
+ id="dx1-147007"></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
@@ -22517,51 +22571,51 @@
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
+ id="dx1-147008"></a> files. </div>
+</p><!--l. 10955--><p class="noindent" >
+</p><!--l. 10957--><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
+ id="dx1-147009"></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
+ id="dx1-147010"></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
+</p><!--l. 10964--><p class="noindent" >
+</p><!--l. 10966--><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
+</p><!--l. 10968--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-147011"></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" >
+</p><!--l. 10970--><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
+class="cmbx-10">12.1</span> </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
+</p><!--l. 10977--><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
+</p><!--l. 10982--><p class="noindent" >
+</p><!--l. 10984--><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
+ id="dx1-147012"></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
@@ -22568,14 +22622,14 @@
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
+</p><!--l. 10992--><p class="noindent" >
+</p><!--l. 10994--><p class="indent" > Base <span
class="cmss-10">glossaries</span><a
- id="dx1-146013"></a> package only:
+ id="dx1-147013"></a> package only:
</p>
- <pre class="verbatim" id="verbatim-294">
+ <pre class="verbatim" id="verbatim-296">
\documentclass{article}
\usepackage{glossaries}
\makeglossaries
@@ -22587,16 +22641,16 @@
\glsaddallunused % <- make sure dog is also listed
\end{document}
</pre>
-<!--l. 10974--><p class="nopar" > Corresponding <a
+<!--l. 11006--><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:
+ id="dx1-147014"></a></a> document code:
</p>
- <pre class="verbatim" id="verbatim-295">
+ <pre class="verbatim" id="verbatim-297">
\documentclass{article}
\usepackage[record]{glossaries-extra}
\GlsXtrLoadResources[src={entries},selection=all]
@@ -22605,41 +22659,41 @@
\printunsrtglossaries
\end{document}
</pre>
-<!--l. 10984--><p class="nopar" > With the file <span
+<!--l. 11016--><p class="nopar" > With the file <span
class="cmtt-10">entries.bib</span>:
</p>
- <pre class="verbatim" id="verbatim-296">
+ <pre class="verbatim" id="verbatim-298">
@entry{cat,name={cat},description={feline}}
@entry{dog,name={dog},description={canine}}
</pre>
-<!--l. 10989--><p class="nopar" >
+<!--l. 11021--><p class="nopar" >
<a
- id="ex:dual"></a>
-</p><!--l. 10991--><p class="noindent" ><span
+ id="x1-147015r22"></a>
+</p><!--l. 11023--><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
+ id="x1-147016"></a>
+</p><!--l. 11024--><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>
+ id="dx1-147017"></a>
package option:
</p>
- <pre class="verbatim" id="verbatim-297">
+ <pre class="verbatim" id="verbatim-299">
\usepackage[acronym]{glossaries}
</pre>
-<!--l. 10998--><p class="nopar" > A new command is then defined to make it easier to define dual entries:
+<!--l. 11030--><p class="nopar" > A new command is then defined to make it easier to define dual entries:
</p>
- <pre class="verbatim" id="verbatim-298">
+ <pre class="verbatim" id="verbatim-300">
\newcommand*{\newdualentry}[5][]{%
  \newglossaryentry{main-#2}{name={#4},%
  text={#3\glsadd{#2}},%
@@ -22649,11 +22703,11 @@
  \newacronym{#2}{#3\glsadd{main-#2}}{#4}%
}
</pre>
-<!--l. 11010--><p class="nopar" > This has the following syntax: </p><div class="alltt">
+<!--l. 11042--><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
+ id="dx1-147018"></a><span
class="cmtt-10">[</span>⟨<span
class="cmitt-10">options</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -22669,51 +22723,51 @@
</div> You can then define a new dual entry:
- <pre class="verbatim" id="verbatim-299">
+ <pre class="verbatim" id="verbatim-301">
\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
+<!--l. 11053--><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
+</p><!--l. 11057--><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
+</p><!--l. 11064--><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
+ id="dx1-147019"></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
+ id="dx1-147020"></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><!--l. 11070--><p class="noindent" >
</p>
<div class="center"
>
-<!--l. 11039--><p class="noindent" >
-</p><!--l. 11039--><p class="noindent" >____________________________</p></div>
+<!--l. 11071--><p class="noindent" >
+</p><!--l. 11071--><p class="noindent" >____________________________</p></div>
-<!--l. 11041--><p class="indent" > </div>
-</p><!--l. 11041--><p class="noindent" ><a
+<!--l. 11073--><p class="indent" > </div>
+</p><!--l. 11073--><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
+</p><!--l. 11076--><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
+ id="dx1-148001"></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
+ id="dx1-148002"></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
@@ -22724,27 +22778,27 @@
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><!--l. 11084--><p class="noindent" >
+</p><!--l. 11086--><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="enumerate" id="x1-148004x1">
+ <!--l. 11090--><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:
+ id="dx1-148005"></a> in the entries description. For example:
</p>
- <pre class="verbatim" id="verbatim-300">
+ <pre class="verbatim" id="verbatim-302">
\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,
+ <!--l. 11095--><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">
+ id="dx1-148006"></a></a>:
+ </p><!--l. 11099--><p class="noindent" ><spacer type=vertical size=10><pre class="prompt"><span class="obeylines-h">
<br />pdflatex filename
<br />makeglossaries filename
<br />pdflatex filename
@@ -22756,76 +22810,76 @@
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
+ id="dx1-148007"></a>). Take care not to use <span
class="cmtt-10">\glsdesc</span><a
- id="dx1-147008"></a>
+ id="dx1-148008"></a>
(or <span
class="cmtt-10">\Glsdesc</span><a
- id="dx1-147009"></a>) in this case as it will cause a nested link.
+ id="dx1-148009"></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
+ class="enumerate" id="x1-148011x2">
+ <!--l. 11112--><p class="noindent" >As described in <a
href="#sec:newglosentry">§<span
-class="cmbx-10">??</span>sec:newglosentry </a><a
+class="cmbx-10">4</span> </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
+ id="dx1-148012"></a> key when you define
the entry. For example:
</p>
- <pre class="verbatim" id="verbatim-301">
+ <pre class="verbatim" id="verbatim-303">
\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
+ <!--l. 11119--><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
+ id="dx1-148013"></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
+class="cmbx-10">5.1</span> </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
+class="cmbx-10">10</span> </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
+ </p><!--l. 11126--><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
+ id="dx1-148014"></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:
+ id="dx1-148015"></a> value. For example:
</p>
- <pre class="verbatim" id="verbatim-302">
+ <pre class="verbatim" id="verbatim-304">
\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
+ <!--l. 11134--><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
+ id="dx1-148016"></a> or <span
class="cmtt-10">\newterm</span><a
- id="dx1-147017"></a> as
+ id="dx1-148017"></a> as
the value will need to be grouped. For example:
</p>
- <pre class="verbatim" id="verbatim-303">
+ <pre class="verbatim" id="verbatim-305">
\newterm{seal}
\newterm[see={[see also]seal}]{sea lion}
</pre>
- <!--l. 11109--><p class="nopar" > Similarly if the value contains a list. For example:
+ <!--l. 11141--><p class="nopar" > Similarly if the value contains a list. For example:
</p>
- <pre class="verbatim" id="verbatim-304">
+ <pre class="verbatim" id="verbatim-306">
\glossaryentry{lemon}{
  name={lemon},
  description={Yellow citrus fruit}
@@ -22842,13 +22896,13 @@
  see={lemon,lime}
}
</pre>
- <!--l. 11127--><p class="nopar" >
+ <!--l. 11159--><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="enumerate" id="x1-148019x3">
+ <!--l. 11161--><p class="noindent" >After you have defined the entry, use
+ </p><!--l. 11162--><p class="noindent" ><hr><div title="Definition"><a
+ id="dx1-148020"></a> <span
class="cmtt-10">\glssee[</span>⟨<span
class="cmitt-10">tag</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -22856,7 +22910,7 @@
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" >
+ </p><!--l. 11164--><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
@@ -22864,58 +22918,58 @@
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
+ id="dx1-148021"></a>.) For
example:
</p>
- <pre class="verbatim" id="verbatim-305">
+ <pre class="verbatim" id="verbatim-307">
\glssee[see also]{series}{FourierSeries,TaylorsTheorem}
</pre>
- <!--l. 11140--><p class="nopar" > Note that this automatically adds the entry given by ⟨<span
+ <!--l. 11172--><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
+<!--l. 11178--><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,
+ id="dx1-148022"></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
+ id="dx1-148023"></a>. In this case, you will need to activate the number list<a
+ id="dx1-148024"></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
+ id="dx1-148025"></a>. Alternatively, if you just use the <span
class="cmtt-10">see</span><a
- id="dx1-147026"></a> key instead
+ id="dx1-148026"></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
+ id="dx1-148027"></a>, you can automatically activate the number list<a
+ id="dx1-148028"></a> using the <span
class="cmss-10">seeautonumberlist</span><a
- id="dx1-147029"></a> package
+ id="dx1-148029"></a> package
option.
-</p><!--l. 11158--><p class="indent" > <div title="bib2gls" style="border: solid 2pt green;"> <a
+</p><!--l. 11190--><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
+ id="dx1-148030"></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. 11194--><p class="noindent" >
</p>
-<!--l. 11164--><p class="noindent" ><a
+<!--l. 11196--><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
+<!--l. 11199--><p class="noindent" >When you use either the <span
class="cmtt-10">see</span><a
- id="dx1-148001"></a> key or the command <span
+ id="dx1-149001"></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
+</p><!--l. 11202--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-149002"></a> <span
class="cmtt-10">\glsseeformat[</span>⟨<span
class="cmitt-10">tag</span>⟩<span
class="cmtt-10">]{</span>⟨<span
@@ -22923,7 +22977,7 @@
class="cmtt-10">}{</span>⟨<span
class="cmitt-10">location</span>⟩<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 11172--><p class="noindent" >
+</p><!--l. 11204--><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
@@ -22935,146 +22989,146 @@
<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>
+ id="x1-149003f1"></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>
+ id="x1-149005f2"></a>
</p>
- <pre class="verbatim" id="verbatim-306">
+ <pre class="verbatim" id="verbatim-308">
\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
+<!--l. 11220--><p class="nopar" >
+</p><!--l. 11223--><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
+</p><!--l. 11226--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-149008"></a> <span
class="cmtt-10">\glsseesep </span></div><hr>
-</p><!--l. 11196--><p class="noindent" >
+</p><!--l. 11228--><p class="noindent" >
or (for the last pair)
-</p><!--l. 11198--><p class="indent" > <hr><div title="Definition"><a
- id="dx1-148009"></a> <span
+</p><!--l. 11230--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-149009"></a> <span
class="cmtt-10">\glsseelastsep </span></div><hr>
-</p><!--l. 11200--><p class="noindent" >
+</p><!--l. 11232--><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
+ id="dx1-149010"></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
+</p><!--l. 11236--><p class="indent" > <hr><div title="Definition"><a
+ id="dx1-149011"></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" >
+</p><!--l. 11238--><p class="noindent" >
This defaults to <span
class="cmtt-10">\glsentrytext</span><a
- id="dx1-148012"></a><span
+ id="dx1-149012"></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>
+ id="x1-149013f3"></a>
For example, to make the cross-referenced list use small caps:
</p>
- <pre class="verbatim" id="verbatim-307">
+ <pre class="verbatim" id="verbatim-309">
\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
+<!--l. 11246--><p class="nopar" >
+</p><!--l. 11247--><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>
+ id="dx1-149016"></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
+</p><!--l. 11252--><p class="noindent" >
+</p><!--l. 11254--><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
+ id="dx1-149017"></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
+ id="dx1-149018"></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">
+ <pre class="verbatim" id="verbatim-310">
Some information (see also
\glsseelist{FourierSeries,TaylorsTheorem}%
\glsadd{FourierSeries}\glsadd{TaylorsTheorem}).
</pre>
-<!--l. 11231--><p class="nopar" > </div>
-</p><!--l. 11232--><p class="noindent" >
+<!--l. 11263--><p class="nopar" > </div>
+</p><!--l. 11264--><p class="noindent" >
</p>
-<!--l. 11234--><p class="indent" > </div>
-</p><!--l. 11234--><p class="noindent" ><a
+<!--l. 11266--><p class="indent" > </div>
+</p><!--l. 11266--><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
+</p><!--l. 11269--><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
+ id="dx1-150001"></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
+class="cmbx-10">5.1</span> </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
+class="cmbx-10">10</span> </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
+ id="dx1-150002"></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
+ id="dx1-150003"></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
+ id="dx1-150004"></a>.
+</p><!--l. 11278--><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
+ id="dx1-150005"></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
+ id="dx1-150006"></a></a> or <a
href="#glo:xindy"><span
class="cmtt-10">xindy</span><a
- id="dx1-149007"></a></a> to hierarchically
+ id="dx1-150007"></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
+ id="dx1-150008"></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
+ id="dx1-150009"></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
+</p><!--l. 11293--><p class="indent" > The <span
class="cmtt-10">\glsaddall</span><a
- id="dx1-149010"></a> command (see <a
+ id="dx1-150010"></a> command (see <a
href="#sec:glsadd">§<span
-class="cmbx-10">??</span>sec:glsadd </a><a
+class="cmbx-10">10</span> </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
@@ -23085,14 +23139,14 @@
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
+ id="dx1-150011"></a></a>, which looks weird if the number list<a
+ id="dx1-150012"></a> hasn’t been
suppressed.
-</p><!--l. 11268--><p class="indent" > With <a
+</p><!--l. 11300--><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
+ id="dx1-150013"></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
@@ -23099,33 +23153,33 @@
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
+ id="dx1-150014"></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
+ id="dx1-150015"></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
+<!--l. 11310--><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
+<!--l. 11313--><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
+ id="dx1-151001"></a></a> is encapsulated with a command formed from the <span
class="cmti-10">encap</span><a
@@ Diff output truncated at 1234567 characters. @@
More information about the tex-live-commits
mailing list.