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