texlive[64903] trunk: glossaries (2nov22)
commits+karl at tug.org
commits+karl at tug.org
Wed Nov 2 23:04:34 CET 2022
Revision: 64903
http://tug.org/svn/texlive?view=revision&revision=64903
Author: karl
Date: 2022-11-02 23:04:34 +0100 (Wed, 02 Nov 2022)
Log Message:
-----------
glossaries (2nov22)
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-examples/glossaries-user-example001.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
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/glossaries.l2h
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-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/rollback/glossaries-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-accsupp-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-accsupp-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-babel-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-babel-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-207-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-207-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-307-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-307-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-polyglossia-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-polyglossia-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-prefix-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-prefix-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-hypernav-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-hypernav-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-inline-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-inline-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-list-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-list-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-long-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-long-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longbooktabs-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longbooktabs-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longragged-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longragged-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-mcols-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-mcols-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-super-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-super-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-superragged-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-superragged-2021-11-01.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-tree-2020-03-19.sty
trunk/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-tree-2021-11-01.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
trunk/Master/tlpkg/tlpsrc/glossaries.tlpsrc
Added Paths:
-----------
trunk/Master/texmf-dist/tex/latex/glossaries/test-entries/example-glossaries-user.tex
Modified: trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries
===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2022-11-02 22:02:31 UTC (rev 64902)
+++ trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2022-11-02 22:04:34 UTC (rev 64903)
@@ -2,7 +2,7 @@
# File : makeglossaries
# Author : Nicola Talbot
-# Version : 4.50
+# Version : 4.51
# 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.l2h.
# Also makeglossaries and makeglossaries-lite.lua.
-my $version="4.50 (2022-10-14)";
+my $version="4.51 (2022-11-02)";
# History:
+# v4.51:
+# * No change. (Version number updated in line with glossaries.sty)
# v4.50:
# * Added -e (don't fix encap clashes)
# * Add check for glsignore with encap clashes
Modified: trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua
===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2022-11-02 22:02:31 UTC (rev 64902)
+++ trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2022-11-02 22:04:34 UTC (rev 64903)
@@ -36,7 +36,7 @@
Also makeglossaries and makeglossaries-lite.lua.
History:
- * 4.48 - 4.50:
+ * 4.48 - 4.51:
- no change.
* 4.47:
- Added hybrid instructions if record option detected but not \makeglossaries
@@ -70,7 +70,7 @@
- changed first line from lua to texlua
--]]
-thisversion = "4.50 (2022-10-14)"
+thisversion = "4.51 (2022-11-02)"
quiet = false
dryrun = false
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES 2022-11-02 22:02:31 UTC (rev 64902)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES 2022-11-02 22:04:34 UTC (rev 64903)
@@ -1,5 +1,21 @@
glossaries change log:
+v4.51 (2022-11-02):
+
+ * glossaries.sty:
+
+ - indexing and unset/reset disabled during measuring
+
+ - added \glsmeasurewidth, \glsmeasureheight and \glsifmeasuring
+
+ - switched to \TrackIfKnownLanguage for the languages identified in
+ "languages" option
+
+ - added test file example-glossaries-user.tex
+
+ - bug fix #215 (automake doesn't work)
+ https://www.dickimaw-books.com/bugtracker.php?key=215
+
v4.50 (2022-10-14):
* glossaries.sty:
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/README.md 2022-11-02 22:02:31 UTC (rev 64902)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/README.md 2022-11-02 22:04:34 UTC (rev 64903)
@@ -1,4 +1,4 @@
-# glossaries v4.50 (2022-10-14)
+# glossaries v4.51 (2022-11-02)
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-examples/glossaries-user-example001.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2022-11-02 22:02:31 UTC (rev 64902)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2022-11-02 22:04:34 UTC (rev 64903)
@@ -13,7 +13,7 @@
</script>
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>
- !
!
<title>User Manual for glossaries.sty v4.50</title>
+ !
!
<title>User Manual for glossaries.sty v4.51</title>
<style type="text/css">
#main {margin-left: 5%; margin-right: 15%}
div.tomain {position: absolute; left: 0pt; width: 5%; text-align: right; font-size: x-small;}
@@ -197,6 +197,12 @@
span.halfturn {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(180.000000deg); -ms-transform: rotate(180.000000deg); -webkit-transform: rotate(180.000000deg); display: inline-block; }
span.fwsdisabledicon {border-style: none; color: gray; }
span.fwsactiveicon {border-style: none; color: green; }
+table.glossary-ruled { border-top: solid 2px; border-bottom: solid 2px; border-collapse: collapse; }
+tr.glossary-ruled { border-bottom: solid 1px; }
+.cell-left-border { border-left: solid 1px; }
+table.glossary-ruled td { vertical-align: text-top; }
+table.glossary td { vertical-align: text-top; }
+div.glossary-children{ padding-left: 1em; }
span.glsshowtargetfonttext {font-family: monospace; font-size: x-small; border-style: none; }
dfn { font-style: normal; font-weight: bold; } a { text-decoration: none; } a:hover { text-decoration: underline; } div.tablefns { border-top: solid; } div.example { border-bottom: solid silver; padding: 20px; } div.example div.title { font-weight: bold; font-size: large; }
div.sidenote {font-size: x-small; float: right; border-style: none; }
@@ -300,24 +306,23 @@
</head>
<body>
<div id="main">
- <header><div class="title">User Manual for glossaries.sty v4.50</div><!-- end of title --><div class="author">Nicola L.C. Talbot<br>
-
-<a href="http://www.dickimaw-books.com/contact">dickimaw-books.com/contact</a></div><!-- end of author --><div class="date">2022-10-14</div><!-- end of date --></header><p>
+ <header><div class="title">User Manual for glossaries.sty v4.51</div><!-- end of title --><div class="author">Nicola L.C. Talbot<br>
+<a href="http://www.dickimaw-books.com/contact">dickimaw-books.com/contact</a></div><!-- end of author --><div class="date">2022-11-02</div><!-- end of date --></header><p>
<p>
<div class="abstract"><div class="abstractheader">Abstract</div><!-- end of abstractheader -->
- The <a id="wrglossary.1"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides a means to define terms or <a id="wrglossary.2"></a><a href="#glo:idx.acronym">acronyms</a> or symbols that can be referenced within your document. Sorted lists with collated <a id="wrglossary.3"></a><a href="#glo:@@glslabel at entrylocation">locations</a> can be generated either using TeX or using a supplementary <a id="wrglossary.4"></a><a href="#glo:dual.indexingapp">indexing application</a>. Sample documents are provided with the <a id="wrglossary.5"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. These are listed in §<a href="#sec:samples">18</a>. </div><!-- end of abstract -->
+ The <a id="wrglossary.1"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package provides a means to define terms or <a id="wrglossary.2"></a><a href="#glo:idx.acronym">acronyms</a> or symbols that can be referenced within your document. Sorted lists with collated <a id="wrglossary.3"></a><a href="#glo:@@glslabel at entrylocation">locations</a> can be generated either using TeX or using a supplementary <a id="wrglossary.4"></a><a href="#glo:dual.indexingapp">indexing application</a>. Sample documents are provided with the <a id="wrglossary.5"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. These are listed in §<a href="#sec:samples">18</a>. </div><!-- end of abstract -->
<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.6"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
Additional features not provided here may be available through the extension package <a id="wrglossary.7"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> which, if required, needs to be installed separately. New features will be added to <a id="wrglossary.8"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. Versions of the <a id="wrglossary.9"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package after v4.21 will mostly be just bug fixes or minor maintenance. The most significant update to the <a id="wrglossary.10"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package since then is version 4.50, which involved the integration of <a id="wrglossary.11"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08 and the phasing out the use of the now deprecated <a id="wrglossary.12"></a><a href="#glo:pkg.textcase"><span class="styfmt">textcase</span></a> package.<p>
-Note that <a id="wrglossary.13"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> provides an extra indexing option (<a id="wrglossary.14"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) which isn’t available with just the base <a id="wrglossary.15"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. </div><!-- end of information -->
+Note that <a id="wrglossary.13"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> provides an extra indexing option (<a id="wrglossary.14"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) which isn’t available with just the base <a id="wrglossary.15"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. </div><!-- end of information -->
<p>
-If you require multilingual support you must also install the relevant language module. Each language module is called <a id="wrglossary.16"></a><a href="#glo:file.glossaries-language"><span class="filefmt">glossaries-</span><span class="meta">〈<em class="metainner">language</em>〉</span><span class="filefmt"></span></a>, where <span class="meta">〈<em class="metainner">language</em>〉</span> is the root language name. For example, <a id="wrglossary.17"></a><a href="#glo:file.glossaries-french"><span class="filefmt">glossaries-french</span></a> or <a id="wrglossary.18"></a><a href="#glo:file.glossaries-german"><span class="filefmt">glossaries-german</span></a>. If a language module is required, the <a id="wrglossary.19"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will automatically try to load it and will give a warning if the module isn’t found. See §<a href="#sec:languages">1.5</a> for further details. If there isn’t any support available for your language, use the <a id="wrglossary.20"></a><a href="#glo:opt.nolangwarn"><span class="styoptfmt">nolangwarn</span></a> package option to suppress the warning and provide your own translations. (For example, use the <a id="wrglossary.21"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key in <a id="wrglossary.22"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>.)<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.23"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Documents have wide-ranging styles when it comes to presenting <a id="wrglossary.24"></a><a href="#glo:dual.glossary">glossaries</a> or lists of terms or notation. People have their own preferences and to a large extent this is determined by the kind of information that needs to go in the <a id="wrglossary.25"></a><a href="#glo:dual.glossary">glossary</a>. They may just have symbols with terse descriptions or they may have long technical words with complicated descriptions. The <a id="wrglossary.26"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is flexible enough to accommodate such varied requirements, but this flexibility comes at a price: a big manual.<p>
-1f631 If you’re freaking out at the size of this manual, start with <a href="glossariesbegin.html"><span class="qt">“The <span class="styfmt">glossaries</span> package: a guide for beginners”</span></a>. You should find it in the same directory as this document or try <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.27"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> glossariesbegin</pre> Once you’ve got to grips with the basics, then come back to this manual to find out how to adjust the settings. </div><!-- end of important -->
+If you require multilingual support you must also install the relevant language module. Each language module is called <a id="wrglossary.16"></a><a href="#glo:file.glossaries-language"><span class="filefmt">glossaries-</span><span class="meta">〈<em class="metainner">language</em>〉</span><span class="filefmt"></span></a>, where <span class="meta">〈<em class="metainner">language</em>〉</span> is the root language name. For example, <a id="wrglossary.17"></a><a href="#glo:file.glossaries-french"><span class="filefmt">glossaries-french</span></a> or <a id="wrglossary.18"></a><a href="#glo:file.glossaries-german"><span class="filefmt">glossaries-german</span></a>. If a language module is required, the <a id="wrglossary.19"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will automatically try to load it and will give a warning if the module isn’t found. See §<a href="#sec:languages">1.5</a> for further details. If there isn’t any support available for your language, use the <a id="wrglossary.20"></a><a href="#glo:opt.nolangwarn"><span class="styoptfmt">nolangwarn</span></a> package option to suppress the warning and provide your own translations. (For example, use the <a id="wrglossary.21"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key in <a id="wrglossary.22"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Documents have wide-ranging styles when it comes to presenting <a id="wrglossary.23"></a><a href="#glo:dual.glossary">glossaries</a> or lists of terms or notation. People have their own preferences and to a large extent this is determined by the kind of information that needs to go in the <a id="wrglossary.24"></a><a href="#glo:dual.glossary">glossary</a>. They may just have symbols with terse descriptions or they may have long technical words with complicated descriptions. The <a id="wrglossary.25"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is flexible enough to accommodate such varied requirements, but this flexibility comes at a price: a big manual.<p>
+1f631 If you’re freaking out at the size of this manual, start with <a href="glossariesbegin.html"><span class="qt">“The <span class="styfmt">glossaries</span> package: a guide for beginners”</span></a>. You should find it in the same directory as this document or try <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a href="https://www.tug.org/texdoc/">texdoc</a> glossariesbegin</pre> Once you’ve got to grips with the basics, then come back to this manual to find out how to adjust the settings. </div><!-- end of important -->
<p>
-The <a id="wrglossary.28"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> bundle includes the following documentation:
+The <a id="wrglossary.26"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> bundle includes the following documentation:
<dl>
<dt><a href="glossariesbegin.html">The <span class="styfmt">glossaries</span> package: a guide for beginners</a></dt>
@@ -326,12 +331,12 @@
<dt>User Manual for glossaries.sty (<span class="filefmt">glossaries-user.pdf)</span></dt>
<p>
-<dd> This document is the main user guide for the <a id="wrglossary.29"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. </dd>
+<dd> This document is the main user guide for the <a id="wrglossary.27"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. </dd>
<p>
<dt>Documented Code for glossaries (<a href="glossaries-code.pdf">glossaries-code.pdf</a>)</dt>
<p>
-<dd> Advanced users wishing to know more about the inner workings of all the packages provided in the <span class="styfmt">glossaries</span> bundle should read <span class="qt">“Documented Code for glossaries v4.50”</span>. </dd>
+<dd> Advanced users wishing to know more about the inner workings of all the packages provided in the <span class="styfmt">glossaries</span> bundle should read <span class="qt">“Documented Code for glossaries v4.51”</span>. </dd>
<p>
<dt><a href="CHANGES">CHANGES</a></dt>
@@ -345,25 +350,25 @@
<dt><a href="Depends.txt">Depends.txt</a></dt>
<p>
-<dd> List of all packages unconditionally required by <a id="wrglossary.30"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. Other unlisted packages may be required under certain circumstances. For help on installing packages see, for example, <a href="https://tex.stackexchange.com/questions/55437">How do I update my TeX distribution?</a> or (for Linux users) <a href="https://tex.stackexchange.com/questions/14925">Updating TeX on Linux</a>. </dd>
+<dd> List of all packages unconditionally required by <a id="wrglossary.28"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. Other unlisted packages may be required under certain circumstances. For help on installing packages see, for example, <a href="https://tex.stackexchange.com/questions/55437">How do I update my TeX distribution?</a> or (for Linux users) <a href="https://tex.stackexchange.com/questions/14925">Updating TeX on Linux</a>. </dd>
<p>
</dl>
Related resources:
<ul class="displaylist">
- <li><span class="bulletitem">•</span><a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a>.<p>
-<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/faqs/glossariesfaq.html"><span class="styfmt">glossaries</span> FAQ</a><p>
-<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/gallery/#glossaries"><span class="styfmt">glossaries</span> gallery</a><p>
-<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/gallery/glossaries-styles/">a summary of all glossary styles provided by <span class="styfmt">glossaries</span> and <span class="styfmt">glossaries-extra</span></a><p>
-<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/gallery/glossaries-performance.shtml"><span class="styfmt">glossaries</span> performance</a> (comparing document build times for the different options provided by <span class="styfmt">glossaries</span> and <span class="styfmt">glossaries-extra</span>).<p>
-<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/latex/thesis/">Using LaTeX to Write a PhD Thesis</a> (chapter 6).<p>
-<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/latex/buildglossaries/">Incorporating <span class="appfmt">makeglossaries</span> or <span class="appfmt">makeglossaries-lite</span> or <span class="appfmt">bib2gls</span> into the document build</a><p>
-<li><span class="bulletitem">•</span>The <a href="https://ctan.org/pkg/glossaries-extra"><span class="styfmt">glossaries-extra</span> package</a><p>
-<li><span class="bulletitem">•</span><a href="https://ctan.org/pkg/bib2gls"><span class="appfmt">bib2gls</span></a>
+ <li><span class="bulletitem">•</span><a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a>.<p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/faqs.php?category=glossaries"><span class="styfmt">glossaries</span> FAQ</a><p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/gallery/#glossaries"><span class="styfmt">glossaries</span> gallery</a><p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/gallery/glossaries-styles/">a summary of all glossary styles provided by <span class="styfmt">glossaries</span> and <span class="styfmt">glossaries-extra</span></a><p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/gallery/glossaries-performance.shtml"><span class="styfmt">glossaries</span> performance</a> (comparing document build times for the different options provided by <span class="styfmt">glossaries</span> and <span class="styfmt">glossaries-extra</span>).<p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/latex/thesis/">Using LaTeX to Write a PhD Thesis</a> (chapter 6).<p>
+<li><span class="bulletitem">•</span><a href="https://www.dickimaw-books.com/latex/buildglossaries/">Incorporating <span class="appfmt">makeglossaries</span> or <span class="appfmt">makeglossaries-lite</span> or <span class="appfmt">bib2gls</span> into the document build</a><p>
+<li><span class="bulletitem">•</span>The <a href="https://ctan.org/pkg/glossaries-extra"><span class="styfmt">glossaries-extra</span> package</a><p>
+<li><span class="bulletitem">•</span><a href="https://ctan.org/pkg/bib2gls"><span class="appfmt">bib2gls</span></a>
</ul>
<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.31"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-If you use <a id="wrglossary.32"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> and <a id="wrglossary.33"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, you must load <a id="wrglossary.34"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> <span style="font-style: italic; font-variant: normal; ">first</span> (although, in general, <a id="wrglossary.35"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> should be loaded after other packages). </div><!-- end of important -->
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you use <a id="wrglossary.29"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> and <a id="wrglossary.30"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, you must load <a id="wrglossary.31"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> <span style="font-style: italic; font-variant: normal; ">first</span> (although, in general, <a id="wrglossary.32"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> should be loaded after other packages). </div><!-- end of important -->
<p>
<nav class="toc">
<section id="toc"><!-- start of section toc --><div class="tomain"><a href="#main">[top]</a></div>
@@ -386,17 +391,17 @@
<li class="toc-section"><a href="#sec:indexingoptions"><span class="numberline">1.3</span>Indexing Options</a></li><!-- end of toc-section -->
<ul>
-<li class="toc-subsection"><a href="#wrglossary.285"><span class="numberline">1.3.1</span>Option 1 (<span class="qt">“noidx”</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.269"><span class="numberline">1.3.1</span>Option 1 (<span class="qt">“noidx”</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.386"><span class="numberline">1.3.2</span>Option 2 (<span class="appfmt">makeindex</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.363"><span class="numberline">1.3.2</span>Option 2 (<span class="appfmt">makeindex</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.527"><span class="numberline">1.3.3</span>Option 3 (<span class="appfmt">xindy</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.492"><span class="numberline">1.3.3</span>Option 3 (<span class="appfmt">xindy</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.670"><span class="numberline">1.3.4</span>Option 4 (<span class="appfmt">bib2gls</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.625"><span class="numberline">1.3.4</span>Option 4 (<span class="appfmt">bib2gls</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.787"><span class="numberline">1.3.5</span>Option 5 (<span class="qt">“unsrt”</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.725"><span class="numberline">1.3.5</span>Option 5 (<span class="qt">“unsrt”</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.848"><span class="numberline">1.3.6</span>Option 6 (<span class="qt">“standalone”</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.780"><span class="numberline">1.3.6</span>Option 6 (<span class="qt">“standalone”</span>)</a></li><!-- end of toc-subsection -->
</ul>
<li class="toc-section"><a href="#sec:lipsum"><span class="numberline">1.4</span>Dummy Entries for Testing</a></li><!-- end of toc-section -->
@@ -548,7 +553,7 @@
<li class="toc-chapter"><a href="#sec:printglossary"><span class="numberline">8</span>Displaying a Glossary</a></li><!-- end of toc-chapter -->
<ul>
-<li class="toc-section"><a href="#sec:printglossoptions"><span class="numberline">8.1</span><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> Options</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#sec:printglossoptions"><span class="numberline">8.1</span><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> Options</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:glossmarkup"><span class="numberline">8.2</span>Glossary Markup</a></li><!-- end of toc-section -->
</ul>
@@ -631,7 +636,9 @@
<li class="toc-section"><a href="#sec:conditionals"><span class="numberline">15.4</span>Conditionals</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#sec:fetchset"><span class="numberline">15.5</span>Fetching and Updating the Value of a Field</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#sec:measuring"><span class="numberline">15.5</span>Measuring</a></li><!-- end of toc-section -->
+
+<li class="toc-section"><a href="#sec:fetchset"><span class="numberline">15.6</span>Fetching and Updating the Value of a Field</a></li><!-- end of toc-section -->
</ul>
<li class="toc-chapter"><a href="#sec:prefix"><span class="numberline">16</span>Prefixes or Determiners</a></li><!-- end of toc-chapter -->
@@ -646,7 +653,7 @@
<li class="toc-section"><a href="#sec:glsentryaccess"><span class="numberline">17.4</span>Obtaining the Access Field Values</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#sec:accsuppdevnote"><span class="numberline">17.5</span>Developer’s Note</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#sec:accsuppdevnote"><span class="numberline">17.5</span>Developer’s Note</a></li><!-- end of toc-section -->
</ul>
<li class="toc-chapter"><a href="#sec:samples"><span class="numberline">18</span>Sample Documents</a></li><!-- end of toc-chapter -->
@@ -685,7 +692,7 @@
<li class="toc-chapter"><a href="#idx.glsopt-optionsummary"><span style="font-family: monospace; ">\Gls</span>-Like and <span style="font-family: monospace; ">\Glstext</span>-Like Options Summary</a></li><!-- end of toc-chapter -->
-<li class="toc-chapter"><a href="#idx.printglossopt-optionsummary"><span style="font-family: monospace; ">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</span> Options Summary</a></li><!-- end of toc-chapter -->
+<li class="toc-chapter"><a href="#idx.printglossopt-optionsummary"><span style="font-family: monospace; ">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</span> Options Summary</a></li><!-- end of toc-chapter -->
<li class="toc-chapter"><a href="#idx.acronymstyle-optionsummary">Acronym Style Summary</a></li><!-- end of toc-chapter -->
@@ -800,7 +807,7 @@
<div class="toc-example"><a href="#ex:addstoragekey2"><span class="numberline">13</span>Defining Custom Storage Key (Acronyms and Non-Acronyms with Descriptions)</a></div><!-- end of toc-example -->
-<div class="toc-example"><a href="#ex:hierarchical"><span class="numberline">14</span>Hierarchical Divisions — Greek and Roman Mathematical Symbols</a></div><!-- end of toc-example -->
+<div class="toc-example"><a href="#ex:hierarchical"><span class="numberline">14</span>Hierarchical Divisions — Greek and Roman Mathematical Symbols</a></div><!-- end of toc-example -->
<div class="toc-example"><a href="#ex:loadgls"><span class="numberline">15</span>Loading Entries from Another File</a></div><!-- end of toc-example -->
@@ -832,7 +839,7 @@
<div class="toc-example"><a href="#ex:dotabbr"><span class="numberline">29</span>Abbreviations with Full Stops (Periods)</a></div><!-- end of toc-example -->
-<div class="toc-example"><a href="#sec:entrycount"><span class="numberline">30</span>Don’t index entries that are only used once</a></div><!-- end of toc-example -->
+<div class="toc-example"><a href="#sec:entrycount"><span class="numberline">30</span>Don’t index entries that are only used once</a></div><!-- end of toc-example -->
<div class="toc-example"><a href="#ex:twocolumn"><span class="numberline">31</span>Switch to Two Column Mode for Glossary</a></div><!-- end of toc-example -->
@@ -844,7 +851,7 @@
<div class="toc-example"><a href="#sec:exadaptstyle"><span class="numberline">35</span>Creating a new glossary style based on an existing style</a></div><!-- end of toc-example -->
-<div class="toc-example"><a href="#sec:exuserstyle"><span class="numberline">36</span>Example: creating a glossary style that uses the <span class="csoptfmt">user1</span>, …, <span class="csoptfmt">user6</span> keys</a></div><!-- end of toc-example -->
+<div class="toc-example"><a href="#sec:exuserstyle"><span class="numberline">36</span>Example: creating a glossary style that uses the <span class="csoptfmt">user1</span>, …, <span class="csoptfmt">user6</span> keys</a></div><!-- end of toc-example -->
<div class="toc-example"><a href="#ex:hyperbfit"><span class="numberline">37</span>Custom Font for Displaying a Location</a></div><!-- end of toc-example -->
@@ -872,126 +879,126 @@
<section id="sec:intro"><!-- start of section sec:intro --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->1. Introduction<div class="labellink"><a href="#sec:intro">[link]</a></div></h1><!-- end of chapter header -->
<p>
-<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.36"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.37"></a><code class="code"><code class="cmd">\usepackage</code>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<dfn id="glo:pkg.glossaries"><span class="styfmt">glossaries</span></dfn>}</code></div><!-- end of pinnedbox -->
+<div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.33"></a><code class="code"><code class="cmd">\usepackage</code>[<span class="meta">〈<em class="metainner">options</em>〉</span>]{<dfn id="glo:pkg.glossaries"><span class="styfmt">glossaries</span></dfn>}</code></div><!-- end of pinnedbox -->
<p>
-The <a id="wrglossary.38"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is provided to assist generating lists of terms, symbols or <a id="wrglossary.39"></a><a href="#glo:idx.acronym">acronyms</a>. For convenience, these lists are all referred to as <a id="wrglossary.40"></a><a href="#glo:dual.glossary">glossaries</a> in this manual. The terms, symbols and <a id="wrglossary.41"></a><a href="#glo:idx.acronym">acronyms</a> are collectively referred to as <a id="wrglossary.42"></a><dfn id="glo:idx.glossaryentry">glossary entries</dfn>.<p>
-The package has a certain amount of flexibility, allowing the user to customize the format of the <a id="wrglossary.43"></a><a href="#glo:dual.glossary">glossary</a> and define multiple <a id="wrglossary.44"></a><a href="#glo:dual.glossary">glossaries</a>. It also supports <a id="wrglossary.45"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that include an associated symbol (in addition to a name and description) for each <a id="wrglossary.46"></a><a href="#glo:idx.glossaryentry">glossary entry</a>.<p>
-There is provision for loading a database of glossary entries. Only those entries <a id="wrglossary.47"></a><a href="#glo:@@glslabel at indexing">indexed</a> in the document will be displayed in the <a id="wrglossary.48"></a><a href="#glo:dual.glossary">glossary</a>. (Unless you use <a id="wrglossary.49"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, which doesn’t use any <a id="wrglossary.50"></a><a href="#glo:dual.indexing">indexing</a> but will instead list all defined entries in order of definition.)<p>
-It’s not necessary to actually have a <a id="wrglossary.51"></a><a href="#glo:dual.glossary">glossary</a> in the document. You may be interested in using this package just as means to consistently format certain types of terms, such as <a id="wrglossary.52"></a><a href="#glo:idx.acronym">acronyms</a>, or you may prefer to have descriptions scattered about the document and be able to easily link to the relevant description (<a id="wrglossary.53"></a><a href="#glo:idx.opt.standalone">Option 6</a>).<p>
-The simplest document is one without a glossary: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.54"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+The <a id="wrglossary.34"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is provided to assist generating lists of terms, symbols or <a id="wrglossary.35"></a><a href="#glo:idx.acronym">acronyms</a>. For convenience, these lists are all referred to as <a id="wrglossary.36"></a><a href="#glo:dual.glossary">glossaries</a> in this manual. The terms, symbols and <a id="wrglossary.37"></a><a href="#glo:idx.acronym">acronyms</a> are collectively referred to as <a id="wrglossary.38"></a><dfn id="glo:idx.glossaryentry">glossary entries</dfn>.<p>
+The package has a certain amount of flexibility, allowing the user to customize the format of the <a id="wrglossary.39"></a><a href="#glo:dual.glossary">glossary</a> and define multiple <a id="wrglossary.40"></a><a href="#glo:dual.glossary">glossaries</a>. It also supports <a id="wrglossary.41"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that include an associated symbol (in addition to a name and description) for each <a id="wrglossary.42"></a><a href="#glo:idx.glossaryentry">glossary entry</a>.<p>
+There is provision for loading a database of glossary entries. Only those entries <a id="wrglossary.43"></a><a href="#glo:@@glslabel at indexing">indexed</a> in the document will be displayed in the <a id="wrglossary.44"></a><a href="#glo:dual.glossary">glossary</a>. (Unless you use <a id="wrglossary.45"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, which doesn’t use any <a id="wrglossary.46"></a><a href="#glo:dual.indexing">indexing</a> but will instead list all defined entries in order of definition.)<p>
+It’s not necessary to actually have a <a id="wrglossary.47"></a><a href="#glo:dual.glossary">glossary</a> in the document. You may be interested in using this package just as means to consistently format certain types of terms, such as <a id="wrglossary.48"></a><a href="#glo:idx.acronym">acronyms</a>, or you may prefer to have descriptions scattered about the document and be able to easily link to the relevant description (<a id="wrglossary.49"></a><a href="#glo:idx.opt.standalone">Option 6</a>).<p>
+The simplest document is one without a glossary: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[
- <a id="wrglossary.55"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.56"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> <span class="comment">% no sorting or <a id="wrglossary.57"></a><a href="#glo:dual.indexing">indexing</a> required</span>
+ <a id="wrglossary.50"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.51"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> <span class="comment">% no sorting or <a id="wrglossary.52"></a><a href="#glo:dual.indexing">indexing</a> required</span>
]
{glossaries}
-<a id="wrglossary.58"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
+<a id="wrglossary.53"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
{cafe}<span class="comment">% label</span>
{<span class="comment">% definition:</span>
- <a id="wrglossary.59"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={café}</span>,
- <a id="wrglossary.60"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={small restaurant selling refreshments}</span>
+ <a id="wrglossary.54"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={café}</span>,
+ <a id="wrglossary.55"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={small restaurant selling refreshments}</span>
}
-<a id="wrglossary.61"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.62"></a><a href="#glo:opt.acrstyle.long-short"><span class="acrstylefmt">long-short</span></a>}
-<a id="wrglossary.63"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>
+<a id="wrglossary.56"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.57"></a><a href="#glo:opt.acrstyle.long-short"><span class="acrstylefmt">long-short</span></a>}
+<a id="wrglossary.58"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>
{html}<span class="comment">% label</span>
{HTML}<span class="comment">% short form</span>
{hypertext markup language}<span class="comment">% long form</span>
-<a id="wrglossary.64"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
+<a id="wrglossary.59"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
{pi}<span class="comment">% label</span>
{<span class="comment">% definition:</span>
- <a id="wrglossary.65"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.66"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\pi</code>}}</span>,
- <a id="wrglossary.67"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Archimedes' Constant}</span>
+ <a id="wrglossary.60"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.61"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\pi</code>}}</span>,
+ <a id="wrglossary.62"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Archimedes' Constant}</span>
}
-<a id="wrglossary.68"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
+<a id="wrglossary.63"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
{distance}<span class="comment">% label</span>
{<span class="comment">% definition:</span>
- <a id="wrglossary.69"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={distance}</span>,
- <a id="wrglossary.70"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={the length between two points}</span>,
- <a id="wrglossary.71"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={m}</span>
+ <a id="wrglossary.64"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={distance}</span>,
+ <a id="wrglossary.65"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={the length between two points}</span>,
+ <a id="wrglossary.66"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={m}</span>
}
<code class="cbeg">\begin{document}</code>
-First use: <a id="wrglossary.72"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.73"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.74"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
-Next use: <a id="wrglossary.75"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.76"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.77"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+First use: <a id="wrglossary.67"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.68"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.69"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+Next use: <a id="wrglossary.70"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.71"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.72"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
-<a id="wrglossary.78"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{distance} (<a id="wrglossary.79"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{distance}) is measured in
-<a id="wrglossary.80"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{distance}.
+<a id="wrglossary.73"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{distance} (<a id="wrglossary.74"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{distance}) is measured in
+<a id="wrglossary.75"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{distance}.
<code class="cend">\end{document}</code>
-</pre> (This is a trivial example. For a real document I recommend you use <a id="wrglossary.81"></a><a href="#glo:pkg.siunitx"><span class="styfmt">siunitx</span></a> for units.) <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.82"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:simplenogloss"></a>Example 1: Simple document with no glossary <a href="glossaries-user-examples/glossaries-user-example001.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example001.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+</pre> (This is a trivial example. For a real document I recommend you use <a id="wrglossary.76"></a><a href="#glo:pkg.siunitx"><span class="styfmt">siunitx</span></a> for units.) <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:simplenogloss"></a>Example 1: Simple document with no glossary <a href="glossaries-user-examples/glossaries-user-example001.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example001.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
<object data="glossaries-user-examples/glossaries-user-example001.png" type="image/png" width="388" height="42">Example document that defines some glossary entries and references them in the text..</object> </div><!-- end of resultbox -->
<p>
-<div class="sidenote"><a id="wrglossary.83"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-The <a id="wrglossary.84"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package, which is distributed as a separate bundle, extends the capabilities of the <a id="wrglossary.85"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. The simplest document with a <a id="wrglossary.86"></a><a href="#glo:dual.glossary">glossary</a> can be created with <a id="wrglossary.87"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> (which internally loads the <a id="wrglossary.88"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.89"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<div class="sidenote"><a id="wrglossary.77"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+The <a id="wrglossary.78"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package, which is distributed as a separate bundle, extends the capabilities of the <a id="wrglossary.79"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. The simplest document with a <a id="wrglossary.80"></a><a href="#glo:dual.glossary">glossary</a> can be created with <a id="wrglossary.81"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> (which internally loads the <a id="wrglossary.82"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[
- <a id="wrglossary.90"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span>,<span class="comment">% no sorting or indexing required</span>
- <a id="wrglossary.91"></a><a href="#glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></a>,<span class="comment">% create list of <a id="wrglossary.92"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a></span>
- <a id="wrglossary.93"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,<span class="comment">% create list of symbols</span>
- <a id="wrglossary.94"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a>, <span class="comment">% append a full stop after the descriptions</span>
- <a id="wrglossary.95"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a>,<a id="wrglossary.96"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=index</span> <span class="comment">% set the default glossary style</span>
+ <a id="wrglossary.83"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span>,<span class="comment">% no sorting or indexing required</span>
+ <a id="wrglossary.84"></a><a href="#glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></a>,<span class="comment">% create list of <a id="wrglossary.85"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a></span>
+ <a id="wrglossary.86"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,<span class="comment">% create list of symbols</span>
+ <a id="wrglossary.87"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a>, <span class="comment">% append a full stop after the descriptions</span>
+ <a id="wrglossary.88"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a>,<a id="wrglossary.89"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=index</span> <span class="comment">% set the default glossary style</span>
]{glossaries-extra}
-<a id="wrglossary.97"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> <span class="comment">% <a id="wrglossary.98"></a><a href="#glo:pkg.glossaries-extra">glossaries.sty</a></span> {cafe}<span class="comment">% label</span>
+<a id="wrglossary.90"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> <span class="comment">% <a id="wrglossary.91"></a><a href="#glo:pkg.glossaries-extra">glossaries.sty</a></span> {cafe}<span class="comment">% label</span>
{<span class="comment">% definition:</span>
- <a id="wrglossary.99"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={café}</span>,
- <a id="wrglossary.100"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={small restaurant selling refreshments}</span>
+ <a id="wrglossary.92"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={café}</span>,
+ <a id="wrglossary.93"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={small restaurant selling refreshments}</span>
}
-<a id="wrglossary.101"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.102"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}<span class="comment">% <a id="wrglossary.103"></a><a href="#glo:pkg.glossaries-extra">glossaries-extra.sty</a></span>
-<a id="wrglossary.104"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> <span class="comment">% <a id="wrglossary.105"></a><a href="#glo:pkg.glossaries-extra">glossaries-extra.sty</a></span> {html}<span class="comment">% label</span>
+<a id="wrglossary.94"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.95"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}<span class="comment">% <a id="wrglossary.96"></a><a href="#glo:pkg.glossaries-extra">glossaries-extra.sty</a></span>
+<a id="wrglossary.97"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> <span class="comment">% <a id="wrglossary.98"></a><a href="#glo:pkg.glossaries-extra">glossaries-extra.sty</a></span> {html}<span class="comment">% label</span>
{HTML}<span class="comment">% short form</span>
{hypertext markup language}<span class="comment">% long form</span>
-<span class="comment">% requires <a id="wrglossary.106"></a><a href="#glo:pkg.glossaries-extra">glossaries-extra.sty</a> '<a id="wrglossary.107"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>' option</span>
-<a id="wrglossary.108"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>
- [<a id="wrglossary.109"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Archimedes' constant}</span>]<span class="comment">% options</span>
+<span class="comment">% requires <a id="wrglossary.99"></a><a href="#glo:pkg.glossaries-extra">glossaries-extra.sty</a> '<a id="wrglossary.100"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>' option</span>
+<a id="wrglossary.101"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>
+ [<a id="wrglossary.102"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Archimedes' constant}</span>]<span class="comment">% options</span>
{pi}<span class="comment">% label</span>
- {<a id="wrglossary.110"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\pi</code>}}<span class="comment">% symbol</span>
+ {<a id="wrglossary.103"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\pi</code>}}<span class="comment">% symbol</span>
-<a id="wrglossary.111"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> <span class="comment">% <a id="wrglossary.112"></a><a href="#glo:pkg.glossaries-extra">glossaries.sty</a></span> {distance}<span class="comment">% label</span>
+<a id="wrglossary.104"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> <span class="comment">% <a id="wrglossary.105"></a><a href="#glo:pkg.glossaries-extra">glossaries.sty</a></span> {distance}<span class="comment">% label</span>
{<span class="comment">% definition:</span>
- <a id="wrglossary.113"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={distance}</span>,
- <a id="wrglossary.114"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={the length between two points}</span>,
- <a id="wrglossary.115"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={m}</span>
+ <a id="wrglossary.106"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={distance}</span>,
+ <a id="wrglossary.107"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={the length between two points}</span>,
+ <a id="wrglossary.108"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={m}</span>
}
<code class="cbeg">\begin{document}</code>
-First use: <a id="wrglossary.116"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.117"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.118"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
-Next use: <a id="wrglossary.119"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.120"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.121"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+First use: <a id="wrglossary.109"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.110"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.111"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
+Next use: <a id="wrglossary.112"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{cafe}, <a id="wrglossary.113"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{html}, <a id="wrglossary.114"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{pi}.
-<a id="wrglossary.122"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{distance} is measured in <a id="wrglossary.123"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{distance}.
-<a id="wrglossary.124"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a> <span class="comment">% list all defined entries</span>
+<a id="wrglossary.115"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{distance} is measured in <a id="wrglossary.116"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>{distance}.
+<a id="wrglossary.117"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a> <span class="comment">% list all defined entries</span>
<code class="cend">\end{document}</code>
</pre><p>
-<div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.125"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:simpleunsrt"></a>Example 2: Simple document with unsorted glossaries <a href="glossaries-user-examples/glossaries-user-example002.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example002.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:simpleunsrt"></a>Example 2: Simple document with unsorted glossaries <a href="glossaries-user-examples/glossaries-user-example002.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example002.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
<object data="glossaries-user-examples/glossaries-user-example002.png" type="image/png" width="388" height="265">Example document that defines some glossary entries, references them in the text, and displays three simple unsorted glossaries..</object> </div><!-- end of resultbox -->
<p>
-Note the difference in the way the <a id="wrglossary.126"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a> (HTML) and symbol (\(𝜋\)) are defined in the two above examples. The <a id="wrglossary.127"></a><a href="#glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></a>, <a id="wrglossary.128"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a> and <a id="wrglossary.129"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> options are specific to <a id="wrglossary.130"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. Other options are passed to the base <a id="wrglossary.131"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.132"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- In this user manual, commands and options displayed in <span class="xtrfmt">tan</span>, such as <a id="wrglossary.133"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> and <a id="wrglossary.134"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a>, are only available with the <a id="wrglossary.135"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package. There are also some commands and options (such as <a id="wrglossary.136"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and <a id="wrglossary.137"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>) that are provided by the base <a id="wrglossary.138"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but are redefined by the <a id="wrglossary.139"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package. See the <a id="wrglossary.140"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details of those commands. </div><!-- end of information -->
+Note the difference in the way the <a id="wrglossary.118"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a> (HTML) and symbol (\(𝜋\)) are defined in the two above examples. The <a id="wrglossary.119"></a><a href="#glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></a>, <a id="wrglossary.120"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a> and <a id="wrglossary.121"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> options are specific to <a id="wrglossary.122"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. Other options are passed to the base <a id="wrglossary.123"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.124"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ In this user manual, commands and options displayed in <span class="xtrfmt">tan</span>, such as <a id="wrglossary.125"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> and <a id="wrglossary.126"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a>, are only available with the <a id="wrglossary.127"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package. There are also some commands and options (such as <a id="wrglossary.128"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and <a id="wrglossary.129"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>) that are provided by the base <a id="wrglossary.130"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but are redefined by the <a id="wrglossary.131"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package. See the <a id="wrglossary.132"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details of those commands. </div><!-- end of information -->
<p>
-One of the strengths of the <a id="wrglossary.141"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is its flexibility, however the drawback of this is the necessity of having a large manual that covers all the various settings. If you are daunted by the size of the manual, try starting off with the much shorter <a href="glossariesbegin.html">guide for beginners</a>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.142"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-There’s a common misconception that you have to have Perl installed in order to use the <a id="wrglossary.143"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Perl is <span style="font-style: italic; font-variant: normal; ">not</span> a requirement (as demonstrated by the above examples) but it does increase the available options, particularly if you use an <a id="wrglossary.144"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or a <a id="wrglossary.145"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>. </div><!-- end of important -->
+One of the strengths of the <a id="wrglossary.133"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is its flexibility, however the drawback of this is the necessity of having a large manual that covers all the various settings. If you are daunted by the size of the manual, try starting off with the much shorter <a href="glossariesbegin.html">guide for beginners</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+There’s a common misconception that you have to have Perl installed in order to use the <a id="wrglossary.134"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Perl is <span style="font-style: italic; font-variant: normal; ">not</span> a requirement (as demonstrated by the above examples) but it does increase the available options, particularly if you use an <a id="wrglossary.135"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or a <a id="wrglossary.136"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>. </div><!-- end of important -->
<p>
-This document uses the <a id="wrglossary.146"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package with <a id="wrglossary.147"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (<a id="wrglossary.148"></a><a href="#glo:idx.opt.b2g">Option 4</a>). For example, when viewing the <a id="wrglossary.149"></a><a href="#glo:PDF">PDF</a> version of this document in a <a id="wrglossary.150"></a><a href="#glo:@@glslabel at hyperlink">hyperlinked-enabled</a> <a id="wrglossary.151"></a><a href="#glo:PDF">PDF</a> viewer (such as Adobe Reader or Okular) if you click on the word <span class="qt">“<a id="wrglossary.152"></a><a href="#glo:dual.indexing">indexing</a>”</span> you’ll be taken to the <a id="wrglossary.153"></a><a href="#glo:idx.glossaryentry">entry</a> in the <a href="#glossary">main glossary</a> where there’s a brief description of the term. This is the way the <a id="wrglossary.154"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> mechanism works. An <a id="wrglossary.155"></a><a href="#glo:dual.indexingapp">indexing application</a> (<a id="wrglossary.156"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> in this case) is used to generate the sorted list of terms. The <a id="wrglossary.157"></a><a href="#glo:dual.indexingapp">indexing applications</a> are <a id="wrglossary.158"></a><a href="#glo:cli">CLI</a> tools, which means they can be run directly from a command prompt or terminal, or can be integrated into some text editors, or you can use a build tool such as <a id="wrglossary.159"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> to run them.<p>
-In addition to standard <a id="wrglossary.160"></a><a href="#glo:dual.glossary">glossaries</a>, this document has <span class="qt">“standalone”</span> definitions (<a id="wrglossary.161"></a><a href="#glo:idx.opt.standalone">Option 6</a>). For example, if you click on the command <a id="wrglossary.162"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, the <a id="wrglossary.163"></a><a href="#glo:idx.hyperlink">hyperlink</a> will take you to main part of the document where the command is described. The <a href="#index">index</a> and <a href="#summaries">summaries</a> are also glossaries. The technique used is too complicated to describe in this manual, but an example can be found in <a href="https://tug.org/TUGboat/tb2022-1/tb133talbot-bib2gls-reorder.pdf"><span class="qt">“<span class="appfmt">bib2gls</span>: Standalone entries and repeated lists (a little book of poisons)”</span> <span style="font-style: italic; font-variant: normal; ">TUGboat</span>, Volume 43 (2022), No. 1</a>.<p>
-Neither of the above two examples require an <a id="wrglossary.164"></a><a href="#glo:dual.indexingapp">indexing application</a>. The first is just using the <a id="wrglossary.165"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for consistent formatting, and there is no list. The second has lists but they are unsorted (see <a id="wrglossary.166"></a><a href="#glo:idx.opt.unsrt">Option 5</a>).<p>
+This document uses the <a id="wrglossary.137"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package with <a id="wrglossary.138"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (<a id="wrglossary.139"></a><a href="#glo:idx.opt.b2g">Option 4</a>). For example, when viewing the <a id="wrglossary.140"></a><a href="#glo:PDF">PDF</a> version of this document in a <a id="wrglossary.141"></a><a href="#glo:@@glslabel at hyperlink">hyperlinked-enabled</a> <a id="wrglossary.142"></a><a href="#glo:PDF">PDF</a> viewer (such as Adobe Reader or Okular) if you click on the word <span class="qt">“<a id="wrglossary.143"></a><a href="#glo:dual.indexing">indexing</a>”</span> you’ll be taken to the <a id="wrglossary.144"></a><a href="#glo:idx.glossaryentry">entry</a> in the <a href="#glossary">main glossary</a> where there’s a brief description of the term. This is the way the <a id="wrglossary.145"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> mechanism works. An <a id="wrglossary.146"></a><a href="#glo:dual.indexingapp">indexing application</a> (<a id="wrglossary.147"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> in this case) is used to generate the sorted list of terms. The <a id="wrglossary.148"></a><a href="#glo:dual.indexingapp">indexing applications</a> are <a id="wrglossary.149"></a><a href="#glo:cli">CLI</a> tools, which means they can be run directly from a command prompt or terminal, or can be integrated into some text editors, or you can use a build tool such as <a id="wrglossary.150"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> to run them.<p>
+In addition to standard <a id="wrglossary.151"></a><a href="#glo:dual.glossary">glossaries</a>, this document has <span class="qt">“standalone”</span> definitions (<a id="wrglossary.152"></a><a href="#glo:idx.opt.standalone">Option 6</a>). For example, if you click on the command <a id="wrglossary.153"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, the <a id="wrglossary.154"></a><a href="#glo:idx.hyperlink">hyperlink</a> will take you to main part of the document where the command is described. The <a href="#index">index</a> and <a href="#summaries">summaries</a> are also glossaries. The technique used is too complicated to describe in this manual, but an example can be found in <a href="https://tug.org/TUGboat/tb2022-1/tb133talbot-bib2gls-reorder.pdf"><span class="qt">“<span class="appfmt">bib2gls</span>: Standalone entries and repeated lists (a little book of poisons)”</span> <span style="font-style: italic; font-variant: normal; ">TUGboat</span>, Volume 43 (2022), No. 1</a>.<p>
+Neither of the above two examples require an <a id="wrglossary.155"></a><a href="#glo:dual.indexingapp">indexing application</a>. The first is just using the <a id="wrglossary.156"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for consistent formatting, and there is no list. The second has lists but they are unsorted (see <a id="wrglossary.157"></a><a href="#glo:idx.opt.unsrt">Option 5</a>).<p>
The remainder of this introductory section covers the following:
<ul class="displaylist">
- <li><span class="bulletitem">•</span>§<a href="#sec:indexingoptions">1.3</a> lists the available indexing options.<p>
-<li><span class="bulletitem">•</span>§<a href="#sec:lipsum">1.4</a> lists the files provided that contain dummy glossary entries which may be used for testing.<p>
-<li><span class="bulletitem">•</span>§<a href="#sec:languages">1.5</a> provides information for users who wish to write in a language other than English.<p>
-<li><span class="bulletitem">•</span>§<a href="#sec:makeglossaries">1.6</a> describes how to use an <a id="wrglossary.167"></a><a href="#glo:indexingapp">indexing application</a> to create the sorted glossaries for your document (Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>).<p>
+ <li><span class="bulletitem">•</span>§<a href="#sec:indexingoptions">1.3</a> lists the available indexing options.<p>
+<li><span class="bulletitem">•</span>§<a href="#sec:lipsum">1.4</a> lists the files provided that contain dummy glossary entries which may be used for testing.<p>
+<li><span class="bulletitem">•</span>§<a href="#sec:languages">1.5</a> provides information for users who wish to write in a language other than English.<p>
+<li><span class="bulletitem">•</span>§<a href="#sec:makeglossaries">1.6</a> describes how to use an <a id="wrglossary.158"></a><a href="#glo:indexingapp">indexing application</a> to create the sorted glossaries for your document (Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>).<p>
</ul>
<p>
-In addition to the examples provided in this document, there are some sample documents provided with the <a id="wrglossary.168"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. They are described in §<a href="#sec:samples">18</a>.<p>
-The <a id="wrglossary.169"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with a number of sample documents that illustrate the various functions. These are listed in §<a href="#sec:samples">18</a>.<p>
+In addition to the examples provided in this document, there are some sample documents provided with the <a id="wrglossary.159"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. They are described in §<a href="#sec:samples">18</a>.<p>
+The <a id="wrglossary.160"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with a number of sample documents that illustrate the various functions. These are listed in §<a href="#sec:samples">18</a>.<p>
</section><!-- end of section sec:intro -->
@@ -1001,14 +1008,14 @@
The following rollback releases are available: <p>
<ul class="displaylist">
- <li><span class="bulletitem">•</span>Version 4.49 (2021-11-01): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.170"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{glossaries}[=v4.49]
-</pre> Note that this should also rollback <a id="wrglossary.171"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> to version 2.07 if you have a later version installed.<p>
-<li><span class="bulletitem">•</span>Version 4.46 (2020-03-19): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.172"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{glossaries}[=v4.46]
+ <li><span class="bulletitem">•</span>Version 4.49 (2021-11-01): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{glossaries}[=v4.49]
+</pre> Note that this should also rollback <a id="wrglossary.161"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> to version 2.07 if you have a later version installed.<p>
+<li><span class="bulletitem">•</span>Version 4.46 (2020-03-19): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{glossaries}[=v4.46]
</pre><p>
</ul>
<p>
-If you rollback using <a id="wrglossary.173"></a><a href="#glo:pkg.latexrelease"><span class="styfmt">latexrelease</span></a> to an earlier date, then you will need to specify v4.46 for <a id="wrglossary.174"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> as there are no earlier rollback versions available. You may want to consider using one of the historic TeX Live Docker images instead. See, for example, <a href="https://www.dickimaw-books.com/blog/legacy-documents-and-tex-live-docker-images">Legacy Documents and TeX Live Docker Images</a>.<p>
+If you rollback using <a id="wrglossary.162"></a><a href="#glo:pkg.latexrelease"><span class="styfmt">latexrelease</span></a> to an earlier date, then you will need to specify v4.46 for <a id="wrglossary.163"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> as there are no earlier rollback versions available. You may want to consider using one of the historic TeX Live Docker images instead. See, for example, <a href="https://www.dickimaw-books.com/blog/legacy-documents-and-tex-live-docker-images">Legacy Documents and TeX Live Docker Images</a>.<p>
</section><!-- end of section sec:rollback -->
@@ -1015,23 +1022,23 @@
<section id="sec:pkgintegration"><!-- start of section sec:pkgintegration --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.2. Integrating Other Packages and Known Issues<div class="labellink"><a href="#sec:pkgintegration">[link]</a></div></h2><!-- end of section header -->
<p>
-If you use <a id="wrglossary.175"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> and <a id="wrglossary.176"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, you must load <a id="wrglossary.177"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> <span style="font-style: italic; font-variant: normal; ">first</span> (although, in general, <a id="wrglossary.178"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> should be loaded after other packages).<p>
-Occasionally you may find that certain packages need to be loaded <span style="font-style: italic; font-variant: normal; ">after</span> packages that are required by <a id="wrglossary.179"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> but need to also be loaded before <a id="wrglossary.180"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. For example, a package <span class="meta">〈<em class="metainner">X</em>〉</span> might need to be loaded after <a id="wrglossary.181"></a><a href="#glo:pkg.amsgen"><span class="styfmt">amsgen</span></a> but before <a id="wrglossary.182"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> (which needs to be loaded before <a id="wrglossary.183"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>). In which case, load the required package first (for example, <a id="wrglossary.184"></a><a href="#glo:pkg.amsgen"><span class="styfmt">amsgen</span></a>), then <span class="meta">〈<em class="metainner">X</em>〉</span>, and finally load <a id="wrglossary.185"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. <pre class="compactcodebox"><code class="cmd">\usepackage</code>{amsgen}<span class="comment">% load before <span class="meta">〈<em class="metainner">X</em>〉</span></span>
-<code class="cmd">\usepackage</code>{<span class="meta">〈<em class="metainner">X</em>〉</span>}<span class="comment">% must be loaded after <a id="wrglossary.186"></a><a href="#glo:pkg.amsgen"><span class="styfmt">amsgen</span></a></span>
-<code class="cmd">\usepackage</code>{hyperref}<span class="comment">% load after <span class="meta">〈<em class="metainner">X</em>〉</span></span>
-<code class="cmd">\usepackage</code>{glossaries}<span class="comment">% load after <a id="wrglossary.187"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a></span>
+If you use <a id="wrglossary.164"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> and <a id="wrglossary.165"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, you must load <a id="wrglossary.166"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> <span style="font-style: italic; font-variant: normal; ">first</span> (although, in general, <a id="wrglossary.167"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> should be loaded after other packages).<p>
+Occasionally you may find that certain packages need to be loaded <span style="font-style: italic; font-variant: normal; ">after</span> packages that are required by <a id="wrglossary.168"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> but need to also be loaded before <a id="wrglossary.169"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. For example, a package <span class="meta">〈<em class="metainner">X</em>〉</span> might need to be loaded after <a id="wrglossary.170"></a><a href="#glo:pkg.amsgen"><span class="styfmt">amsgen</span></a> but before <a id="wrglossary.171"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> (which needs to be loaded before <a id="wrglossary.172"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>). In which case, load the required package first (for example, <a id="wrglossary.173"></a><a href="#glo:pkg.amsgen"><span class="styfmt">amsgen</span></a>), then <span class="meta">〈<em class="metainner">X</em>〉</span>, and finally load <a id="wrglossary.174"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. <pre class="compactcodebox"><code class="cmd">\usepackage</code>{amsgen}<span class="comment">% load before <span class="meta">〈<em class="metainner">X</em>〉</span></span>
+<code class="cmd">\usepackage</code>{<span class="meta">〈<em class="metainner">X</em>〉</span>}<span class="comment">% must be loaded after <a id="wrglossary.175"></a><a href="#glo:pkg.amsgen"><span class="styfmt">amsgen</span></a></span>
+<code class="cmd">\usepackage</code>{hyperref}<span class="comment">% load after <span class="meta">〈<em class="metainner">X</em>〉</span></span>
+<code class="cmd">\usepackage</code>{glossaries}<span class="comment">% load after <a id="wrglossary.176"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a></span>
</pre><p>
-Some packages don’t work with some <a id="wrglossary.188"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. For example, <a id="wrglossary.189"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> doesn’t work with the styles that use the <a id="wrglossary.190"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment, such as the <a id="wrglossary.191"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style. Since this is the default style, the <a id="wrglossary.192"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package checks for <a id="wrglossary.193"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> and will change the default to the <a id="wrglossary.194"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> style if it has been loaded.<p>
-Some packages conflict with a package that’s required by a <a id="wrglossary.195"></a><a href="#glo:idx.glossarystyle">glossary style</a> style package. For example, <a id="wrglossary.196"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> conflicts with <a id="wrglossary.197"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a>, which is required by <a id="wrglossary.198"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a>. In this case, ensure the problematic <a id="wrglossary.199"></a><a href="#glo:idx.glossarystyle">glossary style</a> package isn’t loaded. For example, use the <a id="wrglossary.200"></a><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a> option and (with <a id="wrglossary.201"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>) don’t use <a id="wrglossary.202"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=super</span> or <a id="wrglossary.203"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=all</span>. The <a id="wrglossary.204"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package now (v4.50+) checks for <a id="wrglossary.205"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> and will automatically implement <a id="wrglossary.206"></a><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a> if it has been loaded.<p>
-The language-support is implemented using <a id="wrglossary.207"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>. This needs to know the document languages that have to be supported. It currently (version 1.6 at the time of writing) can’t detect the use of <a id="wrglossary.208"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>. The <a id="wrglossary.209"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package is able to pick up known language labels from the document class options, for example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.210"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[german]{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.211"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span>]{glossaries}
-</pre> The above doesn’t load <a id="wrglossary.212"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.213"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> or <a id="wrglossary.214"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, but the <a id="wrglossary.215"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span> setting will ensure that <a id="wrglossary.216"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is loaded and the language-sensitive command provided by <a id="wrglossary.217"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will use the definitions in <a id="wrglossary.218"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> (which needs to be installed separately, see §<a href="#sec:languages">1.5</a>) because <a id="wrglossary.219"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can pick up the <span class="optfmt">german</span> document class option.<p>
-The <a id="wrglossary.220"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package is also able to pick up languages passed as package options to <a id="wrglossary.221"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.222"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, provided they were loaded before <a id="wrglossary.223"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>. For example, <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.224"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[french]{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.225"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
-</pre> The <a id="wrglossary.226"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package used to be able to detect languages identified by <a id="wrglossary.227"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span>’s</a> <a id="wrglossary.228"></a><a href="#glo:setmainlanguage"><code class="csfmt">\setmainlanguage</code></a> and <a id="wrglossary.229"></a><a href="#glo:setotherlanguage"><code class="csfmt">\setotherlanguage</code></a>, but <a id="wrglossary.230"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> v1.5 can’t with newer versions of <a id="wrglossary.231"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>. You will need to upgrade to <a id="wrglossary.232"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> v1.6+ to allow this to work again.<p>
-In the event that <a id="wrglossary.233"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t pick up the required languages, it’s also possible to identify them with the <a id="wrglossary.234"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> option. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.235"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[nil]{babel}
-<a id="wrglossary.236"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>{french}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.237"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a><span class="optfmt">=french</span>]{glossaries}
+Some packages don’t work with some <a id="wrglossary.177"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. For example, <a id="wrglossary.178"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> doesn’t work with the styles that use the <a id="wrglossary.179"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment, such as the <a id="wrglossary.180"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style. Since this is the default style, the <a id="wrglossary.181"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package checks for <a id="wrglossary.182"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> and will change the default to the <a id="wrglossary.183"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a> style if it has been loaded.<p>
+Some packages conflict with a package that’s required by a <a id="wrglossary.184"></a><a href="#glo:idx.glossarystyle">glossary style</a> style package. For example, <a id="wrglossary.185"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> conflicts with <a id="wrglossary.186"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a>, which is required by <a id="wrglossary.187"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a>. In this case, ensure the problematic <a id="wrglossary.188"></a><a href="#glo:idx.glossarystyle">glossary style</a> package isn’t loaded. For example, use the <a id="wrglossary.189"></a><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a> option and (with <a id="wrglossary.190"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>) don’t use <a id="wrglossary.191"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=super</span> or <a id="wrglossary.192"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=all</span>. The <a id="wrglossary.193"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package now (v4.50+) checks for <a id="wrglossary.194"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> and will automatically implement <a id="wrglossary.195"></a><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a> if it has been loaded.<p>
+The language-support is implemented using <a id="wrglossary.196"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>. This needs to know the document languages that have to be supported. It currently (version 1.6 at the time of writing) can’t detect the use of <a id="wrglossary.197"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>. The <a id="wrglossary.198"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package is able to pick up known language labels from the document class options, for example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[german]{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.199"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span>]{glossaries}
+</pre> The above doesn’t load <a id="wrglossary.200"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.201"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> or <a id="wrglossary.202"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, but the <a id="wrglossary.203"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span> setting will ensure that <a id="wrglossary.204"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is loaded and the language-sensitive command provided by <a id="wrglossary.205"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will use the definitions in <a id="wrglossary.206"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> (which needs to be installed separately, see §<a href="#sec:languages">1.5</a>) because <a id="wrglossary.207"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can pick up the <span class="optfmt">german</span> document class option.<p>
+The <a id="wrglossary.208"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package is also able to pick up languages passed as package options to <a id="wrglossary.209"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.210"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, provided they were loaded before <a id="wrglossary.211"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>. For example, <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[french]{babel}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.212"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
+</pre> The <a id="wrglossary.213"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package used to be able to detect languages identified by <a id="wrglossary.214"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span>’s</a> <a id="wrglossary.215"></a><a href="#glo:setmainlanguage"><code class="csfmt">\setmainlanguage</code></a> and <a id="wrglossary.216"></a><a href="#glo:setotherlanguage"><code class="csfmt">\setotherlanguage</code></a>, but <a id="wrglossary.217"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> v1.5 can’t with newer versions of <a id="wrglossary.218"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>. You will need to upgrade to <a id="wrglossary.219"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> v1.6+ to allow this to work again.<p>
+In the event that <a id="wrglossary.220"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t pick up the required languages, it’s also possible to identify them with the <a id="wrglossary.221"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> option. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[nil]{babel}
+<a id="wrglossary.222"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>{french}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.223"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a><span class="optfmt">=french</span>]{glossaries}
</pre><p>
</section><!-- end of section sec:pkgintegration -->
@@ -1039,15 +1046,15 @@
<section id="sec:indexingoptions"><!-- start of section sec:indexingoptions --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.3. Indexing Options<div class="labellink"><a href="#sec:indexingoptions">[link]</a></div></h2><!-- end of section header -->
<p>
-<a id="wrglossary.238"></a>The basic idea behind the <a id="wrglossary.239"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is that you first define your <a id="wrglossary.240"></a><a href="#glo:idx.glossaryentry">entries</a> (terms, symbols or <a id="wrglossary.241"></a><a href="#glo:idx.acronym">acronyms</a>). Then you can reference these within your document (analogous to <a id="wrglossary.242"></a><a href="#glo:cite"><code class="csfmt">\cite</code></a> or <a id="wrglossary.243"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>). You can also, optionally, display a list of the <a id="wrglossary.244"></a><a href="#glo:idx.glossaryentry">entries</a> you have referenced in your document (the <a id="wrglossary.245"></a><a href="#glo:dual.glossary">glossary</a>). This last part, displaying the <a id="wrglossary.246"></a><a href="#glo:dual.glossary">glossary</a>, is the part that most new users find difficult. There are three options available with the base <a id="wrglossary.247"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package (Options <a id="wrglossary.248"></a><a href="#glo:idx.opt.noidx">1</a>–<a id="wrglossary.249"></a><a href="#glo:idx.opt.xdy">3</a>). The <a id="wrglossary.250"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package provides two extra options for lists (Options <a href="#glo:idx.opt.b2g">4</a> and <a href="#glo:idx.opt.unsrt">5</a>) as well as an option for standalone descriptions within the document body (<a id="wrglossary.251"></a><a href="#glo:idx.opt.standalone">Option 6</a>).<p>
-An overview of Options <a id="wrglossary.252"></a><a href="#glo:idx.opt.noidx">1</a>–<a id="wrglossary.253"></a><a href="#glo:idx.opt.unsrt">5</a> is given in Table <a href="#tab:options">1.1</a>. <a id="wrglossary.254"></a><a href="#glo:idx.opt.standalone">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="styfmt">glossaries</span> performance page</a>. If, for some reason, you want to know what <a id="wrglossary.255"></a><a href="#glo:dual.indexing">indexing</a> option is in effect, you can test the value of: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.256"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.257"></a><code class="code"><dfn id="glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></dfn></code></div><!-- end of pinnedbox -->
- This is initialised to: <pre class="compactcodebox"><a id="wrglossary.258"></a><a href="#glo:ifglsxindy"><code class="csfmt">\ifglsxindy</code></a> xindy<code class="cmd">\else</code> makeindex<code class="cmd">\fi</code>
-</pre> If the <a id="wrglossary.259"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.260"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> or <a id="wrglossary.261"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.262"></a><a href="#glo:optval.sort.clear"><span class="optfmt">clear</span></a> options are used, <a id="wrglossary.263"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> will be redefined to <code class="code">none</code>. If <a id="wrglossary.264"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> is used <a id="wrglossary.265"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> will be updated to either <code class="code">makeindex</code> or <code class="code">xindy</code> as appropriate (that is, the conditional will no longer be part of the definition). If <a id="wrglossary.266"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> is used then <a id="wrglossary.267"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> will be updated to <code class="code">noidx</code>. This means that <a id="wrglossary.268"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> can’t be fully relied on until the start of the <a id="wrglossary.269"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment. (If you are using <a id="wrglossary.270"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+, then this command will also be updated to take the <a id="wrglossary.271"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> setting into account.)<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.272"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-If you are developing a class or package that loads <a id="wrglossary.273"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, I recommend that you don’t force the user into a particular <a id="wrglossary.274"></a><a href="#glo:dual.indexing">indexing</a> method by adding an unconditional <a id="wrglossary.275"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> into your class or package code. Aside from forcing the user into a particular indexing method, it means that they’re unable to use any commands that must come before <a id="wrglossary.276"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> (such as <a id="wrglossary.277"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>) and they can’t switch off the indexing whilst working on a draft document. (If you are using a class or package that has done this, pass the <a id="wrglossary.278"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a> option to <a id="wrglossary.279"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. For example, via the document class options.) </div><!-- end of important -->
+<a id="wrglossary.224"></a>The basic idea behind the <a id="wrglossary.225"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is that you first define your <a id="wrglossary.226"></a><a href="#glo:idx.glossaryentry">entries</a> (terms, symbols or <a id="wrglossary.227"></a><a href="#glo:idx.acronym">acronyms</a>). Then you can reference these within your document (analogous to <a id="wrglossary.228"></a><a href="#glo:cite"><code class="csfmt">\cite</code></a> or <a id="wrglossary.229"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>). You can also, optionally, display a list of the <a id="wrglossary.230"></a><a href="#glo:idx.glossaryentry">entries</a> you have referenced in your document (the <a id="wrglossary.231"></a><a href="#glo:dual.glossary">glossary</a>). This last part, displaying the <a id="wrglossary.232"></a><a href="#glo:dual.glossary">glossary</a>, is the part that most new users find difficult. There are three options available with the base <a id="wrglossary.233"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package (Options <a id="wrglossary.234"></a><a href="#glo:idx.opt.noidx">1</a>–<a id="wrglossary.235"></a><a href="#glo:idx.opt.xdy">3</a>). The <a id="wrglossary.236"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package provides two extra options for lists (Options <a href="#glo:idx.opt.b2g">4</a> and <a href="#glo:idx.opt.unsrt">5</a>) as well as an option for standalone descriptions within the document body (<a id="wrglossary.237"></a><a href="#glo:idx.opt.standalone">Option 6</a>).<p>
+An overview of Options <a id="wrglossary.238"></a><a href="#glo:idx.opt.noidx">1</a>–<a id="wrglossary.239"></a><a href="#glo:idx.opt.unsrt">5</a> is given in Table <a href="#tab:options">1.1</a>. <a id="wrglossary.240"></a><a href="#glo:idx.opt.standalone">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="styfmt">glossaries</span> performance page</a>. If, for some reason, you want to know what <a id="wrglossary.241"></a><a href="#glo:dual.indexing">indexing</a> option is in effect, you can test the value of: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.242"></a><code class="code"><dfn id="glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></dfn></code></div><!-- end of pinnedbox -->
+ This is initialised to: <pre class="compactcodebox"><a id="wrglossary.243"></a><a href="#glo:ifglsxindy"><code class="csfmt">\ifglsxindy</code></a> xindy<code class="cmd">\else</code> makeindex<code class="cmd">\fi</code>
+</pre> If the <a id="wrglossary.244"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.245"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> or <a id="wrglossary.246"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.247"></a><a href="#glo:optval.sort.clear"><span class="optfmt">clear</span></a> options are used, <a id="wrglossary.248"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> will be redefined to <code class="code">none</code>. If <a id="wrglossary.249"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> is used <a id="wrglossary.250"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> will be updated to either <code class="code">makeindex</code> or <code class="code">xindy</code> as appropriate (that is, the conditional will no longer be part of the definition). If <a id="wrglossary.251"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> is used then <a id="wrglossary.252"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> will be updated to <code class="code">noidx</code>. This means that <a id="wrglossary.253"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> can’t be fully relied on until the start of the <a id="wrglossary.254"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment. (If you are using <a id="wrglossary.255"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+, then this command will also be updated to take the <a id="wrglossary.256"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> setting into account.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you are developing a class or package that loads <a id="wrglossary.257"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, I recommend that you don’t force the user into a particular <a id="wrglossary.258"></a><a href="#glo:dual.indexing">indexing</a> method by adding an unconditional <a id="wrglossary.259"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> into your class or package code. Aside from forcing the user into a particular indexing method, it means that they’re unable to use any commands that must come before <a id="wrglossary.260"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> (such as <a id="wrglossary.261"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>) and they can’t switch off the indexing whilst working on a draft document. (If you are using a class or package that has done this, pass the <a id="wrglossary.262"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a> option to <a id="wrglossary.263"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>. For example, via the document class options.) </div><!-- end of important -->
<p>
-Strictly speaking, Options <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a> aren’t actually <a id="wrglossary.280"></a><a href="#glo:dual.indexing">indexing</a> options as no <a id="wrglossary.281"></a><a href="#glo:dual.indexing">indexing</a> is performed. In the case of <a id="wrglossary.282"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, all defined entries are listed in order of definition. In the case of <a id="wrglossary.283"></a><a href="#glo:idx.opt.standalone">Option 6</a>, the entry hypertargets and descriptions are manually inserted at appropriate points in the document. These two options are included here for completeness and for comparison with the actual <a id="wrglossary.284"></a><a href="#glo:dual.indexing">indexing</a> options.<p>
+Strictly speaking, Options <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a> aren’t actually <a id="wrglossary.264"></a><a href="#glo:dual.indexing">indexing</a> options as no <a id="wrglossary.265"></a><a href="#glo:dual.indexing">indexing</a> is performed. In the case of <a id="wrglossary.266"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, all defined entries are listed in order of definition. In the case of <a id="wrglossary.267"></a><a href="#glo:idx.opt.standalone">Option 6</a>, the entry hypertargets and descriptions are manually inserted at appropriate points in the document. These two options are included here for completeness and for comparison with the actual <a id="wrglossary.268"></a><a href="#glo:dual.indexing">indexing</a> options.<p>
<div class="table"> <div id="tab:options" class="caption">Table 1: Glossary Options: Pros and Cons</div><table class="tabular-c">
<tr style=""><th style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Option </span></th>
<td class="cell-noborder-bothsep-c"> <span style="font-weight: bold; "><a href="#glo:idx.opt.noidx">1</a> </span></td>
@@ -1056,114 +1063,114 @@
<td class="cell-noborder-bothsep-c"> <span style="font-weight: bold; "><a href="#glo:idx.opt.b2g">4</a> </span></td>
<td class="cell-noborder-rightsep-c"> <span style="font-weight: bold; "><a href="#glo:idx.opt.unsrt">5</a> </span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Requires <a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Requires an external application? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Requires Perl? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Requires Java? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Can sort <a href="#glo:exlatinalph">extended Latin alphabets</a> or <a href="#glo:nonlatinalph">non-Latin alphabets</a>? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="asterisk marker" class="icon">∗</span></sup> </td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="asterisk marker" class="icon">∗</span></sup> </td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
<td class="cell-noborder-rightsep-c"> N/A</td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Efficient sort algorithm? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
<td class="cell-noborder-rightsep-c"> N/A</td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Can use a different sort method for each glossary? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="dagger marker" class="icon">†</span></sup> </td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="dagger marker" class="icon">†</span></sup> </td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="dagger marker" class="icon">†</span></sup> </td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="dagger marker" class="icon">†</span></sup> </td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
<td class="cell-noborder-rightsep-c"> N/A</td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Any problematic sort values? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span><sup><span title="double dagger marker" class="icon">‡</span></sup></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span><sup><span title="double dagger marker" class="icon">‡</span></sup></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Are entries with identical sort values treated as separate unique entries? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="section marker" class="icon">§</span></sup> </td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span><sup><span title="section marker" class="icon">§</span></sup> </td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Can automatically form <a href="#glo:idx.range">ranges</a> in the <a href="#glo:dual.locationlist">location lists</a>? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Can have non-standard <a href="#glo:@@glslabel at entrylocation">locations</a> in the <a href="#glo:dual.locationlist">location lists</a>? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span><sup><span title="lozenge marker" class="icon">⧫</span></sup> </td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span><sup><span title="pilcrow marker" class="icon">¶</span></sup></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span><sup><span title="lozenge marker" class="icon">⧫</span></sup> </td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span><sup><span title="pilcrow marker" class="icon">¶</span></sup></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Maximum hierarchical depth (style-dependent) </span></td>
-<td class="cell-noborder-bothsep-c"> <span title="unlimited" class="icon">∞</span><sup><span title="hash marker" class="icon">#</span></sup> </td>
+<td class="cell-noborder-bothsep-c"> <span title="unlimited" class="icon">∞</span><sup><span title="hash marker" class="icon">#</span></sup> </td>
<td class="cell-noborder-bothsep-c"> 3 </td>
-<td class="cell-noborder-bothsep-c"> <span title="unlimited" class="icon">∞</span></td>
-<td class="cell-noborder-bothsep-c"> <span title="unlimited" class="icon">∞</span></td>
-<td class="cell-noborder-rightsep-c"> <span title="unlimited" class="icon">∞</span></td>
+<td class="cell-noborder-bothsep-c"> <span title="unlimited" class="icon">∞</span></td>
+<td class="cell-noborder-bothsep-c"> <span title="unlimited" class="icon">∞</span></td>
+<td class="cell-noborder-rightsep-c"> <span title="unlimited" class="icon">∞</span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; "><a href="#glo:glsdisplaynumberlist"><code class="csfmt">\glsdisplaynumberlist</code></a> reliable? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; "><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> allowed in <a href="#glo:env.document"><span class="envfmt">document</span></a> environment? (Not recommended.) </span></td>
-<td class="cell-noborder-bothsep-c"> <span title="no" class="icon">✖</span></td>
-<td class="cell-noborder-bothsep-c"> <span title="yes" class="icon">✔</span></td>
-<td class="cell-noborder-bothsep-c"> <span title="yes" class="icon">✔</span></td>
-<td class="cell-noborder-bothsep-c"> <span title="no" class="icon">✖</span><sup><span title="reference marker" class="icon">※</span></sup> </td>
-<td class="cell-noborder-rightsep-c"> <span title="yes" class="icon">✔</span><sup><span title="vertical double asterisk marker" class="icon">⁑</span></sup></td>
+<td class="cell-noborder-bothsep-c"> <span title="no" class="icon">✖</span></td>
+<td class="cell-noborder-bothsep-c"> <span title="yes" class="icon">✔</span></td>
+<td class="cell-noborder-bothsep-c"> <span title="yes" class="icon">✔</span></td>
+<td class="cell-noborder-bothsep-c"> <span title="no" class="icon">✖</span><sup><span title="reference marker" class="icon">※</span></sup> </td>
+<td class="cell-noborder-rightsep-c"> <span title="yes" class="icon">✔</span><sup><span title="vertical double asterisk marker" class="icon">⁑</span></sup></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Requires additional write registers? </span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
-<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
-<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span><sup><span title="star marker" class="icon">★</span></sup></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
+<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
+<td class="cell-noborder-rightsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span><sup><span title="star marker" class="icon">★</span></sup></td>
</tr><tr style=""><td style="border-top: none; border-right: none; border-left: none; padding-left: 0px; width: 3500.000000%; padding-right: 6.000000pt; text-align: left; "><span style="font-size: small; ">Default value of <a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a> package option </span></td>
<td class="cell-noborder-bothsep-c"> <span class="optfmt">false</span> </td>
<td class="cell-noborder-bothsep-c"> <span class="optfmt">true</span> </td>
<td class="cell-noborder-bothsep-c"> <span class="optfmt">true</span> </td>
-<td class="cell-noborder-bothsep-c"> <span class="optfmt">true</span><sup><span title="florette marker" class="icon">✾</span></sup> </td>
-<td class="cell-noborder-rightsep-c"> <span class="optfmt">true</span><sup><span title="florette marker" class="icon">✾</span></sup> </td>
+<td class="cell-noborder-bothsep-c"> <span class="optfmt">true</span><sup><span title="florette marker" class="icon">✾</span></sup> </td>
+<td class="cell-noborder-rightsep-c"> <span class="optfmt">true</span><sup><span title="florette marker" class="icon">✾</span></sup> </td>
</tr></table>
<p>
-<div class="tablefns"><div class="tablefn"><sup><span title="asterisk marker" class="icon">∗</span></sup>Strips standard LaTeX accents (that is, accents generated by core LaTeX commands) so, for example, <code class="csfmt">\AA</code> is treated the same as A.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="dagger marker" class="icon">†</span></sup>Only with the hybrid method provided with <a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="double dagger marker" class="icon">‡</span></sup>Provided <a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> is used.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="section marker" class="icon">§</span></sup>Entries with the same sort value are merged.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="lozenge marker" class="icon">⧫</span></sup>Requires some setting up.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="pilcrow marker" class="icon">¶</span></sup>The locations must be set explicitly through the custom <a href="#glo:opt.gloskey.location"><span class="xtrcsoptfmt">location</span></a> field provided by <a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.</div><!-- end of tablefn -->
+<div class="tablefns"><div class="tablefn"><sup><span title="asterisk marker" class="icon">∗</span></sup>Strips standard LaTeX accents (that is, accents generated by core LaTeX commands) so, for example, <code class="csfmt">\AA</code> is treated the same as A.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="dagger marker" class="icon">†</span></sup>Only with the hybrid method provided with <a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="double dagger marker" class="icon">‡</span></sup>Provided <a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> is used.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="section marker" class="icon">§</span></sup>Entries with the same sort value are merged.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="lozenge marker" class="icon">⧫</span></sup>Requires some setting up.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="pilcrow marker" class="icon">¶</span></sup>The locations must be set explicitly through the custom <a href="#glo:opt.gloskey.location"><span class="xtrcsoptfmt">location</span></a> field provided by <a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.</div><!-- end of tablefn -->
<div class="tablefn"><sup><span title="hash marker" class="icon">#</span></sup>Unlimited but unreliable.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="reference marker" class="icon">※</span></sup>Entries are defined in <a href="#glo:ext.bib"><span class="extfmt">bib</span></a> format. <a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> should not be used explicitly.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="vertical double asterisk marker" class="icon">⁑</span></sup>Provided <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=true</span> or <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span> but not recommended.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="star marker" class="icon">★</span></sup>Provided <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=false</span> or <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>.</div><!-- end of tablefn -->
- <div class="tablefn"><sup><span title="florette marker" class="icon">✾</span></sup>Irrelevant with <a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a>. (The <a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> option automatically switches this on.)</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="reference marker" class="icon">※</span></sup>Entries are defined in <a href="#glo:ext.bib"><span class="extfmt">bib</span></a> format. <a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> should not be used explicitly.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="vertical double asterisk marker" class="icon">⁑</span></sup>Provided <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=true</span> or <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span> but not recommended.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="star marker" class="icon">★</span></sup>Provided <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=false</span> or <a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>.</div><!-- end of tablefn -->
+ <div class="tablefn"><sup><span title="florette marker" class="icon">✾</span></sup>Irrelevant with <a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a>. (The <a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> option automatically switches this on.)</div><!-- end of tablefn -->
</div><!-- end of tablefns -->
</div><p>
@@ -1170,55 +1177,55 @@
</section><!-- end of section sec:indexingoptions -->
<section id="option1"><!-- start of section option1 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.1. <a id="wrglossary.285"></a><dfn id="glo:idx.opt.noidx">Option 1 (<span class="qt">“noidx”</span>)</dfn><div class="labellink"><a href="#option1">[link]</a></div></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.1. <a id="wrglossary.269"></a><dfn id="glo:idx.opt.noidx">Option 1 (<span class="qt">“noidx”</span>)</dfn><div class="labellink"><a href="#option1">[link]</a></div></h3><!-- end of subsection header -->
<p>
-This option isn’t generally recommended for reasons given below. It’s best used with <a id="wrglossary.286"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.287"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> (order of use) or <a id="wrglossary.288"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.289"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> (order of definition). Example Document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.290"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.291"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.292"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
-<strong class="strong"><a id="wrglossary.293"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a></strong> <span class="comment">% use TeX to sort</span>
-<a id="wrglossary.294"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.295"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.296"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.297"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.298"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.299"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.300"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.301"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.302"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.303"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.304"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.305"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+This option isn’t generally recommended for reasons given below. It’s best used with <a id="wrglossary.270"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.271"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> (order of use) or <a id="wrglossary.272"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.273"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> (order of definition). Example Document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.274"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.275"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
+<strong class="strong"><a id="wrglossary.276"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a></strong> <span class="comment">% use TeX to sort</span>
+<a id="wrglossary.277"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.278"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.279"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.280"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.281"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.282"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.283"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.284"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.285"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.286"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.287"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.288"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.306"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.307"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.308"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.309"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.310"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.311"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.312"></a><a href="#glo:idx.acronym">acronym</a>:</span>
-<a id="wrglossary.313"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.314"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
-<a id="wrglossary.315"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.289"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.290"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.291"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.292"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.293"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.294"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.295"></a><a href="#glo:idx.acronym">acronym</a>:</span>
+<a id="wrglossary.296"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.297"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
+<a id="wrglossary.298"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.316"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.317"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.318"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.319"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.320"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.321"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.322"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a></strong>
+<a id="wrglossary.299"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.300"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.301"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.302"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.303"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.304"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.305"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a></strong>
<code class="cend">\end{document}</code>
-</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.323"></a><a href="#glo:idx.documentpreamble">document preamble</a> with <a id="wrglossary.324"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span> <a id="wrglossary.325"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>). Note that six entries have been defined but only five are referenced (<a id="wrglossary.326"></a><a href="#glo:@@glslabel at indexing">indexed</a>) in the document so only those five appear in the <a id="wrglossary.327"></a><a href="#glo:dual.glossary">glossary</a>. <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.328"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:noidx"></a>Example 3: Simple document that uses TeX to sort entries <a href="glossaries-user-examples/glossaries-user-example003.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example003.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.306"></a><a href="#glo:idx.documentpreamble">document preamble</a> with <a id="wrglossary.307"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span> <a id="wrglossary.308"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>). Note that six entries have been defined but only five are referenced (<a id="wrglossary.309"></a><a href="#glo:@@glslabel at indexing">indexed</a>) in the document so only those five appear in the <a id="wrglossary.310"></a><a href="#glo:dual.glossary">glossary</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:noidx"></a>Example 3: Simple document that uses TeX to sort entries <a href="glossaries-user-examples/glossaries-user-example003.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example003.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
<object data="glossaries-user-examples/glossaries-user-example003.png" type="image/png" width="391" height="244">Example document that defines some entries, references a subset of them in the document and displays a sorted list of the referenced entries: alpha, ARPANET, duck, parrot and puffin. There are three letter groups, headed A, D and P.</object> </div><!-- end of resultbox -->
- This uses the <a id="wrglossary.329"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> style, which puts a heading at the start of each <a id="wrglossary.330"></a><a href="#glo:idx.group">letter group</a>. The <a id="wrglossary.331"></a><a href="#glo:idx.group">letter group</a> is determined by the first character of the sort value. For a preview of all available styles, see <a href="https://www.dickimaw-books.com/gallery/index.php?label=glossaries-styles">Gallery: Predefined Styles</a>. The number 1 after each description is the <a id="wrglossary.332"></a><a href="#glo:locationlist">number list</a> (or <a id="wrglossary.333"></a><a href="#glo:dual.locationlist">location list</a>). This is the list of <a id="wrglossary.334"></a><a href="#glo:@@glslabel at entrylocation">locations</a> (page numbers, in this case) where the entry was <a id="wrglossary.335"></a><a href="#glo:@@glslabel at indexing">indexed</a>. In this example, all entries were <a id="wrglossary.336"></a><a href="#glo:@@glslabel at indexing">indexed</a> on page 1.<p>
-This option doesn’t require an external <a id="wrglossary.337"></a><a href="#glo:dual.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 id="wrglossary.338"></a><a href="#glo:dual.exlatinalph">extended Latin alphabets</a> or <a id="wrglossary.339"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabets</a>. However, if you use the <a id="wrglossary.340"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span> package option (the default for <a id="wrglossary.341"></a><a href="#glo:idx.opt.noidx">Option 1</a>) then the <a id="wrglossary.342"></a><a href="#glo:@@glslabel at latexexlatinchar">standard LaTeX accent commands</a> will be ignored, so if an entry’s name is set to <code class="code"><a id="wrglossary.343"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite</code> then the sort value will default to <code class="code">elite</code> if <a id="wrglossary.344"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span> is used and will default to the literal string \’elite if <a id="wrglossary.345"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> is used. <p>
-<div class="warning"><div class="warningtitle"><a id="wrglossary.346"></a><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
-Previously, it was also possible to strip accents from <a id="wrglossary.347"></a><a href="#glo:dual.utf8">UTF-8</a> characters, but that’s not possible following updates to the LaTeX kernel. The kernel updates are beneficial as they make it possible to use <a id="wrglossary.348"></a><a href="#glo:dual.utf8">UTF-8</a> characters in labels, but the trick of stripping accents was a hack that no longer works. </div><!-- end of warning -->
+ This uses the <a id="wrglossary.311"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> style, which puts a heading at the start of each <a id="wrglossary.312"></a><a href="#glo:idx.group">letter group</a>. The <a id="wrglossary.313"></a><a href="#glo:idx.group">letter group</a> is determined by the first character of the sort value. For a preview of all available styles, see <a href="https://www.dickimaw-books.com/gallery/index.php?label=glossaries-styles">Gallery: Predefined Styles</a>. The number 1 after each description is the <a id="wrglossary.314"></a><a href="#glo:locationlist">number list</a> (or <a id="wrglossary.315"></a><a href="#glo:dual.locationlist">location list</a>). This is the list of <a id="wrglossary.316"></a><a href="#glo:@@glslabel at entrylocation">locations</a> (page numbers, in this case) where the entry was <a id="wrglossary.317"></a><a href="#glo:@@glslabel at indexing">indexed</a>. In this example, all entries were <a id="wrglossary.318"></a><a href="#glo:@@glslabel at indexing">indexed</a> on page 1.<p>
+This option doesn’t require an external <a id="wrglossary.319"></a><a href="#glo:dual.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 id="wrglossary.320"></a><a href="#glo:dual.exlatinalph">extended Latin alphabets</a> or <a id="wrglossary.321"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabets</a>. However, if you use the <a id="wrglossary.322"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span> package option (the default for <a id="wrglossary.323"></a><a href="#glo:idx.opt.noidx">Option 1</a>) then the <a id="wrglossary.324"></a><a href="#glo:@@glslabel at latexexlatinchar">standard LaTeX accent commands</a> will be ignored, so if an entry’s name is set to <code class="code"><a id="wrglossary.325"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite</code> then the sort value will default to <code class="code">elite</code> if <a id="wrglossary.326"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span> is used and will default to the literal string \’elite if <a id="wrglossary.327"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> is used. <p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Previously, it was also possible to strip accents from <a id="wrglossary.328"></a><a href="#glo:dual.utf8">UTF-8</a> characters, but that’s not possible following updates to the LaTeX kernel. The kernel updates are beneficial as they make it possible to use <a id="wrglossary.329"></a><a href="#glo:dual.utf8">UTF-8</a> characters in labels, but the trick of stripping accents was a hack that no longer works. </div><!-- end of warning -->
<p>
-If you have any other kinds of commands that don’t expand to <a id="wrglossary.349"></a><a href="#glo:dual.ascii">ASCII</a> characters, such as <a id="wrglossary.350"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, then you must use <a id="wrglossary.351"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> or change the sort method (<a id="wrglossary.352"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.353"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> or <a id="wrglossary.354"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.355"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>) in the package options or explicitly set the <a id="wrglossary.356"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key when you define the relevant entries, as shown in the above example which has: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.357"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.358"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.359"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.360"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.361"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.362"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.363"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
+If you have any other kinds of commands that don’t expand to <a id="wrglossary.330"></a><a href="#glo:dual.ascii">ASCII</a> characters, such as <a id="wrglossary.331"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, then you must use <a id="wrglossary.332"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> or change the sort method (<a id="wrglossary.333"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.334"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> or <a id="wrglossary.335"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.336"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>) in the package options or explicitly set the <a id="wrglossary.337"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key when you define the relevant entries, as shown in the above example which has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.338"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.339"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.340"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.341"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.342"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.343"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
}
</pre><p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.364"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.365"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.366"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option that provides <a id="wrglossary.367"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the <a id="wrglossary.368"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.369"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>). </div><!-- end of information -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.344"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.345"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.346"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option that provides <a id="wrglossary.347"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the <a id="wrglossary.348"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.349"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>). </div><!-- end of information -->
<p>
-This option works best with the <a id="wrglossary.370"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.371"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.372"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.373"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> setting. For any other setting, be prepared for a long document build time, especially if you have a lot of entries defined. <strong class="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 <a id="wrglossary.374"></a><a href="#glo:hierarchicallevel">hierarchical</a> glossaries and does not form <a id="wrglossary.375"></a><a href="#glo:idx.range">ranges</a> in the <a id="wrglossary.376"></a><a href="#glo:dual.locationlist">location lists</a>. If you really can’t use an <a id="wrglossary.377"></a><a href="#glo:dual.indexingapp">indexing application</a> consider using <a id="wrglossary.378"></a><a href="#glo:idx.opt.unsrt">Option 5</a> instead.<p>
+This option works best with the <a id="wrglossary.350"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.351"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.352"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.353"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> setting. For any other setting, be prepared for a long document build time, especially if you have a lot of entries defined. <strong class="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 <a id="wrglossary.354"></a><a href="#glo:hierarchicallevel">hierarchical</a> glossaries and does not form <a id="wrglossary.355"></a><a href="#glo:idx.range">ranges</a> in the <a id="wrglossary.356"></a><a href="#glo:dual.locationlist">location lists</a>. If you really can’t use an <a id="wrglossary.357"></a><a href="#glo:dual.indexingapp">indexing application</a> consider using <a id="wrglossary.358"></a><a href="#glo:idx.opt.unsrt">Option 5</a> instead.<p>
Summary:
<ol class="displaylist">
- <li><span class="numitem">1.</span>Add <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.379"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.380"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>
-</pre> to your <a id="wrglossary.381"></a><a href="#glo:idx.documentpreamble">preamble</a> (before you start defining your entries, as described in §<a href="#sec:newglosentry">4</a>).<p>
-<li><span class="numitem">2.</span>Put <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.382"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.383"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>
-</pre> where you want your list of entries to appear (described in §<a href="#sec:printglossary">8</a>). Alternatively, to display all glossaries use the iterative command: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.384"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.385"></a><a href="#glo:printnoidxglossaries"><code class="csfmt">\printnoidxglossaries</code></a>
+ <li><span class="numitem">1.</span>Add <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.359"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>
+</pre> to your <a id="wrglossary.360"></a><a href="#glo:idx.documentpreamble">preamble</a> (before you start defining your entries, as described in §<a href="#sec:newglosentry">4</a>).<p>
+<li><span class="numitem">2.</span>Put <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.361"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>
+</pre> where you want your list of entries to appear (described in §<a href="#sec:printglossary">8</a>). Alternatively, to display all glossaries use the iterative command: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.362"></a><a href="#glo:printnoidxglossaries"><code class="csfmt">\printnoidxglossaries</code></a>
</pre><p>
-<li><span class="numitem">3.</span>Run LaTeX twice on your document. (As you would do to make a table of contents appear.) For example, click twice on the <span class="qt">“typeset”</span> or <span class="qt">“build”</span> or <span class="qt">“pdfLaTeX”</span> button in your editor.
+<li><span class="numitem">3.</span>Run LaTeX twice on your document. (As you would do to make a table of contents appear.) For example, click twice on the <span class="qt">“typeset”</span> or <span class="qt">“build”</span> or <span class="qt">“pdfLaTeX”</span> button in your editor.
</ol>
<p>
@@ -1225,145 +1232,145 @@
</section><!-- end of section option1 -->
<section id="option2"><!-- start of section option2 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.2. <a id="wrglossary.386"></a><dfn id="glo:idx.opt.mkidx">Option 2 (<span class="appfmt">makeindex</span>)</dfn><div class="labellink"><a href="#option2">[link]</a></div></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.2. <a id="wrglossary.363"></a><dfn id="glo:idx.opt.mkidx">Option 2 (<span class="appfmt">makeindex</span>)</dfn><div class="labellink"><a href="#option2">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<a id="wrglossary.387"></a>Example document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.388"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.389"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.390"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
-<strong class="strong"><a id="wrglossary.391"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.392"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
-<a id="wrglossary.393"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.394"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.395"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.396"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.397"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.398"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.399"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.400"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.401"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.402"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.403"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.404"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+<a id="wrglossary.364"></a>Example document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.365"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.366"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
+<strong class="strong"><a id="wrglossary.367"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.368"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
+<a id="wrglossary.369"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.370"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.371"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.372"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.373"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.374"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.375"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.376"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.377"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.378"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.379"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.380"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.405"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.406"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.407"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.408"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.409"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.410"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.411"></a><a href="#glo:idx.acronym">acronym</a>:</span>
-<a id="wrglossary.412"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.413"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
-<a id="wrglossary.414"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.381"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.382"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.383"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.384"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.385"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.386"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.387"></a><a href="#glo:idx.acronym">acronym</a>:</span>
+<a id="wrglossary.388"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.389"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
+<a id="wrglossary.390"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.415"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.416"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.417"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.418"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.419"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.420"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.421"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
+<a id="wrglossary.391"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.392"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.393"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.394"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.395"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.396"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.397"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
<code class="cend">\end{document}</code>
-</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.422"></a><a href="#glo:idx.documentpreamble">preamble</a> with <a id="wrglossary.423"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span> <a id="wrglossary.424"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for Example <a href="#ex:noidx">3</a>. <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.425"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:mkidx"></a>Example 4: Simple document that uses <span class="appfmt">makeindex</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example004.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example004.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.398"></a><a href="#glo:idx.documentpreamble">preamble</a> with <a id="wrglossary.399"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span> <a id="wrglossary.400"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for Example <a href="#ex:noidx">3</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:mkidx"></a>Example 4: Simple document that uses <span class="appfmt">makeindex</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example004.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example004.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
<object data="glossaries-user-examples/glossaries-user-example004.png" type="image/png" width="391" height="244">Example document that defines some entries, references a subset of them in the document and displays a sorted list of the referenced entries: alpha, ARPANET, duck, parrot and puffin. There are three letter groups, headed A, D and P.</object> </div><!-- end of resultbox -->
<p>
-This option uses a <a id="wrglossary.426"></a><a href="#glo:dual.cli">CLI</a> application called <a id="wrglossary.427"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> to sort the entries. This application comes with all modern TeX distributions, but it’s hard-coded for the non-extended <a id="wrglossary.428"></a><a href="#glo:dual.latinalph">Latin alphabet</a>. It can’t correctly sort accent commands (such as <a id="wrglossary.429"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a> or <a id="wrglossary.430"></a><a href="#glo:c"><code class="csfmt">\c</code></a>) and fails with <a id="wrglossary.431"></a><a href="#glo:dual.utf8">UTF-8</a> characters, especially for any sort values that start with a <a id="wrglossary.432"></a><a href="#glo:dual.utf8">UTF-8</a> character (as it separates the octets resulting in an invalid file <a id="wrglossary.433"></a><a href="#glo:idx.encoding">encoding</a>). This process involves making LaTeX write the <a id="wrglossary.434"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.435"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> reads. Then <a id="wrglossary.436"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> writes a new file containing the code to typeset the <a id="wrglossary.437"></a><a href="#glo:dual.glossary">glossary</a>. Then <a id="wrglossary.438"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in on the next run.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.439"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-There are other applications that can read <a id="wrglossary.440"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files, such as <a id="wrglossary.441"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> and <a id="wrglossary.442"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a>, but the <a id="wrglossary.443"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package uses a customized <a id="wrglossary.444"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> style file (created by <a id="wrglossary.445"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>) that adjusts the special characters and input keyword and also ensures that the resulting file (which is input by <a id="wrglossary.446"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>) adheres to the <a id="wrglossary.447"></a><a href="#glo:dual.glossary">glossary</a> style. If you want to use an alternative, you will need to ensure that it can honour the settings in the <a id="wrglossary.448"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file. </div><!-- end of information -->
+This option uses a <a id="wrglossary.401"></a><a href="#glo:dual.cli">CLI</a> application called <a id="wrglossary.402"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> to sort the entries. This application comes with all modern TeX distributions, but it’s hard-coded for the non-extended <a id="wrglossary.403"></a><a href="#glo:dual.latinalph">Latin alphabet</a>. It can’t correctly sort accent commands (such as <a id="wrglossary.404"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a> or <a id="wrglossary.405"></a><a href="#glo:c"><code class="csfmt">\c</code></a>) and fails with <a id="wrglossary.406"></a><a href="#glo:dual.utf8">UTF-8</a> characters, especially for any sort values that start with a <a id="wrglossary.407"></a><a href="#glo:dual.utf8">UTF-8</a> character (as it separates the octets resulting in an invalid file <a id="wrglossary.408"></a><a href="#glo:idx.encoding">encoding</a>). This process involves making LaTeX write the <a id="wrglossary.409"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.410"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> reads. Then <a id="wrglossary.411"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> writes a new file containing the code to typeset the <a id="wrglossary.412"></a><a href="#glo:dual.glossary">glossary</a>. Then <a id="wrglossary.413"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in on the next run.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+There are other applications that can read <a id="wrglossary.414"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files, such as <a id="wrglossary.415"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> and <a id="wrglossary.416"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a>, but the <a id="wrglossary.417"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package uses a customized <a id="wrglossary.418"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> style file (created by <a id="wrglossary.419"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>) that adjusts the special characters and input keyword and also ensures that the resulting file (which is input by <a id="wrglossary.420"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>) adheres to the <a id="wrglossary.421"></a><a href="#glo:dual.glossary">glossary</a> style. If you want to use an alternative, you will need to ensure that it can honour the settings in the <a id="wrglossary.422"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file. </div><!-- end of information -->
<p>
-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 <a id="wrglossary.449"></a><a href="#glo:dual.shellescape">shell escape</a> since <a id="wrglossary.450"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is considered a trusted application, which means you should be able to use the <a id="wrglossary.451"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.452"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or <a id="wrglossary.453"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.454"></a><a href="#glo:optval.automake.delayed"><span class="optfmt">true</span></a> package option provided the <a id="wrglossary.455"></a><a href="#glo:dual.shellescape">shell escape</a> hasn’t been completely disabled.<p>
-This method can form <a id="wrglossary.456"></a><a href="#glo:idx.range">ranges</a> in the <a id="wrglossary.457"></a><a href="#glo:locationlist">number list</a> but only accepts limited number formats: <a id="wrglossary.458"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>, <a id="wrglossary.459"></a><a href="#glo:roman"><code class="csfmt">\roman</code></a>, <a id="wrglossary.460"></a><a href="#glo:Roman"><code class="csfmt">\Roman</code></a>, <a id="wrglossary.461"></a><a href="#glo:alph"><code class="csfmt">\alph</code></a> and <a id="wrglossary.462"></a><a href="#glo:Alph"><code class="csfmt">\Alph</code></a>. <p>
-This option does not allow a mixture of sort methods. All <a id="wrglossary.463"></a><a href="#glo:dual.glossary">glossaries</a> 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 <a id="wrglossary.464"></a><a href="#glo:dual.glossary">glossary</a> and letter ordering for another you’ll have to explicitly call <a id="wrglossary.465"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for each <a id="wrglossary.466"></a><a href="#glo:dual.glossary">glossary</a> type.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.467"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.468"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.mkidx">2</a> to provide word/letter ordering with <a id="wrglossary.469"></a><a href="#glo:idx.opt.mkidx">Option 2</a> and order of use/definition with <a id="wrglossary.470"></a><a href="#glo:idx.opt.noidx">Option 1</a>. See the <a id="wrglossary.471"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details. See also the <a id="wrglossary.472"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> alternative to <a id="wrglossary.473"></a><a href="#glo:file.sampleSort.tex"><span class="filefmt">sampleSort.tex</span></a> in §<a href="#sec:samplessort">18.5</a>. </div><!-- end of information -->
+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 <a id="wrglossary.423"></a><a href="#glo:dual.shellescape">shell escape</a> since <a id="wrglossary.424"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is considered a trusted application, which means you should be able to use the <a id="wrglossary.425"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.426"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or <a id="wrglossary.427"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.428"></a><a href="#glo:optval.automake.delayed"><span class="optfmt">true</span></a> package option provided the <a id="wrglossary.429"></a><a href="#glo:dual.shellescape">shell escape</a> hasn’t been completely disabled.<p>
+This method can form <a id="wrglossary.430"></a><a href="#glo:idx.range">ranges</a> in the <a id="wrglossary.431"></a><a href="#glo:locationlist">number list</a> but only accepts limited number formats: <a id="wrglossary.432"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>, <a id="wrglossary.433"></a><a href="#glo:roman"><code class="csfmt">\roman</code></a>, <a id="wrglossary.434"></a><a href="#glo:Roman"><code class="csfmt">\Roman</code></a>, <a id="wrglossary.435"></a><a href="#glo:alph"><code class="csfmt">\alph</code></a> and <a id="wrglossary.436"></a><a href="#glo:Alph"><code class="csfmt">\Alph</code></a>. <p>
+This option does not allow a mixture of sort methods. All <a id="wrglossary.437"></a><a href="#glo:dual.glossary">glossaries</a> 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 <a id="wrglossary.438"></a><a href="#glo:dual.glossary">glossary</a> and letter ordering for another you’ll have to explicitly call <a id="wrglossary.439"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for each <a id="wrglossary.440"></a><a href="#glo:dual.glossary">glossary</a> type.<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.441"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.442"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.mkidx">2</a> to provide word/letter ordering with <a id="wrglossary.443"></a><a href="#glo:idx.opt.mkidx">Option 2</a> and order of use/definition with <a id="wrglossary.444"></a><a href="#glo:idx.opt.noidx">Option 1</a>. See the <a id="wrglossary.445"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details. See also the <a id="wrglossary.446"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> alternative to <a id="wrglossary.447"></a><a href="#glo:file.sampleSort.tex"><span class="filefmt">sampleSort.tex</span></a> in §<a href="#sec:samplessort">18.5</a>. </div><!-- end of information -->
<p>
Summary:
<ol class="displaylist">
- <li><span class="numitem">1.</span>If you want to use <a id="wrglossary.474"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.475"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> option you must change the quote character using <a id="wrglossary.476"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.477"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.478"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
-</pre> This must be used before <a id="wrglossary.479"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Note that if you are using <a id="wrglossary.480"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, the shorthands aren’t enabled until the start of the document, so you won’t be able to use the shorthands in definitions that occur in the <a id="wrglossary.481"></a><a href="#glo:idx.documentpreamble">preamble</a>.<p>
-<li><span class="numitem">2.</span>Add <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.482"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.483"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-</pre> to your <a id="wrglossary.484"></a><a href="#glo:idx.documentpreamble">preamble</a> (before you start defining your entries, as described in §<a href="#sec:newglosentry">4</a>).<p>
-<li><span class="numitem">3.</span>Put <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.485"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.486"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>
-</pre> where you want your list of entries to appear (described in §<a href="#sec:printglossary">8</a>). Alternatively, to display all glossaries use the iterative command: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.487"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.488"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+ <li><span class="numitem">1.</span>If you want to use <a id="wrglossary.448"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.449"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> option you must change the quote character using <a id="wrglossary.450"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.451"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
+</pre> This must be used before <a id="wrglossary.452"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Note that if you are using <a id="wrglossary.453"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, the shorthands aren’t enabled until the start of the document, so you won’t be able to use the shorthands in definitions that occur in the <a id="wrglossary.454"></a><a href="#glo:idx.documentpreamble">preamble</a>.<p>
+<li><span class="numitem">2.</span>Add <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.455"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+</pre> to your <a id="wrglossary.456"></a><a href="#glo:idx.documentpreamble">preamble</a> (before you start defining your entries, as described in §<a href="#sec:newglosentry">4</a>).<p>
+<li><span class="numitem">3.</span>Put <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.457"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>
+</pre> where you want your list of entries to appear (described in §<a href="#sec:printglossary">8</a>). Alternatively, to display all glossaries use the iterative command: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.458"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
</pre><p>
-<li><span class="numitem">4.</span>Run LaTeX on your document. This creates files with the extensions <a id="wrglossary.489"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.490"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> (for example, if your LaTeX document is called <span class="filefmt">myDoc.tex</span>, then you’ll have two extra files called <span class="filefmt">myDoc.glo</span> and <span class="filefmt">myDoc.ist</span>). If you look at your document at this point, you won’t see the glossary as it hasn’t been created yet. (If you use <a id="wrglossary.491"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> you’ll see the section heading and some boilerplate text.)<p>
-If you have used package options such as <a id="wrglossary.492"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there will also be other sets of files corresponding to the extra glossaries that were created by those options.<p>
-<li><span class="numitem">5.</span><a id="makeindex.run"></a> Run <a id="wrglossary.493"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with the <a id="wrglossary.494"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the input file and the <a id="wrglossary.495"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file as the style so that it creates an output file with the extension <a id="wrglossary.496"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.497"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeindex <a id="wrglossary.498"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist <a id="wrglossary.499"></a><a href="#glo:switch.mkidx.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
+<li><span class="numitem">4.</span>Run LaTeX on your document. This creates files with the extensions <a id="wrglossary.459"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.460"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> (for example, if your LaTeX document is called <span class="filefmt">myDoc.tex</span>, then you’ll have two extra files called <span class="filefmt">myDoc.glo</span> and <span class="filefmt">myDoc.ist</span>). If you look at your document at this point, you won’t see the glossary as it hasn’t been created yet. (If you use <a id="wrglossary.461"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> you’ll see the section heading and some boilerplate text.)<p>
+If you have used package options such as <a id="wrglossary.462"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there will also be other sets of files corresponding to the extra glossaries that were created by those options.<p>
+<li><span class="numitem">5.</span><a id="makeindex.run"></a> Run <a id="wrglossary.463"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with the <a id="wrglossary.464"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the input file and the <a id="wrglossary.465"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file as the style so that it creates an output file with the extension <a id="wrglossary.466"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.467"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist <a id="wrglossary.468"></a><a href="#glo:switch.mkidx.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
</pre> (Replace <code class="code">myDoc</code> with the base name of your LaTeX document file. Avoid spaces in the file name if possible.)<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.500"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-The file extensions vary according to the <a id="wrglossary.501"></a><a href="#glo:dual.glossary">glossary</a> <a id="wrglossary.502"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>. See §<a href="#sec:makeindexapp">1.6.4</a> for further details. <a id="wrglossary.503"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> must be called for each set of files. </div><!-- end of important -->
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The file extensions vary according to the <a id="wrglossary.469"></a><a href="#glo:dual.glossary">glossary</a> <a id="wrglossary.470"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>. See §<a href="#sec:makeindexapp">1.6.4</a> for further details. <a id="wrglossary.471"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> must be called for each set of files. </div><!-- end of important -->
<p>
-If you don’t know how to use the command prompt, then you can probably access <a id="wrglossary.504"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></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>
-Alternatively, run <a id="wrglossary.505"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> indirectly via the <a id="wrglossary.506"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.507"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeglossaries myDoc
-</pre> Note that the file extension isn’t supplied in this case. (Replace <a id="wrglossary.508"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with <a id="wrglossary.509"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> if you don’t have Perl installed.) This will pick up all the file extensions from the <a id="wrglossary.510"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.511"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> the appropriate number of times with all the necessary switches.<p>
-The simplest approach is to use <a id="wrglossary.512"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the following comment lines to the start of your document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.513"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
+If you don’t know how to use the command prompt, then you can probably access <a id="wrglossary.472"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></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>
+Alternatively, run <a id="wrglossary.473"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> indirectly via the <a id="wrglossary.474"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeglossaries myDoc
+</pre> Note that the file extension isn’t supplied in this case. (Replace <a id="wrglossary.475"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with <a id="wrglossary.476"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> if you don’t have Perl installed.) This will pick up all the file extensions from the <a id="wrglossary.477"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.478"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> the appropriate number of times with all the necessary switches.<p>
+The simplest approach is to use <a id="wrglossary.479"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the following comment lines to the start of your document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
% arara: makeglossaries
% arara: pdflatex
-</pre> (Replace <code class="code">makeglossaries</code> with <code class="code">makeglossarieslite</code> in the second line above if you don’t have Perl installed. Note that there’s no hyphen in this case.)<p>
-The default sort is word order (<span class="qt">“sea lion”</span> comes before <span class="qt">“seal”</span>). If you want letter ordering you need to add the <a id="wrglossary.514"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> switch: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.515"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeindex <a id="wrglossary.516"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> <a id="wrglossary.517"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist -o myDoc.gls myDoc.glo
-</pre> (See §<a href="#sec:makeindexapp">1.6.4</a> for further details on using <a id="wrglossary.518"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly.) If you use <a id="wrglossary.519"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.520"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> then use the <a id="wrglossary.521"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span> package option and the <a id="wrglossary.522"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> option will be added automatically.<p>
+</pre> (Replace <code class="code">makeglossaries</code> with <code class="code">makeglossarieslite</code> in the second line above if you don’t have Perl installed. Note that there’s no hyphen in this case.)<p>
+The default sort is word order (<span class="qt">“sea lion”</span> comes before <span class="qt">“seal”</span>). If you want letter ordering you need to add the <a id="wrglossary.480"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> switch: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.481"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> <a id="wrglossary.482"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist -o myDoc.gls myDoc.glo
+</pre> (See §<a href="#sec:makeindexapp">1.6.4</a> for further details on using <a id="wrglossary.483"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly.) If you use <a id="wrglossary.484"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.485"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> then use the <a id="wrglossary.486"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span> package option and the <a id="wrglossary.487"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> option will be added automatically.<p>
<li><span class="numitem">6.</span><a id="makeindex.relatex"></a> Once you have successfully completed the previous step, you can now run LaTeX on your document again.
</ol>
- You’ll need to repeat the last step if you have used the <a id="wrglossary.523"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a> option (unless you’re using <a id="wrglossary.524"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">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</a> and <a href="#makeindex.relatex">6</a> if you have any cross-references which can’t be <a id="wrglossary.525"></a><a href="#glo:@@glslabel at indexing">indexed</a> until the <a id="wrglossary.526"></a><a href="#glo:dual.indexingfile">indexing file</a> has been created.<p>
+ You’ll need to repeat the last step if you have used the <a id="wrglossary.488"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a> option (unless you’re using <a id="wrglossary.489"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">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</a> and <a href="#makeindex.relatex">6</a> if you have any cross-references which can’t be <a id="wrglossary.490"></a><a href="#glo:@@glslabel at indexing">indexed</a> until the <a id="wrglossary.491"></a><a href="#glo:dual.indexingfile">indexing file</a> has been created.<p>
</section><!-- end of section option2 -->
<section id="option3"><!-- start of section option3 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.3. <a id="wrglossary.527"></a><dfn id="glo:idx.opt.xdy">Option 3 (<span class="appfmt">xindy</span>)</dfn><div class="labellink"><a href="#option3">[link]</a></div></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.3. <a id="wrglossary.492"></a><dfn id="glo:idx.opt.xdy">Option 3 (<span class="appfmt">xindy</span>)</dfn><div class="labellink"><a href="#option3">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<a id="wrglossary.528"></a>Example document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.529"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<strong class="strong"><a id="wrglossary.530"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a></strong>,<a id="wrglossary.531"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.532"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
-<strong class="strong"><a id="wrglossary.533"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.534"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
-<a id="wrglossary.535"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.536"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.537"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.538"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.539"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.540"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.541"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.542"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.543"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.544"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.545"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.546"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+<a id="wrglossary.493"></a>Example document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<strong class="strong"><a id="wrglossary.494"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a></strong>,<a id="wrglossary.495"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.496"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
+<strong class="strong"><a id="wrglossary.497"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.498"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
+<a id="wrglossary.499"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.500"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.501"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.502"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.503"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.504"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.505"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.506"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.507"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.508"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.509"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.510"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.547"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.548"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.549"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.550"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.551"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.552"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.553"></a><a href="#glo:idx.acronym">acronym</a>:</span>
-<a id="wrglossary.554"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.555"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
-<a id="wrglossary.556"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.511"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.512"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.513"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.514"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.515"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.516"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.517"></a><a href="#glo:idx.acronym">acronym</a>:</span>
+<a id="wrglossary.518"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.519"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
+<a id="wrglossary.520"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.557"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.558"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.559"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.560"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.561"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.562"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.563"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
+<a id="wrglossary.521"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.522"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.523"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.524"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.525"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.526"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.527"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
<code class="cend">\end{document}</code>
-</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.564"></a><a href="#glo:idx.documentpreamble">preamble</a> with <a id="wrglossary.565"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span> <a id="wrglossary.566"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for Example <a href="#ex:noidx">3</a> and Example <a href="#ex:mkidx">4</a>. <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.567"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:xdy"></a>Example 5: Simple document that uses <span class="appfmt">xindy</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example005.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example005.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.528"></a><a href="#glo:idx.documentpreamble">preamble</a> with <a id="wrglossary.529"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span> <a id="wrglossary.530"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for Example <a href="#ex:noidx">3</a> and Example <a href="#ex:mkidx">4</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:xdy"></a>Example 5: Simple document that uses <span class="appfmt">xindy</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example005.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example005.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
<object data="glossaries-user-examples/glossaries-user-example005.png" type="image/png" width="391" height="244">Example document that defines some entries, references a subset of them in the document and displays a sorted list of the referenced entries: alpha, ARPANET, duck, parrot and puffin. There are three letter groups, headed A, D and P.</object> </div><!-- end of resultbox -->
<p>
-This option uses a <a id="wrglossary.568"></a><a href="#glo:dual.cli">CLI</a> application called <a id="wrglossary.569"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to sort the entries. This application is more flexible than <a id="wrglossary.570"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and is able to sort <a id="wrglossary.571"></a><a href="#glo:dual.exlatinalph">extended Latin alphabets</a> or <a id="wrglossary.572"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabets</a>, however it does still have some limitations.<p>
-The <a id="wrglossary.573"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application comes with both TeX Live and MikTeX, but since <a id="wrglossary.574"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></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 id="wrglossary.575"></a><a href="#glo:idx.opt.mkidx">Option 2</a>, this option involves making LaTeX write the <a id="wrglossary.576"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.577"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> reads. Then <a id="wrglossary.578"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> writes a new file containing the code to typeset the glossary. Then <a id="wrglossary.579"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in on the next run.<p>
-This is the best option with just the base <a id="wrglossary.580"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package if you want to sort according to a language other than English or if you want non-standard <a id="wrglossary.581"></a><a href="#glo:dual.locationlist">location lists</a>, but it can require some setting up (see §<a href="#sec:xindy">14</a>). There are some problems with certain sort values:
+This option uses a <a id="wrglossary.531"></a><a href="#glo:dual.cli">CLI</a> application called <a id="wrglossary.532"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to sort the entries. This application is more flexible than <a id="wrglossary.533"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and is able to sort <a id="wrglossary.534"></a><a href="#glo:dual.exlatinalph">extended Latin alphabets</a> or <a id="wrglossary.535"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabets</a>, however it does still have some limitations.<p>
+The <a id="wrglossary.536"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application comes with both TeX Live and MikTeX, but since <a id="wrglossary.537"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></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 id="wrglossary.538"></a><a href="#glo:idx.opt.mkidx">Option 2</a>, this option involves making LaTeX write the <a id="wrglossary.539"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.540"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> reads. Then <a id="wrglossary.541"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> writes a new file containing the code to typeset the glossary. Then <a id="wrglossary.542"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in on the next run.<p>
+This is the best option with just the base <a id="wrglossary.543"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package if you want to sort according to a language other than English or if you want non-standard <a id="wrglossary.544"></a><a href="#glo:dual.locationlist">location lists</a>, but it can require some setting up (see §<a href="#sec:xindy">14</a>). There are some problems with certain sort values:
<ul class="displaylist">
- <li><span class="bulletitem">•</span>entries with the same sort value are merged by <a id="wrglossary.582"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> into a single glossary line so you must make sure that each entry has a unique sort value; <li><span class="bulletitem">•</span><a id="wrglossary.583"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids empty sort values; <li><span class="bulletitem">•</span><a id="wrglossary.584"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> automatically strips control sequences, the math-shift character <a id="wrglossary.585"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a> and braces <a id="wrglossary.586"></a><a href="#glo:idx.sym.bg"><code class="code">{</code></a><a id="wrglossary.587"></a><a href="#glo:idx.sym.eg"><code class="code">}</code></a> from the sort value, which is usually desired but this can cause the sort value to collapse to an empty string which <a id="wrglossary.588"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids.
+ <li><span class="bulletitem">•</span>entries with the same sort value are merged by <a id="wrglossary.545"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> into a single glossary line so you must make sure that each entry has a unique sort value; <li><span class="bulletitem">•</span><a id="wrglossary.546"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids empty sort values; <li><span class="bulletitem">•</span><a id="wrglossary.547"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> automatically strips control sequences, the math-shift character <a id="wrglossary.548"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a> and braces <a id="wrglossary.549"></a><a href="#glo:idx.sym.bg"><code class="code">{</code></a><a id="wrglossary.550"></a><a href="#glo:idx.sym.eg"><code class="code">}</code></a> from the sort value, which is usually desired but this can cause the sort value to collapse to an empty string which <a id="wrglossary.551"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids.
</ul>
- In these problematic cases, you must set the <a id="wrglossary.589"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field explicitly, as in the above example which has: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.590"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.591"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.592"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.593"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.594"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.595"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.596"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
+ In these problematic cases, you must set the <a id="wrglossary.552"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field explicitly, as in the above example which has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.553"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.554"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.555"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.556"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.557"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.558"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
}
-</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.597"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.598"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.599"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option that provides <a id="wrglossary.600"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the <a id="wrglossary.601"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.602"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>). </div><!-- end of information -->
+</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.559"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.560"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.561"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> package option that provides <a id="wrglossary.562"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the <a id="wrglossary.563"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.564"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>). </div><!-- end of information -->
<p>
-All <a id="wrglossary.603"></a><a href="#glo:dual.glossary">glossaries</a> must be sorted according to the same method (word/letter ordering, order of use, or order of definition).<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.604"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.605"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.xdy">3</a> to provide word/letter ordering with <a id="wrglossary.606"></a><a href="#glo:idx.opt.xdy">Option 3</a> and order of use/definition with <a id="wrglossary.607"></a><a href="#glo:idx.opt.mkidx">Option 2</a>. See the <a id="wrglossary.608"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details. </div><!-- end of information -->
+All <a id="wrglossary.565"></a><a href="#glo:dual.glossary">glossaries</a> must be sorted according to the same method (word/letter ordering, order of use, or order of definition).<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.566"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.567"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.xdy">3</a> to provide word/letter ordering with <a id="wrglossary.568"></a><a href="#glo:idx.opt.xdy">Option 3</a> and order of use/definition with <a id="wrglossary.569"></a><a href="#glo:idx.opt.mkidx">Option 2</a>. See the <a id="wrglossary.570"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details. </div><!-- end of information -->
<p>
Summary:
<ol class="displaylist">
- <li><span class="numitem">1.</span>Add the <a id="wrglossary.609"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option to the <a id="wrglossary.610"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option list: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.611"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.612"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
-</pre> If you are using a non-Latin script you’ll also need to either switch off the creation of the number <a id="wrglossary.613"></a><a href="#glo:idx.group">group</a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.614"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.615"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.616"></a><a href="#glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></a><span class="optfmt">=false</span>}</span>]{glossaries}
-</pre> or use either <code class="code"><a id="wrglossary.617"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a>{<span class="meta">〈<em class="metainner">letter</em>〉</span>}</code> (to indicate the first <a id="wrglossary.618"></a><a href="#glo:idx.group">letter group</a> to follow the digits) or <code class="code"><a id="wrglossary.619"></a><a href="#glo:GlsSetXdyNumberGroupOrder"><code class="csfmt">\GlsSetXdyNumberGroupOrder</code></a>{<span class="meta">〈<em class="metainner">spec</em>〉</span>}</code> to indicate where the number <a id="wrglossary.620"></a><a href="#glo:idx.group">group</a> should be placed (see §<a href="#sec:xindy">14</a>).<p>
-<li><span class="numitem">2.</span>Add <a id="wrglossary.621"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> to your <a id="wrglossary.622"></a><a href="#glo:idx.documentpreamble">preamble</a> (before you start defining your entries, as described in §<a href="#sec:newglosentry">4</a>).<p>
-<li><span class="numitem">3.</span>Run LaTeX on your document. This creates files with the extensions <a id="wrglossary.623"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.624"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> (for example, if your LaTeX document is called <span class="filefmt">myDoc.tex</span>, then you’ll have two extra files called <span class="filefmt">myDoc.glo</span> and <span class="filefmt">myDoc.xdy</span>). If you look at your document at this point, you won’t see the glossary as it hasn’t been created yet. (If you’re using the <a id="wrglossary.625"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, you’ll see the section header and some boilerplate text.)<p>
-If you have used package options such as <a id="wrglossary.626"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there will also be other sets of files corresponding to the extra glossaries that were created by those options.<p>
-<li><span class="numitem">4.</span>Run <a id="wrglossary.627"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.628"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the input file and the <a id="wrglossary.629"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> file as a module so that it creates an output file with the extension <a id="wrglossary.630"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>. You also need to set the language name and input <a id="wrglossary.631"></a><a href="#glo:idx.encoding">encoding</a>, as follows (all on one line): <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.632"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>xindy <a id="wrglossary.633"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> english <a id="wrglossary.634"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> utf8 <a id="wrglossary.635"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.636"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> myDoc <a id="wrglossary.637"></a><a href="#glo:switch.xdy.t"><span class="shortargfmt">-t</span></a> myDoc.glg <a id="wrglossary.638"></a><a href="#glo:switch.xdy.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
-</pre> (Replace <code class="code">myDoc</code> with the base name of your LaTeX document file. Avoid spaces in the file name. If necessary, also replace <code class="code">english</code> with the name of your language and <code class="code">utf8</code> with your input <a id="wrglossary.639"></a><a href="#glo:idx.encoding">encoding</a>, for example, <code class="code"><a id="wrglossary.640"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> german <a id="wrglossary.641"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> din5007-utf8</code>.)<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.642"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-The file extensions vary according to the glossary <a id="wrglossary.643"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>. See §<a href="#sec:xindyapp">1.6.3</a> for further details. <a id="wrglossary.644"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> must be called for each set of files. </div><!-- end of important -->
+ <li><span class="numitem">1.</span>Add the <a id="wrglossary.571"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option to the <a id="wrglossary.572"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option list: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.573"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
+</pre> If you are using a non-Latin script you’ll also need to either switch off the creation of the number <a id="wrglossary.574"></a><a href="#glo:idx.group">group</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.575"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.576"></a><a href="#glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></a><span class="optfmt">=false</span>}</span>]{glossaries}
+</pre> or use either <code class="code"><a id="wrglossary.577"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a>{<span class="meta">〈<em class="metainner">letter</em>〉</span>}</code> (to indicate the first <a id="wrglossary.578"></a><a href="#glo:idx.group">letter group</a> to follow the digits) or <code class="code"><a id="wrglossary.579"></a><a href="#glo:GlsSetXdyNumberGroupOrder"><code class="csfmt">\GlsSetXdyNumberGroupOrder</code></a>{<span class="meta">〈<em class="metainner">spec</em>〉</span>}</code> to indicate where the number <a id="wrglossary.580"></a><a href="#glo:idx.group">group</a> should be placed (see §<a href="#sec:xindy">14</a>).<p>
+<li><span class="numitem">2.</span>Add <a id="wrglossary.581"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> to your <a id="wrglossary.582"></a><a href="#glo:idx.documentpreamble">preamble</a> (before you start defining your entries, as described in §<a href="#sec:newglosentry">4</a>).<p>
+<li><span class="numitem">3.</span>Run LaTeX on your document. This creates files with the extensions <a id="wrglossary.583"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.584"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> (for example, if your LaTeX document is called <span class="filefmt">myDoc.tex</span>, then you’ll have two extra files called <span class="filefmt">myDoc.glo</span> and <span class="filefmt">myDoc.xdy</span>). If you look at your document at this point, you won’t see the glossary as it hasn’t been created yet. (If you’re using the <a id="wrglossary.585"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, you’ll see the section header and some boilerplate text.)<p>
+If you have used package options such as <a id="wrglossary.586"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there will also be other sets of files corresponding to the extra glossaries that were created by those options.<p>
+<li><span class="numitem">4.</span>Run <a id="wrglossary.587"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.588"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the input file and the <a id="wrglossary.589"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> file as a module so that it creates an output file with the extension <a id="wrglossary.590"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>. You also need to set the language name and input <a id="wrglossary.591"></a><a href="#glo:idx.encoding">encoding</a>, as follows (all on one line): <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy <a id="wrglossary.592"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> english <a id="wrglossary.593"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> utf8 <a id="wrglossary.594"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.595"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> myDoc <a id="wrglossary.596"></a><a href="#glo:switch.xdy.t"><span class="shortargfmt">-t</span></a> myDoc.glg <a id="wrglossary.597"></a><a href="#glo:switch.xdy.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
+</pre> (Replace <code class="code">myDoc</code> with the base name of your LaTeX document file. Avoid spaces in the file name. If necessary, also replace <code class="code">english</code> with the name of your language and <code class="code">utf8</code> with your input <a id="wrglossary.598"></a><a href="#glo:idx.encoding">encoding</a>, for example, <code class="code"><a id="wrglossary.599"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> german <a id="wrglossary.600"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> din5007-utf8</code>.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The file extensions vary according to the glossary <a id="wrglossary.601"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>. See §<a href="#sec:xindyapp">1.6.3</a> for further details. <a id="wrglossary.602"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> must be called for each set of files. </div><!-- end of important -->
<p>
-It’s much simpler to use <a id="wrglossary.645"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.646"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeglossaries myDoc
-</pre> Note that the file extension isn’t supplied in this case. This will pick up all the file extensions from the <a id="wrglossary.647"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.648"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> the appropriate number of times with all the necessary switches.<p>
-There’s no benefit in using <a id="wrglossary.649"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> with <a id="wrglossary.650"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Remember that <a id="wrglossary.651"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is a Perl script so if you can use <a id="wrglossary.652"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then you can also use <a id="wrglossary.653"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, and if you don’t want to use <a id="wrglossary.654"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you don’t want to install Perl, then you can’t use <a id="wrglossary.655"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> either.) If you don’t know how to use the command prompt, then you can probably access <a id="wrglossary.656"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.657"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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>
-Again, a convenient method is to use <a id="wrglossary.658"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the follow comment lines to the start of your document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.659"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
+It’s much simpler to use <a id="wrglossary.603"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeglossaries myDoc
+</pre> Note that the file extension isn’t supplied in this case. This will pick up all the file extensions from the <a id="wrglossary.604"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.605"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> the appropriate number of times with all the necessary switches.<p>
+There’s no benefit in using <a id="wrglossary.606"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> with <a id="wrglossary.607"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Remember that <a id="wrglossary.608"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is a Perl script so if you can use <a id="wrglossary.609"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then you can also use <a id="wrglossary.610"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, and if you don’t want to use <a id="wrglossary.611"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you don’t want to install Perl, then you can’t use <a id="wrglossary.612"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> either.) If you don’t know how to use the command prompt, then you can probably access <a id="wrglossary.613"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.614"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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>
+Again, a convenient method is to use <a id="wrglossary.615"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the follow comment lines to the start of your document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
% arara: makeglossaries
% arara: pdflatex
</pre><p>
-The default sort is word order (<span class="qt">“sea lion”</span> comes before <span class="qt">“seal”</span>). If you want letter ordering you need to add the <a id="wrglossary.660"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span> package option: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.661"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.662"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>,<a id="wrglossary.663"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span>]{glossaries}
-</pre> (and return to the previous step). This option is picked up by <a id="wrglossary.664"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. If you are explicitly using <a id="wrglossary.665"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then you’ll need to add <code class="code"><a id="wrglossary.666"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to the options list. See §<a href="#sec:xindyapp">1.6.3</a> for further details on using <a id="wrglossary.667"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly.<p>
-<li><span class="numitem">5.</span>Once you have successfully completed the previous step, you can now run LaTeX on your document again. As with <a id="wrglossary.668"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.669"></a><a href="#glo:idx.opt.mkidx">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>
+The default sort is word order (<span class="qt">“sea lion”</span> comes before <span class="qt">“seal”</span>). If you want letter ordering you need to add the <a id="wrglossary.616"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span> package option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.617"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>,<a id="wrglossary.618"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span>]{glossaries}
+</pre> (and return to the previous step). This option is picked up by <a id="wrglossary.619"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. If you are explicitly using <a id="wrglossary.620"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then you’ll need to add <code class="code"><a id="wrglossary.621"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to the options list. See §<a href="#sec:xindyapp">1.6.3</a> for further details on using <a id="wrglossary.622"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly.<p>
+<li><span class="numitem">5.</span>Once you have successfully completed the previous step, you can now run LaTeX on your document again. As with <a id="wrglossary.623"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.624"></a><a href="#glo:idx.opt.mkidx">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>
</ol>
<p>
@@ -1371,280 +1378,280 @@
</section><!-- end of section option3 -->
<section id="option4"><!-- start of section option4 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.4. <a id="wrglossary.670"></a><dfn id="glo:idx.opt.b2g">Option 4 (<span class="appfmt">bib2gls</span>)</dfn><div class="labellink"><a href="#option4">[link]</a></div></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.4. <a id="wrglossary.625"></a><dfn id="glo:idx.opt.b2g">Option 4 (<span class="appfmt">bib2gls</span>)</dfn><div class="labellink"><a href="#option4">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.671"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-<a id="wrglossary.672"></a>This option is only available with the <a id="wrglossary.673"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package. This method uses <a id="wrglossary.674"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to both fetch <a id="wrglossary.675"></a><a href="#glo:idx.glossaryentry">entry</a> definitions from <a id="wrglossary.676"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files and to hierarchically sort and collate.<p>
-Example document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.677"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<strong class="strong"><a id="wrglossary.678"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a></strong>,<a id="wrglossary.679"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.680"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{<strong class="strong">glossaries-extra</strong>}
-<a id="wrglossary.681"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.682"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
+<div class="sidenote"><a id="wrglossary.626"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+<a id="wrglossary.627"></a>This option is only available with the <a id="wrglossary.628"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package. This method uses <a id="wrglossary.629"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to both fetch <a id="wrglossary.630"></a><a href="#glo:idx.glossaryentry">entry</a> definitions from <a id="wrglossary.631"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files and to hierarchically sort and collate.<p>
+Example document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<strong class="strong"><a id="wrglossary.632"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a></strong>,<a id="wrglossary.633"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.634"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{<strong class="strong">glossaries-extra</strong>}
+<a id="wrglossary.635"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.636"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
<span class="comment">% data in sample-entries.bib:</span>
-<strong class="strong"><a id="wrglossary.683"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a></strong>[<a id="wrglossary.684"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-entries}</span>]
+<strong class="strong"><a id="wrglossary.637"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a></strong>[<a id="wrglossary.638"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-entries}</span>]
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.685"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.686"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.687"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.688"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.689"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.690"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.691"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
+<a id="wrglossary.639"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.640"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.641"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.642"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.643"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.644"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.645"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
<code class="cend">\end{document}</code>
-</pre> Note that the <a id="wrglossary.692"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> must be set before <a id="wrglossary.693"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>. The file <span class="filefmt">sample-entries.bib</span> contains: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.694"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{parrot,
- <a id="wrglossary.695"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.696"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>
+</pre> Note that the <a id="wrglossary.646"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> must be set before <a id="wrglossary.647"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>. The file <span class="filefmt">sample-entries.bib</span> contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{parrot,
+ <a id="wrglossary.648"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.649"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>
}
<code class="code">@entry</code>{duck,
- <a id="wrglossary.697"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.698"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>
+ <a id="wrglossary.650"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.651"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>
}
<code class="code">@entry</code>{puffin,
- <a id="wrglossary.699"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.700"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>
+ <a id="wrglossary.652"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.653"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>
}
<code class="code">@entry</code>{penguin,
- <a id="wrglossary.701"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.702"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>
+ <a id="wrglossary.654"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.655"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>
}
<code class="code">@symbol</code>{alpha,
- <a id="wrglossary.703"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.704"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.705"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <a id="wrglossary.706"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
+ <a id="wrglossary.656"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.657"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.658"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <a id="wrglossary.659"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
}
<code class="code">@abbreviation</code>{arpanet,
- <a id="wrglossary.707"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={ARPANET}</span>,
- <a id="wrglossary.708"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={Advanced Research Projects Agency Network}</span>
+ <a id="wrglossary.660"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={ARPANET}</span>,
+ <a id="wrglossary.661"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={Advanced Research Projects Agency Network}</span>
}
-</pre> The result is slightly different from the previous examples. Letter groups aren’t created by default with <a id="wrglossary.709"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> so, even though the <a id="wrglossary.710"></a><a href="#glo:idx.glossarystyle">glossary style</a> supports <a id="wrglossary.711"></a><a href="#glo:idx.group">letter groups</a>, there’s no <a id="wrglossary.712"></a><a href="#glo:idx.group">group</a> information. <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.713"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:b2g"></a>Example 6: Simple document that uses <span class="appfmt">bib2gls</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example006.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example006.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+</pre> The result is slightly different from the previous examples. Letter groups aren’t created by default with <a id="wrglossary.662"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> so, even though the <a id="wrglossary.663"></a><a href="#glo:idx.glossarystyle">glossary style</a> supports <a id="wrglossary.664"></a><a href="#glo:idx.group">letter groups</a>, there’s no <a id="wrglossary.665"></a><a href="#glo:idx.group">group</a> information. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:b2g"></a>Example 6: Simple document that uses <span class="appfmt">bib2gls</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example006.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example006.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
<object data="glossaries-user-examples/glossaries-user-example006.png" type="image/png" width="391" height="151">Example document that defines some entries, references a subset of them in the document and displays a sorted list of the referenced entries: alpha, ARPANET, duck, parrot and puffin. There are no letter groups.</object> </div><!-- end of resultbox -->
<p>
-All entries must be provided in one or more <a id="wrglossary.714"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. (See the <a id="wrglossary.715"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for the required format.) In this example, the terms <span class="qt">“parrot”</span>, <span class="qt">“duck”</span>, <span class="qt">“puffin”</span> and <span class="qt">“penguin”</span> are defined using <code class="code">@atentry</code>, the symbol alpha (\(𝛼\)) is defined using <code class="code">@symbol</code> and the <a id="wrglossary.716"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a> <span class="qt">“ARPANET”</span> is defined using <code class="code">@abbreviation</code>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.717"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that the <a id="wrglossary.718"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key should not be used. Each entry type (<code class="code">@entry</code>, <code class="code">@symbol</code>, <code class="code">@abbreviation</code>) has a particular field that’s used for the sort value by default (<a id="wrglossary.719"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, the label, <a id="wrglossary.720"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>). You will break this mechanism if you explicitly use the <a id="wrglossary.721"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a> for examples. </div><!-- end of important -->
+All entries must be provided in one or more <a id="wrglossary.666"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. (See the <a id="wrglossary.667"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for the required format.) In this example, the terms <span class="qt">“parrot”</span>, <span class="qt">“duck”</span>, <span class="qt">“puffin”</span> and <span class="qt">“penguin”</span> are defined using <code class="code">@atentry</code>, the symbol alpha (\(𝛼\)) is defined using <code class="code">@symbol</code> and the <a id="wrglossary.668"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a> <span class="qt">“ARPANET”</span> is defined using <code class="code">@abbreviation</code>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that the <a id="wrglossary.669"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key should not be used. Each entry type (<code class="code">@entry</code>, <code class="code">@symbol</code>, <code class="code">@abbreviation</code>) has a particular field that’s used for the sort value by default (<a id="wrglossary.670"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, the label, <a id="wrglossary.671"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>). You will break this mechanism if you explicitly use the <a id="wrglossary.672"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a> for examples. </div><!-- end of important -->
<p>
-The <a id="wrglossary.722"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package needs to be loaded with the <a id="wrglossary.723"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.724"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.725"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
-</pre> or (equivalently) <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.726"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.727"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span>]{glossaries-extra}
-</pre> or (with <a id="wrglossary.728"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+ and <a id="wrglossary.729"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.730"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.731"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>]{glossaries-extra}
-</pre> The <a id="wrglossary.732"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span> option is the best method if you are using <a id="wrglossary.733"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>.<p>
-Each resource set is loaded with <a id="wrglossary.734"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.735"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.736"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>
+The <a id="wrglossary.673"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package needs to be loaded with the <a id="wrglossary.674"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.675"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
+</pre> or (equivalently) <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.676"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span>]{glossaries-extra}
+</pre> or (with <a id="wrglossary.677"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+ and <a id="wrglossary.678"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+): <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.679"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>]{glossaries-extra}
+</pre> The <a id="wrglossary.680"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span> option is the best method if you are using <a id="wrglossary.681"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>.<p>
+Each resource set is loaded with <a id="wrglossary.682"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.683"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>
[<span class="comment">% definitions in entries1.bib and entries2.bib:</span>
- <a id="wrglossary.737"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={entries1,entries2}</span>,
- <a id="wrglossary.738"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">={de-CH-1996}</span><span class="comment">% sort according to this locale</span>
+ <a id="wrglossary.684"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={entries1,entries2}</span>,
+ <a id="wrglossary.685"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">={de-CH-1996}</span><span class="comment">% sort according to this locale</span>
]
-</pre> The <a id="wrglossary.739"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files are identified as a comma-separated list in the value of the <a id="wrglossary.740"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a> key. The <a id="wrglossary.741"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></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 <a id="wrglossary.742"></a><a href="#glo:dual.glossary">glossaries</a> or one <a id="wrglossary.743"></a><a href="#glo:dual.glossary">glossary</a> may be split across multiple resource sets, forming logical sub-blocks.<p>
-If you want to ensure that all entries are selected, even if they haven’t been referenced in the document, then add the option <a id="wrglossary.744"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a><span class="optfmt">=all</span>. (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 id="wrglossary.745"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.)<p>
-The <a id="wrglossary.746"></a><a href="#glo:dual.glossary">glossary</a> is displayed using: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.747"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.748"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
-</pre> Alternatively all glossaries can be displayed using the iterative command: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.749"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.750"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
-</pre> The document is built using: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.751"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
+</pre> The <a id="wrglossary.686"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files are identified as a comma-separated list in the value of the <a id="wrglossary.687"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a> key. The <a id="wrglossary.688"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></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 <a id="wrglossary.689"></a><a href="#glo:dual.glossary">glossaries</a> or one <a id="wrglossary.690"></a><a href="#glo:dual.glossary">glossary</a> may be split across multiple resource sets, forming logical sub-blocks.<p>
+If you want to ensure that all entries are selected, even if they haven’t been referenced in the document, then add the option <a id="wrglossary.691"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a><span class="optfmt">=all</span>. (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 id="wrglossary.692"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.)<p>
+The <a id="wrglossary.693"></a><a href="#glo:dual.glossary">glossary</a> is displayed using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.694"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+</pre> Alternatively all glossaries can be displayed using the iterative command: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.695"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
+</pre> The document is built using: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
bib2gls myDoc
pdflatex myDoc
-</pre> If <a id="wrglossary.752"></a><a href="#glo:idx.group">letter groups</a> are required, you need the <a id="wrglossary.753"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.754"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>bib2gls <a id="wrglossary.755"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
-</pre> or with <a id="wrglossary.756"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.757"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls: { group: on }
-</pre> (You will also need an appropriate <a id="wrglossary.758"></a><a href="#glo:idx.glossarystyle">glossary style</a>.)<p>
-Unlike Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, this method doesn’t create a file containing the typeset <a id="wrglossary.759"></a><a href="#glo:dual.glossary">glossary</a> but simply determines which entries are needed for the document, their associated locations and (if required) their associated <a id="wrglossary.760"></a><a href="#glo:idx.group">letter group</a>. This option allows a mixture of sort methods. For example, sorting by word order for one glossary and order of use for another or even sorting one block of the <a id="wrglossary.761"></a><a href="#glo:dual.glossary">glossary</a> differently to another block in the same <a id="wrglossary.762"></a><a href="#glo:dual.glossary">glossary</a>. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a>.<p>
-This method supports Unicode and uses the Common Locale Data Repository, which provides more extensive language support than <a id="wrglossary.763"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Except for Klingon, which is supported by <a id="wrglossary.764"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, but not by the CLDR.) The locations in the <a id="wrglossary.765"></a><a href="#glo:locationlist">number list</a> may be in any format. If <a id="wrglossary.766"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can deduce a numerical value it will attempt to form <a id="wrglossary.767"></a><a href="#glo:idx.range">ranges</a> otherwise it will simply list the <a id="wrglossary.768"></a><a href="#glo:@@glslabel at entrylocation">locations</a>.<p>
+</pre> If <a id="wrglossary.696"></a><a href="#glo:idx.group">letter groups</a> are required, you need the <a id="wrglossary.697"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>bib2gls <a id="wrglossary.698"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
+</pre> or with <a id="wrglossary.699"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls: { group: on }
+</pre> (You will also need an appropriate <a id="wrglossary.700"></a><a href="#glo:idx.glossarystyle">glossary style</a>.)<p>
+Unlike Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, this method doesn’t create a file containing the typeset <a id="wrglossary.701"></a><a href="#glo:dual.glossary">glossary</a> but simply determines which entries are needed for the document, their associated locations and (if required) their associated <a id="wrglossary.702"></a><a href="#glo:idx.group">letter group</a>. This option allows a mixture of sort methods. For example, sorting by word order for one glossary and order of use for another or even sorting one block of the <a id="wrglossary.703"></a><a href="#glo:dual.glossary">glossary</a> differently to another block in the same <a id="wrglossary.704"></a><a href="#glo:dual.glossary">glossary</a>. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a>.<p>
+This method supports Unicode and uses the Common Locale Data Repository, which provides more extensive language support than <a id="wrglossary.705"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Except for Klingon, which is supported by <a id="wrglossary.706"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, but not by the CLDR.) The locations in the <a id="wrglossary.707"></a><a href="#glo:locationlist">number list</a> may be in any format. If <a id="wrglossary.708"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can deduce a numerical value it will attempt to form <a id="wrglossary.709"></a><a href="#glo:idx.range">ranges</a> otherwise it will simply list the <a id="wrglossary.710"></a><a href="#glo:@@glslabel at entrylocation">locations</a>.<p>
Summary:
<ol class="displaylist">
- <li><span class="numitem">1.</span>Use <a id="wrglossary.769"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> with the <a id="wrglossary.770"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.771"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.772"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
+ <li><span class="numitem">1.</span>Use <a id="wrglossary.711"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> with the <a id="wrglossary.712"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.713"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
</pre><p>
-<li><span class="numitem">2.</span>Use <a id="wrglossary.773"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> to identify the <a id="wrglossary.774"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file(s) and <a id="wrglossary.775"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> options. The <a id="wrglossary.776"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> extension may be omitted: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.777"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.778"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.779"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms.bib,abbreviations.bib}</span>,<a id="wrglossary.780"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en</span>]
+<li><span class="numitem">2.</span>Use <a id="wrglossary.714"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> to identify the <a id="wrglossary.715"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file(s) and <a id="wrglossary.716"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> options. The <a id="wrglossary.717"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> extension may be omitted: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.718"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.719"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms.bib,abbreviations.bib}</span>,<a id="wrglossary.720"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en</span>]
</pre><p>
-<li><span class="numitem">3.</span>Put <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.781"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.782"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
-</pre> where you want your list of entries to appear. Alternatively to display all glossaries use the iterative command: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.783"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.784"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
+<li><span class="numitem">3.</span>Put <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.721"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+</pre> where you want your list of entries to appear. Alternatively to display all glossaries use the iterative command: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.722"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
</pre><p>
<li><span class="numitem">4.</span>Run LaTeX on your document.<p>
-<li><span class="numitem">5.</span>Run <a id="wrglossary.785"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with just the document base name.<p>
+<li><span class="numitem">5.</span>Run <a id="wrglossary.723"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with just the document base name.<p>
<li><span class="numitem">6.</span>Run LaTeX on your document.<p>
</ol>
<p>
-See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.786"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></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>.<p>
+See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.724"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></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>.<p>
</section><!-- end of section option4 -->
<section id="option5"><!-- start of section option5 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.5. <a id="wrglossary.787"></a><dfn id="glo:idx.opt.unsrt">Option 5 (<span class="qt">“unsrt”</span>)</dfn><div class="labellink"><a href="#option5">[link]</a></div></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.5. <a id="wrglossary.725"></a><dfn id="glo:idx.opt.unsrt">Option 5 (<span class="qt">“unsrt”</span>)</dfn><div class="labellink"><a href="#option5">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.788"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-This option is only available with the extension package <a id="wrglossary.789"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. No <a id="wrglossary.790"></a><a href="#glo:dual.indexingapp">indexing application</a> is required. <p>
-Example document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.791"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.792"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.793"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries-extra}
-<a id="wrglossary.794"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.795"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.796"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.797"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.798"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.799"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.800"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.801"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.802"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.803"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.804"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.805"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+<div class="sidenote"><a id="wrglossary.726"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+This option is only available with the extension package <a id="wrglossary.727"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. No <a id="wrglossary.728"></a><a href="#glo:dual.indexingapp">indexing application</a> is required. <p>
+Example document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.729"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.730"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries-extra}
+<a id="wrglossary.731"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.732"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.733"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.734"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.735"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.736"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.737"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.738"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.739"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.740"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.741"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.742"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.806"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.807"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.808"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.809"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <a id="wrglossary.810"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.811"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a>:</span>
-<a id="wrglossary.812"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.813"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
-<a id="wrglossary.814"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.743"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.744"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.745"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.746"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <a id="wrglossary.747"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.748"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a>:</span>
+<a id="wrglossary.749"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.750"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
+<a id="wrglossary.751"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.815"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.816"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.817"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.818"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.819"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.820"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.821"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
+<a id="wrglossary.752"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.753"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.754"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.755"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.756"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.757"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.758"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
<code class="cend">\end{document}</code>
-</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.822"></a><a href="#glo:idx.documentpreamble">preamble</a> with <a id="wrglossary.823"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>. There’s no <span class="qt">“activation”</span> command (such as <a id="wrglossary.824"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>). <p>
-The result is different from the previous examples. Now all entries are listed in the <a id="wrglossary.825"></a><a href="#glo:dual.glossary">glossary</a>, including <span class="qt">“penguin”</span> which hasn’t been referenced in the document, and the list is in the order that the entries were defined. There are no <a id="wrglossary.826"></a><a href="#glo:locationlist">number lists</a>. <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.827"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:unsrt"></a>Example 7: Simple document with an unsorted list of all defined entries <a href="glossaries-user-examples/glossaries-user-example007.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example007.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
-<object data="glossaries-user-examples/glossaries-user-example007.png" type="image/png" width="391" height="293">Example document that defines some entries, references a subset of them in the document and displays an unsorted list of the defined entries: parrot, duck, puffin, penguin, alpha and ARPANET. There are four letter groups with a repeated letter: P, D, P, A.</object> </div><!-- end of resultbox -->
- Note that the letter groups are fragmented because the list isn’t in alphabetical order, so there are two <span class="qt">“P”</span> letter groups.<p>
-The <a id="wrglossary.828"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> command simply iterates over the set of all defined entries associated with the given <a id="wrglossary.829"></a><a href="#glo:dual.glossary">glossary</a> and lists them in the order of definition. This means that child entries must be defined immediately after their parent entry if they must be kept together in the glossary. Some <a id="wrglossary.830"></a><a href="#glo:idx.glossarystyle">glossary styles</a> indent entries that have a parent but it’s the <a id="wrglossary.831"></a><a href="#glo:dual.indexingapp">indexing application</a> that ensures the child entries are listed immediately after the parent. If you’re opting to use this manual approach then it’s your responsibility to define the entries in the correct order.<p>
-The <a id="wrglossary.832"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package requires entries to be defined in the <a id="wrglossary.833"></a><a href="#glo:idx.documentpreamble">preamble</a> by default. It’s possible to remove this restriction, but bear in mind that any entries defined after <a id="wrglossary.834"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> won’t be listed.<p>
-The <a id="wrglossary.835"></a><a href="#glo:dual.glossary">glossary</a> is displayed using: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.836"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.837"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
-</pre> Alternatively all glossaries can be displayed using the iterative command: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.838"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.839"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
+</pre> You can place all your entry definitions in a separate file and load it in the <a id="wrglossary.759"></a><a href="#glo:idx.documentpreamble">preamble</a> with <a id="wrglossary.760"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>. There’s no <span class="qt">“activation”</span> command (such as <a id="wrglossary.761"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>). <p>
+The result is different from the previous examples. Now all entries are listed in the <a id="wrglossary.762"></a><a href="#glo:dual.glossary">glossary</a>, including <span class="qt">“penguin”</span> which hasn’t been referenced in the document, and the list is in the order that the entries were defined. There are no <a id="wrglossary.763"></a><a href="#glo:locationlist">number lists</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:unsrt"></a>Example 7: Simple document with an unsorted list of all defined entries <a href="glossaries-user-examples/glossaries-user-example007.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example007.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+<object data="glossaries-user-examples/glossaries-user-example007.png" type="image/png">Example document that defines some entries, references a subset of them in the document and displays an unsorted list of the defined entries: parrot, duck, puffin, penguin, alpha and ARPANET. There are four letter groups with a repeated letter: P, D, P, A.</object> </div><!-- end of resultbox -->
+ Note that the letter groups are fragmented because the list isn’t in alphabetical order, so there are two <span class="qt">“P”</span> letter groups.<p>
+The <a id="wrglossary.764"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> command simply iterates over the set of all defined entries associated with the given <a id="wrglossary.765"></a><a href="#glo:dual.glossary">glossary</a> and lists them in the order of definition. This means that child entries must be defined immediately after their parent entry if they must be kept together in the glossary. Some <a id="wrglossary.766"></a><a href="#glo:idx.glossarystyle">glossary styles</a> indent entries that have a parent but it’s the <a id="wrglossary.767"></a><a href="#glo:dual.indexingapp">indexing application</a> that ensures the child entries are listed immediately after the parent. If you’re opting to use this manual approach then it’s your responsibility to define the entries in the correct order.<p>
+The <a id="wrglossary.768"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package requires entries to be defined in the <a id="wrglossary.769"></a><a href="#glo:idx.documentpreamble">preamble</a> by default. It’s possible to remove this restriction, but bear in mind that any entries defined after <a id="wrglossary.770"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> won’t be listed.<p>
+The <a id="wrglossary.771"></a><a href="#glo:dual.glossary">glossary</a> is displayed using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.772"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+</pre> Alternatively all glossaries can be displayed using the iterative command: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.773"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
</pre><p>
-This method will display <span style="font-style: italic; font-variant: normal; ">all</span> defined entries, regardless of whether or not they have been used in the document. Note that this uses the same command for displaying the <a id="wrglossary.840"></a><a href="#glo:dual.glossary">glossary</a> as <a id="wrglossary.841"></a><a href="#glo:idx.opt.b2g">Option 4</a>. This is because <a id="wrglossary.842"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> takes advantage of this method by defining the wanted entries in the required order and setting the locations (and <a id="wrglossary.843"></a><a href="#glo:idx.group">letter group</a> information, if required). See the <a id="wrglossary.844"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
-Therefore, the above example document has a glossary containing the entries: parrot, duck, puffin, penguin, \(𝛼\) and ARPANET (in that order). Note that the <span class="qt">“penguin”</span> entry has been included even though it wasn’t referenced in the document.<p>
-This just requires a single LaTeX call: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.845"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
-</pre> unless the glossary needs to appear in the table of contents, in which case a second run is required: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.846"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
+This method will display <span style="font-style: italic; font-variant: normal; ">all</span> defined entries, regardless of whether or not they have been used in the document. Note that this uses the same command for displaying the <a id="wrglossary.774"></a><a href="#glo:dual.glossary">glossary</a> as <a id="wrglossary.775"></a><a href="#glo:idx.opt.b2g">Option 4</a>. This is because <a id="wrglossary.776"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> takes advantage of this method by defining the wanted entries in the required order and setting the locations (and <a id="wrglossary.777"></a><a href="#glo:idx.group">letter group</a> information, if required). See the <a id="wrglossary.778"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
+Therefore, the above example document has a glossary containing the entries: parrot, duck, puffin, penguin, \(𝛼\) and ARPANET (in that order). Note that the <span class="qt">“penguin”</span> entry has been included even though it wasn’t referenced in the document.<p>
+This just requires a single LaTeX call: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
+</pre> unless the glossary needs to appear in the table of contents, in which case a second run is required: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
pdflatex myDoc
</pre> (Naturally if the document also contains citations, and so on, then additional steps are required. Similarly for all the other options above.)<p>
-See the <a id="wrglossary.847"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details of this method.<p>
+See the <a id="wrglossary.779"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details of this method.<p>
</section><!-- end of section option5 -->
<section id="option6"><!-- start of section option6 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.6. <a id="wrglossary.848"></a><dfn id="glo:idx.opt.standalone">Option 6 (<span class="qt">“standalone”</span>)</dfn><div class="labellink"><a href="#option6">[link]</a></div></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.6. <a id="wrglossary.780"></a><dfn id="glo:idx.opt.standalone">Option 6 (<span class="qt">“standalone”</span>)</dfn><div class="labellink"><a href="#option6">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.849"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-This option is only available with the <a id="wrglossary.850"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package. (You can just use the base <a id="wrglossary.851"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for the first case, but it’s less convenient. You’d have to manually insert the entry target before the sectioning command and use <code class="code"><a id="wrglossary.852"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or <code class="code"><a id="wrglossary.853"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> to display the entry name.) 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>
-You can either define entries in the <a id="wrglossary.854"></a><a href="#glo:idx.documentpreamble">preamble</a> (or in an external file loaded with <a id="wrglossary.855"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>), as with <a id="wrglossary.856"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, for example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.857"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<div class="sidenote"><a id="wrglossary.781"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+This option is only available with the <a id="wrglossary.782"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package. (You can just use the base <a id="wrglossary.783"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for the first case, but it’s less convenient. You’d have to manually insert the entry target before the sectioning command and use <code class="code"><a id="wrglossary.784"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or <code class="code"><a id="wrglossary.785"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> to display the entry name.) 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>
+You can either define entries in the <a id="wrglossary.786"></a><a href="#glo:idx.documentpreamble">preamble</a> (or in an external file loaded with <a id="wrglossary.787"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>), as with <a id="wrglossary.788"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, for example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.858"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span>,
- <a id="wrglossary.859"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.789"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span>,
+ <a id="wrglossary.790"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
]{glossaries-extra}
-<a id="wrglossary.860"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.861"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
- <a id="wrglossary.862"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
- <a id="wrglossary.863"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.864"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
+<a id="wrglossary.791"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.792"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
+ <a id="wrglossary.793"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
+ <a id="wrglossary.794"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.795"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
}
-<a id="wrglossary.865"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{function}{<a id="wrglossary.866"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
- <a id="wrglossary.867"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the domain <a id="wrglossary.868"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.869"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
- <a id="wrglossary.870"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.871"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
+<a id="wrglossary.796"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{function}{<a id="wrglossary.797"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
+ <a id="wrglossary.798"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the domain <a id="wrglossary.799"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.800"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
+ <a id="wrglossary.801"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.802"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
}
<code class="cmd">\newcommand</code>*{<code class="cmd">\termdef</code>}[1]{<span class="comment">% </span>
- <a id="wrglossary.872"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.873"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <a id="wrglossary.874"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{#1}}<span class="comment">% </span>
- <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.875"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
+ <a id="wrglossary.803"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.804"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <a id="wrglossary.805"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{#1}}<span class="comment">% </span>
+ <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.806"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
}
<code class="cbeg">\begin{document}</code>
<code class="cmd">\tableofcontents</code>
-<a id="wrglossary.876"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
-Sample document about <a id="wrglossary.877"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.878"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
+<a id="wrglossary.807"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
+Sample document about <a id="wrglossary.808"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.809"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
<code class="cmd">\termdef</code>{set}
-More detailed information about <a id="wrglossary.879"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
+More detailed information about <a id="wrglossary.810"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
<code class="cmd">\termdef</code>{function}
-More detailed information about <a id="wrglossary.880"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
+More detailed information about <a id="wrglossary.811"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
<code class="cend">\end{document}</code>
-</pre> This allows the references to <a id="wrglossary.881"></a><a href="#glo:idx.hyperlink">hyperlink</a> to the standalone definitions rather than to a <a id="wrglossary.882"></a><a href="#glo:dual.glossary">glossary</a>. <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.883"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
-<a id="ex:standalone"></a>Example 8: Simple document with standalone entries <a href="glossaries-user-examples/glossaries-user-example008.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example008.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
+</pre> This allows the references to <a id="wrglossary.812"></a><a href="#glo:idx.hyperlink">hyperlink</a> to the standalone definitions rather than to a <a id="wrglossary.813"></a><a href="#glo:dual.glossary">glossary</a>. <div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
+<a id="ex:standalone"></a>Example 8: Simple document with standalone entries <a href="glossaries-user-examples/glossaries-user-example008.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example008.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a><p>
<object data="glossaries-user-examples/glossaries-user-example008.png" type="image/png" width="388" height="362">Example document that defines entries and displays them in the document..</object> </div><!-- end of resultbox -->
<p>
-Or you can use <a id="wrglossary.884"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if you want to manage a large database of terms. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.885"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+Or you can use <a id="wrglossary.814"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if you want to manage a large database of terms. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.886"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>,
- <a id="wrglossary.887"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.815"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>,
+ <a id="wrglossary.816"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
]{glossaries-extra}
-<a id="wrglossary.888"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.889"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<a id="wrglossary.890"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.891"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>]
+<a id="wrglossary.817"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.818"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<a id="wrglossary.819"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.820"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>]
<code class="cmd">\newcommand</code>*{<code class="cmd">\termdef</code>}[1]{<span class="comment">% </span>
- <a id="wrglossary.892"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.893"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <strong class="strong"><a id="wrglossary.894"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a></strong>{#1}}<span class="comment">% </span>
- <a id="wrglossary.895"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{#1}<span class="comment">% <- index this entry</span>
- <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.896"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
+ <a id="wrglossary.821"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.822"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <strong class="strong"><a id="wrglossary.823"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a></strong>{#1}}<span class="comment">% </span>
+ <a id="wrglossary.824"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{#1}<span class="comment">% <- index this entry</span>
+ <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.825"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
}
<code class="cbeg">\begin{document}</code>
<code class="cmd">\tableofcontents</code>
-<a id="wrglossary.897"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
-Sample document about <a id="wrglossary.898"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.899"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
+<a id="wrglossary.826"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
+Sample document about <a id="wrglossary.827"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.828"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
<code class="cmd">\termdef</code>{set}
-More detailed information about <a id="wrglossary.900"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
+More detailed information about <a id="wrglossary.829"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
<code class="cmd">\termdef</code>{function}
-More detailed information about <a id="wrglossary.901"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
+More detailed information about <a id="wrglossary.830"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
<code class="cend">\end{document}</code>
-</pre> Where the file <span class="filefmt">terms.bib</span> contains: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.902"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{set,
- <a id="wrglossary.903"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
- <a id="wrglossary.904"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
- <a id="wrglossary.905"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.906"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
+</pre> Where the file <span class="filefmt">terms.bib</span> contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{set,
+ <a id="wrglossary.831"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
+ <a id="wrglossary.832"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
+ <a id="wrglossary.833"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.834"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
}
<code class="code">@entry</code>{function,
- <a id="wrglossary.907"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
- <a id="wrglossary.908"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the domain <a id="wrglossary.909"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.910"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
- <a id="wrglossary.911"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.912"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
+ <a id="wrglossary.835"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
+ <a id="wrglossary.836"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the domain <a id="wrglossary.837"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.838"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
+ <a id="wrglossary.839"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.840"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
}
-</pre> The advantage in this approach (with <a id="wrglossary.913"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> or <a id="wrglossary.914"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) is that you can use an existing database of entries shared across multiple documents, ensuring consistent notation for all of them.<p>
-In both cases, there’s no need to load all the <a id="wrglossary.915"></a><a href="#glo:idx.glossarystyle">glossary styles</a> packages, as they’re not required, so I’ve used the <a id="wrglossary.916"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> package option to prevent them from being loaded.<p>
-In the first case, you just need to define the terms (preferably in the <a id="wrglossary.917"></a><a href="#glo:idx.documentpreamble">preamble</a> or in a file that’s input in the <a id="wrglossary.918"></a><a href="#glo:idx.documentpreamble">preamble</a>). No external tool is required. Just run LaTeX as normal. (Twice to ensure that the table of contents is up to date.) <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.919"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
+</pre> The advantage in this approach (with <a id="wrglossary.841"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> or <a id="wrglossary.842"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) is that you can use an existing database of entries shared across multiple documents, ensuring consistent notation for all of them.<p>
+In both cases, there’s no need to load all the <a id="wrglossary.843"></a><a href="#glo:idx.glossarystyle">glossary styles</a> packages, as they’re not required, so I’ve used the <a id="wrglossary.844"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> package option to prevent them from being loaded.<p>
+In the first case, you just need to define the terms (preferably in the <a id="wrglossary.845"></a><a href="#glo:idx.documentpreamble">preamble</a> or in a file that’s input in the <a id="wrglossary.846"></a><a href="#glo:idx.documentpreamble">preamble</a>). No external tool is required. Just run LaTeX as normal. (Twice to ensure that the table of contents is up to date.) <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
pdflatex myDoc
</pre><p>
-In the second case, you need the <a id="wrglossary.920"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option (as in <a id="wrglossary.921"></a><a href="#glo:idx.opt.b2g">Option 4</a>) since <a id="wrglossary.922"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is needed to select the required entries, but you don’t need a sorted list: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.923"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.924"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.925"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<strong class="strong"><a id="wrglossary.926"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span></strong>]
-</pre> This will ensure that any entries <a id="wrglossary.927"></a><a href="#glo:@@glslabel at indexing">indexed</a> in the document (through commands like <a id="wrglossary.928"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.929"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) will be selected by <a id="wrglossary.930"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, but it will skip the sorting step. (The chances are you probably also won’t need <a id="wrglossary.931"></a><a href="#glo:dual.locationlist">location lists</a> either. If so, you can add the option <a id="wrglossary.932"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>.)<p>
-Remember that for this second case you need to run <a id="wrglossary.933"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as per <a id="wrglossary.934"></a><a href="#glo:idx.opt.b2g">Option 4</a>: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.935"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
+In the second case, you need the <a id="wrglossary.847"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option (as in <a id="wrglossary.848"></a><a href="#glo:idx.opt.b2g">Option 4</a>) since <a id="wrglossary.849"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is needed to select the required entries, but you don’t need a sorted list: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.850"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.851"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<strong class="strong"><a id="wrglossary.852"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span></strong>]
+</pre> This will ensure that any entries <a id="wrglossary.853"></a><a href="#glo:@@glslabel at indexing">indexed</a> in the document (through commands like <a id="wrglossary.854"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.855"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) will be selected by <a id="wrglossary.856"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, but it will skip the sorting step. (The chances are you probably also won’t need <a id="wrglossary.857"></a><a href="#glo:dual.locationlist">location lists</a> either. If so, you can add the option <a id="wrglossary.858"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>.)<p>
+Remember that for this second case you need to run <a id="wrglossary.859"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as per <a id="wrglossary.860"></a><a href="#glo:idx.opt.b2g">Option 4</a>: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
bib2gls myDoc
pdflatex myDoc
pdflatex myDoc
</pre><p>
-For both cases (with or without <a id="wrglossary.936"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>), instead of listing all the entries using <a id="wrglossary.937"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>, you use <code class="code"><a id="wrglossary.938"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> where you want the name (and anchor with <a id="wrglossary.939"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>) to appear in the document. This will allow the <a id="wrglossary.940"></a><a href="#glo:dual.linktext">link text</a> created by commands like <a id="wrglossary.941"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to link to that point in the document. The description can simply be displayed with <code class="code"><a id="wrglossary.942"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or <code class="code"><a id="wrglossary.943"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{label}</code>, as in the above examples. In both examples, I’ve defined a custom command <code class="csfmt">\termdef</code> 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>
-(Instead of using <a id="wrglossary.944"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a> or <a id="wrglossary.945"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>, you can use <code class="code"><a id="wrglossary.946"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>, which will obey <a id="wrglossary.947"></a><a href="#glo:idx.categoryattribute">category attributes</a> such as <a id="wrglossary.948"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> and <a id="wrglossary.949"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a>. See the <a id="wrglossary.950"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.)<p>
-The symbol (if required) can be displayed with either <code class="code"><a id="wrglossary.951"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or <code class="code"><a id="wrglossary.952"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>. In the first example, I’ve used <a id="wrglossary.953"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>. In the second I’ve used <a id="wrglossary.954"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>. The latter is necessary with <a id="wrglossary.955"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if the symbol needs to go in a section title as the entries aren’t defined on the first LaTeX run.<p>
-In normal document text, <a id="wrglossary.956"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a> 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 <a id="wrglossary.957"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which triggers an error. <p>
-The <a id="wrglossary.958"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> command performs an existence check, which triggers a warning if the entry is undefined. (All entries will be undefined before the first <a id="wrglossary.959"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call.) You need at least <a id="wrglossary.960"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42 to use this command in a section title. (<a id="wrglossary.961"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> is defined by the base <a id="wrglossary.962"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but is redefined by <a id="wrglossary.963"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.) If <a id="wrglossary.964"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, this will use <a id="wrglossary.965"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> to allow a simple expansion for the <a id="wrglossary.966"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a> (see the <a id="wrglossary.967"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details).<p>
-If you want to test if the <a id="wrglossary.968"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field has been set, you need to use <a id="wrglossary.969"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a> outside of the section title. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.970"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.971"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a>{#1}<span class="comment">% </span>
-{<a id="wrglossary.972"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.973"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <a id="wrglossary.974"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{#1}}}
-{<a id="wrglossary.975"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.976"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1}}}
+For both cases (with or without <a id="wrglossary.861"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>), instead of listing all the entries using <a id="wrglossary.862"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>, you use <code class="code"><a id="wrglossary.863"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> where you want the name (and anchor with <a id="wrglossary.864"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>) to appear in the document. This will allow the <a id="wrglossary.865"></a><a href="#glo:dual.linktext">link text</a> created by commands like <a id="wrglossary.866"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to link to that point in the document. The description can simply be displayed with <code class="code"><a id="wrglossary.867"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or <code class="code"><a id="wrglossary.868"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{label}</code>, as in the above examples. In both examples, I’ve defined a custom command <code class="csfmt">\termdef</code> 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>
+(Instead of using <a id="wrglossary.869"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a> or <a id="wrglossary.870"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>, you can use <code class="code"><a id="wrglossary.871"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>, which will obey <a id="wrglossary.872"></a><a href="#glo:idx.categoryattribute">category attributes</a> such as <a id="wrglossary.873"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> and <a id="wrglossary.874"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a>. See the <a id="wrglossary.875"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.)<p>
+The symbol (if required) can be displayed with either <code class="code"><a id="wrglossary.876"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or <code class="code"><a id="wrglossary.877"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>. In the first example, I’ve used <a id="wrglossary.878"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>. In the second I’ve used <a id="wrglossary.879"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>. The latter is necessary with <a id="wrglossary.880"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if the symbol needs to go in a section title as the entries aren’t defined on the first LaTeX run.<p>
+In normal document text, <a id="wrglossary.881"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a> 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 <a id="wrglossary.882"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which triggers an error. <p>
+The <a id="wrglossary.883"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> command performs an existence check, which triggers a warning if the entry is undefined. (All entries will be undefined before the first <a id="wrglossary.884"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call.) You need at least <a id="wrglossary.885"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42 to use this command in a section title. (<a id="wrglossary.886"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> is defined by the base <a id="wrglossary.887"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but is redefined by <a id="wrglossary.888"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.) If <a id="wrglossary.889"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, this will use <a id="wrglossary.890"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> to allow a simple expansion for the <a id="wrglossary.891"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a> (see the <a id="wrglossary.892"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details).<p>
+If you want to test if the <a id="wrglossary.893"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field has been set, you need to use <a id="wrglossary.894"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a> outside of the section title. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.895"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a>{#1}<span class="comment">% </span>
+{<a id="wrglossary.896"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.897"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <a id="wrglossary.898"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{#1}}}
+{<a id="wrglossary.899"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.900"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1}}}
</pre><p>
-In both of the above examples, the section titles start with a <a id="wrglossary.977"></a><a href="#glo:idx.lowercase">lowercase</a> character (because the <a id="wrglossary.978"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value is all <a id="wrglossary.979"></a><a href="#glo:idx.lowercase">lowercase</a> in entry definitions). You can apply automatic <a id="wrglossary.980"></a><a href="#glo:dual.casechange">case change</a> with the <a id="wrglossary.981"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a> <a id="wrglossary.982"></a><a href="#glo:idx.categoryattribute">category attribute</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.983"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.984"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.985"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.986"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{firstuc}
-</pre> or (for title-case) <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.987"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.988"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.989"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.990"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{title}
-</pre> However, this won’t apply the <a id="wrglossary.991"></a><a href="#glo:dual.casechange">case change</a> in the table of contents or bookmarks. Instead you can use helper commands provided by <a id="wrglossary.992"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ but make sure you have up-to-date versions of <a id="wrglossary.993"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.994"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>.<p>
-In the second example, you can instead use <a id="wrglossary.995"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to apply a <a id="wrglossary.996"></a><a href="#glo:dual.casechange">case change</a>. For example, to apply <a id="wrglossary.997"></a><a href="#glo:idx.sentencecase">sentence case</a> to the <a id="wrglossary.998"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.999"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1000"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.1001"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,
- <a id="wrglossary.1002"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.1003"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span><strong class="strong">,
- <a id="wrglossary.1004"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
- <a id="wrglossary.1005"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span></strong>
+In both of the above examples, the section titles start with a <a id="wrglossary.901"></a><a href="#glo:idx.lowercase">lowercase</a> character (because the <a id="wrglossary.902"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value is all <a id="wrglossary.903"></a><a href="#glo:idx.lowercase">lowercase</a> in entry definitions). You can apply automatic <a id="wrglossary.904"></a><a href="#glo:dual.casechange">case change</a> with the <a id="wrglossary.905"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a> <a id="wrglossary.906"></a><a href="#glo:idx.categoryattribute">category attribute</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.907"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.908"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.909"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{firstuc}
+</pre> or (for title-case) <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.910"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.911"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.912"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{title}
+</pre> However, this won’t apply the <a id="wrglossary.913"></a><a href="#glo:dual.casechange">case change</a> in the table of contents or bookmarks. Instead you can use helper commands provided by <a id="wrglossary.914"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ but make sure you have up-to-date versions of <a id="wrglossary.915"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.916"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>.<p>
+In the second example, you can instead use <a id="wrglossary.917"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to apply a <a id="wrglossary.918"></a><a href="#glo:dual.casechange">case change</a>. For example, to apply <a id="wrglossary.919"></a><a href="#glo:idx.sentencecase">sentence case</a> to the <a id="wrglossary.920"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.921"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.922"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,
+ <a id="wrglossary.923"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.924"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span><strong class="strong">,
+ <a id="wrglossary.925"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
+ <a id="wrglossary.926"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span></strong>
]
-</pre> (Or <a id="wrglossary.1006"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=title</span> for <a id="wrglossary.1007"></a><a href="#glo:idx.titlecase">title case</a>.) This copies the <a id="wrglossary.1008"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value to the <a id="wrglossary.1009"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field and then applies a <a id="wrglossary.1010"></a><a href="#glo:dual.casechange">case change</a> to the <a id="wrglossary.1011"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field (leaving the <a id="wrglossary.1012"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field unchanged). The name in the section titles now starts with a capital but the <a id="wrglossary.1013"></a><a href="#glo:dual.linktext">link text</a> produced by commands like <a id="wrglossary.1014"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> is still <a id="wrglossary.1015"></a><a href="#glo:idx.lowercase">lowercase</a>.<p>
-In the first example (without <a id="wrglossary.1016"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) you can do this manually. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1017"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1018"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.1019"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<strong class="strong">S</strong>et}</span>,<strong class="strong"><a id="wrglossary.1020"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a><span class="optfmt">={set}</span></strong>,
- <a id="wrglossary.1021"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
- <a id="wrglossary.1022"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.1023"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
+</pre> (Or <a id="wrglossary.927"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=title</span> for <a id="wrglossary.928"></a><a href="#glo:idx.titlecase">title case</a>.) This copies the <a id="wrglossary.929"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value to the <a id="wrglossary.930"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field and then applies a <a id="wrglossary.931"></a><a href="#glo:dual.casechange">case change</a> to the <a id="wrglossary.932"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field (leaving the <a id="wrglossary.933"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field unchanged). The name in the section titles now starts with a capital but the <a id="wrglossary.934"></a><a href="#glo:dual.linktext">link text</a> produced by commands like <a id="wrglossary.935"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> is still <a id="wrglossary.936"></a><a href="#glo:idx.lowercase">lowercase</a>.<p>
+In the first example (without <a id="wrglossary.937"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) you can do this manually. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.938"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.939"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<strong class="strong">S</strong>et}</span>,<strong class="strong"><a id="wrglossary.940"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a><span class="optfmt">={set}</span></strong>,
+ <a id="wrglossary.941"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
+ <a id="wrglossary.942"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.943"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
}
-</pre> A more automated solution can be obtained with the standalone helper commands for the <a id="wrglossary.1024"></a><a href="#glo:idx.PDFbookmark">PDF bookmark</a> and heading text (<a id="wrglossary.1025"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+).<p>
-Note that if you use the default <a id="wrglossary.1026"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span> with <a id="wrglossary.1027"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s possible to combine Options <a href="#glo:idx.opt.b2g">4</a> and <a href="#glo:idx.opt.standalone">6</a> to have both standalone definitions and an index. In this case, a <a id="wrglossary.1028"></a><a href="#glo:idx.glossarystyle">glossary style</a> is required. In the example below, I’ve use <a id="wrglossary.1029"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a>, which is provided in the <a id="wrglossary.1030"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> package (bundled with <a id="wrglossary.1031"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). I don’t need any of the other style packages, so I can still keep the <a id="wrglossary.1032"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> option and just load <a id="wrglossary.1033"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1034"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.1035"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>,<span class="comment">% <- using <a id="wrglossary.1036"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></span>
- <a id="wrglossary.1037"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<span class="comment">% <- don't load default style packages</span>
- <a id="wrglossary.1038"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<span class="comment">% <- load glossary-bookindex.sty</span>
- <a id="wrglossary.1039"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.1040"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a></span><span class="comment">% <- set the default style to 'bookindex'</span>
+</pre> A more automated solution can be obtained with the standalone helper commands for the <a id="wrglossary.944"></a><a href="#glo:idx.PDFbookmark">PDF bookmark</a> and heading text (<a id="wrglossary.945"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+).<p>
+Note that if you use the default <a id="wrglossary.946"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span> with <a id="wrglossary.947"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s possible to combine Options <a href="#glo:idx.opt.b2g">4</a> and <a href="#glo:idx.opt.standalone">6</a> to have both standalone definitions and an index. In this case, a <a id="wrglossary.948"></a><a href="#glo:idx.glossarystyle">glossary style</a> is required. In the example below, I’ve use <a id="wrglossary.949"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a>, which is provided in the <a id="wrglossary.950"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> package (bundled with <a id="wrglossary.951"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). I don’t need any of the other style packages, so I can still keep the <a id="wrglossary.952"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> option and just load <a id="wrglossary.953"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.954"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>,<span class="comment">% <- using <a id="wrglossary.955"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></span>
+ <a id="wrglossary.956"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<span class="comment">% <- don't load default style packages</span>
+ <a id="wrglossary.957"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<span class="comment">% <- load glossary-bookindex.sty</span>
+ <a id="wrglossary.958"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.959"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a></span><span class="comment">% <- set the default style to 'bookindex'</span>
]{glossaries-extra}
-</pre> I also need to sort the entries, so the resource command is now: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1041"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1042"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.1043"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<span class="comment">% definitions in terms.bib</span>
- <a id="wrglossary.1044"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<span class="comment">% sort by this locale</span>
- <a id="wrglossary.1045"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
- <a id="wrglossary.1046"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span>
+</pre> I also need to sort the entries, so the resource command is now: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.960"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.961"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<span class="comment">% definitions in terms.bib</span>
+ <a id="wrglossary.962"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<span class="comment">% sort by this locale</span>
+ <a id="wrglossary.963"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
+ <a id="wrglossary.964"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span>
]
-</pre> At the end of the document, I can add the <a id="wrglossary.1047"></a><a href="#glo:dual.glossary">glossary</a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1048"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1049"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>[<a id="wrglossary.1050"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">=Index</span>,<a id="wrglossary.1051"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span>]
-</pre> Note that I’ve had to switch off the hypertargets with <a id="wrglossary.1052"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span> (otherwise there would be duplicate targets). If you want <a id="wrglossary.1053"></a><a href="#glo:idx.group">letter group</a> headings you need to use the <a id="wrglossary.1054"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1055"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>bib2gls <a id="wrglossary.1056"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
-</pre> or if you are using <a id="wrglossary.1057"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1058"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls: { group: on }
+</pre> At the end of the document, I can add the <a id="wrglossary.965"></a><a href="#glo:dual.glossary">glossary</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.966"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>[<a id="wrglossary.967"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">=Index</span>,<a id="wrglossary.968"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span>]
+</pre> Note that I’ve had to switch off the hypertargets with <a id="wrglossary.969"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span> (otherwise there would be duplicate targets). If you want <a id="wrglossary.970"></a><a href="#glo:idx.group">letter group</a> headings you need to use the <a id="wrglossary.971"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>bib2gls <a id="wrglossary.972"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
+</pre> or if you are using <a id="wrglossary.973"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls: { group: on }
</pre><p>
-The <a id="wrglossary.1059"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style doesn’t show the description, so only the name and location is displayed. Remember that the name has had a <a id="wrglossary.1060"></a><a href="#glo:dual.casechange">case change</a> so it now starts with an initial capital. If you feel this is inappropriate for the index, you can adjust the <a id="wrglossary.1061"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style so that it uses the <a id="wrglossary.1062"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field instead. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1063"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.1064"></a><a href="#glo:glsxtrbookindexname"><code class="xtrcsfmt">\glsxtrbookindexname</code></a>}[1]{<span class="comment">% </span>
- <a id="wrglossary.1065"></a><a href="#glo:glossentrynameother"><code class="xtrcsfmt">\glossentrynameother</code></a>{#1}{text}}
-</pre> See the <a id="wrglossary.1066"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details about this style.<p>
+The <a id="wrglossary.974"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style doesn’t show the description, so only the name and location is displayed. Remember that the name has had a <a id="wrglossary.975"></a><a href="#glo:dual.casechange">case change</a> so it now starts with an initial capital. If you feel this is inappropriate for the index, you can adjust the <a id="wrglossary.976"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style so that it uses the <a id="wrglossary.977"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field instead. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.978"></a><a href="#glo:glsxtrbookindexname"><code class="xtrcsfmt">\glsxtrbookindexname</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.979"></a><a href="#glo:glossentrynameother"><code class="xtrcsfmt">\glossentrynameother</code></a>{#1}{text}}
+</pre> See the <a id="wrglossary.980"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details about this style.<p>
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>
-If there are extra terms that need to be included in the index that don’t have a description, you can define them with <code class="code">@index</code> in the <a id="wrglossary.1067"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1068"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@index</code>{element}
-<code class="code">@index</code>{member,<a id="wrglossary.1069"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={element}</span>}
-</pre> They can be used in the document as usual: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1070"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The objects that make up a set are the <a id="wrglossary.1071"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{element}
-or <a id="wrglossary.1072"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{member}.
-</pre> See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.1073"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.<p>
+If there are extra terms that need to be included in the index that don’t have a description, you can define them with <code class="code">@index</code> in the <a id="wrglossary.981"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@index</code>{element}
+<code class="code">@index</code>{member,<a id="wrglossary.982"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={element}</span>}
+</pre> They can be used in the document as usual: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The objects that make up a set are the <a id="wrglossary.983"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{element}
+or <a id="wrglossary.984"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{member}.
+</pre> See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.985"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.<p>
</section><!-- end of section option6 -->
@@ -1651,16 +1658,16 @@
<section id="sec:lipsum"><!-- start of section sec:lipsum --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.4. Dummy Entries for Testing<div class="labellink"><a href="#sec:lipsum">[link]</a></div></h2><!-- end of section header -->
<p>
-In addition to the sample files described in §<a href="#sec:samples">18</a>, <a id="wrglossary.1074"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> also provides some files containing lorum ipsum dummy <a id="wrglossary.1075"></a><a href="#glo:idx.glossaryentry">entries</a>. These are provided for testing purposes and are on TeX’s path (in <span class="filefmt">tex/latex/glossaries/test-entries</span>) so they can be included via <a id="wrglossary.1076"></a><a href="#glo:input"><code class="csfmt">\input</code></a> or <a id="wrglossary.1077"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>. The <a id="wrglossary.1078"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.1079"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> versions of all these files for use with <a id="wrglossary.1080"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The files are as follows:<p>
-<div class="filedef">🗋 <a id="wrglossary.1081"></a><dfn id="glo:file.example-glossaries-brief.tex"><span class="filefmt">example-glossaries-brief.tex</span></dfn></div><!-- end of filedef -->
- These entries all have brief descriptions. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1082"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1083"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{lorem}{<a id="wrglossary.1084"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem}</span>,<a id="wrglossary.1085"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>}
+In addition to the sample files described in §<a href="#sec:samples">18</a>, <a id="wrglossary.986"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> also provides some files containing lorum ipsum dummy <a id="wrglossary.987"></a><a href="#glo:idx.glossaryentry">entries</a>. These are provided for testing purposes and are on TeX’s path (in <span class="filefmt">tex/latex/glossaries/test-entries</span>) so they can be included via <a id="wrglossary.988"></a><a href="#glo:input"><code class="csfmt">\input</code></a> or <a id="wrglossary.989"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>. The <a id="wrglossary.990"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.991"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> versions of all these files for use with <a id="wrglossary.992"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The files are as follows:<p>
+<div class="filedef">🗋 <a id="wrglossary.993"></a><dfn id="glo:file.example-glossaries-brief.tex"><span class="filefmt">example-glossaries-brief.tex</span></dfn></div><!-- end of filedef -->
+ These entries all have brief descriptions. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.994"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{lorem}{<a id="wrglossary.995"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem}</span>,<a id="wrglossary.996"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1086"></a><dfn id="glo:file.example-glossaries-long.tex"><span class="filefmt">example-glossaries-long.tex</span></dfn></div><!-- end of filedef -->
- These entries all have long descriptions. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1087"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1088"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{loremipsum}{<a id="wrglossary.1089"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem ipsum}</span>,
-<a id="wrglossary.1090"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris.}</span>}
+<div class="filedef">🗋 <a id="wrglossary.997"></a><dfn id="glo:file.example-glossaries-long.tex"><span class="filefmt">example-glossaries-long.tex</span></dfn></div><!-- end of filedef -->
+ These entries all have long descriptions. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.998"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{loremipsum}{<a id="wrglossary.999"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem ipsum}</span>,
+<a id="wrglossary.1000"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris.}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1091"></a><dfn id="glo:file.example-glossaries-multipar.tex"><span class="filefmt">example-glossaries-multipar.tex</span></dfn></div><!-- end of filedef -->
- These entries all have multi-paragraph descriptions. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1092"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1093"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{loremi-ii}{<a id="wrglossary.1094"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>}<span class="comment">% </span>
+<div class="filedef">🗋 <a id="wrglossary.1001"></a><dfn id="glo:file.example-glossaries-multipar.tex"><span class="filefmt">example-glossaries-multipar.tex</span></dfn></div><!-- end of filedef -->
+ These entries all have multi-paragraph descriptions. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1002"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{loremi-ii}{<a id="wrglossary.1003"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>}<span class="comment">% </span>
{<span class="comment">% </span>
Lorem ipsum ...
@@ -1667,19 +1674,38 @@
Nam dui ligula...
}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1095"></a><dfn id="glo:file.example-glossaries-symbols.tex"><span class="filefmt">example-glossaries-symbols.tex</span></dfn></div><!-- end of filedef -->
- These entries all use the <a id="wrglossary.1096"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1097"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1098"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.1099"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alpha}</span>,
-<a id="wrglossary.1100"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.1101"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1102"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
-<a id="wrglossary.1103"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1004"></a><dfn id="glo:file.example-glossaries-symbols.tex"><span class="filefmt">example-glossaries-symbols.tex</span></dfn></div><!-- end of filedef -->
+ These entries all use the <a id="wrglossary.1005"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1006"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.1007"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alpha}</span>,
+<a id="wrglossary.1008"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.1009"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1010"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+<a id="wrglossary.1011"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1104"></a><dfn id="glo:file.example-glossaries-symbolnames.tex"><span class="filefmt">example-glossaries-symbolnames.tex</span></dfn></div><!-- end of filedef -->
- Similar to the previous file but the <a id="wrglossary.1105"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key isn’t used. Instead the symbol is stored in the <a id="wrglossary.1106"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1107"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1108"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sym.alpha}{<a id="wrglossary.1109"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,
-<a id="wrglossary.1110"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.1111"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1112"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
-<a id="wrglossary.1113"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1012"></a><dfn id="glo:file.example-glossaries-symbolnames.tex"><span class="filefmt">example-glossaries-symbolnames.tex</span></dfn></div><!-- end of filedef -->
+ Similar to the previous file but the <a id="wrglossary.1013"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key isn’t used. Instead the symbol is stored in the <a id="wrglossary.1014"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1015"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sym.alpha}{<a id="wrglossary.1016"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,
+<a id="wrglossary.1017"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.1018"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1019"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+<a id="wrglossary.1020"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1114"></a><dfn id="glo:file.example-glossaries-images.tex"><span class="filefmt">example-glossaries-images.tex</span></dfn></div><!-- end of filedef -->
- These entries use the <a id="wrglossary.1115"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store the name of an image file. (The images are provided by the <a id="wrglossary.1116"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></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: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1117"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1118"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{sedfeugiat}{<a id="wrglossary.1119"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed feugiat}</span>,
-<a id="wrglossary.1120"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>}<span class="comment">% </span>
+<div class="filedef">🗋 <a id="wrglossary.1021"></a><dfn id="glo:file.example-glossaries-user.tex"><span class="filefmt">example-glossaries-user.tex</span></dfn></div><!-- end of filedef -->
+ The <a id="wrglossary.1022"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries have the <a id="wrglossary.1023"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key and all <a id="wrglossary.1024"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a>, <a id="wrglossary.1025"></a><a id="wrglossary.1026"></a><a id="wrglossary.1027"></a><a id="wrglossary.1028"></a>…, <a id="wrglossary.1029"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> keys set. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1030"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample-a}
+{<a id="wrglossary.1031"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={a name}</span>,
+<a id="wrglossary.1032"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a description}</span>,
+<a id="wrglossary.1033"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,
+<a id="wrglossary.1034"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={A}</span>,
+<a id="wrglossary.1035"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={1}</span>,
+<a id="wrglossary.1036"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a><span class="optfmt">={i}</span>,
+<a id="wrglossary.1037"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a><span class="optfmt">={A-i}</span>,
+<a id="wrglossary.1038"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a><span class="optfmt">={25.2020788573521}</span>,
+<a id="wrglossary.1039"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a><span class="optfmt">={1585-11-06}</span>}
+</pre> There are also some <a id="wrglossary.1040"></a><a href="#glo:hierarchicallevel">level 1</a> entries, which may or may not have the <a id="wrglossary.1041"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> and user keys set. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1042"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample-b-0}
+{<a id="wrglossary.1043"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={sample-b}</span>,
+<a id="wrglossary.1044"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={b/0 name}</span>,
+<a id="wrglossary.1045"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={child 0 of b}</span>,
+<a id="wrglossary.1046"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\sigma</code>}}</span>,
+<a id="wrglossary.1047"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={0}</span>,
+<a id="wrglossary.1048"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a><span class="optfmt">={a-i}</span>}
+</pre> There are no deeper <a id="wrglossary.1049"></a><a href="#glo:hierarchicallevel">hierarchical</a> entries. Where set, the <a id="wrglossary.1050"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key is an <a id="wrglossary.1051"></a><a href="#glo:idx.uppercase">uppercase</a> letter (A–Z), the <a id="wrglossary.1052"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> key is an integer, the <a id="wrglossary.1053"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> key is a <a id="wrglossary.1054"></a><a href="#glo:idx.lowercase">lowercase</a> Roman numeral, the <a id="wrglossary.1055"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> key is in the form <span class="meta">〈<em class="metainner">alpha</em>〉</span>-<span class="meta">〈<em class="metainner">roman</em>〉</span> where <span class="meta">〈<em class="metainner">alpha</em>〉</span> is either an upper or <a id="wrglossary.1056"></a><a href="#glo:idx.lowercase">lowercase</a> letter (a–z or A–Z) and <span class="meta">〈<em class="metainner">roman</em>〉</span> is either an upper or <a id="wrglossary.1057"></a><a href="#glo:idx.lowercase">lowercase</a> Roman numeral. The <a id="wrglossary.1058"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> key is a random number (in the range \((-50,+50)\) for <a id="wrglossary.1059"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries and \((-1,+1)\) for child entries). The <a id="wrglossary.1060"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> key is a random date between 1000-01-01 and 2099-12-31.<p>
+<div class="filedef">🗋 <a id="wrglossary.1061"></a><dfn id="glo:file.example-glossaries-images.tex"><span class="filefmt">example-glossaries-images.tex</span></dfn></div><!-- end of filedef -->
+ These entries use the <a id="wrglossary.1062"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store the name of an image file. (The images are provided by the <a id="wrglossary.1063"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></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: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1064"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{sedfeugiat}{<a id="wrglossary.1065"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed feugiat}</span>,
+<a id="wrglossary.1066"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>}<span class="comment">% </span>
{<span class="comment">% </span>
Cum sociis natoque...
@@ -1686,54 +1712,54 @@
Etiam...
}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1121"></a><dfn id="glo:file.example-glossaries-acronym.tex"><span class="filefmt">example-glossaries-acronym.tex</span></dfn></div><!-- end of filedef -->
- These entries are all <a id="wrglossary.1122"></a><a href="#glo:idx.acronym">acronyms</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1123"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1124"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1125"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1126"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>]{lid}{LID}{lorem ipsum
+<div class="filedef">🗋 <a id="wrglossary.1067"></a><dfn id="glo:file.example-glossaries-acronym.tex"><span class="filefmt">example-glossaries-acronym.tex</span></dfn></div><!-- end of filedef -->
+ These entries are all <a id="wrglossary.1068"></a><a href="#glo:idx.acronym">acronyms</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1069"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1070"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1071"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>]{lid}{LID}{lorem ipsum
dolor}
-</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.1127"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- If you use the <a id="wrglossary.1128"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then <a id="wrglossary.1129"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1130"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> with the <a id="wrglossary.1131"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1132"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather than the default <a id="wrglossary.1133"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to set the <a id="wrglossary.1134"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1135"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1136"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1137"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[acronym]{<a id="wrglossary.1138"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
+</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.1072"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ If you use the <a id="wrglossary.1073"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then <a id="wrglossary.1074"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1075"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> with the <a id="wrglossary.1076"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1077"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather than the default <a id="wrglossary.1078"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to set the <a id="wrglossary.1079"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1080"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1081"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[acronym]{<a id="wrglossary.1082"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
</pre> </div><!-- end of information -->
<p>
-<div class="filedef">🗋 <a id="wrglossary.1139"></a><dfn id="glo:file.example-glossaries-acronym-desc.tex"><span class="filefmt">example-glossaries-acronym-desc.tex</span></dfn></div><!-- end of filedef -->
- This file contains entries that are all <a id="wrglossary.1140"></a><a href="#glo:idx.acronym">acronyms</a> that use the <a id="wrglossary.1141"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1142"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1143"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1144"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1145"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,
- <a id="wrglossary.1146"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={fringilla a, euismod sodales, sollicitudin vel, wisi}</span>]{ndl}{NDL}{nam dui ligula}
-</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.1147"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- If you use the <a id="wrglossary.1148"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then <a id="wrglossary.1149"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1150"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> with the <a id="wrglossary.1151"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1152"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather than the default <a id="wrglossary.1153"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to set the <a id="wrglossary.1154"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1155"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1156"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1157"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1158"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1159"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a>}
+<div class="filedef">🗋 <a id="wrglossary.1083"></a><dfn id="glo:file.example-glossaries-acronym-desc.tex"><span class="filefmt">example-glossaries-acronym-desc.tex</span></dfn></div><!-- end of filedef -->
+ This file contains entries that are all <a id="wrglossary.1084"></a><a href="#glo:idx.acronym">acronyms</a> that use the <a id="wrglossary.1085"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1086"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1087"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1088"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,
+ <a id="wrglossary.1089"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={fringilla a, euismod sodales, sollicitudin vel, wisi}</span>]{ndl}{NDL}{nam dui ligula}
+</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.1090"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ If you use the <a id="wrglossary.1091"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then <a id="wrglossary.1092"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1093"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> with the <a id="wrglossary.1094"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1095"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather than the default <a id="wrglossary.1096"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to set the <a id="wrglossary.1097"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1098"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1099"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1100"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1101"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a>}
</pre> </div><!-- end of information -->
<p>
-<div class="filedef">🗋 <a id="wrglossary.1160"></a><dfn id="glo:file.example-glossaries-acronyms-lang.tex"><span class="filefmt">example-glossaries-acronyms-lang.tex</span></dfn></div><!-- end of filedef -->
- These entries are all <a id="wrglossary.1161"></a><a href="#glo:idx.acronym">acronyms</a>, where some of them have a translation supplied in the <a id="wrglossary.1162"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1163"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1164"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1165"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1166"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,<a id="wrglossary.1167"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={love itself}</span>]
+<div class="filedef">🗋 <a id="wrglossary.1102"></a><dfn id="glo:file.example-glossaries-acronyms-lang.tex"><span class="filefmt">example-glossaries-acronyms-lang.tex</span></dfn></div><!-- end of filedef -->
+ These entries are all <a id="wrglossary.1103"></a><a href="#glo:idx.acronym">acronyms</a>, where some of them have a translation supplied in the <a id="wrglossary.1104"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1105"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1106"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1107"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,<a id="wrglossary.1108"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={love itself}</span>]
{li}{LI}{lorem ipsum}
-</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.1168"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- If you use the <a id="wrglossary.1169"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then <a id="wrglossary.1170"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1171"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> with the <a id="wrglossary.1172"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1173"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather than the default <a id="wrglossary.1174"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to set the <a id="wrglossary.1175"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1176"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1177"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1178"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1179"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1180"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>}
+</pre> <div class="information"><div class="informationtitle"><a id="wrglossary.1109"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ If you use the <a id="wrglossary.1110"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then <a id="wrglossary.1111"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1112"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> with the <a id="wrglossary.1113"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1114"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather than the default <a id="wrglossary.1115"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to set the <a id="wrglossary.1116"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1117"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1118"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1119"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1120"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>}
</pre> </div><!-- end of information -->
<p>
-<div class="filedef">🗋 <a id="wrglossary.1181"></a><dfn id="glo:file.example-glossaries-parent.tex"><span class="filefmt">example-glossaries-parent.tex</span></dfn></div><!-- end of filedef -->
- These are hierarchical entries where the child entries use the <a id="wrglossary.1182"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1183"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1184"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sedmattis}{<a id="wrglossary.1185"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
-<a id="wrglossary.1186"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1121"></a><dfn id="glo:file.example-glossaries-parent.tex"><span class="filefmt">example-glossaries-parent.tex</span></dfn></div><!-- end of filedef -->
+ These are hierarchical entries where the child entries use the <a id="wrglossary.1122"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1123"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sedmattis}{<a id="wrglossary.1124"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
+<a id="wrglossary.1125"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet}</span>}
-<a id="wrglossary.1187"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gravida}{<a id="wrglossary.1188"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={sedmattis}</span>,
- <a id="wrglossary.1189"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,<a id="wrglossary.1190"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada}</span>}
+<a id="wrglossary.1126"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gravida}{<a id="wrglossary.1127"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={sedmattis}</span>,
+ <a id="wrglossary.1128"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,<a id="wrglossary.1129"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1191"></a><dfn id="glo:file.example-glossaries-childnoname.tex"><span class="filefmt">example-glossaries-childnoname.tex</span></dfn></div><!-- end of filedef -->
- These are hierarchical entries where the child entries don’t use the <a id="wrglossary.1192"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1193"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1194"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{scelerisque}{<a id="wrglossary.1195"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={scelerisque}</span>,
- <a id="wrglossary.1196"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={at}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1130"></a><dfn id="glo:file.example-glossaries-childnoname.tex"><span class="filefmt">example-glossaries-childnoname.tex</span></dfn></div><!-- end of filedef -->
+ These are hierarchical entries where the child entries don’t use the <a id="wrglossary.1131"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1132"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{scelerisque}{<a id="wrglossary.1133"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={scelerisque}</span>,
+ <a id="wrglossary.1134"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={at}</span>}
-<a id="wrglossary.1197"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{vestibulum}{<a id="wrglossary.1198"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={scelerisque}</span>,
- <a id="wrglossary.1199"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={eu, nulla}</span>}
+<a id="wrglossary.1135"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{vestibulum}{<a id="wrglossary.1136"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={scelerisque}</span>,
+ <a id="wrglossary.1137"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={eu, nulla}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1200"></a><dfn id="glo:file.example-glossaries-longchild.tex"><span class="filefmt">example-glossaries-longchild.tex</span></dfn></div><!-- end of filedef -->
- These entries all have long descriptions and there are some child entries. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1201"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1202"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longsedmattis}{<a id="wrglossary.1203"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
- <a id="wrglossary.1204"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris.}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1138"></a><dfn id="glo:file.example-glossaries-longchild.tex"><span class="filefmt">example-glossaries-longchild.tex</span></dfn></div><!-- end of filedef -->
+ These entries all have long descriptions and there are some child entries. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1139"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longsedmattis}{<a id="wrglossary.1140"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
+ <a id="wrglossary.1141"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris.}</span>}
-<a id="wrglossary.1205"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longgravida}{<a id="wrglossary.1206"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={longsedmattis}</span>,<a id="wrglossary.1207"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,
- <a id="wrglossary.1208"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada libero, nonummy eget, consectetuer id, vulputate a, magna. Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Mauris ut leo.}</span>}
+<a id="wrglossary.1142"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longgravida}{<a id="wrglossary.1143"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={longsedmattis}</span>,<a id="wrglossary.1144"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,
+ <a id="wrglossary.1145"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada libero, nonummy eget, consectetuer id, vulputate a, magna. Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Mauris ut leo.}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1209"></a><dfn id="glo:file.example-glossaries-childmultipar.tex"><span class="filefmt">example-glossaries-childmultipar.tex</span></dfn></div><!-- end of filedef -->
- This consists of parent entries with single paragraph descriptions and child entries with multi-paragraph descriptions. Some entries have the <a id="wrglossary.1210"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key set to the name of an image file provided by the <a id="wrglossary.1211"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></a> package. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1212"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1213"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hiersedmattis}{<a id="wrglossary.1214"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,<a id="wrglossary.1215"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>,
- <a id="wrglossary.1216"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Erat sit amet dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris. Ut pellentesque augue sed urna. Vestibulum diam eros, fringilla et, consectetuer eu, nonummy id, sapien. Nullam at lectus. In sagittis ultrices mauris. Curabitur malesuada erat sit amet massa. Fusce blandit. Aliquam erat volutpat.}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1146"></a><dfn id="glo:file.example-glossaries-childmultipar.tex"><span class="filefmt">example-glossaries-childmultipar.tex</span></dfn></div><!-- end of filedef -->
+ This consists of parent entries with single paragraph descriptions and child entries with multi-paragraph descriptions. Some entries have the <a id="wrglossary.1147"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key set to the name of an image file provided by the <a id="wrglossary.1148"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></a> package. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1149"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hiersedmattis}{<a id="wrglossary.1150"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,<a id="wrglossary.1151"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>,
+ <a id="wrglossary.1152"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Erat sit amet dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris. Ut pellentesque augue sed urna. Vestibulum diam eros, fringilla et, consectetuer eu, nonummy id, sapien. Nullam at lectus. In sagittis ultrices mauris. Curabitur malesuada erat sit amet massa. Fusce blandit. Aliquam erat volutpat.}</span>}
-<a id="wrglossary.1217"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{hierloremi-ii}
-{<a id="wrglossary.1218"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>,<a id="wrglossary.1219"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={hiersedmattis}</span>}<span class="comment">% </span>
+<a id="wrglossary.1153"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{hierloremi-ii}
+{<a id="wrglossary.1154"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>,<a id="wrglossary.1155"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={hiersedmattis}</span>}<span class="comment">% </span>
{<span class="comment">% </span>
Lorem ipsum ...
@@ -1740,26 +1766,26 @@
Nam dui ligula...
}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1220"></a><dfn id="glo:file.example-glossaries-cite.tex"><span class="filefmt">example-glossaries-cite.tex</span></dfn></div><!-- end of filedef -->
- These entries use the <a id="wrglossary.1221"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store a citation key (or comma-separated list of citation keys). The citations are defined in <span class="filefmt">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: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1222"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1223"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{fusce}{<a id="wrglossary.1224"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={fusce}</span>,
-<a id="wrglossary.1225"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={suscipit cursus sem}</span>,<a id="wrglossary.1226"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={article-minimal}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1156"></a><dfn id="glo:file.example-glossaries-cite.tex"><span class="filefmt">example-glossaries-cite.tex</span></dfn></div><!-- end of filedef -->
+ These entries use the <a id="wrglossary.1157"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store a citation key (or comma-separated list of citation keys). The citations are defined in <span class="filefmt">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: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1158"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{fusce}{<a id="wrglossary.1159"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={fusce}</span>,
+<a id="wrglossary.1160"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={suscipit cursus sem}</span>,<a id="wrglossary.1161"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={article-minimal}</span>}
</pre><p>
-<div class="filedef">🗋 <a id="wrglossary.1227"></a><dfn id="glo:file.example-glossaries-url.tex"><span class="filefmt">example-glossaries-url.tex</span></dfn></div><!-- end of filedef -->
- These entries use the <a id="wrglossary.1228"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store an <a id="wrglossary.1229"></a><a href="#glo:URL">URL</a> associated with the entry. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1230"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1231"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{aenean-url}{<a id="wrglossary.1232"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aenean}</span>,
- <a id="wrglossary.1233"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={adipiscing auctor est}</span>,
- <a id="wrglossary.1234"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={http://uk.tug.org/}</span>}
+<div class="filedef">🗋 <a id="wrglossary.1162"></a><dfn id="glo:file.example-glossaries-url.tex"><span class="filefmt">example-glossaries-url.tex</span></dfn></div><!-- end of filedef -->
+ These entries use the <a id="wrglossary.1163"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store an <a id="wrglossary.1164"></a><a href="#glo:URL">URL</a> associated with the entry. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1165"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{aenean-url}{<a id="wrglossary.1166"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aenean}</span>,
+ <a id="wrglossary.1167"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={adipiscing auctor est}</span>,
+ <a id="wrglossary.1168"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={http://uk.tug.org/}</span>}
</pre><p>
The sample file <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples//glossary-lipsum-examples.tex"><span class="filefmt">glossary-lipsum-examples.tex</span></a> in the <span class="filefmt">doc/latex/glossaries/samples</span> directory uses all these files. See also <a href="https://www.dickimaw-books.com/gallery/#glossaries"><span class="styfmt">glossaries</span> gallery</a>.<p>
-<div class="sidenote"><a id="wrglossary.1235"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-The <a id="wrglossary.1236"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides the additional test file: <div class="filedef">🗋 <a id="wrglossary.1237"></a><dfn id="glo:file.example-glossaries-xr.tex"><span class="filefmt">example-glossaries-xr.tex</span></dfn></div><!-- end of filedef -->
- These entries use the <a id="wrglossary.1238"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key provided by the base <span class="styfmt">glossaries</span> package and also the <a id="wrglossary.1239"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> and <a id="wrglossary.1240"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys that require <a id="wrglossary.1241"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1242"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1243"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alias-lorem}{<a id="wrglossary.1244"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alias-lorem}</span>,
- <a id="wrglossary.1245"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>,<a id="wrglossary.1246"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={lorem}</span>}
+<div class="sidenote"><a id="wrglossary.1169"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+The <a id="wrglossary.1170"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides the additional test file: <div class="filedef">🗋 <a id="wrglossary.1171"></a><dfn id="glo:file.example-glossaries-xr.tex"><span class="filefmt">example-glossaries-xr.tex</span></dfn></div><!-- end of filedef -->
+ These entries use the <a id="wrglossary.1172"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key provided by the base <span class="styfmt">glossaries</span> package and also the <a id="wrglossary.1173"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> and <a id="wrglossary.1174"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys that require <a id="wrglossary.1175"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1176"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alias-lorem}{<a id="wrglossary.1177"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alias-lorem}</span>,
+ <a id="wrglossary.1178"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>,<a id="wrglossary.1179"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={lorem}</span>}
-<a id="wrglossary.1247"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{amet}{<a id="wrglossary.1248"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={amet}</span>,<a id="wrglossary.1249"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={consectetuer}</span>,
- <a id="wrglossary.1250"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={dolor}</span>}
+<a id="wrglossary.1180"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{amet}{<a id="wrglossary.1181"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={amet}</span>,<a id="wrglossary.1182"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={consectetuer}</span>,
+ <a id="wrglossary.1183"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={dolor}</span>}
-<a id="wrglossary.1251"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{arcu}<a id="wrglossary.1252"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={arcu}</span>,<a id="wrglossary.1253"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={libero}</span>,
- <a id="wrglossary.1254"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a><span class="optfmt">={placerat,vitae,curabitur}</span>
+<a id="wrglossary.1184"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{arcu}<a id="wrglossary.1185"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={arcu}</span>,<a id="wrglossary.1186"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={libero}</span>,
+ <a id="wrglossary.1187"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a><span class="optfmt">={placerat,vitae,curabitur}</span>
</pre> <p>
</section><!-- end of section sec:lipsum -->
@@ -1767,54 +1793,54 @@
<section id="sec:languages"><!-- start of section sec:languages --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.5. Multi-Lingual Support<div class="labellink"><a href="#sec:languages">[link]</a></div></h2><!-- end of section header -->
<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1255"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-The <a id="wrglossary.1256"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package uses the <a id="wrglossary.1257"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package to determine the document languages. Unfortunately, because there isn’t a standard language identification framework provided with LaTeX, <a id="wrglossary.1258"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> isn’t always able to detect the selected languages either as a result of using an unknown interface or where the interface doesn’t provide a way of detecting the language. In particular, <a id="wrglossary.1259"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t pick up languages specified using <a id="wrglossary.1260"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> <a id="wrglossary.1261"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>. In the event that <a id="wrglossary.1262"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t detect the language, use the <a id="wrglossary.1263"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> package option. See §<a href="#sec:pkgintegration">1.2</a> and also <a href="https://www.dickimaw-books.com/latex/tracklang/">Localisation with <span class="filefmt">tracklang.tex</span></a> for further details. </div><!-- end of important -->
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <a id="wrglossary.1188"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package uses the <a id="wrglossary.1189"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package to determine the document languages. Unfortunately, because there isn’t a standard language identification framework provided with LaTeX, <a id="wrglossary.1190"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> isn’t always able to detect the selected languages either as a result of using an unknown interface or where the interface doesn’t provide a way of detecting the language. In particular, <a id="wrglossary.1191"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t pick up languages specified using <a id="wrglossary.1192"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> <a id="wrglossary.1193"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>. In the event that <a id="wrglossary.1194"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t detect the language, use the <a id="wrglossary.1195"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> package option. See §<a href="#sec:pkgintegration">1.2</a> and also <a href="https://www.dickimaw-books.com/latex/tracklang/">Localisation with <span class="filefmt">tracklang.tex</span></a> for further details. </div><!-- end of important -->
<p>
-As from version 1.17, the <a id="wrglossary.1264"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package can be used with <a id="wrglossary.1265"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as well as <a id="wrglossary.1266"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. If you are writing in a language that uses an <a id="wrglossary.1267"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or <a id="wrglossary.1268"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a> it’s best to use <a id="wrglossary.1269"></a><a href="#glo:idx.opt.xdy">Option 3</a> (<a id="wrglossary.1270"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) or <a id="wrglossary.1271"></a><a href="#glo:idx.opt.b2g">Option 4</a> (<a id="wrglossary.1272"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) as <a id="wrglossary.1273"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.1274"></a><a href="#glo:idx.opt.mkidx">Option 2</a>) is hard-coded for the non-extended <a id="wrglossary.1275"></a><a href="#glo:dual.latinalph">Latin alphabet</a> and <a id="wrglossary.1276"></a><a href="#glo:idx.opt.noidx">Option 1</a> can only perform limited ASCII comparisons.<p>
-This means that with Options <a href="#glo:idx.opt.xdy">3</a> or <a href="#glo:idx.opt.b2g">4</a> you are not restricted to the A, …, Z letter groups. If you want to use <a id="wrglossary.1277"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, remember to use the <a id="wrglossary.1278"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1279"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[french]{article}
+As from version 1.17, the <a id="wrglossary.1196"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package can be used with <a id="wrglossary.1197"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as well as <a id="wrglossary.1198"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. If you are writing in a language that uses an <a id="wrglossary.1199"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or <a id="wrglossary.1200"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a> it’s best to use <a id="wrglossary.1201"></a><a href="#glo:idx.opt.xdy">Option 3</a> (<a id="wrglossary.1202"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) or <a id="wrglossary.1203"></a><a href="#glo:idx.opt.b2g">Option 4</a> (<a id="wrglossary.1204"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) as <a id="wrglossary.1205"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.1206"></a><a href="#glo:idx.opt.mkidx">Option 2</a>) is hard-coded for the non-extended <a id="wrglossary.1207"></a><a href="#glo:dual.latinalph">Latin alphabet</a> and <a id="wrglossary.1208"></a><a href="#glo:idx.opt.noidx">Option 1</a> can only perform limited ASCII comparisons.<p>
+This means that with Options <a href="#glo:idx.opt.xdy">3</a> or <a href="#glo:idx.opt.b2g">4</a> you are not restricted to the A, …, Z letter groups. If you want to use <a id="wrglossary.1209"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, remember to use the <a id="wrglossary.1210"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[french]{article}
<code class="cmd">\usepackage</code>[utf8]{inputenc}
<code class="cmd">\usepackage</code>[T1]{fontenc}
<code class="cmd">\usepackage</code>{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1280"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
-</pre> If you are using a non-Latin script, you may need the <a id="wrglossary.1281"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a><span class="optfmt">=o</span>ption or use <a id="wrglossary.1282"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a> to indicate the first <a id="wrglossary.1283"></a><a href="#glo:idx.group">letter group</a> that should follow the number <a id="wrglossary.1284"></a><a href="#glo:idx.group">group</a>.<p>
-If you want to use <a id="wrglossary.1285"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you need to use the <a id="wrglossary.1286"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option with <a id="wrglossary.1287"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and supply the definitions in <a id="wrglossary.1288"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. (See the <a id="wrglossary.1289"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.)<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1290"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that although a <a id="wrglossary.1291"></a><a href="#glo:dual.nonlatinchar">non-Latin character</a>, such as é, looks like a plain character in your <a id="wrglossary.1292"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file, with standard LaTeX it’s actually a macro and can therefore cause problems. (This issue doesn’t occur with XeLaTeX or LuaLaTeX which both natively support <a id="wrglossary.1293"></a><a href="#glo:dual.utf8">UTF-8</a>.) Recent versions of the LaTeX kernel have made significant improvements in handling <a id="wrglossary.1294"></a><a href="#glo:dual.utf8">UTF-8</a>. To ensure you have the best <a id="wrglossary.1295"></a><a href="#glo:dual.utf8">UTF-8</a> support, use at least <a id="wrglossary.1296"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ with <a id="wrglossary.1297"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ (and, if required, <a id="wrglossary.1298"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+). </div><!-- end of important -->
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1211"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
+</pre> If you are using a non-Latin script, you may need the <a id="wrglossary.1212"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a><span class="optfmt">=o</span>ption or use <a id="wrglossary.1213"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a> to indicate the first <a id="wrglossary.1214"></a><a href="#glo:idx.group">letter group</a> that should follow the number <a id="wrglossary.1215"></a><a href="#glo:idx.group">group</a>.<p>
+If you want to use <a id="wrglossary.1216"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, you need to use the <a id="wrglossary.1217"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option with <a id="wrglossary.1218"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and supply the definitions in <a id="wrglossary.1219"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. (See the <a id="wrglossary.1220"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.)<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that although a <a id="wrglossary.1221"></a><a href="#glo:dual.nonlatinchar">non-Latin character</a>, such as é, looks like a plain character in your <a id="wrglossary.1222"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file, with standard LaTeX it’s actually a macro and can therefore cause problems. (This issue doesn’t occur with XeLaTeX or LuaLaTeX which both natively support <a id="wrglossary.1223"></a><a href="#glo:dual.utf8">UTF-8</a>.) Recent versions of the LaTeX kernel have made significant improvements in handling <a id="wrglossary.1224"></a><a href="#glo:dual.utf8">UTF-8</a>. To ensure you have the best <a id="wrglossary.1225"></a><a href="#glo:dual.utf8">UTF-8</a> support, use at least <a id="wrglossary.1226"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ with <a id="wrglossary.1227"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ (and, if required, <a id="wrglossary.1228"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+). </div><!-- end of important -->
<p>
-With old versions of <a id="wrglossary.1299"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> (pre v2.08), if you use a <a id="wrglossary.1300"></a><a href="#glo:dual.utf8">UTF-8</a> character at the start of an <a id="wrglossary.1301"></a><a href="#glo:idx.glossaryentry">entry</a> name, you must place it in a group, or it will cause a problem for <a id="wrglossary.1302"></a><a href="#glo:idx.sentencecase">sentence case</a> commands (e.g. <a id="wrglossary.1303"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>). For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1304"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% <a id="wrglossary.1305"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07:</span>
-<a id="wrglossary.1306"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.1307"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
-<a id="wrglossary.1308"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
-</pre> This isn’t necessary with <a id="wrglossary.1309"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.1310"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+. <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1311"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% <a id="wrglossary.1312"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08:</span>
-<a id="wrglossary.1313"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.1314"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
-<a id="wrglossary.1315"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+With old versions of <a id="wrglossary.1229"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> (pre v2.08), if you use a <a id="wrglossary.1230"></a><a href="#glo:dual.utf8">UTF-8</a> character at the start of an <a id="wrglossary.1231"></a><a href="#glo:idx.glossaryentry">entry</a> name, you must place it in a group, or it will cause a problem for <a id="wrglossary.1232"></a><a href="#glo:idx.sentencecase">sentence case</a> commands (e.g. <a id="wrglossary.1233"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>). For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% <a id="wrglossary.1234"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07:</span>
+<a id="wrglossary.1235"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.1236"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
+<a id="wrglossary.1237"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+</pre> This isn’t necessary with <a id="wrglossary.1238"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.1239"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+. <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% <a id="wrglossary.1240"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08:</span>
+<a id="wrglossary.1241"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.1242"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+<a id="wrglossary.1243"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
</pre><p>
-If you are using <a id="wrglossary.1316"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1317"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the application needs to know the <a id="wrglossary.1318"></a><a href="#glo:idx.encoding">encoding</a> of the <a id="wrglossary.1319"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file. This information is added to the <a id="wrglossary.1320"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and can be picked up by <a id="wrglossary.1321"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and <a id="wrglossary.1322"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If you use <a id="wrglossary.1323"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly instead of via <a id="wrglossary.1324"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>, you may need to specify the <a id="wrglossary.1325"></a><a href="#glo:idx.encoding">encoding</a> using the <a id="wrglossary.1326"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> option. Read the <a id="wrglossary.1327"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> manual for further details of this option.<p>
-If you have the double-quote character (<a id="wrglossary.1328"></a><a href="#glo:idx.sym.dblquote"><code class="code">"</code></a>) as an active character (for example, a <a id="wrglossary.1329"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> shorthand) and you want to use <a id="wrglossary.1330"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.1331"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> option, you’ll need to change <a id="wrglossary.1332"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> quote character using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.1333"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.1334"></a><code class="code"><dfn id="glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
+If you are using <a id="wrglossary.1244"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1245"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the application needs to know the <a id="wrglossary.1246"></a><a href="#glo:idx.encoding">encoding</a> of the <a id="wrglossary.1247"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file. This information is added to the <a id="wrglossary.1248"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and can be picked up by <a id="wrglossary.1249"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and <a id="wrglossary.1250"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If you use <a id="wrglossary.1251"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly instead of via <a id="wrglossary.1252"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>, you may need to specify the <a id="wrglossary.1253"></a><a href="#glo:idx.encoding">encoding</a> using the <a id="wrglossary.1254"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> option. Read the <a id="wrglossary.1255"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> manual for further details of this option.<p>
+If you have the double-quote character (<a id="wrglossary.1256"></a><a href="#glo:idx.sym.dblquote"><code class="code">"</code></a>) as an active character (for example, a <a id="wrglossary.1257"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> shorthand) and you want to use <a id="wrglossary.1258"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.1259"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> option, you’ll need to change <a id="wrglossary.1260"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> quote character using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1261"></a><code class="code"><dfn id="glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code><p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
- Note that <span class="meta">〈<em class="metainner">character</em>〉</span> may not be one of <a id="wrglossary.1335"></a><a href="#glo:idx.sym.questionmark"><code class="code">?</code> (question mark)</a>, <a id="wrglossary.1336"></a><a href="#glo:idx.sym.pipe"><code class="code">|</code> (pipe)</a> or <a id="wrglossary.1337"></a><a href="#glo:idx.sym.exclammark"><code class="code">!</code> (exclamation mark)</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1338"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1339"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
-</pre> This must be done before <a id="wrglossary.1340"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and any entry definitions. It’s only applicable for <a id="wrglossary.1341"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. This option in conjunction with <span class="optfmt">ngerman</span> will also cause <a id="wrglossary.1342"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to use the <a id="wrglossary.1343"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> switch when invoking <a id="wrglossary.1344"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1345"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Be careful of <a id="wrglossary.1346"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> shorthands. These aren’t switched on until the start of the document, so any entries defined in the <a id="wrglossary.1347"></a><a href="#glo:idx.documentpreamble">preamble</a> 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 id="wrglossary.1348"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1349"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (such as the double-quote) then this will interfere with code that tries to escape any of those characters that occur in the <a id="wrglossary.1350"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. </div><!-- end of important -->
+ Note that <span class="meta">〈<em class="metainner">character</em>〉</span> may not be one of <a id="wrglossary.1262"></a><a href="#glo:idx.sym.questionmark"><code class="code">?</code> (question mark)</a>, <a id="wrglossary.1263"></a><a href="#glo:idx.sym.pipe"><code class="code">|</code> (pipe)</a> or <a id="wrglossary.1264"></a><a href="#glo:idx.sym.exclammark"><code class="code">!</code> (exclamation mark)</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1265"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
+</pre> This must be done before <a id="wrglossary.1266"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and any entry definitions. It’s only applicable for <a id="wrglossary.1267"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. This option in conjunction with <span class="optfmt">ngerman</span> will also cause <a id="wrglossary.1268"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to use the <a id="wrglossary.1269"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> switch when invoking <a id="wrglossary.1270"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Be careful of <a id="wrglossary.1271"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> shorthands. These aren’t switched on until the start of the document, so any entries defined in the <a id="wrglossary.1272"></a><a href="#glo:idx.documentpreamble">preamble</a> 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 id="wrglossary.1273"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1274"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (such as the double-quote) then this will interfere with code that tries to escape any of those characters that occur in the <a id="wrglossary.1275"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. </div><!-- end of important -->
<p>
-In general, it’s best not to use <a id="wrglossary.1351"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s shorthands in entry definitions. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1352"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+In general, it’s best not to use <a id="wrglossary.1276"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s shorthands in entry definitions. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[ngerman]{babel}
<code class="cmd">\usepackage</code>{glossaries}
-<a id="wrglossary.1353"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
+<a id="wrglossary.1277"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
-<a id="wrglossary.1354"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1278"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<a id="wrglossary.1355"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{rna}{name=ribonukleinsäure,
- <a id="wrglossary.1356"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={ribonukleins"aure}</span>,
- <a id="wrglossary.1357"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={eine Nukleinsäure}</span>}
+<a id="wrglossary.1279"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{rna}{name=ribonukleinsäure,
+ <a id="wrglossary.1280"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={ribonukleins"aure}</span>,
+ <a id="wrglossary.1281"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={eine Nukleinsäure}</span>}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.1358"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{rna}
+<a id="wrglossary.1282"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{rna}
-<a id="wrglossary.1359"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.1283"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
</pre><p>
@@ -1823,10 +1849,10 @@
<section id="sec:fixednames"><!-- start of section sec:fixednames --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.5.1. Changing the Fixed Names<div class="labellink"><a href="#sec:fixednames">[link]</a></div></h3><!-- end of subsection header -->
<p>
-The fixed names are produced using the commands listed in Table <a href="#tab:predefinednames">1.2</a>. If you aren’t using a language package such as <a id="wrglossary.1360"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1361"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> that uses caption hooks, you can just redefine these commands as appropriate. If you are using <a id="wrglossary.1362"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1363"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></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 <a id="wrglossary.1364"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1365"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> documentation. If you have loaded <a id="wrglossary.1366"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, then <a id="wrglossary.1367"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will attempt to load <a id="wrglossary.1368"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, unless you have used the <a id="wrglossary.1369"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>, <a id="wrglossary.1370"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=false</span> or <a id="wrglossary.1371"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> package options. If the <a id="wrglossary.1372"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is loaded, the translations are provided by dictionary files (for example, <span class="filefmt">glossaries-dictionary-English.dict</span>). See th!
e <a id="wrglossary.1373"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package for advice on changing translations provided by <a id="wrglossary.1374"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionaries. If you can’t work out how to modify these dictionary definitions, try switching to <a id="wrglossary.1375"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s interface using <a id="wrglossary.1376"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1377"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[english,french]{article}
+The fixed names are produced using the commands listed in Table <a href="#tab:predefinednames">1.2</a>. If you aren’t using a language package such as <a id="wrglossary.1284"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1285"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> that uses caption hooks, you can just redefine these commands as appropriate. If you are using <a id="wrglossary.1286"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1287"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></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 <a id="wrglossary.1288"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1289"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> documentation. If you have loaded <a id="wrglossary.1290"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, then <a id="wrglossary.1291"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will attempt to load <a id="wrglossary.1292"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, unless you have used the <a id="wrglossary.1293"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>, <a id="wrglossary.1294"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=false</span> or <a id="wrglossary.1295"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> package options. If the <a id="wrglossary.1296"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is loaded, the translations are provided by dictionary files (for example, <span class="filefmt">glossaries-dictionary-English.dict</span>). S!
ee the <a id="wrglossary.1297"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package for advice on changing translations provided by <a id="wrglossary.1298"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionaries. If you can’t work out how to modify these dictionary definitions, try switching to <a id="wrglossary.1299"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s interface using <a id="wrglossary.1300"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[english,french]{article}
<code class="cmd">\usepackage</code>{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1378"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
-</pre> and then use <a id="wrglossary.1379"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s caption hook mechanism. Note that if you pass the language options directly to <a id="wrglossary.1380"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> rather that using the document class options or otherwise passing the same options to <a id="wrglossary.1381"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, then <a id="wrglossary.1382"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> won’t pick up the language and no dictionaries will be loaded and <a id="wrglossary.1383"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s caption hooks will be used instead.<p>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1301"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
+</pre> and then use <a id="wrglossary.1302"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s caption hook mechanism. Note that if you pass the language options directly to <a id="wrglossary.1303"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> rather that using the document class options or otherwise passing the same options to <a id="wrglossary.1304"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, then <a id="wrglossary.1305"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> won’t pick up the language and no dictionaries will be loaded and <a id="wrglossary.1306"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s caption hooks will be used instead.<p>
<div class="table"> <div id="tab:predefinednames" class="caption">Table 2: Customised Text</div> <table class="tabular-c">
<tr style=""><th class="cell-noborder-rightsep-l">Command Name </th>
<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 3000.000244%; padding-right: 6.000000pt; text-align: left; "> <span style="font-weight: bold; ">Translator Key Word </span></td>
@@ -1857,18 +1883,18 @@
<td style="border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 4000.000000%; padding-right: 0px; text-align: left; "> Header for numbers section of the glossary for glossary styles that support this option. </td>
</tr></table>
</div><p>
-As from version 4.12, multilingual support is provided by separate language modules that need to be installed in addition to installing the <a id="wrglossary.1384"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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 maintenance by contacting me at <a href="http://www.dickimaw-books.com/contact.html">http://www.dickimaw-books.com/contact.html</a>. The <a id="wrglossary.1385"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary files for <a id="wrglossary.1386"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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>
+As from version 4.12, multilingual support is provided by separate language modules that need to be installed in addition to installing the <a id="wrglossary.1307"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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 maintenance by contacting me at <a href="http://www.dickimaw-books.com/contact.html">http://www.dickimaw-books.com/contact.html</a>. The <a id="wrglossary.1308"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary files for <a id="wrglossary.1309"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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>
Examples of use:
<ul class="displaylist">
- <li><span class="bulletitem">•</span>Using <a id="wrglossary.1387"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.1388"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1389"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[english,french]{article}
+ <li><span class="bulletitem">•</span>Using <a id="wrglossary.1310"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.1311"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[english,french]{article}
<code class="cmd">\usepackage</code>{babel}
<code class="cmd">\usepackage</code>{glossaries}
-</pre> (<a id="wrglossary.1390"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> is automatically loaded).<p>
-<li><span class="bulletitem">•</span>Using <a id="wrglossary.1391"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1392"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[english,french]{article}
+</pre> (<a id="wrglossary.1312"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> is automatically loaded).<p>
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1313"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[english,french]{article}
<code class="cmd">\usepackage</code>{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1393"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
-</pre> (<a id="wrglossary.1394"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> isn’t loaded). The <a id="wrglossary.1395"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has <a id="wrglossary.1396"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> as the default if <a id="wrglossary.1397"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded.<p>
-<li><span class="bulletitem">•</span>Using <a id="wrglossary.1398"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1399"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1314"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
+</pre> (<a id="wrglossary.1315"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> isn’t loaded). The <a id="wrglossary.1316"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has <a id="wrglossary.1317"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> as the default if <a id="wrglossary.1318"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded.<p>
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1319"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>{polyglossia}
<code class="cmd">\setmainlanguage</code>{english}
<code class="cmd">\usepackage</code>{glossaries}
@@ -1876,26 +1902,26 @@
</ul>
<p>
-Due to the varied nature of <a id="wrglossary.1400"></a><a href="#glo:dual.glossary">glossaries</a>, it’s likely that the predefined translations may not be appropriate. If you are using the <a id="wrglossary.1401"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> package and the <a id="wrglossary.1402"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option <a id="wrglossary.1403"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>, 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 <a id="wrglossary.1404"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package, then you can provide your own dictionary with the necessary modifications (using <code class="csfmt">\deftranslation</code>) and load it using <code class="csfmt">\usedictionary</code>. If you simply want to change the title of a <a id="wrglossary.1405"></a><a href="#glo:dual.glossary">glossary</a>, you can use the <a id="wrglossary.1406"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key in commands like <a id="wrglossary.1407"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (but not the iterative commands like <a id="wrglossary.1408"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>).<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1409"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that the <a id="wrglossary.1410"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionaries are loaded at the beginning of the document, so it won’t have any effect if you put <code class="csfmt">\deftranslation</code> in the <a id="wrglossary.1411"></a><a href="#glo:idx.documentpreamble">preamble</a>. It should be put in your personal dictionary instead (as in the example below). See the <a id="wrglossary.1412"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> documentation for further details. </div><!-- end of important -->
+Due to the varied nature of <a id="wrglossary.1320"></a><a href="#glo:dual.glossary">glossaries</a>, it’s likely that the predefined translations may not be appropriate. If you are using the <a id="wrglossary.1321"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> package and the <a id="wrglossary.1322"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option <a id="wrglossary.1323"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>, 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 <a id="wrglossary.1324"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package, then you can provide your own dictionary with the necessary modifications (using <code class="csfmt">\deftranslation</code>) and load it using <code class="csfmt">\usedictionary</code>. If you simply want to change the title of a <a id="wrglossary.1325"></a><a href="#glo:dual.glossary">glossary</a>, you can use the <a id="wrglossary.1326"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key in commands like <a id="wrglossary.1327"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (but not the iterative commands like <a id="wrglossary.1328"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>).<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that the <a id="wrglossary.1329"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionaries are loaded at the beginning of the document, so it won’t have any effect if you put <code class="csfmt">\deftranslation</code> in the <a id="wrglossary.1330"></a><a href="#glo:idx.documentpreamble">preamble</a>. It should be put in your personal dictionary instead (as in the example below). See the <a id="wrglossary.1331"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> documentation for further details. </div><!-- end of important -->
<p>
-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 <span class="qt">“Nomenclature”</span> and the <a id="wrglossary.1413"></a><a href="#glo:dual.locationlist">location list</a> should be labelled <span class="qt">“Location”</span>, then you can create a file called, say, <span class="filefmt">myinstitute-glossaries-dictionary-English.dict</span> that contains the following: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1414"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ProvidesDictionary</code>{myinstitute-glossaries-dictionary}{English}
+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 <span class="qt">“Nomenclature”</span> and the <a id="wrglossary.1332"></a><a href="#glo:dual.locationlist">location list</a> should be labelled <span class="qt">“Location”</span>, then you can create a file called, say, <span class="filefmt">myinstitute-glossaries-dictionary-English.dict</span> that contains the following: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ProvidesDictionary</code>{myinstitute-glossaries-dictionary}{English}
<code class="cmd">\deftranslation</code>{Glossary}{Nomenclature}
<code class="cmd">\deftranslation</code>{Page List (glossaries)}{Location}
-</pre> You can now load it using: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1415"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usedictionary</code>{myinstitute-glossaries-dictionary}
+</pre> You can now load it using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usedictionary</code>{myinstitute-glossaries-dictionary}
</pre> (Make sure that <span class="filefmt">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>
-If you are using <a id="wrglossary.1416"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and don’t want to use the <a id="wrglossary.1417"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> interface, you can use the package option <a id="wrglossary.1418"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1419"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[british]{article}
+If you are using <a id="wrglossary.1333"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and don’t want to use the <a id="wrglossary.1334"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> interface, you can use the package option <a id="wrglossary.1335"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[british]{article}
<code class="cmd">\usepackage</code>{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1420"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1336"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
-<code class="cmd">\addto</code><a id="wrglossary.1421"></a><a href="#glo:captionslanguage"><code class="csfmt">\captionsbritish</code></a>{<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1422"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{List of Terms}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1423"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{List of Acronyms}<span class="comment">% </span>
+<code class="cmd">\addto</code><a id="wrglossary.1337"></a><a href="#glo:captionslanguage"><code class="csfmt">\captionsbritish</code></a>{<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1338"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{List of Terms}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1339"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{List of Acronyms}<span class="comment">% </span>
}
</pre><p>
-Note that <a id="wrglossary.1424"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1425"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> provide much better multi-lingual support than <a id="wrglossary.1426"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, so I recommend that you use Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a> if you have <a id="wrglossary.1427"></a><a href="#glo:dual.glossary">glossary</a> entries that contain <a id="wrglossary.1428"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>. See §<a href="#sec:xindy">14</a> for further details on <a id="wrglossary.1429"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, and see the <a id="wrglossary.1430"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details of that application.<p>
+Note that <a id="wrglossary.1340"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1341"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> provide much better multi-lingual support than <a id="wrglossary.1342"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, so I recommend that you use Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a> if you have <a id="wrglossary.1343"></a><a href="#glo:dual.glossary">glossary</a> entries that contain <a id="wrglossary.1344"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>. See §<a href="#sec:xindy">14</a> for further details on <a id="wrglossary.1345"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, and see the <a id="wrglossary.1346"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details of that application.<p>
</section><!-- end of section sec:fixednames -->
@@ -1902,9 +1928,9 @@
<section id="sec:newlang"><!-- start of section sec:newlang --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.5.2. Creating a New Language Module<div class="labellink"><a href="#sec:newlang">[link]</a></div></h3><!-- end of subsection header -->
<p>
-The <a id="wrglossary.1431"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package now uses the <a id="wrglossary.1432"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></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 <a id="wrglossary.1433"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> documentation.<p>
-To create a new language module, you need to at least create two files called: <a id="wrglossary.1434"></a><a href="#glo:file.glossaries-lang.ldf"><span class="filefmt">glossaries-</span><span class="meta">〈<em class="metainner">lang</em>〉</span><span class="filefmt">.ldf</span></a> and <a id="wrglossary.1435"></a><a href="#glo:file.glossaries-dictionary-Lang.dict"><span class="filefmt">glossaries-dictionary-</span><span class="meta">〈<em class="metainner">Lang</em>〉</span><span class="filefmt">.dict</span></a> where <span class="meta">〈<em class="metainner">lang</em>〉</span> is the root language name (for example, <code class="code">english</code>) and <span class="meta">〈<em class="metainner">Lang</em>〉</span> is the language name used by <a id="wrglossary.1436"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> (for example, <code class="code">English</code>).<p>
-Here’s an example of <a id="wrglossary.1437"></a><a href="#glo:file.glossaries-dictionary-English.dict"><span class="filefmt">glossaries-dictionary-English.dict</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1438"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ProvidesDictionary</code>{glossaries-dictionary}{English}
+The <a id="wrglossary.1347"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package now uses the <a id="wrglossary.1348"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></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 <a id="wrglossary.1349"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> documentation.<p>
+To create a new language module, you need to at least create two files called: <a id="wrglossary.1350"></a><a href="#glo:file.glossaries-lang.ldf"><span class="filefmt">glossaries-</span><span class="meta">〈<em class="metainner">lang</em>〉</span><span class="filefmt">.ldf</span></a> and <a id="wrglossary.1351"></a><a href="#glo:file.glossaries-dictionary-Lang.dict"><span class="filefmt">glossaries-dictionary-</span><span class="meta">〈<em class="metainner">Lang</em>〉</span><span class="filefmt">.dict</span></a> where <span class="meta">〈<em class="metainner">lang</em>〉</span> is the root language name (for example, <code class="code">english</code>) and <span class="meta">〈<em class="metainner">Lang</em>〉</span> is the language name used by <a id="wrglossary.1352"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> (for example, <code class="code">English</code>).<p>
+Here’s an example of <a id="wrglossary.1353"></a><a href="#glo:file.glossaries-dictionary-English.dict"><span class="filefmt">glossaries-dictionary-English.dict</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ProvidesDictionary</code>{glossaries-dictionary}{English}
<code class="cmd">\providetranslation</code>{Glossary}{Glossary}
<code class="cmd">\providetranslation</code>{Acronyms}{Acronyms}
@@ -1914,51 +1940,51 @@
<code class="cmd">\providetranslation</code>{Page List (glossaries)}{Page List}
<code class="cmd">\providetranslation</code>{Symbols (glossaries)}{Symbols}
<code class="cmd">\providetranslation</code>{Numbers (glossaries)}{Numbers}
-</pre> You can use this as a template for your dictionary file. Change <code class="code">English</code> to the <a id="wrglossary.1439"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> name for your language (so that it matches the file name <a id="wrglossary.1440"></a><a href="#glo:file.glossaries-dictionary-Lang.dict"><span class="filefmt">glossaries-dictionary-</span><span class="meta">〈<em class="metainner">Lang</em>〉</span><span class="filefmt">.dict</span></a>) and, for each <code class="csfmt">\providetranslation</code>, change the second argument to the appropriate translation.<p>
-Here’s an example of <a id="wrglossary.1441"></a><a href="#glo:file.glossaries-english.ldf"><span class="filefmt">glossaries-english.ldf</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1442"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1443"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{english}
+</pre> You can use this as a template for your dictionary file. Change <code class="code">English</code> to the <a id="wrglossary.1354"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> name for your language (so that it matches the file name <a id="wrglossary.1355"></a><a href="#glo:file.glossaries-dictionary-Lang.dict"><span class="filefmt">glossaries-dictionary-</span><span class="meta">〈<em class="metainner">Lang</em>〉</span><span class="filefmt">.dict</span></a>) and, for each <code class="csfmt">\providetranslation</code>, change the second argument to the appropriate translation.<p>
+Here’s an example of <a id="wrglossary.1356"></a><a href="#glo:file.glossaries-english.ldf"><span class="filefmt">glossaries-english.ldf</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1357"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{english}
-<a id="wrglossary.1444"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{English}
+<a id="wrglossary.1358"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{English}
{<span class="comment">% </span>
- <a id="wrglossary.1445"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1446"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
- <a id="wrglossary.1447"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1448"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1359"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1360"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1361"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1362"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
}
{<span class="comment">% </span>
<code class="cmd">\@ifpackageloaded</code>{polyglossia}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\newcommand</code>*{<code class="cmd">\glossariescaptionsenglish</code>}{<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1449"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{<code class="cmd">\textenglish</code>{Glossary}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1450"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{<code class="cmd">\textenglish</code>{Acronyms}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1451"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{<code class="cmd">\textenglish</code>{Notation}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1452"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{<code class="cmd">\textenglish</code>{Description}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1453"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{<code class="cmd">\textenglish</code>{Symbol}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1454"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{<code class="cmd">\textenglish</code>{Page List}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1455"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{<code class="cmd">\textenglish</code>{Symbols}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1456"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{<code class="cmd">\textenglish</code>{Numbers}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1363"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{<code class="cmd">\textenglish</code>{Glossary}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1364"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{<code class="cmd">\textenglish</code>{Acronyms}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1365"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{<code class="cmd">\textenglish</code>{Notation}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1366"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{<code class="cmd">\textenglish</code>{Description}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1367"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{<code class="cmd">\textenglish</code>{Symbol}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1368"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{<code class="cmd">\textenglish</code>{Page List}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1369"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{<code class="cmd">\textenglish</code>{Symbols}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1370"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{<code class="cmd">\textenglish</code>{Numbers}}<span class="comment">% </span>
}<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\newcommand</code>*{<code class="cmd">\glossariescaptionsenglish</code>}{<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1457"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Glossary}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1458"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acronyms}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1459"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Notation}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1460"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Description}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1461"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Symbol}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1462"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{Page List}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1463"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Symbols}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1464"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{Numbers}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1371"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Glossary}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1372"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acronyms}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1373"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Notation}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1374"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Description}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1375"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Symbol}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1376"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{Page List}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1377"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Symbols}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1378"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{Numbers}<span class="comment">% </span>
}<span class="comment">% </span>
}<span class="comment">% </span>
- <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1465"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1379"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
{<span class="comment">% </span>
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1466"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1380"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\glossariescaptionsenglish</code>
}<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% </span>
- <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1467"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1381"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
{<span class="comment">% </span>
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1468"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1382"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\glossariescaptionsenglish</code>
}<span class="comment">% </span>
@@ -1968,20 +1994,20 @@
}<span class="comment">% </span>
<code class="cmd">\glossariescaptionsenglish</code>
}
-<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1469"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}{s}
-<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1470"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a>}{<a id="wrglossary.1471"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}
-<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1472"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a>}{<a id="wrglossary.1473"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a>{<a id="wrglossary.1474"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}}
-</pre> This is a somewhat longer file, but again you can use it as a template. Replace <code class="code">English</code> with the <a id="wrglossary.1475"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> language label <span class="meta">〈<em class="metainner">Lang</em>〉</span> used for the dictionary file and replace <code class="code">english</code> with the root language name <span class="meta">〈<em class="metainner">lang</em>〉</span>. Within the definition of <code class="csfmt">\glossariescaptions</code><span class="meta">〈<em class="metainner">lang</em>〉</span>, replace the English text (such as <span class="qt">“Glossaries”</span>) with the appropriate translation.<p>
-<a id="pluralsuffix"></a>The suffixes used to generate the plural forms when the plural hasn’t been specified are given by <a id="wrglossary.1476"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> (for general entries). For <a id="wrglossary.1477"></a><a href="#glo:idx.acronym">acronyms</a> defined with the base <a id="wrglossary.1478"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, <a id="wrglossary.1479"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a> is used for the <a id="wrglossary.1480"></a><a href="#glo:dual.smallcaps">small caps</a> <a id="wrglossary.1481"></a><a href="#glo:idx.acronymstyle">acronym styles</a> where the suffix needs to be set using <a id="wrglossary.1482"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a> to counteract the effects of <a id="wrglossary.1483"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a> and <a id="wrglossary.1484"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a> for other <a id="wrglossary.1485"></a><a href="#glo:idx.acronymstyle">acronym styles</a>. There’s no guarantee when these commands will be expanded. They may be expanded on definition or they may be expanded on use, depending on the <a id="wrglossary.1486"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> configuration.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1487"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Therefore these plural suffix command definitions aren’t included in the <a id="wrglossary.1488"></a><a href="#glo:captionslanguage"><code class="csfmt">\captions<span class="meta">〈<em class="metainner">language</em>〉</span></code></a> hook as that’s typically not switched used until the start of the document. <strong class="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 <a id="wrglossary.1489"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>, <a id="wrglossary.1490"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a>, <a id="wrglossary.1491"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> etc keys to override exceptions. </div><!-- end of important -->
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1383"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}{s}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1384"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a>}{<a id="wrglossary.1385"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1386"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a>}{<a id="wrglossary.1387"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a>{<a id="wrglossary.1388"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}}
+</pre> This is a somewhat longer file, but again you can use it as a template. Replace <code class="code">English</code> with the <a id="wrglossary.1389"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> language label <span class="meta">〈<em class="metainner">Lang</em>〉</span> used for the dictionary file and replace <code class="code">english</code> with the root language name <span class="meta">〈<em class="metainner">lang</em>〉</span>. Within the definition of <code class="csfmt">\glossariescaptions</code><span class="meta">〈<em class="metainner">lang</em>〉</span>, replace the English text (such as <span class="qt">“Glossaries”</span>) with the appropriate translation.<p>
+<a id="pluralsuffix"></a>The suffixes used to generate the plural forms when the plural hasn’t been specified are given by <a id="wrglossary.1390"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> (for general entries). For <a id="wrglossary.1391"></a><a href="#glo:idx.acronym">acronyms</a> defined with the base <a id="wrglossary.1392"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, <a id="wrglossary.1393"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a> is used for the <a id="wrglossary.1394"></a><a href="#glo:dual.smallcaps">small caps</a> <a id="wrglossary.1395"></a><a href="#glo:idx.acronymstyle">acronym styles</a> where the suffix needs to be set using <a id="wrglossary.1396"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a> to counteract the effects of <a id="wrglossary.1397"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a> and <a id="wrglossary.1398"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a> for other <a id="wrglossary.1399"></a><a href="#glo:idx.acronymstyle">acronym styles</a>. There’s no guarantee when these commands will be expanded. They may be expanded on definition or they may be expanded on use, depending on the <a id="wrglossary.1400"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> configuration.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Therefore these plural suffix command definitions aren’t included in the <a id="wrglossary.1401"></a><a href="#glo:captionslanguage"><code class="csfmt">\captions<span class="meta">〈<em class="metainner">language</em>〉</span></code></a> hook as that’s typically not switched used until the start of the document. <strong class="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 <a id="wrglossary.1402"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>, <a id="wrglossary.1403"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a>, <a id="wrglossary.1404"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> etc keys to override exceptions. </div><!-- end of important -->
<p>
-If you want to add a regional variation, create a file called <a id="wrglossary.1492"></a><a href="#glo:file.glossaries-iso-lang-iso-region.ldf"><span class="filefmt">glossaries-</span><span class="meta">〈<em class="metainner">iso-lang</em>〉</span><span class="filefmt">-</span><span class="meta">〈<em class="metainner">iso-region</em>〉</span><span class="filefmt">.ldf</span></a>, where <span class="meta">〈<em class="metainner">iso-lang</em>〉</span> is the ISO language code and <span class="meta">〈<em class="metainner">iso-region</em>〉</span> is the ISO country code. For example, <span class="filefmt">glossaries-en-GB.ldf</span>. This file can load the root language file and make the appropriate changes, for example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1493"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1494"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{en-GB}
- <a id="wrglossary.1495"></a><a href="#glo:RequireGlossariesLang"><code class="csfmt">\RequireGlossariesLang</code></a>{english}
- <a id="wrglossary.1496"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{British}
+If you want to add a regional variation, create a file called <a id="wrglossary.1405"></a><a href="#glo:file.glossaries-iso-lang-iso-region.ldf"><span class="filefmt">glossaries-</span><span class="meta">〈<em class="metainner">iso-lang</em>〉</span><span class="filefmt">-</span><span class="meta">〈<em class="metainner">iso-region</em>〉</span><span class="filefmt">.ldf</span></a>, where <span class="meta">〈<em class="metainner">iso-lang</em>〉</span> is the ISO language code and <span class="meta">〈<em class="metainner">iso-region</em>〉</span> is the ISO country code. For example, <span class="filefmt">glossaries-en-GB.ldf</span>. This file can load the root language file and make the appropriate changes, for example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1406"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{en-GB}
+ <a id="wrglossary.1407"></a><a href="#glo:RequireGlossariesLang"><code class="csfmt">\RequireGlossariesLang</code></a>{english}
+ <a id="wrglossary.1408"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{British}
{<span class="comment">% </span>
- <a id="wrglossary.1497"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1498"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
- <a id="wrglossary.1499"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1500"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1409"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1410"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1411"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1412"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
}
{<span class="comment">% </span>
<code class="cmd">\@ifpackageloaded</code>{polyglossia}<span class="comment">% </span>
@@ -1995,16 +2021,16 @@
}<span class="comment">% </span>
}
</pre><p>
-If the translations includes <a id="wrglossary.1501"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>, it’s a good idea to provide code that’s independent of the input <a id="wrglossary.1502"></a><a href="#glo:idx.encoding">encoding</a>. Remember that while some users may use <a id="wrglossary.1503"></a><a href="#glo:dual.utf8">UTF-8</a> (and it’s now the default <a id="wrglossary.1504"></a><a href="#glo:idx.encoding">encoding</a> with modern LaTeX kernels), others may use Latin-1 or any other supported <a id="wrglossary.1505"></a><a href="#glo:idx.encoding">encoding</a>, but while users won’t appreciate you enforcing your preference on them, it’s useful to provide a <a id="wrglossary.1506"></a><a href="#glo:dual.utf8">UTF-8</a> version.<p>
-The <a id="wrglossary.1507"></a><a href="#glo:file.glossaries-irish.ldf"><span class="filefmt">glossaries-irish.ldf</span></a> file provides this as follows: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1508"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1509"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{irish}
+If the translations includes <a id="wrglossary.1413"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>, it’s a good idea to provide code that’s independent of the input <a id="wrglossary.1414"></a><a href="#glo:idx.encoding">encoding</a>. Remember that while some users may use <a id="wrglossary.1415"></a><a href="#glo:dual.utf8">UTF-8</a> (and it’s now the default <a id="wrglossary.1416"></a><a href="#glo:idx.encoding">encoding</a> with modern LaTeX kernels), others may use Latin-1 or any other supported <a id="wrglossary.1417"></a><a href="#glo:idx.encoding">encoding</a>, but while users won’t appreciate you enforcing your preference on them, it’s useful to provide a <a id="wrglossary.1418"></a><a href="#glo:dual.utf8">UTF-8</a> version.<p>
+The <a id="wrglossary.1419"></a><a href="#glo:file.glossaries-irish.ldf"><span class="filefmt">glossaries-irish.ldf</span></a> file provides this as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1420"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{irish}
-<a id="wrglossary.1510"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{Irish}
+<a id="wrglossary.1421"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{Irish}
{<span class="comment">% </span>
- <a id="wrglossary.1511"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1512"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
- <a id="wrglossary.1513"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1514"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1422"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1423"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1424"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1425"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
}
{<span class="comment">% </span>
- <code class="cmd">\ifdefstring</code>{<a id="wrglossary.1515"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>}{utf8}
+ <code class="cmd">\ifdefstring</code>{<a id="wrglossary.1426"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>}{utf8}
{<code class="cmd">\input</code>{glossaries-irish-utf8.ldf}}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\ifdef</code><code class="cmd">\XeTeXinputencoding</code><span class="comment">% XeTeX defaults to UTF-8</span>
@@ -2011,17 +2037,17 @@
{<code class="cmd">\input</code>{glossaries-irish-utf8.ldf}}<span class="comment">% </span>
{<code class="cmd">\input</code>{glossaries-irish-noenc.ldf}}
}
- <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1516"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1427"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
{<span class="comment">% </span>
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1517"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1428"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\glossariescaptionsirish</code>
}<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% </span>
- <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1518"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1429"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
{
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1519"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1430"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\glossariescaptionsirish</code>
}<span class="comment">% </span>
@@ -2031,34 +2057,34 @@
}<span class="comment">% </span>
<code class="cmd">\glossariescaptionsirish</code>
}
-</pre> (Again you can use this as a template. Replace <code class="code">irish</code> with your root language label and <code class="code">Irish</code> with the <a id="wrglossary.1520"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary label.)<p>
-There are now two extra files: <span class="filefmt">glossaries-irish-noenc.ldf</span> (no <a id="wrglossary.1521"></a><a href="#glo:idx.encoding">encoding</a> information) and <span class="filefmt">glossaries-irish-utf8.ldf</span> (<a id="wrglossary.1522"></a><a href="#glo:dual.utf8">UTF-8</a>).<p>
-These both define <code class="csfmt">\glossariescaptionsirish</code> but the <span class="filefmt">*-noenc.ldf</span> file uses LaTeX accent commands: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1523"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\@ifpackageloaded</code>{polyglossia}<span class="comment">% </span>
+</pre> (Again you can use this as a template. Replace <code class="code">irish</code> with your root language label and <code class="code">Irish</code> with the <a id="wrglossary.1431"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary label.)<p>
+There are now two extra files: <span class="filefmt">glossaries-irish-noenc.ldf</span> (no <a id="wrglossary.1432"></a><a href="#glo:idx.encoding">encoding</a> information) and <span class="filefmt">glossaries-irish-utf8.ldf</span> (<a id="wrglossary.1433"></a><a href="#glo:dual.utf8">UTF-8</a>).<p>
+These both define <code class="csfmt">\glossariescaptionsirish</code> but the <span class="filefmt">*-noenc.ldf</span> file uses LaTeX accent commands: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\@ifpackageloaded</code>{polyglossia}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\newcommand</code>*{<code class="cmd">\glossariescaptionsirish</code>}{<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1524"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{<code class="cmd">\textirish</code>{Gluais}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1525"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{<code class="cmd">\textirish</code>{Acrainmneacha}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1526"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{<code class="cmd">\textirish</code>{Ciall}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1527"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{<code class="cmd">\textirish</code>{Tuairisc}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1528"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{<code class="cmd">\textirish</code>{Comhartha}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1529"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{<code class="cmd">\textirish</code>{Comhartha<a id="wrglossary.1530"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a><code class="cmd">\i</code>}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1531"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{<code class="cmd">\textirish</code>{Leathanaigh}}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1532"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{<code class="cmd">\textirish</code>{Uimhreacha}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1434"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{<code class="cmd">\textirish</code>{Gluais}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1435"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{<code class="cmd">\textirish</code>{Acrainmneacha}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1436"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{<code class="cmd">\textirish</code>{Ciall}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1437"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{<code class="cmd">\textirish</code>{Tuairisc}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1438"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{<code class="cmd">\textirish</code>{Comhartha}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1439"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{<code class="cmd">\textirish</code>{Comhartha<a id="wrglossary.1440"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a><code class="cmd">\i</code>}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1441"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{<code class="cmd">\textirish</code>{Leathanaigh}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1442"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{<code class="cmd">\textirish</code>{Uimhreacha}}<span class="comment">% </span>
}<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\newcommand</code>*{<code class="cmd">\glossariescaptionsirish</code>}{<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1533"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Gluais}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1534"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acrainmneacha}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1535"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Ciall}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1536"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Tuairisc}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1537"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Comhartha}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1538"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Comhartha<a id="wrglossary.1539"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a><code class="cmd">\i</code>}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1540"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{Leathanaigh}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1541"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{Uimhreacha}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1443"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Gluais}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1444"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acrainmneacha}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1445"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Ciall}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1446"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Tuairisc}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1447"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Comhartha}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1448"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Comhartha<a id="wrglossary.1449"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a><code class="cmd">\i</code>}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1450"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{Leathanaigh}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1451"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{Uimhreacha}<span class="comment">% </span>
}<span class="comment">% </span>
}
-</pre> whereas the <span class="filefmt">*-utf8.ldf</span> file replaces the accent commands with the appropriate <a id="wrglossary.1542"></a><a href="#glo:dual.utf8">UTF-8</a> characters.<p>
+</pre> whereas the <span class="filefmt">*-utf8.ldf</span> file replaces the accent commands with the appropriate <a id="wrglossary.1452"></a><a href="#glo:dual.utf8">UTF-8</a> characters.<p>
</section><!-- end of section sec:newlang -->
@@ -2065,51 +2091,51 @@
<section id="sec:makeglossaries"><!-- start of section sec:makeglossaries --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.6. Generating the Associated Glossary Files<div class="labellink"><a href="#sec:makeglossaries">[link]</a></div></h2><!-- end of section header -->
<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1543"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-This section is only applicable if you have chosen Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.b2g">4</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 <a id="wrglossary.1544"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key if the <a id="wrglossary.1545"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> contains any LaTeX commands (except if you’re using <a id="wrglossary.1546"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). </div><!-- end of important -->
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This section is only applicable if you have chosen Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.b2g">4</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 <a id="wrglossary.1453"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key if the <a id="wrglossary.1454"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> contains any LaTeX commands (except if you’re using <a id="wrglossary.1455"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). </div><!-- end of important -->
<p>
-If this section seriously confuses you, and you can’t work out how to run external tools like <a id="wrglossary.1547"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1548"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, you can try using the <a id="wrglossary.1549"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a> package option, described in §<a href="#sec:pkgopts-sort">2.5</a>, but you will need TeX’s <a id="wrglossary.1550"></a><a href="#glo:dual.shellescape">shell escape</a> 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>
-In order to generate a sorted <a id="wrglossary.1551"></a><a href="#glo:dual.glossary">glossary</a> with compact <a id="wrglossary.1552"></a><a href="#glo:locationlist">number lists</a>, it is necessary to use an external <a id="wrglossary.1553"></a><a href="#glo:dual.indexingapp">indexing application</a> as an intermediate step (unless you have chosen <a id="wrglossary.1554"></a><a href="#glo:idx.opt.noidx">Option 1</a>, which uses TeX to do the sorting or <a id="wrglossary.1555"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, which doesn’t perform any sorting). It is this application that creates the file containing the code required to typeset the <a id="wrglossary.1556"></a><a href="#glo:dual.glossary">glossary</a>. <strong class="strong">If this step is omitted, the <a id="wrglossary.1557"></a><a href="#glo:dual.glossary">glossaries</a> will not appear in your document.</strong> The two <a id="wrglossary.1558"></a><a href="#glo:dual.indexingapp">indexing applications</a> that are most commonly used with LaTeX are <a id="wrglossary.1559"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.1560"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. As from version 1.17, the <span class="styfmt">glossaries</span> package can be used with either of these applications. Previous versions were designed to be used with <a id="wrglossary.1561"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> only. With the <a id="wrglossary.1562"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package, you can also use <a id="wrglossary.1563"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as the <a id="wrglossary.1564"></a><a href="#glo:dual.indexingapp">indexing application</a>. (See the <a id="wrglossary.1565"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1566"></a><a href="#glo:app.bib2gls"><span class="app!
fmt">bib2gls</span></a> user manuals for further details.) Note that <a id="wrglossary.1567"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1568"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> have much better multi-lingual support than <a id="wrglossary.1569"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, so <a id="wrglossary.1570"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1571"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> are recommended if you’re not writing in English. Commands that only have an effect when <a id="wrglossary.1572"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is used are described in §<a href="#sec:xindy">14</a>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1573"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-This is a multi-stage process, but there are methods of automating document compilation using applications such as <a id="wrglossary.1574"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> and <a id="wrglossary.1575"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>. With <a id="wrglossary.1576"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can just add special comments to your document source: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1577"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
+If this section seriously confuses you, and you can’t work out how to run external tools like <a id="wrglossary.1456"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1457"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, you can try using the <a id="wrglossary.1458"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a> package option, described in §<a href="#sec:pkgopts-sort">2.5</a>, but you will need TeX’s <a id="wrglossary.1459"></a><a href="#glo:dual.shellescape">shell escape</a> 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>
+In order to generate a sorted <a id="wrglossary.1460"></a><a href="#glo:dual.glossary">glossary</a> with compact <a id="wrglossary.1461"></a><a href="#glo:locationlist">number lists</a>, it is necessary to use an external <a id="wrglossary.1462"></a><a href="#glo:dual.indexingapp">indexing application</a> as an intermediate step (unless you have chosen <a id="wrglossary.1463"></a><a href="#glo:idx.opt.noidx">Option 1</a>, which uses TeX to do the sorting or <a id="wrglossary.1464"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, which doesn’t perform any sorting). It is this application that creates the file containing the code required to typeset the <a id="wrglossary.1465"></a><a href="#glo:dual.glossary">glossary</a>. <strong class="strong">If this step is omitted, the <a id="wrglossary.1466"></a><a href="#glo:dual.glossary">glossaries</a> will not appear in your document.</strong> The two <a id="wrglossary.1467"></a><a href="#glo:dual.indexingapp">indexing applications</a> that are most commonly used with LaTeX are <a id="wrglossary.1468"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.1469"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. As from version 1.17, the <span class="styfmt">glossaries</span> package can be used with either of these applications. Previous versions were designed to be used with <a id="wrglossary.1470"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> only. With the <a id="wrglossary.1471"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package, you can also use <a id="wrglossary.1472"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as the <a id="wrglossary.1473"></a><a href="#glo:dual.indexingapp">indexing application</a>. (See the <a id="wrglossary.1474"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1475"></a><a href="#glo:app.bib2gls"><sp!
an class="appfmt">bib2gls</span></a> user manuals for further details.) Note that <a id="wrglossary.1476"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1477"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> have much better multi-lingual support than <a id="wrglossary.1478"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, so <a id="wrglossary.1479"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1480"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> are recommended if you’re not writing in English. Commands that only have an effect when <a id="wrglossary.1481"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is used are described in §<a href="#sec:xindy">14</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This is a multi-stage process, but there are methods of automating document compilation using applications such as <a id="wrglossary.1482"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> and <a id="wrglossary.1483"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>. With <a id="wrglossary.1484"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can just add special comments to your document source: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
% arara: makeglossaries
% arara: pdflatex
-</pre> With <a id="wrglossary.1578"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> you need to set up the required dependencies. </div><!-- end of important -->
+</pre> With <a id="wrglossary.1485"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> you need to set up the required dependencies. </div><!-- end of important -->
<p>
-The <a id="wrglossary.1579"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with the Perl script <a id="wrglossary.1580"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> which will run <a id="wrglossary.1581"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1582"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> on all the <a id="wrglossary.1583"></a><a href="#glo:dual.indexingfile">indexing files</a> using a customized style file (which is created by <a id="wrglossary.1584"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). See §<a href="#sec:makeglossariesapp">1.6.1</a> for further details. Perl is stable, cross-platform, open source software that is used by a number of TeX-related applications (including <a id="wrglossary.1585"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1586"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a>). Most Unix-like operating systems come with a Perl interpreter. TeX Live also comes with a Perl interpreter. As far as I know, 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 id="wrglossary.1587"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1588"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. Further information is available at <a href="http://www.perl.org/about.html">http://www.perl.org/about.html</a> and <a href="https://tex.stackexchange.com/questions/158796">MikTeX and Perl scripts (and one Python script)</a>.<p>
-The advantages of using <a id="wrglossary.1589"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>:
+The <a id="wrglossary.1486"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with the Perl script <a id="wrglossary.1487"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> which will run <a id="wrglossary.1488"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1489"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> on all the <a id="wrglossary.1490"></a><a href="#glo:dual.indexingfile">indexing files</a> using a customized style file (which is created by <a id="wrglossary.1491"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). See §<a href="#sec:makeglossariesapp">1.6.1</a> for further details. Perl is stable, cross-platform, open source software that is used by a number of TeX-related applications (including <a id="wrglossary.1492"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1493"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a>). Most Unix-like operating systems come with a Perl interpreter. TeX Live also comes with a Perl interpreter. As far as I know, 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 id="wrglossary.1494"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1495"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. Further information is available at <a href="http://www.perl.org/about.html">http://www.perl.org/about.html</a> and <a href="https://tex.stackexchange.com/questions/158796">MikTeX and Perl scripts (and one Python script)</a>.<p>
+The advantages of using <a id="wrglossary.1496"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>:
<ul class="displaylist">
- <li><span class="bulletitem">•</span>It automatically detects whether to use <a id="wrglossary.1590"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1591"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and sets the relevant application switches.<p>
-<li><span class="bulletitem">•</span>One call of <a id="wrglossary.1592"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will run <a id="wrglossary.1593"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1594"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> for each <a id="wrglossary.1595"></a><a href="#glo:dual.glossary">glossary</a> type.<p>
-<li><span class="bulletitem">•</span>If things go wrong, <a id="wrglossary.1596"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will scan the messages from <a id="wrglossary.1597"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1598"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and attempt to diagnose the problem in relation to the <a id="wrglossary.1599"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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 <a id="wrglossary.1600"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1601"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> messages.<p>
-<li><span class="bulletitem">•</span>If <a id="wrglossary.1602"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about <a id="wrglossary.1603"></a><a href="#glo:idx.multipleencap">multiple encap</a> values, <a id="wrglossary.1604"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> v2.18+ will detect this and attempt to correct the problem. This correction is only provided by <a id="wrglossary.1605"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when <a id="wrglossary.1606"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is used since <a id="wrglossary.1607"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> uses the order of the <a id="wrglossary.1608"></a><a href="#glo:@@glslabel at xindyattr">attributes list</a> to determine which format should take precedence. (see §<a href="#sec:xindyloc">14.3</a>.) This correction can be switched off with the <a id="wrglossary.1609"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a> switch.<p>
-<li><span class="bulletitem">•</span>If <a id="wrglossary.1610"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about invalid or <a id="wrglossary.1611"></a><a href="#glo:idx.emptylocation">empty locations</a>, <a id="wrglossary.1612"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> v4.50+ will detect this and attempt to alter the location to fit <a id="wrglossary.1613"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> syntax. This may or may not cause unexpected results in the <a id="wrglossary.1614"></a><a href="#glo:dual.locationlist">location list</a>, but it’s useful if the <a id="wrglossary.1615"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option is used.<p>
-<li><span class="bulletitem">•</span>If <a id="wrglossary.1616"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> has a warning that could be the result of a command occurring within the <a id="wrglossary.1617"></a><a href="#glo:@@glslabel at entrylocation">location</a>, <a id="wrglossary.1618"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> v4.50+ will attempt to repair it by moving the command out of the location and into the <a id="wrglossary.1619"></a><a href="#glo:locationencap">encap</a>.<p>
+ <li><span class="bulletitem">•</span>It automatically detects whether to use <a id="wrglossary.1497"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1498"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and sets the relevant application switches.<p>
+<li><span class="bulletitem">•</span>One call of <a id="wrglossary.1499"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will run <a id="wrglossary.1500"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1501"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> for each <a id="wrglossary.1502"></a><a href="#glo:dual.glossary">glossary</a> type.<p>
+<li><span class="bulletitem">•</span>If things go wrong, <a id="wrglossary.1503"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will scan the messages from <a id="wrglossary.1504"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1505"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and attempt to diagnose the problem in relation to the <a id="wrglossary.1506"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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 <a id="wrglossary.1507"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1508"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> messages.<p>
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1509"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about <a id="wrglossary.1510"></a><a href="#glo:idx.multipleencap">multiple encap</a> values, <a id="wrglossary.1511"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> v2.18+ will detect this and attempt to correct the problem. This correction is only provided by <a id="wrglossary.1512"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when <a id="wrglossary.1513"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is used since <a id="wrglossary.1514"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> uses the order of the <a id="wrglossary.1515"></a><a href="#glo:@@glslabel at xindyattr">attributes list</a> to determine which format should take precedence. (see §<a href="#sec:xindyloc">14.3</a>.) This correction can be switched off with the <a id="wrglossary.1516"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a> switch.<p>
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1517"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about invalid or <a id="wrglossary.1518"></a><a href="#glo:idx.emptylocation">empty locations</a>, <a id="wrglossary.1519"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> v4.50+ will detect this and attempt to alter the location to fit <a id="wrglossary.1520"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> syntax. This may or may not cause unexpected results in the <a id="wrglossary.1521"></a><a href="#glo:dual.locationlist">location list</a>, but it’s useful if the <a id="wrglossary.1522"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option is used.<p>
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1523"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> has a warning that could be the result of a command occurring within the <a id="wrglossary.1524"></a><a href="#glo:@@glslabel at entrylocation">location</a>, <a id="wrglossary.1525"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> v4.50+ will attempt to repair it by moving the command out of the location and into the <a id="wrglossary.1526"></a><a href="#glo:locationencap">encap</a>.<p>
</ul>
- The first two items also apply to <a id="wrglossary.1620"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.<p>
-As from version 4.16, the <a id="wrglossary.1621"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package also comes with a Lua script called <a id="wrglossary.1622"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>. This is a <span style="font-style: italic; font-variant: normal; ">trimmed-down</span> alternative to the <a id="wrglossary.1623"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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 id="wrglossary.1624"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> so it’s an alternative to <a id="wrglossary.1625"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> if you want to use <a id="wrglossary.1626"></a><a href="#glo:idx.opt.mkidx">Option 2</a> (<a id="wrglossary.1627"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>).<p>
-If things go wrong and you can’t work out why your <a id="wrglossary.1628"></a><a href="#glo:dual.glossary">glossaries</a> aren’t being generated correctly, you can use <a id="wrglossary.1629"></a><a href="#glo:app.makeglossariesgui"><span class="appfmt">makeglossariesgui</span></a> as a diagnostic tool. Once you’ve fixed the problem, you can then go back to using <a id="wrglossary.1630"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1631"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.<p>
-Whilst I strongly recommended that you use the <a id="wrglossary.1632"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script or the <a id="wrglossary.1633"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> Lua script, it is possible to use the <a id="wrglossary.1634"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package without using those applications. However, note that some commands and package options have no effect if you explicitly run <a id="wrglossary.1635"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1636"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. These are listed in Table <a href="#tab:makeglossariesCmds">1.3</a>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1637"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-If you are choosing not to use <a id="wrglossary.1638"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you don’t want to install Perl, you will only be able to use <a id="wrglossary.1639"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> as <a id="wrglossary.1640"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> also requires Perl. (Other useful Perl scripts include <span class="appfmt">epstopdf</span> and <a id="wrglossary.1641"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a>, so it’s well-worth the effort to install Perl.) </div><!-- end of important -->
+ The first two items also apply to <a id="wrglossary.1527"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.<p>
+As from version 4.16, the <a id="wrglossary.1528"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package also comes with a Lua script called <a id="wrglossary.1529"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>. This is a <span style="font-style: italic; font-variant: normal; ">trimmed-down</span> alternative to the <a id="wrglossary.1530"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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 id="wrglossary.1531"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> so it’s an alternative to <a id="wrglossary.1532"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> if you want to use <a id="wrglossary.1533"></a><a href="#glo:idx.opt.mkidx">Option 2</a> (<a id="wrglossary.1534"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>).<p>
+If things go wrong and you can’t work out why your <a id="wrglossary.1535"></a><a href="#glo:dual.glossary">glossaries</a> aren’t being generated correctly, you can use <a id="wrglossary.1536"></a><a href="#glo:app.makeglossariesgui"><span class="appfmt">makeglossariesgui</span></a> as a diagnostic tool. Once you’ve fixed the problem, you can then go back to using <a id="wrglossary.1537"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1538"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.<p>
+Whilst I strongly recommended that you use the <a id="wrglossary.1539"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script or the <a id="wrglossary.1540"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> Lua script, it is possible to use the <a id="wrglossary.1541"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package without using those applications. However, note that some commands and package options have no effect if you explicitly run <a id="wrglossary.1542"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1543"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. These are listed in Table <a href="#tab:makeglossariesCmds">1.3</a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you are choosing not to use <a id="wrglossary.1544"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you don’t want to install Perl, you will only be able to use <a id="wrglossary.1545"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> as <a id="wrglossary.1546"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> also requires Perl. (Other useful Perl scripts include <span class="appfmt">epstopdf</span> and <a id="wrglossary.1547"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a>, so it’s well-worth the effort to install Perl.) </div><!-- end of important -->
<p>
-Below, references to <a id="wrglossary.1642"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> can usually be substituted with <a id="wrglossary.1643"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>, except where noted otherwise.<p>
-If any of your entries use an entry that is not referenced outside the <a id="wrglossary.1644"></a><a href="#glo:dual.glossary">glossary</a> (for example, the entry is only referenced in the description of another entry), you will need to do an additional <a id="wrglossary.1645"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1646"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1647"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> run, as appropriate. For example, suppose you have defined the following entries: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1648"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1649"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{citrusfruit}{<a id="wrglossary.1650"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={citrus fruit}</span>,
-<a id="wrglossary.1651"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={fruit of any citrus tree. (See also <a id="wrglossary.1652"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{orange})}</span>}
+Below, references to <a id="wrglossary.1548"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> can usually be substituted with <a id="wrglossary.1549"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>, except where noted otherwise.<p>
+If any of your entries use an entry that is not referenced outside the <a id="wrglossary.1550"></a><a href="#glo:dual.glossary">glossary</a> (for example, the entry is only referenced in the description of another entry), you will need to do an additional <a id="wrglossary.1551"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1552"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1553"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> run, as appropriate. For example, suppose you have defined the following entries: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1554"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{citrusfruit}{<a id="wrglossary.1555"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={citrus fruit}</span>,
+<a id="wrglossary.1556"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={fruit of any citrus tree. (See also <a id="wrglossary.1557"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{orange})}</span>}
-<a id="wrglossary.1653"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{orange}{<a id="wrglossary.1654"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={orange}</span>,
-<a id="wrglossary.1655"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an orange coloured fruit.}</span>}
-</pre> and suppose you have <code class="code"><a id="wrglossary.1656"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{citrusfruit}</code> in your document but don’t reference the <span class="qt">“orange”</span> entry, then the orange entry won’t appear in your <a id="wrglossary.1657"></a><a href="#glo:dual.glossary">glossary</a> until you first create the <a id="wrglossary.1658"></a><a href="#glo:dual.glossary">glossary</a> and then do another run of <a id="wrglossary.1659"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1660"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1661"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. For example, if the document is called <span class="filefmt">myDoc.tex</span>, then you must do: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1662"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
+<a id="wrglossary.1558"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{orange}{<a id="wrglossary.1559"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={orange}</span>,
+<a id="wrglossary.1560"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an orange coloured fruit.}</span>}
+</pre> and suppose you have <code class="code"><a id="wrglossary.1561"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{citrusfruit}</code> in your document but don’t reference the <span class="qt">“orange”</span> entry, then the orange entry won’t appear in your <a id="wrglossary.1562"></a><a href="#glo:dual.glossary">glossary</a> until you first create the <a id="wrglossary.1563"></a><a href="#glo:dual.glossary">glossary</a> and then do another run of <a id="wrglossary.1564"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1565"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1566"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. For example, if the document is called <span class="filefmt">myDoc.tex</span>, then you must do: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
makeglossaries myDoc
pdflatex myDoc
makeglossaries myDoc
pdflatex myDoc
-</pre> (In the case of <a id="wrglossary.1663"></a><a href="#glo:idx.opt.b2g">Option 4</a>, <a id="wrglossary.1664"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will scan the description for instances of commands like <a id="wrglossary.1665"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to ensure they are selected but an extra <a id="wrglossary.1666"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call is required to ensure the <a id="wrglossary.1667"></a><a href="#glo:@@glslabel at entrylocation">locations</a> are included, if <a id="wrglossary.1668"></a><a href="#glo:dual.locationlist">location lists</a> are required. See the and <a id="wrglossary.1669"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.)<p>
-Likewise, an additional <a id="wrglossary.1670"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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 id="wrglossary.1671"></a><a href="#glo:locationlist">number lists</a> in the glossary may need updating.<p>
-The examples in this document assume that you are accessing <a id="wrglossary.1672"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1673"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1674"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> via a terminal. Windows users can use the command prompt which is usually accessed via the <kbd class="menu"><kbd class="menuitem"><samp>Start</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>All Programs</samp></kbd></kbd> menu or <kbd class="menu"><kbd class="menuitem"><samp>Start</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>All Programs</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>Accessories</samp></kbd></kbd> menu or <kbd class="menu"><kbd class="menuitem"><samp>Start</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>Windows System</samp></kbd></kbd>.<p>
+</pre> (In the case of <a id="wrglossary.1567"></a><a href="#glo:idx.opt.b2g">Option 4</a>, <a id="wrglossary.1568"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will scan the description for instances of commands like <a id="wrglossary.1569"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to ensure they are selected but an extra <a id="wrglossary.1570"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call is required to ensure the <a id="wrglossary.1571"></a><a href="#glo:@@glslabel at entrylocation">locations</a> are included, if <a id="wrglossary.1572"></a><a href="#glo:dual.locationlist">location lists</a> are required. See the and <a id="wrglossary.1573"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.)<p>
+Likewise, an additional <a id="wrglossary.1574"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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 id="wrglossary.1575"></a><a href="#glo:locationlist">number lists</a> in the glossary may need updating.<p>
+The examples in this document assume that you are accessing <a id="wrglossary.1576"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1577"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1578"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> via a terminal. Windows users can use the command prompt which is usually accessed via the <kbd class="menu"><kbd class="menuitem"><samp>Start</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>All Programs</samp></kbd></kbd> menu or <kbd class="menu"><kbd class="menuitem"><samp>Start</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>All Programs</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>Accessories</samp></kbd></kbd> menu or <kbd class="menu"><kbd class="menuitem"><samp>Start</samp></kbd><span title="menu separator" class="icon">➜</span><kbd class="menuitem"><samp>Windows System</samp></kbd></kbd>.<p>
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>
-If any problems occur, remember to check the transcript files (e.g. <a id="wrglossary.1675"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a> or <a id="wrglossary.1676"></a><a href="#glo:ext.alg"><span class="extfmt">alg</span></a>) for messages.<p>
+If any problems occur, remember to check the transcript files (e.g. <a id="wrglossary.1579"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a> or <a id="wrglossary.1580"></a><a href="#glo:ext.alg"><span class="extfmt">alg</span></a>) for messages.<p>
<div class="table"> <table class="tabular-c">
<caption id="tab:makeglossariesCmds">Table 3: Commands and package options that have no effect when using <span class="appfmt">xindy</span> or <span class="appfmt">makeindex</span> explicitly</caption><tr style=""><th class="cell-noborder-rightsep-l">Command or Package Option </th>
<td class="cell-noborder-bothsep-l"> <span style="font-weight: bold; "><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> </span></td>
@@ -2122,13 +2148,13 @@
<td class="cell-noborder-rightsep-l"> default</td>
</tr><tr style=""><td class="cell-noborder-rightsep-l"><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">={lang}</span>,<a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a><span class="optfmt">={code}</span></span> </td>
<td class="cell-noborder-bothsep-l"> N/A </td>
-<td class="cell-noborder-rightsep-l"> use <code class="code"><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> <span class="meta">〈<em class="metainner">lang</em>〉</span> <a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> <span class="meta">〈<em class="metainner">code</em>〉</span></code></td>
-</tr><tr style=""><td class="cell-noborder-rightsep-l"><code class="code"><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a>{<span class="meta">〈<em class="metainner">lang</em>〉</span>}</code> </td>
+<td class="cell-noborder-rightsep-l"> use <code class="code"><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> <span class="meta">〈<em class="metainner">lang</em>〉</span> <a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> <span class="meta">〈<em class="metainner">code</em>〉</span></code></td>
+</tr><tr style=""><td class="cell-noborder-rightsep-l"><code class="code"><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a>{<span class="meta">〈<em class="metainner">lang</em>〉</span>}</code> </td>
<td class="cell-noborder-bothsep-l"> N/A </td>
-<td class="cell-noborder-rightsep-l"> use <code class="code"><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> <span class="meta">〈<em class="metainner">lang</em>〉</span></code></td>
-</tr><tr style=""><td class="cell-noborder-rightsep-l"><code class="code"><a href="#glo:GlsSetXdyCodePage"><code class="csfmt">\GlsSetXdyCodePage</code></a>{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code> </td>
+<td class="cell-noborder-rightsep-l"> use <code class="code"><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> <span class="meta">〈<em class="metainner">lang</em>〉</span></code></td>
+</tr><tr style=""><td class="cell-noborder-rightsep-l"><code class="code"><a href="#glo:GlsSetXdyCodePage"><code class="csfmt">\GlsSetXdyCodePage</code></a>{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code> </td>
<td class="cell-noborder-bothsep-l"> N/A </td>
-<td class="cell-noborder-rightsep-l"> use <code class="code"><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> <span class="meta">〈<em class="metainner">code</em>〉</span></code> </td>
+<td class="cell-noborder-rightsep-l"> use <code class="code"><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> <span class="meta">〈<em class="metainner">code</em>〉</span></code> </td>
</tr></table>
<p>
</div><p>
@@ -2138,90 +2164,90 @@
<section id="sec:makeglossariesapp"><!-- start of section sec:makeglossariesapp --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.6.1. Using the <span class="appfmt">makeglossaries</span> Perl Script<div class="labellink"><a href="#sec:makeglossariesapp">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1677"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div><a id="wrglossary.1678"></a><code class="code"><dfn id="glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></dfn> <span class="meta">〈<em class="metainner">options</em>〉</span> <span class="meta">〈<em class="metainner">aux-file</em>〉</span></code></pre><p>
-The <a id="wrglossary.1679"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script picks up the relevant information from the auxiliary (<a id="wrglossary.1680"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>) file and will either call <a id="wrglossary.1681"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1682"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, depending on the supplied information. Therefore, you only need to pass the document’s name without the extension to <a id="wrglossary.1683"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. For example, if your document is called <span class="filefmt">myDoc.tex</span>, type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1684"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1581"></a><code class="code"><dfn id="glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></dfn> <span class="meta">〈<em class="metainner">options</em>〉</span> <span class="meta">〈<em class="metainner">aux-file</em>〉</span></code></pre><p>
+The <a id="wrglossary.1582"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script picks up the relevant information from the auxiliary (<a id="wrglossary.1583"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>) file and will either call <a id="wrglossary.1584"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1585"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, depending on the supplied information. Therefore, you only need to pass the document’s name without the extension to <a id="wrglossary.1586"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. For example, if your document is called <span class="filefmt">myDoc.tex</span>, type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
makeglossaries myDoc
pdflatex myDoc
-</pre> If you only want one <a id="wrglossary.1685"></a><a href="#glo:dual.glossary">glossary</a> processed (for example, if you are working on a draft of a large document and want to concentrate on one specific <a id="wrglossary.1686"></a><a href="#glo:dual.glossary">glossary</a>) then include the <span class="meta">〈<em class="metainner">out-ext</em>〉</span> extension supplied to <a id="wrglossary.1687"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>, such as <a id="wrglossary.1688"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> for the <a id="wrglossary.1689"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. Note that if you do specify the extension and your document has multiple <a id="wrglossary.1690"></a><a href="#glo:dual.glossary">glossaries</a> defined, then <a id="wrglossary.1691"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will tell you how many <a id="wrglossary.1692"></a><a href="#glo:dual.glossary">glossaries</a> have been ignored unless the <a id="wrglossary.1693"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> has been used.<p>
-Windows users: TeX Live on Windows has its own internal Perl interpreter and provides <span class="filefmt">makeglossaries.exe</span> as a convenient wrapper for the <a id="wrglossary.1694"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script. MikTeX also provides a wrapper <span class="filefmt">makeglossaries.exe</span> but doesn’t provide a Perl interpreter (as far as I know), which is still required even if you run MikTeX’s <span class="filefmt">makeglossaries.exe</span>, so with MikTeX you’ll need to install Perl. There’s more information about this at <a href="https://tex.stackexchange.com/questions/158796">MikTeX and Perl scripts (and one Python script)</a>. <p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.1695"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-When upgrading the <a id="wrglossary.1696"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, make sure you also upgrade your version of <a id="wrglossary.1697"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. The current version is 4.50. </div><!-- end of important -->
+</pre> If you only want one <a id="wrglossary.1587"></a><a href="#glo:dual.glossary">glossary</a> processed (for example, if you are working on a draft of a large document and want to concentrate on one specific <a id="wrglossary.1588"></a><a href="#glo:dual.glossary">glossary</a>) then include the <span class="meta">〈<em class="metainner">out-ext</em>〉</span> extension supplied to <a id="wrglossary.1589"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>, such as <a id="wrglossary.1590"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> for the <a id="wrglossary.1591"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. Note that if you do specify the extension and your document has multiple <a id="wrglossary.1592"></a><a href="#glo:dual.glossary">glossaries</a> defined, then <a id="wrglossary.1593"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will tell you how many <a id="wrglossary.1594"></a><a href="#glo:dual.glossary">glossaries</a> have been ignored unless the <a id="wrglossary.1595"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> has been used.<p>
+Windows users: TeX Live on Windows has its own internal Perl interpreter and provides <span class="filefmt">makeglossaries.exe</span> as a convenient wrapper for the <a id="wrglossary.1596"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script. MikTeX also provides a wrapper <span class="filefmt">makeglossaries.exe</span> but doesn’t provide a Perl interpreter (as far as I know), which is still required even if you run MikTeX’s <span class="filefmt">makeglossaries.exe</span>, so with MikTeX you’ll need to install Perl. There’s more information about this at <a href="https://tex.stackexchange.com/questions/158796">MikTeX and Perl scripts (and one Python script)</a>. <p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+When upgrading the <a id="wrglossary.1597"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, make sure you also upgrade your version of <a id="wrglossary.1598"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. The current version is 4.51. </div><!-- end of important -->
<p>
-Some of the options are only applicable to <a id="wrglossary.1698"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some are only applicable to <a id="wrglossary.1699"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1700"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1701"></a><code class="code"><dfn id="glo:switch.mkgls.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
+Some of the options are only applicable to <a id="wrglossary.1599"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some are only applicable to <a id="wrglossary.1600"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1601"></a><code class="code"><dfn id="glo:switch.mkgls.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
Shows a summary of all available options.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1702"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1703"></a><code class="code"><dfn id="glo:switch.mkgls.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1602"></a><code class="code"><dfn id="glo:switch.mkgls.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
Shows the version details.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1704"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1705"></a><code class="code"><dfn id="glo:switch.mkgls.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
- Dry run mode. This doesn’t actually run <a id="wrglossary.1706"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1707"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> but just prints the command it would execute based on the information given in the <a id="wrglossary.1708"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and the supplied options.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1709"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1710"></a><code class="code"><dfn id="glo:switch.mkgls.d"><span class="shortargfmt">-d</span></dfn> <span class="meta">〈<em class="metainner">directory</em>〉</span></code></div><!-- end of settingsbox -->
- Instructs <a id="wrglossary.1711"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to change to the given directory, which should be where the <a id="wrglossary.1712"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>, <a id="wrglossary.1713"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> etc files are located. For example: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1714"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex -output-directory myTmpDir myDoc
-makeglossaries <a id="wrglossary.1715"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> myTmpDir myDoc
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1603"></a><code class="code"><dfn id="glo:switch.mkgls.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
+ Dry run mode. This doesn’t actually run <a id="wrglossary.1604"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1605"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> but just prints the command it would execute based on the information given in the <a id="wrglossary.1606"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and the supplied options.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1607"></a><code class="code"><dfn id="glo:switch.mkgls.d"><span class="shortargfmt">-d</span></dfn> <span class="meta">〈<em class="metainner">directory</em>〉</span></code></div><!-- end of settingsbox -->
+ Instructs <a id="wrglossary.1608"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to change to the given directory, which should be where the <a id="wrglossary.1609"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>, <a id="wrglossary.1610"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> etc files are located. For example: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex -output-directory myTmpDir myDoc
+makeglossaries <a id="wrglossary.1611"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> myTmpDir myDoc
</pre><p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1716"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1717"></a><code class="code"><dfn id="glo:switch.mkgls.e"><span class="shortargfmt">-e</span></dfn></code></div><!-- end of settingsbox -->
- Don’t check for <a id="wrglossary.1718"></a><a href="#glo:idx.multipleencap">multiple encaps</a> (only applicable with <a id="wrglossary.1719"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>). By default, if you are using <a id="wrglossary.1720"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, <a id="wrglossary.1721"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check the <a id="wrglossary.1722"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> transcript for <a id="wrglossary.1723"></a><a href="#glo:idx.multipleencap">multiple encap</a> warnings. <p>
-The <a id="wrglossary.1724"></a><a href="#glo:idx.multipleencap">multiple encap</a> warning is where different <a id="wrglossary.1725"></a><a href="#glo:dual.locationencap">location encap</a> values (location formats) are used on the same <a id="wrglossary.1726"></a><a href="#glo:@@glslabel at entrylocation">location</a> for the same entry. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1727"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1612"></a><code class="code"><dfn id="glo:switch.mkgls.e"><span class="shortargfmt">-e</span></dfn></code></div><!-- end of settingsbox -->
+ Don’t check for <a id="wrglossary.1613"></a><a href="#glo:idx.multipleencap">multiple encaps</a> (only applicable with <a id="wrglossary.1614"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>). By default, if you are using <a id="wrglossary.1615"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, <a id="wrglossary.1616"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check the <a id="wrglossary.1617"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> transcript for <a id="wrglossary.1618"></a><a href="#glo:idx.multipleencap">multiple encap</a> warnings. <p>
+The <a id="wrglossary.1619"></a><a href="#glo:idx.multipleencap">multiple encap</a> warning is where different <a id="wrglossary.1620"></a><a href="#glo:dual.locationencap">location encap</a> values (location formats) are used on the same <a id="wrglossary.1621"></a><a href="#glo:@@glslabel at entrylocation">location</a> for the same entry. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>{glossaries}
-<a id="wrglossary.1728"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1622"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<a id="wrglossary.1729"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.1730"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.1731"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.1623"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.1624"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.1625"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.1732"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1733"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.1734"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=textbf</span>]{sample}.
-<a id="wrglossary.1735"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.1626"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1627"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.1628"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=textbf</span>]{sample}.
+<a id="wrglossary.1629"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
-</pre> If you explicitly use <a id="wrglossary.1736"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, this will cause a warning and the <a id="wrglossary.1737"></a><a href="#glo:dual.locationlist">location list</a> will be <span class="qt">“1, <span style="font-weight: bold; ">1</span>”</span>. That is, the page number will be repeated with each format. As from v2.18, <a id="wrglossary.1738"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for this warning and, if found, will attempt to correct the problem by removing duplicate locations and retrying. If you actually want the duplicate location, you can prevent <a id="wrglossary.1739"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> from checking and correcting the duplicates with <a id="wrglossary.1740"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>.<p>
-There’s no similar check for <a id="wrglossary.1741"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as <a id="wrglossary.1742"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> won’t produce any warning and will simply discard duplicates.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1743"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1744"></a><code class="code"><dfn id="glo:switch.mkgls.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
- Suppresses messages. The <a id="wrglossary.1745"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script attempts to fork the <a id="wrglossary.1746"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1747"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> process using <code class="code">open()</code> on the piped redirection <code class="code">2>&1 |</code> and parses the processor output to help diagnose problems. If this method fails <a id="wrglossary.1748"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will print an <span class="qt">“Unable to fork”</span> warning and will retry without redirection. Without this redirection, the <a id="wrglossary.1749"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> switch doesn’t work as well. Some operating systems don’t support redirection.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1750"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1751"></a><code class="code"><dfn id="glo:switch.mkgls.Q"><span class="shortargfmt">-Q</span></dfn></code></div><!-- end of settingsbox -->
- Suppresses the <span class="qt">“Unable to fork”</span> warning.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1752"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1753"></a><code class="code"><dfn id="glo:switch.mkgls.k"><span class="shortargfmt">-k</span></dfn></code></div><!-- end of settingsbox -->
- Don’t attempt redirection.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1754"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1755"></a><code class="code"><dfn id="glo:switch.mkgls.m"><span class="shortargfmt">-m</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>makeindex</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- The <a id="wrglossary.1756"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
-If you want to use an application that is capable of reading <a id="wrglossary.1757"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files (including support for <a id="wrglossary.1758"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style files via <a id="wrglossary.1759"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a>), then you can use <a id="wrglossary.1760"></a><a href="#glo:switch.mkgls.m"><span class="shortargfmt">-m</span></a> to specify the alternative application to use instead of <a id="wrglossary.1761"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Note that both <a id="wrglossary.1762"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a> and <a id="wrglossary.1763"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> can read <a id="wrglossary.1764"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files using the default <a id="wrglossary.1765"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> syntax but, as of the time of writing this, they don’t support <a id="wrglossary.1766"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style files.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1767"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1768"></a><code class="code"><dfn id="glo:switch.mkgls.x"><span class="shortargfmt">-x</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>xindy</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- The <a id="wrglossary.1769"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1770"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1771"></a><code class="code"><dfn id="glo:switch.mkgls.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
- Compress intermediate blanks. This will pass <a id="wrglossary.1772"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to <a id="wrglossary.1773"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1774"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1775"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1776"></a><code class="code"><dfn id="glo:switch.mkgls.r"><span class="shortargfmt">-r</span></dfn></code></div><!-- end of settingsbox -->
- Disable implicit page <a id="wrglossary.1777"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1778"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to <a id="wrglossary.1779"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1780"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1781"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1782"></a><code class="code"><dfn id="glo:switch.mkgls.p"><span class="shortargfmt">-p</span></dfn> <span class="meta">〈<em class="metainner">num</em>〉</span></code></div><!-- end of settingsbox -->
- Set the starting page number. This will pass <code class="code"><a id="wrglossary.1783"></a><a href="#glo:switch.mkidx.p"><span class="shortargfmt">-p</span></a> <span class="meta">〈<em class="metainner">num</em>〉</span></code> to <a id="wrglossary.1784"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1785"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-The following switches may be used to override settings written to the <a id="wrglossary.1786"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1787"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1788"></a><code class="code"><dfn id="glo:switch.mkgls.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
- Use letter ordering. This will pass <a id="wrglossary.1789"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1790"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <code class="code"><a id="wrglossary.1791"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1792"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1793"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1794"></a><code class="code"><dfn id="glo:switch.mkgls.L"><span class="shortargfmt">-L</span></dfn> <span class="meta">〈<em class="metainner">language</em>〉</span></code></div><!-- end of settingsbox -->
- The language to pass to <a id="wrglossary.1795"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1796"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1797"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1798"></a><code class="code"><dfn id="glo:switch.mkgls.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
- Employ German word ordering. This will pass <a id="wrglossary.1799"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to <a id="wrglossary.1800"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1801"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1802"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1803"></a><code class="code"><dfn id="glo:switch.mkgls.s"><span class="shortargfmt">-s</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
- Set the style file. This will pass <code class="code"><a id="wrglossary.1804"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> <span class="meta">〈<em class="metainner">filename</em>〉</span></code> to <a id="wrglossary.1805"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <code class="code"><a id="wrglossary.1806"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> <span class="meta">〈<em class="metainner">basename</em>〉</span></code> to <a id="wrglossary.1807"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (where <span class="meta">〈<em class="metainner">basename</em>〉</span> is <span class="meta">〈<em class="metainner">filename</em>〉</span> with the <a id="wrglossary.1808"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension removed). This will generate an error if the extension is <a id="wrglossary.1809"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> when <a id="wrglossary.1810"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called, or if the extension isn’t <a id="wrglossary.1811"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> when <a id="wrglossary.1812"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1813"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1814"></a><code class="code"><dfn id="glo:switch.mkgls.o"><span class="shortargfmt">-o</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
- Sets the output file name. Note that this should only be used when only one <a id="wrglossary.1815"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the output filename to the basename supplied to <a id="wrglossary.1816"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1817"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span> argument of <a id="wrglossary.1818"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1819"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1820"></a><code class="code"><dfn id="glo:switch.mkgls.t"><span class="shortargfmt">-t</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
- Sets the transcript file name. Note that this should only be used when only one <a id="wrglossary.1821"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the transcript filename to the basename supplied to <a id="wrglossary.1822"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1823"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span> argument of <a id="wrglossary.1824"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
+</pre> If you explicitly use <a id="wrglossary.1630"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, this will cause a warning and the <a id="wrglossary.1631"></a><a href="#glo:dual.locationlist">location list</a> will be <span class="qt">“1, <span style="font-weight: bold; ">1</span>”</span>. That is, the page number will be repeated with each format. As from v2.18, <a id="wrglossary.1632"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for this warning and, if found, will attempt to correct the problem by removing duplicate locations and retrying. If you actually want the duplicate location, you can prevent <a id="wrglossary.1633"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> from checking and correcting the duplicates with <a id="wrglossary.1634"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>.<p>
+There’s no similar check for <a id="wrglossary.1635"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as <a id="wrglossary.1636"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> won’t produce any warning and will simply discard duplicates.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1637"></a><code class="code"><dfn id="glo:switch.mkgls.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
+ Suppresses messages. The <a id="wrglossary.1638"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script attempts to fork the <a id="wrglossary.1639"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1640"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> process using <code class="code">open()</code> on the piped redirection <code class="code">2>&1 |</code> and parses the processor output to help diagnose problems. If this method fails <a id="wrglossary.1641"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will print an <span class="qt">“Unable to fork”</span> warning and will retry without redirection. Without this redirection, the <a id="wrglossary.1642"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> switch doesn’t work as well. Some operating systems don’t support redirection.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1643"></a><code class="code"><dfn id="glo:switch.mkgls.Q"><span class="shortargfmt">-Q</span></dfn></code></div><!-- end of settingsbox -->
+ Suppresses the <span class="qt">“Unable to fork”</span> warning.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1644"></a><code class="code"><dfn id="glo:switch.mkgls.k"><span class="shortargfmt">-k</span></dfn></code></div><!-- end of settingsbox -->
+ Don’t attempt redirection.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1645"></a><code class="code"><dfn id="glo:switch.mkgls.m"><span class="shortargfmt">-m</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>makeindex</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The <a id="wrglossary.1646"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
+If you want to use an application that is capable of reading <a id="wrglossary.1647"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files (including support for <a id="wrglossary.1648"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style files via <a id="wrglossary.1649"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a>), then you can use <a id="wrglossary.1650"></a><a href="#glo:switch.mkgls.m"><span class="shortargfmt">-m</span></a> to specify the alternative application to use instead of <a id="wrglossary.1651"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Note that both <a id="wrglossary.1652"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a> and <a id="wrglossary.1653"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> can read <a id="wrglossary.1654"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files using the default <a id="wrglossary.1655"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> syntax but, as of the time of writing this, they don’t support <a id="wrglossary.1656"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style files.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1657"></a><code class="code"><dfn id="glo:switch.mkgls.x"><span class="shortargfmt">-x</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>xindy</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The <a id="wrglossary.1658"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1659"></a><code class="code"><dfn id="glo:switch.mkgls.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
+ Compress intermediate blanks. This will pass <a id="wrglossary.1660"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to <a id="wrglossary.1661"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1662"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1663"></a><code class="code"><dfn id="glo:switch.mkgls.r"><span class="shortargfmt">-r</span></dfn></code></div><!-- end of settingsbox -->
+ Disable implicit page <a id="wrglossary.1664"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1665"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to <a id="wrglossary.1666"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1667"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1668"></a><code class="code"><dfn id="glo:switch.mkgls.p"><span class="shortargfmt">-p</span></dfn> <span class="meta">〈<em class="metainner">num</em>〉</span></code></div><!-- end of settingsbox -->
+ Set the starting page number. This will pass <code class="code"><a id="wrglossary.1669"></a><a href="#glo:switch.mkidx.p"><span class="shortargfmt">-p</span></a> <span class="meta">〈<em class="metainner">num</em>〉</span></code> to <a id="wrglossary.1670"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1671"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+The following switches may be used to override settings written to the <a id="wrglossary.1672"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1673"></a><code class="code"><dfn id="glo:switch.mkgls.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
+ Use letter ordering. This will pass <a id="wrglossary.1674"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1675"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <code class="code"><a id="wrglossary.1676"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1677"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1678"></a><code class="code"><dfn id="glo:switch.mkgls.L"><span class="shortargfmt">-L</span></dfn> <span class="meta">〈<em class="metainner">language</em>〉</span></code></div><!-- end of settingsbox -->
+ The language to pass to <a id="wrglossary.1679"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1680"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1681"></a><code class="code"><dfn id="glo:switch.mkgls.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
+ Employ German word ordering. This will pass <a id="wrglossary.1682"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to <a id="wrglossary.1683"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1684"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1685"></a><code class="code"><dfn id="glo:switch.mkgls.s"><span class="shortargfmt">-s</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
+ Set the style file. This will pass <code class="code"><a id="wrglossary.1686"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> <span class="meta">〈<em class="metainner">filename</em>〉</span></code> to <a id="wrglossary.1687"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <code class="code"><a id="wrglossary.1688"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> <span class="meta">〈<em class="metainner">basename</em>〉</span></code> to <a id="wrglossary.1689"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (where <span class="meta">〈<em class="metainner">basename</em>〉</span> is <span class="meta">〈<em class="metainner">filename</em>〉</span> with the <a id="wrglossary.1690"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension removed). This will generate an error if the extension is <a id="wrglossary.1691"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> when <a id="wrglossary.1692"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called, or if the extension isn’t <a id="wrglossary.1693"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> when <a id="wrglossary.1694"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1695"></a><code class="code"><dfn id="glo:switch.mkgls.o"><span class="shortargfmt">-o</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
+ Sets the output file name. Note that this should only be used when only one <a id="wrglossary.1696"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the output filename to the basename supplied to <a id="wrglossary.1697"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1698"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span> argument of <a id="wrglossary.1699"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1700"></a><code class="code"><dfn id="glo:switch.mkgls.t"><span class="shortargfmt">-t</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
+ Sets the transcript file name. Note that this should only be used when only one <a id="wrglossary.1701"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the transcript filename to the basename supplied to <a id="wrglossary.1702"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1703"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span> argument of <a id="wrglossary.1704"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
</section><!-- end of section sec:makeglossariesapp -->
@@ -2228,61 +2254,61 @@
<section id="sec:makeglossarieslua"><!-- start of section sec:makeglossarieslua --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.6.2. Using the <span class="appfmt">makeglossaries-lite</span> Lua Script<div class="labellink"><a href="#sec:makeglossarieslua">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1825"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div><a id="wrglossary.1826"></a><code class="code"><dfn id="glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></dfn> <span class="meta">〈<em class="metainner">options</em>〉</span> <span class="meta">〈<em class="metainner">aux-file</em>〉</span></code></pre><p>
-The Lua alternative to the <a id="wrglossary.1827"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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 id="wrglossary.1828"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> script is therefore limited by this and some of the options available to the <a id="wrglossary.1829"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script aren’t available here. (In particular the <a id="wrglossary.1830"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> option.) Whilst it may be possible to implement those features by requiring Lua packages, this would defeat the purpose of providing this script for those don’t want the inconvenience of learning how to install interpreters or their associated packages.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.1831"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1705"></a><code class="code"><dfn id="glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></dfn> <span class="meta">〈<em class="metainner">options</em>〉</span> <span class="meta">〈<em class="metainner">aux-file</em>〉</span></code></pre><p>
+The Lua alternative to the <a id="wrglossary.1706"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></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 id="wrglossary.1707"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> script is therefore limited by this and some of the options available to the <a id="wrglossary.1708"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script aren’t available here. (In particular the <a id="wrglossary.1709"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> option.) Whilst it may be possible to implement those features by requiring Lua packages, this would defeat the purpose of providing this script for those don’t want the inconvenience of learning how to install interpreters or their associated packages.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
The script is actually supplied as <span class="filefmt">makeglossaries-lite.lua</span> but TeX distributions on Windows convert this to an executable wrapper <span class="filefmt">makeglossaries-lite.exe</span> and TeX Live on Unix-like systems provide a symbolic link without the extension. </div><!-- end of information -->
<p>
-The <a id="wrglossary.1832"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> script can be invoked in the same way as <a id="wrglossary.1833"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. For example, if your document is called <span class="filefmt">myDoc.tex</span>, then do <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1834"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeglossaries-lite myDoc
-</pre> Note that the <a id="wrglossary.1835"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> rule doesn’t contain the hyphen: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1836"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: makeglossarieslite
+The <a id="wrglossary.1710"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> script can be invoked in the same way as <a id="wrglossary.1711"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. For example, if your document is called <span class="filefmt">myDoc.tex</span>, then do <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeglossaries-lite myDoc
+</pre> Note that the <a id="wrglossary.1712"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> rule doesn’t contain the hyphen: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: makeglossarieslite
</pre><p>
-Some of the options are only applicable to <a id="wrglossary.1837"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some are only applicable to <a id="wrglossary.1838"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1839"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1840"></a><code class="code"><dfn id="glo:switch.mkglslite.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
+Some of the options are only applicable to <a id="wrglossary.1713"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some are only applicable to <a id="wrglossary.1714"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1715"></a><code class="code"><dfn id="glo:switch.mkglslite.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
Shows a summary of all available options.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1841"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1842"></a><code class="code"><dfn id="glo:switch.mkglslite.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1716"></a><code class="code"><dfn id="glo:switch.mkglslite.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
Shows the version details.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1843"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1844"></a><code class="code"><dfn id="glo:switch.mkglslite.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
- Dry run mode. This doesn’t actually run <a id="wrglossary.1845"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1846"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> but just prints the command it would execute based on the information given in the <a id="wrglossary.1847"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and the supplied options.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1848"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1849"></a><code class="code"><dfn id="glo:switch.mkglslite.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1717"></a><code class="code"><dfn id="glo:switch.mkglslite.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
+ Dry run mode. This doesn’t actually run <a id="wrglossary.1718"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1719"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> but just prints the command it would execute based on the information given in the <a id="wrglossary.1720"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and the supplied options.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1721"></a><code class="code"><dfn id="glo:switch.mkglslite.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
Quiet mode. This suppresses some but not all messages.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1850"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1851"></a><code class="code"><dfn id="glo:switch.mkglslite.m"><span class="shortargfmt">-m</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>makeindex</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- The <a id="wrglossary.1852"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1853"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1854"></a><code class="code"><dfn id="glo:switch.mkglslite.x"><span class="shortargfmt">-x</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>xindy</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- The <a id="wrglossary.1855"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1856"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1857"></a><code class="code"><dfn id="glo:switch.mkglslite.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
- Compress intermediate blanks. This will pass <a id="wrglossary.1858"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to <a id="wrglossary.1859"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1860"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1861"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1862"></a><code class="code"><dfn id="glo:switch.mkglslite.r"><span class="shortargfmt">-r</span></dfn></code></div><!-- end of settingsbox -->
- Disable implicit page <a id="wrglossary.1863"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1864"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to <a id="wrglossary.1865"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1866"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1867"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1868"></a><code class="code"><dfn id="glo:switch.mkglslite.p"><span class="shortargfmt">-p</span></dfn> <span class="meta">〈<em class="metainner">num</em>〉</span></code></div><!-- end of settingsbox -->
- Set the starting page number. This will pass <code class="code"><a id="wrglossary.1869"></a><a href="#glo:switch.mkidx.p"><span class="shortargfmt">-p</span></a> <span class="meta">〈<em class="metainner">num</em>〉</span></code> to <a id="wrglossary.1870"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1871"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-The following switches may be used to override settings written to the <a id="wrglossary.1872"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1873"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1874"></a><code class="code"><dfn id="glo:switch.mkglslite.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
- Use letter ordering. This will pass <a id="wrglossary.1875"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1876"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <code class="code"><a id="wrglossary.1877"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1878"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1879"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1880"></a><code class="code"><dfn id="glo:switch.mkglslite.L"><span class="shortargfmt">-L</span></dfn> <span class="meta">〈<em class="metainner">language</em>〉</span></code></div><!-- end of settingsbox -->
- The language to pass to <a id="wrglossary.1881"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1882"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1883"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1884"></a><code class="code"><dfn id="glo:switch.mkglslite.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
- Employ German word ordering. This will pass <a id="wrglossary.1885"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to <a id="wrglossary.1886"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1887"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1888"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1889"></a><code class="code"><dfn id="glo:switch.mkglslite.s"><span class="shortargfmt">-s</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1722"></a><code class="code"><dfn id="glo:switch.mkglslite.m"><span class="shortargfmt">-m</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>makeindex</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The <a id="wrglossary.1723"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1724"></a><code class="code"><dfn id="glo:switch.mkglslite.x"><span class="shortargfmt">-x</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>xindy</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The <a id="wrglossary.1725"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application. Only the name is required if it’s on the operating system’s path, otherwise the full path name will be needed.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1726"></a><code class="code"><dfn id="glo:switch.mkglslite.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
+ Compress intermediate blanks. This will pass <a id="wrglossary.1727"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to <a id="wrglossary.1728"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1729"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1730"></a><code class="code"><dfn id="glo:switch.mkglslite.r"><span class="shortargfmt">-r</span></dfn></code></div><!-- end of settingsbox -->
+ Disable implicit page <a id="wrglossary.1731"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1732"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to <a id="wrglossary.1733"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1734"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1735"></a><code class="code"><dfn id="glo:switch.mkglslite.p"><span class="shortargfmt">-p</span></dfn> <span class="meta">〈<em class="metainner">num</em>〉</span></code></div><!-- end of settingsbox -->
+ Set the starting page number. This will pass <code class="code"><a id="wrglossary.1736"></a><a href="#glo:switch.mkidx.p"><span class="shortargfmt">-p</span></a> <span class="meta">〈<em class="metainner">num</em>〉</span></code> to <a id="wrglossary.1737"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1738"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+The following switches may be used to override settings written to the <a id="wrglossary.1739"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1740"></a><code class="code"><dfn id="glo:switch.mkglslite.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
+ Use letter ordering. This will pass <a id="wrglossary.1741"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1742"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <code class="code"><a id="wrglossary.1743"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1744"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1745"></a><code class="code"><dfn id="glo:switch.mkglslite.L"><span class="shortargfmt">-L</span></dfn> <span class="meta">〈<em class="metainner">language</em>〉</span></code></div><!-- end of settingsbox -->
+ The language to pass to <a id="wrglossary.1746"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1747"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1748"></a><code class="code"><dfn id="glo:switch.mkglslite.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
+ Employ German word ordering. This will pass <a id="wrglossary.1749"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to <a id="wrglossary.1750"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1751"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1752"></a><code class="code"><dfn id="glo:switch.mkglslite.s"><span class="shortargfmt">-s</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
Set the style file.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1890"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1891"></a><code class="code"><dfn id="glo:switch.mkglslite.o"><span class="shortargfmt">-o</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
- Sets the output file name. Note that this should only be used when only one <a id="wrglossary.1892"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the output filename to the basename supplied to <a id="wrglossary.1893"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1894"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span> argument of <a id="wrglossary.1895"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.1896"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1897"></a><code class="code"><dfn id="glo:switch.mkglslite.t"><span class="shortargfmt">-t</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
- Sets the transcript file name. Note that this should only be used when only one <a id="wrglossary.1898"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the transcript filename to the basename supplied to <a id="wrglossary.1899"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1900"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span> argument of <a id="wrglossary.1901"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1753"></a><code class="code"><dfn id="glo:switch.mkglslite.o"><span class="shortargfmt">-o</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
+ Sets the output file name. Note that this should only be used when only one <a id="wrglossary.1754"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the output filename to the basename supplied to <a id="wrglossary.1755"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1756"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span> argument of <a id="wrglossary.1757"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1758"></a><code class="code"><dfn id="glo:switch.mkglslite.t"><span class="shortargfmt">-t</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
+ Sets the transcript file name. Note that this should only be used when only one <a id="wrglossary.1759"></a><a href="#glo:dual.glossary">glossary</a> should be processed. The default is to set the transcript filename to the basename supplied to <a id="wrglossary.1760"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with the extension associated with the <a id="wrglossary.1761"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span> argument of <a id="wrglossary.1762"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).<p>
</section><!-- end of section sec:makeglossarieslua -->
@@ -2289,17 +2315,17 @@
<section id="sec:xindyapp"><!-- start of section sec:xindyapp --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.6.3. Using <span class="appfmt">xindy</span> explicitly (Option 3)<div class="labellink"><a href="#sec:xindyapp">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<a id="wrglossary.1902"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> comes with TeX Live. It has also been added to MikTeX, but if you don’t have it installed, see <a href="https://tex.stackexchange.com/questions/71167">How to use Xindy with MikTeX</a>.<p>
-If you want to use <a id="wrglossary.1903"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to process the glossary files, you must make sure you have used the <a id="wrglossary.1904"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.1905"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.1906"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
-</pre> This is required regardless of whether you use <a id="wrglossary.1907"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly or whether it’s called implicitly via applications such as <a id="wrglossary.1908"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. This causes the glossary entries to be written in raw <a id="wrglossary.1909"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format, so you need to use <code class="code"><a id="wrglossary.1910"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy</code> <span style="font-style: italic; font-variant: normal; ">not</span> <code class="code"><a id="wrglossary.1911"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> tex</code>.<p>
-To run <a id="wrglossary.1912"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> type the following in your terminal (all on one line): <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1913"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>xindy <a id="wrglossary.1914"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> <span class="meta">〈<em class="metainner">language</em>〉</span> <a id="wrglossary.1915"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> <span class="meta">〈<em class="metainner">encoding</em>〉</span> <a id="wrglossary.1916"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.1917"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> <span class="meta">〈<em class="metainner">style</em>〉</span> <a id="wrglossary.1918"></a><a href="#glo:switch.xdy.t"><span class="shortargfmt">-t</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.glg <a id="wrglossary.1919"></a><a href="#glo:switch.xdy.o"><span class="shortargfmt">-o</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.gls <span class="meta">〈<em class="metainner">base</em>〉</span>.glo
-</pre> where <span class="meta">〈<em class="metainner">language</em>〉</span> is the required language name, <span class="meta">〈<em class="metainner">encoding</em>〉</span> is the <a id="wrglossary.1920"></a><a href="#glo:idx.encoding">encoding</a>, <span class="meta">〈<em class="metainner">base</em>〉</span> is the name of the document without the <a id="wrglossary.1921"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> extension and <span class="meta">〈<em class="metainner">style</em>〉</span> is the name of the <a id="wrglossary.1922"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file without the <a id="wrglossary.1923"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension. The default name for this style file is <span class="meta">〈<em class="metainner">base</em>〉</span><a id="wrglossary.1924"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> but can be changed via <a id="wrglossary.1925"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. 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>
-For example, if your document is called <span class="filefmt">myDoc.tex</span> and you are using <a id="wrglossary.1926"></a><a href="#glo:dual.utf8">UTF-8</a> <a id="wrglossary.1927"></a><a href="#glo:idx.encoding">encoding</a> in English, then type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1928"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.glg -o myDoc.gls myDoc.glo
+<a id="wrglossary.1763"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> comes with TeX Live. It has also been added to MikTeX, but if you don’t have it installed, see <a href="https://tex.stackexchange.com/questions/71167">How to use Xindy with MikTeX</a>.<p>
+If you want to use <a id="wrglossary.1764"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to process the glossary files, you must make sure you have used the <a id="wrglossary.1765"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.1766"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
+</pre> This is required regardless of whether you use <a id="wrglossary.1767"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly or whether it’s called implicitly via applications such as <a id="wrglossary.1768"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. This causes the glossary entries to be written in raw <a id="wrglossary.1769"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format, so you need to use <code class="code"><a id="wrglossary.1770"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy</code> <span style="font-style: italic; font-variant: normal; ">not</span> <code class="code"><a id="wrglossary.1771"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> tex</code>.<p>
+To run <a id="wrglossary.1772"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> type the following in your terminal (all on one line): <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy <a id="wrglossary.1773"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> <span class="meta">〈<em class="metainner">language</em>〉</span> <a id="wrglossary.1774"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> <span class="meta">〈<em class="metainner">encoding</em>〉</span> <a id="wrglossary.1775"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.1776"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> <span class="meta">〈<em class="metainner">style</em>〉</span> <a id="wrglossary.1777"></a><a href="#glo:switch.xdy.t"><span class="shortargfmt">-t</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.glg <a id="wrglossary.1778"></a><a href="#glo:switch.xdy.o"><span class="shortargfmt">-o</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.gls <span class="meta">〈<em class="metainner">base</em>〉</span>.glo
+</pre> where <span class="meta">〈<em class="metainner">language</em>〉</span> is the required language name, <span class="meta">〈<em class="metainner">encoding</em>〉</span> is the <a id="wrglossary.1779"></a><a href="#glo:idx.encoding">encoding</a>, <span class="meta">〈<em class="metainner">base</em>〉</span> is the name of the document without the <a id="wrglossary.1780"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> extension and <span class="meta">〈<em class="metainner">style</em>〉</span> is the name of the <a id="wrglossary.1781"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file without the <a id="wrglossary.1782"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension. The default name for this style file is <span class="meta">〈<em class="metainner">base</em>〉</span><a id="wrglossary.1783"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> but can be changed via <a id="wrglossary.1784"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. 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>
+For example, if your document is called <span class="filefmt">myDoc.tex</span> and you are using <a id="wrglossary.1785"></a><a href="#glo:dual.utf8">UTF-8</a> <a id="wrglossary.1786"></a><a href="#glo:idx.encoding">encoding</a> in English, then type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.glg -o myDoc.gls myDoc.glo
</pre><p>
-Note that this just creates the <a id="wrglossary.1929"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1930"></a><a href="#glo:dual.glossary">glossary</a>. You need to do the same for each of the other <a id="wrglossary.1931"></a><a href="#glo:dual.glossary">glossaries</a> (including the list of <a id="wrglossary.1932"></a><a href="#glo:idx.acronym">acronyms</a> if you have used the <a id="wrglossary.1933"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option), substituting <a id="wrglossary.1934"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1935"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> and <a id="wrglossary.1936"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> with the relevant extensions. For example, if you have used the <a id="wrglossary.1937"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option, then you would need to do: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1938"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.alg -o myDoc.acr myDoc.acn
-</pre> For additional <a id="wrglossary.1939"></a><a href="#glo:dual.glossary">glossaries</a>, the extensions are those supplied when you created the <a id="wrglossary.1940"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.1941"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.<p>
-Note that if you use <a id="wrglossary.1942"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can replace all those calls to <a id="wrglossary.1943"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with just one call to <a id="wrglossary.1944"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1945"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeglossaries myDoc
-</pre> Note also that some commands and package options have no effect if you use <a id="wrglossary.1946"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly instead of using <a id="wrglossary.1947"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. These are listed in Table <a href="#tab:makeglossariesCmds">1.3</a>.<p>
+Note that this just creates the <a id="wrglossary.1787"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1788"></a><a href="#glo:dual.glossary">glossary</a>. You need to do the same for each of the other <a id="wrglossary.1789"></a><a href="#glo:dual.glossary">glossaries</a> (including the list of <a id="wrglossary.1790"></a><a href="#glo:idx.acronym">acronyms</a> if you have used the <a id="wrglossary.1791"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option), substituting <a id="wrglossary.1792"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1793"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> and <a id="wrglossary.1794"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> with the relevant extensions. For example, if you have used the <a id="wrglossary.1795"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option, then you would need to do: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.alg -o myDoc.acr myDoc.acn
+</pre> For additional <a id="wrglossary.1796"></a><a href="#glo:dual.glossary">glossaries</a>, the extensions are those supplied when you created the <a id="wrglossary.1797"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.1798"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.<p>
+Note that if you use <a id="wrglossary.1799"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can replace all those calls to <a id="wrglossary.1800"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with just one call to <a id="wrglossary.1801"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeglossaries myDoc
+</pre> Note also that some commands and package options have no effect if you use <a id="wrglossary.1802"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly instead of using <a id="wrglossary.1803"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. These are listed in Table <a href="#tab:makeglossariesCmds">1.3</a>.<p>
</section><!-- end of section sec:xindyapp -->
@@ -2306,13 +2332,13 @@
<section id="sec:makeindexapp"><!-- start of section sec:makeindexapp --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.6.4. Using <span class="appfmt">makeindex</span> explicitly (Option 2)<div class="labellink"><a href="#sec:makeindexapp">[link]</a></div></h3><!-- end of subsection header -->
<p>
-If you want to use <a id="wrglossary.1948"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly, you must make sure that you haven’t used the <a id="wrglossary.1949"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option or the <a id="wrglossary.1950"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will be written in the wrong format. To run <a id="wrglossary.1951"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1952"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeindex <a id="wrglossary.1953"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> <span class="meta">〈<em class="metainner">style</em>〉</span>.ist <a id="wrglossary.1954"></a><a href="#glo:switch.mkidx.t"><span class="shortargfmt">-t</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.glg <a id="wrglossary.1955"></a><a href="#glo:switch.mkidx.o"><span class="shortargfmt">-o</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.gls <span class="meta">〈<em class="metainner">base</em>〉</span>.glo
-</pre> where <span class="meta">〈<em class="metainner">base</em>〉</span> is the name of your document without the <a id="wrglossary.1956"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> extension and <span class="meta">〈<em class="metainner">style</em>〉</span><a id="wrglossary.1957"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> is the name of the <a id="wrglossary.1958"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style file. By default, this is <span class="meta">〈<em class="metainner">base</em>〉</span><a id="wrglossary.1959"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>, but may be changed via <a id="wrglossary.1960"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. Note that there are other options, such as <a id="wrglossary.1961"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> (letter ordering). See the <a id="wrglossary.1962"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> manual for further details.<p>
-For example, if your document is called <span class="filefmt">myDoc.tex</span>, then type the following at the terminal: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1963"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeindex -s myDoc.ist -t myDoc.glg -o myDoc.gls myDoc.glo
-</pre> Note that this only creates the <a id="wrglossary.1964"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1965"></a><a href="#glo:dual.glossary">glossary</a>. If you have additional <a id="wrglossary.1966"></a><a href="#glo:dual.glossary">glossaries</a> (for example, if you have used the <a id="wrglossary.1967"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option) then you must call <a id="wrglossary.1968"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for each glossary, substituting <a id="wrglossary.1969"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1970"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> and <a id="wrglossary.1971"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> with the relevant extensions. For example, if you have used the <a id="wrglossary.1972"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option, then you need to type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1973"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeindex -s myDoc.ist -t myDoc.alg -o myDoc.acr myDoc.acn
-</pre> For additional glossaries, the extensions are those supplied when you created the glossary with <a id="wrglossary.1974"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.<p>
-Note that if you use <a id="wrglossary.1975"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can replace all those calls to <a id="wrglossary.1976"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with just one call to <a id="wrglossary.1977"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.1978"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>makeglossaries myDoc
-</pre> Note also that some commands and package options have no effect if you use <a id="wrglossary.1979"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly instead of using <a id="wrglossary.1980"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. These are listed in Table <a href="#tab:makeglossariesCmds">1.3</a>.<p>
+If you want to use <a id="wrglossary.1804"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly, you must make sure that you haven’t used the <a id="wrglossary.1805"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option or the <a id="wrglossary.1806"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will be written in the wrong format. To run <a id="wrglossary.1807"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.1808"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> <span class="meta">〈<em class="metainner">style</em>〉</span>.ist <a id="wrglossary.1809"></a><a href="#glo:switch.mkidx.t"><span class="shortargfmt">-t</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.glg <a id="wrglossary.1810"></a><a href="#glo:switch.mkidx.o"><span class="shortargfmt">-o</span></a> <span class="meta">〈<em class="metainner">base</em>〉</span>.gls <span class="meta">〈<em class="metainner">base</em>〉</span>.glo
+</pre> where <span class="meta">〈<em class="metainner">base</em>〉</span> is the name of your document without the <a id="wrglossary.1811"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> extension and <span class="meta">〈<em class="metainner">style</em>〉</span><a id="wrglossary.1812"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> is the name of the <a id="wrglossary.1813"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style file. By default, this is <span class="meta">〈<em class="metainner">base</em>〉</span><a id="wrglossary.1814"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>, but may be changed via <a id="wrglossary.1815"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. Note that there are other options, such as <a id="wrglossary.1816"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> (letter ordering). See the <a id="wrglossary.1817"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> manual for further details.<p>
+For example, if your document is called <span class="filefmt">myDoc.tex</span>, then type the following at the terminal: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex -s myDoc.ist -t myDoc.glg -o myDoc.gls myDoc.glo
+</pre> Note that this only creates the <a id="wrglossary.1818"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1819"></a><a href="#glo:dual.glossary">glossary</a>. If you have additional <a id="wrglossary.1820"></a><a href="#glo:dual.glossary">glossaries</a> (for example, if you have used the <a id="wrglossary.1821"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option) then you must call <a id="wrglossary.1822"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for each glossary, substituting <a id="wrglossary.1823"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1824"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> and <a id="wrglossary.1825"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> with the relevant extensions. For example, if you have used the <a id="wrglossary.1826"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option, then you need to type the following in your terminal: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex -s myDoc.ist -t myDoc.alg -o myDoc.acr myDoc.acn
+</pre> For additional glossaries, the extensions are those supplied when you created the glossary with <a id="wrglossary.1827"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.<p>
+Note that if you use <a id="wrglossary.1828"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can replace all those calls to <a id="wrglossary.1829"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with just one call to <a id="wrglossary.1830"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeglossaries myDoc
+</pre> Note also that some commands and package options have no effect if you use <a id="wrglossary.1831"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly instead of using <a id="wrglossary.1832"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. These are listed in Table <a href="#tab:makeglossariesCmds">1.3</a>.<p>
</section><!-- end of section sec:makeindexapp -->
@@ -2319,7 +2345,7 @@
<section id="sec:notedev"><!-- start of section sec:notedev --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.7. Note to Front-End and Script Developers<div class="labellink"><a href="#sec:notedev">[link]</a></div></h2><!-- end of section header -->
<p>
-The information needed to determine whether to use <a id="wrglossary.1981"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, <a id="wrglossary.1982"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1983"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is stored in the <a id="wrglossary.1984"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. This information can be gathered by a front-end, editor or script to make the <a id="wrglossary.1985"></a><a href="#glo:dual.glossary">glossaries</a> where appropriate. This section describes how the information is stored in the auxiliary file.<p>
+The information needed to determine whether to use <a id="wrglossary.1833"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, <a id="wrglossary.1834"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1835"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is stored in the <a id="wrglossary.1836"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file. This information can be gathered by a front-end, editor or script to make the <a id="wrglossary.1837"></a><a href="#glo:dual.glossary">glossaries</a> where appropriate. This section describes how the information is stored in the auxiliary file.<p>
</section><!-- end of section sec:notedev -->
@@ -2326,31 +2352,31 @@
<section id="sec:notedev.makeindex.xindy"><!-- start of section sec:notedev.makeindex.xindy --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.7.1. MakeIndex and Xindy<div class="labellink"><a href="#sec:notedev.makeindex.xindy">[link]</a></div></h3><!-- end of subsection header -->
<p>
-The <a id="wrglossary.1986"></a><a href="#glo:idx.fileextension">file extension</a> of the <a id="wrglossary.1987"></a><a href="#glo:dual.indexingfile">indexing files</a> used for each defined <a id="wrglossary.1988"></a><a href="#glo:dual.glossary">glossary</a> (not including any <a id="wrglossary.1989"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>) are given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.1990"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.1991"></a><code class="code"><dfn id="glo:@newglossary"><code class="csfmt">\@newglossary</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">log</em>〉</span>}{<span class="meta">〈<em class="metainner">out-ext</em>〉</span>}{<span class="meta">〈<em class="metainner">in-ext</em>〉</span>}</code></div><!-- end of pinnedbox -->
-where <span class="meta">〈<em class="metainner">in-ext</em>〉</span> is the extension of the <span style="font-style: italic; font-variant: normal; "><a id="wrglossary.1992"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span> input file (the output file from the <a id="wrglossary.1993"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s point of view), such as <a id="wrglossary.1994"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a>, <span class="meta">〈<em class="metainner">out-ext</em>〉</span> is the extension of the <span style="font-style: italic; font-variant: normal; "><a id="wrglossary.1995"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span> output file (the input file from the <a id="wrglossary.1996"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s point of view), such as <a id="wrglossary.1997"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>, and <span class="meta">〈<em class="metainner">log</em>〉</span> is the extension of the <a id="wrglossary.1998"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file, such as <a id="wrglossary.1999"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>. The label for the <a id="wrglossary.2000"></a><a href="#glo:dual.glossary">glossary</a> is also given. This isn’t required with <a id="wrglossary.2001"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, but with <a id="wrglossary.2002"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> it’s needed to pick up the associated language and <a id="wrglossary.2003"></a><a href="#glo:idx.encoding">encoding</a> (see below). For example, the information for the default <a id="wrglossary.2004"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.2005"></a><a href="#glo:dual.glossary">glossary</a> is written as: <pre class="codebox"><div clas!
s="codeboxtitle"><a id="wrglossary.2006"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2007"></a><a href="#glo:@newglossary"><code class="csfmt">\@newglossary</code></a>{main}{glg}{gls}{glo}
-</pre> If <a id="wrglossary.2008"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> hybrid method has been used (with <a id="wrglossary.2009"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>[<span class="meta">〈<em class="metainner">sub-list</em>〉</span>]), then the sub-list of <a id="wrglossary.2010"></a><a href="#glo:dual.glossary">glossaries</a> that need to be processed will be identified with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2011"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2012"></a><code class="code"><dfn id="glo:glsxtr at makeglossaries"><code class="csfmt">\glsxtr at makeglossaries</code></dfn>{<span class="meta">〈<em class="metainner">label-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+The <a id="wrglossary.1838"></a><a href="#glo:idx.fileextension">file extension</a> of the <a id="wrglossary.1839"></a><a href="#glo:dual.indexingfile">indexing files</a> used for each defined <a id="wrglossary.1840"></a><a href="#glo:dual.glossary">glossary</a> (not including any <a id="wrglossary.1841"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>) are given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1842"></a><code class="code"><dfn id="glo:@newglossary"><code class="csfmt">\@newglossary</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">log</em>〉</span>}{<span class="meta">〈<em class="metainner">out-ext</em>〉</span>}{<span class="meta">〈<em class="metainner">in-ext</em>〉</span>}</code></div><!-- end of pinnedbox -->
+where <span class="meta">〈<em class="metainner">in-ext</em>〉</span> is the extension of the <span style="font-style: italic; font-variant: normal; "><a id="wrglossary.1843"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span> input file (the output file from the <a id="wrglossary.1844"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s point of view), such as <a id="wrglossary.1845"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a>, <span class="meta">〈<em class="metainner">out-ext</em>〉</span> is the extension of the <span style="font-style: italic; font-variant: normal; "><a id="wrglossary.1846"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span> output file (the input file from the <a id="wrglossary.1847"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s point of view), such as <a id="wrglossary.1848"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>, and <span class="meta">〈<em class="metainner">log</em>〉</span> is the extension of the <a id="wrglossary.1849"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file, such as <a id="wrglossary.1850"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>. The label for the <a id="wrglossary.1851"></a><a href="#glo:dual.glossary">glossary</a> is also given. This isn’t required with <a id="wrglossary.1852"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, but with <a id="wrglossary.1853"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> it’s needed to pick up the associated language and <a id="wrglossary.1854"></a><a href="#glo:idx.encoding">encoding</a> (see below). For example, the information for the default <a id="wrglossary.1855"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1856"></a><a href="#glo:dual.glo!
ssary">glossary</a> is written as: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1857"></a><a href="#glo:@newglossary"><code class="csfmt">\@newglossary</code></a>{main}{glg}{gls}{glo}
+</pre> If <a id="wrglossary.1858"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> hybrid method has been used (with <a id="wrglossary.1859"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>[<span class="meta">〈<em class="metainner">sub-list</em>〉</span>]), then the sub-list of <a id="wrglossary.1860"></a><a href="#glo:dual.glossary">glossaries</a> that need to be processed will be identified with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1861"></a><code class="code"><dfn id="glo:glsxtr at makeglossaries"><code class="csfmt">\glsxtr at makeglossaries</code></dfn>{<span class="meta">〈<em class="metainner">label-list</em>〉</span>}</code></div><!-- end of pinnedbox -->
<p>
-The <a id="wrglossary.2013"></a><a href="#glo:dual.indexingapp">indexing application’s</a> style file is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2014"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2015"></a><code class="code"><dfn id="glo:@istfilename"><code class="csfmt">\@istfilename</code></dfn>{<span class="meta">〈<em class="metainner">filename</em>〉</span>}</code></div><!-- end of pinnedbox -->
- The file extension indicates whether to use <a id="wrglossary.2016"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.2017"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.2018"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.2019"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>). Note that the <a id="wrglossary.2020"></a><a href="#glo:dual.glossary">glossary</a> information has a different syntax depending on which <a id="wrglossary.2021"></a><a href="#glo:dual.indexingapp">indexing application</a> is supposed to be used, so it’s important to call the correct one.<p>
-For example, with <a id="wrglossary.2022"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether to run <a id="wrglossary.2023"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2024"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: makeglossaries if found("aux", "@istfilename")
-</pre> It’s more complicated if you want to explicitly run <a id="wrglossary.2025"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2026"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.2027"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that if you choose to explicitly call <a id="wrglossary.2028"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2029"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then the user will miss out on the diagnostic information and the <a id="wrglossary.2030"></a><a href="#glo:locationencap">encap</a>-clash fix that <a id="wrglossary.2031"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> also provides. </div><!-- end of important -->
+The <a id="wrglossary.1862"></a><a href="#glo:dual.indexingapp">indexing application’s</a> style file is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1863"></a><code class="code"><dfn id="glo:@istfilename"><code class="csfmt">\@istfilename</code></dfn>{<span class="meta">〈<em class="metainner">filename</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ The file extension indicates whether to use <a id="wrglossary.1864"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.1865"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.1866"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.1867"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>). Note that the <a id="wrglossary.1868"></a><a href="#glo:dual.glossary">glossary</a> information has a different syntax depending on which <a id="wrglossary.1869"></a><a href="#glo:dual.indexingapp">indexing application</a> is supposed to be used, so it’s important to call the correct one.<p>
+For example, with <a id="wrglossary.1870"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether to run <a id="wrglossary.1871"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: makeglossaries if found("aux", "@istfilename")
+</pre> It’s more complicated if you want to explicitly run <a id="wrglossary.1872"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1873"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that if you choose to explicitly call <a id="wrglossary.1874"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1875"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then the user will miss out on the diagnostic information and the <a id="wrglossary.1876"></a><a href="#glo:locationencap">encap</a>-clash fix that <a id="wrglossary.1877"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> also provides. </div><!-- end of important -->
<p>
-Word or letter ordering is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2032"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2033"></a><code class="code"><dfn id="glo:@glsorder"><code class="csfmt">\@glsorder</code></dfn>{<span class="meta">〈<em class="metainner">order</em>〉</span>}</code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">order</em>〉</span> can be either <code class="code">word</code> or <code class="code">letter</code> (obtained from the <a id="wrglossary.2034"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> package option).<p>
-If <a id="wrglossary.2035"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be used, the language for each <a id="wrglossary.2036"></a><a href="#glo:dual.glossary">glossary</a> is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2037"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2038"></a><code class="code"><dfn id="glo:@xdylanguage"><code class="csfmt">\@xdylanguage</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">language</em>〉</span>}</code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">glossary-label</em>〉</span> identifies the <a id="wrglossary.2039"></a><a href="#glo:dual.glossary">glossary</a> and <span class="meta">〈<em class="metainner">language</em>〉</span> is the root language (for example, <code class="code">english</code>).<p>
-The <a id="wrglossary.2040"></a><a href="#glo:idx.codepage">codepage</a> (file <a id="wrglossary.2041"></a><a href="#glo:idx.encoding">encoding</a>) for all <a id="wrglossary.2042"></a><a href="#glo:dual.glossary">glossaries</a> is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2043"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2044"></a><code class="code"><dfn id="glo:@gls at codepage"><code class="csfmt">\@gls at codepage</code></dfn>{<span class="meta">〈<em class="metainner">code-page</em>〉</span>}</code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">code</em>〉</span> is the <a id="wrglossary.2045"></a><a href="#glo:idx.encoding">encoding</a> (for example, <code class="code">utf8</code>). The above two commands are omitted if <a id="wrglossary.2046"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be used.<p>
-If <a id="wrglossary.2047"></a><a href="#glo:idx.opt.noidx">Option 1</a> has been used, the <a id="wrglossary.2048"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file will contain <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2049"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2050"></a><code class="code"><dfn id="glo:@gls at reference"><code class="csfmt">\@gls at reference</code></dfn>{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
+Word or letter ordering is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1878"></a><code class="code"><dfn id="glo:@glsorder"><code class="csfmt">\@glsorder</code></dfn>{<span class="meta">〈<em class="metainner">order</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">order</em>〉</span> can be either <code class="code">word</code> or <code class="code">letter</code> (obtained from the <a id="wrglossary.1879"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> package option).<p>
+If <a id="wrglossary.1880"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be used, the language for each <a id="wrglossary.1881"></a><a href="#glo:dual.glossary">glossary</a> is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1882"></a><code class="code"><dfn id="glo:@xdylanguage"><code class="csfmt">\@xdylanguage</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">language</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">glossary-label</em>〉</span> identifies the <a id="wrglossary.1883"></a><a href="#glo:dual.glossary">glossary</a> and <span class="meta">〈<em class="metainner">language</em>〉</span> is the root language (for example, <code class="code">english</code>).<p>
+The <a id="wrglossary.1884"></a><a href="#glo:idx.codepage">codepage</a> (file <a id="wrglossary.1885"></a><a href="#glo:idx.encoding">encoding</a>) for all <a id="wrglossary.1886"></a><a href="#glo:dual.glossary">glossaries</a> is specified by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1887"></a><code class="code"><dfn id="glo:@gls at codepage"><code class="csfmt">\@gls at codepage</code></dfn>{<span class="meta">〈<em class="metainner">code-page</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">code</em>〉</span> is the <a id="wrglossary.1888"></a><a href="#glo:idx.encoding">encoding</a> (for example, <code class="code">utf8</code>). The above two commands are omitted if <a id="wrglossary.1889"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be used.<p>
+If <a id="wrglossary.1890"></a><a href="#glo:idx.opt.noidx">Option 1</a> has been used, the <a id="wrglossary.1891"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file will contain <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1892"></a><code class="code"><dfn id="glo:@gls at reference"><code class="csfmt">\@gls at reference</code></dfn>{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}</code></div><!-- end of pinnedbox -->
for every time an entry has been referenced. <p>
</section><!-- end of section sec:notedev.makeindex.xindy -->
@@ -2358,9 +2384,9 @@
<section id="sec:notedev.labels"><!-- start of section sec:notedev.labels --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.7.2. Entry Labels<div class="labellink"><a href="#sec:notedev.labels">[link]</a></div></h3><!-- end of subsection header -->
<p>
-If you need to gather labels for <a id="wrglossary.2051"></a><a href="#glo:idx.auto-completion">auto-completion</a>, the <a id="wrglossary.2052"></a><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a> package option will create a file containing the labels of all defined <a id="wrglossary.2053"></a><a href="#glo:idx.glossaryentry">entries</a> (regardless of whether or not the <a id="wrglossary.2054"></a><a href="#glo:idx.glossaryentry">entry</a> has been used in the document). As from v4.47, there is a similar option <a id="wrglossary.2055"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a> that writes both the label and name (separated by a tab).<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2056"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.2057"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package also provides <a id="wrglossary.2058"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span>, which will create the <a id="wrglossary.2059"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file but will act like <a id="wrglossary.2060"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>. </div><!-- end of information -->
+If you need to gather labels for <a id="wrglossary.1893"></a><a href="#glo:idx.auto-completion">auto-completion</a>, the <a id="wrglossary.1894"></a><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a> package option will create a file containing the labels of all defined <a id="wrglossary.1895"></a><a href="#glo:idx.glossaryentry">entries</a> (regardless of whether or not the <a id="wrglossary.1896"></a><a href="#glo:idx.glossaryentry">entry</a> has been used in the document). As from v4.47, there is a similar option <a id="wrglossary.1897"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a> that writes both the label and name (separated by a tab).<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.1898"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.1899"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package also provides <a id="wrglossary.1900"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span>, which will create the <a id="wrglossary.1901"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file but will act like <a id="wrglossary.1902"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>. </div><!-- end of information -->
<p>
</section><!-- end of section sec:notedev.labels -->
@@ -2368,24 +2394,24 @@
<section id="sec:notedev.bib2gls"><!-- start of section sec:notedev.bib2gls --><div class="tomain"><a href="#main">[top]</a></div>
<h3><!-- start of subsection header -->1.7.3. Bib2Gls<div class="labellink"><a href="#sec:notedev.bib2gls">[link]</a></div></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.2061"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-If <a id="wrglossary.2062"></a><a href="#glo:idx.opt.b2g">Option 4</a> has been used, the <a id="wrglossary.2063"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file will contain one or more instances of: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2064"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2065"></a><code class="code"><dfn id="glo:glsxtr at resource"><code class="csfmt">\glsxtr at resource</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">basename</em>〉</span> is the basename of the <a id="wrglossary.2066"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file that needs to be created by <a id="wrglossary.2067"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If <a id="wrglossary.2068"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={<span class="meta">〈<em class="metainner">bib list</em>〉</span>}</span> isn’t present in <span class="meta">〈<em class="metainner">options</em>〉</span> then <span class="meta">〈<em class="metainner">basename</em>〉</span> also indicates the name of the associated <a id="wrglossary.2069"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file.<p>
-For example, with <a id="wrglossary.2070"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether or not to run <a id="wrglossary.2071"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2072"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls if found("aux", "glsxtr at resource")
-</pre> (It gets more complicated if both <a id="wrglossary.2073"></a><a href="#glo:glsxtr at resource"><code class="csfmt">\glsxtr at resource</code></a> and <a id="wrglossary.2074"></a><a href="#glo:@istfilename"><code class="csfmt">\@istfilename</code></a> are present as that indicates the hybrid <a id="wrglossary.2075"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=hybrid</span> option.)<p>
-Remember that with <a id="wrglossary.2076"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.2077"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will never be defined on the first LaTeX call (because their definitions are contained in the <a id="wrglossary.2078"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.2079"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). You can also pick up labels from the <a id="wrglossary.2080"></a><a href="#glo:@@glslabel at indexing">records</a> in <a id="wrglossary.2081"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which will be in the form: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2082"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2083"></a><code class="code"><dfn id="glo:glsxtr at record"><code class="csfmt">\glsxtr at record</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">h-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">loc</em>〉</span>}</code></div><!-- end of pinnedbox -->
- or (with <a id="wrglossary.2084"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>): <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2085"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2086"></a><code class="code"><dfn id="glo:glsxtr at record@nameref"><code class="csfmt">\glsxtr at record@nameref</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">href prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">href anchor</em>〉</span>}{<span class="meta">〈<em class="metainner">href value</em>〉</span>}</code></div><!-- end of pinnedbox -->
- or (with <a id="wrglossary.2087"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>): <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2088"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2089"></a><code class="code"><dfn id="glo:glsxtr at recordsee"><code class="csfmt">\glsxtr at recordsee</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr list</em>〉</span>}</code></div><!-- end of pinnedbox -->
-{label}{xr list} You can also pick up the commands defined with <a id="wrglossary.2090"></a><a href="#glo:glsxtrnewglslike"><code class="xtrcsfmt">\glsxtrnewglslike</code></a>, which are added to the <a id="wrglossary.2091"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file for <a id="wrglossary.2092"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> benefit: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2093"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2094"></a><code class="code"><dfn id="glo:@glsxtr at newglslike"><code class="csfmt">\@glsxtr at newglslike</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
- If <a id="wrglossary.2095"></a><a href="#glo:GlsXtrSetAltModifier"><code class="xtrcsfmt">\GlsXtrSetAltModifier</code></a> is used, then the modifier is identified with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2096"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2097"></a><code class="code"><dfn id="glo:@glsxtr at altmodifier"><code class="csfmt">\@glsxtr at altmodifier</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code></div><!-- end of pinnedbox -->
- Label prefixes (for the <a id="wrglossary.2098"></a><a href="#glo:dgls"><code class="xtrcsfmt">\dgls</code></a> set of commands) are identified with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2099"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2100"></a><code class="code"><dfn id="glo:@glsxtr at prefixlabellist"><code class="csfmt">\@glsxtr at prefixlabellist</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<div class="sidenote"><a id="wrglossary.1903"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+If <a id="wrglossary.1904"></a><a href="#glo:idx.opt.b2g">Option 4</a> has been used, the <a id="wrglossary.1905"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file will contain one or more instances of: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1906"></a><code class="code"><dfn id="glo:glsxtr at resource"><code class="csfmt">\glsxtr at resource</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">basename</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">basename</em>〉</span> is the basename of the <a id="wrglossary.1907"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file that needs to be created by <a id="wrglossary.1908"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If <a id="wrglossary.1909"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={<span class="meta">〈<em class="metainner">bib list</em>〉</span>}</span> isn’t present in <span class="meta">〈<em class="metainner">options</em>〉</span> then <span class="meta">〈<em class="metainner">basename</em>〉</span> also indicates the name of the associated <a id="wrglossary.1910"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file.<p>
+For example, with <a id="wrglossary.1911"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether or not to run <a id="wrglossary.1912"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls if found("aux", "glsxtr at resource")
+</pre> (It gets more complicated if both <a id="wrglossary.1913"></a><a href="#glo:glsxtr at resource"><code class="csfmt">\glsxtr at resource</code></a> and <a id="wrglossary.1914"></a><a href="#glo:@istfilename"><code class="csfmt">\@istfilename</code></a> are present as that indicates the hybrid <a id="wrglossary.1915"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=hybrid</span> option.)<p>
+Remember that with <a id="wrglossary.1916"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.1917"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will never be defined on the first LaTeX call (because their definitions are contained in the <a id="wrglossary.1918"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.1919"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). You can also pick up labels from the <a id="wrglossary.1920"></a><a href="#glo:@@glslabel at indexing">records</a> in <a id="wrglossary.1921"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which will be in the form: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1922"></a><code class="code"><dfn id="glo:glsxtr at record"><code class="csfmt">\glsxtr at record</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">h-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">loc</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ or (with <a id="wrglossary.1923"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>): <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1924"></a><code class="code"><dfn id="glo:glsxtr at record@nameref"><code class="csfmt">\glsxtr at record@nameref</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">href prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">counter</em>〉</span>}{<span class="meta">〈<em class="metainner">format</em>〉</span>}{<span class="meta">〈<em class="metainner">location</em>〉</span>}{<span class="meta">〈<em class="metainner">title</em>〉</span>}{<span class="meta">〈<em class="metainner">href anchor</em>〉</span>}{<span class="meta">〈<em class="metainner">href value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ or (with <a id="wrglossary.1925"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>): <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1926"></a><code class="code"><dfn id="glo:glsxtr at recordsee"><code class="csfmt">\glsxtr at recordsee</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+{label}{xr list} You can also pick up the commands defined with <a id="wrglossary.1927"></a><a href="#glo:glsxtrnewglslike"><code class="xtrcsfmt">\glsxtrnewglslike</code></a>, which are added to the <a id="wrglossary.1928"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file for <a id="wrglossary.1929"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> benefit: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1930"></a><code class="code"><dfn id="glo:@glsxtr at newglslike"><code class="csfmt">\@glsxtr at newglslike</code></dfn>{<span class="meta">〈<em class="metainner">label-prefix</em>〉</span>}{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ If <a id="wrglossary.1931"></a><a href="#glo:GlsXtrSetAltModifier"><code class="xtrcsfmt">\GlsXtrSetAltModifier</code></a> is used, then the modifier is identified with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1932"></a><code class="code"><dfn id="glo:@glsxtr at altmodifier"><code class="csfmt">\@glsxtr at altmodifier</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ Label prefixes (for the <a id="wrglossary.1933"></a><a href="#glo:dgls"><code class="xtrcsfmt">\dgls</code></a> set of commands) are identified with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1934"></a><code class="code"><dfn id="glo:@glsxtr at prefixlabellist"><code class="csfmt">\@glsxtr at prefixlabellist</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
<p>
</section><!-- end of section sec:notedev.bib2gls -->
@@ -2393,12 +2419,12 @@
<section id="sec:pkgopts"><!-- start of section sec:pkgopts --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->2. Package Options<div class="labellink"><a href="#sec:pkgopts">[link]</a></div></h1><!-- end of chapter header -->
<p>
-This section describes the available <a id="wrglossary.2101"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package options. You may omit the <code class="code">=true</code> for boolean options. (For example, <a id="wrglossary.2102"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> is equivalent to <a id="wrglossary.2103"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="optfmt">=true</span>).<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2104"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.2105"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has additional options described in the <a id="wrglossary.2106"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual. The extension package also has some different default settings to the base package. Those that are available at the time of writing are included here. Future versions of <a id="wrglossary.2107"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> may have additional package options or new values for existing settings that aren’t listed here. </div><!-- end of information -->
+This section describes the available <a id="wrglossary.1935"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package options. You may omit the <code class="code">=true</code> for boolean options. (For example, <a id="wrglossary.1936"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> is equivalent to <a id="wrglossary.1937"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="optfmt">=true</span>).<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.1938"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.1939"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has additional options described in the <a id="wrglossary.1940"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual. The extension package also has some different default settings to the base package. Those that are available at the time of writing are included here. Future versions of <a id="wrglossary.1941"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> may have additional package options or new values for existing settings that aren’t listed here. </div><!-- end of information -->
<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.2108"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> package options can’t be passed via the document class options. (This includes options where the <span class="meta">〈<em class="metainner">value</em>〉</span> part may be omitted, such as <a id="wrglossary.2109"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>.) This is a general limitation not restricted to the <a id="wrglossary.2110"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Options that aren’t <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> (such as <a id="wrglossary.2111"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>) may be passed via the document class options. </div><!-- end of important -->
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> package options can’t be passed via the document class options. (This includes options where the <span class="meta">〈<em class="metainner">value</em>〉</span> part may be omitted, such as <a id="wrglossary.1942"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>.) This is a general limitation not restricted to the <a id="wrglossary.1943"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Options that aren’t <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> (such as <a id="wrglossary.1944"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>) may be passed via the document class options. </div><!-- end of important -->
<p>
<p>
@@ -2407,164 +2433,164 @@
<section id="sec:pkgopts-general"><!-- start of section sec:pkgopts-general --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.1. General Options<div class="labellink"><a href="#sec:pkgopts-general">[link]</a></div></h2><!-- end of section header -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2112"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2113"></a><code class="code"><dfn id="glo:opt.nowarn"><span class="styoptfmt">nowarn</span></dfn></code></div><!-- end of settingsbox -->
- This suppresses all warnings generated by the <a id="wrglossary.2114"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Don’t use this option if you’re new to using <a id="wrglossary.2115"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> as the warnings are designed to help detect common mistakes (such as forgetting to use <a id="wrglossary.2116"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). Note that if you use <a id="wrglossary.2117"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> with any value other than <span class="optfmt">false</span> it will override this option.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2118"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2119"></a><code class="code"><dfn id="glo:opt.nolangwarn"><span class="styoptfmt">nolangwarn</span></dfn></code></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1945"></a><code class="code"><dfn id="glo:opt.nowarn"><span class="styoptfmt">nowarn</span></dfn></code></div><!-- end of settingsbox -->
+ This suppresses all warnings generated by the <a id="wrglossary.1946"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. Don’t use this option if you’re new to using <a id="wrglossary.1947"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> as the warnings are designed to help detect common mistakes (such as forgetting to use <a id="wrglossary.1948"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). Note that if you use <a id="wrglossary.1949"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> with any value other than <span class="optfmt">false</span> it will override this option.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1950"></a><code class="code"><dfn id="glo:opt.nolangwarn"><span class="styoptfmt">nolangwarn</span></dfn></code></div><!-- end of settingsbox -->
This suppresses the warning generated by a missing language module.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2120"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2121"></a><code class="code"><dfn id="glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></dfn></code></div><!-- end of settingsbox -->
- If you load <a id="wrglossary.2122"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> with a class or another package that already defines glossary related commands, by default <a id="wrglossary.2123"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will warn you that it’s redefining those commands. If you are aware of the consequences of using <a id="wrglossary.2124"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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 <a id="wrglossary.2125"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a> option described above. (This option is automatically switched on by <a id="wrglossary.2126"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2127"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2128"></a><code class="code"><dfn id="glo:opt.debug"><span class="styoptfmt">debug</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- Debugging mode may write information to the transcript file or add markers to the document. The following values are available: <div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2129"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2130"></a><a id="wrglossary.2131"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1951"></a><code class="code"><dfn id="glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></dfn></code></div><!-- end of settingsbox -->
+ If you load <a id="wrglossary.1952"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> with a class or another package that already defines glossary related commands, by default <a id="wrglossary.1953"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will warn you that it’s redefining those commands. If you are aware of the consequences of using <a id="wrglossary.1954"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> 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 <a id="wrglossary.1955"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a> option described above. (This option is automatically switched on by <a id="wrglossary.1956"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.1957"></a><code class="code"><dfn id="glo:opt.debug"><span class="styoptfmt">debug</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Debugging mode may write information to the transcript file or add markers to the document. The following values are available: <div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.1958"></a><a id="wrglossary.1959"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
Switches off debugging mode.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2132"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2133"></a><a id="wrglossary.2134"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
- This will write the following line to the transcript file if any attempt at indexing occurs before the associated files have been opened by <a id="wrglossary.2135"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>: <pre class="compactcodebox">wrglossary(<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>)(<span class="meta">〈<em class="metainner">indexing info</em>〉</span>)
-</pre> Note that this setting will also cancel <a id="wrglossary.2136"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a>.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2137"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2138"></a><a id="wrglossary.2139"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></dfn></code></div><!-- end of optionvaluebox -->
- As <a id="wrglossary.2140"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2141"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the <a id="wrglossary.2142"></a><a href="#glo:dual.glossary">glossary</a>-related <a id="wrglossary.2143"></a><a href="#glo:idx.hyperlink">hyperlinks</a> and targets occur in the document.<p>
-The <a id="wrglossary.2144"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2145"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a> option will additionally use: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2146"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2147"></a><code class="code"><dfn id="glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
- to show the <a id="wrglossary.2148"></a><a href="#glo:idx.hypertarget">hypertarget</a> or <a id="wrglossary.2149"></a><a href="#glo:idx.hyperlink">hyperlink</a> name when <a id="wrglossary.2150"></a><a href="#glo:glsdohypertarget"><code class="csfmt">\glsdohypertarget</code></a> is used by commands like <a id="wrglossary.2151"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a> and when <a id="wrglossary.2152"></a><a href="#glo:glsdohyperlink"><code class="csfmt">\glsdohyperlink</code></a> is used by commands like <a id="wrglossary.2153"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. In <a id="wrglossary.2154"></a><a href="#glo:idx.mathmode">math mode</a> or inner mode, this uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2155"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2156"></a><code class="code"><dfn id="glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
- which typesets the target name as: <pre class="compactcodebox">[<a id="wrglossary.2157"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}]
-</pre> just before the link or anchor. This uses the text-block command: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2158"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2159"></a><code class="code"><dfn id="glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
- which checks for math-mode before applying the font change. In outer mode <a id="wrglossary.2160"></a><a href="#glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></a> uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2161"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2162"></a><code class="code"><dfn id="glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
- which by default places the target name in the margin with a symbol produced with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2163"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2164"></a><code class="code"><dfn id="glo:glsshowtargetsymbol"><code class="csfmt">\glsshowtargetsymbol</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.1960"></a><a id="wrglossary.1961"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+ This will write the following line to the transcript file if any attempt at indexing occurs before the associated files have been opened by <a id="wrglossary.1962"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>: <pre class="compactcodebox">wrglossary(<span class="meta">〈<em class="metainner">glossary-type</em>〉</span>)(<span class="meta">〈<em class="metainner">indexing info</em>〉</span>)
+</pre> Note that this setting will also cancel <a id="wrglossary.1963"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.1964"></a><a id="wrglossary.1965"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></dfn></code></div><!-- end of optionvaluebox -->
+ As <a id="wrglossary.1966"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.1967"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the <a id="wrglossary.1968"></a><a href="#glo:dual.glossary">glossary</a>-related <a id="wrglossary.1969"></a><a href="#glo:idx.hyperlink">hyperlinks</a> and targets occur in the document.<p>
+The <a id="wrglossary.1970"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.1971"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a> option will additionally use: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1972"></a><code class="code"><dfn id="glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ to show the <a id="wrglossary.1973"></a><a href="#glo:idx.hypertarget">hypertarget</a> or <a id="wrglossary.1974"></a><a href="#glo:idx.hyperlink">hyperlink</a> name when <a id="wrglossary.1975"></a><a href="#glo:glsdohypertarget"><code class="csfmt">\glsdohypertarget</code></a> is used by commands like <a id="wrglossary.1976"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a> and when <a id="wrglossary.1977"></a><a href="#glo:glsdohyperlink"><code class="csfmt">\glsdohyperlink</code></a> is used by commands like <a id="wrglossary.1978"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. In <a id="wrglossary.1979"></a><a href="#glo:idx.mathmode">math mode</a> or inner mode, this uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1980"></a><code class="code"><dfn id="glo:glsshowtargetinner"><code class="csfmt">\glsshowtargetinner</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which typesets the target name as: <pre class="compactcodebox">[<a id="wrglossary.1981"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}]
+</pre> just before the link or anchor. This uses the text-block command: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1982"></a><code class="code"><dfn id="glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which checks for math-mode before applying the font change. In outer mode <a id="wrglossary.1983"></a><a href="#glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></a> uses: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1984"></a><code class="code"><dfn id="glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ which by default places the target name in the margin with a symbol produced with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1985"></a><code class="code"><dfn id="glo:glsshowtargetsymbol"><code class="csfmt">\glsshowtargetsymbol</code></dfn>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}</code></div><!-- end of pinnedbox -->
which defaults to a small right facing triangle.<p>
-The font used by both <a id="wrglossary.2165"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a> and <a id="wrglossary.2166"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a> is given by the declaration: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2167"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2168"></a><code class="code"><dfn id="glo:glsshowtargetfont"><code class="csfmt">\glsshowtargetfont</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\ttfamily</code><code class="csfmt">\footnotesize</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+The font used by both <a id="wrglossary.1986"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a> and <a id="wrglossary.1987"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a> is given by the declaration: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1988"></a><code class="code"><dfn id="glo:glsshowtargetfont"><code class="csfmt">\glsshowtargetfont</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\ttfamily</code><code class="csfmt">\footnotesize</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2169"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2170"></a><a id="wrglossary.2171"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.showaccsupp"><span class="optfmt">showaccsupp</span></dfn></code></div><!-- end of optionvaluebox -->
- As <a id="wrglossary.2172"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2173"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the <a id="wrglossary.2174"></a><a href="#glo:dual.glossary">glossary</a>-related accessibility information occurs (see <a id="wrglossary.2175"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>) using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2176"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2177"></a><code class="code"><dfn id="glo:glsshowaccsupp"><code class="csfmt">\glsshowaccsupp</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">PDF element</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.1989"></a><a id="wrglossary.1990"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>=<code class="code"><dfn id="glo:optval.debug.showaccsupp"><span class="optfmt">showaccsupp</span></dfn></code></div><!-- end of optionvaluebox -->
+ As <a id="wrglossary.1991"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.1992"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the <a id="wrglossary.1993"></a><a href="#glo:dual.glossary">glossary</a>-related accessibility information occurs (see <a id="wrglossary.1994"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>) using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.1995"></a><code class="code"><dfn id="glo:glsshowaccsupp"><code class="csfmt">\glsshowaccsupp</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}{<span class="meta">〈<em class="metainner">PDF element</em>〉</span>}{<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of pinnedbox -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2178"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.2179"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides extra values <a id="wrglossary.2180"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=showwrgloss</span>, that may be used to show where the <a id="wrglossary.2181"></a><a href="#glo:dual.indexing">indexing</a> is occurring, and <a id="wrglossary.2182"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=all</span>, which switches on all debugging options. See the <a id="wrglossary.2183"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. </div><!-- end of information -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.1996"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.1997"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides extra values <a id="wrglossary.1998"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=showwrgloss</span>, that may be used to show where the <a id="wrglossary.1999"></a><a href="#glo:dual.indexing">indexing</a> is occurring, and <a id="wrglossary.2000"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=all</span>, which switches on all debugging options. See the <a id="wrglossary.2001"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. </div><!-- end of information -->
<p>
-The purpose of the debug mode can be demonstrated with the following example document: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2184"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
+The purpose of the debug mode can be demonstrated with the following example document: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>{glossaries}
-<code class="cmd">\newglossaryentry</code>{sample1}{<a id="wrglossary.2185"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample1}</span>,<a id="wrglossary.2186"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={example}</span>}
-<code class="cmd">\newglossaryentry</code>{sample2}{<a id="wrglossary.2187"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample2}</span>,<a id="wrglossary.2188"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={example}</span>}
-<strong class="strong"><a id="wrglossary.2189"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a></strong>{sample2}<span class="comment">% <- does nothing here</span>
-<strong class="strong"><a id="wrglossary.2190"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong>
+<code class="cmd">\newglossaryentry</code>{sample1}{<a id="wrglossary.2002"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample1}</span>,<a id="wrglossary.2003"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={example}</span>}
+<code class="cmd">\newglossaryentry</code>{sample2}{<a id="wrglossary.2004"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample2}</span>,<a id="wrglossary.2005"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={example}</span>}
+<strong class="strong"><a id="wrglossary.2006"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a></strong>{sample2}<span class="comment">% <- does nothing here</span>
+<strong class="strong"><a id="wrglossary.2007"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong>
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.2191"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample1}.
-<a id="wrglossary.2192"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.2008"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample1}.
+<a id="wrglossary.2009"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
-</pre> In this case, only the <span class="qt">“sample1”</span> entry has been <a id="wrglossary.2193"></a><a href="#glo:@@glslabel at indexing">indexed</a>, even though <code class="code"><a id="wrglossary.2194"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{sample2}</code> appears in the source code. This is because <code class="code"><a id="wrglossary.2195"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{sample2}</code> has been used before the associated file is opened by <a id="wrglossary.2196"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Since the file isn’t open yet, the information can’t be written to it, which is why the <span class="qt">“sample2”</span> entry doesn’t appear in the <a id="wrglossary.2197"></a><a href="#glo:dual.glossary">glossary</a>.<p>
-Without <a id="wrglossary.2198"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> the <a id="wrglossary.2199"></a><a href="#glo:dual.indexing">indexing</a> is suppressed with Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> but, other than that, commands like <a id="wrglossary.2200"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> behave as usual.<p>
-This situation doesn’t cause any errors or warnings as it’s perfectly legitimate for a user to want to use <a id="wrglossary.2201"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> to format the entries (for example, to show a different form on <a id="wrglossary.2202"></a><a href="#glo:dual.firstuse">first use</a>) but not display any <a id="wrglossary.2203"></a><a href="#glo:dual.glossary">glossaries</a> (or the user may prefer to use the unsorted Options <a href="#glo:idx.opt.unsrt">5</a> or <a href="#glo:idx.opt.standalone">6</a>). It’s also possible that the user may want to temporarily comment out <a id="wrglossary.2204"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> in order to suppress the <a id="wrglossary.2205"></a><a href="#glo:dual.indexing">indexing</a> while working on a draft version to speed compilation, or the user may prefer to use Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.b2g">4</a> for <a id="wrglossary.2206"></a><a href="#glo:dual.indexing">indexing</a>, which don’t use <a id="wrglossary.2207"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.<p>
-Therefore <a id="wrglossary.2208"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> can’t be used to enable <a id="wrglossary.2209"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and commands like <a id="wrglossary.2210"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.2211"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>. These commands must be enabled by default. (It does, however, enable the <a id="wrglossary.2212"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key as that’s a more common problem. See below.)<p>
-The debug mode, enabled with the <a id="wrglossary.2213"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> option, <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2214"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2215"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>]{glossaries}
-</pre> will write information to the log file when the <a id="wrglossary.2216"></a><a href="#glo:dual.indexing">indexing</a> can’t occur because the associated file isn’t open. The message is written in the form <pre class="transcript"><div class="transcripttitle"><a id="wrglossary.2217"></a><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>Package glossaries Info: wrglossary(<span class="meta">〈<em class="metainner">type</em>〉</span>)(<span class="meta">〈<em class="metainner">text</em>〉</span>) on
-input line <span class="meta">〈<em class="metainner">line number</em>〉</span>.
-</pre> where <span class="meta">〈<em class="metainner">type</em>〉</span> is the glossary label and <span class="meta">〈<em class="metainner">text</em>〉</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 <a id="wrglossary.2218"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> or <a id="wrglossary.2219"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, try switching on the <a id="wrglossary.2220"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> option and see if any information has been written to the log file.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2221"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2222"></a><code class="code"><dfn id="glo:opt.savewrites"><span class="styoptfmt">savewrites</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- This is a boolean option to minimise the number of write registers used by the <a id="wrglossary.2223"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. The default is <a id="wrglossary.2224"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a><span class="optfmt">=false</span>. With Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, one write register is required per (non-ignored) <a id="wrglossary.2225"></a><a href="#glo:dual.glossary">glossary</a> and one for the style file.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2226"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+</pre> In this case, only the <span class="qt">“sample1”</span> entry has been <a id="wrglossary.2010"></a><a href="#glo:@@glslabel at indexing">indexed</a>, even though <code class="code"><a id="wrglossary.2011"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{sample2}</code> appears in the source code. This is because <code class="code"><a id="wrglossary.2012"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{sample2}</code> has been used before the associated file is opened by <a id="wrglossary.2013"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Since the file isn’t open yet, the information can’t be written to it, which is why the <span class="qt">“sample2”</span> entry doesn’t appear in the <a id="wrglossary.2014"></a><a href="#glo:dual.glossary">glossary</a>.<p>
+Without <a id="wrglossary.2015"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> the <a id="wrglossary.2016"></a><a href="#glo:dual.indexing">indexing</a> is suppressed with Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> but, other than that, commands like <a id="wrglossary.2017"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> behave as usual.<p>
+This situation doesn’t cause any errors or warnings as it’s perfectly legitimate for a user to want to use <a id="wrglossary.2018"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> to format the entries (for example, to show a different form on <a id="wrglossary.2019"></a><a href="#glo:dual.firstuse">first use</a>) but not display any <a id="wrglossary.2020"></a><a href="#glo:dual.glossary">glossaries</a> (or the user may prefer to use the unsorted Options <a href="#glo:idx.opt.unsrt">5</a> or <a href="#glo:idx.opt.standalone">6</a>). It’s also possible that the user may want to temporarily comment out <a id="wrglossary.2021"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> in order to suppress the <a id="wrglossary.2022"></a><a href="#glo:dual.indexing">indexing</a> while working on a draft version to speed compilation, or the user may prefer to use Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.b2g">4</a> for <a id="wrglossary.2023"></a><a href="#glo:dual.indexing">indexing</a>, which don’t use <a id="wrglossary.2024"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.<p>
+Therefore <a id="wrglossary.2025"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> can’t be used to enable <a id="wrglossary.2026"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and commands like <a id="wrglossary.2027"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.2028"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>. These commands must be enabled by default. (It does, however, enable the <a id="wrglossary.2029"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key as that’s a more common problem. See below.)<p>
+The debug mode, enabled with the <a id="wrglossary.2030"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> option, <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2031"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>]{glossaries}
+</pre> will write information to the log file when the <a id="wrglossary.2032"></a><a href="#glo:dual.indexing">indexing</a> can’t occur because the associated file isn’t open. The message is written in the form <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>Package glossaries Info: wrglossary(<span class="meta">〈<em class="metainner">type</em>〉</span>)(<span class="meta">〈<em class="metainner">text</em>〉</span>) on
+input line <span class="meta">〈<em class="metainner">line number</em>〉</span>.
+</pre> where <span class="meta">〈<em class="metainner">type</em>〉</span> is the glossary label and <span class="meta">〈<em class="metainner">text</em>〉</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 <a id="wrglossary.2033"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> or <a id="wrglossary.2034"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, try switching on the <a id="wrglossary.2035"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> option and see if any information has been written to the log file.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2036"></a><code class="code"><dfn id="glo:opt.savewrites"><span class="styoptfmt">savewrites</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This is a boolean option to minimise the number of write registers used by the <a id="wrglossary.2037"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. The default is <a id="wrglossary.2038"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a><span class="optfmt">=false</span>. With Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, one write register is required per (non-ignored) <a id="wrglossary.2039"></a><a href="#glo:dual.glossary">glossary</a> and one for the style file.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
In general, this package option is best avoided. </div><!-- end of information -->
<p>
-With all options except Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.b2g">4</a>14, another write register is required if the <a id="wrglossary.2227"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file is needed to save document definitions. With both Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.b2g">4</a>, no write registers are required (document definitions aren’t permitted and <a id="wrglossary.2228"></a><a href="#glo:dual.indexing">indexing</a> information is written to the <a id="wrglossary.2229"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file). If you really need document definitions but you want to minimise the number of write registers then consider using <a id="wrglossary.2230"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span> with <a id="wrglossary.2231"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
-There are only a limited number of write registers, and if you have a large number of <a id="wrglossary.2232"></a><a href="#glo:dual.glossary">glossaries</a> 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 <a id="wrglossary.2233"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a> is set, the <a id="wrglossary.2234"></a><a href="#glo:dual.glossary">glossary</a> information will be stored in token registers until the end of the document when they will be written to the external files.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.2235"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-This option can significantly slow document compilation and may cause the <a id="wrglossary.2236"></a><a href="#glo:dual.indexing">indexing</a> to fail. Page numbers in the <a id="wrglossary.2237"></a><a href="#glo:locationlist">number list</a> will be incorrect on page boundaries due to TeX’s asynchronous output routine. As an alternative, you can use the <a id="wrglossary.2238"></a><a href="#glo:pkg.scrwfile"><span class="styfmt">scrwfile</span></a> package (part of the KOMA-Script bundle) and not use this option. </div><!-- end of important -->
+With all options except Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.b2g">4</a>14, another write register is required if the <a id="wrglossary.2040"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file is needed to save document definitions. With both Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.b2g">4</a>, no write registers are required (document definitions aren’t permitted and <a id="wrglossary.2041"></a><a href="#glo:dual.indexing">indexing</a> information is written to the <a id="wrglossary.2042"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file). If you really need document definitions but you want to minimise the number of write registers then consider using <a id="wrglossary.2043"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span> with <a id="wrglossary.2044"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+There are only a limited number of write registers, and if you have a large number of <a id="wrglossary.2045"></a><a href="#glo:dual.glossary">glossaries</a> 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 <a id="wrglossary.2046"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a> is set, the <a id="wrglossary.2047"></a><a href="#glo:dual.glossary">glossary</a> information will be stored in token registers until the end of the document when they will be written to the external files.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+This option can significantly slow document compilation and may cause the <a id="wrglossary.2048"></a><a href="#glo:dual.indexing">indexing</a> to fail. Page numbers in the <a id="wrglossary.2049"></a><a href="#glo:locationlist">number list</a> will be incorrect on page boundaries due to TeX’s asynchronous output routine. As an alternative, you can use the <a id="wrglossary.2050"></a><a href="#glo:pkg.scrwfile"><span class="styfmt">scrwfile</span></a> package (part of the KOMA-Script bundle) and not use this option. </div><!-- end of important -->
<p>
-By way of comparison, <span class="filefmt">sample-multi2.tex</span> provided with <a id="wrglossary.2239"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has a total of 15 <a id="wrglossary.2240"></a><a href="#glo:dual.glossary">glossaries</a>. With Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, this would require 46 associated files and 16 write registers. (These figures don’t include standard files and registers provided by the kernel or <a id="wrglossary.2241"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, such as <a id="wrglossary.2242"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> and <span class="filefmt">out</span>.) With <a id="wrglossary.2243"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></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>
-<div class="important"><div class="importanttitle"><a id="wrglossary.2244"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-If you want to use TeX’s <a id="wrglossary.2245"></a><a href="#glo:dual.shellescape">shell escape</a> to call <a id="wrglossary.2246"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2247"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> from your document and use <a id="wrglossary.2248"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a>, then use <a id="wrglossary.2249"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2250"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or <a id="wrglossary.2251"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2252"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a> or <a id="wrglossary.2253"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2254"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a>. </div><!-- end of important -->
+By way of comparison, <span class="filefmt">sample-multi2.tex</span> provided with <a id="wrglossary.2051"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has a total of 15 <a id="wrglossary.2052"></a><a href="#glo:dual.glossary">glossaries</a>. With Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, this would require 46 associated files and 16 write registers. (These figures don’t include standard files and registers provided by the kernel or <a id="wrglossary.2053"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, such as <a id="wrglossary.2054"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> and <span class="filefmt">out</span>.) With <a id="wrglossary.2055"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></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>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you want to use TeX’s <a id="wrglossary.2056"></a><a href="#glo:dual.shellescape">shell escape</a> to call <a id="wrglossary.2057"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2058"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> from your document and use <a id="wrglossary.2059"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a>, then use <a id="wrglossary.2060"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2061"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or <a id="wrglossary.2062"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2063"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a> or <a id="wrglossary.2064"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2065"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a>. </div><!-- end of important -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2255"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2256"></a><code class="code"><dfn id="glo:opt.translate"><span class="styoptfmt">translate</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
- This can take one of the values listed below. If no supported language package has been loaded the default is <a id="wrglossary.2257"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2258"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> otherwise the default is <a id="wrglossary.2259"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2260"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a> for the base <a id="wrglossary.2261"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2262"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2263"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> for <a id="wrglossary.2264"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2265"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2266"></a><a id="wrglossary.2267"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>=<code class="code"><dfn id="glo:optval.translate.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
- If <a id="wrglossary.2268"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded and the <a id="wrglossary.2269"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is installed, <a id="wrglossary.2270"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> will be loaded and the translations will be provided by the <a id="wrglossary.2271"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package interface. You can modify the translations by providing your own dictionary. If the <a id="wrglossary.2272"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package isn’t installed and <a id="wrglossary.2273"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> is loaded, the <a id="wrglossary.2274"></a><a href="#glo:pkg.glossaries-babel"><span class="styfmt">glossaries-babel</span></a> package will be loaded and the translations will be provided using <a id="wrglossary.2275"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> <code class="csfmt">\addto</code><a id="wrglossary.2276"></a><a href="#glo:captionslanguage"><code class="csfmt">\captions<span class="meta">〈<em class="metainner">language</em>〉</span></code></a> mechanism. If <a id="wrglossary.2277"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> has been loaded, <a id="wrglossary.2278"></a><a href="#glo:pkg.glossaries-polyglossia"><span class="styfmt">glossaries-polyglossia</span></a> will be loaded.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2279"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2280"></a><a id="wrglossary.2281"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>=<code class="code"><dfn id="glo:optval.translate.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
- Don’t provide translations, even if <a id="wrglossary.2282"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.2283"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> has been loaded. (Note that <a id="wrglossary.2284"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> provides the command <a id="wrglossary.2285"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> so that will still be translated if you have loaded <a id="wrglossary.2286"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>.)<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2287"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2288"></a><a id="wrglossary.2289"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>=<code class="code"><dfn id="glo:optval.translate.babel"><span class="optfmt">babel</span></dfn></code></div><!-- end of optionvaluebox -->
- Don’t load the <a id="wrglossary.2290"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package. Instead load <a id="wrglossary.2291"></a><a href="#glo:pkg.glossaries-babel"><span class="styfmt">glossaries-babel</span></a>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.2292"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-I recommend you use <a id="wrglossary.2293"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2294"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> if you have any problems with the translations or with <a id="wrglossary.2295"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a>, but to maintain backward compatibility, if <a id="wrglossary.2296"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded the default is <a id="wrglossary.2297"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2298"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a>. </div><!-- end of important -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2066"></a><code class="code"><dfn id="glo:opt.translate"><span class="styoptfmt">translate</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This can take one of the values listed below. If no supported language package has been loaded the default is <a id="wrglossary.2067"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2068"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> otherwise the default is <a id="wrglossary.2069"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2070"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a> for the base <a id="wrglossary.2071"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2072"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2073"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> for <a id="wrglossary.2074"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2075"></a><a id="wrglossary.2076"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>=<code class="code"><dfn id="glo:optval.translate.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+ If <a id="wrglossary.2077"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded and the <a id="wrglossary.2078"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is installed, <a id="wrglossary.2079"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> will be loaded and the translations will be provided by the <a id="wrglossary.2080"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package interface. You can modify the translations by providing your own dictionary. If the <a id="wrglossary.2081"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package isn’t installed and <a id="wrglossary.2082"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> is loaded, the <a id="wrglossary.2083"></a><a href="#glo:pkg.glossaries-babel"><span class="styfmt">glossaries-babel</span></a> package will be loaded and the translations will be provided using <a id="wrglossary.2084"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> <code class="csfmt">\addto</code><a id="wrglossary.2085"></a><a href="#glo:captionslanguage"><code class="csfmt">\captions<span class="meta">〈<em class="metainner">language</em>〉</span></code></a> mechanism. If <a id="wrglossary.2086"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> has been loaded, <a id="wrglossary.2087"></a><a href="#glo:pkg.glossaries-polyglossia"><span class="styfmt">glossaries-polyglossia</span></a> will be loaded.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2088"></a><a id="wrglossary.2089"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>=<code class="code"><dfn id="glo:optval.translate.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+ Don’t provide translations, even if <a id="wrglossary.2090"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.2091"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> has been loaded. (Note that <a id="wrglossary.2092"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> provides the command <a id="wrglossary.2093"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> so that will still be translated if you have loaded <a id="wrglossary.2094"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>.)<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2095"></a><a id="wrglossary.2096"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>=<code class="code"><dfn id="glo:optval.translate.babel"><span class="optfmt">babel</span></dfn></code></div><!-- end of optionvaluebox -->
+ Don’t load the <a id="wrglossary.2097"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package. Instead load <a id="wrglossary.2098"></a><a href="#glo:pkg.glossaries-babel"><span class="styfmt">glossaries-babel</span></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+I recommend you use <a id="wrglossary.2099"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2100"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> if you have any problems with the translations or with <a id="wrglossary.2101"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a>, but to maintain backward compatibility, if <a id="wrglossary.2102"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded the default is <a id="wrglossary.2103"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2104"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a>. </div><!-- end of important -->
<p>
-See §<a href="#sec:fixednames">1.5.1</a> for further details.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2299"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2300"></a><code class="code"><dfn id="glo:opt.notranslate"><span class="styoptfmt">notranslate</span></dfn></code></div><!-- end of settingsbox -->
- This is equivalent to <a id="wrglossary.2301"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2302"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> and may be passed via the document class options.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2303"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2304"></a><code class="code"><dfn id="glo:opt.languages"><span class="styoptfmt">languages</span></dfn></code></div><!-- end of settingsbox -->
- This automatically implements <a id="wrglossary.2305"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2306"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> (which means that <a id="wrglossary.2307"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> won’t automatically be loaded) but will also add the list of languages to <a id="wrglossary.2308"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> list of tracked languages. Each element in the <span class="meta">〈<em class="metainner">list</em>〉</span> may be an ISO language tag (such as <code class="code">pt-BR</code>) or one of <a id="wrglossary.2309"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> known language labels (such as <code class="code">british</code>).<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2310"></a><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2311"></a><code class="code"><dfn id="glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If true, terms on <a id="wrglossary.2312"></a><a href="#glo:dual.firstuse">first use</a> will have a <a id="wrglossary.2313"></a><a href="#glo:idx.hyperlink">hyperlink</a>, if supported, unless the <a id="wrglossary.2314"></a><a href="#glo:idx.hyperlink">hyperlink</a> is explicitly suppressed using starred versions of commands such as <code class="code"><a id="wrglossary.2315"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>*</code>. If false, only <a id="wrglossary.2316"></a><a href="#glo:dual.subsequentuse">subsequent use</a> instances will have a <a id="wrglossary.2317"></a><a href="#glo:idx.hyperlink">hyperlink</a> (if supported).<p>
-Note that <a id="wrglossary.2318"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> overrides <a id="wrglossary.2319"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=true</span>. This option only affects commands that check the <a id="wrglossary.2320"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as the <a id="wrglossary.2321"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> commands (for example, <a id="wrglossary.2322"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.2323"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>), but not the <a id="wrglossary.2324"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands (for example, <a id="wrglossary.2325"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> or <a id="wrglossary.2326"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>). <p>
-The <a id="wrglossary.2327"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> setting applies to all <a id="wrglossary.2328"></a><a href="#glo:dual.glossary">glossary</a> types (unless identified by <a id="wrglossary.2329"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> or defined with <a id="wrglossary.2330"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>). It can be overridden on an individual basis by explicitly setting the <a id="wrglossary.2331"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a> key when referencing an entry (or by using the plus or starred version of the referencing command).<p>
-It may be that you only want to suppress <a id="wrglossary.2332"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for just the <a id="wrglossary.2333"></a><a href="#glo:idx.acronym">acronyms</a> (where the <a id="wrglossary.2334"></a><a href="#glo:dual.firstuse">first use</a> explains the meaning of the <a id="wrglossary.2335"></a><a href="#glo:idx.acronym">acronym</a>) but not for ordinary <a id="wrglossary.2336"></a><a href="#glo:idx.glossaryentry">glossary entries</a> (where the <a id="wrglossary.2337"></a><a href="#glo:dual.firstuse">first use</a> is identical to <a id="wrglossary.2338"></a><a href="#glo:dual.subsequentuse">subsequent use</a>). In this case, you can use <a id="wrglossary.2339"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span> and apply <a id="wrglossary.2340"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> to all the regular (non-<a id="wrglossary.2341"></a><a href="#glo:idx.acronym">acronym</a>) <a id="wrglossary.2342"></a><a href="#glo:dual.glossary">glossaries</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2343"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2344"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.2345"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span>]{glossaries}
-<span class="comment">% <a id="wrglossary.2346"></a><a href="#glo:idx.acronym">acronym</a> and <a id="wrglossary.2347"></a><a href="#glo:idx.glossaryentry">glossary entry</a> definitions</span>
+See §<a href="#sec:fixednames">1.5.1</a> for further details.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2105"></a><code class="code"><dfn id="glo:opt.notranslate"><span class="styoptfmt">notranslate</span></dfn></code></div><!-- end of settingsbox -->
+ This is equivalent to <a id="wrglossary.2106"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2107"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> and may be passed via the document class options.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2108"></a><code class="code"><dfn id="glo:opt.languages"><span class="styoptfmt">languages</span></dfn></code></div><!-- end of settingsbox -->
+ This automatically implements <a id="wrglossary.2109"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2110"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> (which means that <a id="wrglossary.2111"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> won’t automatically be loaded) but will also add the list of languages to <a id="wrglossary.2112"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> list of tracked languages. Each element in the <span class="meta">〈<em class="metainner">list</em>〉</span> may be an ISO language tag (such as <code class="code">pt-BR</code>) or one of <a id="wrglossary.2113"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> known language labels (such as <code class="code">british</code>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2114"></a><code class="code"><dfn id="glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If true, terms on <a id="wrglossary.2115"></a><a href="#glo:dual.firstuse">first use</a> will have a <a id="wrglossary.2116"></a><a href="#glo:idx.hyperlink">hyperlink</a>, if supported, unless the <a id="wrglossary.2117"></a><a href="#glo:idx.hyperlink">hyperlink</a> is explicitly suppressed using starred versions of commands such as <code class="code"><a id="wrglossary.2118"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>*</code>. If false, only <a id="wrglossary.2119"></a><a href="#glo:dual.subsequentuse">subsequent use</a> instances will have a <a id="wrglossary.2120"></a><a href="#glo:idx.hyperlink">hyperlink</a> (if supported).<p>
+Note that <a id="wrglossary.2121"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> overrides <a id="wrglossary.2122"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=true</span>. This option only affects commands that check the <a id="wrglossary.2123"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as the <a id="wrglossary.2124"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> commands (for example, <a id="wrglossary.2125"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.2126"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>), but not the <a id="wrglossary.2127"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands (for example, <a id="wrglossary.2128"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> or <a id="wrglossary.2129"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>). <p>
+The <a id="wrglossary.2130"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> setting applies to all <a id="wrglossary.2131"></a><a href="#glo:dual.glossary">glossary</a> types (unless identified by <a id="wrglossary.2132"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> or defined with <a id="wrglossary.2133"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>). It can be overridden on an individual basis by explicitly setting the <a id="wrglossary.2134"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a> key when referencing an entry (or by using the plus or starred version of the referencing command).<p>
+It may be that you only want to suppress <a id="wrglossary.2135"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for just the <a id="wrglossary.2136"></a><a href="#glo:idx.acronym">acronyms</a> (where the <a id="wrglossary.2137"></a><a href="#glo:dual.firstuse">first use</a> explains the meaning of the <a id="wrglossary.2138"></a><a href="#glo:idx.acronym">acronym</a>) but not for ordinary <a id="wrglossary.2139"></a><a href="#glo:idx.glossaryentry">glossary entries</a> (where the <a id="wrglossary.2140"></a><a href="#glo:dual.firstuse">first use</a> is identical to <a id="wrglossary.2141"></a><a href="#glo:dual.subsequentuse">subsequent use</a>). In this case, you can use <a id="wrglossary.2142"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span> and apply <a id="wrglossary.2143"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> to all the regular (non-<a id="wrglossary.2144"></a><a href="#glo:idx.acronym">acronym</a>) <a id="wrglossary.2145"></a><a href="#glo:dual.glossary">glossaries</a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2146"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.2147"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span>]{glossaries}
+<span class="comment">% <a id="wrglossary.2148"></a><a href="#glo:idx.acronym">acronym</a> and <a id="wrglossary.2149"></a><a href="#glo:idx.glossaryentry">glossary entry</a> definitions</span>
<span class="comment">% at the end of the preamble</span>
-<a id="wrglossary.2348"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a>[<a id="wrglossary.2349"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>]
+<a id="wrglossary.2150"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a>[<a id="wrglossary.2151"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>]
</pre><p>
-Alternatively you can redefine the hook <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2350"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2351"></a><code class="code"><dfn id="glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></dfn></code></div><!-- end of pinnedbox -->
- which is used by the commands that check the <a id="wrglossary.2352"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as <a id="wrglossary.2353"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. Within the definition of this command, you can use <a id="wrglossary.2354"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> to reference the <a id="wrglossary.2355"></a><a href="#glo:idx.glossaryentry">entry</a> label and <a id="wrglossary.2356"></a><a href="#glo:glstype"><code class="csfmt">\glstype</code></a> to reference the <a id="wrglossary.2357"></a><a href="#glo:dual.glossary">glossary</a> type. You can also use <a id="wrglossary.2358"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> to determine if the <a id="wrglossary.2359"></a><a href="#glo:idx.glossaryentry">entry</a> has been used. You can test if an <a id="wrglossary.2360"></a><a href="#glo:idx.glossaryentry">entry</a> is an <a id="wrglossary.2361"></a><a href="#glo:idx.acronym">acronym</a> by checking if it has the <a id="wrglossary.2362"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key set using <a id="wrglossary.2363"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> (or if the <a id="wrglossary.2364"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> key has been set using <a id="wrglossary.2365"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>). For example, to switch off the <a id="wrglossary.2366"></a><a href="#glo:idx.hyperlink">hyperlink</a> on <a id="wrglossary.2367"></a><a href="#glo:dual.firstuse">first use</a> just for <a id="wrglossary.2368"></a><a href="#glo:idx.acronym">acronyms</a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2369"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.2370"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="cs!
fmt">\glslinkcheckfirsthyperhook</code></a>}{<span class="comment">% </span>
- <a id="wrglossary.2371"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{<a id="wrglossary.2372"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{}<span class="comment">% </span>
+Alternatively you can redefine the hook <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2152"></a><code class="code"><dfn id="glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></dfn></code></div><!-- end of pinnedbox -->
+ which is used by the commands that check the <a id="wrglossary.2153"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as <a id="wrglossary.2154"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. Within the definition of this command, you can use <a id="wrglossary.2155"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> to reference the <a id="wrglossary.2156"></a><a href="#glo:idx.glossaryentry">entry</a> label and <a id="wrglossary.2157"></a><a href="#glo:glstype"><code class="csfmt">\glstype</code></a> to reference the <a id="wrglossary.2158"></a><a href="#glo:dual.glossary">glossary</a> type. You can also use <a id="wrglossary.2159"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a> to determine if the <a id="wrglossary.2160"></a><a href="#glo:idx.glossaryentry">entry</a> has been used. You can test if an <a id="wrglossary.2161"></a><a href="#glo:idx.glossaryentry">entry</a> is an <a id="wrglossary.2162"></a><a href="#glo:idx.acronym">acronym</a> by checking if it has the <a id="wrglossary.2163"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key set using <a id="wrglossary.2164"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> (or if the <a id="wrglossary.2165"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> key has been set using <a id="wrglossary.2166"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>). For example, to switch off the <a id="wrglossary.2167"></a><a href="#glo:idx.hyperlink">hyperlink</a> on <a id="wrglossary.2168"></a><a href="#glo:dual.firstuse">first use</a> just for <a id="wrglossary.2169"></a><a href="#glo:idx.acronym">acronyms</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.2170"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirst!
hyperhook</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.2171"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{<a id="wrglossary.2172"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{}<span class="comment">% </span>
{<span class="comment">% </span>
- <a id="wrglossary.2373"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.2374"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<code class="cmd">\setkeys</code>{glslink}{<a id="wrglossary.2375"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>}}<span class="comment">% </span>
+ <a id="wrglossary.2173"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.2174"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<code class="cmd">\setkeys</code>{glslink}{<a id="wrglossary.2175"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a><span class="optfmt">=false</span>}}<span class="comment">% </span>
}<span class="comment">% </span>
}
</pre><p>
-Note that this hook isn’t used by the commands that don’t check the <a id="wrglossary.2376"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as <a id="wrglossary.2377"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>. (You can, instead, redefine <a id="wrglossary.2378"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>, which is used by both the <a id="wrglossary.2379"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.2380"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.)<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2381"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.2382"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a method of disabling the <a id="wrglossary.2383"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.2384"></a><a href="#glo:idx.hyperlink">hyperlink</a> according to the <a id="wrglossary.2385"></a><a href="#glo:idx.glossaryentry">entry’s</a> associated <a id="wrglossary.2386"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a>. For example, if you only want to switch off the <a id="wrglossary.2387"></a><a href="#glo:dual.firstuse">first use</a> hyperlink for <a id="wrglossary.2388"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you simply need to set the <a id="wrglossary.2389"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> <a id="wrglossary.2390"></a><a href="#glo:@@glslabel at categoryattribute">attribute</a> for the <a id="wrglossary.2391"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a> and, if appropriate, <a id="wrglossary.2392"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the <a id="wrglossary.2393"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> package option.) See the <a id="wrglossary.2394"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. </div><!-- end of information -->
+Note that this hook isn’t used by the commands that don’t check the <a id="wrglossary.2176"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as <a id="wrglossary.2177"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>. (You can, instead, redefine <a id="wrglossary.2178"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>, which is used by both the <a id="wrglossary.2179"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.2180"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.)<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2181"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.2182"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a method of disabling the <a id="wrglossary.2183"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.2184"></a><a href="#glo:idx.hyperlink">hyperlink</a> according to the <a id="wrglossary.2185"></a><a href="#glo:idx.glossaryentry">entry’s</a> associated <a id="wrglossary.2186"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a>. For example, if you only want to switch off the <a id="wrglossary.2187"></a><a href="#glo:dual.firstuse">first use</a> hyperlink for <a id="wrglossary.2188"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you simply need to set the <a id="wrglossary.2189"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> <a id="wrglossary.2190"></a><a href="#glo:@@glslabel at categoryattribute">attribute</a> for the <a id="wrglossary.2191"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a> and, if appropriate, <a id="wrglossary.2192"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the <a id="wrglossary.2193"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> package option.) See the <a id="wrglossary.2194"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2395"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2396"></a><code class="code"><dfn id="glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></dfn></code></div><!-- end of settingsbox -->
- This option will create a file called <code class="code"><a id="wrglossary.2397"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.2398"></a><a href="#glo:ext.glslabels"><span class="extfmt">glslabels</span></a></code> at the end of the document. This file simply contains a list of all defined entry labels (including those in any <a id="wrglossary.2399"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>). It’s provided for the benefit of text editors that need to know labels for <a id="wrglossary.2400"></a><a href="#glo:idx.auto-completion">auto-completion</a>. If you also want the name, use <a id="wrglossary.2401"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a>. (See also <a id="wrglossary.2402"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> <a id="wrglossary.2403"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span> package option.)<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2404"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
- Note that with <a id="wrglossary.2405"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> the file will only contain the entries that <a id="wrglossary.2406"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has selected from the <a id="wrglossary.2407"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. </div><!-- end of information -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2195"></a><code class="code"><dfn id="glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></dfn></code></div><!-- end of settingsbox -->
+ This option will create a file called <code class="code"><a id="wrglossary.2196"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.2197"></a><a href="#glo:ext.glslabels"><span class="extfmt">glslabels</span></a></code> at the end of the document. This file simply contains a list of all defined entry labels (including those in any <a id="wrglossary.2198"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>). It’s provided for the benefit of text editors that need to know labels for <a id="wrglossary.2199"></a><a href="#glo:idx.auto-completion">auto-completion</a>. If you also want the name, use <a id="wrglossary.2200"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a>. (See also <a id="wrglossary.2201"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> <a id="wrglossary.2202"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span> package option.)<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2203"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+ Note that with <a id="wrglossary.2204"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> the file will only contain the entries that <a id="wrglossary.2205"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has selected from the <a id="wrglossary.2206"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2408"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2409"></a><code class="code"><dfn id="glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></dfn></code></div><!-- end of settingsbox -->
- Similar to <a id="wrglossary.2410"></a><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a> but writes both the label and name (separated by a tab).<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2411"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2412"></a><code class="code"><dfn id="glo:opt.undefaction"><span class="xtrstyoptfmt">undefaction</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>error</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2207"></a><code class="code"><dfn id="glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></dfn></code></div><!-- end of settingsbox -->
+ Similar to <a id="wrglossary.2208"></a><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a> but writes both the label and name (separated by a tab).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2209"></a><code class="code"><dfn id="glo:opt.undefaction"><span class="xtrstyoptfmt">undefaction</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>error</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-Only available with <a id="wrglossary.2413"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, the value for this option may be one of:<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2414"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2415"></a><a id="wrglossary.2416"></a><a href="#glo:opt.undefaction"><span class="xtrstyoptfmt">undefaction</span></a>=<code class="code"><dfn id="glo:optval.undefaction.error"><span class="xtroptfmt">error</span></dfn></code></div><!-- end of optionvaluebox -->
- Generates an error if a referenced entry is undefined (default, and the only available setting with just the base <a id="wrglossary.2417"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2418"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2419"></a><a id="wrglossary.2420"></a><a href="#glo:opt.undefaction"><span class="xtrstyoptfmt">undefaction</span></a>=<code class="code"><dfn id="glo:optval.undefaction.warn"><span class="xtroptfmt">warn</span></dfn></code></div><!-- end of optionvaluebox -->
- Only warns if a referenced entry is undefined (automatically activated with <a id="wrglossary.2421"></a><a href="#glo:idx.opt.b2g">Option 4</a>).<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2422"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2423"></a><code class="code"><dfn id="glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+Only available with <a id="wrglossary.2210"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, the value for this option may be one of:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2211"></a><a id="wrglossary.2212"></a><a href="#glo:opt.undefaction"><span class="xtrstyoptfmt">undefaction</span></a>=<code class="code"><dfn id="glo:optval.undefaction.error"><span class="xtroptfmt">error</span></dfn></code></div><!-- end of optionvaluebox -->
+ Generates an error if a referenced entry is undefined (default, and the only available setting with just the base <a id="wrglossary.2213"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2214"></a><a id="wrglossary.2215"></a><a href="#glo:opt.undefaction"><span class="xtrstyoptfmt">undefaction</span></a>=<code class="code"><dfn id="glo:optval.undefaction.warn"><span class="xtroptfmt">warn</span></dfn></code></div><!-- end of optionvaluebox -->
+ Only warns if a referenced entry is undefined (automatically activated with <a id="wrglossary.2216"></a><a href="#glo:idx.opt.b2g">Option 4</a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2217"></a><code class="code"><dfn id="glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-Only available with <a id="wrglossary.2424"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option governs the use of <a id="wrglossary.2425"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. Available values:<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2426"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2427"></a><a id="wrglossary.2428"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.false"><span class="xtroptfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting means that <a id="wrglossary.2429"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is not permitted in the <a id="wrglossary.2430"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment (default with <a id="wrglossary.2431"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and for <a id="wrglossary.2432"></a><a href="#glo:idx.opt.noidx">Option 1</a> with just the base <a id="wrglossary.2433"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2434"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2435"></a><a id="wrglossary.2436"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting means that <a id="wrglossary.2437"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is only permitted in the <a id="wrglossary.2438"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment if it occurs before <a id="wrglossary.2439"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (not available for some indexing options, such as Option <a href="#glo:idx.opt.b2g">4</a>).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2440"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2441"></a><a id="wrglossary.2442"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.atom"><span class="xtroptfmt">atom</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting is as <a id="wrglossary.2443"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2444"></a><a href="#glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></a> but creates the <a id="wrglossary.2445"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file for use by <a id="wrglossary.2446"></a><a href="#glo:app.atom"><span class="appfmt">atom</span></a> (without the limitations of <a id="wrglossary.2447"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2448"></a><a href="#glo:optval.docdef.true"><span class="xtroptfmt">true</span></a>).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2449"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2450"></a><a id="wrglossary.2451"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.true"><span class="xtroptfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting means that <a id="wrglossary.2452"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is permitted in the <a id="wrglossary.2453"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment where it would normally be permitted by the base <a id="wrglossary.2454"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This will create the <a id="wrglossary.2455"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file if <a id="wrglossary.2456"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is found in the <a id="wrglossary.2457"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment.<p>
+Only available with <a id="wrglossary.2218"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option governs the use of <a id="wrglossary.2219"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. Available values:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2220"></a><a id="wrglossary.2221"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.false"><span class="xtroptfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting means that <a id="wrglossary.2222"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is not permitted in the <a id="wrglossary.2223"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment (default with <a id="wrglossary.2224"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and for <a id="wrglossary.2225"></a><a href="#glo:idx.opt.noidx">Option 1</a> with just the base <a id="wrglossary.2226"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2227"></a><a id="wrglossary.2228"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting means that <a id="wrglossary.2229"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is only permitted in the <a id="wrglossary.2230"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment if it occurs before <a id="wrglossary.2231"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (not available for some indexing options, such as Option <a href="#glo:idx.opt.b2g">4</a>).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2232"></a><a id="wrglossary.2233"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.atom"><span class="xtroptfmt">atom</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is as <a id="wrglossary.2234"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2235"></a><a href="#glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></a> but creates the <a id="wrglossary.2236"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file for use by <a id="wrglossary.2237"></a><a href="#glo:app.atom"><span class="appfmt">atom</span></a> (without the limitations of <a id="wrglossary.2238"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2239"></a><a href="#glo:optval.docdef.true"><span class="xtroptfmt">true</span></a>).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2240"></a><a id="wrglossary.2241"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>=<code class="code"><dfn id="glo:optval.docdef.true"><span class="xtroptfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting means that <a id="wrglossary.2242"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is permitted in the <a id="wrglossary.2243"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment where it would normally be permitted by the base <a id="wrglossary.2244"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This will create the <a id="wrglossary.2245"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file if <a id="wrglossary.2246"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is found in the <a id="wrglossary.2247"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment.<p>
</section><!-- end of section sec:pkgopts-general -->
@@ -2571,73 +2597,73 @@
<section id="sec:pkgopts-sec"><!-- start of section sec:pkgopts-sec --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.2. Sectioning, Headings and TOC Options<div class="labellink"><a href="#sec:pkgopts-sec">[link]</a></div></h2><!-- end of section header -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2458"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2459"></a><code class="code"><dfn id="glo:opt.toc"><span class="styoptfmt">toc</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
- Adds the <a id="wrglossary.2460"></a><a href="#glo:dual.glossary">glossaries</a> to the <a id="wrglossary.2461"></a><a href="#glo:idx.tableofcontents">table of contents</a> (<a id="wrglossary.2462"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file). Note that an extra LaTeX run is required with this option. Alternatively, you can switch this function on and off using <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2463"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2464"></a><code class="code"><dfn id="glo:glstoctrue"><code class="csfmt">\glstoctrue</code></dfn></code></div><!-- end of pinnedbox -->
- and <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2465"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2466"></a><code class="code"><dfn id="glo:glstocfalse"><code class="csfmt">\glstocfalse</code></dfn></code></div><!-- end of pinnedbox -->
- You can test whether or not this option is set using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2467"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2468"></a><code class="code"><dfn id="glo:ifglstoc"><code class="csfmt">\ifglstoc</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- The default value is <a id="wrglossary.2469"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span> for the base <a id="wrglossary.2470"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2471"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> for <a id="wrglossary.2472"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2473"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2474"></a><code class="code"><dfn id="glo:opt.numberline"><span class="styoptfmt">numberline</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- When used with <a id="wrglossary.2475"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> option, this will add <code class="code"><a id="wrglossary.2476"></a><a href="#glo:numberline"><code class="csfmt">\numberline</code></a>{}</code> in the final argument of <a id="wrglossary.2477"></a><a href="#glo:addcontentsline"><code class="csfmt">\addcontentsline</code></a>. This will align the <a id="wrglossary.2478"></a><a href="#glo:idx.tableofcontents">table of contents</a> entry with the numbered section titles. Note that this option has no effect with <a id="wrglossary.2479"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span>. If <a id="wrglossary.2480"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> is used without <a id="wrglossary.2481"></a><a href="#glo:opt.numberline"><span class="styoptfmt">numberline</span></a>, the <a id="wrglossary.2482"></a><a href="#glo:dual.glossary">glossary</a> title will be aligned with the section numbers rather than the section titles.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2483"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2484"></a><code class="code"><dfn id="glo:opt.section"><span class="styoptfmt">section</span></dfn>=<span class="meta">〈<em class="metainner">name</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>section</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2248"></a><code class="code"><dfn id="glo:opt.toc"><span class="styoptfmt">toc</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ Adds the <a id="wrglossary.2249"></a><a href="#glo:dual.glossary">glossaries</a> to the <a id="wrglossary.2250"></a><a href="#glo:idx.tableofcontents">table of contents</a> (<a id="wrglossary.2251"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file). Note that an extra LaTeX run is required with this option. Alternatively, you can switch this function on and off using <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2252"></a><code class="code"><dfn id="glo:glstoctrue"><code class="csfmt">\glstoctrue</code></dfn></code></div><!-- end of pinnedbox -->
+ and <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2253"></a><code class="code"><dfn id="glo:glstocfalse"><code class="csfmt">\glstocfalse</code></dfn></code></div><!-- end of pinnedbox -->
+ You can test whether or not this option is set using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2254"></a><code class="code"><dfn id="glo:ifglstoc"><code class="csfmt">\ifglstoc</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ The default value is <a id="wrglossary.2255"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span> for the base <a id="wrglossary.2256"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2257"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> for <a id="wrglossary.2258"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2259"></a><code class="code"><dfn id="glo:opt.numberline"><span class="styoptfmt">numberline</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ When used with <a id="wrglossary.2260"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> option, this will add <code class="code"><a id="wrglossary.2261"></a><a href="#glo:numberline"><code class="csfmt">\numberline</code></a>{}</code> in the final argument of <a id="wrglossary.2262"></a><a href="#glo:addcontentsline"><code class="csfmt">\addcontentsline</code></a>. This will align the <a id="wrglossary.2263"></a><a href="#glo:idx.tableofcontents">table of contents</a> entry with the numbered section titles. Note that this option has no effect with <a id="wrglossary.2264"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span>. If <a id="wrglossary.2265"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> is used without <a id="wrglossary.2266"></a><a href="#glo:opt.numberline"><span class="styoptfmt">numberline</span></a>, the <a id="wrglossary.2267"></a><a href="#glo:dual.glossary">glossary</a> title will be aligned with the section numbers rather than the section titles.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2268"></a><code class="code"><dfn id="glo:opt.section"><span class="styoptfmt">section</span></dfn>=<span class="meta">〈<em class="metainner">name</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>section</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-This option indicates the sectional unit to use for the <a id="wrglossary.2485"></a><a href="#glo:dual.glossary">glossary</a>. The value <span class="meta">〈<em class="metainner">name</em>〉</span> should be the control sequence <span style="font-style: italic; font-variant: normal; ">name</span> without the leading backslash or following star (for example, just <code class="code">chapter</code> not <a id="wrglossary.2486"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <code class="code">chapter*</code>).<p>
-The default behaviour is for the glossary heading to use <a id="wrglossary.2487"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a>, if that command exists, or <a id="wrglossary.2488"></a><a href="#glo:section"><code class="csfmt">\section</code></a> otherwise. The starred or unstarred form is determined by the <a id="wrglossary.2489"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a> option.<p>
-Example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2490"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2491"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="optfmt">=subsection</span>]{glossaries}
-</pre> You can omit the value if you want to use <a id="wrglossary.2492"></a><a href="#glo:section"><code class="csfmt">\section</code></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2493"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2494"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>]{glossaries}
-</pre> is equivalent to <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2495"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2496"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="optfmt">=section</span>]{glossaries}
-</pre> You can change this value later in the document using <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2497"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2498"></a><code class="code"><dfn id="glo:setglossarysection"><code class="csfmt">\setglossarysection</code></dfn><span class="meta">〈<em class="metainner">name</em>〉</span></code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">name</em>〉</span> is the sectional unit.<p>
-The start of each <a id="wrglossary.2499"></a><a href="#glo:dual.glossary">glossary</a> adds information to the page header via <a id="wrglossary.2500"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> (see §<a href="#sec:glossmarkup">8.2</a>).<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2501"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2502"></a><code class="code"><dfn id="glo:opt.ucmark"><span class="styoptfmt">ucmark</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If <a id="wrglossary.2503"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>, this will make <a id="wrglossary.2504"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> use <a id="wrglossary.2505"></a><a href="#glo:idx.allcaps">all caps</a> in the header, otherwise no <a id="wrglossary.2506"></a><a href="#glo:dual.casechange">case change</a> will be applied. The default is <a id="wrglossary.2507"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=false</span>, unless <a id="wrglossary.2508"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a> has been loaded, in which case the default is <a id="wrglossary.2509"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>.<p>
-You can test if this option has been set using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2510"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2511"></a><code class="code"><dfn id="glo:ifglsucmark"><code class="csfmt">\ifglsucmark</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2512"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.2513"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a>}[1]{<span class="comment">% </span>
- <a id="wrglossary.2514"></a><a href="#glo:ifglsucmark"><code class="csfmt">\ifglsucmark</code></a>
- <a id="wrglossary.2515"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{<a id="wrglossary.2516"></a><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a>{#1}}<span class="comment">% </span>
+This option indicates the sectional unit to use for the <a id="wrglossary.2269"></a><a href="#glo:dual.glossary">glossary</a>. The value <span class="meta">〈<em class="metainner">name</em>〉</span> should be the control sequence <span style="font-style: italic; font-variant: normal; ">name</span> without the leading backslash or following star (for example, just <code class="code">chapter</code> not <a id="wrglossary.2270"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <code class="code">chapter*</code>).<p>
+The default behaviour is for the glossary heading to use <a id="wrglossary.2271"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a>, if that command exists, or <a id="wrglossary.2272"></a><a href="#glo:section"><code class="csfmt">\section</code></a> otherwise. The starred or unstarred form is determined by the <a id="wrglossary.2273"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a> option.<p>
+Example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2274"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="optfmt">=subsection</span>]{glossaries}
+</pre> You can omit the value if you want to use <a id="wrglossary.2275"></a><a href="#glo:section"><code class="csfmt">\section</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2276"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>]{glossaries}
+</pre> is equivalent to <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2277"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="optfmt">=section</span>]{glossaries}
+</pre> You can change this value later in the document using <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2278"></a><code class="code"><dfn id="glo:setglossarysection"><code class="csfmt">\setglossarysection</code></dfn><span class="meta">〈<em class="metainner">name</em>〉</span></code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">name</em>〉</span> is the sectional unit.<p>
+The start of each <a id="wrglossary.2279"></a><a href="#glo:dual.glossary">glossary</a> adds information to the page header via <a id="wrglossary.2280"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> (see §<a href="#sec:glossmarkup">8.2</a>).<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2281"></a><code class="code"><dfn id="glo:opt.ucmark"><span class="styoptfmt">ucmark</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If <a id="wrglossary.2282"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>, this will make <a id="wrglossary.2283"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> use <a id="wrglossary.2284"></a><a href="#glo:idx.allcaps">all caps</a> in the header, otherwise no <a id="wrglossary.2285"></a><a href="#glo:dual.casechange">case change</a> will be applied. The default is <a id="wrglossary.2286"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=false</span>, unless <a id="wrglossary.2287"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a> has been loaded, in which case the default is <a id="wrglossary.2288"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>.<p>
+You can test if this option has been set using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2289"></a><code class="code"><dfn id="glo:ifglsucmark"><code class="csfmt">\ifglsucmark</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.2290"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.2291"></a><a href="#glo:ifglsucmark"><code class="csfmt">\ifglsucmark</code></a>
+ <a id="wrglossary.2292"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{<a id="wrglossary.2293"></a><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a>{#1}}<span class="comment">% </span>
<code class="cmd">\else</code>
- <a id="wrglossary.2517"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{#1}<span class="comment">% </span>
+ <a id="wrglossary.2294"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{#1}<span class="comment">% </span>
<code class="cmd">\fi</code>}
</pre><p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2518"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2519"></a><code class="code"><dfn id="glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>nolabel; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- The <a id="wrglossary.2520"></a><a href="#glo:dual.glossary">glossaries</a> are placed in unnumbered sectional units by default, but this can be changed using <a id="wrglossary.2521"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>. This option can take one of the following values:<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2522"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2523"></a><a id="wrglossary.2524"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
- No number, that is, use the starred form of sectioning command (for example, <a id="wrglossary.2525"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or <a id="wrglossary.2526"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2527"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2528"></a><a id="wrglossary.2529"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.nolabel"><span class="optfmt">nolabel</span></dfn></code></div><!-- end of optionvaluebox -->
- Use a numbered section, that is, the unstarred form of sectioning command (for example, <a id="wrglossary.2530"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2531"></a><a href="#glo:section"><code class="csfmt">\section</code></a>), but no label is automatically added.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2532"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2533"></a><a id="wrglossary.2534"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.autolabel"><span class="optfmt">autolabel</span></dfn></code></div><!-- end of optionvaluebox -->
- Use numbered sections with automatic labelling. Each <a id="wrglossary.2535"></a><a href="#glo:dual.glossary">glossary</a> uses the unstarred form of a sectioning command (for example, <a id="wrglossary.2536"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2537"></a><a href="#glo:section"><code class="csfmt">\section</code></a>) and is assigned a label (via <a id="wrglossary.2538"></a><a href="#glo:label"><code class="csfmt">\label</code></a>). The label is formed from the <a id="wrglossary.2539"></a><a href="#glo:dual.glossary">glossary’s</a> label prefixed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2540"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2541"></a><code class="code"><dfn id="glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></dfn></code></div><!-- end of pinnedbox -->
- The default value of <a id="wrglossary.2542"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> is empty. For example, if you load <a id="wrglossary.2543"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> using: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2544"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2545"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>,<a id="wrglossary.2546"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span>]
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2295"></a><code class="code"><dfn id="glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>nolabel; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ The <a id="wrglossary.2296"></a><a href="#glo:dual.glossary">glossaries</a> are placed in unnumbered sectional units by default, but this can be changed using <a id="wrglossary.2297"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>. This option can take one of the following values:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2298"></a><a id="wrglossary.2299"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+ No number, that is, use the starred form of sectioning command (for example, <a id="wrglossary.2300"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or <a id="wrglossary.2301"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2302"></a><a id="wrglossary.2303"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.nolabel"><span class="optfmt">nolabel</span></dfn></code></div><!-- end of optionvaluebox -->
+ Use a numbered section, that is, the unstarred form of sectioning command (for example, <a id="wrglossary.2304"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2305"></a><a href="#glo:section"><code class="csfmt">\section</code></a>), but no label is automatically added.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2306"></a><a id="wrglossary.2307"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.autolabel"><span class="optfmt">autolabel</span></dfn></code></div><!-- end of optionvaluebox -->
+ Use numbered sections with automatic labelling. Each <a id="wrglossary.2308"></a><a href="#glo:dual.glossary">glossary</a> uses the unstarred form of a sectioning command (for example, <a id="wrglossary.2309"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2310"></a><a href="#glo:section"><code class="csfmt">\section</code></a>) and is assigned a label (via <a id="wrglossary.2311"></a><a href="#glo:label"><code class="csfmt">\label</code></a>). The label is formed from the <a id="wrglossary.2312"></a><a href="#glo:dual.glossary">glossary’s</a> label prefixed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2313"></a><code class="code"><dfn id="glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></dfn></code></div><!-- end of pinnedbox -->
+ The default value of <a id="wrglossary.2314"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> is empty. For example, if you load <a id="wrglossary.2315"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> using: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2316"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>,<a id="wrglossary.2317"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span>]
{glossaries}
-</pre> then each <a id="wrglossary.2547"></a><a href="#glo:dual.glossary">glossary</a> will appear in a numbered section, and can be referenced using something like: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2548"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The main glossary is in section<a id="wrglossary.2549"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2550"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{main} and
-the list of acronyms is in section<a id="wrglossary.2551"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2552"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{acronym}.
-</pre> If you can’t decide whether to have the acronyms in the main glossary or a separate list of acronyms, you can use <a id="wrglossary.2553"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> which is set to <a id="wrglossary.2554"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> if the <a id="wrglossary.2555"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is not used and is set to <a id="wrglossary.2556"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> if the <a id="wrglossary.2557"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is used. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2558"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The list of acronyms is in section<a id="wrglossary.2559"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2560"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2561"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
-</pre> You can redefine the prefix if the default label clashes with another label in your document. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2562"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.2563"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a>}{glo:}
-</pre> will add <code class="code">glo:</code> to the automatically generated label, so you can then, for example, refer to the list of acronyms as follows: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2564"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The list of acronyms is in
-section<a id="wrglossary.2565"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2566"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{glo:<a id="wrglossary.2567"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
-</pre> Or, if you are undecided on a prefix: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2568"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The list of acronyms is in
-section<a id="wrglossary.2569"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2570"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2571"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a><a id="wrglossary.2572"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
+</pre> then each <a id="wrglossary.2318"></a><a href="#glo:dual.glossary">glossary</a> will appear in a numbered section, and can be referenced using something like: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The main glossary is in section<a id="wrglossary.2319"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2320"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{main} and
+the list of acronyms is in section<a id="wrglossary.2321"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2322"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{acronym}.
+</pre> If you can’t decide whether to have the acronyms in the main glossary or a separate list of acronyms, you can use <a id="wrglossary.2323"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> which is set to <a id="wrglossary.2324"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> if the <a id="wrglossary.2325"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is not used and is set to <a id="wrglossary.2326"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> if the <a id="wrglossary.2327"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is used. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The list of acronyms is in section<a id="wrglossary.2328"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2329"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2330"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
+</pre> You can redefine the prefix if the default label clashes with another label in your document. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.2331"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a>}{glo:}
+</pre> will add <code class="code">glo:</code> to the automatically generated label, so you can then, for example, refer to the list of acronyms as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The list of acronyms is in
+section<a id="wrglossary.2332"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2333"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{glo:<a id="wrglossary.2334"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
+</pre> Or, if you are undecided on a prefix: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The list of acronyms is in
+section<a id="wrglossary.2335"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2336"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2337"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a><a id="wrglossary.2338"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
</pre><p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2573"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2574"></a><a id="wrglossary.2575"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.nameref"><span class="optfmt">nameref</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting is like <a id="wrglossary.2576"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span> but uses an unnumbered sectioning command (for example, <a id="wrglossary.2577"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or <a id="wrglossary.2578"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>). It’s designed for use with the <a id="wrglossary.2579"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> package. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2580"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{nameref}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.2581"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
-</pre> Alternatively, since <a id="wrglossary.2582"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> is automatically loaded by <a id="wrglossary.2583"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2584"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{hyperref}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.2585"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
-</pre> Now <code class="code"><a id="wrglossary.2586"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{main}</code> will display the (<a id="wrglossary.2587"></a><a href="#glo:idx.tableofcontents">table of contents</a>) section title associated with the <a id="wrglossary.2588"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. As above, you can redefine <a id="wrglossary.2589"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> to provide a prefix for the label.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2339"></a><a id="wrglossary.2340"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>=<code class="code"><dfn id="glo:optval.numberedsection.nameref"><span class="optfmt">nameref</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is like <a id="wrglossary.2341"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span> but uses an unnumbered sectioning command (for example, <a id="wrglossary.2342"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or <a id="wrglossary.2343"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>). It’s designed for use with the <a id="wrglossary.2344"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> package. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{nameref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.2345"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
+</pre> Alternatively, since <a id="wrglossary.2346"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> is automatically loaded by <a id="wrglossary.2347"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{hyperref}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.2348"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
+</pre> Now <code class="code"><a id="wrglossary.2349"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{main}</code> will display the (<a id="wrglossary.2350"></a><a href="#glo:idx.tableofcontents">table of contents</a>) section title associated with the <a id="wrglossary.2351"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. As above, you can redefine <a id="wrglossary.2352"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> to provide a prefix for the label.<p>
</section><!-- end of section sec:pkgopts-sec -->
@@ -2644,169 +2670,169 @@
<section id="sec:pkgopts-printglos"><!-- start of section sec:pkgopts-printglos --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.3. Glossary Appearance Options<div class="labellink"><a href="#sec:pkgopts-printglos">[link]</a></div></h2><!-- end of section header -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2590"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2591"></a><code class="code"><dfn id="glo:opt.savenumberlist"><span class="styoptfmt">savenumberlist</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span><p>
-<div class="noteBox">Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> only</div><!-- end of noteBox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2353"></a><code class="code"><dfn id="glo:opt.savenumberlist"><span class="styoptfmt">savenumberlist</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span><p>
+<div class="noteBox">Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> only</div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
- This is a boolean option that specifies whether or not to gather and store the <a id="wrglossary.2592"></a><a href="#glo:locationlist">number list</a> for each entry. The default is <a id="wrglossary.2593"></a><a href="#glo:opt.savenumberlist"><span class="styoptfmt">savenumberlist</span></a><span class="optfmt">=false</span> with Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>. (See <a id="wrglossary.2594"></a><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a> and <a id="wrglossary.2595"></a><a href="#glo:glsdisplaynumberlist"><code class="csfmt">\glsdisplaynumberlist</code></a> in §<a href="#sec:glsnolink">5.2</a>.) This setting is always true if you use <a id="wrglossary.2596"></a><a href="#glo:idx.opt.noidx">Option 1</a> as a by-product of the way that <a id="wrglossary.2597"></a><a href="#glo:dual.indexing">indexing</a> method works.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2598"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
- If you use the <a id="wrglossary.2599"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option (with either no value or <a id="wrglossary.2600"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> or <a id="wrglossary.2601"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>) then this package option has no effect. With <a id="wrglossary.2602"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.2603"></a><a href="#glo:locationlist">number lists</a> are automatically saved with the default <a id="wrglossary.2604"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span> and <a id="wrglossary.2605"></a><a href="#glo:opt.resource.save-loclist"><span class="xtrcsoptfmt">save-loclist</span></a><span class="optfmt">=true</span> resource settings. </div><!-- end of information -->
+ This is a boolean option that specifies whether or not to gather and store the <a id="wrglossary.2354"></a><a href="#glo:locationlist">number list</a> for each entry. The default is <a id="wrglossary.2355"></a><a href="#glo:opt.savenumberlist"><span class="styoptfmt">savenumberlist</span></a><span class="optfmt">=false</span> with Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>. (See <a id="wrglossary.2356"></a><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a> and <a id="wrglossary.2357"></a><a href="#glo:glsdisplaynumberlist"><code class="csfmt">\glsdisplaynumberlist</code></a> in §<a href="#sec:glsnolink">5.2</a>.) This setting is always true if you use <a id="wrglossary.2358"></a><a href="#glo:idx.opt.noidx">Option 1</a> as a by-product of the way that <a id="wrglossary.2359"></a><a href="#glo:dual.indexing">indexing</a> method works.<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2360"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+ If you use the <a id="wrglossary.2361"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option (with either no value or <a id="wrglossary.2362"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> or <a id="wrglossary.2363"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>) then this package option has no effect. With <a id="wrglossary.2364"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.2365"></a><a href="#glo:locationlist">number lists</a> are automatically saved with the default <a id="wrglossary.2366"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span> and <a id="wrglossary.2367"></a><a href="#glo:opt.resource.save-loclist"><span class="xtrcsoptfmt">save-loclist</span></a><span class="optfmt">=true</span> resource settings. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2606"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2607"></a><code class="code"><dfn id="glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If set, this will create the counter: <div class="ctrbox"><div class="ctrboxtitle"><a id="wrglossary.2608"></a><a href="#glo:sym.counter"><span title="Counter" class="icon">№</span></a></div><!-- end of ctrboxtitle -->
-<a id="wrglossary.2609"></a><code class="code"><dfn id="glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></dfn></code></div><!-- end of ctrbox -->
- Each <a id="wrglossary.2610"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entry will increment and display that counter at the start of the <a id="wrglossary.2611"></a><a href="#glo:dual.entryline">entry line</a> when using <a id="wrglossary.2612"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that support this setting. Note that if you also use <a id="wrglossary.2613"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> the option order makes a difference. If <a id="wrglossary.2614"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> is specified first, the sub-entry counter will be dependent on the <a id="wrglossary.2615"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter.<p>
-If you use this option (and are using a <a id="wrglossary.2616"></a><a href="#glo:idx.glossarystyle">glossary style</a> that supports this option) then you can reference the <a id="wrglossary.2617"></a><a href="#glo:idx.glossaryentry">entry</a> number within the document using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2618"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2619"></a><code class="code"><dfn id="glo:glsrefentry"><code class="csfmt">\glsrefentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">label</em>〉</span> is the label associated with that glossary entry. This will use <a id="wrglossary.2620"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a> if either <a id="wrglossary.2621"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> or <a id="wrglossary.2622"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span>, with the label <span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">label</em>〉</span>, where <span class="meta">〈<em class="metainner">label</em>〉</span> is the entry’s label and <span class="meta">〈<em class="metainner">prefix</em>〉</span> is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2623"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2624"></a><code class="code"><dfn id="glo:GlsEntryCounterLabelPrefix"><code class="csfmt">\GlsEntryCounterLabelPrefix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsentry-</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- If both <a id="wrglossary.2625"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span> and <a id="wrglossary.2626"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>, <code class="code"><a id="wrglossary.2627"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> will be used instead.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.2628"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-If you use <a id="wrglossary.2629"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, you must run LaTeX twice after creating the <a id="wrglossary.2630"></a><a href="#glo:dual.indexingfile">indexing files</a> using <a id="wrglossary.2631"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.2632"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2633"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (or after creating the <a id="wrglossary.2634"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file with <a id="wrglossary.2635"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) to ensure the cross-references are up-to-date. This is because the counter can’t be incremented and labelled until the <a id="wrglossary.2636"></a><a href="#glo:dual.glossary">glossary</a> is typeset. </div><!-- end of important -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2368"></a><code class="code"><dfn id="glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If set, this will create the counter: <div class="ctrbox"><div class="ctrboxtitle"><a href="#glo:sym.counter"><span title="Counter" class="icon">№</span></a></div><!-- end of ctrboxtitle -->
+<a id="wrglossary.2369"></a><code class="code"><dfn id="glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></dfn></code></div><!-- end of ctrbox -->
+ Each <a id="wrglossary.2370"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entry will increment and display that counter at the start of the <a id="wrglossary.2371"></a><a href="#glo:dual.entryline">entry line</a> when using <a id="wrglossary.2372"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that support this setting. Note that if you also use <a id="wrglossary.2373"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> the option order makes a difference. If <a id="wrglossary.2374"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> is specified first, the sub-entry counter will be dependent on the <a id="wrglossary.2375"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter.<p>
+If you use this option (and are using a <a id="wrglossary.2376"></a><a href="#glo:idx.glossarystyle">glossary style</a> that supports this option) then you can reference the <a id="wrglossary.2377"></a><a href="#glo:idx.glossaryentry">entry</a> number within the document using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2378"></a><code class="code"><dfn id="glo:glsrefentry"><code class="csfmt">\glsrefentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">label</em>〉</span> is the label associated with that glossary entry. This will use <a id="wrglossary.2379"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a> if either <a id="wrglossary.2380"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> or <a id="wrglossary.2381"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span>, with the label <span class="meta">〈<em class="metainner">prefix</em>〉</span><span class="meta">〈<em class="metainner">label</em>〉</span>, where <span class="meta">〈<em class="metainner">label</em>〉</span> is the entry’s label and <span class="meta">〈<em class="metainner">prefix</em>〉</span> is given by: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2382"></a><code class="code"><dfn id="glo:GlsEntryCounterLabelPrefix"><code class="csfmt">\GlsEntryCounterLabelPrefix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>glsentry-</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ If both <a id="wrglossary.2383"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span> and <a id="wrglossary.2384"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>, <code class="code"><a id="wrglossary.2385"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> will be used instead.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+If you use <a id="wrglossary.2386"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, you must run LaTeX twice after creating the <a id="wrglossary.2387"></a><a href="#glo:dual.indexingfile">indexing files</a> using <a id="wrglossary.2388"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.2389"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2390"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (or after creating the <a id="wrglossary.2391"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file with <a id="wrglossary.2392"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) to ensure the cross-references are up-to-date. This is because the counter can’t be incremented and labelled until the <a id="wrglossary.2393"></a><a href="#glo:dual.glossary">glossary</a> is typeset. </div><!-- end of important -->
<p>
-The <a id="wrglossary.2637"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be reset back to zero with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2638"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2639"></a><code class="code"><dfn id="glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
- This does nothing if <a id="wrglossary.2640"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>. The <a id="wrglossary.2641"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be simultaneously incremented and labelled (using <a id="wrglossary.2642"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2643"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2644"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2645"></a><code class="code"><dfn id="glo:glsstepentry"><code class="csfmt">\glsstepentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code></div><!-- end of pinnedbox -->
- This command is within the definition of <a id="wrglossary.2646"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>, which is typically used in <a id="wrglossary.2647"></a><a href="#glo:idx.glossarystyle">glossary styles</a> at the start of <a id="wrglossary.2648"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries. The argument is the entry label.<p>
-The value of the <a id="wrglossary.2649"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2650"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2651"></a><code class="code"><dfn id="glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></dfn></code><p>
+The <a id="wrglossary.2394"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be reset back to zero with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2395"></a><code class="code"><dfn id="glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
+ This does nothing if <a id="wrglossary.2396"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>. The <a id="wrglossary.2397"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be simultaneously incremented and labelled (using <a id="wrglossary.2398"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2399"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2400"></a><code class="code"><dfn id="glo:glsstepentry"><code class="csfmt">\glsstepentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is within the definition of <a id="wrglossary.2401"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>, which is typically used in <a id="wrglossary.2402"></a><a href="#glo:idx.glossarystyle">glossary styles</a> at the start of <a id="wrglossary.2403"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries. The argument is the entry label.<p>
+The value of the <a id="wrglossary.2404"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2405"></a><code class="code"><dfn id="glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></dfn></code><p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
- This command is defined when the <a id="wrglossary.2652"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter is defined, so won’t be available otherwise. The formatted value is more usually displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2653"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2654"></a><code class="code"><dfn id="glo:glsentrycounterlabel"><code class="csfmt">\glsentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
- This will do <code class="code"><a id="wrglossary.2655"></a><a href="#glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></a>.<a id="wrglossary.2656"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if <a id="wrglossary.2657"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span>, otherwise does nothing. This is therefore more generally useful in <a id="wrglossary.2658"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as it will silently do nothing if the setting isn’t on. This command is used within the definition of <a id="wrglossary.2659"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>.<p>
-If you want to test whether or not this option is currently enabled, use the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2660"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2661"></a><code class="code"><dfn id="glo:ifglsentrycounter"><code class="csfmt">\ifglsentrycounter</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- You can later switch it off using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2662"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2663"></a><code class="code"><dfn id="glo:glsentrycounterfalse"><code class="csfmt">\glsentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
- and switch it back on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2664"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2665"></a><code class="code"><dfn id="glo:glsentrycountertrue"><code class="csfmt">\glsentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
- but note that this won’t define <a id="wrglossary.2666"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> if <a id="wrglossary.2667"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> wasn’t used initially. You can also locally enable or disable this option for a specific <a id="wrglossary.2668"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2669"></a><a href="#glo:opt.printgloss.entrycounter"><span class="csoptfmt">entrycounter</span></a> <a id="wrglossary.2670"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2671"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2672"></a><code class="code"><dfn id="glo:opt.counterwithin"><span class="styoptfmt">counterwithin</span></dfn>=<span class="meta">〈<em class="metainner">parent-counter</em>〉</span></code></div><!-- end of settingsbox -->
- If used, this option will automatically set <a id="wrglossary.2673"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>true and the <a id="wrglossary.2674"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter will be reset every time <span class="meta">〈<em class="metainner">parent-counter</em>〉</span> is incremented. An empty value indicates that <a id="wrglossary.2675"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> has no parent counter (but <a id="wrglossary.2676"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> will still be defined).<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.2677"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-The <a id="wrglossary.2678"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter isn’t automatically reset at the start of each glossary, except when glossary section numbering is on and the counter used by <a id="wrglossary.2679"></a><a href="#glo:opt.counterwithin"><span class="styoptfmt">counterwithin</span></a> is the same as the counter used in the glossary’s sectioning command. </div><!-- end of important -->
+ This command is defined when the <a id="wrglossary.2406"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter is defined, so won’t be available otherwise. The formatted value is more usually displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2407"></a><code class="code"><dfn id="glo:glsentrycounterlabel"><code class="csfmt">\glsentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
+ This will do <code class="code"><a id="wrglossary.2408"></a><a href="#glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></a>.<a id="wrglossary.2409"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if <a id="wrglossary.2410"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span>, otherwise does nothing. This is therefore more generally useful in <a id="wrglossary.2411"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as it will silently do nothing if the setting isn’t on. This command is used within the definition of <a id="wrglossary.2412"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>.<p>
+If you want to test whether or not this option is currently enabled, use the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2413"></a><code class="code"><dfn id="glo:ifglsentrycounter"><code class="csfmt">\ifglsentrycounter</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ You can later switch it off using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2414"></a><code class="code"><dfn id="glo:glsentrycounterfalse"><code class="csfmt">\glsentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
+ and switch it back on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2415"></a><code class="code"><dfn id="glo:glsentrycountertrue"><code class="csfmt">\glsentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
+ but note that this won’t define <a id="wrglossary.2416"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> if <a id="wrglossary.2417"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> wasn’t used initially. You can also locally enable or disable this option for a specific <a id="wrglossary.2418"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2419"></a><a href="#glo:opt.printgloss.entrycounter"><span class="csoptfmt">entrycounter</span></a> <a id="wrglossary.2420"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2421"></a><code class="code"><dfn id="glo:opt.counterwithin"><span class="styoptfmt">counterwithin</span></dfn>=<span class="meta">〈<em class="metainner">parent-counter</em>〉</span></code></div><!-- end of settingsbox -->
+ If used, this option will automatically set <a id="wrglossary.2422"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>true and the <a id="wrglossary.2423"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter will be reset every time <span class="meta">〈<em class="metainner">parent-counter</em>〉</span> is incremented. An empty value indicates that <a id="wrglossary.2424"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> has no parent counter (but <a id="wrglossary.2425"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> will still be defined).<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <a id="wrglossary.2426"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter isn’t automatically reset at the start of each glossary, except when glossary section numbering is on and the counter used by <a id="wrglossary.2427"></a><a href="#glo:opt.counterwithin"><span class="styoptfmt">counterwithin</span></a> is the same as the counter used in the glossary’s sectioning command. </div><!-- end of important -->
<p>
-If you want the counter reset at the start of each <a id="wrglossary.2680"></a><a href="#glo:dual.glossary">glossary</a>, you can modify the <a id="wrglossary.2681"></a><a href="#glo:idx.glossarypreamble">glossary preamble</a>(<a id="wrglossary.2682"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>) to use <a id="wrglossary.2683"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2684"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.2685"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>}{<span class="comment">% </span>
- <a id="wrglossary.2686"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
+If you want the counter reset at the start of each <a id="wrglossary.2428"></a><a href="#glo:dual.glossary">glossary</a>, you can modify the <a id="wrglossary.2429"></a><a href="#glo:idx.glossarypreamble">glossary preamble</a> (<a id="wrglossary.2430"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>) to use <a id="wrglossary.2431"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.2432"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.2433"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
}
-</pre> or if you are using <a id="wrglossary.2687"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>, add it to each <a id="wrglossary.2688"></a><a href="#glo:idx.glossarypreamble">glossary preamble</a>, as required. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2689"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2690"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>[<a id="wrglossary.2691"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>]{<span class="comment">% </span>
- <a id="wrglossary.2692"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
+</pre> or if you are using <a id="wrglossary.2434"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>, add it to each <a id="wrglossary.2435"></a><a href="#glo:idx.glossarypreamble">glossary preamble</a>, as required. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2436"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>[<a id="wrglossary.2437"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>]{<span class="comment">% </span>
+ <a id="wrglossary.2438"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
The preamble text here for the list of acronyms.
}
-<a id="wrglossary.2693"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>{<span class="comment">% </span>
- <a id="wrglossary.2694"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
- The preamble text here for the <a id="wrglossary.2695"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
+<a id="wrglossary.2439"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>{<span class="comment">% </span>
+ <a id="wrglossary.2440"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
+ The preamble text here for the <a id="wrglossary.2441"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
}
</pre><p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2696"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2697"></a><code class="code"><dfn id="glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If set, each <a id="wrglossary.2698"></a><a href="#glo:hierarchicallevel">level 1</a> glossary <a id="wrglossary.2699"></a><a href="#glo:idx.glossaryentry">entry</a> will be numbered at the start of its <a id="wrglossary.2700"></a><a href="#glo:dual.entryline">entry line</a> when using <a id="wrglossary.2701"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that support this option. This option creates the counter <div class="ctrbox"><div class="ctrboxtitle"><a id="wrglossary.2702"></a><a href="#glo:sym.counter"><span title="Counter" class="icon">№</span></a></div><!-- end of ctrboxtitle -->
-<a id="wrglossary.2703"></a><code class="code"><dfn id="glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></dfn></code></div><!-- end of ctrbox -->
- If the <a id="wrglossary.2704"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option is used before <a id="wrglossary.2705"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a>, then <a id="wrglossary.2706"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> will be added to the reset list for <a id="wrglossary.2707"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a>. If <a id="wrglossary.2708"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is used without <a id="wrglossary.2709"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the <a id="wrglossary.2710"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter will be reset by <a id="wrglossary.2711"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>. If <a id="wrglossary.2712"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is used before <a id="wrglossary.2713"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the two counters are independent.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2714"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-There’s no support for deeper <a id="wrglossary.2715"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a>. Some styles, such as those that don’t support any hierarchy, may not support this setting or, for those that only support level 0 and level 1, may use this setting for all child entries. </div><!-- end of information -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2442"></a><code class="code"><dfn id="glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If set, each <a id="wrglossary.2443"></a><a href="#glo:hierarchicallevel">level 1</a> glossary <a id="wrglossary.2444"></a><a href="#glo:idx.glossaryentry">entry</a> will be numbered at the start of its <a id="wrglossary.2445"></a><a href="#glo:dual.entryline">entry line</a> when using <a id="wrglossary.2446"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that support this option. This option creates the counter <div class="ctrbox"><div class="ctrboxtitle"><a href="#glo:sym.counter"><span title="Counter" class="icon">№</span></a></div><!-- end of ctrboxtitle -->
+<a id="wrglossary.2447"></a><code class="code"><dfn id="glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></dfn></code></div><!-- end of ctrbox -->
+ If the <a id="wrglossary.2448"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option is used before <a id="wrglossary.2449"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a>, then <a id="wrglossary.2450"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> will be added to the reset list for <a id="wrglossary.2451"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a>. If <a id="wrglossary.2452"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is used without <a id="wrglossary.2453"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the <a id="wrglossary.2454"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter will be reset by <a id="wrglossary.2455"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>. If <a id="wrglossary.2456"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is used before <a id="wrglossary.2457"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the two counters are independent.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+There’s no support for deeper <a id="wrglossary.2458"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a>. Some styles, such as those that don’t support any hierarchy, may not support this setting or, for those that only support level 0 and level 1, may use this setting for all child entries. </div><!-- end of information -->
<p>
-As with the <a id="wrglossary.2716"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option, you can reference the number within the document using <a id="wrglossary.2717"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>. There are analogous commands to those for <a id="wrglossary.2718"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>.<p>
-The <a id="wrglossary.2719"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be reset back to zero with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2720"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2721"></a><code class="code"><dfn id="glo:glsresetsubentrycounter"><code class="csfmt">\glsresetsubentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
- This does nothing if <a id="wrglossary.2722"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>. This command is used within the definition of <a id="wrglossary.2723"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> if <a id="wrglossary.2724"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.<p>
-The <a id="wrglossary.2725"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be simultaneously incremented and labelled (using <a id="wrglossary.2726"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2727"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2728"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2729"></a><code class="code"><dfn id="glo:glsstepsubentry"><code class="csfmt">\glsstepsubentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code></div><!-- end of pinnedbox -->
- This command is used in <a id="wrglossary.2730"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a> if <a id="wrglossary.2731"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span>, otherwise it does nothing. The argument is the entry label and is passed to <a id="wrglossary.2732"></a><a href="#glo:label"><code class="csfmt">\label</code></a> is as for <a id="wrglossary.2733"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>.<p>
-The value of the <a id="wrglossary.2734"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2735"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2736"></a><code class="code"><dfn id="glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></dfn></code><p>
+As with the <a id="wrglossary.2459"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option, you can reference the number within the document using <a id="wrglossary.2460"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>. There are analogous commands to those for <a id="wrglossary.2461"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>.<p>
+The <a id="wrglossary.2462"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be reset back to zero with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2463"></a><code class="code"><dfn id="glo:glsresetsubentrycounter"><code class="csfmt">\glsresetsubentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
+ This does nothing if <a id="wrglossary.2464"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>. This command is used within the definition of <a id="wrglossary.2465"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> if <a id="wrglossary.2466"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.<p>
+The <a id="wrglossary.2467"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be simultaneously incremented and labelled (using <a id="wrglossary.2468"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2469"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2470"></a><code class="code"><dfn id="glo:glsstepsubentry"><code class="csfmt">\glsstepsubentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This command is used in <a id="wrglossary.2471"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a> if <a id="wrglossary.2472"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span>, otherwise it does nothing. The argument is the entry label and is passed to <a id="wrglossary.2473"></a><a href="#glo:label"><code class="csfmt">\label</code></a> is as for <a id="wrglossary.2474"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>.<p>
+The value of the <a id="wrglossary.2475"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2476"></a><code class="code"><dfn id="glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></dfn></code><p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
- This command is defined when the <a id="wrglossary.2737"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter is defined, so won’t be available otherwise. The formatted value is more usually displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2738"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2739"></a><code class="code"><dfn id="glo:glssubentrycounterlabel"><code class="csfmt">\glssubentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
- This will do <code class="code"><a id="wrglossary.2740"></a><a href="#glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></a>)<a id="wrglossary.2741"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if <a id="wrglossary.2742"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span>, otherwise does nothing. This is therefore more generally useful in <a id="wrglossary.2743"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as it will silently do nothing if the setting isn’t on. This command is used in <a id="wrglossary.2744"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>.<p>
-If you want to test whether or not this option is currently enabled, use the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2745"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2746"></a><code class="code"><dfn id="glo:ifglssubentrycounter"><code class="csfmt">\ifglssubentrycounter</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- You can later switch it off using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2747"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2748"></a><code class="code"><dfn id="glo:glssubentrycounterfalse"><code class="csfmt">\glssubentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
- and switch it back on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2749"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2750"></a><code class="code"><dfn id="glo:glssubentrycountertrue"><code class="csfmt">\glssubentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
- but note that this won’t define <a id="wrglossary.2751"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> if <a id="wrglossary.2752"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span> wasn’t used initially. You can also locally enable or disable this option for a specific <a id="wrglossary.2753"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2754"></a><a href="#glo:opt.printgloss.subentrycounter"><span class="csoptfmt">subentrycounter</span></a> <a id="wrglossary.2755"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2756"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2757"></a><code class="code"><dfn id="glo:opt.style"><span class="styoptfmt">style</span></dfn>=<span class="meta">〈<em class="metainner">style-name</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
- This option sets the default <a id="wrglossary.2758"></a><a href="#glo:idx.glossarystyle">glossary style</a> to <span class="meta">〈<em class="metainner">style-name</em>〉</span>. This is initialised to <a id="wrglossary.2759"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2760"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a></span> unless <a id="wrglossary.2761"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded, in which case the default is <a id="wrglossary.2762"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2763"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a></span>. (The styles that use the <a id="wrglossary.2764"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment, such as the <a id="wrglossary.2765"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style, are incompatible with <a id="wrglossary.2766"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a>.)<p>
-This setting may only be used for styles that are defined when the <a id="wrglossary.2767"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is loaded. This will usually be the styles in the packages <a id="wrglossary.2768"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>, <a id="wrglossary.2769"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>, <a id="wrglossary.2770"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> or <a id="wrglossary.2771"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>, unless they have been suppressed through options such as <a id="wrglossary.2772"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>. Style packages can also be loaded by the <a id="wrglossary.2773"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> option provided by <a id="wrglossary.2774"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
-Alternatively, you can set the style later using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2775"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2776"></a><code class="code"><dfn id="glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
- or use the <a id="wrglossary.2777"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2778"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>. (See §<a href="#sec:styles">13</a> for further details.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2779"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2780"></a><code class="code"><dfn id="glo:opt.nolong"><span class="styoptfmt">nolong</span></dfn></code></div><!-- end of settingsbox -->
- This prevents the <a id="wrglossary.2781"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2782"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> (which means that the <a id="wrglossary.2783"></a><a href="#glo:pkg.longtable"><span class="styfmt">longtable</span></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 <a id="wrglossary.2784"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2785"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> package (unless you explicitly load <a id="wrglossary.2786"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>).<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2787"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-Some style packages implicitly load <a id="wrglossary.2788"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>, so this package may still end up being loaded even if you use <a id="wrglossary.2789"></a><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a>. </div><!-- end of information -->
+ This command is defined when the <a id="wrglossary.2477"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter is defined, so won’t be available otherwise. The formatted value is more usually displayed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2478"></a><code class="code"><dfn id="glo:glssubentrycounterlabel"><code class="csfmt">\glssubentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
+ This will do <code class="code"><a id="wrglossary.2479"></a><a href="#glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></a>)<a id="wrglossary.2480"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if <a id="wrglossary.2481"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span>, otherwise does nothing. This is therefore more generally useful in <a id="wrglossary.2482"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as it will silently do nothing if the setting isn’t on. This command is used in <a id="wrglossary.2483"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>.<p>
+If you want to test whether or not this option is currently enabled, use the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2484"></a><code class="code"><dfn id="glo:ifglssubentrycounter"><code class="csfmt">\ifglssubentrycounter</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ You can later switch it off using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2485"></a><code class="code"><dfn id="glo:glssubentrycounterfalse"><code class="csfmt">\glssubentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
+ and switch it back on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2486"></a><code class="code"><dfn id="glo:glssubentrycountertrue"><code class="csfmt">\glssubentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
+ but note that this won’t define <a id="wrglossary.2487"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> if <a id="wrglossary.2488"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span> wasn’t used initially. You can also locally enable or disable this option for a specific <a id="wrglossary.2489"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2490"></a><a href="#glo:opt.printgloss.subentrycounter"><span class="csoptfmt">subentrycounter</span></a> <a id="wrglossary.2491"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2492"></a><code class="code"><dfn id="glo:opt.style"><span class="styoptfmt">style</span></dfn>=<span class="meta">〈<em class="metainner">style-name</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option sets the default <a id="wrglossary.2493"></a><a href="#glo:idx.glossarystyle">glossary style</a> to <span class="meta">〈<em class="metainner">style-name</em>〉</span>. This is initialised to <a id="wrglossary.2494"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2495"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a></span> unless <a id="wrglossary.2496"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded, in which case the default is <a id="wrglossary.2497"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2498"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a></span>. (The styles that use the <a id="wrglossary.2499"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment, such as the <a id="wrglossary.2500"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style, are incompatible with <a id="wrglossary.2501"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a>.)<p>
+This setting may only be used for styles that are defined when the <a id="wrglossary.2502"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package is loaded. This will usually be the styles in the packages <a id="wrglossary.2503"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>, <a id="wrglossary.2504"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>, <a id="wrglossary.2505"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> or <a id="wrglossary.2506"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>, unless they have been suppressed through options such as <a id="wrglossary.2507"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>. Style packages can also be loaded by the <a id="wrglossary.2508"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> option provided by <a id="wrglossary.2509"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+Alternatively, you can set the style later using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2510"></a><code class="code"><dfn id="glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></dfn>{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ or use the <a id="wrglossary.2511"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2512"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>. (See §<a href="#sec:styles">13</a> for further details.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2513"></a><code class="code"><dfn id="glo:opt.nolong"><span class="styoptfmt">nolong</span></dfn></code></div><!-- end of settingsbox -->
+ This prevents the <a id="wrglossary.2514"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2515"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> (which means that the <a id="wrglossary.2516"></a><a href="#glo:pkg.longtable"><span class="styfmt">longtable</span></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 <a id="wrglossary.2517"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2518"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> package (unless you explicitly load <a id="wrglossary.2519"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>).<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Some style packages implicitly load <a id="wrglossary.2520"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>, so this package may still end up being loaded even if you use <a id="wrglossary.2521"></a><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a>. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2790"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2791"></a><code class="code"><dfn id="glo:opt.nosuper"><span class="styoptfmt">nosuper</span></dfn></code></div><!-- end of settingsbox -->
- This prevents the <a id="wrglossary.2792"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2793"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> (which means that the <a id="wrglossary.2794"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></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 <a id="wrglossary.2795"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2796"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> package (unless you explicitly load <a id="wrglossary.2797"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a>).<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2798"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-This option is automatically implemented if <a id="wrglossary.2799"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> has been loaded as it’s incompatible with <a id="wrglossary.2800"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a>. This option is also automatically implemented if <a id="wrglossary.2801"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a> isn’t installed. </div><!-- end of information -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2522"></a><code class="code"><dfn id="glo:opt.nosuper"><span class="styoptfmt">nosuper</span></dfn></code></div><!-- end of settingsbox -->
+ This prevents the <a id="wrglossary.2523"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2524"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> (which means that the <a id="wrglossary.2525"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></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 <a id="wrglossary.2526"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2527"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> package (unless you explicitly load <a id="wrglossary.2528"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a>).<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option is automatically implemented if <a id="wrglossary.2529"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> has been loaded as it’s incompatible with <a id="wrglossary.2530"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a>. This option is also automatically implemented if <a id="wrglossary.2531"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a> isn’t installed. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2802"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2803"></a><code class="code"><dfn id="glo:opt.nolist"><span class="styoptfmt">nolist</span></dfn></code></div><!-- end of settingsbox -->
- This prevents the <a id="wrglossary.2804"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2805"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></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 <a id="wrglossary.2806"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2807"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a> package (unless you explicitly load <a id="wrglossary.2808"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>). Note that since the default style is <a id="wrglossary.2809"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> (unless <a id="wrglossary.2810"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded), you will also need to use the <a id="wrglossary.2811"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> option to set the style to something else.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2812"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2813"></a><code class="code"><dfn id="glo:opt.notree"><span class="styoptfmt">notree</span></dfn></code></div><!-- end of settingsbox -->
- This prevents the <a id="wrglossary.2814"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2815"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></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 <a id="wrglossary.2816"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2817"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package (unless you explicitly load <a id="wrglossary.2818"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>). Note that if <a id="wrglossary.2819"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded, the default style is <a id="wrglossary.2820"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a>, which is provided by <a id="wrglossary.2821"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2822"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-Some style packages implicitly load <a id="wrglossary.2823"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>, so this package may still end up being loaded even if you use <a id="wrglossary.2824"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a>. </div><!-- end of information -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2532"></a><code class="code"><dfn id="glo:opt.nolist"><span class="styoptfmt">nolist</span></dfn></code></div><!-- end of settingsbox -->
+ This prevents the <a id="wrglossary.2533"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2534"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></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 <a id="wrglossary.2535"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2536"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a> package (unless you explicitly load <a id="wrglossary.2537"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>). Note that since the default style is <a id="wrglossary.2538"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> (unless <a id="wrglossary.2539"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded), you will also need to use the <a id="wrglossary.2540"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> option to set the style to something else.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2541"></a><code class="code"><dfn id="glo:opt.notree"><span class="styoptfmt">notree</span></dfn></code></div><!-- end of settingsbox -->
+ This prevents the <a id="wrglossary.2542"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package from automatically loading <a id="wrglossary.2543"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></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 <a id="wrglossary.2544"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2545"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package (unless you explicitly load <a id="wrglossary.2546"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>). Note that if <a id="wrglossary.2547"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded, the default style is <a id="wrglossary.2548"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a>, which is provided by <a id="wrglossary.2549"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+Some style packages implicitly load <a id="wrglossary.2550"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>, so this package may still end up being loaded even if you use <a id="wrglossary.2551"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a>. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2825"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2826"></a><code class="code"><dfn id="glo:opt.nostyles"><span class="styoptfmt">nostyles</span></dfn></code></div><!-- end of settingsbox -->
- This prevents all the predefined styles from being loaded. If you use this option, you need to load a <a id="wrglossary.2827"></a><a href="#glo:idx.glossarystyle">glossary style</a> package (such as <a id="wrglossary.2828"></a><a href="#glo:pkg.glossary-mcols"><span class="styfmt">glossary-mcols</span></a>). Also if you use this option, you can’t use the <a id="wrglossary.2829"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> package option (unless you use <a id="wrglossary.2830"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> with <a id="wrglossary.2831"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). Instead you must either use <a id="wrglossary.2832"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> or the <a id="wrglossary.2833"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2834"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>. Example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2835"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2836"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>]{glossaries}
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2552"></a><code class="code"><dfn id="glo:opt.nostyles"><span class="styoptfmt">nostyles</span></dfn></code></div><!-- end of settingsbox -->
+ This prevents all the predefined styles from being loaded. If you use this option, you need to load a <a id="wrglossary.2553"></a><a href="#glo:idx.glossarystyle">glossary style</a> package (such as <a id="wrglossary.2554"></a><a href="#glo:pkg.glossary-mcols"><span class="styfmt">glossary-mcols</span></a>). Also if you use this option, you can’t use the <a id="wrglossary.2555"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> package option (unless you use <a id="wrglossary.2556"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> with <a id="wrglossary.2557"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). Instead you must either use <a id="wrglossary.2558"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> or the <a id="wrglossary.2559"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2560"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>. Example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2561"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>]{glossaries}
<code class="cmd">\usepackage</code>{glossary-mcols}
-<a id="wrglossary.2837"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{<a id="wrglossary.2838"></a><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a>}
-</pre> Alternatively: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.2839"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2840"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.2841"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=mcols</span>,<a id="wrglossary.2842"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2843"></a><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a></span>]{glossaries-extra}
+<a id="wrglossary.2562"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{<a id="wrglossary.2563"></a><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a>}
+</pre> Alternatively: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.2564"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.2565"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=mcols</span>,<a id="wrglossary.2566"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2567"></a><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a></span>]{glossaries-extra}
</pre><p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2844"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2845"></a><code class="code"><dfn id="glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></dfn></code></div><!-- end of settingsbox -->
- This option will suppress the associated <a id="wrglossary.2846"></a><a href="#glo:locationlist">number lists</a> in the <a id="wrglossary.2847"></a><a href="#glo:dual.glossary">glossaries</a> (see also §<a href="#sec:numberlists">12</a>). This option can also be locally switched on or off for a specific <a id="wrglossary.2848"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2849"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a> <a id="wrglossary.2850"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> options</a>.<p>
-<div class="warning"><div class="warningtitle"><a id="wrglossary.2851"></a><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
-Note that if you use Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a> (<a id="wrglossary.2852"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2853"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) then the <a id="wrglossary.2854"></a><a href="#glo:@@glslabel at entrylocation">locations</a> must still be valid even if this setting is on. This package option merely prevents the <a id="wrglossary.2855"></a><a href="#glo:locationlist">number list</a> from being displayed, but both <a id="wrglossary.2856"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2857"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> still require a <a id="wrglossary.2858"></a><a href="#glo:@@glslabel at entrylocation">location</a> or cross-reference for each term that’s <a id="wrglossary.2859"></a><a href="#glo:@@glslabel at indexing">indexed</a>. </div><!-- end of warning -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2568"></a><code class="code"><dfn id="glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></dfn></code></div><!-- end of settingsbox -->
+ This option will suppress the associated <a id="wrglossary.2569"></a><a href="#glo:locationlist">number lists</a> in the <a id="wrglossary.2570"></a><a href="#glo:dual.glossary">glossaries</a> (see also §<a href="#sec:numberlists">12</a>). This option can also be locally switched on or off for a specific <a id="wrglossary.2571"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2572"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a> <a id="wrglossary.2573"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> options</a>.<p>
+<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
+Note that if you use Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a> (<a id="wrglossary.2574"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2575"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) then the <a id="wrglossary.2576"></a><a href="#glo:@@glslabel at entrylocation">locations</a> must still be valid even if this setting is on. This package option merely prevents the <a id="wrglossary.2577"></a><a href="#glo:locationlist">number list</a> from being displayed, but both <a id="wrglossary.2578"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2579"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> still require a <a id="wrglossary.2580"></a><a href="#glo:@@glslabel at entrylocation">location</a> or cross-reference for each term that’s <a id="wrglossary.2581"></a><a href="#glo:@@glslabel at indexing">indexed</a>. </div><!-- end of warning -->
<p>
-Remember that <a id="wrglossary.2860"></a><a href="#glo:locationlist">number list</a> includes any cross-references, so suppressing the <a id="wrglossary.2861"></a><a href="#glo:locationlist">number list</a> will also hide the cross-references (in which case, you may want to use <a id="wrglossary.2862"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>).<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2863"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
- With <a id="wrglossary.2864"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s more efficient to use <a id="wrglossary.2865"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span> in the resource options if no <a id="wrglossary.2866"></a><a href="#glo:@@glslabel at entrylocation">locations</a> are required. </div><!-- end of information -->
+Remember that <a id="wrglossary.2582"></a><a href="#glo:locationlist">number list</a> includes any cross-references, so suppressing the <a id="wrglossary.2583"></a><a href="#glo:locationlist">number list</a> will also hide the cross-references (in which case, you may want to use <a id="wrglossary.2584"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>).<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2585"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+ With <a id="wrglossary.2586"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s more efficient to use <a id="wrglossary.2587"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span> in the resource options if no <a id="wrglossary.2588"></a><a href="#glo:@@glslabel at entrylocation">locations</a> are required. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2867"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2868"></a><code class="code"><dfn id="glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></dfn></code></div><!-- end of settingsbox -->
- If you suppress the <a id="wrglossary.2869"></a><a href="#glo:locationlist">number lists</a> with <a id="wrglossary.2870"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a>, described above, this will also suppress any cross-referencing information supplied by the <a id="wrglossary.2871"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key in <a id="wrglossary.2872"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> or <a id="wrglossary.2873"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. If you use <a id="wrglossary.2874"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>, the <a id="wrglossary.2875"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key will automatically implement <a id="wrglossary.2876"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a><span class="optfmt">=false</span> for that entry. (Note this doesn’t affect <a id="wrglossary.2877"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>.) For further details see §<a href="#sec:crossref">11</a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2878"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2879"></a><code class="code"><dfn id="glo:opt.counter"><span class="styoptfmt">counter</span></dfn>=<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>page</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- This setting indicates that <span class="meta">〈<em class="metainner">counter-name</em>〉</span> should be the default counter to use in the <a id="wrglossary.2880"></a><a href="#glo:locationlist">number lists</a> (see §<a href="#sec:numberlists">12</a>). This option can be overridden for a specific <a id="wrglossary.2881"></a><a href="#glo:dual.glossary">glossary</a> by the <span class="meta">〈<em class="metainner">counter</em>〉</span> optional argument of <a id="wrglossary.2882"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> or the <a id="wrglossary.2883"></a><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a> key when defining an entry or by the <a id="wrglossary.2884"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> option when referencing an entry.<p>
-This option will redefine: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2885"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2886"></a><code class="code"><dfn id="glo:glscounter"><code class="csfmt">\glscounter</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>page</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- to <span class="meta">〈<em class="metainner">counter-name</em>〉</span>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2887"></a><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2888"></a><code class="code"><dfn id="glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If true, this option suppresses the default terminating <a id="wrglossary.2889"></a><a href="#glo:idx.fullstop">full stop</a> in <a id="wrglossary.2890"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the post-description hook: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2891"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2892"></a><code class="code"><dfn id="glo:glspostdescription"><code class="csfmt">\glspostdescription</code></dfn></code></div><!-- end of pinnedbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2589"></a><code class="code"><dfn id="glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></dfn></code></div><!-- end of settingsbox -->
+ If you suppress the <a id="wrglossary.2590"></a><a href="#glo:locationlist">number lists</a> with <a id="wrglossary.2591"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a>, described above, this will also suppress any cross-referencing information supplied by the <a id="wrglossary.2592"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key in <a id="wrglossary.2593"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> or <a id="wrglossary.2594"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. If you use <a id="wrglossary.2595"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>, the <a id="wrglossary.2596"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key will automatically implement <a id="wrglossary.2597"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a><span class="optfmt">=false</span> for that entry. (Note this doesn’t affect <a id="wrglossary.2598"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>.) For further details see §<a href="#sec:crossref">11</a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2599"></a><code class="code"><dfn id="glo:opt.counter"><span class="styoptfmt">counter</span></dfn>=<span class="meta">〈<em class="metainner">counter-name</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>page</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This setting indicates that <span class="meta">〈<em class="metainner">counter-name</em>〉</span> should be the default counter to use in the <a id="wrglossary.2600"></a><a href="#glo:locationlist">number lists</a> (see §<a href="#sec:numberlists">12</a>). This option can be overridden for a specific <a id="wrglossary.2601"></a><a href="#glo:dual.glossary">glossary</a> by the <span class="meta">〈<em class="metainner">counter</em>〉</span> optional argument of <a id="wrglossary.2602"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> or the <a id="wrglossary.2603"></a><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a> key when defining an entry or by the <a id="wrglossary.2604"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> option when referencing an entry.<p>
+This option will redefine: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2605"></a><code class="code"><dfn id="glo:glscounter"><code class="csfmt">\glscounter</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>page</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ to <span class="meta">〈<em class="metainner">counter-name</em>〉</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2606"></a><code class="code"><dfn id="glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If true, this option suppresses the default terminating <a id="wrglossary.2607"></a><a href="#glo:idx.fullstop">full stop</a> in <a id="wrglossary.2608"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the post-description hook: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2609"></a><code class="code"><dfn id="glo:glspostdescription"><code class="csfmt">\glspostdescription</code></dfn></code></div><!-- end of pinnedbox -->
<p>
-The default setting is <a id="wrglossary.2893"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> for the base <a id="wrglossary.2894"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2895"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> for <a id="wrglossary.2896"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2897"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- The <a id="wrglossary.2898"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.2899"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a>, which is equivalent to <a id="wrglossary.2900"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>, and also <a id="wrglossary.2901"></a><a href="#glo:opt.postpunc"><span class="xtrstyoptfmt">postpunc</span></a>, which allows you to choose a different punctuation character. </div><!-- end of information -->
+The default setting is <a id="wrglossary.2610"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> for the base <a id="wrglossary.2611"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2612"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> for <a id="wrglossary.2613"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2614"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ The <a id="wrglossary.2615"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.2616"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a>, which is equivalent to <a id="wrglossary.2617"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>, and also <a id="wrglossary.2618"></a><a href="#glo:opt.postpunc"><span class="xtrstyoptfmt">postpunc</span></a>, which allows you to choose a different punctuation character. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2902"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2903"></a><code class="code"><dfn id="glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If true, this option suppresses the default vertical gap between letter groups used by some of the predefined <a id="wrglossary.2904"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. This option can also be locally switched on or off for a specific <a id="wrglossary.2905"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2906"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a> <a id="wrglossary.2907"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> options</a>.<p>
-This option is only relevant for <a id="wrglossary.2908"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2909"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2910"></a><code class="code"><dfn id="glo:ifglsnogroupskip"><code class="csfmt">\ifglsnogroupskip</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2619"></a><code class="code"><dfn id="glo:opt.nogroupskip"><span class="styoptfmt">nogroupskip</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If true, this option suppresses the default vertical gap between letter groups used by some of the predefined <a id="wrglossary.2620"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. This option can also be locally switched on or off for a specific <a id="wrglossary.2621"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2622"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a> <a id="wrglossary.2623"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> options</a>.<p>
+This option is only relevant for <a id="wrglossary.2624"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2625"></a><code class="code"><dfn id="glo:ifglsnogroupskip"><code class="csfmt">\ifglsnogroupskip</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
to test for this setting.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2911"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
- If you are using <a id="wrglossary.2912"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> without the <a id="wrglossary.2913"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or <a id="wrglossary.2914"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>) switch then this option is irrelevant as there won’t be any letter groups. </div><!-- end of information -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2626"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+ If you are using <a id="wrglossary.2627"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> without the <a id="wrglossary.2628"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or <a id="wrglossary.2629"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>) switch then this option is irrelevant as there won’t be any letter groups. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2915"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2916"></a><code class="code"><dfn id="glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></dfn>=<span class="meta">〈<em class="metainner">list</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>default</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2630"></a><code class="code"><dfn id="glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></dfn>=<span class="meta">〈<em class="metainner">list</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>default</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-Loads the <a id="wrglossary.2917"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package, which patches the predefined <a id="wrglossary.2918"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. The <span class="meta">〈<em class="metainner">list</em>〉</span> argument is optional. If present, this will also load <span class="styfmt">glossary-<span class="meta">〈<em class="metainner">element</em>〉</span>.sty</span> for each <span class="meta">〈<em class="metainner">element</em>〉</span> in the comma-separated <span class="meta">〈<em class="metainner">list</em>〉</span>. See the <a id="wrglossary.2919"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
+Loads the <a id="wrglossary.2631"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package, which patches the predefined <a id="wrglossary.2632"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. The <span class="meta">〈<em class="metainner">list</em>〉</span> argument is optional. If present, this will also load <span class="styfmt">glossary-<span class="meta">〈<em class="metainner">element</em>〉</span>.sty</span> for each <span class="meta">〈<em class="metainner">element</em>〉</span> in the comma-separated <span class="meta">〈<em class="metainner">list</em>〉</span>. See the <a id="wrglossary.2633"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
</section><!-- end of section sec:pkgopts-printglos -->
@@ -2813,108 +2839,108 @@
<section id="sec:pkgopts-indexing"><!-- start of section sec:pkgopts-indexing --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.4. Indexing Options<div class="labellink"><a href="#sec:pkgopts-indexing">[link]</a></div></h2><!-- end of section header -->
<p>
-<a id="wrglossary.2920"></a><div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2921"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2922"></a><code class="code"><dfn id="glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>error</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- (This option is only relevant with <a id="wrglossary.2923"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2924"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.) The <a id="wrglossary.2925"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key automatically <a id="wrglossary.2926"></a><a href="#glo:@@glslabel at indexing">indexes</a> the cross-referenced entry using <a id="wrglossary.2927"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. This means that if this key is used in an entry definition before the relevant <a id="wrglossary.2928"></a><a href="#glo:dual.indexingfile">indexing file</a> has been opened, the <a id="wrglossary.2929"></a><a href="#glo:dual.indexing">indexing</a> can’t be performed. Since this is easy to miss, the <a id="wrglossary.2930"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package by default issues an error message if the <a id="wrglossary.2931"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used before <a id="wrglossary.2932"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. <p>
-This option may take one of the following values: <div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2933"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2934"></a><a id="wrglossary.2935"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a>=<code class="code"><dfn id="glo:optval.seenoindex.error"><span class="optfmt">error</span></dfn></code></div><!-- end of optionvaluebox -->
+<a id="wrglossary.2634"></a><div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2635"></a><code class="code"><dfn id="glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>error</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ (This option is only relevant with <a id="wrglossary.2636"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2637"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.) The <a id="wrglossary.2638"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key automatically <a id="wrglossary.2639"></a><a href="#glo:@@glslabel at indexing">indexes</a> the cross-referenced entry using <a id="wrglossary.2640"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. This means that if this key is used in an entry definition before the relevant <a id="wrglossary.2641"></a><a href="#glo:dual.indexingfile">indexing file</a> has been opened, the <a id="wrglossary.2642"></a><a href="#glo:dual.indexing">indexing</a> can’t be performed. Since this is easy to miss, the <a id="wrglossary.2643"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package by default issues an error message if the <a id="wrglossary.2644"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used before <a id="wrglossary.2645"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. <p>
+This option may take one of the following values: <div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2646"></a><a id="wrglossary.2647"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a>=<code class="code"><dfn id="glo:optval.seenoindex.error"><span class="optfmt">error</span></dfn></code></div><!-- end of optionvaluebox -->
This is the default setting that issues an error message.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2936"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2937"></a><a id="wrglossary.2938"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a>=<code class="code"><dfn id="glo:optval.seenoindex.warn"><span class="optfmt">warn</span></dfn></code></div><!-- end of optionvaluebox -->
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2648"></a><a id="wrglossary.2649"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a>=<code class="code"><dfn id="glo:optval.seenoindex.warn"><span class="optfmt">warn</span></dfn></code></div><!-- end of optionvaluebox -->
This setting will trigger a warning rather than an error.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.2939"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2940"></a><a id="wrglossary.2941"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a>=<code class="code"><dfn id="glo:optval.seenoindex.ignore"><span class="optfmt">ignore</span></dfn></code></div><!-- end of optionvaluebox -->
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2650"></a><a id="wrglossary.2651"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a>=<code class="code"><dfn id="glo:optval.seenoindex.ignore"><span class="optfmt">ignore</span></dfn></code></div><!-- end of optionvaluebox -->
This setting will do nothing. <p>
-For example, if you want to temporarily comment out <a id="wrglossary.2942"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> to speed up the compilation of a draft document by omitting the <a id="wrglossary.2943"></a><a href="#glo:dual.indexing">indexing</a>, you can use <a id="wrglossary.2944"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=warn</span> or <a id="wrglossary.2945"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=ignore</span>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2946"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2947"></a><code class="code"><dfn id="glo:opt.esclocations"><span class="styoptfmt">esclocations</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+For example, if you want to temporarily comment out <a id="wrglossary.2652"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> to speed up the compilation of a draft document by omitting the <a id="wrglossary.2653"></a><a href="#glo:dual.indexing">indexing</a>, you can use <a id="wrglossary.2654"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=warn</span> or <a id="wrglossary.2655"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=ignore</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2656"></a><code class="code"><dfn id="glo:opt.esclocations"><span class="styoptfmt">esclocations</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-Only applicable to <a id="wrglossary.2948"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2949"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. As from v4.50, the initial setting is now <a id="wrglossary.2950"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>. Previously it was <a id="wrglossary.2951"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>.<p>
-Both <a id="wrglossary.2952"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2953"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are fussy about the <a id="wrglossary.2954"></a><a href="#glo:@@glslabel at entrylocation">location</a> syntax (<a id="wrglossary.2955"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> more so than <a id="wrglossary.2956"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) so, if <a id="wrglossary.2957"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>, the <a id="wrglossary.2958"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will try to ensure that special characters are escaped, which allows for the <a id="wrglossary.2959"></a><a href="#glo:@@glslabel at entrylocation">location</a> to be substituted for a format that’s more acceptable to the <a id="wrglossary.2960"></a><a href="#glo:dual.indexingapp">indexing application</a>. 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>
-If you’re sure that your locations will always expand to an acceptable format (or you’re prepared to post-process the <a id="wrglossary.2961"></a><a href="#glo:dual.glossary">glossary</a> file before passing it to the relevant indexing application) then use <a id="wrglossary.2962"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span> to avoid the complex escaping of location values. This is now the default. <p>
-If, however, your <a id="wrglossary.2963"></a><a href="#glo:@@glslabel at entrylocation">locations</a> (for example, <a id="wrglossary.2964"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> with the default <a id="wrglossary.2965"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.2966"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a></span>) expand to a robust command then you may need to use <a id="wrglossary.2967"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>. You may additionally need to set the following conditional to true: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2968"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2969"></a><code class="code"><dfn id="glo:ifglswrallowprimitivemods"><code class="csfmt">\ifglswrallowprimitivemods</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- which will locally redefine some primitives in order to escape special characters without prematurely expanding <a id="wrglossary.2970"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a>. Since this hack may cause some issues and isn’t necessary for the majority of documents, this is off by default.<p>
-This conditional can be switched on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2971"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2972"></a><code class="code"><dfn id="glo:glswrallowprimitivemodstrue"><code class="csfmt">\glswrallowprimitivemodstrue</code></dfn></code></div><!-- end of pinnedbox -->
- but remember that it will have no effect with <a id="wrglossary.2973"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>. If can be switched off with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2974"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2975"></a><code class="code"><dfn id="glo:glswrallowprimitivemodsfalse"><code class="csfmt">\glswrallowprimitivemodsfalse</code></dfn></code></div><!-- end of pinnedbox -->
+Only applicable to <a id="wrglossary.2657"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2658"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. As from v4.50, the initial setting is now <a id="wrglossary.2659"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>. Previously it was <a id="wrglossary.2660"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>.<p>
+Both <a id="wrglossary.2661"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2662"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are fussy about the <a id="wrglossary.2663"></a><a href="#glo:@@glslabel at entrylocation">location</a> syntax (<a id="wrglossary.2664"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> more so than <a id="wrglossary.2665"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) so, if <a id="wrglossary.2666"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>, the <a id="wrglossary.2667"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will try to ensure that special characters are escaped, which allows for the <a id="wrglossary.2668"></a><a href="#glo:@@glslabel at entrylocation">location</a> to be substituted for a format that’s more acceptable to the <a id="wrglossary.2669"></a><a href="#glo:dual.indexingapp">indexing application</a>. 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>
+If you’re sure that your locations will always expand to an acceptable format (or you’re prepared to post-process the <a id="wrglossary.2670"></a><a href="#glo:dual.glossary">glossary</a> file before passing it to the relevant indexing application) then use <a id="wrglossary.2671"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span> to avoid the complex escaping of location values. This is now the default. <p>
+If, however, your <a id="wrglossary.2672"></a><a href="#glo:@@glslabel at entrylocation">locations</a> (for example, <a id="wrglossary.2673"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> with the default <a id="wrglossary.2674"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.2675"></a><a href="#glo:ctr.page"><span class="ctrfmt">page</span></a></span>) expand to a robust command then you may need to use <a id="wrglossary.2676"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>. You may additionally need to set the following conditional to true: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2677"></a><code class="code"><dfn id="glo:ifglswrallowprimitivemods"><code class="csfmt">\ifglswrallowprimitivemods</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ which will locally redefine some primitives in order to escape special characters without prematurely expanding <a id="wrglossary.2678"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a>. Since this hack may cause some issues and isn’t necessary for the majority of documents, this is off by default.<p>
+This conditional can be switched on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2679"></a><code class="code"><dfn id="glo:glswrallowprimitivemodstrue"><code class="csfmt">\glswrallowprimitivemodstrue</code></dfn></code></div><!-- end of pinnedbox -->
+ but remember that it will have no effect with <a id="wrglossary.2680"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>. If can be switched off with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2681"></a><code class="code"><dfn id="glo:glswrallowprimitivemodsfalse"><code class="csfmt">\glswrallowprimitivemodsfalse</code></dfn></code></div><!-- end of pinnedbox -->
<p>
-If you are using <a id="wrglossary.2976"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and your <a id="wrglossary.2977"></a><a href="#glo:@@glslabel at entrylocation">location</a> expands to content in the form <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span> {<span class="meta">〈<em class="metainner">num</em>〉</span>}</code>, where <span class="meta">〈<em class="metainner">cs</em>〉</span> is a command (optionally preceded by <a id="wrglossary.2978"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a>) and <span class="meta">〈<em class="metainner">num</em>〉</span> is a location acceptable to <a id="wrglossary.2979"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, then you can use <a id="wrglossary.2980"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to make a suitable adjustment without <a id="wrglossary.2981"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>. See §<a href="#sec:problemlocations">12.5</a> for furthe details.<p>
-This isn’t an issue for Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.b2g">4</a> as the <a id="wrglossary.2982"></a><a href="#glo:@@glslabel at entrylocation">locations</a> are written to the <a id="wrglossary.2983"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and both methods use LaTeX syntax, so no conversion is required.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.2984"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2985"></a><code class="code"><dfn id="glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If true, this setting will only <a id="wrglossary.2986"></a><a href="#glo:@@glslabel at indexing">index</a> on <a id="wrglossary.2987"></a><a href="#glo:dual.firstuse">first use</a>. The default setting <a id="wrglossary.2988"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="optfmt">=false</span>, will <a id="wrglossary.2989"></a><a href="#glo:@@glslabel at indexing">index</a> the entry every time one of the <a id="wrglossary.2990"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.2991"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are used. Note that <a id="wrglossary.2992"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> will always add information to the external <a id="wrglossary.2993"></a><a href="#glo:dual.glossary">glossary</a> file (since that’s the purpose of that command).<p>
-You can test if this setting is on using the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2994"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2995"></a><code class="code"><dfn id="glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- This setting can also be switched on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2996"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2997"></a><code class="code"><dfn id="glo:glsindexonlyfirsttrue"><code class="csfmt">\glsindexonlyfirsttrue</code></dfn></code></div><!-- end of pinnedbox -->
- and off with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.2998"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2999"></a><code class="code"><dfn id="glo:glsindexonlyfirstfalse"><code class="csfmt">\glsindexonlyfirstfalse</code></dfn></code></div><!-- end of pinnedbox -->
+If you are using <a id="wrglossary.2682"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and your <a id="wrglossary.2683"></a><a href="#glo:@@glslabel at entrylocation">location</a> expands to content in the form <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span> {<span class="meta">〈<em class="metainner">num</em>〉</span>}</code>, where <span class="meta">〈<em class="metainner">cs</em>〉</span> is a command (optionally preceded by <a id="wrglossary.2684"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a>) and <span class="meta">〈<em class="metainner">num</em>〉</span> is a location acceptable to <a id="wrglossary.2685"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, then you can use <a id="wrglossary.2686"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to make a suitable adjustment without <a id="wrglossary.2687"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>. See §<a href="#sec:problemlocations">12.5</a> for furthe details.<p>
+This isn’t an issue for Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.b2g">4</a> as the <a id="wrglossary.2688"></a><a href="#glo:@@glslabel at entrylocation">locations</a> are written to the <a id="wrglossary.2689"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and both methods use LaTeX syntax, so no conversion is required.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2690"></a><code class="code"><dfn id="glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If true, this setting will only <a id="wrglossary.2691"></a><a href="#glo:@@glslabel at indexing">index</a> on <a id="wrglossary.2692"></a><a href="#glo:dual.firstuse">first use</a>. The default setting <a id="wrglossary.2693"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="optfmt">=false</span>, will <a id="wrglossary.2694"></a><a href="#glo:@@glslabel at indexing">index</a> the entry every time one of the <a id="wrglossary.2695"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.2696"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are used. Note that <a id="wrglossary.2697"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> will always add information to the external <a id="wrglossary.2698"></a><a href="#glo:dual.glossary">glossary</a> file (since that’s the purpose of that command).<p>
+You can test if this setting is on using the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2699"></a><code class="code"><dfn id="glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ This setting can also be switched on with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2700"></a><code class="code"><dfn id="glo:glsindexonlyfirsttrue"><code class="csfmt">\glsindexonlyfirsttrue</code></dfn></code></div><!-- end of pinnedbox -->
+ and off with: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2701"></a><code class="code"><dfn id="glo:glsindexonlyfirstfalse"><code class="csfmt">\glsindexonlyfirstfalse</code></dfn></code></div><!-- end of pinnedbox -->
<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.3000"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Resetting the <a id="wrglossary.3001"></a><a href="#glo:dual.firstuseflag">first use flag</a> with commands like <a id="wrglossary.3002"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> after an entry has been <a id="wrglossary.3003"></a><a href="#glo:@@glslabel at indexing">indexed</a> will cause that entry to be indexed multiple times if it’s used again after the reset. Likewise unsetting the <a id="wrglossary.3004"></a><a href="#glo:dual.firstuseflag">first use flag</a> before an entry has been indexed will prevent it from being indexed (unless specifically indexed with <a id="wrglossary.3005"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>). </div><!-- end of important -->
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Resetting the <a id="wrglossary.2702"></a><a href="#glo:dual.firstuseflag">first use flag</a> with commands like <a id="wrglossary.2703"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> after an entry has been <a id="wrglossary.2704"></a><a href="#glo:@@glslabel at indexing">indexed</a> will cause that entry to be indexed multiple times if it’s used again after the reset. Likewise unsetting the <a id="wrglossary.2705"></a><a href="#glo:dual.firstuseflag">first use flag</a> before an entry has been indexed will prevent it from being indexed (unless specifically indexed with <a id="wrglossary.2706"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>). </div><!-- end of important -->
<p>
-You can customise the default behaviour by redefining <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.3006"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.3007"></a><code class="code"><dfn id="glo:glswriteentry"><code class="csfmt">\glswriteentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">indexing code</em>〉</span>}</code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">label</em>〉</span> is the entry’s label and <span class="meta">〈<em class="metainner">indexing code</em>〉</span> is the code that writes the entry’s information to the external file. The default definition of <a id="wrglossary.3008"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a> is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.3009"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a>}[2]{<span class="comment">% </span>
- <a id="wrglossary.3010"></a><a href="#glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></a>
- <a id="wrglossary.3011"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}<span class="comment">% </span>
+You can customise the default behaviour by redefining <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2707"></a><code class="code"><dfn id="glo:glswriteentry"><code class="csfmt">\glswriteentry</code></dfn>{<span class="meta">〈<em class="metainner">label</em>〉</span>}{<span class="meta">〈<em class="metainner">indexing code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">label</em>〉</span> is the entry’s label and <span class="meta">〈<em class="metainner">indexing code</em>〉</span> is the code that writes the entry’s information to the external file. The default definition of <a id="wrglossary.2708"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a> is: <pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.2709"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.2710"></a><a href="#glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></a>
+ <a id="wrglossary.2711"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}<span class="comment">% </span>
<code class="cmd">\else</code>
#2<span class="comment">% </span>
<code class="cmd">\fi</code>
}
-</pre> This does <span class="meta">〈<em class="metainner">indexing code</em>〉</span> unless <a id="wrglossary.3012"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="optfmt">=true</span> and the entry identified by <span class="meta">〈<em class="metainner">label</em>〉</span> has been marked as <a id="wrglossary.3013"></a><a href="#glo:firstuseflag">used</a><p>
-For example, suppose you only want to index the <a id="wrglossary.3014"></a><a href="#glo:dual.firstuse">first use</a> for entries in the <a id="wrglossary.3015"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossary and not in the <a id="wrglossary.3016"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> (or any other) <a id="wrglossary.3017"></a><a href="#glo:dual.glossary">glossary</a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3018"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.3019"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a>}[2]{<span class="comment">% </span>
- <code class="cmd">\ifthenelse</code><code class="cmd">\equal</code>{<a id="wrglossary.3020"></a><a href="#glo:glsentrytype"><code class="csfmt">\glsentrytype</code></a>{#1}}{acronym}
- {<a id="wrglossary.3021"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}}<span class="comment">% </span>
+</pre> This does <span class="meta">〈<em class="metainner">indexing code</em>〉</span> unless <a id="wrglossary.2712"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="optfmt">=true</span> and the entry identified by <span class="meta">〈<em class="metainner">label</em>〉</span> has been marked as <a id="wrglossary.2713"></a><a href="#glo:firstuseflag">used</a><p>
+For example, suppose you only want to index the <a id="wrglossary.2714"></a><a href="#glo:dual.firstuse">first use</a> for entries in the <a id="wrglossary.2715"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossary and not in the <a id="wrglossary.2716"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> (or any other) <a id="wrglossary.2717"></a><a href="#glo:dual.glossary">glossary</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.2718"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a>}[2]{<span class="comment">% </span>
+ <code class="cmd">\ifthenelse</code><code class="cmd">\equal</code>{<a id="wrglossary.2719"></a><a href="#glo:glsentrytype"><code class="csfmt">\glsentrytype</code></a>{#1}}{acronym}
+ {<a id="wrglossary.2720"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}}<span class="comment">% </span>
{#2}<span class="comment">% </span>
}
-</pre> Here I’ve used <code class="csfmt">\ifthenelse</code> to ensure the arguments of <code class="csfmt">\equal</code> are fully expanded before the comparison is made. There are other methods of performing an expanded string comparison, which you may prefer to use.<p>
-With the <a id="wrglossary.3022"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package it’s possible to only index <a id="wrglossary.3023"></a><a href="#glo:dual.firstuse">first use</a> for particular categories. For example, if you only want this enabled for <a id="wrglossary.3024"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you can set the <a id="wrglossary.3025"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> <a id="wrglossary.3026"></a><a href="#glo:@@glslabel at categoryattribute">attribute</a> for the <a id="wrglossary.3027"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a> and, if appropriate, <a id="wrglossary.3028"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the <a id="wrglossary.3029"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option.) See the <a id="wrglossary.3030"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3031"></a><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3032"></a><code class="code"><dfn id="glo:opt.indexcrossrefs"><span class="xtrstyoptfmt">indexcrossrefs</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+</pre> Here I’ve used <code class="csfmt">\ifthenelse</code> to ensure the arguments of <code class="csfmt">\equal</code> are fully expanded before the comparison is made. There are other methods of performing an expanded string comparison, which you may prefer to use.<p>
+With the <a id="wrglossary.2721"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package it’s possible to only index <a id="wrglossary.2722"></a><a href="#glo:dual.firstuse">first use</a> for particular categories. For example, if you only want this enabled for <a id="wrglossary.2723"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you can set the <a id="wrglossary.2724"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> <a id="wrglossary.2725"></a><a href="#glo:@@glslabel at categoryattribute">attribute</a> for the <a id="wrglossary.2726"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a> and, if appropriate, <a id="wrglossary.2727"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the <a id="wrglossary.2728"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option.) See the <a id="wrglossary.2729"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2730"></a><code class="code"><dfn id="glo:opt.indexcrossrefs"><span class="xtrstyoptfmt">indexcrossrefs</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-This option is only available with <a id="wrglossary.3033"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. If true, this will automatically index (<a id="wrglossary.3034"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) any cross-referenced entries that haven’t been marked as used at the end of the document. Note that this increases the document build time. See <a id="wrglossary.3035"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3036"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
- Note that <a id="wrglossary.3037"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can automatically find dependent entries when it parses the <a id="wrglossary.3038"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. Use the <a id="wrglossary.3039"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> option to determine the selection of dependencies. </div><!-- end of information -->
+This option is only available with <a id="wrglossary.2731"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. If true, this will automatically index (<a id="wrglossary.2732"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) any cross-referenced entries that haven’t been marked as used at the end of the document. Note that this increases the document build time. See <a id="wrglossary.2733"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2734"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+ Note that <a id="wrglossary.2735"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can automatically find dependent entries when it parses the <a id="wrglossary.2736"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. Use the <a id="wrglossary.2737"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> option to determine the selection of dependencies. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3040"></a><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3041"></a><code class="code"><dfn id="glo:opt.autoseeindex"><span class="xtrstyoptfmt">autoseeindex</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2738"></a><code class="code"><dfn id="glo:opt.autoseeindex"><span class="xtrstyoptfmt">autoseeindex</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-This option is only available with <a id="wrglossary.3042"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. The base <a id="wrglossary.3043"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package always implements <a id="wrglossary.3044"></a><a href="#glo:opt.autoseeindex"><span class="xtrstyoptfmt">autoseeindex</span></a><span class="optfmt">=true</span>.<p>
-If true, this makes the <a id="wrglossary.3045"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.3046"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys automatically index the entry (with <a id="wrglossary.3047"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>) when the entry is defined. This means that any entry with the <a id="wrglossary.3048"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> (or <a id="wrglossary.3049"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a>) key will automatically be added to the <a id="wrglossary.3050"></a><a href="#glo:dual.glossary">glossary</a>. See the <a id="wrglossary.3051"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3052"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
- With <a id="wrglossary.3053"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.3054"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> resource option to determine the selection of dependencies. </div><!-- end of information -->
+This option is only available with <a id="wrglossary.2739"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. The base <a id="wrglossary.2740"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package always implements <a id="wrglossary.2741"></a><a href="#glo:opt.autoseeindex"><span class="xtrstyoptfmt">autoseeindex</span></a><span class="optfmt">=true</span>.<p>
+If true, this makes the <a id="wrglossary.2742"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and <a id="wrglossary.2743"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys automatically index the entry (with <a id="wrglossary.2744"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>) when the entry is defined. This means that any entry with the <a id="wrglossary.2745"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> (or <a id="wrglossary.2746"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a>) key will automatically be added to the <a id="wrglossary.2747"></a><a href="#glo:dual.glossary">glossary</a>. See the <a id="wrglossary.2748"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2749"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+ With <a id="wrglossary.2750"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.2751"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> resource option to determine the selection of dependencies. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3055"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3056"></a><code class="code"><dfn id="glo:opt.record"><span class="xtrstyoptfmt">record</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>only; <span class="summarytag">initial: </span>off</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2752"></a><code class="code"><dfn id="glo:opt.record"><span class="xtrstyoptfmt">record</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>only; <span class="summarytag">initial: </span>off</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-This option is only available with <a id="wrglossary.3057"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. See <a id="wrglossary.3058"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. A brief summary of available values:<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3059"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3060"></a><a id="wrglossary.3061"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.off"><span class="xtroptfmt">off</span></dfn></code></div><!-- end of optionvaluebox -->
- This default setting indicates that <a id="wrglossary.3062"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> isn’t being used.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3063"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3064"></a><a id="wrglossary.3065"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.only"><span class="xtroptfmt">only</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting indicates that <a id="wrglossary.3066"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is being used to fetch entries from one or more <a id="wrglossary.3067"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files, to sort the entries and collate the <a id="wrglossary.3068"></a><a href="#glo:locationlist">number lists</a>, where the <a id="wrglossary.3069"></a><a href="#glo:@@glslabel at entrylocation">location</a> information is the same as for Options <a href="#glo:idx.opt.noidx">1</a>, <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3070"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3071"></a><a id="wrglossary.3072"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.nameref"><span class="xtroptfmt">nameref</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting is like <a id="wrglossary.3073"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=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>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3074"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3075"></a><a id="wrglossary.3076"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.hybrid"><span class="xtroptfmt">hybrid</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting indicates a hybrid approach where <a id="wrglossary.3077"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is used to fetch entries from one or more <a id="wrglossary.3078"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files but <a id="wrglossary.3079"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3080"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are used for the <a id="wrglossary.3081"></a><a href="#glo:dual.indexing">indexing</a>. This requires a more complicated document build and isn’t recommended.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3082"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3083"></a><code class="code"><dfn id="glo:opt.equations"><span class="xtrstyoptfmt">equations</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+This option is only available with <a id="wrglossary.2753"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. See <a id="wrglossary.2754"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. A brief summary of available values:<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2755"></a><a id="wrglossary.2756"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.off"><span class="xtroptfmt">off</span></dfn></code></div><!-- end of optionvaluebox -->
+ This default setting indicates that <a id="wrglossary.2757"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> isn’t being used.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2758"></a><a id="wrglossary.2759"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.only"><span class="xtroptfmt">only</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting indicates that <a id="wrglossary.2760"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is being used to fetch entries from one or more <a id="wrglossary.2761"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files, to sort the entries and collate the <a id="wrglossary.2762"></a><a href="#glo:locationlist">number lists</a>, where the <a id="wrglossary.2763"></a><a href="#glo:@@glslabel at entrylocation">location</a> information is the same as for Options <a href="#glo:idx.opt.noidx">1</a>, <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2764"></a><a id="wrglossary.2765"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.nameref"><span class="xtroptfmt">nameref</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is like <a id="wrglossary.2766"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=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>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2767"></a><a id="wrglossary.2768"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>=<code class="code"><dfn id="glo:optval.record.hybrid"><span class="xtroptfmt">hybrid</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting indicates a hybrid approach where <a id="wrglossary.2769"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is used to fetch entries from one or more <a id="wrglossary.2770"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files but <a id="wrglossary.2771"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2772"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are used for the <a id="wrglossary.2773"></a><a href="#glo:dual.indexing">indexing</a>. This requires a more complicated document build and isn’t recommended.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2774"></a><code class="code"><dfn id="glo:opt.equations"><span class="xtrstyoptfmt">equations</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-This option is only available with <a id="wrglossary.3084"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. If true, this option will cause the default <a id="wrglossary.3085"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to <a id="wrglossary.3086"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> when inside a numbered equation environment.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3087"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3088"></a><code class="code"><dfn id="glo:opt.floats"><span class="xtrstyoptfmt">floats</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+This option is only available with <a id="wrglossary.2775"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. If true, this option will cause the default <a id="wrglossary.2776"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to <a id="wrglossary.2777"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> when inside a numbered equation environment.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2778"></a><code class="code"><dfn id="glo:opt.floats"><span class="xtrstyoptfmt">floats</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
-This option is only available with <a id="wrglossary.3089"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. If true, this option will cause the default <a id="wrglossary.3090"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to the corresponding counter when inside a float. (Remember that with floats it’s the <a id="wrglossary.3091"></a><a href="#glo:caption"><code class="csfmt">\caption</code></a> command that increments the counter so the location will be incorrect if an entry is <a id="wrglossary.3092"></a><a href="#glo:@@glslabel at indexing">indexed</a> within the float before the caption.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3093"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3094"></a><code class="code"><dfn id="glo:opt.indexcounter"><span class="xtrstyoptfmt">indexcounter</span></dfn></code></div><!-- end of settingsbox -->
+This option is only available with <a id="wrglossary.2779"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. If true, this option will cause the default <a id="wrglossary.2780"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to the corresponding counter when inside a float. (Remember that with floats it’s the <a id="wrglossary.2781"></a><a href="#glo:caption"><code class="csfmt">\caption</code></a> command that increments the counter so the location will be incorrect if an entry is <a id="wrglossary.2782"></a><a href="#glo:@@glslabel at indexing">indexed</a> within the float before the caption.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2783"></a><code class="code"><dfn id="glo:opt.indexcounter"><span class="xtrstyoptfmt">indexcounter</span></dfn></code></div><!-- end of settingsbox -->
<p>
-This option is only available with <a id="wrglossary.3095"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. This valueless option is primarily intended for use with <a id="wrglossary.3096"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and <a id="wrglossary.3097"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> allowing the page location <a id="wrglossary.3098"></a><a href="#glo:idx.hyperlink">hyperlink</a> 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 id="wrglossary.3099"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. <a id="wrglossary.3100"></a><p>
+This option is only available with <a id="wrglossary.2784"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. This valueless option is primarily intended for use with <a id="wrglossary.2785"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and <a id="wrglossary.2786"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> allowing the page location <a id="wrglossary.2787"></a><a href="#glo:idx.hyperlink">hyperlink</a> 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 id="wrglossary.2788"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. <a id="wrglossary.2789"></a><p>
</section><!-- end of section sec:pkgopts-indexing -->
@@ -2921,233 +2947,233 @@
<section id="sec:pkgopts-sort"><!-- start of section sec:pkgopts-sort --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.5. Sorting Options<div class="labellink"><a href="#sec:pkgopts-sort">[link]</a></div></h2><!-- end of section header -->
<p>
-This section is mostly for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>. Only the <a id="wrglossary.3101"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> and <a id="wrglossary.3102"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> options are applicable for <a id="wrglossary.3103"></a><a href="#glo:idx.opt.noidx">Option 1</a>.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3104"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
- With Options <a href="#glo:idx.opt.b2g">4</a>, <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a>, only <a id="wrglossary.3105"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span> is applicable (and this is automatically implemented by <a id="wrglossary.3106"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.3107"></a><a href="#glo:optval.record.only"><span class="xtroptfmt">only</span></a> and <a id="wrglossary.3108"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.3109"></a><a href="#glo:optval.record.nameref"><span class="xtroptfmt">nameref</span></a>). With <a id="wrglossary.3110"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the sort method is provided in the optional argument of <a id="wrglossary.3111"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> not with the <a id="wrglossary.3112"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> package option. There’s no sorting with Options <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a>. </div><!-- end of information -->
+This section is mostly for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>. Only the <a id="wrglossary.2790"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> and <a id="wrglossary.2791"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> options are applicable for <a id="wrglossary.2792"></a><a href="#glo:idx.opt.noidx">Option 1</a>.<p>
+<div class="information"><div class="informationtitle"><a id="wrglossary.2793"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+ With Options <a href="#glo:idx.opt.b2g">4</a>, <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a>, only <a id="wrglossary.2794"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span> is applicable (and this is automatically implemented by <a id="wrglossary.2795"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2796"></a><a href="#glo:optval.record.only"><span class="xtroptfmt">only</span></a> and <a id="wrglossary.2797"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2798"></a><a href="#glo:optval.record.nameref"><span class="xtroptfmt">nameref</span></a>). With <a id="wrglossary.2799"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the sort method is provided in the optional argument of <a id="wrglossary.2800"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> not with the <a id="wrglossary.2801"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> package option. There’s no sorting with Options <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a>. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3113"></a><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3114"></a><code class="code"><dfn id="glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
- This option determines whether or not to <a id="wrglossary.3115"></a><a href="#glo:dual.sanitize">sanitize</a> the sort value when writing to the external <a id="wrglossary.3116"></a><a href="#glo:dual.indexingfile">indexing file</a>. For example, suppose you define an entry as follows: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3117"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3118"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hash}{<a id="wrglossary.3119"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.3120"></a><a href="#glo:cs.hash"><code class="csfmt">\#</code></a>}</span>,<a id="wrglossary.3121"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<a id="wrglossary.3122"></a><a href="#glo:idx.sym.hash"></a>}</span>,
- <a id="wrglossary.3123"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={hash symbol}</span>}
-</pre> The sort value (<a id="wrglossary.3124"></a><a href="#glo:idx.sym.hash"></a>) must be sanitized before writing it to the <a id="wrglossary.3125"></a><a href="#glo:dual.indexingfile">indexing file</a>, 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: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3126"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\mysortvalue</code>}{AAA}
-<a id="wrglossary.3127"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<span class="comment">% </span>
- <a id="wrglossary.3128"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
- <a id="wrglossary.3129"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<code class="cmd">\mysortvalue</code>}</span>,
- <a id="wrglossary.3130"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
-</pre> and you actually want <code class="csfmt">\mysortvalue</code> expanded, so that the entry is sorted according to <code class="code">AAA</code>, then use the package option <a id="wrglossary.3131"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a>false.<p>
-The default for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> is <a id="wrglossary.3132"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>, and the default for <a id="wrglossary.3133"></a><a href="#glo:idx.opt.noidx">Option 1</a> is <a id="wrglossary.3134"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3135"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3136"></a><code class="code"><dfn id="glo:opt.sort"><span class="styoptfmt">sort</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>standard</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If you use Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, this package option is the only way of specifying how to sort the glossaries. Only <a id="wrglossary.3137"></a><a href="#glo:idx.opt.noidx">Option 1</a> allows you to specify sort methods for individual glossaries via the <a id="wrglossary.3138"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> key in the optional argument of <a id="wrglossary.3139"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. If you have multiple <a id="wrglossary.3140"></a><a href="#glo:dual.glossary">glossaries</a> in your document and you are using <a id="wrglossary.3141"></a><a href="#glo:idx.opt.noidx">Option 1</a>, only use the package options <a id="wrglossary.3142"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3143"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.3144"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3145"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> if you want to set this sort method for <span style="font-style: italic; font-variant: normal; ">all</span> your <a id="wrglossary.3146"></a><a href="#glo:dual.glossary">glossaries</a>.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3147"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3148"></a><a id="wrglossary.3149"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.none"><span class="optfmt">none</span></dfn></code></div><!-- end of optionvaluebox -->
- This setting is only for documents that don’t use <a id="wrglossary.3150"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> (Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>) or <a id="wrglossary.3151"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> (<a id="wrglossary.3152"></a><a href="#glo:idx.opt.noidx">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. This setting may be used if no <a id="wrglossary.3153"></a><a href="#glo:dual.glossary">glossary</a> is required or if <a id="wrglossary.3154"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> is used (<a id="wrglossary.3155"></a><a href="#glo:idx.opt.unsrt">Option 5</a>). If you want an unsorted <a id="wrglossary.3156"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.3157"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the resource option <a id="wrglossary.3158"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span> instead. This option will redefine <a id="wrglossary.3159"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">none</code>.<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3160"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-This option will still assign the <a id="wrglossary.3161"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to its default value. It simply doesn’t process it. If you want the <a id="wrglossary.3162"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key set to an empty value instead, use <a id="wrglossary.3163"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3164"></a><a href="#glo:optval.sort.clear"><span class="optfmt">clear</span></a> instead. </div><!-- end of information -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2802"></a><code class="code"><dfn id="glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></dfn>=<span class="meta">〈<em class="metainner">boolean</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span><span class="initvalnotefmt"><em class="initvalnotefmtinner">varies</em></span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option determines whether or not to <a id="wrglossary.2803"></a><a href="#glo:dual.sanitize">sanitize</a> the sort value when writing to the external <a id="wrglossary.2804"></a><a href="#glo:dual.indexingfile">indexing file</a>. For example, suppose you define an entry as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2805"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hash}{<a id="wrglossary.2806"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.2807"></a><a href="#glo:cs.hash"><code class="csfmt">\#</code></a>}</span>,<a id="wrglossary.2808"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<a id="wrglossary.2809"></a><a href="#glo:idx.sym.hash"></a>}</span>,
+ <a id="wrglossary.2810"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={hash symbol}</span>}
+</pre> The sort value (<a id="wrglossary.2811"></a><a href="#glo:idx.sym.hash"></a>) must be sanitized before writing it to the <a id="wrglossary.2812"></a><a href="#glo:dual.indexingfile">indexing file</a>, 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: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\mysortvalue</code>}{AAA}
+<a id="wrglossary.2813"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<span class="comment">% </span>
+ <a id="wrglossary.2814"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.2815"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<code class="cmd">\mysortvalue</code>}</span>,
+ <a id="wrglossary.2816"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+</pre> and you actually want <code class="csfmt">\mysortvalue</code> expanded, so that the entry is sorted according to <code class="code">AAA</code>, then use the package option <a id="wrglossary.2817"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a>false.<p>
+The default for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> is <a id="wrglossary.2818"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>, and the default for <a id="wrglossary.2819"></a><a href="#glo:idx.opt.noidx">Option 1</a> is <a id="wrglossary.2820"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2821"></a><code class="code"><dfn id="glo:opt.sort"><span class="styoptfmt">sort</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>standard</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If you use Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, this package option is the only way of specifying how to sort the glossaries. Only <a id="wrglossary.2822"></a><a href="#glo:idx.opt.noidx">Option 1</a> allows you to specify sort methods for individual glossaries via the <a id="wrglossary.2823"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> key in the optional argument of <a id="wrglossary.2824"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. If you have multiple <a id="wrglossary.2825"></a><a href="#glo:dual.glossary">glossaries</a> in your document and you are using <a id="wrglossary.2826"></a><a href="#glo:idx.opt.noidx">Option 1</a>, only use the package options <a id="wrglossary.2827"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2828"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.2829"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2830"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> if you want to set this sort method for <span style="font-style: italic; font-variant: normal; ">all</span> your <a id="wrglossary.2831"></a><a href="#glo:dual.glossary">glossaries</a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2832"></a><a id="wrglossary.2833"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.none"><span class="optfmt">none</span></dfn></code></div><!-- end of optionvaluebox -->
+ This setting is only for documents that don’t use <a id="wrglossary.2834"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> (Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>) or <a id="wrglossary.2835"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> (<a id="wrglossary.2836"></a><a href="#glo:idx.opt.noidx">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. This setting may be used if no <a id="wrglossary.2837"></a><a href="#glo:dual.glossary">glossary</a> is required or if <a id="wrglossary.2838"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> is used (<a id="wrglossary.2839"></a><a href="#glo:idx.opt.unsrt">Option 5</a>). If you want an unsorted <a id="wrglossary.2840"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.2841"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the resource option <a id="wrglossary.2842"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span> instead. This option will redefine <a id="wrglossary.2843"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">none</code>.<p>
+<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
+This option will still assign the <a id="wrglossary.2844"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to its default value. It simply doesn’t process it. If you want the <a id="wrglossary.2845"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key set to an empty value instead, use <a id="wrglossary.2846"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2847"></a><a href="#glo:optval.sort.clear"><span class="optfmt">clear</span></a> instead. </div><!-- end of information -->
<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3165"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3166"></a><a id="wrglossary.3167"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.clear"><span class="optfmt">clear</span></dfn></code></div><!-- end of optionvaluebox -->
- As <a id="wrglossary.3168"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3169"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> but sets the <a id="wrglossary.3170"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to an empty value. This will affect <a id="wrglossary.3171"></a><a href="#glo:idx.group">letter group</a> formations in <a id="wrglossary.3172"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> with <a id="wrglossary.3173"></a><a href="#glo:idx.opt.unsrt">Option 5</a>. See the <a id="wrglossary.3174"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. This option will redefine <a id="wrglossary.3175"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">none</code>. The remaining <a id="wrglossary.3176"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> options listed below don’t change <a id="wrglossary.3177"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a>.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3178"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3179"></a><a id="wrglossary.3180"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.def"><span class="optfmt">def</span></dfn></code></div><!-- end of optionvaluebox -->
- Entries are sorted in the order in which they were defined. With <a id="wrglossary.3181"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this is implemented by simply iterating over all defined entries so there’s no actual sorting. With Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, sorting is always performed (since that’s the purpose of <a id="wrglossary.3182"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.3183"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). This means that to obtain a list in order of definition, the <a id="wrglossary.3184"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is assigned a numeric value that’s incremented whenever a new entry is defined.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3185"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3186"></a><a id="wrglossary.3187"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.use"><span class="optfmt">use</span></dfn></code></div><!-- end of optionvaluebox -->
- Entries are sorted according to the order in which they are used in the document. With <a id="wrglossary.3188"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this order is obtained by iterating over a list that’s formed with the <a id="wrglossary.3189"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file is input at the start of the document. With Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, again the <a id="wrglossary.3190"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is assigned a numeric value, but in this case the value is incremented, and the <a id="wrglossary.3191"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is assigned, the first time an entry is <a id="wrglossary.3192"></a><a href="#glo:@@glslabel at indexing">indexed</a>.<p>
-Both <a id="wrglossary.3193"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3194"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> and <a id="wrglossary.3195"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3196"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> zero-pad the sort key to a six digit number using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.3197"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.3198"></a><code class="code"><dfn id="glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></dfn>{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code></div><!-- end of pinnedbox -->
- This can be redefined, if required, before the entries are defined (in the case of <a id="wrglossary.3199"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3200"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>) or before the entries are used (in the case of <a id="wrglossary.3201"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3202"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a>).<p>
-Note that the <a id="wrglossary.3203"></a><a href="#glo:idx.group">group</a> styles (such as <a id="wrglossary.3204"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a>) are incompatible with the <a id="wrglossary.3205"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3206"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> and <a id="wrglossary.3207"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3208"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> options.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3209"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3210"></a><a id="wrglossary.3211"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.standard"><span class="optfmt">standard</span></dfn></code></div><!-- end of optionvaluebox -->
- Entries are sorted according to the value of the <a id="wrglossary.3212"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key used in <a id="wrglossary.3213"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> (if present) or the <a id="wrglossary.3214"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key (if <a id="wrglossary.3215"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is missing).<p>
-When the standard sort option is in use, you can hook into the sort mechanism by redefining: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.3216"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.3217"></a><code class="code"><dfn id="glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></dfn>{<span class="meta">〈<em class="metainner">sort cs</em>〉</span>}{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
- where <span class="meta">〈<em class="metainner">sort cs</em>〉</span> is a temporary control sequence that stores the sort value (which was either explicitly set via the <a id="wrglossary.3218"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key or implicitly set via the <a id="wrglossary.3219"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key) before any escaping of the <a id="wrglossary.3220"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.3221"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> special characters is performed. By default <a id="wrglossary.3222"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> just does: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.3223"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.3224"></a><code class="code"><dfn id="glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></dfn></code><p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2848"></a><a id="wrglossary.2849"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.clear"><span class="optfmt">clear</span></dfn></code></div><!-- end of optionvaluebox -->
+ As <a id="wrglossary.2850"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2851"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> but sets the <a id="wrglossary.2852"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to an empty value. This will affect <a id="wrglossary.2853"></a><a href="#glo:idx.group">letter group</a> formations in <a id="wrglossary.2854"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> with <a id="wrglossary.2855"></a><a href="#glo:idx.opt.unsrt">Option 5</a>. See the <a id="wrglossary.2856"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. This option will redefine <a id="wrglossary.2857"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">none</code>. The remaining <a id="wrglossary.2858"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> options listed below don’t change <a id="wrglossary.2859"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a>.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2860"></a><a id="wrglossary.2861"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.def"><span class="optfmt">def</span></dfn></code></div><!-- end of optionvaluebox -->
+ Entries are sorted in the order in which they were defined. With <a id="wrglossary.2862"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this is implemented by simply iterating over all defined entries so there’s no actual sorting. With Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, sorting is always performed (since that’s the purpose of <a id="wrglossary.2863"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2864"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). This means that to obtain a list in order of definition, the <a id="wrglossary.2865"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is assigned a numeric value that’s incremented whenever a new entry is defined.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2866"></a><a id="wrglossary.2867"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.use"><span class="optfmt">use</span></dfn></code></div><!-- end of optionvaluebox -->
+ Entries are sorted according to the order in which they are used in the document. With <a id="wrglossary.2868"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this order is obtained by iterating over a list that’s formed with the <a id="wrglossary.2869"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file is input at the start of the document. With Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, again the <a id="wrglossary.2870"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is assigned a numeric value, but in this case the value is incremented, and the <a id="wrglossary.2871"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is assigned, the first time an entry is <a id="wrglossary.2872"></a><a href="#glo:@@glslabel at indexing">indexed</a>.<p>
+Both <a id="wrglossary.2873"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2874"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> and <a id="wrglossary.2875"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2876"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> zero-pad the sort key to a six digit number using: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2877"></a><code class="code"><dfn id="glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></dfn>{<span class="meta">〈<em class="metainner">number</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ This can be redefined, if required, before the entries are defined (in the case of <a id="wrglossary.2878"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2879"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>) or before the entries are used (in the case of <a id="wrglossary.2880"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2881"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a>).<p>
+Note that the <a id="wrglossary.2882"></a><a href="#glo:idx.group">group</a> styles (such as <a id="wrglossary.2883"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a>) are incompatible with the <a id="wrglossary.2884"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2885"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> and <a id="wrglossary.2886"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2887"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> options.<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2888"></a><a id="wrglossary.2889"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a>=<code class="code"><dfn id="glo:optval.sort.standard"><span class="optfmt">standard</span></dfn></code></div><!-- end of optionvaluebox -->
+ Entries are sorted according to the value of the <a id="wrglossary.2890"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key used in <a id="wrglossary.2891"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> (if present) or the <a id="wrglossary.2892"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key (if <a id="wrglossary.2893"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is missing).<p>
+When the standard sort option is in use, you can hook into the sort mechanism by redefining: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2894"></a><code class="code"><dfn id="glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></dfn>{<span class="meta">〈<em class="metainner">sort cs</em>〉</span>}{<span class="meta">〈<em class="metainner">type</em>〉</span>}{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+ where <span class="meta">〈<em class="metainner">sort cs</em>〉</span> is a temporary control sequence that stores the sort value (which was either explicitly set via the <a id="wrglossary.2895"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key or implicitly set via the <a id="wrglossary.2896"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key) before any escaping of the <a id="wrglossary.2897"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.2898"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> special characters is performed. By default <a id="wrglossary.2899"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> just does: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.2900"></a><code class="code"><dfn id="glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></dfn></code><p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
- which <a id="wrglossary.3225"></a><a href="#glo:dual.sanitize">sanitizes</a> <span class="meta">〈<em class="metainner">sort cs</em>〉</span> if <a id="wrglossary.3226"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> (or does nothing if <a id="wrglossary.3227"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span>).<p>
-The other arguments, <span class="meta">〈<em class="metainner">type</em>〉</span> and <span class="meta">〈<em class="metainner">entry-label</em>〉</span>, are the <a id="wrglossary.3228"></a><a href="#glo:dual.glossary">glossary</a> type and the entry label for the current entry. Note that <span class="meta">〈<em class="metainner">type</em>〉</span> will always be a control sequence, but <span class="meta">〈<em class="metainner">label</em>〉</span> will be in the form used in the first argument of <a id="wrglossary.3229"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.3230"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Redefining <a id="wrglossary.3231"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> won’t affect any entries that have already been defined and will have no effect at all if you use another <a id="wrglossary.3232"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> setting. </div><!-- end of important -->
+ which <a id="wrglossary.2901"></a><a href="#glo:dual.sanitize">sanitizes</a> <span class="meta">〈<em class="metainner">sort cs</em>〉</span> if <a id="wrglossary.2902"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> (or does nothing if <a id="wrglossary.2903"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span>).<p>
+The other arguments, <span class="meta">〈<em class="metainner">type</em>〉</span> and <span class="meta">〈<em class="metainner">entry-label</em>〉</span>, are the <a id="wrglossary.2904"></a><a href="#glo:dual.glossary">glossary</a> type and the entry label for the current entry. Note that <span class="meta">〈<em class="metainner">type</em>〉</span> will always be a control sequence, but <span class="meta">〈<em class="metainner">label</em>〉</span> will be in the form used in the first argument of <a id="wrglossary.2905"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Redefining <a id="wrglossary.2906"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> won’t affect any entries that have already been defined and will have no effect at all if you use another <a id="wrglossary.2907"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> setting. </div><!-- end of important -->
<p>
-<div class="example" id="ex:diffsorts"><div class="title">Example 9: Mixing Alphabetical and Order of Definition Sorting</div> Suppose I have three <a id="wrglossary.3233"></a><a href="#glo:dual.glossary">glossaries</a>: <a id="wrglossary.3234"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>, <a id="wrglossary.3235"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> and <code class="glostypefmt">notation</code>, and let’s suppose I want the <a id="wrglossary.3236"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3237"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossaries to be sorted alphabetically, but the <code class="glostypefmt">notation</code> type should be sorted in order of definition. <p>
-For <a id="wrglossary.3238"></a><a href="#glo:idx.opt.noidx">Option 1</a>, the <a id="wrglossary.3239"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> option can be used in <a id="wrglossary.3240"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3241"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3242"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3243"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
-<a id="wrglossary.3244"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3245"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3246"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3247"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
-<a id="wrglossary.3248"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3249"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=notation</span>,<a id="wrglossary.3250"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=def</span>]
+<div class="example" id="ex:diffsorts"><div class="title">Example 9: Mixing Alphabetical and Order of Definition Sorting</div> Suppose I have three <a id="wrglossary.2908"></a><a href="#glo:dual.glossary">glossaries</a>: <a id="wrglossary.2909"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>, <a id="wrglossary.2910"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> and <code class="glostypefmt">notation</code>, and let’s suppose I want the <a id="wrglossary.2911"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.2912"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossaries to be sorted alphabetically, but the <code class="glostypefmt">notation</code> type should be sorted in order of definition. <p>
+For <a id="wrglossary.2913"></a><a href="#glo:idx.opt.noidx">Option 1</a>, the <a id="wrglossary.2914"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> option can be used in <a id="wrglossary.2915"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2916"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.2917"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.2918"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.2919"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.2920"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.2921"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.2922"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.2923"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=notation</span>,<a id="wrglossary.2924"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=def</span>]
</pre><p>
-For Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, I can set <a id="wrglossary.3251"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3252"></a><a href="#glo:optval.sort.standard"><span class="optfmt">standard</span></a> (which is the default), and I can either define all my <a id="wrglossary.3253"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3254"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> entries, then redefine <a id="wrglossary.3255"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> to set <span class="meta">〈<em class="metainner">sort cs</em>〉</span> to an incremented integer, and then define all my <code class="glostypefmt">notation</code> entries. Alternatively, I can redefine <a id="wrglossary.3256"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> to check for the glossary type and only modify <span class="meta">〈<em class="metainner">sort cs</em>〉</span> if <span class="meta">〈<em class="metainner">type</em>〉</span> is <code class="glostypefmt">notation</code>.<p>
-The first method can be achieved as follows: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3257"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcounter</code>{sortcount}
+For Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, I can set <a id="wrglossary.2925"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2926"></a><a href="#glo:optval.sort.standard"><span class="optfmt">standard</span></a> (which is the default), and I can either define all my <a id="wrglossary.2927"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.2928"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> entries, then redefine <a id="wrglossary.2929"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> to set <span class="meta">〈<em class="metainner">sort cs</em>〉</span> to an incremented integer, and then define all my <code class="glostypefmt">notation</code> entries. Alternatively, I can redefine <a id="wrglossary.2930"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> to check for the glossary type and only modify <span class="meta">〈<em class="metainner">sort cs</em>〉</span> if <span class="meta">〈<em class="metainner">type</em>〉</span> is <code class="glostypefmt">notation</code>.<p>
+The first method can be achieved as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcounter</code>{sortcount}
-<code class="cmd">\renewcommand</code>{<a id="wrglossary.3258"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.2931"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
<code class="cmd">\stepcounter</code>{sortcount}<span class="comment">% </span>
- <code class="cmd">\edef</code>#1{<a id="wrglossary.3259"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3260"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>{sortcount}}}<span class="comment">% </span>
+ <code class="cmd">\edef</code>#1{<a id="wrglossary.2932"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.2933"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>{sortcount}}}<span class="comment">% </span>
}
-</pre> The second method can be achieved as follows: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3261"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcounter</code>{sortcount}
+</pre> The second method can be achieved as follows: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcounter</code>{sortcount}
-<code class="cmd">\renewcommand</code>{<a id="wrglossary.3262"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.2934"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
<code class="cmd">\ifdefstring</code>{#2}{notation}<span class="comment">% </span>
{<span class="comment">% </span>
<code class="cmd">\stepcounter</code>{sortcount}<span class="comment">% </span>
- <code class="cmd">\edef</code>#1{<a id="wrglossary.3263"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3264"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>{sortcount}}}<span class="comment">% </span>
+ <code class="cmd">\edef</code>#1{<a id="wrglossary.2935"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.2936"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>{sortcount}}}<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% </span>
- <a id="wrglossary.3265"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
+ <a id="wrglossary.2937"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
}<span class="comment">% </span>
}
-</pre> (<code class="csfmt">\ifdefstring</code> is defined by the <a id="wrglossary.3266"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> package, which is automatically loaded by <a id="wrglossary.3267"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>.) For a complete document, see the sample file <a id="wrglossary.3268"></a><a href="#glo:file.sampleSort.tex"><span class="filefmt">sampleSort.tex</span></a>. </div><p>
-<div class="example" id="ex:customsort"><div class="title">Example 10: Customizing Standard Sort (Options 2 or 3)</div> Suppose you want a <a id="wrglossary.3269"></a><a href="#glo:dual.glossary">glossary</a> of people and you want the names listed as <span class="meta">〈<em class="metainner">first-name</em>〉</span> <span class="meta">〈<em class="metainner">surname</em>〉</span> in the glossary, but you want the names sorted by <span class="meta">〈<em class="metainner">surname</em>〉</span>, <span class="meta">〈<em class="metainner">first-name</em>〉</span>. You can do this by defining a command called, say, <code class="csfmt">\name</code>{first-name}{surname} that you can use in the <a id="wrglossary.3270"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key when you define the entry, but hook into the standard sort mechanism to temporarily redefine <code class="csfmt">\name</code> while the sort value is being set.<p>
-First, define two commands to set the person’s name: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3271"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\sortname</code>}[2]{#2, #1}
+</pre> (<code class="csfmt">\ifdefstring</code> is defined by the <a id="wrglossary.2938"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> package, which is automatically loaded by <a id="wrglossary.2939"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>.) For a complete document, see the sample file <a id="wrglossary.2940"></a><a href="#glo:file.sampleSort.tex"><span class="filefmt">sampleSort.tex</span></a>. </div><p>
+<div class="example" id="ex:customsort"><div class="title">Example 10: Customizing Standard Sort (Options 2 or 3)</div> Suppose you want a <a id="wrglossary.2941"></a><a href="#glo:dual.glossary">glossary</a> of people and you want the names listed as <span class="meta">〈<em class="metainner">first-name</em>〉</span> <span class="meta">〈<em class="metainner">surname</em>〉</span> in the glossary, but you want the names sorted by <span class="meta">〈<em class="metainner">surname</em>〉</span>, <span class="meta">〈<em class="metainner">first-name</em>〉</span>. You can do this by defining a command called, say, <code class="csfmt">\name</code>{first-name}{surname} that you can use in the <a id="wrglossary.2942"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key when you define the entry, but hook into the standard sort mechanism to temporarily redefine <code class="csfmt">\name</code> while the sort value is being set.<p>
+First, define two commands to set the person’s name: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\sortname</code>}[2]{#2, #1}
<code class="cmd">\newcommand</code>{<code class="cmd">\textname</code>}[2]{#1 #2}
-</pre> and <code class="csfmt">\name</code> needs to be initialised to <code class="csfmt">\textname</code>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3272"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\let</code><code class="cmd">\name</code><code class="cmd">\textname</code>
-</pre> Now redefine <a id="wrglossary.3273"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> so that it temporarily sets <code class="csfmt">\name</code> to <code class="csfmt">\sortname</code> and expands the sort value, then sets <code class="csfmt">\name</code> to <code class="csfmt">\textname</code> so that the person’s name appears as <span class="meta">〈<em class="metainner">first-name</em>〉</span> <span class="meta">〈<em class="metainner">surname</em>〉</span> in the text: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3274"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.3275"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
+</pre> and <code class="csfmt">\name</code> needs to be initialised to <code class="csfmt">\textname</code>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\let</code><code class="cmd">\name</code><code class="cmd">\textname</code>
+</pre> Now redefine <a id="wrglossary.2943"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> so that it temporarily sets <code class="csfmt">\name</code> to <code class="csfmt">\sortname</code> and expands the sort value, then sets <code class="csfmt">\name</code> to <code class="csfmt">\textname</code> so that the person’s name appears as <span class="meta">〈<em class="metainner">first-name</em>〉</span> <span class="meta">〈<em class="metainner">surname</em>〉</span> in the text: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.2944"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
<code class="cmd">\let</code><code class="cmd">\name</code><code class="cmd">\sortname</code>
<code class="cmd">\edef</code>#1{<code class="cmd">\expandafter</code><code class="cmd">\expandonce</code><code class="cmd">\expandafter</code>{#1}}<span class="comment">% </span>
<code class="cmd">\let</code><code class="cmd">\name</code><code class="cmd">\textname</code>
- <a id="wrglossary.3276"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
+ <a id="wrglossary.2945"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
}
</pre> (The somewhat complicate use of <code class="csfmt">\expandafter</code> etc helps to protect fragile commands, but care is still needed.)<p>
-Now the entries can be defined: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3277"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3278"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{joebloggs}<a id="wrglossary.3279"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\name</code>{Joe}{Bloggs}}</span>,
- <a id="wrglossary.3280"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={some information about Joe Bloggs}</span>
+Now the entries can be defined: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2946"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{joebloggs}<a id="wrglossary.2947"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\name</code>{Joe}{Bloggs}}</span>,
+ <a id="wrglossary.2948"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={some information about Joe Bloggs}</span>
-<a id="wrglossary.3281"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{johnsmith}{<a id="wrglossary.3282"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\name</code>{John}{Smith}}</span>,
- <a id="wrglossary.3283"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={some information about John Smith}</span>}
-</pre> For a complete document, see the sample file <a id="wrglossary.3284"></a><a href="#glo:file.samplePeople.tex"><span class="filefmt">samplePeople.tex</span></a>. </div><p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3285"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3286"></a><code class="code"><dfn id="glo:opt.order"><span class="styoptfmt">order</span></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>word</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.2949"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{johnsmith}{<a id="wrglossary.2950"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\name</code>{John}{Smith}}</span>,
+ <a id="wrglossary.2951"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={some information about John Smith}</span>}
+</pre> For a complete document, see the sample file <a id="wrglossary.2952"></a><a href="#glo:file.samplePeople.tex"><span class="filefmt">samplePeople.tex</span></a>. </div><p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2953"></a><code class="code"><dfn id="glo:opt.order"><span class="styoptfmt">order</span></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>word</span><span class="clearfix"></span></div><!-- end of settingsbox -->
This may take two values: <p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3287"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3288"></a><a id="wrglossary.3289"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>=<code class="code"><dfn id="glo:optval.order.word"><span class="optfmt">word</span></dfn></code></div><!-- end of optionvaluebox -->
- Word order (<span class="qt">“sea lion”</span> before <span class="qt">“seal”</span>).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3290"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3291"></a><a id="wrglossary.3292"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>=<code class="code"><dfn id="glo:optval.order.letter"><span class="optfmt">letter</span></dfn></code></div><!-- end of optionvaluebox -->
- Letter order (<span class="qt">“seal”</span> before <span class="qt">“sea lion”</span>).<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.3293"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that with Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, the <a id="wrglossary.3294"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> option has no effect if you explicitly call <a id="wrglossary.3295"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3296"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. </div><!-- end of important -->
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2954"></a><a id="wrglossary.2955"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>=<code class="code"><dfn id="glo:optval.order.word"><span class="optfmt">word</span></dfn></code></div><!-- end of optionvaluebox -->
+ Word order (<span class="qt">“sea lion”</span> before <span class="qt">“seal”</span>).<p>
+<div class="optionvaluebox"><div class="optionvalueboxtitle"><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
+<a id="wrglossary.2956"></a><a id="wrglossary.2957"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>=<code class="code"><dfn id="glo:optval.order.letter"><span class="optfmt">letter</span></dfn></code></div><!-- end of optionvaluebox -->
+ Letter order (<span class="qt">“seal”</span> before <span class="qt">“sea lion”</span>).<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that with Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, the <a id="wrglossary.2958"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> option has no effect if you explicitly call <a id="wrglossary.2959"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2960"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. </div><!-- end of important -->
<p>
-If you use <a id="wrglossary.3297"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this setting will be used if you use <a id="wrglossary.3298"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=standard</span> in the optional argument of <a id="wrglossary.3299"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3300"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3301"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3302"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=standard</span>]
-</pre> Alternatively, you can specify the order for individual <a id="wrglossary.3303"></a><a href="#glo:dual.glossary">glossaries</a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3304"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3305"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3306"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
-<a id="wrglossary.3307"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3308"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3309"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3310"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=letter</span>]
+If you use <a id="wrglossary.2961"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this setting will be used if you use <a id="wrglossary.2962"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=standard</span> in the optional argument of <a id="wrglossary.2963"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2964"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.2965"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=standard</span>]
+</pre> Alternatively, you can specify the order for individual <a id="wrglossary.2966"></a><a href="#glo:dual.glossary">glossaries</a>: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2967"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.2968"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.2969"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.2970"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.2971"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.2972"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=letter</span>]
</pre><p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3311"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
- With <a id="wrglossary.3312"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.3313"></a><a href="#glo:opt.resource.break-at"><span class="xtrcsoptfmt">break-at</span></a> option in <a id="wrglossary.3314"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> instead of <a id="wrglossary.3315"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>. </div><!-- end of information -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2973"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+ With <a id="wrglossary.2974"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.2975"></a><a href="#glo:opt.resource.break-at"><span class="xtrcsoptfmt">break-at</span></a> option in <a id="wrglossary.2976"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> instead of <a id="wrglossary.2977"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>. </div><!-- end of information -->
<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3316"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3317"></a><code class="code"><dfn id="glo:opt.makeindex"><span class="styoptfmt">makeindex</span></dfn></code><p>
-<div class="noteBox"><a id="wrglossary.3318"></a><a href="#glo:idx.opt.mkidx">Option 2</a></div><!-- end of noteBox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2978"></a><code class="code"><dfn id="glo:opt.makeindex"><span class="styoptfmt">makeindex</span></dfn></code><p>
+<div class="noteBox"><a id="wrglossary.2979"></a><a href="#glo:idx.opt.mkidx">Option 2</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
- The <a id="wrglossary.3319"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3320"></a><a href="#glo:dual.indexing">indexing</a> style file will be written in <a id="wrglossary.3321"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> format. If you use <a id="wrglossary.3322"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.3323"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>, it will automatically detect that it needs to call <a id="wrglossary.3324"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. If you don’t use <a id="wrglossary.3325"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to remember to use <a id="wrglossary.3326"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> not <a id="wrglossary.3327"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The indexing style file will been given a <a id="wrglossary.3328"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> extension.<p>
-You may omit this package option if you are using <a id="wrglossary.3329"></a><a href="#glo:idx.opt.mkidx">Option 2</a> as this is the default. It’s available in case you need to override the effect of an earlier occurrence of <a id="wrglossary.3330"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> in the package option list.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3331"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3332"></a><code class="code"><dfn id="glo:opt.xindy"><span class="styoptfmt">xindy</span></dfn>={<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><p>
-<div class="noteBox"><a id="wrglossary.3333"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+ The <a id="wrglossary.2980"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.2981"></a><a href="#glo:dual.indexing">indexing</a> style file will be written in <a id="wrglossary.2982"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> format. If you use <a id="wrglossary.2983"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.2984"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>, it will automatically detect that it needs to call <a id="wrglossary.2985"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. If you don’t use <a id="wrglossary.2986"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to remember to use <a id="wrglossary.2987"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> not <a id="wrglossary.2988"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The indexing style file will been given a <a id="wrglossary.2989"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> extension.<p>
+You may omit this package option if you are using <a id="wrglossary.2990"></a><a href="#glo:idx.opt.mkidx">Option 2</a> as this is the default. It’s available in case you need to override the effect of an earlier occurrence of <a id="wrglossary.2991"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> in the package option list.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.2992"></a><code class="code"><dfn id="glo:opt.xindy"><span class="styoptfmt">xindy</span></dfn>={<span class="meta">〈<em class="metainner">options</em>〉</span>}</code><p>
+<div class="noteBox"><a id="wrglossary.2993"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
- The <a id="wrglossary.3334"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3335"></a><a href="#glo:dual.indexing">indexing</a> style file will be written in <a id="wrglossary.3336"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format. If you use <a id="wrglossary.3337"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, it will automatically detect that it needs to call <a id="wrglossary.3338"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. If you don’t use <a id="wrglossary.3339"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to remember to use <a id="wrglossary.3340"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> not <a id="wrglossary.3341"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. The indexing style file will been given a <a id="wrglossary.3342"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension.<p>
-This package option may additionally have a value that is a <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> comma-separated list to override some default options. Note that these options are irrelevant if you explicitly call <a id="wrglossary.3343"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. See §<a href="#sec:xindy">14</a> for further details on using <a id="wrglossary.3344"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3345"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.<p>
-You can test if this option has been set using the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.3346"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.3347"></a><code class="code"><dfn id="glo:ifglsxindy"><code class="csfmt">\ifglsxindy</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
- Note that this conditional should not be changed after <a id="wrglossary.3348"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> otherwise the syntax in the <a id="wrglossary.3349"></a><a href="#glo:dual.glossary">glossary</a> files will be incorrect. If this conditional is false, it means that any option other than <a id="wrglossary.3350"></a><a href="#glo:idx.opt.xdy">Option 3</a> is in effect. (If you need to know which indexing option is in effect, check the definition of <a id="wrglossary.3351"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> instead.)<p>
-The <span class="meta">〈<em class="metainner">options</em>〉</span> value may be omitted. If set, it should be a <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> list, where the following three options may be used:<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3352"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3353"></a><code class="code"><dfn id="glo:opt.xindy.language"><span class="optfmt">language</span></dfn>={<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of settingsbox -->
- The language module to use, which is passed to <a id="wrglossary.3354"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3355"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> switch. The default is obtained from <a id="wrglossary.3356"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a> but note that this may not be correct as <a id="wrglossary.3357"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> has a different labelling system to <a id="wrglossary.3358"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.3359"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>. <p>
-The <a id="wrglossary.3360"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script has a set of mappings of known <a id="wrglossary.3361"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> language names to <a id="wrglossary.3362"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language names, but new <a id="wrglossary.3363"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> dialect names may not be included. The <a id="wrglossary.3364"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> script doesn’t have this feature (but there’s no benefit in use <a id="wrglossary.3365"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> instead of <a id="wrglossary.3366"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when using <a id="wrglossary.3367"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). The <a id="wrglossary.3368"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=o</span>ption that calls <a id="wrglossary.3369"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly also doesn’t use any mapping.<p>
-However, even if the appropriate mapping is available, <a id="wrglossary.3370"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a> may still not expand to the language required for the <a id="wrglossary.3371"></a><a href="#glo:dual.glossary">glossary</a>. In which case, you need to specify the correct <a id="wrglossary.3372"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3373"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[brazilian,english]{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.3374"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3375"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=portuguese</span></span>]{glossaries}
-</pre> If you have multiple <a id="wrglossary.3376"></a><a href="#glo:dual.glossary">glossaries</a> in different languages, use <a id="wrglossary.3377"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> to set the language for each glossary.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3378"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3379"></a><code class="code"><dfn id="glo:opt.xindy.codepage"><span class="optfmt">codepage</span></dfn>={<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of settingsbox -->
- The <a id="wrglossary.3380"></a><a href="#glo:idx.codepage">codepage</a> is the file <a id="wrglossary.3381"></a><a href="#glo:idx.encoding">encoding</a> for the <a id="wrglossary.3382"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> files and is passed to <a id="wrglossary.3383"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3384"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> switch. The default <a id="wrglossary.3385"></a><a href="#glo:idx.codepage">codepage</a> is obtained from <a id="wrglossary.3386"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>. As from v4.50, if <a id="wrglossary.3387"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a> isn’t defined, <a id="wrglossary.3388"></a><a href="#glo:dual.utf8">UTF-8</a> is assumed (which is identified by the label <code class="code">utf8</code>). If this is incorrect, you will need to use the <a id="wrglossary.3389"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a> option but make sure you use the <a id="wrglossary.3390"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> <a id="wrglossary.3391"></a><a href="#glo:idx.codepage">codepage</a> label (for example, <code class="code">cp1252</code> or <code class="code">latin9</code>). See the <a id="wrglossary.3392"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> documentation for further details.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.3393"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-The <a id="wrglossary.3394"></a><a href="#glo:idx.codepage">codepage</a> may not simply be the <a id="wrglossary.3395"></a><a href="#glo:idx.encoding">encoding</a> but may include a sorting rule, such as <code class="code">ij-as-y-utf8</code> or <code class="code">din5007-utf8</code>. See §<a href="#sec:langenc">14.2</a>. </div><!-- end of important -->
+ The <a id="wrglossary.2994"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.2995"></a><a href="#glo:dual.indexing">indexing</a> style file will be written in <a id="wrglossary.2996"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format. If you use <a id="wrglossary.2997"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, it will automatically detect that it needs to call <a id="wrglossary.2998"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. If you don’t use <a id="wrglossary.2999"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to remember to use <a id="wrglossary.3000"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> not <a id="wrglossary.3001"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. The indexing style file will been given a <a id="wrglossary.3002"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension.<p>
+This package option may additionally have a value that is a <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> comma-separated list to override some default options. Note that these options are irrelevant if you explicitly call <a id="wrglossary.3003"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. See §<a href="#sec:xindy">14</a> for further details on using <a id="wrglossary.3004"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3005"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.<p>
+You can test if this option has been set using the conditional: <div class="pinnedbox"><div class="pinnedboxtitle"><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
+<a id="wrglossary.3006"></a><code class="code"><dfn id="glo:ifglsxindy"><code class="csfmt">\ifglsxindy</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="csfmt">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+ Note that this conditional should not be changed after <a id="wrglossary.3007"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> otherwise the syntax in the <a id="wrglossary.3008"></a><a href="#glo:dual.glossary">glossary</a> files will be incorrect. If this conditional is false, it means that any option other than <a id="wrglossary.3009"></a><a href="#glo:idx.opt.xdy">Option 3</a> is in effect. (If you need to know which indexing option is in effect, check the definition of <a id="wrglossary.3010"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> instead.)<p>
+The <span class="meta">〈<em class="metainner">options</em>〉</span> value may be omitted. If set, it should be a <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> list, where the following three options may be used:<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3011"></a><code class="code"><dfn id="glo:opt.xindy.language"><span class="optfmt">language</span></dfn>={<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of settingsbox -->
+ The language module to use, which is passed to <a id="wrglossary.3012"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3013"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> switch. The default is obtained from <a id="wrglossary.3014"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a> but note that this may not be correct as <a id="wrglossary.3015"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> has a different labelling system to <a id="wrglossary.3016"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.3017"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>. <p>
+The <a id="wrglossary.3018"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script has a set of mappings of known <a id="wrglossary.3019"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> language names to <a id="wrglossary.3020"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language names, but new <a id="wrglossary.3021"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> dialect names may not be included. The <a id="wrglossary.3022"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> script doesn’t have this feature (but there’s no benefit in use <a id="wrglossary.3023"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> instead of <a id="wrglossary.3024"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when using <a id="wrglossary.3025"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). The <a id="wrglossary.3026"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=o</span>ption that calls <a id="wrglossary.3027"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly also doesn’t use any mapping.<p>
+However, even if the appropriate mapping is available, <a id="wrglossary.3028"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a> may still not expand to the language required for the <a id="wrglossary.3029"></a><a href="#glo:dual.glossary">glossary</a>. In which case, you need to specify the correct <a id="wrglossary.3030"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language. For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[brazilian,english]{babel}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.3031"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3032"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=portuguese</span></span>]{glossaries}
+</pre> If you have multiple <a id="wrglossary.3033"></a><a href="#glo:dual.glossary">glossaries</a> in different languages, use <a id="wrglossary.3034"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> to set the language for each glossary.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3035"></a><code class="code"><dfn id="glo:opt.xindy.codepage"><span class="optfmt">codepage</span></dfn>={<span class="meta">〈<em class="metainner">value</em>〉</span>}</code></div><!-- end of settingsbox -->
+ The <a id="wrglossary.3036"></a><a href="#glo:idx.codepage">codepage</a> is the file <a id="wrglossary.3037"></a><a href="#glo:idx.encoding">encoding</a> for the <a id="wrglossary.3038"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> files and is passed to <a id="wrglossary.3039"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3040"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> switch. The default <a id="wrglossary.3041"></a><a href="#glo:idx.codepage">codepage</a> is obtained from <a id="wrglossary.3042"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>. As from v4.50, if <a id="wrglossary.3043"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a> isn’t defined, <a id="wrglossary.3044"></a><a href="#glo:dual.utf8">UTF-8</a> is assumed (which is identified by the label <code class="code">utf8</code>). If this is incorrect, you will need to use the <a id="wrglossary.3045"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a> option but make sure you use the <a id="wrglossary.3046"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> <a id="wrglossary.3047"></a><a href="#glo:idx.codepage">codepage</a> label (for example, <code class="code">cp1252</code> or <code class="code">latin9</code>). See the <a id="wrglossary.3048"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> documentation for further details.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+The <a id="wrglossary.3049"></a><a href="#glo:idx.codepage">codepage</a> may not simply be the <a id="wrglossary.3050"></a><a href="#glo:idx.encoding">encoding</a> but may include a sorting rule, such as <code class="code">ij-as-y-utf8</code> or <code class="code">din5007-utf8</code>. See §<a href="#sec:langenc">14.2</a>. </div><!-- end of important -->
<p>
-For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3396"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3397"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3398"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=english</span>,<a id="wrglossary.3399"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a><span class="optfmt">=cp1252</span></span>]
+For example: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3051"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3052"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=english</span>,<a id="wrglossary.3053"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a><span class="optfmt">=cp1252</span></span>]
{glossaries}
</pre><p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3400"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3401"></a><code class="code"><dfn id="glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></dfn>={<span class="meta">〈<em class="metainner">boolean</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- If true, this option will define the number <a id="wrglossary.3402"></a><a href="#glo:idx.group">group</a> in the <a id="wrglossary.3403"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file, which by default will be placed before the <span class="qt">“A”</span> <a id="wrglossary.3404"></a><a href="#glo:idx.group">letter group</a>. If you don’t want this <a id="wrglossary.3405"></a><a href="#glo:idx.group">letter group</a>, set this option to false. Note that the <span class="qt">“A”</span> <a id="wrglossary.3406"></a><a href="#glo:idx.group">letter group</a> is only available with <a id="wrglossary.3407"></a><a href="#glo:dual.latinalph">Latin alphabets</a>, so if you are using a <a id="wrglossary.3408"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>, you will either need to switch off the number <a id="wrglossary.3409"></a><a href="#glo:idx.group">group</a> or identify the <a id="wrglossary.3410"></a><a href="#glo:idx.group">letter group</a> that it should come before with <a id="wrglossary.3411"></a><a href="#glo:GlsSetXdyNumberGroupOrder"><code class="csfmt">\GlsSetXdyNumberGroupOrder</code></a>.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3412"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3413"></a><code class="code"><dfn id="glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></dfn></code><p>
-<div class="noteBox"><a id="wrglossary.3414"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3054"></a><code class="code"><dfn id="glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></dfn>={<span class="meta">〈<em class="metainner">boolean</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">default: </span>true; <span class="summarytag">initial: </span>true</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ If true, this option will define the number <a id="wrglossary.3055"></a><a href="#glo:idx.group">group</a> in the <a id="wrglossary.3056"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file, which by default will be placed before the <span class="qt">“A”</span> <a id="wrglossary.3057"></a><a href="#glo:idx.group">letter group</a>. If you don’t want this <a id="wrglossary.3058"></a><a href="#glo:idx.group">letter group</a>, set this option to false. Note that the <span class="qt">“A”</span> <a id="wrglossary.3059"></a><a href="#glo:idx.group">letter group</a> is only available with <a id="wrglossary.3060"></a><a href="#glo:dual.latinalph">Latin alphabets</a>, so if you are using a <a id="wrglossary.3061"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>, you will either need to switch off the number <a id="wrglossary.3062"></a><a href="#glo:idx.group">group</a> or identify the <a id="wrglossary.3063"></a><a href="#glo:idx.group">letter group</a> that it should come before with <a id="wrglossary.3064"></a><a href="#glo:GlsSetXdyNumberGroupOrder"><code class="csfmt">\GlsSetXdyNumberGroupOrder</code></a>.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3065"></a><code class="code"><dfn id="glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></dfn></code><p>
+<div class="noteBox"><a id="wrglossary.3066"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
- This is equivalent to <a id="wrglossary.3415"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> without any value supplied and may be used as a document class option. The language and code page can be set via <a id="wrglossary.3416"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> and <a id="wrglossary.3417"></a><a href="#glo:GlsSetXdyCodePage"><code class="csfmt">\GlsSetXdyCodePage</code></a> if the defaults are inappropriate (see §<a href="#sec:langenc">14.2</a>.)<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3418"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3419"></a><code class="code"><dfn id="glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></dfn></code><p>
-<div class="noteBox"><a id="wrglossary.3420"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+ This is equivalent to <a id="wrglossary.3067"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> without any value supplied and may be used as a document class option. The language and code page can be set via <a id="wrglossary.3068"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> and <a id="wrglossary.3069"></a><a href="#glo:GlsSetXdyCodePage"><code class="csfmt">\GlsSetXdyCodePage</code></a> if the defaults are inappropriate (see §<a href="#sec:langenc">14.2</a>.)<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3070"></a><code class="code"><dfn id="glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></dfn></code><p>
+<div class="noteBox"><a id="wrglossary.3071"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
- This is equivalent to <a id="wrglossary.3421"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.3422"></a><a href="#glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></a><span class="optfmt">=false</span>}</span> and may be used as a document class option.<p>
-<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.3423"></a><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3424"></a><code class="code"><dfn id="glo:opt.automake"><span class="styoptfmt">automake</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>immediate; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
- This option will attempt to use the <a id="wrglossary.3425"></a><a href="#glo:dual.shellescape">shell escape</a> to run the appropriate <a id="wrglossary.3426"></a><a href="#glo:dual.indexingapp">indexing application</a>. You will still need to run LaTeX twice. For example, if the document in the file <span class="filefmt">myDoc.tex</span> contains: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3427"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3428"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
-<a id="wrglossary.3429"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<a id="wrglossary.3430"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.3431"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.3432"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+ This is equivalent to <a id="wrglossary.3072"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.3073"></a><a href="#glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></a><span class="optfmt">=false</span>}</span> and may be used as a document class option.<p>
+<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
+<a id="wrglossary.3074"></a><code class="code"><dfn id="glo:opt.automake"><span class="styoptfmt">automake</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">default: </span>immediate; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+ This option will attempt to use the <a id="wrglossary.3075"></a><a href="#glo:dual.shellescape">shell escape</a> to run the appropriate <a id="wrglossary.3076"></a><a href="#glo:dual.indexingapp">indexing application</a>. You will still need to run LaTeX twice. For example, if the document in the file <span class="filefmt">myDoc.tex</span> contains: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3077"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<a id="wrglossary.3078"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.3079"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.3080"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.3081"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.3433"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}
-<a id="wrglossary.3434"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.3082"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}
+<a id="wrglossary.3083"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
-</pre> Then the document build is now: <pre class="terminal"><div class="terminaltitle"><a id="wrglossary.3435"></a><a href="#glo:sym.terminal"><span title="Terminal" class="icon">🔎</span></a></div>pdflatex myDoc
+</pre> Then the document build is now: <pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
pdflatex myDoc
-</pre> This will run <a id="wrglossary.3436"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> on every LaTeX run. If you have a large <a id="wrglossary.3437"></a><a href="#glo:dual.glossary">glossary</a> with a complex document build, this can end up being more time-consuming that simply running <a id="wrglossary.3438"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (either explicitly or via <a id="wrglossary.3439"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>) the minimum number of required times.<p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.3440"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that you will need to have the <a id="wrglossary.3441"></a><a href="#glo:dual.shellescape">shell escape</a> enabled (restricted mode for a direct call to <a id="wrglossary.3442"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and unrestricted mode for <a id="wrglossary.3443"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, <a id="wrglossary.3444"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.3445"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>). If you switch this option on and you are using LuaLaTeX, then the <a id="wrglossary.3446"></a><a href="#glo:pkg.shellesc"><span class="styfmt">shellesc</span></a> package will be loaded. </div><!-- end of important -->
+</pre> This will run <a id="wrglossary.3084"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> on every LaTeX run. If you have a large <a id="wrglossary.3085"></a><a href="#glo:dual.glossary">glossary</a> with a complex document build, this can end up being more time-consuming that simply running <a id="wrglossary.3086"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (either explicitly or via <a id="wrglossary.3087"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>) the minimum number of required times.<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Note that you will need to have the <a id="wrglossary.3088"></a><a href="#glo:dual.shellescape">shell escape</a> enabled (restricted mode for a direct call to <a id="wrglossary.3089"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and unrestricted mode for <a id="wrglossary.3090"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, <a id="wrglossary.3091"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.3092"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>). If you switch this option on and you are using LuaLaTeX, then the <a id="wrglossary.3093"></a><a href="#glo:pkg.shellesc"><span class="styfmt">shellesc</span></a> package will be loaded. </div><!-- end of important -->
<p>
-If this option doesn’t seem to work, open the <a id="wrglossary.3447"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file in your text editor and search for “<code class="qtt">runsystem</code>”. For example, if the document is in a file called <span class="filefmt">myDoc.tex</span> and it has: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3448"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3449"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
-</pre> and you run LaTeX in restricted mode, then if call was successful, you should find the following line in the file <span class="filefmt">myDoc.log</span>: <pre class="transcript"><div class="transcripttitle"><a id="wrglossary.3450"></a><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>runsystem(makeindex -s myDoc.ist -t myDoc.glg -o myDoc.gls myDoc.glo)...executed safely (allowed).
-</pre> The parentheses immediately after “<code class="qtt">runsystem</code>” show how the command was called. The bit after the three dots <code class="code">...</code> indicates whether or not the command was run and, if so, whether it was successful. In the above case, it has <span class="qt">“executed safely (allowed)”</span>. This means that it was allowed to run in restricted mode because <a id="wrglossary.3451"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is on the list of trusted applications.<p>
-If you change the package option to: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.3452"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3453"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3454"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a>]{glossaries}
-</pre> and rerun LaTeX in restricted mode, then the line in <span class="filefmt">myDoc.log</span> will now be: <pre class="transcript"><div class="transcripttitle"><a id="wrglossary.3455"></a><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>runsystem(makeglossaries myDoc)...disabled (restricted).
-</pre> This indicates that an attempt was made to run <a id="wrglossary.3456"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> (rather than a direct call to <a id="wrglossary.3457"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>), which isn’t permitted in restricted mode. There will be a similar message with <a id="wrglossary.3458"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3459"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a> or if the <a id="wrglossary.3460"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option is used. These cases require the unrestricted <a id="wrglossary.3461"></a><a href="#glo:dual.shellescape">shell escape</a>. <p>
-<div class="important"><div class="importanttitle"><a id="wrglossary.3462"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Think carefully before enabling unrestricted mode. Do you trust all the packages your document is loading (either explicitly or implicitly via another package)? Do you trust any code that you have copied and pasted from some third party? First compile your document in restricted mode (or with the <a id="wrglossary.3463"></a><a href="#glo:dual.shellescape">shell escape</a> disabled) and search the <a id="wrglossary.3464"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file for “<code class="qtt">runsystem</code>” to find out exactly what system calls are being attempted. </div><!-- end of important -->
+If this option doesn’t seem to work, open the <a id="wrglossary.3094"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file in your text editor and search for “<code class="qtt">runsystem</code>”. For example, if the document is in a file called <span class="filefmt">myDoc.tex</span> and it has: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3095"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+</pre> and you run LaTeX in restricted mode, then if call was successful, you should find the following line in the file <span class="filefmt">myDoc.log</span>: <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>runsystem(makeindex -s myDoc.ist -t myDoc.glg -o myDoc.gls myDoc.glo)...executed safely (allowed).
+</pre> The parentheses immediately after “<code class="qtt">runsystem</code>” show how the command was called. The bit after the three dots <code class="code">...</code> indicates whether or not the command was run and, if so, whether it was successful. In the above case, it has <span class="qt">“executed safely (allowed)”</span>. This means that it was allowed to run in restricted mode because <a id="wrglossary.3096"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is on the list of trusted applications.<p>
+If you change the package option to: <pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.3097"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3098"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a>]{glossaries}
+</pre> and rerun LaTeX in restricted mode, then the line in <span class="filefmt">myDoc.log</span> will now be: <pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>runsystem(makeglossaries myDoc)...disabled (restricted).
+</pre> This indicates that an attempt was made to run <a id="wrglossary.3099"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> (rather than a direct call to <a id="wrglossary.3100"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>), which isn’t permitted in restricted mode. There will be a similar message with <a id="wrglossary.3101"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3102"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a> or if the <a id="wrglossary.3103"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option is used. These cases require the unrestricted <a id="wrglossary.3104"></a><a href="#glo:dual.shellescape">shell escape</a>. <p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Think carefully before enabling unrestricted mode. Do you trust all the packages your document is loading (either explicitly or implicitly via another package)? Do you trust any code that you have copied and pasted from some third party? First compile your document in restricted mode (or with the <a id="wrglossary.3105"></a><a href="#glo:dual.shellescape">shell escape</a> disabled) and search the <a id="wrglossary.3106"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file for “<code class="qtt">runsystem</code>” to find out exactly what system calls are being attempted. </div><!-- end of important -->
<p>
-If the document is compiled in unrestricted mode, the corresponding line in the <a id="wrglossary.3465"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file should now be: <pre class="transcript"><div class="transcripttitle"><a id="wrglossary.3466"></a><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>runsystem(makeglossaries myDoc)...executed.
-</pre> This means that <a id="wrglossary.3467"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> was run. If it has <span class="qt">“failed”</span> instead of <span class="qt">“executed”</span>, then it means there was a fatal error. Note that just because the <a id="wrglossary.3468"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file has <span class="qt">“executed”</span> doesn’t mean that the application ran without a problem as there may have been some warnings or non-fatal errors. If you get any unexpected results, check the <a id="wrglossary.3469"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file (for example, the <a id="wrglossary.3470"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a> file, <span class="filefmt">myDoc.glg</span> in the above, for the <a id="wrglossary.3471"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3472"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3473"></a><a id="wrglossary.3474"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
- No attempt is made to use the <a id="wrglossary.3475"></a><a href="#glo:dual.shellescape">shell escape</a>.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3476"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3477"></a><a id="wrglossary.3478"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.true"><span class="optfmt">true</span></dfn></code><span class="floatrightbox"><a id="wrglossary.3479"></a><a href="#glo:sym.deprecated">Deprecated</a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
- This is now a deprecated synonym for <a id="wrglossary.3480"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3481"></a><a href="#glo:optval.automake.delayed"><span class="optfmt">delayed</span></a>. This used to be the default if the value to <a id="wrglossary.3482"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a> wasn’t supplied, but the default switched to the less problematic <a id="wrglossary.3483"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3484"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> in version 4.50.<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3485"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3486"></a><a id="wrglossary.3487"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.delayed"><span class="optfmt">delayed</span></dfn></code></div><!-- end of optionvaluebox -->
- A direct call to <a id="wrglossary.3488"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3489"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for each non-empty <a id="wrglossary.3490"></a><a href="#glo:dual.glossary">glossary</a> will be made at the end of the document using a delayed write to ensure that the <a id="wrglossary.3491"></a><a href="#glo:dual.glossary">glossary</a> files are complete. (It’s necessary to delay writing to the <a id="wrglossary.3492"></a><a href="#glo:dual.indexingfile">indexing files</a> in order to ensure that <a id="wrglossary.3493"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> is correct.) Unfortunately, there are situations where the delayed write never occurs, for example, if there are floats on the final page. In those cases, it’s better to use an immediate write (any of the following options).<p>
-<div class="optionvaluebox"><div class="optionvalueboxtitle"><a id="wrglossary.3494"></a><a href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3495"></a><a id="wrglossary.3496"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.immediate"><span class="optfmt">immediate</span></dfn></code></div><!-- end of optionvaluebox -->
- A direct call to <a id="wrglossary.3497"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3498"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for each non-empty <a id="wrglossary.3499"></a><a href="#glo:dual.glossary">glossary</a> will be made at the start of <a id="wrglossary.3500"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write. This ensures that the <a id="wrglossary.3501"></a><a href="#glo:dual.indexingfile">indexing files</a> are read by the <a id="wrglossary.3502"></a><a href="#glo:dual.indexingapp">indexing application</a> before they are opened (which will clear their content).<p>
@@ Diff output truncated at 1234567 characters. @@
More information about the tex-live-commits
mailing list.