texlive[74424] branches/branch2024.final: glossaries (branch)
commits+karl at tug.org
commits+karl at tug.org
Mon Mar 3 22:24:29 CET 2025
Revision: 74424
https://tug.org/svn/texlive?view=revision&revision=74424
Author: karl
Date: 2025-03-03 22:24:28 +0100 (Mon, 03 Mar 2025)
Log Message:
-----------
glossaries (branch) (3mar25)
Modified Paths:
--------------
branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries
branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/CHANGES
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/README.md
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-code.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user.tex
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.tex
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.html
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.tex
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/glossary-lipsum-examples.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/minimalgls.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/mwe-acr-desc.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/mwe-acr.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/mwe-gls.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-FnDesc.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-chap-hyperfirst.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-crossref.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-custom-acronym.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-dot-abbr.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-dual.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-entrycount.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-entryfmt.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-font-abbr.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-ignored.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-index.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-inline.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-langdict.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-newkeys.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-noidxapp-utf8.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-noidxapp.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-nomathhyper.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-numberlist.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-prefix.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-si.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-storage-abbr-desc.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample-storage-abbr.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sample4col.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleAcr.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleAcrDesc.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleCustomAcr.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleDB.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleDesc.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleEq.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleEqPg.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleFnAcrDesc.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleNtn.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/samplePeople.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleSec.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleSort.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleaccsupp.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleacronyms.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampletree.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/sampleutf8.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy2.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy3.pdf
branches/branch2024.final/Master/texmf-dist/doc/man/man1/makeglossaries-lite.1
branches/branch2024.final/Master/texmf-dist/doc/man/man1/makeglossaries-lite.man1.pdf
branches/branch2024.final/Master/texmf-dist/doc/man/man1/makeglossaries.1
branches/branch2024.final/Master/texmf-dist/doc/man/man1/makeglossaries.man1.pdf
branches/branch2024.final/Master/texmf-dist/scripts/glossaries/glossaries.l2h
branches/branch2024.final/Master/texmf-dist/scripts/glossaries/makeglossaries
branches/branch2024.final/Master/texmf-dist/scripts/glossaries/makeglossaries-lite.lua
branches/branch2024.final/Master/texmf-dist/source/latex/glossaries/glossaries.dtx
branches/branch2024.final/Master/texmf-dist/source/latex/glossaries/glossaries.ins
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/base/glossaries-babel.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/base/glossaries-compatible-207.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/base/glossaries-compatible-307.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/base/glossaries-polyglossia.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/base/glossaries-prefix.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/base/glossaries.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/expl/glossaries-accsupp.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-2022-11-03.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-2024-04-03.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-accsupp-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-accsupp-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-babel-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-babel-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-207-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-207-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-307-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-compatible-307-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-polyglossia-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-polyglossia-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-prefix-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossaries-prefix-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-hypernav-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-hypernav-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-hypernav-2022-11-03.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-inline-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-inline-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-list-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-list-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-long-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-long-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longbooktabs-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longbooktabs-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longragged-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-longragged-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-mcols-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-mcols-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-super-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-super-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-superragged-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-superragged-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-tree-2020-03-19.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/rollback/glossary-tree-2021-11-01.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-hypernav.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-inline.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-list.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-long.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-longbooktabs.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-longragged.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-mcols.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-super.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-superragged.sty
branches/branch2024.final/Master/texmf-dist/tex/latex/glossaries/styles/glossary-tree.sty
Added Paths:
-----------
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex
Modified: branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries
===================================================================
--- branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2025-03-03 21:24:28 UTC (rev 74424)
@@ -2,7 +2,7 @@
# File : makeglossaries
# Author : Nicola Talbot
-# Version : 4.55
+# Version : 4.56
# Description: simple Perl script that calls makeindex or xindy.
# Intended for use with "glossaries.sty" (saves having to remember
# all the various switches)
@@ -31,10 +31,10 @@
# glossaries-babel.sty, glossaries-polyglossia.sty, glossaries.l2h.
# Also makeglossaries and makeglossaries-lite.lua.
-my $version="4.55 (2024-11-01)";
+my $version="4.56 (2025-03-03)";
# History:
-# v4.51 - v4.55:
+# v4.51 - v4.56:
# * No change. (Version number updated in line with glossaries.sty)
# v4.50:
# * Added -e (don't fix encap clashes)
Modified: branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua
===================================================================
--- branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2025-03-03 21:24:28 UTC (rev 74424)
@@ -36,7 +36,7 @@
Also makeglossaries and makeglossaries-lite.lua.
History:
- * 4.48 - 4.55:
+ * 4.48 - 4.56:
- 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.55 (2024-11-01)"
+thisversion = "4.56 (2025-03-03)"
quiet = false
dryrun = false
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/CHANGES
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/CHANGES 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/CHANGES 2025-03-03 21:24:28 UTC (rev 74424)
@@ -1,5 +1,11 @@
glossaries change log:
+v4.56 (2025-03-03)
+
+ * glossaries.sty:
+
+ - corrections to \printnoidxglossary when used with datatool v3.0+
+
v4.55 (2024-11-01):
* glossaries.sty:
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/README.md
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/README.md 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/README.md 2025-03-03 21:24:28 UTC (rev 74424)
@@ -1,4 +1,4 @@
-# glossaries v4.55 (2024-11-01)
+# glossaries v4.56 (2025-03-03)
Author: Nicola Talbot ([contact](http://www.dickimaw-books.com/contact))
@@ -8,7 +8,7 @@
See http://www.ctan.org/license/lppl1.3
for the details of that license.
-Copyright 2007-2024 Nicola Talbot
+Copyright 2007-2025 Nicola Talbot
## DESCRIPTION
@@ -21,8 +21,6 @@
a database of terms where only terms used in the text will be added
to the relevant glossary.
-*This package replaces the glossary package which is now obsolete.*
-
### Included supplementary files:
- glossaries-prefix.sty: allows for the inclusion of a prefix (such
@@ -117,3 +115,4 @@
xspace.sty. This needs to be explicitly loaded in your document if
required. (Not recommended.)
+**This package replaces the glossary package which is now obsolete (2006).**
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-code.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.png
===================================================================
(Binary files differ)
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
===================================================================
(Binary files differ)
Index: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf 2025-03-03 21:24:28 UTC (rev 74424)
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
===================================================================
(Binary files differ)
Index: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png 2025-03-03 21:24:28 UTC (rev 74424)
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex (rev 0)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex 2025-03-03 21:24:28 UTC (rev 74424)
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-user.pdf
+% Example 22 Simple document with acronyms
+% Label: "ex:simpleacronyms"
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries}
+\setacronymstyle{long-short}
+\newacronym{html}{HTML}{hypertext markup language}
+\newacronym{xml}{XML}{extensible markup language}
+\begin{document}
+First use: \gls{html} and \gls{xml}.
+
+Next use: \gls{html} and \gls{xml}.
+\end{document}
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
===================================================================
(Binary files differ)
Index: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf 2025-03-03 21:24:28 UTC (rev 74424)
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
===================================================================
(Binary files differ)
Index: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png 2025-03-03 21:24:28 UTC (rev 74424)
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex (rev 0)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex 2025-03-03 21:24:28 UTC (rev 74424)
@@ -0,0 +1,17 @@
+% This file is embedded in glossaries-user.pdf
+% Example 23 Defining and Using an Acronym
+% Label: "ex:newacronym"
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries}
+\setacronymstyle{long-short}
+\newacronym{idn}{IDN}{identification number}
+\begin{document}
+First use: \gls{idn}. Next use: \gls{idn}.
+
+\glsreset{idn}% reset first use
+ The \gls{idn}['s] prefix is a capital letter.
+Next use: the \gls{idn}['s] prefix is a capital letter.
+\end{document}
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.png
===================================================================
(Binary files differ)
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
===================================================================
(Binary files differ)
Index: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf 2025-03-03 21:24:28 UTC (rev 74424)
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
===================================================================
(Binary files differ)
Index: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png 2025-03-03 21:24:28 UTC (rev 74424)
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex (rev 0)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex 2025-03-03 21:24:28 UTC (rev 74424)
@@ -0,0 +1,32 @@
+% This file is embedded in glossaries-user.pdf
+% Example 30 Don't index entries that are only used once
+% Label: "sec:entrycount"
+% arara: pdflatex
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[acronym]{glossaries}
+\makeglossaries
+
+\glsenableentrycount
+
+\setacronymstyle{long-short}
+
+\newacronym{html}{HTML}{hypertext markup language}
+\newacronym{css}{CSS}{cascading style sheets}
+\newacronym{xml}{XML}{extensible markup language}
+\newacronym{sql}{SQL}{structured query language}
+\newacronym{rdbms}{RDBMS}{relational database management system}
+\newacronym{rdsms}{RDSMS}{relational data stream management system}
+\begin{document}
+These entries are only used once: \cgls{sql}, \cgls{rdbms},
+\cgls{xml}. These entries are used multiple times:
+\cgls{html}, \cgls{html}, \cgls{css}, \cgls{css}, \cgls{css},
+\cgls{rdsms}, \cgls{rdsms}.
+
+\printglossaries
+\end{document}
Property changes on: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.png
===================================================================
(Binary files differ)
Modified: branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html
===================================================================
--- branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2025-03-03 21:23:41 UTC (rev 74423)
+++ branches/branch2024.final/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2025-03-03 21:24:28 UTC (rev 74424)
@@ -4471,9 +4471,7 @@
-
-
-<title>User Manual for glossaries.sty v4.55</title>
+<title>User Manual for glossaries.sty v4.56</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;}
@@ -4770,6 +4768,7 @@
div.nlctuserguideidx0 {border-style: none; margin-left: 0.000000pt; }
div.nlctuserguideidx1 {border-style: none; margin-left: 20.000000pt; }
div.nlctuserguideidx2 {border-style: none; margin-left: 40.000000pt; }
+div.nlctuserguideidx3 {border-style: none; margin-left: 60.000000pt; }
div.nlctusernavbox {border-style: none; }
div.abstractheader {font-weight: bold; text-align: center; border-style: none; }
span.crossreftag {font-style: italic; font-variant: normal; border-style: none; }
@@ -4795,8 +4794,8 @@
<body>
<div id="main">
-<header><div class="title">User Manual for glossaries.sty v4.55</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">2024-11-01</div><!-- end of date --></header>
+<header><div class="title">User Manual for glossaries.sty v4.56</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">2025-03-03</div><!-- end of date --></header>
<p>
<p>
@@ -4895,7 +4894,7 @@
<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.55”</span>.
+<span class="qt">“Documented Code for glossaries v4.56”</span>.
</dd>
<p>
@@ -5302,51 +5301,51 @@
<li class="toc-chapter"><a href="#cmdsummary">Command Summary</a></li><!-- end of toc-chapter -->
<ul>
-<li class="toc-section"><a href="#summary.index@">Command Summary: @</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.indexglssymbols">Command Summary: Symbols</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index6553600">Command Summary: A</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index6815744">Command Summary: A</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index6619136">Command Summary: B</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index6881280">Command Summary: B</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index6684672">Command Summary: C</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index6946816">Command Summary: C</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index6750208">Command Summary: D</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7012352">Command Summary: D</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index6815744">Command Summary: E</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7077888">Command Summary: E</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index6881280">Command Summary: F</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7143424">Command Summary: F</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index6946816">Command Summary: G</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7208960">Command Summary: G</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7012352">Command Summary: Glo</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7274496">Command Summary: Glo</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7077888">Command Summary: Gls</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7340032">Command Summary: Gls</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7143424">Command Summary: Glsxtr</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7405568">Command Summary: Glsxtr</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7208960">Command Summary: H</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7471104">Command Summary: H</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7274496">Command Summary: I</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7536640">Command Summary: I</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7471104">Command Summary: L</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7733248">Command Summary: L</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7536640">Command Summary: M</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7798784">Command Summary: M</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7602176">Command Summary: N</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7864320">Command Summary: N</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7667712">Command Summary: O</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7929856">Command Summary: O</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7733248">Command Summary: P</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index7995392">Command Summary: P</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7864320">Command Summary: R</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index8126464">Command Summary: R</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7929856">Command Summary: S</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index8192000">Command Summary: S</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index7995392">Command Summary: T</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index8257536">Command Summary: T</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index8192000">Command Summary: W</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index8454144">Command Summary: W</a></li><!-- end of toc-section -->
-<li class="toc-section"><a href="#summary.index8257536">Command Summary: X</a></li><!-- end of toc-section -->
+<li class="toc-section"><a href="#summary.index8519680">Command Summary: X</a></li><!-- end of toc-section -->
</ul>
<li class="toc-chapter"><a href="#envsummary">Environment Summary</a></li><!-- end of toc-chapter -->
@@ -5770,6 +5769,18 @@
<h2><!-- start of section header -->1.1. Rollback<span class="labellink"><a href="#sec:rollback">[link]</a></span></h2><!-- end of section header -->
<p>
+<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
+Rollback provides a useful way of reverting back to an earlier
+release if there’s a problem with a new version. However,
+the further away the rollback date is from the current LaTeX kernel,
+the more likely that incompatibilities will occur.
+If you have historic documents that you need to compile, consider
+using the historic TeX Live Docker images.
+(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>.)
+</div><!-- end of important -->
+
+<p>
The following rollback releases are available:
<p>
@@ -6181,7 +6192,7 @@
value contains <a id="wrglossary.307"></a><a href="#glo:dual.exlatinchar">extended Latin characters</a> or <a id="wrglossary.308"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>.
However, if you have both
<a id="wrglossary.309"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> v3.0+ and <span class="styfmt">datatool-english</span>
-installed, and at least <a id="wrglossary.310"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.55, then make sure you
+installed, and at least <a id="wrglossary.310"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.56, then make sure you
specify the locale. 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>[locales=en]{datatool-base}
<code class="cmd">\usepackage</code>{glossaries}
@@ -7604,11 +7615,12 @@
LaTeX, <a id="wrglossary.1205"></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.1206"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> currently (version 1.6.1 at the time of writing)
-can’t pick up languages specified
-using <a id="wrglossary.1207"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> <a id="wrglossary.1208"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>. In the event that
-<a id="wrglossary.1209"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t detect the language, use the <a id="wrglossary.1210"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>
-or <a id="wrglossary.1211"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a> package option.
+<p>
+You will needed at least version 1.6.4 of <a id="wrglossary.1206"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> to
+support <a id="wrglossary.1207"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> <a id="wrglossary.1208"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>. All instances of
+<a id="wrglossary.1209"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a> need to occur before <a id="wrglossary.1210"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is loaded.
+In the event that <a id="wrglossary.1211"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t detect the language, use the <a id="wrglossary.1212"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>
+or <a id="wrglossary.1213"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</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.
@@ -7615,54 +7627,46 @@
</div><!-- end of important -->
<p>
-For example (using <a id="wrglossary.1212"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>):
+For example (using <a id="wrglossary.1214"></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>{article}
<code class="cmd">\usepackage</code>[german]{babel}
<code class="cmd">\usepackage</code>{glossaries}
</pre>
This can pick up the language setting but will also automatically
-load <a id="wrglossary.1213"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>. Compare this with:
+load <a id="wrglossary.1215"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>. Compare this with:
<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>[german]{babel}
<code class="cmd">\usepackage</code>{glossaries-extra}
</pre>
This will pick up the language setting but won’t automatically load
-<a id="wrglossary.1214"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>.
+<a id="wrglossary.1216"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>.
<p>
-In both the above cases, <a id="wrglossary.1215"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> will automatically
+In both the above cases, <a id="wrglossary.1217"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> will automatically
be loaded and the language-sensitive commands provided by
-<a id="wrglossary.1216"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will use the definitions in
-<a id="wrglossary.1217"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> (which needs to be installed
+<a id="wrglossary.1218"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will use the definitions in
+<a id="wrglossary.1219"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> (which needs to be installed
separately).
<p>
-In the event that <a id="wrglossary.1218"></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.1219"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> or <a id="wrglossary.1220"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</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.1221"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>{french}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1222"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a><span class="optfmt">={french}</span>]{glossaries}
-</pre>
-<p>
Another example (no language 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>[german]{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1223"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1220"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span>]{glossaries}
</pre>
-The above document doesn’t load <a id="wrglossary.1224"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1225"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> or
-<a id="wrglossary.1226"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, but the <a id="wrglossary.1227"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span> setting will
-ensure that <a id="wrglossary.1228"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is loaded, which will pick up the
+The above document doesn’t load <a id="wrglossary.1221"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1222"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> or
+<a id="wrglossary.1223"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, but the <a id="wrglossary.1224"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span> setting will
+ensure that <a id="wrglossary.1225"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is loaded, which will pick up the
document class option.
<p>
-Alternatively, using the <a id="wrglossary.1229"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</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.1230"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a><span class="optfmt">={de-DE,en-GB}</span>]{glossaries}
+Alternatively, using the <a id="wrglossary.1226"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</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.1227"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a><span class="optfmt">={de-DE,en-GB}</span>]{glossaries}
</pre>
-This will required both <a id="wrglossary.1231"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> and
-<a id="wrglossary.1232"></a><a href="#glo:file.glossaries-english.ldf"><span class="filefmt">glossaries-english.ldf</span></a> to be installed.
-Note that the <a id="wrglossary.1233"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a> option is a synonym of the
-<a id="wrglossary.1234"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> option, but semantically <a id="wrglossary.1235"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a> makes more
+This will required both <a id="wrglossary.1228"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> and
+<a id="wrglossary.1229"></a><a href="#glo:file.glossaries-english.ldf"><span class="filefmt">glossaries-english.ldf</span></a> to be installed.
+Note that the <a id="wrglossary.1230"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a> option is a synonym of the
+<a id="wrglossary.1231"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> option, but semantically <a id="wrglossary.1232"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a> makes more
sense when using language identifiers that include regions.
<p>
Note that if another package has already been loaded that uses
-<a id="wrglossary.1236"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>, then the list of supported locales will be picked
+<a id="wrglossary.1233"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>, then the list of supported locales will be picked
up from that 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>[de-DE,en-GB]{datetime2}
<code class="cmd">\usepackage</code>{glossaries}
@@ -7669,95 +7673,95 @@
</pre>
<p>
The best method to sort terms that use an
-<a id="wrglossary.1237"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or <a id="wrglossary.1238"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a> is with
-<a id="wrglossary.1239"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1240"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. This means using a
-<a id="wrglossary.1241"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file to store the entry data (see <a id="wrglossary.1242"></a><a href="#glo:idx.opt.b2g">Option 4</a>). If you
-prefer to only use the base <a id="wrglossary.1243"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, then <a id="wrglossary.1244"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
-(<a id="wrglossary.1245"></a><a href="#glo:idx.opt.xdy">Option 3</a>) is the best option, but be aware that <a id="wrglossary.1246"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
-is a general purpose <a id="wrglossary.1247"></a><a href="#glo:dual.indexingapp">indexing application</a> that’s developed
-independently of <a id="wrglossary.1248"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> (as opposed to <a id="wrglossary.1249"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>,
+<a id="wrglossary.1234"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or <a id="wrglossary.1235"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a> is with
+<a id="wrglossary.1236"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1237"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. This means using a
+<a id="wrglossary.1238"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file to store the entry data (see <a id="wrglossary.1239"></a><a href="#glo:idx.opt.b2g">Option 4</a>). If you
+prefer to only use the base <a id="wrglossary.1240"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, then <a id="wrglossary.1241"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+(<a id="wrglossary.1242"></a><a href="#glo:idx.opt.xdy">Option 3</a>) is the best option, but be aware that <a id="wrglossary.1243"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+is a general purpose <a id="wrglossary.1244"></a><a href="#glo:dual.indexingapp">indexing application</a> that’s developed
+independently of <a id="wrglossary.1245"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> (as opposed to <a id="wrglossary.1246"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>,
which is specifically designed for, and developed alongside,
-<a id="wrglossary.1250"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and therefore provides better integration).
+<a id="wrglossary.1247"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and therefore provides better integration).
<p>
-Note also that <a id="wrglossary.1251"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can support any language provided by
-the <a id="wrglossary.1252"></a><a href="#glo:cldr">CLDR</a>, whereas <a id="wrglossary.1253"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> only has a limited number of
+Note also that <a id="wrglossary.1248"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can support any language provided by
+the <a id="wrglossary.1249"></a><a href="#glo:cldr">CLDR</a>, whereas <a id="wrglossary.1250"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> only has a limited number of
built-in languages (although more can be added).
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-If you are using a non-Latin script with <a id="wrglossary.1254"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, you may need the
-<a id="wrglossary.1255"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a> option or use
-<a id="wrglossary.1256"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a> to indicate the first
-<a id="wrglossary.1257"></a><a href="#glo:idx.group">letter group</a> that should follow the number <a id="wrglossary.1258"></a><a href="#glo:idx.group">group</a>.
+If you are using a non-Latin script with <a id="wrglossary.1251"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, you may need the
+<a id="wrglossary.1252"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a> option or use
+<a id="wrglossary.1253"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a> to indicate the first
+<a id="wrglossary.1254"></a><a href="#glo:idx.group">letter group</a> that should follow the number <a id="wrglossary.1255"></a><a href="#glo:idx.group">group</a>.
</div><!-- end of information -->
<p>
<div class="marginright"><a id="ex:xindyutf8-backref">🖹</a><a href="#ex:xindyutf8">9</a></div>Example <a href="#ex:xindyutf8">9</a> demonstrates a document with
-<a id="wrglossary.1259"></a><a href="#glo:dual.utf8">UTF-8</a> characters that requires <a id="wrglossary.1260"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+<a id="wrglossary.1256"></a><a href="#glo:dual.utf8">UTF-8</a> characters that requires <a id="wrglossary.1257"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
If you try this example and encounter errors,
check that you have an up-to-date TeX distribution.
Note that with the modern LaTeX kernel, the default encoding is
-assumed to be <a id="wrglossary.1261"></a><a href="#glo:dual.utf8">UTF-8</a> so I haven’t bothered loading the
-<a id="wrglossary.1262"></a><a href="#glo:pkg.inputenc"><span class="styfmt">inputenc</span></a> package.
+assumed to be <a id="wrglossary.1258"></a><a href="#glo:dual.utf8">UTF-8</a> so I haven’t bothered loading the
+<a id="wrglossary.1259"></a><a href="#glo:pkg.inputenc"><span class="styfmt">inputenc</span></a> package.
<p>
<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>[T1]{fontenc}
<code class="cmd">\usepackage</code>[main=english,brazilian]{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1263"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1260"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
</pre>
-Note the use of the <a id="wrglossary.1264"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option, which ensures that
-all the <a id="wrglossary.1265"></a><a href="#glo:dual.indexing">indexing</a> information is written in the correct format.
+Note the use of the <a id="wrglossary.1261"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option, which ensures that
+all the <a id="wrglossary.1262"></a><a href="#glo:dual.indexing">indexing</a> information is written in the correct format.
<p>
This example is a multilingual document so a second
-<a id="wrglossary.1266"></a><a href="#glo:dual.glossary">glossary</a> is defined for the Brazilian terms:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1267"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{dictionary}{<a id="wrglossary.1268"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}
+<a id="wrglossary.1263"></a><a href="#glo:dual.glossary">glossary</a> is defined for the Brazilian terms:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1264"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{dictionary}{<a id="wrglossary.1265"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}
</pre>
I could just supply the actual title, but using the
-language-sensitive <a id="wrglossary.1269"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> (which is also the title
-provided for the main <a id="wrglossary.1270"></a><a href="#glo:dual.glossary">glossary</a>) demonstrates the language
+language-sensitive <a id="wrglossary.1266"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> (which is also the title
+provided for the main <a id="wrglossary.1267"></a><a href="#glo:dual.glossary">glossary</a>) demonstrates the language
support.
<p>
This document will need to have both <span class="filefmt">glossaries-english</span>
and <span class="filefmt">glossaries-portuges</span> installed in addition to
-the base <a id="wrglossary.1271"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
+the base <a id="wrglossary.1268"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
<p>
-To ensure that the files required by <a id="wrglossary.1272"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are opened:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1273"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+To ensure that the files required by <a id="wrglossary.1269"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are opened:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1270"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
</pre>
Now define some English terms:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1274"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{élite}{<a id="wrglossary.1275"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
-<a id="wrglossary.1276"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
-<a id="wrglossary.1277"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elephant}{<a id="wrglossary.1278"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elephant}</span>,
-<a id="wrglossary.1279"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large animal with trunk and tusks}</span>}
-<a id="wrglossary.1280"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elk}{<a id="wrglossary.1281"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elk}</span>, <a id="wrglossary.1282"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large deer}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1271"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{élite}{<a id="wrglossary.1272"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+<a id="wrglossary.1273"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+<a id="wrglossary.1274"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elephant}{<a id="wrglossary.1275"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elephant}</span>,
+<a id="wrglossary.1276"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large animal with trunk and tusks}</span>}
+<a id="wrglossary.1277"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elk}{<a id="wrglossary.1278"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elk}</span>, <a id="wrglossary.1279"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large deer}</span>}
</pre>
And here are the terms that need to go in the custom <span class="qt">“dictionary”</span>
glossary:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1283"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{água}{<a id="wrglossary.1284"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={água}</span>,
-<a id="wrglossary.1285"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
-<a id="wrglossary.1286"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={water}</span>}
-<a id="wrglossary.1287"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{árvore}{<a id="wrglossary.1288"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={árvore}</span>,
-<a id="wrglossary.1289"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
-<a id="wrglossary.1290"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={tree}</span>}
-<a id="wrglossary.1291"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ano}{<a id="wrglossary.1292"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ano}</span>,
-<a id="wrglossary.1293"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
-<a id="wrglossary.1294"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={year}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1280"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{água}{<a id="wrglossary.1281"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={água}</span>,
+<a id="wrglossary.1282"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
+<a id="wrglossary.1283"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={water}</span>}
+<a id="wrglossary.1284"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{árvore}{<a id="wrglossary.1285"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={árvore}</span>,
+<a id="wrglossary.1286"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
+<a id="wrglossary.1287"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={tree}</span>}
+<a id="wrglossary.1288"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ano}{<a id="wrglossary.1289"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ano}</span>,
+<a id="wrglossary.1290"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
+<a id="wrglossary.1291"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={year}</span>}
</pre>
The main body of the document contains references using the labels
-provided in the first argument of <a id="wrglossary.1295"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and the
-<a id="wrglossary.1296"></a><a href="#glo:dual.glossary">glossary</a> lists are placed at the desired location, at the end
+provided in the first argument of <a id="wrglossary.1292"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and the
+<a id="wrglossary.1293"></a><a href="#glo:dual.glossary">glossary</a> lists are placed at the desired location, at the end
of each section:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cbeg">\begin{document}</code>
<code class="cmd">\section</code>{English}
-An <a id="wrglossary.1297"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elk} and an <a id="wrglossary.1298"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elephant} belonged to an
-<a id="wrglossary.1299"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{élite} group.
+An <a id="wrglossary.1294"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elk} and an <a id="wrglossary.1295"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elephant} belonged to an
+<a id="wrglossary.1296"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{élite} group.
-<a id="wrglossary.1300"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>
+<a id="wrglossary.1297"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>
<code class="cmd">\selectlanguage</code>{brazilian}
<code class="cmd">\section</code>{Brasileiro}
-A <a id="wrglossary.1301"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{árvore} tive <a id="wrglossary.1302"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{água} este <a id="wrglossary.1303"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ano}.
+A <a id="wrglossary.1298"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{árvore} tive <a id="wrglossary.1299"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{água} este <a id="wrglossary.1300"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ano}.
-<a id="wrglossary.1304"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[type=dictionary]
+<a id="wrglossary.1301"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[type=dictionary]
<code class="cend">\end{document}</code>
</pre>
If the document is saved in the file <span class="filefmt">myDoc.tex</span> then the
@@ -7769,86 +7773,86 @@
<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#ex:xindyutf8-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:xindyutf8"></a>Example 9: UTF-8 and <span class="appfmt">xindy</span> <a href="glossaries-user-examples/glossaries-user-example009.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example009.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
<p>
-<object data="glossaries-user-examples/glossaries-user-example009.png" type="image/png" width="261" height="351">Example document that defines a term with a UTF-8
+<object data="glossaries-user-examples/glossaries-user-example009.png" type="image/png" width="261" height="349">Example document that defines a term with a UTF-8
character.</object>
</div><!-- end of resultbox -->
<p>
-<div class="sidenote"><a id="wrglossary.1305"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+<div class="sidenote"><a id="wrglossary.1302"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
<div class="marginright"><a id="ex:bib2glsutf8-backref">🖹</a><a href="#ex:bib2glsutf8">10</a></div>Example <a href="#ex:bib2glsutf8">10</a> is a modification of
-the previous example which uses <a id="wrglossary.1306"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (and therefore
-requires <a id="wrglossary.1307"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). The entry data must now be provided
-in one or more <a id="wrglossary.1308"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. For example, the file
+the previous example which uses <a id="wrglossary.1303"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (and therefore
+requires <a id="wrglossary.1304"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). The entry data must now be provided
+in one or more <a id="wrglossary.1305"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files. For example, the file
<span class="filefmt">sample-utf8-en.bib</span> contains:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% Encoding: UTF-8</span>
<code class="code">@entry</code>{élite,
- <a id="wrglossary.1309"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
- <a id="wrglossary.1310"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>
+ <a id="wrglossary.1306"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+ <a id="wrglossary.1307"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>
}
<code class="code">@entry</code>{elephant,
- <a id="wrglossary.1311"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elephant}</span>,
- <a id="wrglossary.1312"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large animal with trunk and tusks}</span>
+ <a id="wrglossary.1308"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elephant}</span>,
+ <a id="wrglossary.1309"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large animal with trunk and tusks}</span>
}
<code class="code">@entry</code>{elk,
- <a id="wrglossary.1313"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elk}</span>,
- <a id="wrglossary.1314"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large deer}</span>
+ <a id="wrglossary.1310"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elk}</span>,
+ <a id="wrglossary.1311"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={large deer}</span>
}
</pre>
and the file <span class="filefmt">sample-utf8-pt.bib</span> contains:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% Encoding: UTF-8</span>
<code class="code">@entry</code>{água,
- <a id="wrglossary.1315"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={água}</span>,
- <a id="wrglossary.1316"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={water}</span>
+ <a id="wrglossary.1312"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={água}</span>,
+ <a id="wrglossary.1313"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={water}</span>
}
<code class="code">@entry</code>{árvore,
- <a id="wrglossary.1317"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={árvore}</span>,
- <a id="wrglossary.1318"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={tree}</span>
+ <a id="wrglossary.1314"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={árvore}</span>,
+ <a id="wrglossary.1315"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={tree}</span>
}
<code class="code">@entry</code>{ano,
- <a id="wrglossary.1319"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ano}</span>,
- <a id="wrglossary.1320"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={year}</span>
+ <a id="wrglossary.1316"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ano}</span>,
+ <a id="wrglossary.1317"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={year}</span>
}
</pre>
<p>
-The document now requires <a id="wrglossary.1321"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> with the
-<a id="wrglossary.1322"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option:
+The document now requires <a id="wrglossary.1318"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> with the
+<a id="wrglossary.1319"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</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">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[T1]{fontenc}
<code class="cmd">\usepackage</code>[main=english,brazilian]{babel}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.1323"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1320"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
</pre>
As before a custom glossary is defined:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1324"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{dictionary}{<a id="wrglossary.1325"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1321"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{dictionary}{<a id="wrglossary.1322"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}
</pre>
-Instead of using <a id="wrglossary.1326"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>, the document now needs:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1327"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[
- <a id="wrglossary.1328"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en</span>,<span class="comment">% sort according to English language rules</span>
- <a id="wrglossary.1329"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-utf8-en}</span><span class="comment">% data in sample-utf8-en.bib</span>
+Instead of using <a id="wrglossary.1323"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>, the document now needs:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1324"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.1325"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en</span>,<span class="comment">% sort according to English language rules</span>
+ <a id="wrglossary.1326"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-utf8-en}</span><span class="comment">% data in sample-utf8-en.bib</span>
]
-<a id="wrglossary.1330"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[
- <a id="wrglossary.1331"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=pt-BR</span>,<span class="comment">% sort according to pt-BR language rules</span>
- <a id="wrglossary.1332"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-utf8-pt}</span>,<span class="comment">% data in sample-utf8-pt.bib</span>
- <a id="wrglossary.1333"></a><a href="#glo:opt.resource.type"><span class="xtrcsoptfmt">type</span></a><span class="optfmt">=dictionary</span>
+<a id="wrglossary.1327"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.1328"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=pt-BR</span>,<span class="comment">% sort according to pt-BR language rules</span>
+ <a id="wrglossary.1329"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-utf8-pt}</span>,<span class="comment">% data in sample-utf8-pt.bib</span>
+ <a id="wrglossary.1330"></a><a href="#glo:opt.resource.type"><span class="xtrcsoptfmt">type</span></a><span class="optfmt">=dictionary</span>
]
</pre>
The main body of the document is similar to the previous example,
-but a different command is needed to display the <a id="wrglossary.1334"></a><a href="#glo:dual.glossary">glossary</a>.
+but a different command is needed to display the <a id="wrglossary.1331"></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="cbeg">\begin{document}</code>
<code class="cmd">\section</code>{English}
-An <a id="wrglossary.1335"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elk} and an <a id="wrglossary.1336"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elephant} belonged to an
-<a id="wrglossary.1337"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{élite} group.
+An <a id="wrglossary.1332"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elk} and an <a id="wrglossary.1333"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elephant} belonged to an
+<a id="wrglossary.1334"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{élite} group.
-<a id="wrglossary.1338"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+<a id="wrglossary.1335"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
<code class="cmd">\selectlanguage</code>{brazilian}
<code class="cmd">\section</code>{Brasileiro}
-A <a id="wrglossary.1339"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{árvore} tive <a id="wrglossary.1340"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{água} este <a id="wrglossary.1341"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ano}.
+A <a id="wrglossary.1336"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{árvore} tive <a id="wrglossary.1337"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{água} este <a id="wrglossary.1338"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ano}.
-<a id="wrglossary.1342"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>[type=dictionary]
+<a id="wrglossary.1339"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>[type=dictionary]
<code class="cend">\end{document}</code>
</pre>
The document build is slightly different:
@@ -7859,69 +7863,69 @@
<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#ex:bib2glsutf8-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:bib2glsutf8"></a>Example 10: UTF-8 and <span class="appfmt">bib2gls</span> <a href="glossaries-user-examples/glossaries-user-example010.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example010.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
<p>
-<object data="glossaries-user-examples/glossaries-user-example010.png" type="image/png" width="261" height="349">Example UTF-8 document that defines terms in bib
+<object data="glossaries-user-examples/glossaries-user-example010.png" type="image/png" width="595" height="842">Example UTF-8 document that defines terms in bib
files.</object>
</div><!-- end of resultbox -->
<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.1343"></a><a href="#glo:dual.nonlatinchar">non-Latin character</a>, such as é, looks like a
-plain character in your <a id="wrglossary.1344"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file, with pdfLaTeX it’s
+Note that although a <a id="wrglossary.1340"></a><a href="#glo:dual.nonlatinchar">non-Latin character</a>, such as é, looks like a
+plain character in your <a id="wrglossary.1341"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file, with pdfLaTeX 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.1345"></a><a href="#glo:dual.utf8">UTF-8</a>.) Recent versions of the LaTeX kernel have
-made significant improvements in handling <a id="wrglossary.1346"></a><a href="#glo:dual.utf8">UTF-8</a>. To ensure you have the best
-<a id="wrglossary.1347"></a><a href="#glo:dual.utf8">UTF-8</a> support, use at least <a id="wrglossary.1348"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ with
-<a id="wrglossary.1349"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ (and, if required, <a id="wrglossary.1350"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
-v1.49+). With old TeX distributions, you can’t use <a id="wrglossary.1351"></a><a href="#glo:dual.utf8">UTF-8</a>
+support <a id="wrglossary.1342"></a><a href="#glo:dual.utf8">UTF-8</a>.) Recent versions of the LaTeX kernel have
+made significant improvements in handling <a id="wrglossary.1343"></a><a href="#glo:dual.utf8">UTF-8</a>. To ensure you have the best
+<a id="wrglossary.1344"></a><a href="#glo:dual.utf8">UTF-8</a> support, use at least <a id="wrglossary.1345"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ with
+<a id="wrglossary.1346"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ (and, if required, <a id="wrglossary.1347"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+v1.49+). With old TeX distributions, you can’t use <a id="wrglossary.1348"></a><a href="#glo:dual.utf8">UTF-8</a>
characters in labels.
</div><!-- end of important -->
<p>
-With old versions of <a id="wrglossary.1352"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> (pre v2.08), if you use a <a id="wrglossary.1353"></a><a href="#glo:dual.utf8">UTF-8</a>
-character at the start of an <a id="wrglossary.1354"></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.1355"></a><a href="#glo:idx.sentencecase">sentence case</a> commands
-(e.g. <a id="wrglossary.1356"></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.1357"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07:</span>
-<a id="wrglossary.1358"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.1359"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
-<a id="wrglossary.1360"></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.1349"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> (pre v2.08), if you use a <a id="wrglossary.1350"></a><a href="#glo:dual.utf8">UTF-8</a>
+character at the start of an <a id="wrglossary.1351"></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.1352"></a><a href="#glo:idx.sentencecase">sentence case</a> commands
+(e.g. <a id="wrglossary.1353"></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.1354"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07:</span>
+<a id="wrglossary.1355"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.1356"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
+<a id="wrglossary.1357"></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.1361"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.1362"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>
-v2.08+, and with a newer LaTeX kernel the <a id="wrglossary.1363"></a><a href="#glo:dual.utf8">UTF-8</a> character may
+This isn’t necessary with <a id="wrglossary.1358"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.1359"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>
+v2.08+, and with a newer LaTeX kernel the <a id="wrglossary.1360"></a><a href="#glo:dual.utf8">UTF-8</a> character may
occur in the label:
-<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.1364"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08:</span>
-<a id="wrglossary.1365"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{élite}{<a id="wrglossary.1366"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
-<a id="wrglossary.1367"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+<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.1361"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08:</span>
+<a id="wrglossary.1362"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{élite}{<a id="wrglossary.1363"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+<a id="wrglossary.1364"></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.1368"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1369"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the application needs
-to know the <a id="wrglossary.1370"></a><a href="#glo:idx.encoding">encoding</a> of the <a id="wrglossary.1371"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file. This information
-is added to the <a id="wrglossary.1372"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and can be picked up by
-<a id="wrglossary.1373"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and <a id="wrglossary.1374"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
+If you are using <a id="wrglossary.1365"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1366"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the application needs
+to know the <a id="wrglossary.1367"></a><a href="#glo:idx.encoding">encoding</a> of the <a id="wrglossary.1368"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file. This information
+is added to the <a id="wrglossary.1369"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and can be picked up by
+<a id="wrglossary.1370"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and <a id="wrglossary.1371"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
<p>
-Note that <a id="wrglossary.1375"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> doesn’t support <a id="wrglossary.1376"></a><a href="#glo:dual.utf8">UTF-8</a> so, although it
-can be used with some <a id="wrglossary.1377"></a><a href="#glo:dual.latinalph">Latin alphabet</a> languages, you will need to ensure
-that the sort value doesn’t contain any <a id="wrglossary.1378"></a><a href="#glo:dual.utf8">UTF-8</a>.
-If you have the double-quote character (<a id="wrglossary.1379"></a><a href="#glo:idx.sym.dblquote"><code class="code">"</code></a>) as an
-active character (for example, a <a id="wrglossary.1380"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> shorthand) and you
-want to use <a id="wrglossary.1381"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.1382"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> (German) option, you’ll
-need to change <a id="wrglossary.1383"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> quote character using:
+Note that <a id="wrglossary.1372"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> doesn’t support <a id="wrglossary.1373"></a><a href="#glo:dual.utf8">UTF-8</a> so, although it
+can be used with some <a id="wrglossary.1374"></a><a href="#glo:dual.latinalph">Latin alphabet</a> languages, you will need to ensure
+that the sort value doesn’t contain any <a id="wrglossary.1375"></a><a href="#glo:dual.utf8">UTF-8</a>.
+If you have the double-quote character (<a id="wrglossary.1376"></a><a href="#glo:idx.sym.dblquote"><code class="code">"</code></a>) as an
+active character (for example, a <a id="wrglossary.1377"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> shorthand) and you
+want to use <a id="wrglossary.1378"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.1379"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> (German) option, you’ll
+need to change <a id="wrglossary.1380"></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.1384"></a><code class="code"><dfn id="glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code>
+<a id="wrglossary.1381"></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.1385"></a><a href="#glo:idx.sym.questionmark"><code class="code">?</code> (question mark)</a>,
-<a id="wrglossary.1386"></a><a href="#glo:idx.sym.pipe"><code class="code">|</code> (pipe)</a> or <a id="wrglossary.1387"></a><a href="#glo:idx.sym.exclammark"><code class="code">!</code> (exclamation mark)</a>.
+Note that <span class="meta">〈<em class="metainner">character</em>〉</span> may not be one of <a id="wrglossary.1382"></a><a href="#glo:idx.sym.questionmark"><code class="code">?</code> (question mark)</a>,
+<a id="wrglossary.1383"></a><a href="#glo:idx.sym.pipe"><code class="code">|</code> (pipe)</a> or <a id="wrglossary.1384"></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.1388"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1385"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
</pre>
-This must be done before <a id="wrglossary.1389"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and any entry
-definitions. It’s only applicable for <a id="wrglossary.1390"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. This option
+This must be done before <a id="wrglossary.1386"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and any entry
+definitions. It’s only applicable for <a id="wrglossary.1387"></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.1391"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to use the <a id="wrglossary.1392"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> switch when invoking
-<a id="wrglossary.1393"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.
+<a id="wrglossary.1388"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to use the <a id="wrglossary.1389"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> switch when invoking
+<a id="wrglossary.1390"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</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">\documentclass</code>{article}
@@ -7928,18 +7932,18 @@
<code class="cmd">\usepackage</code>[ngerman]{babel}
<code class="cmd">\usepackage</code>{glossaries}
-<a id="wrglossary.1394"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
+<a id="wrglossary.1391"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
-<a id="wrglossary.1395"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1392"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<a id="wrglossary.1396"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{rna}{name=ribonukleinsäure,
- <a id="wrglossary.1397"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={ribonukleins"aure}</span>,
- <a id="wrglossary.1398"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={eine Nukleinsäure}</span>}
+<a id="wrglossary.1393"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{rna}{name=ribonukleinsäure,
+ <a id="wrglossary.1394"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={ribonukleins"aure}</span>,
+ <a id="wrglossary.1395"></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.1399"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{rna}
+<a id="wrglossary.1396"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{rna}
-<a id="wrglossary.1400"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.1397"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
</pre>
<p>
@@ -7952,40 +7956,40 @@
<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.1401"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1402"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> that uses caption
+package such as <a id="wrglossary.1398"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1399"></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.1403"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1404"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>, you need to use their
+are using <a id="wrglossary.1400"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1401"></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.1405"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1406"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>
-documentation. If you have loaded <a id="wrglossary.1407"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, then <a id="wrglossary.1408"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
-will attempt to load <a id="wrglossary.1409"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, unless you have used the
-<a id="wrglossary.1410"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>, <a id="wrglossary.1411"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=false</span> or
-<a id="wrglossary.1412"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>
+the words babel uses</a> or read the <a id="wrglossary.1402"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1403"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>
+documentation. If you have loaded <a id="wrglossary.1404"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, then <a id="wrglossary.1405"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+will attempt to load <a id="wrglossary.1406"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, unless you have used the
+<a id="wrglossary.1407"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>, <a id="wrglossary.1408"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=false</span> or
+<a id="wrglossary.1409"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>
package options.
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.1413"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.1410"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.1414"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package defaults to
-<a id="wrglossary.1415"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> if <a id="wrglossary.1416"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded.
+The <a id="wrglossary.1411"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package defaults to
+<a id="wrglossary.1412"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> if <a id="wrglossary.1413"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded.
</div><!-- end of information -->
<p>
-If the <a id="wrglossary.1417"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is loaded, the
+If the <a id="wrglossary.1414"></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 the
-<a id="wrglossary.1418"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package for advice on changing translations provided by
-<a id="wrglossary.1419"></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.1420"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s
-interface using <a id="wrglossary.1421"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>:
+<a id="wrglossary.1415"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package for advice on changing translations provided by
+<a id="wrglossary.1416"></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.1417"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s
+interface using <a id="wrglossary.1418"></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.1422"></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.1419"></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.1423"></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.1424"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> rather that using
+and then use <a id="wrglossary.1420"></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.1421"></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.1425"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, then <a id="wrglossary.1426"></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.1427"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s
+<a id="wrglossary.1422"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, then <a id="wrglossary.1423"></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.1424"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s
caption hooks will be used instead.
<p>
<div class="table">
@@ -8042,12 +8046,12 @@
<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.1428"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. You only need to install the
+the <a id="wrglossary.1425"></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="https://www.dickimaw-books.com/contact">https://www.dickimaw-books.com/contact</a>. The
-<a id="wrglossary.1429"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary files for <a id="wrglossary.1430"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> are now
+<a id="wrglossary.1426"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary files for <a id="wrglossary.1427"></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.
@@ -8056,23 +8060,23 @@
<ul class="displaylist">
-<li><span class="bulletitem">•</span>Using <a id="wrglossary.1431"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.1432"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>:
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1428"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.1429"></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.1433"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> is automatically loaded).
+(<a id="wrglossary.1430"></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.1434"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>:
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1431"></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.1435"></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.1432"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
</pre>
-(<a id="wrglossary.1436"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> isn’t loaded). The <a id="wrglossary.1437"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package
-has <a id="wrglossary.1438"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> as the default if <a id="wrglossary.1439"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been
+(<a id="wrglossary.1433"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> isn’t loaded). The <a id="wrglossary.1434"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package
+has <a id="wrglossary.1435"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> as the default if <a id="wrglossary.1436"></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.1440"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>:
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1437"></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}
@@ -8083,24 +8087,24 @@
</ul>
<p>
-Due to the varied nature of <a id="wrglossary.1441"></a><a href="#glo:dual.glossary">glossaries</a>, it’s likely that the
+Due to the varied nature of <a id="wrglossary.1438"></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.1442"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> package and the <a id="wrglossary.1443"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option
-<a id="wrglossary.1444"></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 id="wrglossary.1439"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> package and the <a id="wrglossary.1440"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option
+<a id="wrglossary.1441"></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.1445"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>
+the words babel uses</a>. If you are using the <a id="wrglossary.1442"></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.1446"></a><a href="#glo:dual.glossary">glossary</a>, you can use the <a id="wrglossary.1447"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key in
-commands like <a id="wrglossary.1448"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (but not the iterative commands
-like <a id="wrglossary.1449"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>).
+<a id="wrglossary.1443"></a><a href="#glo:dual.glossary">glossary</a>, you can use the <a id="wrglossary.1444"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key in
+commands like <a id="wrglossary.1445"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (but not the iterative commands
+like <a id="wrglossary.1446"></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.1450"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionaries are loaded at the beginning of the
+Note that the <a id="wrglossary.1447"></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.1451"></a><a href="#glo:idx.preamble/document">preamble</a>. It should be put in your personal dictionary
-instead (as in the example below). See the <a id="wrglossary.1452"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>
+in the <a id="wrglossary.1448"></a><a href="#glo:idx.preamble/document">preamble</a>. It should be put in your personal dictionary
+instead (as in the example below). See the <a id="wrglossary.1449"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>
documentation for further details.
</div><!-- end of important -->
@@ -8109,7 +8113,7 @@
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.1453"></a><a href="#glo:dual.locationlist">location list</a> should be labelled
+<span class="qt">“Nomenclature”</span> and the <a id="wrglossary.1450"></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:
@@ -8124,25 +8128,25 @@
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.1454"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and don’t want to use the
-<a id="wrglossary.1455"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> interface, you can use the package
-option <a id="wrglossary.1456"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>. For example:
+If you are using <a id="wrglossary.1451"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and don’t want to use the
+<a id="wrglossary.1452"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> interface, you can use the package
+option <a id="wrglossary.1453"></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.1457"></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.1454"></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.1458"></a><a href="#glo:captionslanguage"><code class="csfmt">\captionsbritish</code></a>{<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1459"></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.1460"></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.1455"></a><a href="#glo:captionslanguage"><code class="csfmt">\captionsbritish</code></a>{<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1456"></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.1457"></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.1461"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1462"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> provide much better
-multi-lingual support than <a id="wrglossary.1463"></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.1464"></a><a href="#glo:dual.glossary">glossary</a> entries that
-contain <a id="wrglossary.1465"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>. See §<a href="#sec:xindy">14</a> for further
-details on <a id="wrglossary.1466"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, and see the <a id="wrglossary.1467"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for
+Note that <a id="wrglossary.1458"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1459"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> provide much better
+multi-lingual support than <a id="wrglossary.1460"></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.1461"></a><a href="#glo:dual.glossary">glossary</a> entries that
+contain <a id="wrglossary.1462"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>. See §<a href="#sec:xindy">14</a> for further
+details on <a id="wrglossary.1463"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, and see the <a id="wrglossary.1464"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for
further details of that application.
<p>
@@ -8152,19 +8156,19 @@
<h3><!-- start of subsection header -->1.5.2. Creating a New Language Module<span class="labellink"><a href="#sec:newlang">[link]</a></span></h3><!-- end of subsection header -->
<p>
-The <a id="wrglossary.1468"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package now uses the <a id="wrglossary.1469"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package
+The <a id="wrglossary.1465"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package now uses the <a id="wrglossary.1466"></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.1470"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> documentation.
+<a id="wrglossary.1467"></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.1471"></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.1472"></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
+files called: <a id="wrglossary.1468"></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.1469"></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.1473"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> (for example, <code class="code">English</code>).
+<a id="wrglossary.1470"></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.1474"></a><a href="#glo:file.glossaries-dictionary-English.dict"><span class="filefmt">glossaries-dictionary-English.dict</span></a>:
+Here’s an example of <a id="wrglossary.1471"></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}
@@ -8177,56 +8181,56 @@
<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.1475"></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.1476"></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>)
+<code class="code">English</code> to the <a id="wrglossary.1472"></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.1473"></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.1477"></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.1478"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{english}
+Here’s an example of <a id="wrglossary.1474"></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.1475"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{english}
-<a id="wrglossary.1479"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{English}
+<a id="wrglossary.1476"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{English}
{<span class="comment">% </span>
- <a id="wrglossary.1480"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1481"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
- <a id="wrglossary.1482"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1483"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1477"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1478"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1479"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1480"></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.1484"></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.1485"></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.1486"></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.1487"></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.1488"></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.1489"></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.1490"></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.1491"></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.1481"></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.1482"></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.1483"></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.1484"></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.1485"></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.1486"></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.1487"></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.1488"></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.1492"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Glossary}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1493"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acronyms}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1494"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Notation}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1495"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Description}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1496"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Symbol}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1497"></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.1498"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Symbols}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1499"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{Numbers}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1489"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Glossary}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1490"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acronyms}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1491"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Notation}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1492"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Description}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1493"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Symbol}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1494"></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.1495"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Symbols}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1496"></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.1500"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1497"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
{<span class="comment">% </span>
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1501"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1498"></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.1502"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1499"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
{<span class="comment">% </span>
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1503"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1500"></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>
@@ -8236,12 +8240,12 @@
}<span class="comment">% </span>
<code class="cmd">\glossariescaptionsenglish</code>
}
-<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1504"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}{s}
-<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1505"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a>}{<a id="wrglossary.1506"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}
-<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1507"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a>}{<a id="wrglossary.1508"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a>{<a id="wrglossary.1509"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1501"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}{s}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1502"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a>}{<a id="wrglossary.1503"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1504"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a>}{<a id="wrglossary.1505"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a>{<a id="wrglossary.1506"></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.1510"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>
+template. Replace <code class="code">English</code> with the <a id="wrglossary.1507"></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
@@ -8249,39 +8253,39 @@
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.1511"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> (for
-general entries). For <a id="wrglossary.1512"></a><a href="#glo:idx.acronym">acronyms</a> defined with the base
-<a id="wrglossary.1513"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, <a id="wrglossary.1514"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a> is used for the
-<a id="wrglossary.1515"></a><a href="#glo:dual.smallcaps">small caps</a> <a id="wrglossary.1516"></a><a href="#glo:idx.acronymstyle">acronym styles</a> where the suffix needs to be
-set using <a id="wrglossary.1517"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a> to counteract the effects of <a id="wrglossary.1518"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>
-and <a id="wrglossary.1519"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a> for other <a id="wrglossary.1520"></a><a href="#glo:idx.acronymstyle">acronym styles</a>.
+hasn’t been specified are given by <a id="wrglossary.1508"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> (for
+general entries). For <a id="wrglossary.1509"></a><a href="#glo:idx.acronym">acronyms</a> defined with the base
+<a id="wrglossary.1510"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, <a id="wrglossary.1511"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a> is used for the
+<a id="wrglossary.1512"></a><a href="#glo:dual.smallcaps">small caps</a> <a id="wrglossary.1513"></a><a href="#glo:idx.acronymstyle">acronym styles</a> where the suffix needs to be
+set using <a id="wrglossary.1514"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a> to counteract the effects of <a id="wrglossary.1515"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>
+and <a id="wrglossary.1516"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a> for other <a id="wrglossary.1517"></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.1521"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> configuration.
+on the <a id="wrglossary.1518"></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.1522"></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 implemented
+the <a id="wrglossary.1519"></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 implemented
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.1523"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>,
-<a id="wrglossary.1524"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a>, <a id="wrglossary.1525"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> etc keys to override
+suffix required in your document and use the <a id="wrglossary.1520"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>,
+<a id="wrglossary.1521"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a>, <a id="wrglossary.1522"></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.1526"></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
+<a id="wrglossary.1523"></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.1527"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{en-GB}
- <a id="wrglossary.1528"></a><a href="#glo:RequireGlossariesLang"><code class="csfmt">\RequireGlossariesLang</code></a>{english}
- <a id="wrglossary.1529"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{British}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1524"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{en-GB}
+ <a id="wrglossary.1525"></a><a href="#glo:RequireGlossariesLang"><code class="csfmt">\RequireGlossariesLang</code></a>{english}
+ <a id="wrglossary.1526"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{British}
{<span class="comment">% </span>
- <a id="wrglossary.1530"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1531"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
- <a id="wrglossary.1532"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1533"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1527"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1528"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1529"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1530"></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>
@@ -8296,23 +8300,23 @@
}
</pre>
<p>
-If the translations includes <a id="wrglossary.1534"></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.1535"></a><a href="#glo:idx.encoding">encoding</a>. Remember that
-while some users may use <a id="wrglossary.1536"></a><a href="#glo:dual.utf8">UTF-8</a> (and it’s now the default
-<a id="wrglossary.1537"></a><a href="#glo:idx.encoding">encoding</a> with modern LaTeX kernels), others may use Latin-1 or any other
-supported <a id="wrglossary.1538"></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.1539"></a><a href="#glo:dual.utf8">UTF-8</a> version.
+If the translations includes <a id="wrglossary.1531"></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.1532"></a><a href="#glo:idx.encoding">encoding</a>. Remember that
+while some users may use <a id="wrglossary.1533"></a><a href="#glo:dual.utf8">UTF-8</a> (and it’s now the default
+<a id="wrglossary.1534"></a><a href="#glo:idx.encoding">encoding</a> with modern LaTeX kernels), others may use Latin-1 or any other
+supported <a id="wrglossary.1535"></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.1536"></a><a href="#glo:dual.utf8">UTF-8</a> version.
<p>
-The <a id="wrglossary.1540"></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.1541"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{irish}
+The <a id="wrglossary.1537"></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.1538"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{irish}
-<a id="wrglossary.1542"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{Irish}
+<a id="wrglossary.1539"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{Irish}
{<span class="comment">% </span>
- <a id="wrglossary.1543"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1544"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
- <a id="wrglossary.1545"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1546"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1540"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1541"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1542"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1543"></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.1547"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>}{utf8}
+ <code class="cmd">\ifdefstring</code>{<a id="wrglossary.1544"></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>
@@ -8319,17 +8323,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.1548"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1545"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
{<span class="comment">% </span>
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1549"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1546"></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.1550"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1547"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
{
- <code class="cmd">\csappto</code>{captions<a id="wrglossary.1551"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1548"></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>
@@ -8342,11 +8346,11 @@
</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.1552"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary label.)
+<a id="wrglossary.1549"></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.1553"></a><a href="#glo:idx.encoding">encoding</a> information)
-and <span class="filefmt">glossaries-irish-utf8.ldf</span> (<a id="wrglossary.1554"></a><a href="#glo:dual.utf8">UTF-8</a>).
+(no <a id="wrglossary.1550"></a><a href="#glo:idx.encoding">encoding</a> information)
+and <span class="filefmt">glossaries-irish-utf8.ldf</span> (<a id="wrglossary.1551"></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:
@@ -8353,31 +8357,31 @@
<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.1555"></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.1556"></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.1557"></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.1558"></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.1559"></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.1560"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{<code class="cmd">\textirish</code>{Comhartha<a id="wrglossary.1561"></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.1562"></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.1563"></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.1552"></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.1553"></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.1554"></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.1555"></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.1556"></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.1557"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{<code class="cmd">\textirish</code>{Comhartha<a id="wrglossary.1558"></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.1559"></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.1560"></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.1564"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Gluais}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1565"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acrainmneacha}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1566"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Ciall}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1567"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Tuairisc}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1568"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Comhartha}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1569"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Comhartha<a id="wrglossary.1570"></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.1571"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{Leathanaigh}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1572"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}{Uimhreacha}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1561"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Gluais}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1562"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acrainmneacha}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1563"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Ciall}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1564"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Tuairisc}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1565"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Comhartha}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1566"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Comhartha<a id="wrglossary.1567"></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.1568"></a><a href="#glo:pagelistname"><code class="csfmt">\pagelistname</code></a>}{Leathanaigh}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1569"></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.1573"></a><a href="#glo:dual.utf8">UTF-8</a> characters.
+the appropriate <a id="wrglossary.1570"></a><a href="#glo:dual.utf8">UTF-8</a> characters.
<p>
</section><!-- end of section sec:newlang -->
@@ -8389,25 +8393,25 @@
<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.xdy">3</a>. You can
ignore this section if you have chosen any of the other options.
-(For <a id="wrglossary.1574"></a><a href="#glo:idx.opt.b2g">Option 4</a>, see the <a id="wrglossary.1575"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for details.)
+(For <a id="wrglossary.1571"></a><a href="#glo:idx.opt.b2g">Option 4</a>, see the <a id="wrglossary.1572"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for details.)
If you want to alphabetically sort your entries always remember to use the
-<a id="wrglossary.1576"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key if the <a id="wrglossary.1577"></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.1578"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>).
+<a id="wrglossary.1573"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key if the <a id="wrglossary.1574"></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.1575"></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.1579"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1580"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>,
-you can try using the <a id="wrglossary.1581"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a> package option, described in
+to run external tools like <a id="wrglossary.1576"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1577"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>,
+you can try using the <a id="wrglossary.1578"></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.1582"></a><a href="#glo:dual.shellescape">shell escape</a> enabled. See also
+<a id="wrglossary.1579"></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>.
-Since <a id="wrglossary.1583"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is on the trusted list, the restricted
-<a id="wrglossary.1584"></a><a href="#glo:dual.shellescape">shell escape</a> may be used, which is safer than the unrestricted
+Since <a id="wrglossary.1580"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is on the trusted list, the restricted
+<a id="wrglossary.1581"></a><a href="#glo:dual.shellescape">shell escape</a> may be used, which is safer than the unrestricted
mode. 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.1585"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
-<a id="wrglossary.1586"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</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.1582"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<a id="wrglossary.1583"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
</pre>
If the document source is in the file <span class="filefmt">myDoc.tex</span> then this
requires:
@@ -8417,8 +8421,8 @@
(you may find that <code class="code">-shell-restricted</code> is the default for your
system, in which case it may be omitted).
Whereas:
-<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.1587"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>,<a id="wrglossary.1588"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
-<a id="wrglossary.1589"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</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.1584"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>,<a id="wrglossary.1585"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<a id="wrglossary.1586"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
</pre>
requires:
<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex -shell-escape myDoc
@@ -8427,156 +8431,156 @@
Be aware that this unrestricted mode is a security risk, so it’s best
avoided.
<p>
-In order to generate a sorted <a id="wrglossary.1590"></a><a href="#glo:dual.glossary">glossary</a> with compact
-<a id="wrglossary.1591"></a><a href="#glo:locationlist">number lists</a>, it is necessary to use an external
-<a id="wrglossary.1592"></a><a href="#glo:dual.indexingapp">indexing application</a> as an intermediate step (<a id="wrglossary.1593"></a><a href="#glo:idx.opt.noidx">Option 1</a>, which
-uses TeX to do the sorting, can’t compact <a id="wrglossary.1594"></a><a href="#glo:locationlist">number lists</a>). It
+In order to generate a sorted <a id="wrglossary.1587"></a><a href="#glo:dual.glossary">glossary</a> with compact
+<a id="wrglossary.1588"></a><a href="#glo:locationlist">number lists</a>, it is necessary to use an external
+<a id="wrglossary.1589"></a><a href="#glo:dual.indexingapp">indexing application</a> as an intermediate step (<a id="wrglossary.1590"></a><a href="#glo:idx.opt.noidx">Option 1</a>, which
+uses TeX to do the sorting, can’t compact <a id="wrglossary.1591"></a><a href="#glo:locationlist">number lists</a>). It
is this application that creates the file containing the code
-required to typeset the <a id="wrglossary.1595"></a><a href="#glo:dual.glossary">glossary</a>. <strong class="strong">If this step is
-omitted, the <a id="wrglossary.1596"></a><a href="#glo:dual.glossary">glossaries</a> will not appear in your document.</strong>
+required to typeset the <a id="wrglossary.1592"></a><a href="#glo:dual.glossary">glossary</a>. <strong class="strong">If this step is
+omitted, the <a id="wrglossary.1593"></a><a href="#glo:dual.glossary">glossaries</a> will not appear in your document.</strong>
<p>
-The two oldest <a id="wrglossary.1597"></a><a href="#glo:dual.indexingapp">indexing applications</a> most commonly used with LaTeX are <a id="wrglossary.1598"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.1599"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The <span class="styfmt">glossaries</span> package
+The two oldest <a id="wrglossary.1594"></a><a href="#glo:dual.indexingapp">indexing applications</a> most commonly used with LaTeX are <a id="wrglossary.1595"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.1596"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The <span class="styfmt">glossaries</span> package
can be used with either of these applications. Any other application
-that can support <a id="wrglossary.1600"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> syntax and style file may be
-used instead of <a id="wrglossary.1601"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Simply follow the <a id="wrglossary.1602"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-instructions and substitute the call to <a id="wrglossary.1603"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with the
+that can support <a id="wrglossary.1597"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> syntax and style file may be
+used instead of <a id="wrglossary.1598"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Simply follow the <a id="wrglossary.1599"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+instructions and substitute the call to <a id="wrglossary.1600"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with the
appropriate call to the alternative.
<p>
-Commands that only have an effect when <a id="wrglossary.1604"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is used are
+Commands that only have an effect when <a id="wrglossary.1601"></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.1605"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> and
-<a id="wrglossary.1606"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>. With <a id="wrglossary.1607"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can just add special comments to
+document compilation using applications such as <a id="wrglossary.1602"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> and
+<a id="wrglossary.1603"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>. With <a id="wrglossary.1604"></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.1608"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> you need to set up the required dependencies.
+With <a id="wrglossary.1605"></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.1609"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with the Perl script
-<a id="wrglossary.1610"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> which will run <a id="wrglossary.1611"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1612"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
-on all the <a id="wrglossary.1613"></a><a href="#glo:dual.indexingfile">indexing files</a> using a customized style file (which is
-created by <a id="wrglossary.1614"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). See
+The <a id="wrglossary.1606"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with the Perl script
+<a id="wrglossary.1607"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> which will run <a id="wrglossary.1608"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1609"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+on all the <a id="wrglossary.1610"></a><a href="#glo:dual.indexingfile">indexing files</a> using a customized style file (which is
+created by <a id="wrglossary.1611"></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.1615"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1616"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a>). Most Unix-like
+<a id="wrglossary.1612"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1613"></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.1617"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1618"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+install Perl if you want to use <a id="wrglossary.1614"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1615"></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.1619"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>:
+The advantages of using <a id="wrglossary.1616"></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.1620"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
-<a id="wrglossary.1621"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and sets the relevant application switches.
+<li><span class="bulletitem">•</span>It automatically detects whether to use <a id="wrglossary.1617"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
+<a id="wrglossary.1618"></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.1622"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will run
-<a id="wrglossary.1623"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1624"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> for each <a id="wrglossary.1625"></a><a href="#glo:dual.glossary">glossary</a> type.
+<li><span class="bulletitem">•</span>One call of <a id="wrglossary.1619"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will run
+<a id="wrglossary.1620"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1621"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> for each <a id="wrglossary.1622"></a><a href="#glo:dual.glossary">glossary</a> type.
<p>
-<li><span class="bulletitem">•</span>If things go wrong, <a id="wrglossary.1626"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will scan the
-messages from <a id="wrglossary.1627"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1628"></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.1629"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This
+<li><span class="bulletitem">•</span>If things go wrong, <a id="wrglossary.1623"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will scan the
+messages from <a id="wrglossary.1624"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1625"></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.1626"></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.1630"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
-<a id="wrglossary.1631"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> messages.
+file and see if you can work it out from the <a id="wrglossary.1627"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
+<a id="wrglossary.1628"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> messages.
<p>
-<li><span class="bulletitem">•</span>If <a id="wrglossary.1632"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about <a id="wrglossary.1633"></a><a href="#glo:idx.multipleencap">multiple encap</a> values,
-<a id="wrglossary.1634"></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.1635"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when
-<a id="wrglossary.1636"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is used since <a id="wrglossary.1637"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> uses the order of the
-<a id="wrglossary.1638"></a><a href="#glo:idx.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.1639"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1629"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about <a id="wrglossary.1630"></a><a href="#glo:idx.multipleencap">multiple encap</a> values,
+<a id="wrglossary.1631"></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.1632"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when
+<a id="wrglossary.1633"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is used since <a id="wrglossary.1634"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> uses the order of the
+<a id="wrglossary.1635"></a><a href="#glo:idx.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.1636"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>
switch.
<p>
-<li><span class="bulletitem">•</span>If <a id="wrglossary.1640"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about invalid or
-<a id="wrglossary.1641"></a><a href="#glo:idx.emptylocation">empty locations</a>, <a id="wrglossary.1642"></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.1643"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> syntax.
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1637"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about invalid or
+<a id="wrglossary.1638"></a><a href="#glo:idx.emptylocation">empty locations</a>, <a id="wrglossary.1639"></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.1640"></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.1644"></a><a href="#glo:dual.locationlist">location list</a>, but it’s useful if the <a id="wrglossary.1645"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a> option
+<a id="wrglossary.1641"></a><a href="#glo:dual.locationlist">location list</a>, but it’s useful if the <a id="wrglossary.1642"></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.1646"></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.1647"></a><a href="#glo:dual.entrylocation">location</a>, <a id="wrglossary.1648"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> v4.50+
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1643"></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.1644"></a><a href="#glo:dual.entrylocation">location</a>, <a id="wrglossary.1645"></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.1649"></a><a href="#glo:locationencap">encap</a>.
+and into the <a id="wrglossary.1646"></a><a href="#glo:locationencap">encap</a>.
<p>
<li><span class="bulletitem">•</span>If the output directory has been set when running LaTeX (which puts all the associated files in another directory),
-<a id="wrglossary.1650"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> has a <a id="wrglossary.1651"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> switch that can be used to
-identify the output directory. This means that <a id="wrglossary.1652"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-can change to that directory before running <a id="wrglossary.1653"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-or <a id="wrglossary.1654"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+<a id="wrglossary.1647"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> has a <a id="wrglossary.1648"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> switch that can be used to
+identify the output directory. This means that <a id="wrglossary.1649"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+can change to that directory before running <a id="wrglossary.1650"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <a id="wrglossary.1651"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
</ul>
-The first two items also apply to <a id="wrglossary.1655"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.
+The first two items also apply to <a id="wrglossary.1652"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.
<p>
-As from version 4.16, the <a id="wrglossary.1656"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package also comes
-with a Lua script called <a id="wrglossary.1657"></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.1658"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl
+As from version 4.16, the <a id="wrglossary.1653"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package also comes
+with a Lua script called <a id="wrglossary.1654"></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.1655"></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.1659"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> so it’s an alternative to
-<a id="wrglossary.1660"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> if you want to use <a id="wrglossary.1661"></a><a href="#glo:idx.opt.mkidx">Option 2</a> (<a id="wrglossary.1662"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>).
+to use <a id="wrglossary.1656"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> so it’s an alternative to
+<a id="wrglossary.1657"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> if you want to use <a id="wrglossary.1658"></a><a href="#glo:idx.opt.mkidx">Option 2</a> (<a id="wrglossary.1659"></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.1663"></a><a href="#glo:dual.glossary">glossaries</a>
+If things go wrong and you can’t work out why your <a id="wrglossary.1660"></a><a href="#glo:dual.glossary">glossaries</a>
aren’t being generated correctly, you can use
-<a id="wrglossary.1664"></a><a href="#glo:app.makeglossariesgui"><span class="appfmt">makeglossariesgui</span></a> as a diagnostic tool. Once you’ve
+<a id="wrglossary.1661"></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.1665"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1666"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.
+<a id="wrglossary.1662"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1663"></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.1667"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-Perl script or the <a id="wrglossary.1668"></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.1669"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package without using those
+Whilst I strongly recommended that you use the <a id="wrglossary.1664"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+Perl script or the <a id="wrglossary.1665"></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.1666"></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.1670"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1671"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+have no effect if you explicitly run <a id="wrglossary.1667"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1668"></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.1672"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you
+If you are choosing not to use <a id="wrglossary.1669"></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.1673"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> as <a id="wrglossary.1674"></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.1675"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a>, so it’s
+<a id="wrglossary.1670"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> as <a id="wrglossary.1671"></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.1672"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a>, so it’s
well-worth the effort to install Perl.)
Alternatively, if you have Java installed,
-switch to <a id="wrglossary.1676"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1677"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
+switch to <a id="wrglossary.1673"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1674"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
</div><!-- end of important -->
<p>
-Below, references to <a id="wrglossary.1678"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> can usually be substituted
-with <a id="wrglossary.1679"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>, except where noted otherwise.
+Below, references to <a id="wrglossary.1675"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> can usually be substituted
+with <a id="wrglossary.1676"></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.1680"></a><a href="#glo:dual.glossary">glossary</a> (for example, the entry is only referenced in the
+the <a id="wrglossary.1677"></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.1681"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1682"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1683"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> run, as
+<a id="wrglossary.1678"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1679"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1680"></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.1684"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{citrusfruit}{<a id="wrglossary.1685"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={citrus fruit}</span>,
-<a id="wrglossary.1686"></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.1687"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{orange})}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1681"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{citrusfruit}{<a id="wrglossary.1682"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={citrus fruit}</span>,
+<a id="wrglossary.1683"></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.1684"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{orange})}</span>}
-<a id="wrglossary.1688"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{orange}{<a id="wrglossary.1689"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={orange}</span>,
-<a id="wrglossary.1690"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an orange coloured fruit.}</span>}
+<a id="wrglossary.1685"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{orange}{<a id="wrglossary.1686"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={orange}</span>,
+<a id="wrglossary.1687"></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.1691"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{citrusfruit}</code> in your document
+and suppose you have <code class="code"><a id="wrglossary.1688"></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.1692"></a><a href="#glo:dual.glossary">glossary</a> until
-you first create the <a id="wrglossary.1693"></a><a href="#glo:dual.glossary">glossary</a> and then do another run
-of <a id="wrglossary.1694"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1695"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1696"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+orange entry won’t appear in your <a id="wrglossary.1689"></a><a href="#glo:dual.glossary">glossary</a> until
+you first create the <a id="wrglossary.1690"></a><a href="#glo:dual.glossary">glossary</a> and then do another run
+of <a id="wrglossary.1691"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1692"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1693"></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
@@ -8585,22 +8589,22 @@
makeglossaries myDoc
pdflatex myDoc
</pre>
-(In the case of <a id="wrglossary.1697"></a><a href="#glo:idx.opt.b2g">Option 4</a>, <a id="wrglossary.1698"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will scan the description for
-instances of commands like <a id="wrglossary.1699"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to ensure they are selected but
-an extra <a id="wrglossary.1700"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call is required to ensure the <a id="wrglossary.1701"></a><a href="#glo:dual.entrylocation">locations</a> are
-included, if <a id="wrglossary.1702"></a><a href="#glo:dual.locationlist">location lists</a> are required. See the
-<a id="wrglossary.1703"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.)
+(In the case of <a id="wrglossary.1694"></a><a href="#glo:idx.opt.b2g">Option 4</a>, <a id="wrglossary.1695"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will scan the description for
+instances of commands like <a id="wrglossary.1696"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to ensure they are selected but
+an extra <a id="wrglossary.1697"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call is required to ensure the <a id="wrglossary.1698"></a><a href="#glo:dual.entrylocation">locations</a> are
+included, if <a id="wrglossary.1699"></a><a href="#glo:dual.locationlist">location lists</a> are required. See the
+<a id="wrglossary.1700"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.)
<p>
-Likewise, an additional <a id="wrglossary.1704"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and LaTeX run
+Likewise, an additional <a id="wrglossary.1701"></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.1705"></a><a href="#glo:locationlist">number lists</a> in the glossary may
+means that the <a id="wrglossary.1702"></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.1706"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1707"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1708"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> via a terminal.
+<a id="wrglossary.1703"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1704"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1705"></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
@@ -8613,7 +8617,7 @@
build</a>.
<p>
If any problems occur, remember to check the transcript files
-(e.g. <a id="wrglossary.1709"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a> or <a id="wrglossary.1710"></a><a href="#glo:ext.alg"><span class="extfmt">alg</span></a>) for messages.
+(e.g. <a id="wrglossary.1706"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a> or <a id="wrglossary.1707"></a><a href="#glo:ext.alg"><span class="extfmt">alg</span></a>) for messages.
<p>
<div class="table">
@@ -8658,13 +8662,13 @@
<h3><!-- start of subsection header -->1.6.1. Using the <span class="appfmt">makeglossaries</span> Perl Script<span class="labellink"><a href="#sec:makeglossariesapp">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1711"></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>
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1708"></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.1712"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script picks up the relevant information
-from the auxiliary (<a id="wrglossary.1713"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>) file and will either call
-<a id="wrglossary.1714"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1715"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, depending on the supplied
+The <a id="wrglossary.1709"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script picks up the relevant information
+from the auxiliary (<a id="wrglossary.1710"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>) file and will either call
+<a id="wrglossary.1711"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1712"></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.1716"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. For example, if your
+without the extension to <a id="wrglossary.1713"></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
@@ -8671,18 +8675,18 @@
makeglossaries myDoc
pdflatex myDoc
</pre>
-If you only want one <a id="wrglossary.1717"></a><a href="#glo:dual.glossary">glossary</a> processed (for example, if you
+If you only want one <a id="wrglossary.1714"></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.1718"></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.1719"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>, such as <a id="wrglossary.1720"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> for the <a id="wrglossary.1721"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>
+<a id="wrglossary.1715"></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.1716"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>, such as <a id="wrglossary.1717"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> for the <a id="wrglossary.1718"></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.1722"></a><a href="#glo:dual.glossary">glossaries</a> defined, then
-<a id="wrglossary.1723"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will tell you how many <a id="wrglossary.1724"></a><a href="#glo:dual.glossary">glossaries</a> have
-been ignored unless the <a id="wrglossary.1725"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> switch has been used.
+document has multiple <a id="wrglossary.1719"></a><a href="#glo:dual.glossary">glossaries</a> defined, then
+<a id="wrglossary.1720"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will tell you how many <a id="wrglossary.1721"></a><a href="#glo:dual.glossary">glossaries</a> have
+been ignored unless the <a id="wrglossary.1722"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> switch 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.1726"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script. MikTeX also
+wrapper for the <a id="wrglossary.1723"></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
@@ -8690,193 +8694,193 @@
<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.1727"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, make sure you also
-upgrade your version of <a id="wrglossary.1728"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. The current version is
-4.55.
+When upgrading the <a id="wrglossary.1724"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, make sure you also
+upgrade your version of <a id="wrglossary.1725"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. The current version is
+4.56.
</div><!-- end of important -->
<p>
-Some of the options are only applicable to <a id="wrglossary.1729"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some
-are only applicable to <a id="wrglossary.1730"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+Some of the options are only applicable to <a id="wrglossary.1726"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some
+are only applicable to <a id="wrglossary.1727"></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.1731"></a><code class="code"><dfn id="glo:switch.mkgls.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1728"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1732"></a><code class="code"><dfn id="glo:switch.mkgls.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1729"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1733"></a><code class="code"><dfn id="glo:switch.mkgls.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1730"></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.1734"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1735"></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.1736"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
+<a id="wrglossary.1731"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1732"></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.1733"></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.1737"></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 -->
+<a id="wrglossary.1734"></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.1738"></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.1739"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>,
-<a id="wrglossary.1740"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> etc files are located.
+Instructs <a id="wrglossary.1735"></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.1736"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>,
+<a id="wrglossary.1737"></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.1741"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> myTmpDir myDoc
+makeglossaries <a id="wrglossary.1738"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> myTmpDir myDoc
</pre>
<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.1742"></a><code class="code"><dfn id="glo:switch.mkgls.e"><span class="shortargfmt">-e</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1739"></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.1743"></a><a href="#glo:idx.multipleencap">multiple encaps</a> (only applicable with <a id="wrglossary.1744"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>).
+Don’t check for <a id="wrglossary.1740"></a><a href="#glo:idx.multipleencap">multiple encaps</a> (only applicable with <a id="wrglossary.1741"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>).
By default, if you are using
-<a id="wrglossary.1745"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, <a id="wrglossary.1746"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check the <a id="wrglossary.1747"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-transcript for <a id="wrglossary.1748"></a><a href="#glo:idx.multipleencap">multiple encap</a> warnings.
+<a id="wrglossary.1742"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, <a id="wrglossary.1743"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check the <a id="wrglossary.1744"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+transcript for <a id="wrglossary.1745"></a><a href="#glo:idx.multipleencap">multiple encap</a> warnings.
<p>
-The <a id="wrglossary.1749"></a><a href="#glo:idx.multipleencap">multiple encap</a> warning is where different <a id="wrglossary.1750"></a><a href="#glo:dual.locationencap">location encap</a>
-values (location formats) are used on the same <a id="wrglossary.1751"></a><a href="#glo:dual.entrylocation">location</a> for the
+The <a id="wrglossary.1746"></a><a href="#glo:idx.multipleencap">multiple encap</a> warning is where different <a id="wrglossary.1747"></a><a href="#glo:dual.locationencap">location encap</a>
+values (location formats) are used on the same <a id="wrglossary.1748"></a><a href="#glo:dual.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.1752"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1749"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<a id="wrglossary.1753"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.1754"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.1755"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.1750"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.1751"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.1752"></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.1756"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1757"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.1758"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=textbf</span>]{sample}.
-<a id="wrglossary.1759"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.1753"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1754"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.1755"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=textbf</span>]{sample}.
+<a id="wrglossary.1756"></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.1760"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, this will cause a warning and
-the <a id="wrglossary.1761"></a><a href="#glo:dual.locationlist">location list</a> will be <span class="qt">“1, <span style="font-weight: bold; ">1”</span>. That is, the page
+If you explicitly use <a id="wrglossary.1757"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, this will cause a warning and
+the <a id="wrglossary.1758"></a><a href="#glo:dual.locationlist">location list</a> will be <span class="qt">“1, <span style="font-weight: bold; ">1”</span>. That is, the page
number will be repeated with each format. As from v2.18,
-<a id="wrglossary.1762"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for this warning and, if found, will
+<a id="wrglossary.1759"></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.1763"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> from checking and correcting the
-duplicates with <a id="wrglossary.1764"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>.
+prevent <a id="wrglossary.1760"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> from checking and correcting the
+duplicates with <a id="wrglossary.1761"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>.
<p>
-There’s no similar check for <a id="wrglossary.1765"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as <a id="wrglossary.1766"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+There’s no similar check for <a id="wrglossary.1762"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as <a id="wrglossary.1763"></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.1767"></a><code class="code"><dfn id="glo:switch.mkgls.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1764"></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.1768"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script attempts to fork the
-<a id="wrglossary.1769"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1770"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> process using <code class="code">open()</code> on the
+The <a id="wrglossary.1765"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script attempts to fork the
+<a id="wrglossary.1766"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1767"></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.1771"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+help diagnose problems. If this method fails <a id="wrglossary.1768"></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.1772"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> switch
+redirection. Without this redirection, the <a id="wrglossary.1769"></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.1773"></a><code class="code"><dfn id="glo:switch.mkgls.Q"><span class="shortargfmt">-Q</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1770"></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.1774"></a><code class="code"><dfn id="glo:switch.mkgls.k"><span class="shortargfmt">-k</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1771"></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.1775"></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 -->
+<a id="wrglossary.1772"></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.1776"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> application. Only the name is required if it’s
+The <a id="wrglossary.1773"></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.1777"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files (including support for <a id="wrglossary.1778"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style
-files via <a id="wrglossary.1779"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a>), then you can use <a id="wrglossary.1780"></a><a href="#glo:switch.mkgls.m"><span class="shortargfmt">-m</span></a>
+<a id="wrglossary.1774"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files (including support for <a id="wrglossary.1775"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style
+files via <a id="wrglossary.1776"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a>), then you can use <a id="wrglossary.1777"></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.1781"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Note that both <a id="wrglossary.1782"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a> and <a id="wrglossary.1783"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> can
-read <a id="wrglossary.1784"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files using the default <a id="wrglossary.1785"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> syntax
+<a id="wrglossary.1778"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Note that both <a id="wrglossary.1779"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a> and <a id="wrglossary.1780"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> can
+read <a id="wrglossary.1781"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files using the default <a id="wrglossary.1782"></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.1786"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style files.
+<a id="wrglossary.1783"></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.1787"></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 -->
+<a id="wrglossary.1784"></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.1788"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application. Only the name is required if it’s
+The <a id="wrglossary.1785"></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.1789"></a><code class="code"><dfn id="glo:switch.mkgls.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1786"></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.1790"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to
-<a id="wrglossary.1791"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1792"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
+Compress intermediate blanks. This will pass <a id="wrglossary.1787"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to
+<a id="wrglossary.1788"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1789"></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.1793"></a><code class="code"><dfn id="glo:switch.mkgls.r"><span class="shortargfmt">-r</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1790"></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.1794"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1795"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to
-<a id="wrglossary.1796"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1797"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
+Disable implicit page <a id="wrglossary.1791"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1792"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to
+<a id="wrglossary.1793"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1794"></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.1798"></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 -->
+<a id="wrglossary.1795"></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.1799"></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.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.)
+<code class="code"><a id="wrglossary.1796"></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.1797"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.
+(Ignored if <a id="wrglossary.1798"></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.1802"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.
+the <a id="wrglossary.1799"></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.1803"></a><code class="code"><dfn id="glo:switch.mkgls.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1800"></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.1804"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> 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> ord/letorder</code> to <a id="wrglossary.1807"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+Use letter ordering. This will pass <a id="wrglossary.1801"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1802"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <code class="code"><a id="wrglossary.1803"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1804"></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.1808"></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 -->
+<a id="wrglossary.1805"></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.1809"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1810"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+The language to pass to <a id="wrglossary.1806"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1807"></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.1811"></a><code class="code"><dfn id="glo:switch.mkgls.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1808"></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.1812"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to
-<a id="wrglossary.1813"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1814"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
+Employ German word ordering. This will pass <a id="wrglossary.1809"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to
+<a id="wrglossary.1810"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1811"></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.1815"></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 -->
+<a id="wrglossary.1812"></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.1816"></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.1817"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-or <code class="code"><a id="wrglossary.1818"></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.1819"></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.1820"></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.1821"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>
-when <a id="wrglossary.1822"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called, or if the extension isn’t
-<a id="wrglossary.1823"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> when <a id="wrglossary.1824"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.
+<code class="code"><a id="wrglossary.1813"></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.1814"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <code class="code"><a id="wrglossary.1815"></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.1816"></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.1817"></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.1818"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>
+when <a id="wrglossary.1819"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called, or if the extension isn’t
+<a id="wrglossary.1820"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> when <a id="wrglossary.1821"></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.1825"></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 -->
+<a id="wrglossary.1822"></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.1826"></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.1827"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-with the extension associated with the <a id="wrglossary.1828"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span>
-argument of <a id="wrglossary.1829"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
+only one <a id="wrglossary.1823"></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.1824"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1825"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span>
+argument of <a id="wrglossary.1826"></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.1830"></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 -->
+<a id="wrglossary.1827"></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.1831"></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.1832"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-with the extension associated with the <a id="wrglossary.1833"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span>
-argument of <a id="wrglossary.1834"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
+only one <a id="wrglossary.1828"></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.1829"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1830"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span>
+argument of <a id="wrglossary.1831"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
<p>
</section><!-- end of section sec:makeglossariesapp -->
@@ -8885,17 +8889,17 @@
<h3><!-- start of subsection header -->1.6.2. Using the <span class="appfmt">makeglossaries-lite</span> Lua Script<span class="labellink"><a href="#sec:makeglossarieslua">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1835"></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>
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1832"></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.1836"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script requires
+The Lua alternative to the <a id="wrglossary.1833"></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.1837"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>
+scripting languages, such as Perl. The <a id="wrglossary.1834"></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.1838"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script aren’t available
-here. (In particular the <a id="wrglossary.1839"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> option.) Whilst it may be
+available to the <a id="wrglossary.1835"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script aren’t available
+here. (In particular the <a id="wrglossary.1836"></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
@@ -8909,119 +8913,119 @@
</div><!-- end of information -->
<p>
-The <a id="wrglossary.1840"></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.1841"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. For example, if your document is called
+The <a id="wrglossary.1837"></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.1838"></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.1842"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> rule doesn’t contain the hyphen:
+Note that the <a id="wrglossary.1839"></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.1843"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some
-are only applicable to <a id="wrglossary.1844"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. There’s no equivalent to
-the <a id="wrglossary.1845"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> available to <a id="wrglossary.1846"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> but it may work
+Some of the options are only applicable to <a id="wrglossary.1840"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some
+are only applicable to <a id="wrglossary.1841"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. There’s no equivalent to
+the <a id="wrglossary.1842"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> available to <a id="wrglossary.1843"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> but it may work
if you prefix the basename with the path.
<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.1847"></a><code class="code"><dfn id="glo:switch.mkglslite.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1844"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1848"></a><code class="code"><dfn id="glo:switch.mkglslite.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1845"></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 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.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1846"></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.1850"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1851"></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.1852"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
+<a id="wrglossary.1847"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1848"></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.1849"></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.1853"></a><code class="code"><dfn id="glo:switch.mkglslite.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1850"></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 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.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 -->
+<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.1855"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> application. Only the name is required if it’s
+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 href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1856"></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 -->
+<a id="wrglossary.1853"></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.1857"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application. Only the name is required if it’s
+The <a id="wrglossary.1854"></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.1858"></a><code class="code"><dfn id="glo:switch.mkglslite.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1855"></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.1859"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to
-<a id="wrglossary.1860"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1861"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
+Compress intermediate blanks. This will pass <a id="wrglossary.1856"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to
+<a id="wrglossary.1857"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1858"></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.1862"></a><code class="code"><dfn id="glo:switch.mkglslite.r"><span class="shortargfmt">-r</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1859"></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.)
+Disable implicit page <a id="wrglossary.1860"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1861"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to
+<a id="wrglossary.1862"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1863"></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.1867"></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 -->
+<a id="wrglossary.1864"></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.1868"></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.1869"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.
-(Ignored if <a id="wrglossary.1870"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
+<code class="code"><a id="wrglossary.1865"></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.1866"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.
+(Ignored if <a id="wrglossary.1867"></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.1871"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.
+the <a id="wrglossary.1868"></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.1872"></a><code class="code"><dfn id="glo:switch.mkglslite.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1869"></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.1873"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1874"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-or <code class="code"><a id="wrglossary.1875"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1876"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+Use letter ordering. This will pass <a id="wrglossary.1870"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1871"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <code class="code"><a id="wrglossary.1872"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1873"></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.1877"></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 -->
+<a id="wrglossary.1874"></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.1878"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1879"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+The language to pass to <a id="wrglossary.1875"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1876"></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.1880"></a><code class="code"><dfn id="glo:switch.mkglslite.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1877"></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.1881"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to
-<a id="wrglossary.1882"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1883"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
+Employ German word ordering. This will pass <a id="wrglossary.1878"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to
+<a id="wrglossary.1879"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1880"></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.1884"></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 -->
+<a id="wrglossary.1881"></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 href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.1885"></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 -->
+<a id="wrglossary.1882"></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.1886"></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.1887"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-with the extension associated with the <a id="wrglossary.1888"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span>
-argument of <a id="wrglossary.1889"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
+only one <a id="wrglossary.1883"></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.1884"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1885"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span>
+argument of <a id="wrglossary.1886"></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.1890"></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 -->
+<a id="wrglossary.1887"></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.1891"></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.1892"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-with the extension associated with the <a id="wrglossary.1893"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span>
-argument of <a id="wrglossary.1894"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
+only one <a id="wrglossary.1888"></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.1889"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1890"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span>
+argument of <a id="wrglossary.1891"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
<p>
</section><!-- end of section sec:makeglossarieslua -->
@@ -9030,60 +9034,60 @@
<h3><!-- start of subsection header -->1.6.3. Using <span class="appfmt">xindy</span> explicitly (Option 3)<span class="labellink"><a href="#sec:xindyapp">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<a id="wrglossary.1895"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> comes with TeX Live. It has also been added to MikTeX,
+<a id="wrglossary.1892"></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.1896"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to process the glossary
+If you want to use <a id="wrglossary.1893"></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.1897"></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.1898"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
+<a id="wrglossary.1894"></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.1895"></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.1899"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+This is required regardless of whether you use <a id="wrglossary.1896"></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.1900"></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.1901"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format, so you need to
-use <code class="code"><a id="wrglossary.1902"></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.1903"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> tex</code>.
+as <a id="wrglossary.1897"></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.1898"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format, so you need to
+use <code class="code"><a id="wrglossary.1899"></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.1900"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> tex</code>.
<p>
-To run <a id="wrglossary.1904"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> type the following in your terminal
+To run <a id="wrglossary.1901"></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.1905"></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.1906"></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.1907"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.1908"></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.1909"></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.1910"></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 class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy <a id="wrglossary.1902"></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.1903"></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.1904"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.1905"></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.1906"></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.1907"></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.1911"></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.1912"></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.1913"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file without the <a id="wrglossary.1914"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension.
+is the <a id="wrglossary.1908"></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.1909"></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.1910"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file without the <a id="wrglossary.1911"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension.
The default name for this style file is <span class="filefmt"></span><span class="meta">〈<em class="metainner">base</em>〉</span><span class="filefmt">xdy</span>
-but can be changed via <a id="wrglossary.1915"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. As usual for command line
+but can be changed via <a id="wrglossary.1912"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. As usual for command line
applications, 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.1916"></a><a href="#glo:dual.utf8">UTF-8</a> <a id="wrglossary.1917"></a><a href="#glo:idx.encoding">encoding</a> in English, then type the
+you are using <a id="wrglossary.1913"></a><a href="#glo:dual.utf8">UTF-8</a> <a id="wrglossary.1914"></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.1918"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1919"></a><a href="#glo:dual.glossary">glossary</a>. You need to do
-the same for each of the other <a id="wrglossary.1920"></a><a href="#glo:dual.glossary">glossaries</a> (including the
-list of <a id="wrglossary.1921"></a><a href="#glo:idx.acronym">acronyms</a> if you have used the <a id="wrglossary.1922"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>
-package option), substituting <a id="wrglossary.1923"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1924"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>
-and <a id="wrglossary.1925"></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.1926"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option, then
+Note that this just creates the <a id="wrglossary.1915"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1916"></a><a href="#glo:dual.glossary">glossary</a>. You need to do
+the same for each of the other <a id="wrglossary.1917"></a><a href="#glo:dual.glossary">glossaries</a> (including the
+list of <a id="wrglossary.1918"></a><a href="#glo:idx.acronym">acronyms</a> if you have used the <a id="wrglossary.1919"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>
+package option), substituting <a id="wrglossary.1920"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1921"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>
+and <a id="wrglossary.1922"></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.1923"></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.1927"></a><a href="#glo:dual.glossary">glossaries</a>, the extensions are those supplied
-when you created the <a id="wrglossary.1928"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.1929"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.
+For additional <a id="wrglossary.1924"></a><a href="#glo:dual.glossary">glossaries</a>, the extensions are those supplied
+when you created the <a id="wrglossary.1925"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.1926"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.
<p>
-Note that if you use <a id="wrglossary.1930"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can
-replace all those calls to <a id="wrglossary.1931"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with just one call
-to <a id="wrglossary.1932"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>:
+Note that if you use <a id="wrglossary.1927"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can
+replace all those calls to <a id="wrglossary.1928"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with just one call
+to <a id="wrglossary.1929"></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.1933"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly instead of using
-<a id="wrglossary.1934"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. These are listed in
+you use <a id="wrglossary.1930"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly instead of using
+<a id="wrglossary.1931"></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>
@@ -9094,19 +9098,19 @@
<span class="appfmt">makeindex</span> explicitly (Option 2)<span class="labellink"><a href="#sec:makeindexapp">[link]</a></span></h3><!-- end of subsection header -->
<p>
-If you want to use <a id="wrglossary.1935"></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.1936"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package
-option or the <a id="wrglossary.1937"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will be written in the wrong
-format. To run <a id="wrglossary.1938"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, type the following in
+If you want to use <a id="wrglossary.1932"></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.1933"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package
+option or the <a id="wrglossary.1934"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will be written in the wrong
+format. To run <a id="wrglossary.1935"></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.1939"></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.1940"></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.1941"></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 class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.1936"></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.1937"></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.1938"></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.1942"></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.1943"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> is the
-name of the <a id="wrglossary.1944"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style file. By default, this is
+<a id="wrglossary.1939"></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.1940"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> is the
+name of the <a id="wrglossary.1941"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style file. By default, this is
<span class="filefmt"></span><span class="meta">〈<em class="metainner">base</em>〉</span><span class="filefmt">ist</span>, but may be changed via
-<a id="wrglossary.1945"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. Note that there are other options,
-such as <a id="wrglossary.1946"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> (letter ordering). See the <a id="wrglossary.1947"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+<a id="wrglossary.1942"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. Note that there are other options,
+such as <a id="wrglossary.1943"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> (letter ordering). See the <a id="wrglossary.1944"></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
@@ -9113,27 +9117,27 @@
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.1948"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1949"></a><a href="#glo:dual.glossary">glossary</a>. If you have
-additional <a id="wrglossary.1950"></a><a href="#glo:dual.glossary">glossaries</a> (for example, if you have used the
-<a id="wrglossary.1951"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option) then you must call
-<a id="wrglossary.1952"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for each glossary, substituting
-<a id="wrglossary.1953"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1954"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> and <a id="wrglossary.1955"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> with the
+Note that this only creates the <a id="wrglossary.1945"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1946"></a><a href="#glo:dual.glossary">glossary</a>. If you have
+additional <a id="wrglossary.1947"></a><a href="#glo:dual.glossary">glossaries</a> (for example, if you have used the
+<a id="wrglossary.1948"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option) then you must call
+<a id="wrglossary.1949"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for each glossary, substituting
+<a id="wrglossary.1950"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1951"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> and <a id="wrglossary.1952"></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.1956"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option, then you need to type the
+<a id="wrglossary.1953"></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.1957"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.
+when you created the glossary with <a id="wrglossary.1954"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.
<p>
-Note that if you use <a id="wrglossary.1958"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can
-replace all those calls to <a id="wrglossary.1959"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with just one call
-to <a id="wrglossary.1960"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>:
+Note that if you use <a id="wrglossary.1955"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can
+replace all those calls to <a id="wrglossary.1956"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with just one call
+to <a id="wrglossary.1957"></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.1961"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly instead of using
-<a id="wrglossary.1962"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. These are listed in
+you use <a id="wrglossary.1958"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly instead of using
+<a id="wrglossary.1959"></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>
@@ -9143,10 +9147,10 @@
<h2><!-- start of section header -->1.7. Note to Front-End and Script Developers<span class="labellink"><a href="#sec:notedev">[link]</a></span></h2><!-- end of section header -->
<p>
-The information needed to determine whether to use <a id="wrglossary.1963"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>,
-<a id="wrglossary.1964"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1965"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is stored in the <a id="wrglossary.1966"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>
+The information needed to determine whether to use <a id="wrglossary.1960"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>,
+<a id="wrglossary.1961"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1962"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is stored in the <a id="wrglossary.1963"></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.1967"></a><a href="#glo:dual.glossary">glossaries</a> where appropriate. This section
+script to make the <a id="wrglossary.1964"></a><a href="#glo:dual.glossary">glossaries</a> where appropriate. This section
describes how the information is stored in the auxiliary file.
See also
<span class="qt">“<a href="https://www.dickimaw-books.com/latex/auxglossaries">Decyphering the Aux File Commands Provided by
@@ -9159,80 +9163,80 @@
<h3><!-- start of subsection header -->1.7.1. MakeIndex and Xindy<span class="labellink"><a href="#sec:notedev.makeindex.xindy">[link]</a></span></h3><!-- end of subsection header -->
<p>
-The <a id="wrglossary.1968"></a><a href="#glo:idx.fileextension">file extension</a> of the <a id="wrglossary.1969"></a><a href="#glo:dual.indexingfile">indexing files</a> used for each defined
-<a id="wrglossary.1970"></a><a href="#glo:dual.glossary">glossary</a> (not including any <a id="wrglossary.1971"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>) are given by:
+The <a id="wrglossary.1965"></a><a href="#glo:idx.fileextension">file extension</a> of the <a id="wrglossary.1966"></a><a href="#glo:dual.indexingfile">indexing files</a> used for each defined
+<a id="wrglossary.1967"></a><a href="#glo:dual.glossary">glossary</a> (not including any <a id="wrglossary.1968"></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.1972"></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 -->
+<a id="wrglossary.1969"></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.1973"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span> input file (the output file from the
-<a id="wrglossary.1974"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s point of view), such as <a id="wrglossary.1975"></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.1976"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span>
-output file (the input file from the <a id="wrglossary.1977"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s
-point of view), such as <a id="wrglossary.1978"></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.1979"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file, such as <a id="wrglossary.1980"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>.
-The label for the <a id="wrglossary.1981"></a><a href="#glo:dual.glossary">glossary</a> is also given. This isn’t required
-with <a id="wrglossary.1982"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, but with <a id="wrglossary.1983"></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.1984"></a><a href="#glo:idx.encoding">encoding</a> (see below). For example, the
-information for the default <a id="wrglossary.1985"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1986"></a><a href="#glo:dual.glossary">glossary</a> is
+<span style="font-style: italic; font-variant: normal; "><a id="wrglossary.1970"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span> input file (the output file from the
+<a id="wrglossary.1971"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s point of view), such as <a id="wrglossary.1972"></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.1973"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span>
+output file (the input file from the <a id="wrglossary.1974"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s
+point of view), such as <a id="wrglossary.1975"></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.1976"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file, such as <a id="wrglossary.1977"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>.
+The label for the <a id="wrglossary.1978"></a><a href="#glo:dual.glossary">glossary</a> is also given. This isn’t required
+with <a id="wrglossary.1979"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, but with <a id="wrglossary.1980"></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.1981"></a><a href="#glo:idx.encoding">encoding</a> (see below). For example, the
+information for the default <a id="wrglossary.1982"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1983"></a><a href="#glo:dual.glossary">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.1987"></a><a href="#glo:@newglossary"><code class="csfmt">\@newglossary</code></a>{main}{glg}{gls}{glo}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1984"></a><a href="#glo:@newglossary"><code class="csfmt">\@newglossary</code></a>{main}{glg}{gls}{glo}
</pre>
-If <a id="wrglossary.1988"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> hybrid method has been used (with
-<a id="wrglossary.1989"></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.1990"></a><a href="#glo:dual.glossary">glossaries</a> that need to be processed will be identified with:
+If <a id="wrglossary.1985"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> hybrid method has been used (with
+<a id="wrglossary.1986"></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.1987"></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.1991"></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 -->
+<a id="wrglossary.1988"></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.1992"></a><a href="#glo:dual.indexingapp">indexing application’s</a> style file is specified by:
+The <a id="wrglossary.1989"></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.1993"></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 -->
+<a id="wrglossary.1990"></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.1994"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-(<a id="wrglossary.1995"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.1996"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.1997"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>). Note that
-the <a id="wrglossary.1998"></a><a href="#glo:dual.glossary">glossary</a> information has a different syntax depending on
-which <a id="wrglossary.1999"></a><a href="#glo:dual.indexingapp">indexing application</a> is supposed to be used, so it’s
+The file extension indicates whether to use <a id="wrglossary.1991"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+(<a id="wrglossary.1992"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.1993"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.1994"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>). Note that
+the <a id="wrglossary.1995"></a><a href="#glo:dual.glossary">glossary</a> information has a different syntax depending on
+which <a id="wrglossary.1996"></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.2000"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether to
-run <a id="wrglossary.2001"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>:
+For example, with <a id="wrglossary.1997"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether to
+run <a id="wrglossary.1998"></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.2002"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-or <a id="wrglossary.2003"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+It’s more complicated if you want to explicitly run <a id="wrglossary.1999"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <a id="wrglossary.2000"></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.2004"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
-<a id="wrglossary.2005"></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.2006"></a><a href="#glo:locationencap">encap</a>-clash fix
-that <a id="wrglossary.2007"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> also provides.
+Note that if you choose to explicitly call <a id="wrglossary.2001"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
+<a id="wrglossary.2002"></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.2003"></a><a href="#glo:locationencap">encap</a>-clash fix
+that <a id="wrglossary.2004"></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 href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2008"></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 -->
+<a id="wrglossary.2005"></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.2009"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> package option).
+(obtained from the <a id="wrglossary.2006"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> package option).
<p>
-If <a id="wrglossary.2010"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be used, the language for each <a id="wrglossary.2011"></a><a href="#glo:dual.glossary">glossary</a> is specified by:
+If <a id="wrglossary.2007"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be used, the language for each <a id="wrglossary.2008"></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.2012"></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 -->
+<a id="wrglossary.2009"></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.2013"></a><a href="#glo:dual.glossary">glossary</a> and <span class="meta">〈<em class="metainner">language</em>〉</span> is
+where <span class="meta">〈<em class="metainner">glossary-label</em>〉</span> identifies the <a id="wrglossary.2010"></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.2014"></a><a href="#glo:idx.codepage">codepage</a> (file <a id="wrglossary.2015"></a><a href="#glo:idx.encoding">encoding</a>) for all <a id="wrglossary.2016"></a><a href="#glo:dual.glossary">glossaries</a> is specified by:
+The <a id="wrglossary.2011"></a><a href="#glo:idx.codepage">codepage</a> (file <a id="wrglossary.2012"></a><a href="#glo:idx.encoding">encoding</a>) for all <a id="wrglossary.2013"></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.2017"></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 -->
+<a id="wrglossary.2014"></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.2018"></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.2019"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be used.
+where <span class="meta">〈<em class="metainner">code</em>〉</span> is the <a id="wrglossary.2015"></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.2016"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be used.
<p>
-If <a id="wrglossary.2020"></a><a href="#glo:idx.opt.noidx">Option 1</a> has been used, the <a id="wrglossary.2021"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file will contain
+If <a id="wrglossary.2017"></a><a href="#glo:idx.opt.noidx">Option 1</a> has been used, the <a id="wrglossary.2018"></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.2022"></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 -->
+<a id="wrglossary.2019"></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>
@@ -9243,18 +9247,18 @@
<h3><!-- start of subsection header -->1.7.2. Entry Labels<span class="labellink"><a href="#sec:notedev.labels">[link]</a></span></h3><!-- end of subsection header -->
<p>
-If you need to gather labels for <a id="wrglossary.2023"></a><a href="#glo:idx.auto-completion">auto-completion</a>, the
-<a id="wrglossary.2024"></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.2025"></a><a href="#glo:idx.glossaryentry">entries</a> (regardless of whether or not the
-<a id="wrglossary.2026"></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.2027"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a> that writes both the
+If you need to gather labels for <a id="wrglossary.2020"></a><a href="#glo:idx.auto-completion">auto-completion</a>, the
+<a id="wrglossary.2021"></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.2022"></a><a href="#glo:idx.glossaryentry">entries</a> (regardless of whether or not the
+<a id="wrglossary.2023"></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.2024"></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.2028"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2025"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.2029"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
-package also provides <a id="wrglossary.2030"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span>, which will create the
-<a id="wrglossary.2031"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file but will act like <a id="wrglossary.2032"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>.
+The <a id="wrglossary.2026"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+package also provides <a id="wrglossary.2027"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span>, which will create the
+<a id="wrglossary.2028"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file but will act like <a id="wrglossary.2029"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>.
</div><!-- end of information -->
<p>
@@ -9265,57 +9269,57 @@
<h3><!-- start of subsection header -->1.7.3. Bib2Gls<span class="labellink"><a href="#sec:notedev.bib2gls">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.2033"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-If <a id="wrglossary.2034"></a><a href="#glo:idx.opt.b2g">Option 4</a> has been used, the <a id="wrglossary.2035"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file will contain one
+<div class="sidenote"><a id="wrglossary.2030"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+If <a id="wrglossary.2031"></a><a href="#glo:idx.opt.b2g">Option 4</a> has been used, the <a id="wrglossary.2032"></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.2036"></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 -->
+<a id="wrglossary.2033"></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.2037"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file that
-needs to be created by <a id="wrglossary.2038"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If
-<a id="wrglossary.2039"></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
+where <span class="meta">〈<em class="metainner">basename</em>〉</span> is the basename of the <a id="wrglossary.2034"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file that
+needs to be created by <a id="wrglossary.2035"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If
+<a id="wrglossary.2036"></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.2040"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file.
+associated <a id="wrglossary.2037"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file.
<p>
-For example, with <a id="wrglossary.2041"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether or
-not to run <a id="wrglossary.2042"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>:
+For example, with <a id="wrglossary.2038"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether or
+not to run <a id="wrglossary.2039"></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.2043"></a><a href="#glo:glsxtr at resource"><code class="csfmt">\glsxtr at resource</code></a> and
-<a id="wrglossary.2044"></a><a href="#glo:@istfilename"><code class="csfmt">\@istfilename</code></a> are present as that indicates the hybrid
-<a id="wrglossary.2045"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=hybrid</span> option.)
+(It gets more complicated if both <a id="wrglossary.2040"></a><a href="#glo:glsxtr at resource"><code class="csfmt">\glsxtr at resource</code></a> and
+<a id="wrglossary.2041"></a><a href="#glo:@istfilename"><code class="csfmt">\@istfilename</code></a> are present as that indicates the hybrid
+<a id="wrglossary.2042"></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.2046"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.2047"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will never be defined
+Remember that with <a id="wrglossary.2043"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.2044"></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.2048"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.2049"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). You can
-also pick up labels from the <a id="wrglossary.2050"></a><a href="#glo:dual.indexing">records</a> in <a id="wrglossary.2051"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which
+in the <a id="wrglossary.2045"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.2046"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). You can
+also pick up labels from the <a id="wrglossary.2047"></a><a href="#glo:dual.indexing">records</a> in <a id="wrglossary.2048"></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.2052"></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 -->
+<a id="wrglossary.2049"></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.2053"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>):
+or (with <a id="wrglossary.2050"></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.2054"></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 -->
+<a id="wrglossary.2051"></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.2055"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>):
+or (with <a id="wrglossary.2052"></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.2056"></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 -->
+<a id="wrglossary.2053"></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 -->
You can also pick up the commands defined with
-<a id="wrglossary.2057"></a><a href="#glo:glsxtrnewglslike"><code class="xtrcsfmt">\glsxtrnewglslike</code></a>, which are added to the <a id="wrglossary.2058"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
-for <a id="wrglossary.2059"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span>’s</a> benefit:
+<a id="wrglossary.2054"></a><a href="#glo:glsxtrnewglslike"><code class="xtrcsfmt">\glsxtrnewglslike</code></a>, which are added to the <a id="wrglossary.2055"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
+for <a id="wrglossary.2056"></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.2060"></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 -->
+<a id="wrglossary.2057"></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.2061"></a><a href="#glo:GlsXtrSetAltModifier"><code class="xtrcsfmt">\GlsXtrSetAltModifier</code></a> is used, then the modifier is
+If <a id="wrglossary.2058"></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.2062"></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 -->
+<a id="wrglossary.2059"></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.2063"></a><a href="#glo:dgls"><code class="xtrcsfmt">\dgls</code></a> set of commands) are identified
+Label prefixes (for the <a id="wrglossary.2060"></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.2064"></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 -->
+<a id="wrglossary.2061"></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>
@@ -9325,17 +9329,17 @@
<h1><!-- start of chapter header -->2. Package Options<span class="labellink"><a href="#sec:pkgopts">[link]</a></span></h1><!-- end of chapter header -->
<p>
-This section describes the available <a id="wrglossary.2065"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+This section describes the available <a id="wrglossary.2062"></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.2066"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> is equivalent to <a id="wrglossary.2067"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="optfmt">=true</span>).
+example, <a id="wrglossary.2063"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> is equivalent to <a id="wrglossary.2064"></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.2068"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2065"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.2069"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has additional options described
-in the <a id="wrglossary.2070"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual. The extension package also
+The <a id="wrglossary.2066"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has additional options described
+in the <a id="wrglossary.2067"></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.2071"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> may have additional package
+versions of <a id="wrglossary.2068"></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 -->
@@ -9343,9 +9347,9 @@
<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.2072"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>.) This is a general limitation
-not restricted to the <a id="wrglossary.2073"></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.2074"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>) may be passed via the document
+may be omitted, such as <a id="wrglossary.2069"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>.) This is a general limitation
+not restricted to the <a id="wrglossary.2070"></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.2071"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>) may be passed via the document
class options.
</div><!-- end of important -->
@@ -9360,112 +9364,112 @@
<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.2075"></a><code class="code"><dfn id="glo:opt.nowarn"><span class="styoptfmt">nowarn</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2072"></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.2076"></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.2077"></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.2078"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>).
-Note that if you use <a id="wrglossary.2079"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> with any value other than
+the <a id="wrglossary.2073"></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.2074"></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.2075"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>).
+Note that if you use <a id="wrglossary.2076"></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.2080"></a><code class="code"><dfn id="glo:opt.nolangwarn"><span class="styoptfmt">nolangwarn</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2077"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2081"></a><code class="code"><dfn id="glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2078"></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.2082"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> with
+If you load <a id="wrglossary.2079"></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.2083"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will warn you that it’s
+commands, by default <a id="wrglossary.2080"></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.2084"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> with that class or package and you don’t
+using <a id="wrglossary.2081"></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.2085"></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.2086"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.)
+<a id="wrglossary.2082"></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.2083"></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.2087"></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 -->
+<a id="wrglossary.2084"></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.2088"></a><a id="wrglossary.2089"></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 -->
+<a id="wrglossary.2085"></a><a id="wrglossary.2086"></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 href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2090"></a><a id="wrglossary.2091"></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 -->
+<a id="wrglossary.2087"></a><a id="wrglossary.2088"></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.2092"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>:
+opened by <a id="wrglossary.2089"></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.2093"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a>.
+Note that this setting will also cancel <a id="wrglossary.2090"></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.2094"></a><a id="wrglossary.2095"></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 -->
+<a id="wrglossary.2091"></a><a id="wrglossary.2092"></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.2096"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2097"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the
-<a id="wrglossary.2098"></a><a href="#glo:dual.glossary">glossary</a>-related <a id="wrglossary.2099"></a><a href="#glo:idx.hyperlink">hyperlinks</a> and targets occur in the document.
+As <a id="wrglossary.2093"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2094"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the
+<a id="wrglossary.2095"></a><a href="#glo:dual.glossary">glossary</a>-related <a id="wrglossary.2096"></a><a href="#glo:idx.hyperlink">hyperlinks</a> and targets occur in the document.
<p>
-The <a id="wrglossary.2100"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2101"></a><a href="#glo:optval.debug.showtargets"><span class="optfmt">showtargets</span></a> option will additionally use:
+The <a id="wrglossary.2097"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2098"></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.2102"></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 -->
+<a id="wrglossary.2099"></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.2103"></a><a href="#glo:idx.hypertarget">hypertarget</a> or <a id="wrglossary.2104"></a><a href="#glo:idx.hyperlink">hyperlink</a> name when
-<a id="wrglossary.2105"></a><a href="#glo:glsdohypertarget"><code class="csfmt">\glsdohypertarget</code></a> is used by commands like <a id="wrglossary.2106"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>
-and when <a id="wrglossary.2107"></a><a href="#glo:glsdohyperlink"><code class="csfmt">\glsdohyperlink</code></a> is used by commands like <a id="wrglossary.2108"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.
-In <a id="wrglossary.2109"></a><a href="#glo:idx.mathmode">math mode</a> or inner mode, this uses:
+to show the <a id="wrglossary.2100"></a><a href="#glo:idx.hypertarget">hypertarget</a> or <a id="wrglossary.2101"></a><a href="#glo:idx.hyperlink">hyperlink</a> name when
+<a id="wrglossary.2102"></a><a href="#glo:glsdohypertarget"><code class="csfmt">\glsdohypertarget</code></a> is used by commands like <a id="wrglossary.2103"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>
+and when <a id="wrglossary.2104"></a><a href="#glo:glsdohyperlink"><code class="csfmt">\glsdohyperlink</code></a> is used by commands like <a id="wrglossary.2105"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.
+In <a id="wrglossary.2106"></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.2110"></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 -->
+<a id="wrglossary.2107"></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.2111"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a>{<span class="meta">〈<em class="metainner">target name</em>〉</span>}]
+<pre class="compactcodebox">[<a id="wrglossary.2108"></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.2112"></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 -->
+<a id="wrglossary.2109"></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.2113"></a><a href="#glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></a> uses:
+In outer mode <a id="wrglossary.2110"></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.2114"></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 -->
+<a id="wrglossary.2111"></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.2115"></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 -->
+<a id="wrglossary.2112"></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.2116"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a> and
-<a id="wrglossary.2117"></a><a href="#glo:glsshowtargetouter"><code class="csfmt">\glsshowtargetouter</code></a> is given by the declaration:
+The font used by both <a id="wrglossary.2113"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a> and
+<a id="wrglossary.2114"></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.2118"></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 -->
+<a id="wrglossary.2115"></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 href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2119"></a><a id="wrglossary.2120"></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 -->
+<a id="wrglossary.2116"></a><a id="wrglossary.2117"></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.2121"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2122"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the
-<a id="wrglossary.2123"></a><a href="#glo:dual.glossary">glossary</a>-related accessibility information occurs (see
-<a id="wrglossary.2124"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>) using:
+As <a id="wrglossary.2118"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2119"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the
+<a id="wrglossary.2120"></a><a href="#glo:dual.glossary">glossary</a>-related accessibility information occurs (see
+<a id="wrglossary.2121"></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.2125"></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 -->
+<a id="wrglossary.2122"></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.2126"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2123"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.2127"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides extra values
-<a id="wrglossary.2128"></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.2129"></a><a href="#glo:dual.indexing">indexing</a> is occurring, and <a id="wrglossary.2130"></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.2131"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+The <a id="wrglossary.2124"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides extra values
+<a id="wrglossary.2125"></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.2126"></a><a href="#glo:dual.indexing">indexing</a> is occurring, and <a id="wrglossary.2127"></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.2128"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
manual for further details.
</div><!-- end of information -->
@@ -9474,46 +9478,46 @@
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.2132"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample1}</span>,<a id="wrglossary.2133"></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.2134"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample2}</span>,<a id="wrglossary.2135"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={example}</span>}
-<strong class="strong"><a id="wrglossary.2136"></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.2137"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong>
+<code class="cmd">\newglossaryentry</code>{sample1}{<a id="wrglossary.2129"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample1}</span>,<a id="wrglossary.2130"></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.2131"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample2}</span>,<a id="wrglossary.2132"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={example}</span>}
+<strong class="strong"><a id="wrglossary.2133"></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.2134"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong>
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.2138"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample1}.
-<a id="wrglossary.2139"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.2135"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample1}.
+<a id="wrglossary.2136"></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.2140"></a><a href="#glo:dual.indexing">indexed</a>, even
-though <code class="code"><a id="wrglossary.2141"></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.2142"></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.2143"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Since the file
+In this case, only the <span class="qt">“sample1”</span> entry has been <a id="wrglossary.2137"></a><a href="#glo:dual.indexing">indexed</a>, even
+though <code class="code"><a id="wrglossary.2138"></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.2139"></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.2140"></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.2144"></a><a href="#glo:dual.glossary">glossary</a>.
+the <span class="qt">“sample2”</span> entry doesn’t appear in the <a id="wrglossary.2141"></a><a href="#glo:dual.glossary">glossary</a>.
<p>
-Without <a id="wrglossary.2145"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> the <a id="wrglossary.2146"></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.2147"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>
+Without <a id="wrglossary.2142"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> the <a id="wrglossary.2143"></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.2144"></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.2148"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> to
+perfectly legitimate for a user to want to use <a id="wrglossary.2145"></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.2149"></a><a href="#glo:dual.firstuse">first use</a>) but not display any <a id="wrglossary.2150"></a><a href="#glo:dual.glossary">glossaries</a> (or the user
+<a id="wrglossary.2146"></a><a href="#glo:dual.firstuse">first use</a>) but not display any <a id="wrglossary.2147"></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.2151"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> in order to suppress the <a id="wrglossary.2152"></a><a href="#glo:dual.indexing">indexing</a> while
+<a id="wrglossary.2148"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> in order to suppress the <a id="wrglossary.2149"></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.2153"></a><a href="#glo:dual.indexing">indexing</a>, which don’t
-use <a id="wrglossary.2154"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
+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.2150"></a><a href="#glo:dual.indexing">indexing</a>, which don’t
+use <a id="wrglossary.2151"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
<p>
-Therefore <a id="wrglossary.2155"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> can’t be used to enable
-<a id="wrglossary.2156"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and commands like <a id="wrglossary.2157"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.2158"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>.
+Therefore <a id="wrglossary.2152"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> can’t be used to enable
+<a id="wrglossary.2153"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and commands like <a id="wrglossary.2154"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.2155"></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.2159"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key as that’s a more common problem. See below.)
+the <a id="wrglossary.2156"></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.2160"></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.2161"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a>]{glossaries}
+The debug mode, enabled with the <a id="wrglossary.2157"></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.2158"></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.2162"></a><a href="#glo:dual.indexing">indexing</a>
+will write information to the log file when the <a id="wrglossary.2159"></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
@@ -9522,17 +9526,17 @@
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.2163"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>
-or <a id="wrglossary.2164"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, try switching on the <a id="wrglossary.2165"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a> option
+glossary but you’re sure you used commands like <a id="wrglossary.2160"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>
+or <a id="wrglossary.2161"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, try switching on the <a id="wrglossary.2162"></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.2166"></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 -->
+<a id="wrglossary.2163"></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.2167"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
-The default is <a id="wrglossary.2168"></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.2169"></a><a href="#glo:dual.glossary">glossary</a> and one for
+number of write registers used by the <a id="wrglossary.2164"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
+The default is <a id="wrglossary.2165"></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.2166"></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 -->
@@ -9541,90 +9545,90 @@
<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.2170"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file is needed to save document
+required if the <a id="wrglossary.2167"></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.2171"></a><a href="#glo:dual.indexing">indexing</a> information is
-written to the <a id="wrglossary.2172"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file). If you really need document
+(document definitions aren’t permitted and <a id="wrglossary.2168"></a><a href="#glo:dual.indexing">indexing</a> information is
+written to the <a id="wrglossary.2169"></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.2173"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span> with
-<a id="wrglossary.2174"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+then consider using <a id="wrglossary.2170"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span> with
+<a id="wrglossary.2171"></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.2175"></a><a href="#glo:dual.glossary">glossaries</a> or if you are using a class or other
+a large number of <a id="wrglossary.2172"></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.2176"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a> is
-set, the <a id="wrglossary.2177"></a><a href="#glo:dual.glossary">glossary</a> information will be stored in token registers
+maximum number of available registers. If <a id="wrglossary.2173"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a> is
+set, the <a id="wrglossary.2174"></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.2178"></a><a href="#glo:dual.indexing">indexing</a> to fail. Page numbers in the <a id="wrglossary.2179"></a><a href="#glo:locationlist">number list</a>
+cause the <a id="wrglossary.2175"></a><a href="#glo:dual.indexing">indexing</a> to fail. Page numbers in the <a id="wrglossary.2176"></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.2180"></a><a href="#glo:pkg.scrwfile"><span class="styfmt">scrwfile</span></a>
+output routine. As an alternative, you can use the <a id="wrglossary.2177"></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.2181"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has a total of 15 <a id="wrglossary.2182"></a><a href="#glo:dual.glossary">glossaries</a>. With
+provided with <a id="wrglossary.2178"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has a total of 15 <a id="wrglossary.2179"></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.2183"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, such as
-<a id="wrglossary.2184"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> and <span class="filefmt">out</span>.) With
-<a id="wrglossary.2185"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, no write registers are required and there are only 10
+and registers provided by the kernel or <a id="wrglossary.2180"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, such as
+<a id="wrglossary.2181"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> and <span class="filefmt">out</span>.) With
+<a id="wrglossary.2182"></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.2186"></a><a href="#glo:dual.shellescape">shell escape</a> to call
-<a id="wrglossary.2187"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2188"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> from your document and use
-<a id="wrglossary.2189"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a>, then use <a id="wrglossary.2190"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2191"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or
-<a id="wrglossary.2192"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2193"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a> or <a id="wrglossary.2194"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2195"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a>.
+If you want to use TeX’s <a id="wrglossary.2183"></a><a href="#glo:dual.shellescape">shell escape</a> to call
+<a id="wrglossary.2184"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2185"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> from your document and use
+<a id="wrglossary.2186"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a>, then use <a id="wrglossary.2187"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2188"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or
+<a id="wrglossary.2189"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2190"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a> or <a id="wrglossary.2191"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2192"></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 href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2196"></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 -->
+<a id="wrglossary.2193"></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.2197"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2198"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> otherwise the default is
-<a id="wrglossary.2199"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2200"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a> for the base <a id="wrglossary.2201"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
-and <a id="wrglossary.2202"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2203"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> for <a id="wrglossary.2204"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+<a id="wrglossary.2194"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2195"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> otherwise the default is
+<a id="wrglossary.2196"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2197"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a> for the base <a id="wrglossary.2198"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+and <a id="wrglossary.2199"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2200"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> for <a id="wrglossary.2201"></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.2205"></a><a id="wrglossary.2206"></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 -->
+<a id="wrglossary.2202"></a><a id="wrglossary.2203"></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.2207"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded and the <a id="wrglossary.2208"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is
-installed, <a id="wrglossary.2209"></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.2210"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package interface. You can
+If <a id="wrglossary.2204"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded and the <a id="wrglossary.2205"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is
+installed, <a id="wrglossary.2206"></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.2207"></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.2211"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package isn’t installed and <a id="wrglossary.2212"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> is loaded,
-the <a id="wrglossary.2213"></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.2214"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a>
-<code class="csfmt">\addto</code><a id="wrglossary.2215"></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.2216"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> has been loaded, <a id="wrglossary.2217"></a><a href="#glo:pkg.glossaries-polyglossia"><span class="styfmt">glossaries-polyglossia</span></a> will
+<a id="wrglossary.2208"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package isn’t installed and <a id="wrglossary.2209"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> is loaded,
+the <a id="wrglossary.2210"></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.2211"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a>
+<code class="csfmt">\addto</code><a id="wrglossary.2212"></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.2213"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> has been loaded, <a id="wrglossary.2214"></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.2218"></a><a id="wrglossary.2219"></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 -->
+<a id="wrglossary.2215"></a><a id="wrglossary.2216"></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.2220"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.2221"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>
-has been loaded. (Note that <a id="wrglossary.2222"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> provides the command
-<a id="wrglossary.2223"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> so that will still be translated if you have
-loaded <a id="wrglossary.2224"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>.)
+Don’t provide translations, even if <a id="wrglossary.2217"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.2218"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>
+has been loaded. (Note that <a id="wrglossary.2219"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> provides the command
+<a id="wrglossary.2220"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> so that will still be translated if you have
+loaded <a id="wrglossary.2221"></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.2225"></a><a id="wrglossary.2226"></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 -->
+<a id="wrglossary.2222"></a><a id="wrglossary.2223"></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.2227"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package. Instead load <a id="wrglossary.2228"></a><a href="#glo:pkg.glossaries-babel"><span class="styfmt">glossaries-babel</span></a>.
+Don’t load the <a id="wrglossary.2224"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package. Instead load <a id="wrglossary.2225"></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.2229"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2230"></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.2231"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a>, but to maintain backward
-compatibility, if <a id="wrglossary.2232"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded the default is
-<a id="wrglossary.2233"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2234"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a>.
+I recommend you use <a id="wrglossary.2226"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2227"></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.2228"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a>, but to maintain backward
+compatibility, if <a id="wrglossary.2229"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded the default is
+<a id="wrglossary.2230"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2231"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a>.
</div><!-- end of important -->
<p>
@@ -9631,184 +9635,184 @@
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.2235"></a><code class="code"><dfn id="glo:opt.notranslate"><span class="styoptfmt">notranslate</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2232"></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.2236"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2237"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> and may be
+This is equivalent to <a id="wrglossary.2233"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2234"></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.2238"></a><code class="code"><dfn id="glo:opt.languages"><span class="styoptfmt">languages</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2235"></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.2239"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2240"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> (which
-means that <a id="wrglossary.2241"></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.2242"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a> list of
+This automatically implements <a id="wrglossary.2236"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2237"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> (which
+means that <a id="wrglossary.2238"></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.2239"></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.2243"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span>’s</a>
+language tag (such as <code class="code">pt-BR</code>) or one of <a id="wrglossary.2240"></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.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2244"></a><code class="code"><dfn id="glo:opt.locales"><span class="styoptfmt">locales</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.2241"></a><code class="code"><dfn id="glo:opt.locales"><span class="styoptfmt">locales</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
-Synonym of <a id="wrglossary.2245"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>.
+Synonym of <a id="wrglossary.2242"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>.
<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.2246"></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 -->
+<a id="wrglossary.2243"></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.2247"></a><a href="#glo:dual.firstuse">first use</a> will have a <a id="wrglossary.2248"></a><a href="#glo:idx.hyperlink">hyperlink</a>, if
-supported, unless the <a id="wrglossary.2249"></a><a href="#glo:idx.hyperlink">hyperlink</a> is explicitly suppressed using
-starred versions of commands such as <code class="code"><a id="wrglossary.2250"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>*</code>.
-If false, only <a id="wrglossary.2251"></a><a href="#glo:dual.subsequentuse">subsequent use</a> instances will have a <a id="wrglossary.2252"></a><a href="#glo:idx.hyperlink">hyperlink</a>
+If true, terms on <a id="wrglossary.2244"></a><a href="#glo:dual.firstuse">first use</a> will have a <a id="wrglossary.2245"></a><a href="#glo:idx.hyperlink">hyperlink</a>, if
+supported, unless the <a id="wrglossary.2246"></a><a href="#glo:idx.hyperlink">hyperlink</a> is explicitly suppressed using
+starred versions of commands such as <code class="code"><a id="wrglossary.2247"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>*</code>.
+If false, only <a id="wrglossary.2248"></a><a href="#glo:dual.subsequentuse">subsequent use</a> instances will have a <a id="wrglossary.2249"></a><a href="#glo:idx.hyperlink">hyperlink</a>
(if supported).
<p>
-Note that <a id="wrglossary.2253"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> overrides <a id="wrglossary.2254"></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.2255"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such
-as the <a id="wrglossary.2256"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> commands (for example, <a id="wrglossary.2257"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or
-<a id="wrglossary.2258"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>), but not the <a id="wrglossary.2259"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands
-(for example, <a id="wrglossary.2260"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> or <a id="wrglossary.2261"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>).
+Note that <a id="wrglossary.2250"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> overrides <a id="wrglossary.2251"></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.2252"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such
+as the <a id="wrglossary.2253"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> commands (for example, <a id="wrglossary.2254"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or
+<a id="wrglossary.2255"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>), but not the <a id="wrglossary.2256"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands
+(for example, <a id="wrglossary.2257"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> or <a id="wrglossary.2258"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>).
<p>
-The <a id="wrglossary.2262"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> setting applies to
-all <a id="wrglossary.2263"></a><a href="#glo:dual.glossary">glossary</a> types (unless identified by <a id="wrglossary.2264"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> or
-defined with <a id="wrglossary.2265"></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.2266"></a><a href="#glo:opt.glsopt.hyper"><span class="csoptfmt">hyper</span></a> key
+The <a id="wrglossary.2259"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> setting applies to
+all <a id="wrglossary.2260"></a><a href="#glo:dual.glossary">glossary</a> types (unless identified by <a id="wrglossary.2261"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> or
+defined with <a id="wrglossary.2262"></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.2263"></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.2267"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for just the <a id="wrglossary.2268"></a><a href="#glo:idx.acronym">acronyms</a>
-(where the <a id="wrglossary.2269"></a><a href="#glo:dual.firstuse">first use</a> explains the meaning of the <a id="wrglossary.2270"></a><a href="#glo:idx.acronym">acronym</a>) but not
-for ordinary <a id="wrglossary.2271"></a><a href="#glo:idx.glossaryentry">glossary entries</a> (where the <a id="wrglossary.2272"></a><a href="#glo:dual.firstuse">first use</a> is identical to
-<a id="wrglossary.2273"></a><a href="#glo:dual.subsequentuse">subsequent use</a>). In this case, you can use <a id="wrglossary.2274"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span> and
-apply <a id="wrglossary.2275"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> to all the regular (non-<a id="wrglossary.2276"></a><a href="#glo:idx.acronym">acronym</a>)
-<a id="wrglossary.2277"></a><a href="#glo:dual.glossary">glossaries</a>.
+It may be that you only want to suppress <a id="wrglossary.2264"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for just the <a id="wrglossary.2265"></a><a href="#glo:idx.acronym">acronyms</a>
+(where the <a id="wrglossary.2266"></a><a href="#glo:dual.firstuse">first use</a> explains the meaning of the <a id="wrglossary.2267"></a><a href="#glo:idx.acronym">acronym</a>) but not
+for ordinary <a id="wrglossary.2268"></a><a href="#glo:idx.glossaryentry">glossary entries</a> (where the <a id="wrglossary.2269"></a><a href="#glo:dual.firstuse">first use</a> is identical to
+<a id="wrglossary.2270"></a><a href="#glo:dual.subsequentuse">subsequent use</a>). In this case, you can use <a id="wrglossary.2271"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span> and
+apply <a id="wrglossary.2272"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> to all the regular (non-<a id="wrglossary.2273"></a><a href="#glo:idx.acronym">acronym</a>)
+<a id="wrglossary.2274"></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.2278"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.2279"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span>]{glossaries}
-<span class="comment">% <a id="wrglossary.2280"></a><a href="#glo:idx.acronym">acronym</a> and <a id="wrglossary.2281"></a><a href="#glo:idx.glossaryentry">glossary entry</a> definitions</span>
+<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.2275"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.2276"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span>]{glossaries}
+<span class="comment">% <a id="wrglossary.2277"></a><a href="#glo:idx.acronym">acronym</a> and <a id="wrglossary.2278"></a><a href="#glo:idx.glossaryentry">glossary entry</a> definitions</span>
<span class="comment">% at the end of the preamble</span>
-<a id="wrglossary.2282"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a>[<a id="wrglossary.2283"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>]
+<a id="wrglossary.2279"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a>[<a id="wrglossary.2280"></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 href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2284"></a><code class="code"><dfn id="glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2281"></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.2285"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such
-as <a id="wrglossary.2286"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. Within the definition of this command, you can use
-<a id="wrglossary.2287"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> to reference the <a id="wrglossary.2288"></a><a href="#glo:idx.glossaryentry">entry</a> label and <a id="wrglossary.2289"></a><a href="#glo:glstype"><code class="csfmt">\glstype</code></a> to
-reference the <a id="wrglossary.2290"></a><a href="#glo:dual.glossary">glossary</a> type. You can also use <a id="wrglossary.2291"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>
-to determine if the <a id="wrglossary.2292"></a><a href="#glo:idx.glossaryentry">entry</a> has been used. You can test if an
-<a id="wrglossary.2293"></a><a href="#glo:idx.glossaryentry">entry</a> is an <a id="wrglossary.2294"></a><a href="#glo:idx.acronym">acronym</a> by checking if it has the <a id="wrglossary.2295"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key set using
-<a id="wrglossary.2296"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> (or if the <a id="wrglossary.2297"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> key has been set using
-<a id="wrglossary.2298"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>). For example, to switch off the <a id="wrglossary.2299"></a><a href="#glo:idx.hyperlink">hyperlink</a> on
-<a id="wrglossary.2300"></a><a href="#glo:dual.firstuse">first use</a> just for <a id="wrglossary.2301"></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.2302"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a>}{<span class="comment">% </span>
- <a id="wrglossary.2303"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{<a id="wrglossary.2304"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{}<span class="comment">% </span>
+which is used by the commands that check the <a id="wrglossary.2282"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such
+as <a id="wrglossary.2283"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. Within the definition of this command, you can use
+<a id="wrglossary.2284"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> to reference the <a id="wrglossary.2285"></a><a href="#glo:idx.glossaryentry">entry</a> label and <a id="wrglossary.2286"></a><a href="#glo:glstype"><code class="csfmt">\glstype</code></a> to
+reference the <a id="wrglossary.2287"></a><a href="#glo:dual.glossary">glossary</a> type. You can also use <a id="wrglossary.2288"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>
+to determine if the <a id="wrglossary.2289"></a><a href="#glo:idx.glossaryentry">entry</a> has been used. You can test if an
+<a id="wrglossary.2290"></a><a href="#glo:idx.glossaryentry">entry</a> is an <a id="wrglossary.2291"></a><a href="#glo:idx.acronym">acronym</a> by checking if it has the <a id="wrglossary.2292"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key set using
+<a id="wrglossary.2293"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> (or if the <a id="wrglossary.2294"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> key has been set using
+<a id="wrglossary.2295"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>). For example, to switch off the <a id="wrglossary.2296"></a><a href="#glo:idx.hyperlink">hyperlink</a> on
+<a id="wrglossary.2297"></a><a href="#glo:dual.firstuse">first use</a> just for <a id="wrglossary.2298"></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.2299"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.2300"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{<a id="wrglossary.2301"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{}<span class="comment">% </span>
{<span class="comment">% </span>
- <a id="wrglossary.2305"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.2306"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<code class="cmd">\setkeys</code>{glslink}{<a id="wrglossary.2307"></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.2302"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.2303"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<code class="cmd">\setkeys</code>{glslink}{<a id="wrglossary.2304"></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.2308"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as <a id="wrglossary.2309"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>. (You can, instead, redefine
-<a id="wrglossary.2310"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>, which is used by both the <a id="wrglossary.2311"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> and
-<a id="wrglossary.2312"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.)
+<a id="wrglossary.2305"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as <a id="wrglossary.2306"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>. (You can, instead, redefine
+<a id="wrglossary.2307"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>, which is used by both the <a id="wrglossary.2308"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> and
+<a id="wrglossary.2309"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.)
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2313"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2310"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.2314"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a method of disabling
-the <a id="wrglossary.2315"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.2316"></a><a href="#glo:idx.hyperlink">hyperlink</a> according to the <a id="wrglossary.2317"></a><a href="#glo:idx.glossaryentry">entry’s</a> associated
-<a id="wrglossary.2318"></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.2319"></a><a href="#glo:dual.firstuse">first use</a>
-hyperlink for <a id="wrglossary.2320"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you simply need to set
-the <a id="wrglossary.2321"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> <a id="wrglossary.2322"></a><a href="#glo:idx.categoryattribute">attribute</a> for the <a id="wrglossary.2323"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>
-and, if appropriate, <a id="wrglossary.2324"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the
-<a id="wrglossary.2325"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> package option.) See the
-<a id="wrglossary.2326"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+The <a id="wrglossary.2311"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a method of disabling
+the <a id="wrglossary.2312"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.2313"></a><a href="#glo:idx.hyperlink">hyperlink</a> according to the <a id="wrglossary.2314"></a><a href="#glo:idx.glossaryentry">entry’s</a> associated
+<a id="wrglossary.2315"></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.2316"></a><a href="#glo:dual.firstuse">first use</a>
+hyperlink for <a id="wrglossary.2317"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you simply need to set
+the <a id="wrglossary.2318"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> <a id="wrglossary.2319"></a><a href="#glo:idx.categoryattribute">attribute</a> for the <a id="wrglossary.2320"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>
+and, if appropriate, <a id="wrglossary.2321"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the
+<a id="wrglossary.2322"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> package option.) See the
+<a id="wrglossary.2323"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2327"></a><code class="code"><dfn id="glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2324"></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.2328"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.2329"></a><a href="#glo:ext.glslabels"><span class="extfmt">glslabels</span></a></code> at the end of the document.
+<code class="code"><a id="wrglossary.2325"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.2326"></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.2330"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>). It’s provided for
+(including those in any <a id="wrglossary.2327"></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.2331"></a><a href="#glo:idx.auto-completion">auto-completion</a>. If you also want the name, use
-<a id="wrglossary.2332"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a>. (See also <a id="wrglossary.2333"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a>
-<a id="wrglossary.2334"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span> package option.)
+<a id="wrglossary.2328"></a><a href="#glo:idx.auto-completion">auto-completion</a>. If you also want the name, use
+<a id="wrglossary.2329"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a>. (See also <a id="wrglossary.2330"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a>
+<a id="wrglossary.2331"></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.2335"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2332"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-Note that with <a id="wrglossary.2336"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> the file will only contain the entries
-that <a id="wrglossary.2337"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has selected from the <a id="wrglossary.2338"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files.
+Note that with <a id="wrglossary.2333"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> the file will only contain the entries
+that <a id="wrglossary.2334"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has selected from the <a id="wrglossary.2335"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2339"></a><code class="code"><dfn id="glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2336"></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.2340"></a><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a> but writes both
+Similar to <a id="wrglossary.2337"></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.2341"></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 -->
+<a id="wrglossary.2338"></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.2342"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, the value for this
+Only available with <a id="wrglossary.2339"></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.2343"></a><a id="wrglossary.2344"></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 -->
+<a id="wrglossary.2340"></a><a id="wrglossary.2341"></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.2345"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package).
+the base <a id="wrglossary.2342"></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.2346"></a><a id="wrglossary.2347"></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 -->
+<a id="wrglossary.2343"></a><a id="wrglossary.2344"></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.2348"></a><a href="#glo:idx.opt.b2g">Option 4</a>).
+activated with <a id="wrglossary.2345"></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.2349"></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 -->
+<a id="wrglossary.2346"></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.2350"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this
-option governs the use of <a id="wrglossary.2351"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. Available
+Only available with <a id="wrglossary.2347"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this
+option governs the use of <a id="wrglossary.2348"></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.2352"></a><a id="wrglossary.2353"></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 -->
+<a id="wrglossary.2349"></a><a id="wrglossary.2350"></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.2354"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is not permitted in
-the <a id="wrglossary.2355"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment (default with <a id="wrglossary.2356"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
-and for <a id="wrglossary.2357"></a><a href="#glo:idx.opt.noidx">Option 1</a> with just the base <a id="wrglossary.2358"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package).
+This setting means that <a id="wrglossary.2351"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is not permitted in
+the <a id="wrglossary.2352"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment (default with <a id="wrglossary.2353"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+and for <a id="wrglossary.2354"></a><a href="#glo:idx.opt.noidx">Option 1</a> with just the base <a id="wrglossary.2355"></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.2359"></a><a id="wrglossary.2360"></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 -->
+<a id="wrglossary.2356"></a><a id="wrglossary.2357"></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.2361"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is only permitted in
-the <a id="wrglossary.2362"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment if it occurs before
-<a id="wrglossary.2363"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (not available for some indexing options, such
+This setting means that <a id="wrglossary.2358"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is only permitted in
+the <a id="wrglossary.2359"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment if it occurs before
+<a id="wrglossary.2360"></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.2364"></a><a id="wrglossary.2365"></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 -->
+<a id="wrglossary.2361"></a><a id="wrglossary.2362"></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.2366"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2367"></a><a href="#glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></a> but creates the
-<a id="wrglossary.2368"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file for use by <a id="wrglossary.2369"></a><a href="#glo:app.atom"><span class="appfmt">atom</span></a> (without the
-limitations of <a id="wrglossary.2370"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2371"></a><a href="#glo:optval.docdef.true"><span class="xtroptfmt">true</span></a>).
+This setting is as <a id="wrglossary.2363"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2364"></a><a href="#glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></a> but creates the
+<a id="wrglossary.2365"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file for use by <a id="wrglossary.2366"></a><a href="#glo:app.atom"><span class="appfmt">atom</span></a> (without the
+limitations of <a id="wrglossary.2367"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2368"></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.2372"></a><a id="wrglossary.2373"></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 -->
+<a id="wrglossary.2369"></a><a id="wrglossary.2370"></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.2374"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is permitted in the
-<a id="wrglossary.2375"></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.2376"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This will create the
-<a id="wrglossary.2377"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file if <a id="wrglossary.2378"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is found in the
-<a id="wrglossary.2379"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment.
+This setting means that <a id="wrglossary.2371"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is permitted in the
+<a id="wrglossary.2372"></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.2373"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This will create the
+<a id="wrglossary.2374"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file if <a id="wrglossary.2375"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is found in the
+<a id="wrglossary.2376"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment.
<p>
</section><!-- end of section sec:pkgopts-general -->
@@ -9818,174 +9822,174 @@
<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.2380"></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 -->
+<a id="wrglossary.2377"></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.2381"></a><a href="#glo:dual.glossary">glossaries</a> to the <a id="wrglossary.2382"></a><a href="#glo:idx.tableofcontents">table of contents</a> (<a id="wrglossary.2383"></a><a href="#glo:ext.toc"><span class="extfmt">toc</span></a> file).
+Adds the <a id="wrglossary.2378"></a><a href="#glo:dual.glossary">glossaries</a> to the <a id="wrglossary.2379"></a><a href="#glo:idx.tableofcontents">table of contents</a> (<a id="wrglossary.2380"></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.2384"></a><code class="code"><dfn id="glo:glstoctrue"><code class="csfmt">\glstoctrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2381"></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.2385"></a><code class="code"><dfn id="glo:glstocfalse"><code class="csfmt">\glstocfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2382"></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.2386"></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 -->
+<a id="wrglossary.2383"></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.2387"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span> for the base
-<a id="wrglossary.2388"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2389"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> for
-<a id="wrglossary.2390"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+The default value is <a id="wrglossary.2384"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span> for the base
+<a id="wrglossary.2385"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2386"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> for
+<a id="wrglossary.2387"></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.2391"></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 -->
+<a id="wrglossary.2388"></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.2392"></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.2393"></a><a href="#glo:numberline"><code class="csfmt">\numberline</code></a>{}</code> in the final argument of
-<a id="wrglossary.2394"></a><a href="#glo:addcontentsline"><code class="csfmt">\addcontentsline</code></a>. This will align the <a id="wrglossary.2395"></a><a href="#glo:idx.tableofcontents">table of contents</a>
+When used with <a id="wrglossary.2389"></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.2390"></a><a href="#glo:numberline"><code class="csfmt">\numberline</code></a>{}</code> in the final argument of
+<a id="wrglossary.2391"></a><a href="#glo:addcontentsline"><code class="csfmt">\addcontentsline</code></a>. This will align the <a id="wrglossary.2392"></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.2396"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span>. If <a id="wrglossary.2397"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> is used
-without <a id="wrglossary.2398"></a><a href="#glo:opt.numberline"><span class="styoptfmt">numberline</span></a>, the <a id="wrglossary.2399"></a><a href="#glo:dual.glossary">glossary</a> title will be aligned
+effect with <a id="wrglossary.2393"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span>. If <a id="wrglossary.2394"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> is used
+without <a id="wrglossary.2395"></a><a href="#glo:opt.numberline"><span class="styoptfmt">numberline</span></a>, the <a id="wrglossary.2396"></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.2400"></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 -->
+<a id="wrglossary.2397"></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.2401"></a><a href="#glo:dual.glossary">glossary</a>.
+This option indicates the sectional unit to use for the <a id="wrglossary.2398"></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.2402"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <code class="code">chapter*</code>).
+not <a id="wrglossary.2399"></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.2403"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a>, if that command exists, or <a id="wrglossary.2404"></a><a href="#glo:section"><code class="csfmt">\section</code></a> otherwise. The
-starred or unstarred form is determined by the <a id="wrglossary.2405"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a> option.
+<a id="wrglossary.2400"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a>, if that command exists, or <a id="wrglossary.2401"></a><a href="#glo:section"><code class="csfmt">\section</code></a> otherwise. The
+starred or unstarred form is determined by the <a id="wrglossary.2402"></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.2406"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="optfmt">=subsection</span>]{glossaries}
+<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.2403"></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.2407"></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.2408"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>]{glossaries}
+You can omit the value if you want to use <a id="wrglossary.2404"></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.2405"></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.2409"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a><span class="optfmt">=section</span>]{glossaries}
+<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.2406"></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.2410"></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 -->
+<a id="wrglossary.2407"></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.2411"></a><a href="#glo:dual.glossary">glossary</a> adds information to the page header via
-<a id="wrglossary.2412"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> (see §<a href="#sec:glossmarkup">8.2</a>).
+The start of each <a id="wrglossary.2408"></a><a href="#glo:dual.glossary">glossary</a> adds information to the page header via
+<a id="wrglossary.2409"></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.2413"></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 -->
+<a id="wrglossary.2410"></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.2414"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>, this will make <a id="wrglossary.2415"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> use
-<a id="wrglossary.2416"></a><a href="#glo:idx.allcaps">all caps</a> in the header, otherwise no <a id="wrglossary.2417"></a><a href="#glo:dual.casechange">case change</a> will be
+If <a id="wrglossary.2411"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>, this will make <a id="wrglossary.2412"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> use
+<a id="wrglossary.2413"></a><a href="#glo:idx.allcaps">all caps</a> in the header, otherwise no <a id="wrglossary.2414"></a><a href="#glo:dual.casechange">case change</a> will be
applied.
The default is
-<a id="wrglossary.2418"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=false</span>, unless <a id="wrglossary.2419"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a> has been loaded, in
-which case the default is <a id="wrglossary.2420"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>.
+<a id="wrglossary.2415"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=false</span>, unless <a id="wrglossary.2416"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a> has been loaded, in
+which case the default is <a id="wrglossary.2417"></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.2421"></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 -->
+<a id="wrglossary.2418"></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.2422"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a>}[1]{<span class="comment">% </span>
- <a id="wrglossary.2423"></a><a href="#glo:ifglsucmark"><code class="csfmt">\ifglsucmark</code></a>
- <a id="wrglossary.2424"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{<a id="wrglossary.2425"></a><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a>{#1}}<span class="comment">% </span>
+<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.2419"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.2420"></a><a href="#glo:ifglsucmark"><code class="csfmt">\ifglsucmark</code></a>
+ <a id="wrglossary.2421"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{<a id="wrglossary.2422"></a><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a>{#1}}<span class="comment">% </span>
<code class="cmd">\else</code>
- <a id="wrglossary.2426"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{#1}<span class="comment">% </span>
+ <a id="wrglossary.2423"></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 href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2427"></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 -->
+<a id="wrglossary.2424"></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.2428"></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.2429"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a>. This option can take
+The <a id="wrglossary.2425"></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.2426"></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.2430"></a><a id="wrglossary.2431"></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 -->
+<a id="wrglossary.2427"></a><a id="wrglossary.2428"></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.2432"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or
-<a id="wrglossary.2433"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>).
+of sectioning command (for example, <a id="wrglossary.2429"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or
+<a id="wrglossary.2430"></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.2434"></a><a id="wrglossary.2435"></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 -->
+<a id="wrglossary.2431"></a><a id="wrglossary.2432"></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.2436"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2437"></a><a href="#glo:section"><code class="csfmt">\section</code></a>), but
+command (for example, <a id="wrglossary.2433"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2434"></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.2438"></a><a id="wrglossary.2439"></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 -->
+<a id="wrglossary.2435"></a><a id="wrglossary.2436"></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.2440"></a><a href="#glo:dual.glossary">glossary</a> uses the unstarred form of a sectioning
-command (for example, <a id="wrglossary.2441"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2442"></a><a href="#glo:section"><code class="csfmt">\section</code></a>) and is assigned a label
-(via <a id="wrglossary.2443"></a><a href="#glo:label"><code class="csfmt">\label</code></a>). The label is formed from the <a id="wrglossary.2444"></a><a href="#glo:dual.glossary">glossary’s</a>
+labelling. Each <a id="wrglossary.2437"></a><a href="#glo:dual.glossary">glossary</a> uses the unstarred form of a sectioning
+command (for example, <a id="wrglossary.2438"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2439"></a><a href="#glo:section"><code class="csfmt">\section</code></a>) and is assigned a label
+(via <a id="wrglossary.2440"></a><a href="#glo:label"><code class="csfmt">\label</code></a>). The label is formed from the <a id="wrglossary.2441"></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.2445"></a><code class="code"><dfn id="glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2442"></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.2446"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> is empty. For example,
-if you load <a id="wrglossary.2447"></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.2448"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>,<a id="wrglossary.2449"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span>]
+The default value of <a id="wrglossary.2443"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> is empty. For example,
+if you load <a id="wrglossary.2444"></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.2445"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>,<a id="wrglossary.2446"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span>]
{glossaries}
</pre>
-then each <a id="wrglossary.2450"></a><a href="#glo:dual.glossary">glossary</a> will appear in a numbered section, and can
+then each <a id="wrglossary.2447"></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.2451"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2452"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{main} and
-the list of acronyms is in section<a id="wrglossary.2453"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2454"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{acronym}.
+<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.2448"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2449"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{main} and
+the list of acronyms is in section<a id="wrglossary.2450"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2451"></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.2455"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> which is set to <a id="wrglossary.2456"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> if the
-<a id="wrglossary.2457"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is not used and is set to <a id="wrglossary.2458"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>
-if the <a id="wrglossary.2459"></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.2460"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2461"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2462"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
+<a id="wrglossary.2452"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> which is set to <a id="wrglossary.2453"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> if the
+<a id="wrglossary.2454"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is not used and is set to <a id="wrglossary.2455"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>
+if the <a id="wrglossary.2456"></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.2457"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2458"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2459"></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.2463"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a>}{glo:}
+<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.2460"></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.2464"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2465"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{glo:<a id="wrglossary.2466"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
+section<a id="wrglossary.2461"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2462"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{glo:<a id="wrglossary.2463"></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.2467"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2468"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2469"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a><a id="wrglossary.2470"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
+section<a id="wrglossary.2464"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2465"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2466"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a><a id="wrglossary.2467"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}.
</pre>
<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.2471"></a><a id="wrglossary.2472"></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 -->
+<a id="wrglossary.2468"></a><a id="wrglossary.2469"></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.2473"></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.2474"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or <a id="wrglossary.2475"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>). It’s
-designed for use with the <a id="wrglossary.2476"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> package. For example:
+<a id="wrglossary.2470"></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.2471"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or <a id="wrglossary.2472"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>). It’s
+designed for use with the <a id="wrglossary.2473"></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.2477"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.2474"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
</pre>
-Alternatively, since <a id="wrglossary.2478"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> is automatically loaded by
-<a id="wrglossary.2479"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>:
+Alternatively, since <a id="wrglossary.2475"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> is automatically loaded by
+<a id="wrglossary.2476"></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.2480"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.2477"></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.2481"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{main}</code> will display the
-(<a id="wrglossary.2482"></a><a href="#glo:idx.tableofcontents">table of contents</a>) section title
-associated with the <a id="wrglossary.2483"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. As above, you can
-redefine <a id="wrglossary.2484"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> to provide a prefix for the label.
+Now <code class="code"><a id="wrglossary.2478"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{main}</code> will display the
+(<a id="wrglossary.2479"></a><a href="#glo:idx.tableofcontents">table of contents</a>) section title
+associated with the <a id="wrglossary.2480"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. As above, you can
+redefine <a id="wrglossary.2481"></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 -->
@@ -9995,178 +9999,178 @@
<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.2485"></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>
+<a id="wrglossary.2482"></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.2486"></a><a href="#glo:locationlist">number list</a> for each entry. The default is
-<a id="wrglossary.2487"></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.2488"></a><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a> and <a id="wrglossary.2489"></a><a href="#glo:glsdisplaynumberlist"><code class="csfmt">\glsdisplaynumberlist</code></a> in
+store the <a id="wrglossary.2483"></a><a href="#glo:locationlist">number list</a> for each entry. The default is
+<a id="wrglossary.2484"></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.2485"></a><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a> and <a id="wrglossary.2486"></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.2490"></a><a href="#glo:idx.opt.noidx">Option 1</a> as a by-product of the way that <a id="wrglossary.2491"></a><a href="#glo:dual.indexing">indexing</a> method works.
+<a id="wrglossary.2487"></a><a href="#glo:idx.opt.noidx">Option 1</a> as a by-product of the way that <a id="wrglossary.2488"></a><a href="#glo:dual.indexing">indexing</a> method works.
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2492"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2489"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-If you use the <a id="wrglossary.2493"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option (with either no value or
-<a id="wrglossary.2494"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> or <a id="wrglossary.2495"></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.2496"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the
-<a id="wrglossary.2497"></a><a href="#glo:locationlist">number lists</a> are automatically saved with the default
-<a id="wrglossary.2498"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span> and
-<a id="wrglossary.2499"></a><a href="#glo:opt.resource.save-loclist"><span class="xtrcsoptfmt">save-loclist</span></a><span class="optfmt">=true</span> resource settings.
+If you use the <a id="wrglossary.2490"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option (with either no value or
+<a id="wrglossary.2491"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> or <a id="wrglossary.2492"></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.2493"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the
+<a id="wrglossary.2494"></a><a href="#glo:locationlist">number lists</a> are automatically saved with the default
+<a id="wrglossary.2495"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span> and
+<a id="wrglossary.2496"></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 href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2500"></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 -->
+<a id="wrglossary.2497"></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.2501"></a><code class="code"><dfn id="glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></dfn></code></div><!-- end of ctrbox -->
+<a id="wrglossary.2498"></a><code class="code"><dfn id="glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></dfn></code></div><!-- end of ctrbox -->
-Each <a id="wrglossary.2502"></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.2503"></a><a href="#glo:dual.entryline">entry line</a> when using
-<a id="wrglossary.2504"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that support this setting.
-Note that if you also use <a id="wrglossary.2505"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> the option order
-makes a difference. If <a id="wrglossary.2506"></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.2507"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a>
+Each <a id="wrglossary.2499"></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.2500"></a><a href="#glo:dual.entryline">entry line</a> when using
+<a id="wrglossary.2501"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that support this setting.
+Note that if you also use <a id="wrglossary.2502"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> the option order
+makes a difference. If <a id="wrglossary.2503"></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.2504"></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.2508"></a><a href="#glo:idx.glossarystyle">glossary style</a> that
-supports this option) then you can reference the <a id="wrglossary.2509"></a><a href="#glo:idx.glossaryentry">entry</a> number
+If you use this option (and are using a <a id="wrglossary.2505"></a><a href="#glo:idx.glossarystyle">glossary style</a> that
+supports this option) then you can reference the <a id="wrglossary.2506"></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.2510"></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 -->
+<a id="wrglossary.2507"></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.2511"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a> if either <a id="wrglossary.2512"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> or
-<a id="wrglossary.2513"></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
+This will use <a id="wrglossary.2508"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a> if either <a id="wrglossary.2509"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> or
+<a id="wrglossary.2510"></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.2514"></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 -->
+<a id="wrglossary.2511"></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.2515"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span> and
-<a id="wrglossary.2516"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>, <code class="code"><a id="wrglossary.2517"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> will
+If both <a id="wrglossary.2512"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span> and
+<a id="wrglossary.2513"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>, <code class="code"><a id="wrglossary.2514"></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.2518"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, you must run LaTeX twice after
-creating the <a id="wrglossary.2519"></a><a href="#glo:dual.indexingfile">indexing files</a> using <a id="wrglossary.2520"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>,
-<a id="wrglossary.2521"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2522"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (or after creating the <a id="wrglossary.2523"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a>
-file with <a id="wrglossary.2524"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) to ensure the cross-references are
+If you use <a id="wrglossary.2515"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, you must run LaTeX twice after
+creating the <a id="wrglossary.2516"></a><a href="#glo:dual.indexingfile">indexing files</a> using <a id="wrglossary.2517"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>,
+<a id="wrglossary.2518"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2519"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (or after creating the <a id="wrglossary.2520"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a>
+file with <a id="wrglossary.2521"></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.2525"></a><a href="#glo:dual.glossary">glossary</a> is typeset.
+labelled until the <a id="wrglossary.2522"></a><a href="#glo:dual.glossary">glossary</a> is typeset.
</div><!-- end of important -->
<p>
-The <a id="wrglossary.2526"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be reset back to zero with:
+The <a id="wrglossary.2523"></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.2527"></a><code class="code"><dfn id="glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2524"></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.2528"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.
-The <a id="wrglossary.2529"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be simultaneously incremented and labelled (using
-<a id="wrglossary.2530"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2531"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) with:
+This does nothing if <a id="wrglossary.2525"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.
+The <a id="wrglossary.2526"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be simultaneously incremented and labelled (using
+<a id="wrglossary.2527"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2528"></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.2532"></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 -->
+<a id="wrglossary.2529"></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.2533"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>, which is
-typically used in <a id="wrglossary.2534"></a><a href="#glo:idx.glossarystyle">glossary styles</a> at the start of
-<a id="wrglossary.2535"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries. The argument is the entry label.
+This command is within the definition of <a id="wrglossary.2530"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>, which is
+typically used in <a id="wrglossary.2531"></a><a href="#glo:idx.glossarystyle">glossary styles</a> at the start of
+<a id="wrglossary.2532"></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.2536"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be displayed with:
+The value of the <a id="wrglossary.2533"></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.2537"></a><code class="code"><dfn id="glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></dfn></code>
+<a id="wrglossary.2534"></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.2538"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter is
+This command is defined when the <a id="wrglossary.2535"></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.2539"></a><code class="code"><dfn id="glo:glsentrycounterlabel"><code class="csfmt">\glsentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2536"></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.2540"></a><a href="#glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></a>.<a id="wrglossary.2541"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if
-<a id="wrglossary.2542"></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.2543"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as it will
+This will do <code class="code"><a id="wrglossary.2537"></a><a href="#glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></a>.<a id="wrglossary.2538"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if
+<a id="wrglossary.2539"></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.2540"></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.2544"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>.
+within the definition of <a id="wrglossary.2541"></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.2545"></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 -->
+<a id="wrglossary.2542"></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.2546"></a><code class="code"><dfn id="glo:glsentrycounterfalse"><code class="csfmt">\glsentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2543"></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.2547"></a><code class="code"><dfn id="glo:glsentrycountertrue"><code class="csfmt">\glsentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2544"></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.2548"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> if
-<a id="wrglossary.2549"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> wasn’t used initially.
+but note that this won’t define <a id="wrglossary.2545"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> if
+<a id="wrglossary.2546"></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.2550"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2551"></a><a href="#glo:opt.printgloss.entrycounter"><span class="csoptfmt">entrycounter</span></a>
-<a id="wrglossary.2552"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>.
+<a id="wrglossary.2547"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2548"></a><a href="#glo:opt.printgloss.entrycounter"><span class="csoptfmt">entrycounter</span></a>
+<a id="wrglossary.2549"></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.2553"></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 -->
+<a id="wrglossary.2550"></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.2554"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>true and the
-<a id="wrglossary.2555"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter will be reset every time
+If used, this option will automatically set <a id="wrglossary.2551"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>true and the
+<a id="wrglossary.2552"></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.2556"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> has no parent counter (but <a id="wrglossary.2557"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a>
+<a id="wrglossary.2553"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> has no parent counter (but <a id="wrglossary.2554"></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.2558"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter isn’t automatically reset at the
+The <a id="wrglossary.2555"></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.2559"></a><a href="#glo:opt.counterwithin"><span class="styoptfmt">counterwithin</span></a> is the same as the
+and the counter used by <a id="wrglossary.2556"></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.2560"></a><a href="#glo:dual.glossary">glossary</a>, you can
-modify the <a id="wrglossary.2561"></a><a href="#glo:idx.preamble/glossary">glossary preamble</a> (<a id="wrglossary.2562"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>) to use
-<a id="wrglossary.2563"></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.2564"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>}{<span class="comment">% </span>
- <a id="wrglossary.2565"></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.2557"></a><a href="#glo:dual.glossary">glossary</a>, you can
+modify the <a id="wrglossary.2558"></a><a href="#glo:idx.preamble/glossary">glossary preamble</a> (<a id="wrglossary.2559"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>) to use
+<a id="wrglossary.2560"></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.2561"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.2562"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
}
</pre>
-or if you are using <a id="wrglossary.2566"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>, add it to each
-<a id="wrglossary.2567"></a><a href="#glo:idx.preamble/glossary">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.2568"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>[<a id="wrglossary.2569"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>]{<span class="comment">% </span>
- <a id="wrglossary.2570"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
+or if you are using <a id="wrglossary.2563"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>, add it to each
+<a id="wrglossary.2564"></a><a href="#glo:idx.preamble/glossary">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.2565"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>[<a id="wrglossary.2566"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>]{<span class="comment">% </span>
+ <a id="wrglossary.2567"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
The preamble text here for the list of acronyms.
}
-<a id="wrglossary.2571"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>{<span class="comment">% </span>
- <a id="wrglossary.2572"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
- The preamble text here for the <a id="wrglossary.2573"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
+<a id="wrglossary.2568"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>{<span class="comment">% </span>
+ <a id="wrglossary.2569"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
+ The preamble text here for the <a id="wrglossary.2570"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
}
</pre>
<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.2574"></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 -->
+<a id="wrglossary.2571"></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.2575"></a><a href="#glo:hierarchicallevel">level 1</a> glossary <a id="wrglossary.2576"></a><a href="#glo:idx.glossaryentry">entry</a> will be numbered at the
-start of its <a id="wrglossary.2577"></a><a href="#glo:dual.entryline">entry line</a> when using <a id="wrglossary.2578"></a><a href="#glo:idx.glossarystyle">glossary styles</a>
+If set, each <a id="wrglossary.2572"></a><a href="#glo:hierarchicallevel">level 1</a> glossary <a id="wrglossary.2573"></a><a href="#glo:idx.glossaryentry">entry</a> will be numbered at the
+start of its <a id="wrglossary.2574"></a><a href="#glo:dual.entryline">entry line</a> when using <a id="wrglossary.2575"></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.2579"></a><code class="code"><dfn id="glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></dfn></code></div><!-- end of ctrbox -->
+<a id="wrglossary.2576"></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.2580"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option is used before
-<a id="wrglossary.2581"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a>, then <a id="wrglossary.2582"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> will be added to
-the reset list for <a id="wrglossary.2583"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a>. If <a id="wrglossary.2584"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is
-used without <a id="wrglossary.2585"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the <a id="wrglossary.2586"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a>
-counter will be reset by <a id="wrglossary.2587"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>. If
-<a id="wrglossary.2588"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is used before <a id="wrglossary.2589"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the two
+If the <a id="wrglossary.2577"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option is used before
+<a id="wrglossary.2578"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a>, then <a id="wrglossary.2579"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> will be added to
+the reset list for <a id="wrglossary.2580"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a>. If <a id="wrglossary.2581"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is
+used without <a id="wrglossary.2582"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the <a id="wrglossary.2583"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a>
+counter will be reset by <a id="wrglossary.2584"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>. If
+<a id="wrglossary.2585"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is used before <a id="wrglossary.2586"></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.2590"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a>. Some
+There’s no support for deeper <a id="wrglossary.2587"></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.
@@ -10173,290 +10177,290 @@
</div><!-- end of information -->
<p>
-As with the <a id="wrglossary.2591"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option, you can
+As with the <a id="wrglossary.2588"></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.2592"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>. There are analogous commands to those for
-<a id="wrglossary.2593"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>.
+<a id="wrglossary.2589"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>. There are analogous commands to those for
+<a id="wrglossary.2590"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>.
<p>
-The <a id="wrglossary.2594"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be reset back to zero with:
+The <a id="wrglossary.2591"></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.2595"></a><code class="code"><dfn id="glo:glsresetsubentrycounter"><code class="csfmt">\glsresetsubentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2592"></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.2596"></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.2597"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> if
-<a id="wrglossary.2598"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.
+This does nothing if <a id="wrglossary.2593"></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.2594"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> if
+<a id="wrglossary.2595"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.
<p>
-The <a id="wrglossary.2599"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be simultaneously incremented and labelled (using
-<a id="wrglossary.2600"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2601"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) with:
+The <a id="wrglossary.2596"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be simultaneously incremented and labelled (using
+<a id="wrglossary.2597"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2598"></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.2602"></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 -->
+<a id="wrglossary.2599"></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.2603"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a> if
-<a id="wrglossary.2604"></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.2605"></a><a href="#glo:label"><code class="csfmt">\label</code></a> is as for
-<a id="wrglossary.2606"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>.
+This command is used in <a id="wrglossary.2600"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a> if
+<a id="wrglossary.2601"></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.2602"></a><a href="#glo:label"><code class="csfmt">\label</code></a> is as for
+<a id="wrglossary.2603"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>.
<p>
-The value of the <a id="wrglossary.2607"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be displayed with:
+The value of the <a id="wrglossary.2604"></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.2608"></a><code class="code"><dfn id="glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></dfn></code>
+<a id="wrglossary.2605"></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.2609"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter is
+This command is defined when the <a id="wrglossary.2606"></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.2610"></a><code class="code"><dfn id="glo:glssubentrycounterlabel"><code class="csfmt">\glssubentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2607"></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.2611"></a><a href="#glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></a>)<a id="wrglossary.2612"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if
-<a id="wrglossary.2613"></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.2614"></a><a href="#glo:idx.glossarystyle">glossary styles</a> as it will
+This will do <code class="code"><a id="wrglossary.2608"></a><a href="#glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></a>)<a id="wrglossary.2609"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if
+<a id="wrglossary.2610"></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.2611"></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.2615"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>.
+<a id="wrglossary.2612"></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.2616"></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 -->
+<a id="wrglossary.2613"></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.2617"></a><code class="code"><dfn id="glo:glssubentrycounterfalse"><code class="csfmt">\glssubentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2614"></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.2618"></a><code class="code"><dfn id="glo:glssubentrycountertrue"><code class="csfmt">\glssubentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2615"></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.2619"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> if
-<a id="wrglossary.2620"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=true</span> wasn’t used initially.
+but note that this won’t define <a id="wrglossary.2616"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> if
+<a id="wrglossary.2617"></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.2621"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2622"></a><a href="#glo:opt.printgloss.subentrycounter"><span class="csoptfmt">subentrycounter</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> option</a>.
+<a id="wrglossary.2618"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2619"></a><a href="#glo:opt.printgloss.subentrycounter"><span class="csoptfmt">subentrycounter</span></a>
+<a id="wrglossary.2620"></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.2624"></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 -->
+<a id="wrglossary.2621"></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.2625"></a><a href="#glo:idx.glossarystyle">glossary style</a> to
+This option sets the default <a id="wrglossary.2622"></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.2626"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2627"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a></span> unless <a id="wrglossary.2628"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a>
+<a id="wrglossary.2623"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2624"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a></span> unless <a id="wrglossary.2625"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a>
has been loaded, in which case the default is
-<a id="wrglossary.2629"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2630"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a></span>. (The styles that use the
-<a id="wrglossary.2631"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment, such as the <a id="wrglossary.2632"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style, are incompatible
-with <a id="wrglossary.2633"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a>.)
+<a id="wrglossary.2626"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2627"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a></span>. (The styles that use the
+<a id="wrglossary.2628"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment, such as the <a id="wrglossary.2629"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style, are incompatible
+with <a id="wrglossary.2630"></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.2634"></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.2635"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>, <a id="wrglossary.2636"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>,
-<a id="wrglossary.2637"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> or <a id="wrglossary.2638"></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.2639"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>. Style packages
-can also be loaded by the <a id="wrglossary.2640"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> option provided by
-<a id="wrglossary.2641"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+<a id="wrglossary.2631"></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.2632"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>, <a id="wrglossary.2633"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>,
+<a id="wrglossary.2634"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> or <a id="wrglossary.2635"></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.2636"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>. Style packages
+can also be loaded by the <a id="wrglossary.2637"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> option provided by
+<a id="wrglossary.2638"></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.2642"></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 -->
+<a id="wrglossary.2639"></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.2643"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2644"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> option</a>.
+or use the <a id="wrglossary.2640"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2641"></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.2645"></a><code class="code"><dfn id="glo:opt.nolong"><span class="styoptfmt">nolong</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2642"></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.2646"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
-from automatically loading <a id="wrglossary.2647"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> (which means that
-the <a id="wrglossary.2648"></a><a href="#glo:pkg.longtable"><span class="styfmt">longtable</span></a> package also won’t be loaded). This reduces
+This prevents the <a id="wrglossary.2643"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+from automatically loading <a id="wrglossary.2644"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> (which means that
+the <a id="wrglossary.2645"></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.2649"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2650"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> package (unless
-you explicitly load <a id="wrglossary.2651"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>).
+<a id="wrglossary.2646"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2647"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> package (unless
+you explicitly load <a id="wrglossary.2648"></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.2652"></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.2653"></a><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a>.
+Some style packages implicitly load <a id="wrglossary.2649"></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.2650"></a><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a>.
</div><!-- end of information -->
<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.2654"></a><code class="code"><dfn id="glo:opt.nosuper"><span class="styoptfmt">nosuper</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2651"></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.2655"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
-from automatically loading <a id="wrglossary.2656"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> (which means that
-the <a id="wrglossary.2657"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a> package also won’t be loaded). This reduces
+This prevents the <a id="wrglossary.2652"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+from automatically loading <a id="wrglossary.2653"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> (which means that
+the <a id="wrglossary.2654"></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.2658"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2659"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> package
-(unless you explicitly load <a id="wrglossary.2660"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a>).
+<a id="wrglossary.2655"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2656"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> package
+(unless you explicitly load <a id="wrglossary.2657"></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.2661"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> has been
-loaded as it’s incompatible with <a id="wrglossary.2662"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a>. This option is
-also automatically implemented if <a id="wrglossary.2663"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a> isn’t installed.
+This option is automatically implemented if <a id="wrglossary.2658"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> has been
+loaded as it’s incompatible with <a id="wrglossary.2659"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a>. This option is
+also automatically implemented if <a id="wrglossary.2660"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2664"></a><code class="code"><dfn id="glo:opt.nolist"><span class="styoptfmt">nolist</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2661"></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.2665"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
-from automatically loading <a id="wrglossary.2666"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>. This reduces
+This prevents the <a id="wrglossary.2662"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+from automatically loading <a id="wrglossary.2663"></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.2667"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2668"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a> package
-(unless you explicitly load <a id="wrglossary.2669"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>).
-Note that since the default style is <a id="wrglossary.2670"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> (unless
-<a id="wrglossary.2671"></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.2672"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> option to set the style to
+<a id="wrglossary.2664"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2665"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a> package
+(unless you explicitly load <a id="wrglossary.2666"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>).
+Note that since the default style is <a id="wrglossary.2667"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> (unless
+<a id="wrglossary.2668"></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.2669"></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.2673"></a><code class="code"><dfn id="glo:opt.notree"><span class="styoptfmt">notree</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2670"></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.2674"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
-from automatically loading <a id="wrglossary.2675"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>. This reduces
+This prevents the <a id="wrglossary.2671"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+from automatically loading <a id="wrglossary.2672"></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.2676"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2677"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package
-(unless you explicitly load <a id="wrglossary.2678"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>). Note that if
-<a id="wrglossary.2679"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded, the default style is
-<a id="wrglossary.2680"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a>, which is provided by <a id="wrglossary.2681"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>.
+<a id="wrglossary.2673"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2674"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a> package
+(unless you explicitly load <a id="wrglossary.2675"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>). Note that if
+<a id="wrglossary.2676"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded, the default style is
+<a id="wrglossary.2677"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a>, which is provided by <a id="wrglossary.2678"></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.2682"></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.2683"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a>.
+Some style packages implicitly load <a id="wrglossary.2679"></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.2680"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a>.
</div><!-- end of information -->
<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.2684"></a><code class="code"><dfn id="glo:opt.nostyles"><span class="styoptfmt">nostyles</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2681"></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.2685"></a><a href="#glo:idx.glossarystyle">glossary style</a> package (such as <a id="wrglossary.2686"></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.2687"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> package option
-(unless you use <a id="wrglossary.2688"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> with <a id="wrglossary.2689"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>).
-Instead you must either use <a id="wrglossary.2690"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> or the
-<a id="wrglossary.2691"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2692"></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.2693"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>]{glossaries}
+<a id="wrglossary.2682"></a><a href="#glo:idx.glossarystyle">glossary style</a> package (such as <a id="wrglossary.2683"></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.2684"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> package option
+(unless you use <a id="wrglossary.2685"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> with <a id="wrglossary.2686"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>).
+Instead you must either use <a id="wrglossary.2687"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> or the
+<a id="wrglossary.2688"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2689"></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.2690"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>]{glossaries}
<code class="cmd">\usepackage</code>{glossary-mcols}
-<a id="wrglossary.2694"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{<a id="wrglossary.2695"></a><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a>}
+<a id="wrglossary.2691"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{<a id="wrglossary.2692"></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.2696"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.2697"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=mcols</span>,<a id="wrglossary.2698"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2699"></a><a href="#glo:opt.glostyle.mcoltree"><span class="glostylefmt">mcoltree</span></a></span>]{glossaries-extra}
+<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.2693"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.2694"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=mcols</span>,<a id="wrglossary.2695"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2696"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2700"></a><code class="code"><dfn id="glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2697"></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.2701"></a><a href="#glo:locationlist">number lists</a> in the
-<a id="wrglossary.2702"></a><a href="#glo:dual.glossary">glossaries</a> (see also §<a href="#sec:numberlists">12</a>).
+This option will suppress the associated <a id="wrglossary.2698"></a><a href="#glo:locationlist">number lists</a> in the
+<a id="wrglossary.2699"></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.2703"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2704"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a>
-<a id="wrglossary.2705"></a><a href="#glo:idx.printglossopt"><code class="csfmt">\print<span class="meta">〈<em class="metainner">…</em>〉</span>glossary</code> options</a>.
+<a id="wrglossary.2700"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2701"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a>
+<a id="wrglossary.2702"></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.2706"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2707"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>)
-then the <a id="wrglossary.2708"></a><a href="#glo:dual.entrylocation">locations</a> must still be valid even if this
+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.2703"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2704"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>)
+then the <a id="wrglossary.2705"></a><a href="#glo:dual.entrylocation">locations</a> must still be valid even if this
setting is on. This package option merely
-prevents the <a id="wrglossary.2709"></a><a href="#glo:locationlist">number list</a> from being displayed, but both
-<a id="wrglossary.2710"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2711"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> still require a <a id="wrglossary.2712"></a><a href="#glo:dual.entrylocation">location</a> or
-cross-reference for each term that’s <a id="wrglossary.2713"></a><a href="#glo:dual.indexing">indexed</a>.
+prevents the <a id="wrglossary.2706"></a><a href="#glo:locationlist">number list</a> from being displayed, but both
+<a id="wrglossary.2707"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2708"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> still require a <a id="wrglossary.2709"></a><a href="#glo:dual.entrylocation">location</a> or
+cross-reference for each term that’s <a id="wrglossary.2710"></a><a href="#glo:dual.indexing">indexed</a>.
</div><!-- end of warning -->
<p>
-Remember that <a id="wrglossary.2714"></a><a href="#glo:locationlist">number list</a> includes any cross-references, so
-suppressing the <a id="wrglossary.2715"></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.2716"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>).
+Remember that <a id="wrglossary.2711"></a><a href="#glo:locationlist">number list</a> includes any cross-references, so
+suppressing the <a id="wrglossary.2712"></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.2713"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>).
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2717"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2714"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-With <a id="wrglossary.2718"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s more efficient to use
-<a id="wrglossary.2719"></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.2720"></a><a href="#glo:dual.entrylocation">locations</a> are required.
+With <a id="wrglossary.2715"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s more efficient to use
+<a id="wrglossary.2716"></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.2717"></a><a href="#glo:dual.entrylocation">locations</a> are required.
</div><!-- end of information -->
<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.2721"></a><code class="code"><dfn id="glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2718"></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.2722"></a><a href="#glo:locationlist">number lists</a> with <a id="wrglossary.2723"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a>, described above, this
+<a id="wrglossary.2719"></a><a href="#glo:locationlist">number lists</a> with <a id="wrglossary.2720"></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.2724"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key in <a id="wrglossary.2725"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> or <a id="wrglossary.2726"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. If you
-use <a id="wrglossary.2727"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>, the <a id="wrglossary.2728"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key will
-automatically implement <a id="wrglossary.2729"></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.2730"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>.) For further details see
+<a id="wrglossary.2721"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key in <a id="wrglossary.2722"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> or <a id="wrglossary.2723"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. If you
+use <a id="wrglossary.2724"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>, the <a id="wrglossary.2725"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key will
+automatically implement <a id="wrglossary.2726"></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.2727"></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.2731"></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 -->
+<a id="wrglossary.2728"></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.2732"></a><a href="#glo:locationlist">number lists</a> (see
+default counter to use in the <a id="wrglossary.2729"></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.2733"></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.2734"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> or the <a id="wrglossary.2735"></a><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a> key when defining an
-entry or by the <a id="wrglossary.2736"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a> option when referencing an entry.
+specific <a id="wrglossary.2730"></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.2731"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> or the <a id="wrglossary.2732"></a><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a> key when defining an
+entry or by the <a id="wrglossary.2733"></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.2737"></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 -->
+<a id="wrglossary.2734"></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.2738"></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 -->
+<a id="wrglossary.2735"></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.2739"></a><a href="#glo:idx.fullstop">full stop</a> in <a id="wrglossary.2740"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the
-post-description hook <a id="wrglossary.2741"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>.
+<a id="wrglossary.2736"></a><a href="#glo:idx.fullstop">full stop</a> in <a id="wrglossary.2737"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the
+post-description hook <a id="wrglossary.2738"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>.
<p>
-The default setting is <a id="wrglossary.2742"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> for the base
-<a id="wrglossary.2743"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2744"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> for
-<a id="wrglossary.2745"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+The default setting is <a id="wrglossary.2739"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> for the base
+<a id="wrglossary.2740"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2741"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> for
+<a id="wrglossary.2742"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2746"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2743"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.2747"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.2748"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a>, which
-is equivalent to <a id="wrglossary.2749"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>, and also
-<a id="wrglossary.2750"></a><a href="#glo:opt.postpunc"><span class="xtrstyoptfmt">postpunc</span></a>, which allows you to choose a different
+The <a id="wrglossary.2744"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.2745"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a>, which
+is equivalent to <a id="wrglossary.2746"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>, and also
+<a id="wrglossary.2747"></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 href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2751"></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 -->
+<a id="wrglossary.2748"></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.2752"></a><a href="#glo:idx.glossarystyle">glossary styles</a>.
+letter groups used by some of the predefined <a id="wrglossary.2749"></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.2753"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2754"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</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> options</a>.
+<a id="wrglossary.2750"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2751"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a>
+<a id="wrglossary.2752"></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.2756"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the
+This option is only relevant for <a id="wrglossary.2753"></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.2757"></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 -->
+<a id="wrglossary.2754"></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.2758"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2755"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-If you are using <a id="wrglossary.2759"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> without the <a id="wrglossary.2760"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or
-<a id="wrglossary.2761"></a><a href="#glo:switch.group"><span class="shortargfmt">-g</span></a>) switch then this option is irrelevant as
+If you are using <a id="wrglossary.2756"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> without the <a id="wrglossary.2757"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or
+<a id="wrglossary.2758"></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 href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2762"></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 -->
+<a id="wrglossary.2759"></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.2763"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package, which patches the
-predefined <a id="wrglossary.2764"></a><a href="#glo:idx.glossarystyle">glossary styles</a>. The <span class="meta">〈<em class="metainner">list</em>〉</span> argument is optional. If present,
+Loads the <a id="wrglossary.2760"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package, which patches the
+predefined <a id="wrglossary.2761"></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.2765"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.2762"></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 -->
@@ -10465,139 +10469,139 @@
<h2><!-- start of section header -->2.4. Indexing Options<span class="labellink"><a href="#sec:pkgopts-indexing">[link]</a></span></h2><!-- end of section header -->
<p>
-<a id="wrglossary.2766"></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.2767"></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 -->
+<a id="wrglossary.2763"></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.2764"></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.2768"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2769"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.)
-The <a id="wrglossary.2770"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key automatically <a id="wrglossary.2771"></a><a href="#glo:dual.indexing">indexes</a> the
-cross-referenced entry using <a id="wrglossary.2772"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. This means that if this
+(This option is only relevant with <a id="wrglossary.2765"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2766"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.)
+The <a id="wrglossary.2767"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key automatically <a id="wrglossary.2768"></a><a href="#glo:dual.indexing">indexes</a> the
+cross-referenced entry using <a id="wrglossary.2769"></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.2773"></a><a href="#glo:dual.indexingfile">indexing file</a> has been opened, the <a id="wrglossary.2774"></a><a href="#glo:dual.indexing">indexing</a> can’t be performed.
-Since this is easy to miss, the <a id="wrglossary.2775"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package by
-default issues an error message if the <a id="wrglossary.2776"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used
-before <a id="wrglossary.2777"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
+<a id="wrglossary.2770"></a><a href="#glo:dual.indexingfile">indexing file</a> has been opened, the <a id="wrglossary.2771"></a><a href="#glo:dual.indexing">indexing</a> can’t be performed.
+Since this is easy to miss, the <a id="wrglossary.2772"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package by
+default issues an error message if the <a id="wrglossary.2773"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used
+before <a id="wrglossary.2774"></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.2778"></a><a id="wrglossary.2779"></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.2775"></a><a id="wrglossary.2776"></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 href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2780"></a><a id="wrglossary.2781"></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 -->
+<a id="wrglossary.2777"></a><a id="wrglossary.2778"></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 href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2782"></a><a id="wrglossary.2783"></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 -->
+<a id="wrglossary.2779"></a><a id="wrglossary.2780"></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.2784"></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.2785"></a><a href="#glo:dual.indexing">indexing</a>, you can use
-<a id="wrglossary.2786"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=warn</span> or <a id="wrglossary.2787"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=ignore</span>.
+<a id="wrglossary.2781"></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.2782"></a><a href="#glo:dual.indexing">indexing</a>, you can use
+<a id="wrglossary.2783"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=warn</span> or <a id="wrglossary.2784"></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.2788"></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 -->
+<a id="wrglossary.2785"></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.2789"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2790"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+Only applicable to <a id="wrglossary.2786"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2787"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
As from v4.50, the initial setting is now
-<a id="wrglossary.2791"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>. Previously it was
-<a id="wrglossary.2792"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>.
+<a id="wrglossary.2788"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>. Previously it was
+<a id="wrglossary.2789"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>.
<p>
-Both <a id="wrglossary.2793"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2794"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are fussy about the <a id="wrglossary.2795"></a><a href="#glo:dual.entrylocation">location</a> syntax (<a id="wrglossary.2796"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> more so than <a id="wrglossary.2797"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) so, if
-<a id="wrglossary.2798"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>, the <a id="wrglossary.2799"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will try
+Both <a id="wrglossary.2790"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2791"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are fussy about the <a id="wrglossary.2792"></a><a href="#glo:dual.entrylocation">location</a> syntax (<a id="wrglossary.2793"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> more so than <a id="wrglossary.2794"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) so, if
+<a id="wrglossary.2795"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>, the <a id="wrglossary.2796"></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.2800"></a><a href="#glo:dual.entrylocation">location</a> to be substituted for a format that’s more acceptable to
-the <a id="wrglossary.2801"></a><a href="#glo:dual.indexingapp">indexing application</a>. This requires a bit of trickery to circumvent
+<a id="wrglossary.2797"></a><a href="#glo:dual.entrylocation">location</a> to be substituted for a format that’s more acceptable to
+the <a id="wrglossary.2798"></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.2802"></a><a href="#glo:dual.glossary">glossary</a>
+acceptable format (or you’re prepared to post-process the <a id="wrglossary.2799"></a><a href="#glo:dual.glossary">glossary</a>
file before passing it to the relevant indexing application) then
-use <a id="wrglossary.2803"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span> to avoid the complex escaping of
+use <a id="wrglossary.2800"></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.2804"></a><a href="#glo:dual.entrylocation">locations</a> (for example, <a id="wrglossary.2805"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> with the
-default <a id="wrglossary.2806"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.2807"></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.2808"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>. You may
+If, however, your <a id="wrglossary.2801"></a><a href="#glo:dual.entrylocation">locations</a> (for example, <a id="wrglossary.2802"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> with the
+default <a id="wrglossary.2803"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.2804"></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.2805"></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.2809"></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 -->
+<a id="wrglossary.2806"></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.2810"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a>.
+special characters without prematurely expanding <a id="wrglossary.2807"></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.2811"></a><code class="code"><dfn id="glo:glswrallowprimitivemodstrue"><code class="csfmt">\glswrallowprimitivemodstrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2808"></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.2812"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>.
+<a id="wrglossary.2809"></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.2813"></a><code class="code"><dfn id="glo:glswrallowprimitivemodsfalse"><code class="csfmt">\glswrallowprimitivemodsfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2810"></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.2814"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and your <a id="wrglossary.2815"></a><a href="#glo:dual.entrylocation">location</a> expands to
+If you are using <a id="wrglossary.2811"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and your <a id="wrglossary.2812"></a><a href="#glo:dual.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.2816"></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.2817"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, then you can use
-<a id="wrglossary.2818"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to make a suitable adjustment without
-<a id="wrglossary.2819"></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>
+a command (optionally preceded by <a id="wrglossary.2813"></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.2814"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, then you can use
+<a id="wrglossary.2815"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to make a suitable adjustment without
+<a id="wrglossary.2816"></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.2820"></a><a href="#glo:dual.entrylocation">locations</a> are written to
-the <a id="wrglossary.2821"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and both methods use LaTeX syntax, so no conversion is required.
+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.2817"></a><a href="#glo:dual.entrylocation">locations</a> are written to
+the <a id="wrglossary.2818"></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.2822"></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 -->
+<a id="wrglossary.2819"></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.2823"></a><a href="#glo:dual.indexing">index</a> on <a id="wrglossary.2824"></a><a href="#glo:dual.firstuse">first use</a>.
-The default setting <a id="wrglossary.2825"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="optfmt">=false</span>,
-will <a id="wrglossary.2826"></a><a href="#glo:dual.indexing">index</a> the entry every time one of the
-<a id="wrglossary.2827"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.2828"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are used. Note that <a id="wrglossary.2829"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>
-will always add information to the external <a id="wrglossary.2830"></a><a href="#glo:dual.glossary">glossary</a>
+If true, this setting will only <a id="wrglossary.2820"></a><a href="#glo:dual.indexing">index</a> on <a id="wrglossary.2821"></a><a href="#glo:dual.firstuse">first use</a>.
+The default setting <a id="wrglossary.2822"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="optfmt">=false</span>,
+will <a id="wrglossary.2823"></a><a href="#glo:dual.indexing">index</a> the entry every time one of the
+<a id="wrglossary.2824"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.2825"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are used. Note that <a id="wrglossary.2826"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>
+will always add information to the external <a id="wrglossary.2827"></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.2831"></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 -->
+<a id="wrglossary.2828"></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.2832"></a><code class="code"><dfn id="glo:glsindexonlyfirsttrue"><code class="csfmt">\glsindexonlyfirsttrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2829"></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.2833"></a><code class="code"><dfn id="glo:glsindexonlyfirstfalse"><code class="csfmt">\glsindexonlyfirstfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2830"></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 href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Resetting the <a id="wrglossary.2834"></a><a href="#glo:dual.firstuseflag">first use flag</a> with commands like
-<a id="wrglossary.2835"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> after an entry has been <a id="wrglossary.2836"></a><a href="#glo:dual.indexing">indexed</a> will cause that entry to be
+Resetting the <a id="wrglossary.2831"></a><a href="#glo:dual.firstuseflag">first use flag</a> with commands like
+<a id="wrglossary.2832"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> after an entry has been <a id="wrglossary.2833"></a><a href="#glo:dual.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.2837"></a><a href="#glo:dual.firstuseflag">first use flag</a> before an entry has been
+Likewise unsetting the <a id="wrglossary.2834"></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.2838"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>).
+indexed with <a id="wrglossary.2835"></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 href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
-<a id="wrglossary.2839"></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 -->
+<a id="wrglossary.2836"></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.2840"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a> is:
-<pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.2841"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a>}[2]{<span class="comment">% </span>
- <a id="wrglossary.2842"></a><a href="#glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></a>
- <a id="wrglossary.2843"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}<span class="comment">% </span>
+The default definition of <a id="wrglossary.2837"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a> is:
+<pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.2838"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.2839"></a><a href="#glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></a>
+ <a id="wrglossary.2840"></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>
@@ -10604,15 +10608,15 @@
}
</pre>
This does <span class="meta">〈<em class="metainner">indexing code</em>〉</span> unless
-<a id="wrglossary.2844"></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.2845"></a><a href="#glo:firstuseflag">used</a>
+<a id="wrglossary.2841"></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.2842"></a><a href="#glo:firstuseflag">used</a>
<p>
-For example, suppose you only want to index the <a id="wrglossary.2846"></a><a href="#glo:dual.firstuse">first use</a> for
-entries in the <a id="wrglossary.2847"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossary and not in the
-<a id="wrglossary.2848"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> (or any other) <a id="wrglossary.2849"></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.2850"></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.2851"></a><a href="#glo:glsentrytype"><code class="csfmt">\glsentrytype</code></a>{#1}}{acronym}
- {<a id="wrglossary.2852"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}}<span class="comment">% </span>
+For example, suppose you only want to index the <a id="wrglossary.2843"></a><a href="#glo:dual.firstuse">first use</a> for
+entries in the <a id="wrglossary.2844"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossary and not in the
+<a id="wrglossary.2845"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> (or any other) <a id="wrglossary.2846"></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.2847"></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.2848"></a><a href="#glo:glsentrytype"><code class="csfmt">\glsentrytype</code></a>{#1}}{acronym}
+ {<a id="wrglossary.2849"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}}<span class="comment">% </span>
{#2}<span class="comment">% </span>
}
</pre>
@@ -10621,124 +10625,124 @@
There are other methods of performing an expanded string comparison,
which you may prefer to use.
<p>
-With the <a id="wrglossary.2853"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package it’s possible to only index
-<a id="wrglossary.2854"></a><a href="#glo:dual.firstuse">first use</a> for particular categories. For example, if you only
-want this enabled for <a id="wrglossary.2855"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you can set
-the <a id="wrglossary.2856"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> <a id="wrglossary.2857"></a><a href="#glo:idx.categoryattribute">attribute</a>
-for the <a id="wrglossary.2858"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>
-and, if appropriate, <a id="wrglossary.2859"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the
-<a id="wrglossary.2860"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option.) See the
-<a id="wrglossary.2861"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+With the <a id="wrglossary.2850"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package it’s possible to only index
+<a id="wrglossary.2851"></a><a href="#glo:dual.firstuse">first use</a> for particular categories. For example, if you only
+want this enabled for <a id="wrglossary.2852"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you can set
+the <a id="wrglossary.2853"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> <a id="wrglossary.2854"></a><a href="#glo:idx.categoryattribute">attribute</a>
+for the <a id="wrglossary.2855"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>
+and, if appropriate, <a id="wrglossary.2856"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the
+<a id="wrglossary.2857"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option.) See the
+<a id="wrglossary.2858"></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.2862"></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 -->
+<a id="wrglossary.2859"></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.2863"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
-If true, this will automatically index (<a id="wrglossary.2864"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) any
+This option is only available with <a id="wrglossary.2860"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+If true, this will automatically index (<a id="wrglossary.2861"></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.2865"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.2862"></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.2866"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<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 -->
-Note that <a id="wrglossary.2867"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can automatically find dependent entries
-when it parses the <a id="wrglossary.2868"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. Use the <a id="wrglossary.2869"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> option
+Note that <a id="wrglossary.2864"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can automatically find dependent entries
+when it parses the <a id="wrglossary.2865"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. Use the <a id="wrglossary.2866"></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 href="#glo:sym.toggleonsetting"><span title="Toggle (On)" class="icon"><span class="fwsactiveicon">🔘</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2870"></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 -->
+<a id="wrglossary.2867"></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.2871"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
-The base <a id="wrglossary.2872"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package always implements
-<a id="wrglossary.2873"></a><a href="#glo:opt.autoseeindex"><span class="xtrstyoptfmt">autoseeindex</span></a><span class="optfmt">=true</span>.
+This option is only available with <a id="wrglossary.2868"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+The base <a id="wrglossary.2869"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package always implements
+<a id="wrglossary.2870"></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.2874"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and
-<a id="wrglossary.2875"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys automatically index the entry
-(with <a id="wrglossary.2876"></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.2877"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> (or <a id="wrglossary.2878"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a>) key will
-automatically be added to the <a id="wrglossary.2879"></a><a href="#glo:dual.glossary">glossary</a>. See the
-<a id="wrglossary.2880"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+If true, this makes the <a id="wrglossary.2871"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and
+<a id="wrglossary.2872"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys automatically index the entry
+(with <a id="wrglossary.2873"></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.2874"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> (or <a id="wrglossary.2875"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a>) key will
+automatically be added to the <a id="wrglossary.2876"></a><a href="#glo:dual.glossary">glossary</a>. See the
+<a id="wrglossary.2877"></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.2881"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2878"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-With <a id="wrglossary.2882"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.2883"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> resource option
+With <a id="wrglossary.2879"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.2880"></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 href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2884"></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 -->
+<a id="wrglossary.2881"></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.2885"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
-See <a id="wrglossary.2886"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details. A brief
+This option is only available with <a id="wrglossary.2882"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+See <a id="wrglossary.2883"></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.2887"></a><a id="wrglossary.2888"></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 -->
+<a id="wrglossary.2884"></a><a id="wrglossary.2885"></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.2889"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> isn’t being used.
+This default setting indicates that <a id="wrglossary.2886"></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.2890"></a><a id="wrglossary.2891"></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 -->
+<a id="wrglossary.2887"></a><a id="wrglossary.2888"></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.2892"></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.2893"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files, to sort the entries and collate the
-<a id="wrglossary.2894"></a><a href="#glo:locationlist">number lists</a>, where the <a id="wrglossary.2895"></a><a href="#glo:dual.entrylocation">location</a> information is the same as
+This setting indicates that <a id="wrglossary.2889"></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.2890"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files, to sort the entries and collate the
+<a id="wrglossary.2891"></a><a href="#glo:locationlist">number lists</a>, where the <a id="wrglossary.2892"></a><a href="#glo:dual.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.2896"></a><a id="wrglossary.2897"></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 -->
+<a id="wrglossary.2893"></a><a id="wrglossary.2894"></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.2898"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> but provides extra
+This setting is like <a id="wrglossary.2895"></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.2899"></a><a id="wrglossary.2900"></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 -->
+<a id="wrglossary.2896"></a><a id="wrglossary.2897"></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.2901"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
-is used to fetch entries from one or more <a id="wrglossary.2902"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files but
-<a id="wrglossary.2903"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2904"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are used for the <a id="wrglossary.2905"></a><a href="#glo:dual.indexing">indexing</a>. This
+This setting indicates a hybrid approach where <a id="wrglossary.2898"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
+is used to fetch entries from one or more <a id="wrglossary.2899"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files but
+<a id="wrglossary.2900"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2901"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are used for the <a id="wrglossary.2902"></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.2906"></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 -->
+<a id="wrglossary.2903"></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.2907"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+This option is only available with <a id="wrglossary.2904"></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.2908"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to <a id="wrglossary.2909"></a><a href="#glo:ctr.equation"><span class="ctrfmt">equation</span></a> when inside a
+<a id="wrglossary.2905"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to <a id="wrglossary.2906"></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.2910"></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 -->
+<a id="wrglossary.2907"></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.2911"></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.2912"></a><a href="#glo:dual.locationcounter">location counter</a>
+This option is only available with <a id="wrglossary.2908"></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.2909"></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.2913"></a><a href="#glo:caption"><code class="csfmt">\caption</code></a> command that
+float. (Remember that with floats it’s the <a id="wrglossary.2910"></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.2914"></a><a href="#glo:dual.indexing">indexed</a> within the float before the caption.)
+is <a id="wrglossary.2911"></a><a href="#glo:dual.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.2915"></a><code class="code"><dfn id="glo:opt.indexcounter"><span class="xtrstyoptfmt">indexcounter</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2912"></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.2916"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+This option is only available with <a id="wrglossary.2913"></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.2917"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and <a id="wrglossary.2918"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> allowing the page location
-<a id="wrglossary.2919"></a><a href="#glo:idx.hyperlink">hyperlink</a> target to be set to the relevant point within the page
+<a id="wrglossary.2914"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and <a id="wrglossary.2915"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> allowing the page location
+<a id="wrglossary.2916"></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.2920"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for
+with other indexing methods. See <a id="wrglossary.2917"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for
further details.
-<a id="wrglossary.2921"></a>
+<a id="wrglossary.2918"></a>
<p>
</section><!-- end of section sec:pkgopts-indexing -->
@@ -10747,225 +10751,225 @@
<h2><!-- start of section header -->2.5. Sorting Options<span class="labellink"><a href="#sec:pkgopts-sort">[link]</a></span></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.2922"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> and
-<a id="wrglossary.2923"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> options are applicable for <a id="wrglossary.2924"></a><a href="#glo:idx.opt.noidx">Option 1</a>.
+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.2919"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> and
+<a id="wrglossary.2920"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> options are applicable for <a id="wrglossary.2921"></a><a href="#glo:idx.opt.noidx">Option 1</a>.
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.2925"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2922"></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.2926"></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.2927"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2928"></a><a href="#glo:optval.record.only"><span class="xtroptfmt">only</span></a> and
-<a id="wrglossary.2929"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2930"></a><a href="#glo:optval.record.nameref"><span class="xtroptfmt">nameref</span></a>). With <a id="wrglossary.2931"></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.2932"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>
-not with the <a id="wrglossary.2933"></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.b2g">4</a>, <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a>, only <a id="wrglossary.2923"></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.2924"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2925"></a><a href="#glo:optval.record.only"><span class="xtroptfmt">only</span></a> and
+<a id="wrglossary.2926"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2927"></a><a href="#glo:optval.record.nameref"><span class="xtroptfmt">nameref</span></a>). With <a id="wrglossary.2928"></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.2929"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>
+not with the <a id="wrglossary.2930"></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 href="#glo:sym.toggleoffsetting"><span title="Toggle (Off)" class="icon"><span class="fwsdisabledicon">🔘︎</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.2934"></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 -->
+<a id="wrglossary.2931"></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.2935"></a><a href="#glo:dual.sanitize">sanitize</a> the sort value when
-writing to the external <a id="wrglossary.2936"></a><a href="#glo:dual.indexingfile">indexing file</a>. For example, suppose you
+This option determines whether or not to <a id="wrglossary.2932"></a><a href="#glo:dual.sanitize">sanitize</a> the sort value when
+writing to the external <a id="wrglossary.2933"></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.2937"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hash}{<a id="wrglossary.2938"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.2939"></a><a href="#glo:cs.hash"><code class="csfmt">\#</code></a>}</span>,<a id="wrglossary.2940"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<a id="wrglossary.2941"></a><a href="#glo:idx.sym.hash"></a>}</span>,
- <a id="wrglossary.2942"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={hash symbol}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2934"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hash}{<a id="wrglossary.2935"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.2936"></a><a href="#glo:cs.hash"><code class="csfmt">\#</code></a>}</span>,<a id="wrglossary.2937"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<a id="wrglossary.2938"></a><a href="#glo:idx.sym.hash"></a>}</span>,
+ <a id="wrglossary.2939"></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.2943"></a><a href="#glo:idx.sym.hash"></a>) must be sanitized before writing it to the
-<a id="wrglossary.2944"></a><a href="#glo:dual.indexingfile">indexing file</a>, otherwise LaTeX will try to interpret it as a
+The sort value (<a id="wrglossary.2940"></a><a href="#glo:idx.sym.hash"></a>) must be sanitized before writing it to the
+<a id="wrglossary.2941"></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.2945"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<span class="comment">% </span>
- <a id="wrglossary.2946"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
- <a id="wrglossary.2947"></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.2948"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<a id="wrglossary.2942"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<span class="comment">% </span>
+ <a id="wrglossary.2943"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.2944"></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.2945"></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.2949"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a>false.
+<a id="wrglossary.2946"></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.2950"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>, and the
-default for <a id="wrglossary.2951"></a><a href="#glo:idx.opt.noidx">Option 1</a> is <a id="wrglossary.2952"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span>.
+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.2947"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>, and the
+default for <a id="wrglossary.2948"></a><a href="#glo:idx.opt.noidx">Option 1</a> is <a id="wrglossary.2949"></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.2953"></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 -->
+<a id="wrglossary.2950"></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.2954"></a><a href="#glo:idx.opt.noidx">Option 1</a> allows you to specify sort methods for individual glossaries
-via the <a id="wrglossary.2955"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> key in the optional
-argument of <a id="wrglossary.2956"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. If you have multiple
-<a id="wrglossary.2957"></a><a href="#glo:dual.glossary">glossaries</a> in your document and you are using <a id="wrglossary.2958"></a><a href="#glo:idx.opt.noidx">Option 1</a>, only use
+<a id="wrglossary.2951"></a><a href="#glo:idx.opt.noidx">Option 1</a> allows you to specify sort methods for individual glossaries
+via the <a id="wrglossary.2952"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> key in the optional
+argument of <a id="wrglossary.2953"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. If you have multiple
+<a id="wrglossary.2954"></a><a href="#glo:dual.glossary">glossaries</a> in your document and you are using <a id="wrglossary.2955"></a><a href="#glo:idx.opt.noidx">Option 1</a>, only use
the package options
-<a id="wrglossary.2959"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2960"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.2961"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2962"></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.2963"></a><a href="#glo:dual.glossary">glossaries</a>.
+<a id="wrglossary.2956"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2957"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.2958"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2959"></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.2960"></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.2964"></a><a id="wrglossary.2965"></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 -->
+<a id="wrglossary.2961"></a><a id="wrglossary.2962"></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.2966"></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.2967"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> (<a id="wrglossary.2968"></a><a href="#glo:idx.opt.noidx">Option 1</a>). It omits the code used
+<a id="wrglossary.2963"></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.2964"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> (<a id="wrglossary.2965"></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.2969"></a><a href="#glo:dual.glossary">glossary</a> is required or if <a id="wrglossary.2970"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> is used
-(<a id="wrglossary.2971"></a><a href="#glo:idx.opt.unsrt">Option 5</a>). If you want an unsorted <a id="wrglossary.2972"></a><a href="#glo:dual.glossary">glossary</a> with
-<a id="wrglossary.2973"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the resource option <a id="wrglossary.2974"></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.2975"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to
+<a id="wrglossary.2966"></a><a href="#glo:dual.glossary">glossary</a> is required or if <a id="wrglossary.2967"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> is used
+(<a id="wrglossary.2968"></a><a href="#glo:idx.opt.unsrt">Option 5</a>). If you want an unsorted <a id="wrglossary.2969"></a><a href="#glo:dual.glossary">glossary</a> with
+<a id="wrglossary.2970"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the resource option <a id="wrglossary.2971"></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.2972"></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.2976"></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.2977"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
-key set to an empty value instead, use <a id="wrglossary.2978"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2979"></a><a href="#glo:optval.sort.clear"><span class="optfmt">clear</span></a>
+This option will still assign the <a id="wrglossary.2973"></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.2974"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
+key set to an empty value instead, use <a id="wrglossary.2975"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2976"></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 href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.2980"></a><a id="wrglossary.2981"></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 -->
+<a id="wrglossary.2977"></a><a id="wrglossary.2978"></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.2982"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2983"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> but sets the <a id="wrglossary.2984"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to an
-empty value. This will affect <a id="wrglossary.2985"></a><a href="#glo:idx.group">letter group</a> formations in
-<a id="wrglossary.2986"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> with <a id="wrglossary.2987"></a><a href="#glo:idx.opt.unsrt">Option 5</a>. See the
-<a id="wrglossary.2988"></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.2989"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">none</code>. The remaining
-<a id="wrglossary.2990"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> options listed below don’t change <a id="wrglossary.2991"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a>.
+As <a id="wrglossary.2979"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2980"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> but sets the <a id="wrglossary.2981"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to an
+empty value. This will affect <a id="wrglossary.2982"></a><a href="#glo:idx.group">letter group</a> formations in
+<a id="wrglossary.2983"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> with <a id="wrglossary.2984"></a><a href="#glo:idx.opt.unsrt">Option 5</a>. See the
+<a id="wrglossary.2985"></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.2986"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">none</code>. The remaining
+<a id="wrglossary.2987"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> options listed below don’t change <a id="wrglossary.2988"></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.2992"></a><a id="wrglossary.2993"></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 -->
+<a id="wrglossary.2989"></a><a id="wrglossary.2990"></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.2994"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this is implemented by
+which they were defined. With <a id="wrglossary.2991"></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.2995"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2996"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). This
+(since that’s the purpose of <a id="wrglossary.2992"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2993"></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.2997"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is assigned a numeric value that’s incremented
+<a id="wrglossary.2994"></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.2998"></a><a id="wrglossary.2999"></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 -->
+<a id="wrglossary.2995"></a><a id="wrglossary.2996"></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.3000"></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.3001"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file is input
+the document. With <a id="wrglossary.2997"></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.2998"></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.3002"></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.3003"></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.3004"></a><a href="#glo:dual.indexing">indexed</a>.
+<a id="wrglossary.2999"></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.3000"></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.3001"></a><a href="#glo:dual.indexing">indexed</a>.
<p>
-Both <a id="wrglossary.3005"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3006"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> and <a id="wrglossary.3007"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3008"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> zero-pad the sort key to a
+Both <a id="wrglossary.3002"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3003"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> and <a id="wrglossary.3004"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3005"></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.3009"></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 -->
+<a id="wrglossary.3006"></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.3010"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3011"></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.3012"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3013"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a>).
+case of <a id="wrglossary.3007"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3008"></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.3009"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3010"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a>).
<p>
-Note that the <a id="wrglossary.3014"></a><a href="#glo:idx.group">group</a> styles (such as <a id="wrglossary.3015"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a>) are
-incompatible with the <a id="wrglossary.3016"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3017"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> and <a id="wrglossary.3018"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3019"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>
+Note that the <a id="wrglossary.3011"></a><a href="#glo:idx.group">group</a> styles (such as <a id="wrglossary.3012"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a>) are
+incompatible with the <a id="wrglossary.3013"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3014"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> and <a id="wrglossary.3015"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3016"></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.3020"></a><a id="wrglossary.3021"></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 -->
+<a id="wrglossary.3017"></a><a id="wrglossary.3018"></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.3022"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key
-used in <a id="wrglossary.3023"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> (if present) or the <a id="wrglossary.3024"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>
-key (if <a id="wrglossary.3025"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is missing).
+Entries are sorted according to the value of the <a id="wrglossary.3019"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key
+used in <a id="wrglossary.3020"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> (if present) or the <a id="wrglossary.3021"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>
+key (if <a id="wrglossary.3022"></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.3026"></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 -->
+<a id="wrglossary.3023"></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.3027"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
-key or implicitly set via the <a id="wrglossary.3028"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key) before any escaping of the
-<a id="wrglossary.3029"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.3030"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> special characters is performed.
-By default <a id="wrglossary.3031"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> just does:
+sort value (which was either explicitly set via the <a id="wrglossary.3024"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
+key or implicitly set via the <a id="wrglossary.3025"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key) before any escaping of the
+<a id="wrglossary.3026"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.3027"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> special characters is performed.
+By default <a id="wrglossary.3028"></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.3032"></a><code class="code"><dfn id="glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></dfn></code>
+<a id="wrglossary.3029"></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.3033"></a><a href="#glo:dual.sanitize">sanitizes</a> <span class="meta">〈<em class="metainner">sort cs</em>〉</span> if <a id="wrglossary.3034"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>
-(or does nothing if <a id="wrglossary.3035"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span>).
+which <a id="wrglossary.3030"></a><a href="#glo:dual.sanitize">sanitizes</a> <span class="meta">〈<em class="metainner">sort cs</em>〉</span> if <a id="wrglossary.3031"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>
+(or does nothing if <a id="wrglossary.3032"></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.3036"></a><a href="#glo:dual.glossary">glossary</a> type and the entry label for the current entry. Note that
+<a id="wrglossary.3033"></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.3037"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>.
+be in the form used in the first argument of <a id="wrglossary.3034"></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.3038"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> won’t affect any entries that
+Redefining <a id="wrglossary.3035"></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.3039"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> setting.
+use another <a id="wrglossary.3036"></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 11: Mixing Alphabetical and Order of Definition Sorting</div>
-Suppose I have three <a id="wrglossary.3040"></a><a href="#glo:dual.glossary">glossaries</a>: <a id="wrglossary.3041"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>,
-<a id="wrglossary.3042"></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.3043"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3044"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossaries to be
+Suppose I have three <a id="wrglossary.3037"></a><a href="#glo:dual.glossary">glossaries</a>: <a id="wrglossary.3038"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>,
+<a id="wrglossary.3039"></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.3040"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3041"></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.3045"></a><a href="#glo:idx.opt.noidx">Option 1</a>, the <a id="wrglossary.3046"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> option can be
-used in <a id="wrglossary.3047"></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.3048"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3049"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
-<a id="wrglossary.3050"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3051"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3052"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3053"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
-<a id="wrglossary.3054"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3055"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=notation</span>,<a id="wrglossary.3056"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=def</span>]
+For <a id="wrglossary.3042"></a><a href="#glo:idx.opt.noidx">Option 1</a>, the <a id="wrglossary.3043"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> option can be
+used in <a id="wrglossary.3044"></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.3045"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3046"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.3047"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3048"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3049"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3050"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.3051"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3052"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=notation</span>,<a id="wrglossary.3053"></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.3057"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3058"></a><a href="#glo:optval.sort.standard"><span class="optfmt">standard</span></a>
+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.3054"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3055"></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.3059"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3060"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> entries, then
-redefine <a id="wrglossary.3061"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> to set <span class="meta">〈<em class="metainner">sort cs</em>〉</span> to
+all my <a id="wrglossary.3056"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3057"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> entries, then
+redefine <a id="wrglossary.3058"></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.3062"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> to check for the glossary type and only
+<a id="wrglossary.3059"></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.3063"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.3060"></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.3064"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3065"></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.3061"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3062"></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 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.3066"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.3063"></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.3067"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3068"></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.3064"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3065"></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.3069"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
+ <a id="wrglossary.3066"></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.3070"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> package, which
-is automatically loaded by <a id="wrglossary.3071"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>.)
-For a complete document, see the sample file <a id="wrglossary.3072"></a><a href="#glo:file.sampleSort.tex"><span class="filefmt">sampleSort.tex</span></a>.
+(<code class="csfmt">\ifdefstring</code> is defined by the <a id="wrglossary.3067"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> package, which
+is automatically loaded by <a id="wrglossary.3068"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>.)
+For a complete document, see the sample file <a id="wrglossary.3069"></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 12: Customizing Standard Sort (Options
2 or 3)</div>
-Suppose you want a <a id="wrglossary.3073"></a><a href="#glo:dual.glossary">glossary</a> of people and you want the names listed
+Suppose you want a <a id="wrglossary.3070"></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.3074"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key when you define the entry, but hook into the
+<a id="wrglossary.3071"></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>
@@ -10976,15 +10980,15 @@
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.3075"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> so that it temporarily sets
+Now redefine <a id="wrglossary.3072"></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.3076"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
+<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.3073"></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.3077"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
+ <a id="wrglossary.3074"></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
@@ -10991,145 +10995,145 @@
protect fragile commands, but care is still needed.)
<p>
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.3078"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{joebloggs}<a id="wrglossary.3079"></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.3080"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={some information about Joe Bloggs}</span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3075"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{joebloggs}<a id="wrglossary.3076"></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.3077"></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.3081"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{johnsmith}{<a id="wrglossary.3082"></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.3083"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={some information about John Smith}</span>}
+<a id="wrglossary.3078"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{johnsmith}{<a id="wrglossary.3079"></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.3080"></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.3084"></a><a href="#glo:file.samplePeople.tex"><span class="filefmt">samplePeople.tex</span></a>.
+For a complete document, see the sample file <a id="wrglossary.3081"></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.3085"></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.3082"></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 href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3086"></a><a id="wrglossary.3087"></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 -->
+<a id="wrglossary.3083"></a><a id="wrglossary.3084"></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.3088"></a><a id="wrglossary.3089"></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 -->
+<a id="wrglossary.3085"></a><a id="wrglossary.3086"></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.3090"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> option has
-no effect if you explicitly call <a id="wrglossary.3091"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3092"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+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.3087"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> option has
+no effect if you explicitly call <a id="wrglossary.3088"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3089"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
</div><!-- end of important -->
<p>
-If you use <a id="wrglossary.3093"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this setting will be used if you use
-<a id="wrglossary.3094"></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.3095"></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.3096"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3097"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=standard</span>]
+If you use <a id="wrglossary.3090"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this setting will be used if you use
+<a id="wrglossary.3091"></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.3092"></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.3093"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3094"></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.3098"></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.3099"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3100"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
-<a id="wrglossary.3101"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3102"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3103"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3104"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=letter</span>]
+<a id="wrglossary.3095"></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.3096"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3097"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.3098"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3099"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3100"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3101"></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.3105"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3102"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-With <a id="wrglossary.3106"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.3107"></a><a href="#glo:opt.resource.break-at"><span class="xtrcsoptfmt">break-at</span></a> option
-in <a id="wrglossary.3108"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> instead of <a id="wrglossary.3109"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>.
+With <a id="wrglossary.3103"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.3104"></a><a href="#glo:opt.resource.break-at"><span class="xtrcsoptfmt">break-at</span></a> option
+in <a id="wrglossary.3105"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> instead of <a id="wrglossary.3106"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a>.
</div><!-- end of information -->
<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.3110"></a><code class="code"><dfn id="glo:opt.makeindex"><span class="styoptfmt">makeindex</span></dfn></code>
+<a id="wrglossary.3107"></a><code class="code"><dfn id="glo:opt.makeindex"><span class="styoptfmt">makeindex</span></dfn></code>
<p>
-<div class="noteBox"><a id="wrglossary.3111"></a><a href="#glo:idx.opt.mkidx">Option 2</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3108"></a><a href="#glo:idx.opt.mkidx">Option 2</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
-The <a id="wrglossary.3112"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3113"></a><a href="#glo:dual.indexing">indexing</a> style file will be
-written in <a id="wrglossary.3114"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> format. If you use <a id="wrglossary.3115"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-or <a id="wrglossary.3116"></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.3117"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. If you don’t use
-<a id="wrglossary.3118"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to remember to use <a id="wrglossary.3119"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-not <a id="wrglossary.3120"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The indexing style file will been given a <a id="wrglossary.3121"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>
+The <a id="wrglossary.3109"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3110"></a><a href="#glo:dual.indexing">indexing</a> style file will be
+written in <a id="wrglossary.3111"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> format. If you use <a id="wrglossary.3112"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+or <a id="wrglossary.3113"></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.3114"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. If you don’t use
+<a id="wrglossary.3115"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to remember to use <a id="wrglossary.3116"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+not <a id="wrglossary.3117"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The indexing style file will been given a <a id="wrglossary.3118"></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.3122"></a><a href="#glo:idx.opt.mkidx">Option 2</a> as this is the
+You may omit this package option if you are using <a id="wrglossary.3119"></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.3123"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> in the package option list.
+occurrence of <a id="wrglossary.3120"></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.3124"></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>
+<a id="wrglossary.3121"></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.3125"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3122"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
-The <a id="wrglossary.3126"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3127"></a><a href="#glo:dual.indexing">indexing</a> style
-file will be written in <a id="wrglossary.3128"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format. If you use
-<a id="wrglossary.3129"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, it will automatically detect that it needs to
-call <a id="wrglossary.3130"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. If you don’t use <a id="wrglossary.3131"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to
-remember to use <a id="wrglossary.3132"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> not <a id="wrglossary.3133"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. The indexing style
-file will been given a <a id="wrglossary.3134"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension.
+The <a id="wrglossary.3123"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3124"></a><a href="#glo:dual.indexing">indexing</a> style
+file will be written in <a id="wrglossary.3125"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format. If you use
+<a id="wrglossary.3126"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, it will automatically detect that it needs to
+call <a id="wrglossary.3127"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. If you don’t use <a id="wrglossary.3128"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to
+remember to use <a id="wrglossary.3129"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> not <a id="wrglossary.3130"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. The indexing style
+file will been given a <a id="wrglossary.3131"></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.3135"></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.3136"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
-with the <a id="wrglossary.3137"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
+these options are irrelevant if you explicitly call <a id="wrglossary.3132"></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.3133"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+with the <a id="wrglossary.3134"></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.3138"></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 -->
+<a id="wrglossary.3135"></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.3139"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> otherwise the syntax in the <a id="wrglossary.3140"></a><a href="#glo:dual.glossary">glossary</a>
+<a id="wrglossary.3136"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> otherwise the syntax in the <a id="wrglossary.3137"></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.3141"></a><a href="#glo:idx.opt.xdy">Option 3</a> is in effect. (If you need to
+any option other than <a id="wrglossary.3138"></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.3142"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> instead.)
+<a id="wrglossary.3139"></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.3143"></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 -->
+<a id="wrglossary.3140"></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.3144"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the
-<a id="wrglossary.3145"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> switch. The default is obtained from <a id="wrglossary.3146"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a>
-but note that this may not be correct as <a id="wrglossary.3147"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> has a different
-labelling system to <a id="wrglossary.3148"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.3149"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>.
+The language module to use, which is passed to <a id="wrglossary.3141"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the
+<a id="wrglossary.3142"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> switch. The default is obtained from <a id="wrglossary.3143"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a>
+but note that this may not be correct as <a id="wrglossary.3144"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> has a different
+labelling system to <a id="wrglossary.3145"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.3146"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>.
<p>
-The <a id="wrglossary.3150"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script has a set of mappings of known
-<a id="wrglossary.3151"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> language names to <a id="wrglossary.3152"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language names, but new
-<a id="wrglossary.3153"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> dialect names may not be included. The
-<a id="wrglossary.3154"></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.3155"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> instead of
-<a id="wrglossary.3156"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when using <a id="wrglossary.3157"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). The <a id="wrglossary.3158"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=o</span>ption that calls <a id="wrglossary.3159"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly also doesn’t use any
+The <a id="wrglossary.3147"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script has a set of mappings of known
+<a id="wrglossary.3148"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> language names to <a id="wrglossary.3149"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language names, but new
+<a id="wrglossary.3150"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> dialect names may not be included. The
+<a id="wrglossary.3151"></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.3152"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> instead of
+<a id="wrglossary.3153"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when using <a id="wrglossary.3154"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). The <a id="wrglossary.3155"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=o</span>ption that calls <a id="wrglossary.3156"></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.3160"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a> may still not expand to the language required for
-the <a id="wrglossary.3161"></a><a href="#glo:dual.glossary">glossary</a>. In which case, you need to specify the correct
-<a id="wrglossary.3162"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language. For example:
+<a id="wrglossary.3157"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a> may still not expand to the language required for
+the <a id="wrglossary.3158"></a><a href="#glo:dual.glossary">glossary</a>. In which case, you need to specify the correct
+<a id="wrglossary.3159"></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.3163"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3164"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=portuguese</span></span>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.3160"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3161"></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.3165"></a><a href="#glo:dual.glossary">glossaries</a> in different languages, use
-<a id="wrglossary.3166"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> to set the language for each glossary.
+If you have multiple <a id="wrglossary.3162"></a><a href="#glo:dual.glossary">glossaries</a> in different languages, use
+<a id="wrglossary.3163"></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.3167"></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 -->
+<a id="wrglossary.3164"></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.3168"></a><a href="#glo:idx.codepage">codepage</a> is the file <a id="wrglossary.3169"></a><a href="#glo:idx.encoding">encoding</a> for the <a id="wrglossary.3170"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> files and is
-passed to <a id="wrglossary.3171"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3172"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> switch. The default
-<a id="wrglossary.3173"></a><a href="#glo:idx.codepage">codepage</a> is obtained from <a id="wrglossary.3174"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>. As from v4.50, if
-<a id="wrglossary.3175"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a> isn’t defined, <a id="wrglossary.3176"></a><a href="#glo:dual.utf8">UTF-8</a> is assumed (which is
+The <a id="wrglossary.3165"></a><a href="#glo:idx.codepage">codepage</a> is the file <a id="wrglossary.3166"></a><a href="#glo:idx.encoding">encoding</a> for the <a id="wrglossary.3167"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> files and is
+passed to <a id="wrglossary.3168"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3169"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> switch. The default
+<a id="wrglossary.3170"></a><a href="#glo:idx.codepage">codepage</a> is obtained from <a id="wrglossary.3171"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>. As from v4.50, if
+<a id="wrglossary.3172"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a> isn’t defined, <a id="wrglossary.3173"></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.3177"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a> option but make sure you
-use the <a id="wrglossary.3178"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> <a id="wrglossary.3179"></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.3180"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> documentation for further
+need to use the <a id="wrglossary.3174"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a> option but make sure you
+use the <a id="wrglossary.3175"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> <a id="wrglossary.3176"></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.3177"></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.3181"></a><a href="#glo:idx.codepage">codepage</a> may not simply be the <a id="wrglossary.3182"></a><a href="#glo:idx.encoding">encoding</a> but may
+The <a id="wrglossary.3178"></a><a href="#glo:idx.codepage">codepage</a> may not simply be the <a id="wrglossary.3179"></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 -->
@@ -11136,56 +11140,56 @@
<p>
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.3183"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3184"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=english</span>,<a id="wrglossary.3185"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a><span class="optfmt">=cp1252</span></span>]
+<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.3180"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3181"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=english</span>,<a id="wrglossary.3182"></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 href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3186"></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 -->
+<a id="wrglossary.3183"></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.3187"></a><a href="#glo:idx.group">group</a> in the <a id="wrglossary.3188"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+If true, this option will define the number <a id="wrglossary.3184"></a><a href="#glo:idx.group">group</a> in the <a id="wrglossary.3185"></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.3189"></a><a href="#glo:idx.group">letter group</a>. If you don’t want this <a id="wrglossary.3190"></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.3191"></a><a href="#glo:idx.group">letter group</a> is only available with
-<a id="wrglossary.3192"></a><a href="#glo:dual.latinalph">Latin alphabets</a>, so if you are using a <a id="wrglossary.3193"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>, you
-will either need to switch off the number <a id="wrglossary.3194"></a><a href="#glo:idx.group">group</a> or identify the
-<a id="wrglossary.3195"></a><a href="#glo:idx.group">letter group</a> that it should come before with
-<a id="wrglossary.3196"></a><a href="#glo:GlsSetXdyNumberGroupOrder"><code class="csfmt">\GlsSetXdyNumberGroupOrder</code></a>.
+<a id="wrglossary.3186"></a><a href="#glo:idx.group">letter group</a>. If you don’t want this <a id="wrglossary.3187"></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.3188"></a><a href="#glo:idx.group">letter group</a> is only available with
+<a id="wrglossary.3189"></a><a href="#glo:dual.latinalph">Latin alphabets</a>, so if you are using a <a id="wrglossary.3190"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>, you
+will either need to switch off the number <a id="wrglossary.3191"></a><a href="#glo:idx.group">group</a> or identify the
+<a id="wrglossary.3192"></a><a href="#glo:idx.group">letter group</a> that it should come before with
+<a id="wrglossary.3193"></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.3197"></a><code class="code"><dfn id="glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></dfn></code>
+<a id="wrglossary.3194"></a><code class="code"><dfn id="glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></dfn></code>
<p>
-<div class="noteBox"><a id="wrglossary.3198"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3195"></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.3199"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> without any value supplied
+This is equivalent to <a id="wrglossary.3196"></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.3200"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> and
-<a id="wrglossary.3201"></a><a href="#glo:GlsSetXdyCodePage"><code class="csfmt">\GlsSetXdyCodePage</code></a> if the defaults are inappropriate
+and code page can be set via <a id="wrglossary.3197"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> and
+<a id="wrglossary.3198"></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.3202"></a><code class="code"><dfn id="glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></dfn></code>
+<a id="wrglossary.3199"></a><code class="code"><dfn id="glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></dfn></code>
<p>
-<div class="noteBox"><a id="wrglossary.3203"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3200"></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.3204"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.3205"></a><a href="#glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></a><span class="optfmt">=false</span>}</span>
+<a id="wrglossary.3201"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.3202"></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.3206"></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 -->
+<a id="wrglossary.3203"></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.3207"></a><a href="#glo:dual.shellescape">shell escape</a> to run the
-appropriate <a id="wrglossary.3208"></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>
+This option will attempt to use the <a id="wrglossary.3204"></a><a href="#glo:dual.shellescape">shell escape</a> to run the
+appropriate <a id="wrglossary.3205"></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.3209"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
-<a id="wrglossary.3210"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<a id="wrglossary.3211"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.3212"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.3213"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={an example}</span>}
+<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.3206"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<a id="wrglossary.3207"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.3208"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.3209"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.3210"></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.3214"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}
-<a id="wrglossary.3215"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.3211"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}
+<a id="wrglossary.3212"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
</pre>
Then the document build is now:
@@ -11192,26 +11196,26 @@
<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.3216"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> on every LaTeX run. If you have a
-large <a id="wrglossary.3217"></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.3218"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-(either explicitly or via <a id="wrglossary.3219"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>) the minimum number
+This will run <a id="wrglossary.3213"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> on every LaTeX run. If you have a
+large <a id="wrglossary.3214"></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.3215"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+(either explicitly or via <a id="wrglossary.3216"></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.3220"></a><a href="#glo:dual.shellescape">shell escape</a> enabled (restricted mode for a direct call to
-<a id="wrglossary.3221"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and unrestricted mode for <a id="wrglossary.3222"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>,
-<a id="wrglossary.3223"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.3224"></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.3225"></a><a href="#glo:pkg.shellesc"><span class="styfmt">shellesc</span></a>
+<a id="wrglossary.3217"></a><a href="#glo:dual.shellescape">shell escape</a> enabled (restricted mode for a direct call to
+<a id="wrglossary.3218"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and unrestricted mode for <a id="wrglossary.3219"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>,
+<a id="wrglossary.3220"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.3221"></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.3222"></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.3226"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file in
+If this option doesn’t seem to work, open the <a id="wrglossary.3223"></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.3227"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<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.3224"></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
@@ -11223,20 +11227,20 @@
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.3228"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is on the list of trusted applications.
+mode because <a id="wrglossary.3225"></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.3229"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3230"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a>]{glossaries}
+<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.3226"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3227"></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.3231"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-(rather than a direct call to <a id="wrglossary.3232"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>), which isn’t
+This indicates that an attempt was made to run <a id="wrglossary.3228"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+(rather than a direct call to <a id="wrglossary.3229"></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.3233"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3234"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a> or if the <a id="wrglossary.3235"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option is used.
-These cases require the unrestricted <a id="wrglossary.3236"></a><a href="#glo:dual.shellescape">shell escape</a>.
+<a id="wrglossary.3230"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3231"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a> or if the <a id="wrglossary.3232"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option is used.
+These cases require the unrestricted <a id="wrglossary.3233"></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
@@ -11243,46 +11247,46 @@
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.3237"></a><a href="#glo:dual.shellescape">shell escape</a> disabled) and
-search the <a id="wrglossary.3238"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file for “<code class="qtt">runsystem</code>” to find out exactly
+in restricted mode (or with the <a id="wrglossary.3234"></a><a href="#glo:dual.shellescape">shell escape</a> disabled) and
+search the <a id="wrglossary.3235"></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.3239"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file should now be:
+line in the <a id="wrglossary.3236"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file should now be:
<pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>runsystem(makeglossaries myDoc)...executed.
</pre>
-This means that <a id="wrglossary.3240"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> was run. If it has <span class="qt">“failed”</span>
+This means that <a id="wrglossary.3237"></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.3241"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file has <span class="qt">“executed”</span> doesn’t
+Note that just because the <a id="wrglossary.3238"></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.3242"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file (for
-example, the <a id="wrglossary.3243"></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.3244"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary).
+results, check the <a id="wrglossary.3239"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file (for
+example, the <a id="wrglossary.3240"></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.3241"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary).
<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.3245"></a><a id="wrglossary.3246"></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 -->
+<a id="wrglossary.3242"></a><a id="wrglossary.3243"></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.3247"></a><a href="#glo:dual.shellescape">shell escape</a>.
+No attempt is made to use the <a id="wrglossary.3244"></a><a href="#glo:dual.shellescape">shell escape</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.3248"></a><a id="wrglossary.3249"></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"><span class="summarytag">alias: </span><a href="#glo:optval.automake.delayed"><span class="optfmt">delayed</span></a> <a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
+<a id="wrglossary.3245"></a><a id="wrglossary.3246"></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"><span class="summarytag">alias: </span><a href="#glo:optval.automake.delayed"><span class="optfmt">delayed</span></a> <a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of optionvaluebox -->
This is now a deprecated synonym for
-<a id="wrglossary.3250"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3251"></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.3252"></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.3253"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3254"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> in version 4.50.
+<a id="wrglossary.3247"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3248"></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.3249"></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.3250"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3251"></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 href="#glo:sym.optionvalue"><span title="Option Value Definition" class="icon">🔖</span></a></div><!-- end of optionvalueboxtitle -->
-<a id="wrglossary.3255"></a><a id="wrglossary.3256"></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 id="wrglossary.3252"></a><a id="wrglossary.3253"></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.3257"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3258"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for
-each non-empty <a id="wrglossary.3259"></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.3260"></a><a href="#glo:dual.glossary">glossary</a>
+A direct call to <a id="wrglossary.3254"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3255"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for
+each non-empty <a id="wrglossary.3256"></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.3257"></a><a href="#glo:dual.glossary">glossary</a>
files are complete. (It’s necessary to delay writing to the
-<a id="wrglossary.3261"></a><a href="#glo:dual.indexingfile">indexing files</a> in order to ensure that <a id="wrglossary.3262"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> is
+<a id="wrglossary.3258"></a><a href="#glo:dual.indexingfile">indexing files</a> in order to ensure that <a id="wrglossary.3259"></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
@@ -11289,102 +11293,102 @@
the following 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.3263"></a><a id="wrglossary.3264"></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 id="wrglossary.3260"></a><a id="wrglossary.3261"></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.3265"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3266"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for
-each non-empty <a id="wrglossary.3267"></a><a href="#glo:dual.glossary">glossary</a> will be made at the start of
-<a id="wrglossary.3268"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write. This ensures that the
-<a id="wrglossary.3269"></a><a href="#glo:dual.indexingfile">indexing files</a> are read by the <a id="wrglossary.3270"></a><a href="#glo:dual.indexingapp">indexing application</a> before they
+A direct call to <a id="wrglossary.3262"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3263"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for
+each non-empty <a id="wrglossary.3264"></a><a href="#glo:dual.glossary">glossary</a> will be made at the start of
+<a id="wrglossary.3265"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write. This ensures that the
+<a id="wrglossary.3266"></a><a href="#glo:dual.indexingfile">indexing files</a> are read by the <a id="wrglossary.3267"></a><a href="#glo:dual.indexingapp">indexing application</a> before they
are opened (which will clear their content).
<p>
-If you are using <a id="wrglossary.3271"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, then <a id="wrglossary.3272"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3273"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a>
+If you are using <a id="wrglossary.3268"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, then <a id="wrglossary.3269"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3270"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a>
is a better option that this one. Either way, you will need Perl and
-the unrestricted mode, but with <a id="wrglossary.3274"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> you get the
+the unrestricted mode, but with <a id="wrglossary.3271"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> you get the
benefit of the language mappings and diagnostics.
<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.3275"></a><a id="wrglossary.3276"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></dfn></code></div><!-- end of optionvaluebox -->
+<a id="wrglossary.3272"></a><a id="wrglossary.3273"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></dfn></code></div><!-- end of optionvaluebox -->
-A call to <a id="wrglossary.3277"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will be made at the start of
-<a id="wrglossary.3278"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write if the <a id="wrglossary.3279"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
-exists. On the one hand, it’s better to use <a id="wrglossary.3280"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> as
+A call to <a id="wrglossary.3274"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will be made at the start of
+<a id="wrglossary.3275"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write if the <a id="wrglossary.3276"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
+exists. On the one hand, it’s better to use <a id="wrglossary.3277"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> as
it has some extra diagnostic functions, but on the other hand it
-both requires Perl and the unrestricted <a id="wrglossary.3281"></a><a href="#glo:dual.shellescape">shell escape</a>.
+both requires Perl and the unrestricted <a id="wrglossary.3278"></a><a href="#glo:dual.shellescape">shell escape</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.3282"></a><a id="wrglossary.3283"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.lite"><span class="optfmt">lite</span></dfn></code></div><!-- end of optionvaluebox -->
+<a id="wrglossary.3279"></a><a id="wrglossary.3280"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>=<code class="code"><dfn id="glo:optval.automake.lite"><span class="optfmt">lite</span></dfn></code></div><!-- end of optionvaluebox -->
-A call to <a id="wrglossary.3284"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> will be made at the start of
-<a id="wrglossary.3285"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write if the <a id="wrglossary.3286"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
+A call to <a id="wrglossary.3281"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> will be made at the start of
+<a id="wrglossary.3282"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write if the <a id="wrglossary.3283"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
exists. There’s little benefit in this option over
-<a id="wrglossary.3287"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3288"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> and it has the added disadvantage
+<a id="wrglossary.3284"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3285"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> and it has the added disadvantage
of requiring the unrestricted mode.
<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.3289"></a><code class="code"><dfn id="glo:opt.automakegloss"><span class="styoptfmt">automakegloss</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3286"></a><code class="code"><dfn id="glo:opt.automakegloss"><span class="styoptfmt">automakegloss</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
-This valueless option is equivalent to <a id="wrglossary.3290"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3291"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a>.
+This valueless option is equivalent to <a id="wrglossary.3287"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3288"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</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.3292"></a><code class="code"><dfn id="glo:opt.automakeglosslite"><span class="styoptfmt">automakeglosslite</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3289"></a><code class="code"><dfn id="glo:opt.automakeglosslite"><span class="styoptfmt">automakeglosslite</span></dfn></code><span class="floatrightbox"><span class="summarytag">alias: </span><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
-This valueless option is equivalent to <a id="wrglossary.3293"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3294"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a>.
+This valueless option is equivalent to <a id="wrglossary.3290"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3291"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</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.3295"></a><code class="code"><dfn id="glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3292"></a><code class="code"><dfn id="glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></dfn></code></div><!-- end of settingsbox -->
-This valueless option indicates that <a id="wrglossary.3296"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and
-<a id="wrglossary.3297"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> should be disabled. This option is
+This valueless option indicates that <a id="wrglossary.3293"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and
+<a id="wrglossary.3294"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> should be disabled. This option is
provided in the event that you have to use a class or package that
disregards the advice in §<a href="#sec:indexingoptions">1.3</a> and
-automatically performs <a id="wrglossary.3298"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or
-<a id="wrglossary.3299"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> but you don’t want this. (For example,
-you want to use a different <a id="wrglossary.3300"></a><a href="#glo:dual.indexing">indexing</a> method or you want to
-disable <a id="wrglossary.3301"></a><a href="#glo:dual.indexing">indexing</a> while working on a draft document.)
+automatically performs <a id="wrglossary.3295"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or
+<a id="wrglossary.3296"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> but you don’t want this. (For example,
+you want to use a different <a id="wrglossary.3297"></a><a href="#glo:dual.indexing">indexing</a> method or you want to
+disable <a id="wrglossary.3298"></a><a href="#glo:dual.indexing">indexing</a> while working on a draft document.)
<p>
Naturally, if there’s a particular reason why the class or package
-insists on a specific <a id="wrglossary.3302"></a><a href="#glo:dual.indexing">indexing</a> method, for example, it’s an
+insists on a specific <a id="wrglossary.3299"></a><a href="#glo:dual.indexing">indexing</a> method, for example, it’s an
editorial requirement, then you will need to abide by that
decision.
<p>
This option may be passed in the standard document class option list
-or passed using <a id="wrglossary.3303"></a><a href="#glo:PassOptionsToPackage"><code class="csfmt">\PassOptionsToPackage</code></a> before <a id="wrglossary.3304"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is
+or passed using <a id="wrglossary.3300"></a><a href="#glo:PassOptionsToPackage"><code class="csfmt">\PassOptionsToPackage</code></a> before <a id="wrglossary.3301"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is
loaded. Note that this does nothing if
-<a id="wrglossary.3305"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.3306"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> has already
+<a id="wrglossary.3302"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.3303"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> has already
been used whilst enabled.
<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.3307"></a><code class="code"><dfn id="glo:opt.restoremakegloss"><span class="styoptfmt">restoremakegloss</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3304"></a><code class="code"><dfn id="glo:opt.restoremakegloss"><span class="styoptfmt">restoremakegloss</span></dfn></code></div><!-- end of settingsbox -->
-Cancels the effect of <a id="wrglossary.3308"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>. This option may be used in
-<a id="wrglossary.3309"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>. It issues a warning if <a id="wrglossary.3310"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or
-<a id="wrglossary.3311"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> has already been used whilst enabled.
-Note that this option removes the check for <a id="wrglossary.3312"></a><a href="#glo:nofiles"><code class="csfmt">\nofiles</code></a>, as this
+Cancels the effect of <a id="wrglossary.3305"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>. This option may be used in
+<a id="wrglossary.3306"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>. It issues a warning if <a id="wrglossary.3307"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or
+<a id="wrglossary.3308"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> has already been used whilst enabled.
+Note that this option removes the check for <a id="wrglossary.3309"></a><a href="#glo:nofiles"><code class="csfmt">\nofiles</code></a>, as this
option is an indication that the output files are actually required.
<p>
For example, suppose the class <span class="clsfmt">customclass.cls</span>
-automatically loads <a id="wrglossary.3313"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and does <a id="wrglossary.3314"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-but you need an extra <a id="wrglossary.3315"></a><a href="#glo:dual.glossary">glossary</a>, which has to be defined before
-<a id="wrglossary.3316"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>, then you can do:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[<a id="wrglossary.3317"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>]{customclass}
-<a id="wrglossary.3318"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{functions}{Functions}
-<a id="wrglossary.3319"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>{restoremakegloss}
-<a id="wrglossary.3320"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+automatically loads <a id="wrglossary.3310"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and does <a id="wrglossary.3311"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+but you need an extra <a id="wrglossary.3312"></a><a href="#glo:dual.glossary">glossary</a>, which has to be defined before
+<a id="wrglossary.3313"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>, then you can do:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>[<a id="wrglossary.3314"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>]{customclass}
+<a id="wrglossary.3315"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{functions}{Functions}
+<a id="wrglossary.3316"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>{restoremakegloss}
+<a id="wrglossary.3317"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
</pre>
or
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3321"></a><a href="#glo:PassOptionsToPackage"><code class="csfmt">\PassOptionsToPackage</code></a>{<a id="wrglossary.3322"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>}{glossaries}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3318"></a><a href="#glo:PassOptionsToPackage"><code class="csfmt">\PassOptionsToPackage</code></a>{<a id="wrglossary.3319"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>}{glossaries}
<code class="cmd">\documentclass</code>{customclass}
-<a id="wrglossary.3323"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{functions}{Functions}
-<a id="wrglossary.3324"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>{restoremakegloss}
-<a id="wrglossary.3325"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.3320"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{functions}{Functions}
+<a id="wrglossary.3321"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>{restoremakegloss}
+<a id="wrglossary.3322"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
</pre>
<p>
Note that restoring these commands doesn’t necessarily mean that they can be
used. It just means that their normal behaviour given the current
-settings will apply. For example, if you use the <a id="wrglossary.3326"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span>
-or <a id="wrglossary.3327"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span> options with <a id="wrglossary.3328"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
-then you can’t use <a id="wrglossary.3329"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.3330"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>
-regardless of <a id="wrglossary.3331"></a><a href="#glo:opt.restoremakegloss"><span class="styoptfmt">restoremakegloss</span></a>.
+settings will apply. For example, if you use the <a id="wrglossary.3323"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span>
+or <a id="wrglossary.3324"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span> options with <a id="wrglossary.3325"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+then you can’t use <a id="wrglossary.3326"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.3327"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>
+regardless of <a id="wrglossary.3328"></a><a href="#glo:opt.restoremakegloss"><span class="styoptfmt">restoremakegloss</span></a>.
<p>
</section><!-- end of section sec:pkgopts-sort -->
@@ -11394,213 +11398,213 @@
<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.3332"></a><code class="code"><dfn id="glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></dfn>={<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3329"></a><code class="code"><dfn id="glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></dfn>={<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of settingsbox -->
Use this option if you have multiple
-<a id="wrglossary.3333"></a><a href="#glo:dual.glossary">glossaries</a> and you want to suppress the entry <a id="wrglossary.3334"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for a
-particular <a id="wrglossary.3335"></a><a href="#glo:dual.glossary">glossary</a> or <a id="wrglossary.3336"></a><a href="#glo:dual.glossary">glossaries</a>. The value of this option should
-be a comma-separated list of <a id="wrglossary.3337"></a><a href="#glo:dual.glossary">glossary</a> types where <a id="wrglossary.3338"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> etc
-shouldn’t have <a id="wrglossary.3339"></a><a href="#glo:idx.hyperlink">hyperlinks</a> by default. Make sure you enclose the
+<a id="wrglossary.3330"></a><a href="#glo:dual.glossary">glossaries</a> and you want to suppress the entry <a id="wrglossary.3331"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for a
+particular <a id="wrglossary.3332"></a><a href="#glo:dual.glossary">glossary</a> or <a id="wrglossary.3333"></a><a href="#glo:dual.glossary">glossaries</a>. The value of this option should
+be a comma-separated list of <a id="wrglossary.3334"></a><a href="#glo:dual.glossary">glossary</a> types where <a id="wrglossary.3335"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> etc
+shouldn’t have <a id="wrglossary.3336"></a><a href="#glo:idx.hyperlink">hyperlinks</a> by default. Make sure you enclose the
value in braces if it contains any commas. 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.3340"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3341"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">={<a id="wrglossary.3342"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>,notation}</span>]
+<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.3337"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3338"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">={<a id="wrglossary.3339"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>,notation}</span>]
{glossaries}
-<a id="wrglossary.3343"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[nlg]{notation}{not}{ntn}{Notation}
+<a id="wrglossary.3340"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[nlg]{notation}{not}{ntn}{Notation}
</pre>
-As illustrated above, the <a id="wrglossary.3344"></a><a href="#glo:dual.glossary">glossary</a> doesn’t need to exist when
-you identify it in <a id="wrglossary.3345"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a>.
+As illustrated above, the <a id="wrglossary.3341"></a><a href="#glo:dual.glossary">glossary</a> doesn’t need to exist when
+you identify it in <a id="wrglossary.3342"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</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 -->
The values must be fully expanded, so <strong class="strong">don’t</strong> try, for
-example, <a id="wrglossary.3346"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">=<a id="wrglossary.3347"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a></span>.
+example, <a id="wrglossary.3343"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">=<a id="wrglossary.3344"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a></span>.
</div><!-- end of important -->
<p>
You may also 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.3348"></a><code class="code"><dfn id="glo:GlsDeclareNoHyperList"><code class="csfmt">\GlsDeclareNoHyperList</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3345"></a><code class="code"><dfn id="glo:GlsDeclareNoHyperList"><code class="csfmt">\GlsDeclareNoHyperList</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
instead or additionally.
See §<a href="#sec:glslink">5.1</a> for further details.
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3349"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3346"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.3350"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has the <a id="wrglossary.3351"></a><a href="#glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></a>
-<a id="wrglossary.3352"></a><a href="#glo:idx.categoryattribute">category attribute</a> which will suppress the <a id="wrglossary.3353"></a><a href="#glo:idx.hyperlink">hyperlink</a> for entries
+The <a id="wrglossary.3347"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has the <a id="wrglossary.3348"></a><a href="#glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></a>
+<a id="wrglossary.3349"></a><a href="#glo:idx.categoryattribute">category attribute</a> which will suppress the <a id="wrglossary.3350"></a><a href="#glo:idx.hyperlink">hyperlink</a> for entries
with the given category, which can be used as an alternative to
-suppressing the <a id="wrglossary.3354"></a><a href="#glo:idx.hyperlink">hyperlink</a> on a per-<a id="wrglossary.3355"></a><a href="#glo:dual.glossary">glossary</a> basis.
+suppressing the <a id="wrglossary.3351"></a><a href="#glo:idx.hyperlink">hyperlink</a> on a per-<a id="wrglossary.3352"></a><a href="#glo:dual.glossary">glossary</a> basis.
</div><!-- end of information -->
<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.3356"></a><code class="code"><dfn id="glo:opt.nomain"><span class="styoptfmt">nomain</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3353"></a><code class="code"><dfn id="glo:opt.nomain"><span class="styoptfmt">nomain</span></dfn></code></div><!-- end of settingsbox -->
-This suppresses the creation of the <a id="wrglossary.3357"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>
-glossary and associated <a id="wrglossary.3358"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file, if unrequired. Note that
-if you use this option, you must create another <a id="wrglossary.3359"></a><a href="#glo:dual.glossary">glossary</a> in which to
-put all your entries (either via the <a id="wrglossary.3360"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> (or
-<a id="wrglossary.3361"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a>) package option described in
-§<a href="#sec:pkgopts-acronym">2.7</a> or via the <a id="wrglossary.3362"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,
-<a id="wrglossary.3363"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> or <a id="wrglossary.3364"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> options described in
-§<a href="#sec:pkgopts-other">2.9</a> or via <a id="wrglossary.3365"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> described in
+This suppresses the creation of the <a id="wrglossary.3354"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>
+glossary and associated <a id="wrglossary.3355"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file, if unrequired. Note that
+if you use this option, you must create another <a id="wrglossary.3356"></a><a href="#glo:dual.glossary">glossary</a> in which to
+put all your entries (either via the <a id="wrglossary.3357"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> (or
+<a id="wrglossary.3358"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a>) package option described in
+§<a href="#sec:pkgopts-acronym">2.7</a> or via the <a id="wrglossary.3359"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,
+<a id="wrglossary.3360"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> or <a id="wrglossary.3361"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> options described in
+§<a href="#sec:pkgopts-other">2.9</a> or via <a id="wrglossary.3362"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> described in
§<a href="#sec:newglossary">9</a>). Even if you don’t intend to display
-the <a id="wrglossary.3366"></a><a href="#glo:dual.glossary">glossary</a>, a default <a id="wrglossary.3367"></a><a href="#glo:dual.glossary">glossary</a> is still required.
+the <a id="wrglossary.3363"></a><a href="#glo:dual.glossary">glossary</a>, a default <a id="wrglossary.3364"></a><a href="#glo:dual.glossary">glossary</a> is still required.
<p>
-If you don’t use the <a id="wrglossary.3368"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary and you don’t use this
-option to suppress its creation, <a id="wrglossary.3369"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will produce a warning:
+If you don’t use the <a id="wrglossary.3365"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary and you don’t use this
+option to suppress its creation, <a id="wrglossary.3366"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will produce a warning:
<pre class="transcript"><div class="transcripttitle"><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>Warning: File '<span class="meta">〈<em class="metainner">filename</em>〉</span>.glo' is empty.
-Have you used any entries defined in glossary '<a id="wrglossary.3370"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>'?
-Remember to use package option '<a id="wrglossary.3371"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a>' if
-you don't want to use the <a id="wrglossary.3372"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
+Have you used any entries defined in glossary '<a id="wrglossary.3367"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>'?
+Remember to use package option '<a id="wrglossary.3368"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a>' if
+you don't want to use the <a id="wrglossary.3369"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
</pre>
-If you did actually want to use the <a id="wrglossary.3373"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary and you see this
-warning, check that you have referenced the entries in that <a id="wrglossary.3374"></a><a href="#glo:dual.glossary">glossary</a>
-via commands such as <a id="wrglossary.3375"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.
+If you did actually want to use the <a id="wrglossary.3370"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary and you see this
+warning, check that you have referenced the entries in that <a id="wrglossary.3371"></a><a href="#glo:dual.glossary">glossary</a>
+via commands such as <a id="wrglossary.3372"></a><a href="#glo:gls"><code class="csfmt">\gls</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.3376"></a><code class="code"><dfn id="glo:opt.symbols"><span class="styoptfmt">symbols</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3373"></a><code class="code"><dfn id="glo:opt.symbols"><span class="styoptfmt">symbols</span></dfn></code></div><!-- end of settingsbox -->
-This valueless option defines a new <a id="wrglossary.3377"></a><a href="#glo:dual.glossary">glossary</a> type with
-the label <a id="wrglossary.3378"></a><dfn id="glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></dfn> via
-<pre class="compactcodebox"><a id="wrglossary.3379"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[slg]{<a id="wrglossary.3380"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a>}{sls}{slo}{<a id="wrglossary.3381"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}
+This valueless option defines a new <a id="wrglossary.3374"></a><a href="#glo:dual.glossary">glossary</a> type with
+the label <a id="wrglossary.3375"></a><dfn id="glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></dfn> via
+<pre class="compactcodebox"><a id="wrglossary.3376"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[slg]{<a id="wrglossary.3377"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a>}{sls}{slo}{<a id="wrglossary.3378"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}
</pre>
It also defines
<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.3382"></a><code class="code"><dfn id="glo:printsymbols"><code class="csfmt">\printsymbols</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code>
+<a id="wrglossary.3379"></a><code class="code"><dfn id="glo:printsymbols"><code class="csfmt">\printsymbols</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
which is a synonym for
-<pre class="compactcodebox"><a id="wrglossary.3383"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3384"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3385"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+<pre class="compactcodebox"><a id="wrglossary.3380"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3381"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3382"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
<p>
-If you use <a id="wrglossary.3386"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
-<pre class="compactcodebox"><a id="wrglossary.3387"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3388"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3389"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+If you use <a id="wrglossary.3383"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
+<pre class="compactcodebox"><a id="wrglossary.3384"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3385"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3386"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
to display the list of symbols.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Remember to use the <a id="wrglossary.3390"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
-interested in using this <a id="wrglossary.3391"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a> glossary and don’t intend
-to use the <a id="wrglossary.3392"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
+Remember to use the <a id="wrglossary.3387"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
+interested in using this <a id="wrglossary.3388"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a> glossary and don’t intend
+to use the <a id="wrglossary.3389"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
</div><!-- end of important -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3393"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3390"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.3394"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a slightly modified
-version of this option which additionally provides <a id="wrglossary.3395"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>
+The <a id="wrglossary.3391"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a slightly modified
+version of this option which additionally provides <a id="wrglossary.3392"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>
as a convenient shortcut method for defining symbols. See the
-<a id="wrglossary.3396"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.3393"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3397"></a><code class="code"><dfn id="glo:opt.numbers"><span class="styoptfmt">numbers</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3394"></a><code class="code"><dfn id="glo:opt.numbers"><span class="styoptfmt">numbers</span></dfn></code></div><!-- end of settingsbox -->
-This valueless option defines a new <a id="wrglossary.3398"></a><a href="#glo:dual.glossary">glossary</a> type with
-the label <a id="wrglossary.3399"></a><dfn id="glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></dfn> via
-<pre class="compactcodebox"><a id="wrglossary.3400"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[nlg]{<a id="wrglossary.3401"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a>}{nls}{nlo}{<a id="wrglossary.3402"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}
+This valueless option defines a new <a id="wrglossary.3395"></a><a href="#glo:dual.glossary">glossary</a> type with
+the label <a id="wrglossary.3396"></a><dfn id="glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></dfn> via
+<pre class="compactcodebox"><a id="wrglossary.3397"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[nlg]{<a id="wrglossary.3398"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a>}{nls}{nlo}{<a id="wrglossary.3399"></a><a href="#glo:glsnumbersgroupname"><code class="csfmt">\glsnumbersgroupname</code></a>}
</pre>
It also defines
<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.3403"></a><code class="code"><dfn id="glo:printnumbers"><code class="csfmt">\printnumbers</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code>
+<a id="wrglossary.3400"></a><code class="code"><dfn id="glo:printnumbers"><code class="csfmt">\printnumbers</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
which is a synonym for
-<pre class="compactcodebox"><a id="wrglossary.3404"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3405"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3406"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+<pre class="compactcodebox"><a id="wrglossary.3401"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3402"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3403"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
<p>
-If you use <a id="wrglossary.3407"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
-<pre class="compactcodebox"><a id="wrglossary.3408"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3409"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3410"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+If you use <a id="wrglossary.3404"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
+<pre class="compactcodebox"><a id="wrglossary.3405"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3406"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3407"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
to display the list of numbers.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Remember to use the <a id="wrglossary.3411"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
-interested in using this <a id="wrglossary.3412"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a> glossary and don’t intend
-to use the <a id="wrglossary.3413"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
+Remember to use the <a id="wrglossary.3408"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
+interested in using this <a id="wrglossary.3409"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a> glossary and don’t intend
+to use the <a id="wrglossary.3410"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.
</div><!-- end of important -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3414"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3411"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.3415"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a slightly modified
-version of this option which additionally provides <a id="wrglossary.3416"></a><a href="#glo:glsxtrnewnumber"><code class="xtrcsfmt">\glsxtrnewnumber</code></a>
+The <a id="wrglossary.3412"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a slightly modified
+version of this option which additionally provides <a id="wrglossary.3413"></a><a href="#glo:glsxtrnewnumber"><code class="xtrcsfmt">\glsxtrnewnumber</code></a>
as a convenient shortcut method for defining numbers. See the
-<a id="wrglossary.3417"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.3414"></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 href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3418"></a><code class="code"><dfn id="glo:opt.index"><span class="styoptfmt">index</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3415"></a><code class="code"><dfn id="glo:opt.index"><span class="styoptfmt">index</span></dfn></code></div><!-- end of settingsbox -->
-This valueless option defines a new <a id="wrglossary.3419"></a><a href="#glo:dual.glossary">glossary</a> type with
-the label <a id="wrglossary.3420"></a><dfn id="glo:opt.glostype.index"><code class="glostypefmt">index</code></dfn> via
-<pre class="compactcodebox"><a id="wrglossary.3421"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[ilg]{<a id="wrglossary.3422"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}{ind}{idx}{<a id="wrglossary.3423"></a><a href="#glo:indexname"><code class="csfmt">\indexname</code></a>}
+This valueless option defines a new <a id="wrglossary.3416"></a><a href="#glo:dual.glossary">glossary</a> type with
+the label <a id="wrglossary.3417"></a><dfn id="glo:opt.glostype.index"><code class="glostypefmt">index</code></dfn> via
+<pre class="compactcodebox"><a id="wrglossary.3418"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[ilg]{<a id="wrglossary.3419"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}{ind}{idx}{<a id="wrglossary.3420"></a><a href="#glo:indexname"><code class="csfmt">\indexname</code></a>}
</pre>
It also defines
<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.3424"></a><code class="code"><dfn id="glo:newterm"><code class="csfmt">\newterm</code></dfn>[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>
+<a id="wrglossary.3421"></a><code class="code"><dfn id="glo:newterm"><code class="csfmt">\newterm</code></dfn>[<span class="meta">〈<em class="metainner">key=value list</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}</code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
which is a synonym for
-<pre class="compactcodebox"><a id="wrglossary.3425"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.3426"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.3427"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}</span>,<a id="wrglossary.3428"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={entry-label}</span>,
-<a id="wrglossary.3429"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.3430"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>}
+<pre class="compactcodebox"><a id="wrglossary.3422"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.3423"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.3424"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}</span>,<a id="wrglossary.3425"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={entry-label}</span>,
+<a id="wrglossary.3426"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.3427"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>,<span class="meta">〈<em class="metainner">options</em>〉</span>}
</pre>
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.3431"></a><code class="code"><dfn id="glo:printindex"><code class="csfmt">\printindex</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>] v4.02+</code>
+<a id="wrglossary.3428"></a><code class="code"><dfn id="glo:printindex"><code class="csfmt">\printindex</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>] v4.02+</code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
which is a synonym for
-<pre class="compactcodebox"><a id="wrglossary.3432"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3433"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3434"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+<pre class="compactcodebox"><a id="wrglossary.3429"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3430"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3431"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
<p>
-If you use <a id="wrglossary.3435"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
-<pre class="compactcodebox"><a id="wrglossary.3436"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3437"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3438"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+If you use <a id="wrglossary.3432"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
+<pre class="compactcodebox"><a id="wrglossary.3433"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3434"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3435"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
-to display this <a id="wrglossary.3439"></a><a href="#glo:dual.glossary">glossary</a>.
+to display this <a id="wrglossary.3436"></a><a href="#glo:dual.glossary">glossary</a>.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Remember to use the <a id="wrglossary.3440"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
-interested in using this <a id="wrglossary.3441"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a> glossary and don’t intend to
-use the <a id="wrglossary.3442"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. Note that you
-can’t mix this option with <a id="wrglossary.3443"></a><a href="#glo:index"><code class="csfmt">\index</code></a>. Either use
-<a id="wrglossary.3444"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> for the <a id="wrglossary.3445"></a><a href="#glo:dual.indexing">indexing</a> or use a custom <a id="wrglossary.3446"></a><a href="#glo:dual.indexing">indexing</a>
-package, such as <a id="wrglossary.3447"></a><a href="#glo:pkg.makeidx"><span class="styfmt">makeidx</span></a>, <a id="wrglossary.3448"></a><a href="#glo:pkg.imakeidx"><span class="styfmt">imakeidx</span></a>.
+Remember to use the <a id="wrglossary.3437"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
+interested in using this <a id="wrglossary.3438"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a> glossary and don’t intend to
+use the <a id="wrglossary.3439"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. Note that you
+can’t mix this option with <a id="wrglossary.3440"></a><a href="#glo:index"><code class="csfmt">\index</code></a>. Either use
+<a id="wrglossary.3441"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> for the <a id="wrglossary.3442"></a><a href="#glo:dual.indexing">indexing</a> or use a custom <a id="wrglossary.3443"></a><a href="#glo:dual.indexing">indexing</a>
+package, such as <a id="wrglossary.3444"></a><a href="#glo:pkg.makeidx"><span class="styfmt">makeidx</span></a>, <a id="wrglossary.3445"></a><a href="#glo:pkg.imakeidx"><span class="styfmt">imakeidx</span></a>.
(You can, of course, load one of those packages and
-load <a id="wrglossary.3449"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> without the <a id="wrglossary.3450"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option.)
+load <a id="wrglossary.3446"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> without the <a id="wrglossary.3447"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option.)
</div><!-- end of important -->
<p>
Since the index isn’t designed for terms with descriptions, you
-might also want to disable the <a id="wrglossary.3451"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for this <a id="wrglossary.3452"></a><a href="#glo:dual.glossary">glossary</a> using
-the package option <a id="wrglossary.3453"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">=index</span> or the command
-<pre class="compactcodebox"><a id="wrglossary.3454"></a><a href="#glo:GlsDeclareNoHyperList"><code class="csfmt">\GlsDeclareNoHyperList</code></a>{<a id="wrglossary.3455"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}
+might also want to disable the <a id="wrglossary.3448"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for this <a id="wrglossary.3449"></a><a href="#glo:dual.glossary">glossary</a> using
+the package option <a id="wrglossary.3450"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">=index</span> or the command
+<pre class="compactcodebox"><a id="wrglossary.3451"></a><a href="#glo:GlsDeclareNoHyperList"><code class="csfmt">\GlsDeclareNoHyperList</code></a>{<a id="wrglossary.3452"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}
</pre>
However, it can also be useful to link to the index in order to look
-up the term’s <a id="wrglossary.3456"></a><a href="#glo:dual.locationlist">location list</a> to find other parts of the document
+up the term’s <a id="wrglossary.3453"></a><a href="#glo:dual.locationlist">location list</a> to find other parts of the document
where it might be used. For example, this manual will have a
-<a id="wrglossary.3457"></a><a href="#glo:idx.hyperlink">hyperlink</a> to the <a href="#index">index</a> for general terms, such as
-<span class="qt">“<a id="wrglossary.3458"></a><a href="#glo:idx.tableofcontents">table of contents</a>”</span>, or general commands, such as
-<a id="wrglossary.3459"></a><a href="#glo:index"><code class="csfmt">\index</code></a>, that aren’t defined anywhere in the document.
+<a id="wrglossary.3454"></a><a href="#glo:idx.hyperlink">hyperlink</a> to the <a href="#index">index</a> for general terms, such as
+<span class="qt">“<a id="wrglossary.3455"></a><a href="#glo:idx.tableofcontents">table of contents</a>”</span>, or general commands, such as
+<a id="wrglossary.3456"></a><a href="#glo:index"><code class="csfmt">\index</code></a>, that aren’t defined anywhere in the document.
<p>
-The example file <a id="wrglossary.3460"></a><a href="#glo:file.sample-index.tex"><span class="filefmt">sample-index.tex</span></a> illustrates the use of the
-<a id="wrglossary.3461"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package option.
+The example file <a id="wrglossary.3457"></a><a href="#glo:file.sample-index.tex"><span class="filefmt">sample-index.tex</span></a> illustrates the use of the
+<a id="wrglossary.3458"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> package 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.3462"></a><code class="code"><dfn id="glo:opt.noglossaryindex"><span class="styoptfmt">noglossaryindex</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3459"></a><code class="code"><dfn id="glo:opt.noglossaryindex"><span class="styoptfmt">noglossaryindex</span></dfn></code></div><!-- end of settingsbox -->
-This valueless option switches off <a id="wrglossary.3463"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> if <a id="wrglossary.3464"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> has
+This valueless option switches off <a id="wrglossary.3460"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> if <a id="wrglossary.3461"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> has
been passed implicitly (for example, through global document
-options). This option can’t be used in <a id="wrglossary.3465"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>.
+options). This option can’t be used in <a id="wrglossary.3462"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>.
<p>
</section><!-- end of section sec:pkgopts-type -->
@@ -11609,153 +11613,153 @@
<h2><!-- start of section header -->2.7. Acronym and Abbreviation Options<span class="labellink"><a href="#sec:pkgopts-acronym">[link]</a></span></h2><!-- end of section header -->
<p>
-<a id="wrglossary.3466"></a><a id="wrglossary.3467"></a><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.3468"></a><code class="code"><dfn id="glo:opt.acronym"><span class="styoptfmt">acronym</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 -->
+<a id="wrglossary.3463"></a><a id="wrglossary.3464"></a><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.3465"></a><code class="code"><dfn id="glo:opt.acronym"><span class="styoptfmt">acronym</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 creates a new <a id="wrglossary.3469"></a><a href="#glo:dual.glossary">glossary</a> with the
-label <a id="wrglossary.3470"></a><dfn id="glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></dfn>. This is equivalent to:
-<pre class="compactcodebox"><a id="wrglossary.3471"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[alg]{<a id="wrglossary.3472"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>}{acr}{acn}{<a id="wrglossary.3473"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}
+If true, this creates a new <a id="wrglossary.3466"></a><a href="#glo:dual.glossary">glossary</a> with the
+label <a id="wrglossary.3467"></a><dfn id="glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></dfn>. This is equivalent to:
+<pre class="compactcodebox"><a id="wrglossary.3468"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[alg]{<a id="wrglossary.3469"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>}{acr}{acn}{<a id="wrglossary.3470"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}
</pre>
It will also provide (if not already defined)
<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.3474"></a><code class="code"><dfn id="glo:printacronyms"><code class="csfmt">\printacronyms</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code>
+<a id="wrglossary.3471"></a><code class="code"><dfn id="glo:printacronyms"><code class="csfmt">\printacronyms</code></dfn>[<span class="meta">〈<em class="metainner">options</em>〉</span>]</code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
that’s equivalent to
-<pre class="compactcodebox"><a id="wrglossary.3475"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3476"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3477"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+<pre class="compactcodebox"><a id="wrglossary.3472"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3473"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3474"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
<p>
-If you are using <a id="wrglossary.3478"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use
-<pre class="compactcodebox"><a id="wrglossary.3479"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3480"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3481"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
+If you are using <a id="wrglossary.3475"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use
+<pre class="compactcodebox"><a id="wrglossary.3476"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3477"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3478"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<span class="meta">〈<em class="metainner">options</em>〉</span>]
</pre>
to display the list of acronyms.
<p>
-If the <a id="wrglossary.3482"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option is used, <a id="wrglossary.3483"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> is
-set to <a id="wrglossary.3484"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> otherwise it is set to
-<a id="wrglossary.3485"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> (which is normally the <a id="wrglossary.3486"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>
-glossary.) Entries that are defined using <a id="wrglossary.3487"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> are
-placed in the <a id="wrglossary.3488"></a><a href="#glo:dual.glossary">glossary</a> whose label is given by <a id="wrglossary.3489"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>,
-unless another <a id="wrglossary.3490"></a><a href="#glo:dual.glossary">glossary</a> is explicitly specified with the
-<a id="wrglossary.3491"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key.
+If the <a id="wrglossary.3479"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option is used, <a id="wrglossary.3480"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> is
+set to <a id="wrglossary.3481"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> otherwise it is set to
+<a id="wrglossary.3482"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> (which is normally the <a id="wrglossary.3483"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>
+glossary.) Entries that are defined using <a id="wrglossary.3484"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> are
+placed in the <a id="wrglossary.3485"></a><a href="#glo:dual.glossary">glossary</a> whose label is given by <a id="wrglossary.3486"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>,
+unless another <a id="wrglossary.3487"></a><a href="#glo:dual.glossary">glossary</a> is explicitly specified with the
+<a id="wrglossary.3488"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Remember to use the <a id="wrglossary.3492"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
-interested in using this <a id="wrglossary.3493"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossary. (That is, you
-don’t intend to use the <a id="wrglossary.3494"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.)
+Remember to use the <a id="wrglossary.3489"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a> package option if you’re only
+interested in using this <a id="wrglossary.3490"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossary. (That is, you
+don’t intend to use the <a id="wrglossary.3491"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary.)
</div><!-- end of important -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3495"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3492"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.3496"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package comes with an analogous
-<a id="wrglossary.3497"></a><a href="#glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></a> option, which creates a new <a id="wrglossary.3498"></a><a href="#glo:dual.glossary">glossary</a> with
-the label <a id="wrglossary.3499"></a><a href="#glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></a> and sets the command
-<a id="wrglossary.3500"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a> to this. If the <a id="wrglossary.3501"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option hasn’t
-also been used, then <a id="wrglossary.3502"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> will be set to
-<a id="wrglossary.3503"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a>. This enables both <a id="wrglossary.3504"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and
-<a id="wrglossary.3505"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> to use the same <a id="wrglossary.3506"></a><a href="#glo:dual.glossary">glossary</a>.
+The <a id="wrglossary.3493"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package comes with an analogous
+<a id="wrglossary.3494"></a><a href="#glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></a> option, which creates a new <a id="wrglossary.3495"></a><a href="#glo:dual.glossary">glossary</a> with
+the label <a id="wrglossary.3496"></a><a href="#glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></a> and sets the command
+<a id="wrglossary.3497"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a> to this. If the <a id="wrglossary.3498"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option hasn’t
+also been used, then <a id="wrglossary.3499"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> will be set to
+<a id="wrglossary.3500"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a>. This enables both <a id="wrglossary.3501"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and
+<a id="wrglossary.3502"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> to use the same <a id="wrglossary.3503"></a><a href="#glo:dual.glossary">glossary</a>.
<p>
-Make sure you have at least v1.42 of <a id="wrglossary.3507"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> if you
-use the <a id="wrglossary.3508"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> (or <a id="wrglossary.3509"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a>) package option with
+Make sure you have at least v1.42 of <a id="wrglossary.3504"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> if you
+use the <a id="wrglossary.3505"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> (or <a id="wrglossary.3506"></a><a href="#glo:opt.acronyms"><span class="styoptfmt">acronyms</span></a>) package option with
the extension package to avoid a bug that interferes with the
-<a id="wrglossary.3510"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a>.
+<a id="wrglossary.3507"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a>.
</div><!-- end of information -->
<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.3511"></a><code class="code"><dfn id="glo:opt.acronyms"><span class="styoptfmt">acronyms</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3508"></a><code class="code"><dfn id="glo:opt.acronyms"><span class="styoptfmt">acronyms</span></dfn></code></div><!-- end of settingsbox -->
-This is equivalent to <a id="wrglossary.3512"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="optfmt">=true</span> and may be used in the
+This is equivalent to <a id="wrglossary.3509"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a><span class="optfmt">=true</span> and may be used in the
document class option list.
<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.3513"></a><code class="code"><dfn id="glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3510"></a><code class="code"><dfn id="glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></dfn></code></div><!-- end of settingsbox -->
<p>
-This valueless option provided by <a id="wrglossary.3514"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> creates a new
-<a id="wrglossary.3515"></a><a href="#glo:dual.glossary">glossary</a> type with the label
-<a id="wrglossary.3516"></a><dfn id="glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></dfn> using:
-<pre class="compactcodebox"><a id="wrglossary.3517"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[glg-abr]{<a id="wrglossary.3518"></a><a href="#glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></a>}{gls-abr}{glo-abr}{<a id="wrglossary.3519"></a><a href="#glo:abbreviationsname"><code class="xtrcsfmt">\abbreviationsname</code></a>}
+This valueless option provided by <a id="wrglossary.3511"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> creates a new
+<a id="wrglossary.3512"></a><a href="#glo:dual.glossary">glossary</a> type with the label
+<a id="wrglossary.3513"></a><dfn id="glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></dfn> using:
+<pre class="compactcodebox"><a id="wrglossary.3514"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[glg-abr]{<a id="wrglossary.3515"></a><a href="#glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></a>}{gls-abr}{glo-abr}{<a id="wrglossary.3516"></a><a href="#glo:abbreviationsname"><code class="xtrcsfmt">\abbreviationsname</code></a>}
</pre>
-The label can be accessed with <a id="wrglossary.3520"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a>, which is
-analogous to <a id="wrglossary.3521"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>. See <a id="wrglossary.3522"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for
+The label can be accessed with <a id="wrglossary.3517"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a>, which is
+analogous to <a id="wrglossary.3518"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>. See <a id="wrglossary.3519"></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.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3523"></a><code class="code"><dfn id="glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></dfn>={<span class="meta">〈<em class="metainner">label-list</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3520"></a><code class="code"><dfn id="glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></dfn>={<span class="meta">〈<em class="metainner">label-list</em>〉</span>}</code></div><!-- end of settingsbox -->
-This option is used to identify the <a id="wrglossary.3524"></a><a href="#glo:dual.glossary">glossaries</a> that contain
-<a id="wrglossary.3525"></a><a href="#glo:idx.acronym">acronyms</a> so that they can have their <a id="wrglossary.3526"></a><a href="#glo:idx.entryformat">entry format</a>
-adjusted by <a id="wrglossary.3527"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>. (It also enables <a id="wrglossary.3528"></a><a href="#glo:forallacronyms"><code class="csfmt">\forallacronyms</code></a> to
+This option is used to identify the <a id="wrglossary.3521"></a><a href="#glo:dual.glossary">glossaries</a> that contain
+<a id="wrglossary.3522"></a><a href="#glo:idx.acronym">acronyms</a> so that they can have their <a id="wrglossary.3523"></a><a href="#glo:idx.entryformat">entry format</a>
+adjusted by <a id="wrglossary.3524"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>. (It also enables <a id="wrglossary.3525"></a><a href="#glo:forallacronyms"><code class="csfmt">\forallacronyms</code></a> to
work.)
<p>
-By default, if the list is empty when <a id="wrglossary.3529"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a> is used
-then it will automatically add <a id="wrglossary.3530"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to the list.
+By default, if the list is empty when <a id="wrglossary.3526"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a> is used
+then it will automatically add <a id="wrglossary.3527"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to the list.
<p>
-If you have other lists of <a id="wrglossary.3531"></a><a href="#glo:idx.acronym">acronyms</a>, you can specify them as
-a comma-separated list in the value of <a id="wrglossary.3532"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a>. For
-example, if you use the <a id="wrglossary.3533"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option but you also
-want the <a id="wrglossary.3534"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary to also contain a list of
-<a id="wrglossary.3535"></a><a href="#glo:idx.acronym">acronyms</a>, you can do:
-<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.3536"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3537"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a><span class="optfmt">=<a id="wrglossary.3538"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a></span>]{glossaries}
+If you have other lists of <a id="wrglossary.3528"></a><a href="#glo:idx.acronym">acronyms</a>, you can specify them as
+a comma-separated list in the value of <a id="wrglossary.3529"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a>. For
+example, if you use the <a id="wrglossary.3530"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option but you also
+want the <a id="wrglossary.3531"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary to also contain a list of
+<a id="wrglossary.3532"></a><a href="#glo:idx.acronym">acronyms</a>, you can do:
+<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.3533"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3534"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a><span class="optfmt">=<a id="wrglossary.3535"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a></span>]{glossaries}
</pre>
-No check is performed to determine if the listed <a id="wrglossary.3539"></a><a href="#glo:dual.glossary">glossaries</a> exist,
-so you can add <a id="wrglossary.3540"></a><a href="#glo:dual.glossary">glossaries</a> you haven’t defined yet. 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.3541"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3542"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a><span class="optfmt">={<a id="wrglossary.3543"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>,acronym2}</span>]
+No check is performed to determine if the listed <a id="wrglossary.3536"></a><a href="#glo:dual.glossary">glossaries</a> exist,
+so you can add <a id="wrglossary.3537"></a><a href="#glo:dual.glossary">glossaries</a> you haven’t defined yet. 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.3538"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3539"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a><span class="optfmt">={<a id="wrglossary.3540"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>,acronym2}</span>]
{glossaries}
-<a id="wrglossary.3544"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[alg2]{acronym2}{acr2}{acn2}<span class="comment">% </span>
+<a id="wrglossary.3541"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[alg2]{acronym2}{acr2}{acn2}<span class="comment">% </span>
{Statistical Acronyms}
</pre>
You can 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.3545"></a><code class="code"><dfn id="glo:DeclareAcronymList"><code class="csfmt">\DeclareAcronymList</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3542"></a><code class="code"><dfn id="glo:DeclareAcronymList"><code class="csfmt">\DeclareAcronymList</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
-instead of or in addition to the <a id="wrglossary.3546"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a> option.
-This will add the <a id="wrglossary.3547"></a><a href="#glo:dual.glossary">glossaries</a> given in <span class="meta">〈<em class="metainner">list</em>〉</span> to the list of
-<a id="wrglossary.3548"></a><a href="#glo:dual.glossary">glossaries</a> that are identified as lists of <a id="wrglossary.3549"></a><a href="#glo:idx.acronym">acronyms</a>.
-To replace the list of <a id="wrglossary.3550"></a><a href="#glo:idx.acronym">acronym</a> lists with a new list use:
+instead of or in addition to the <a id="wrglossary.3543"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a> option.
+This will add the <a id="wrglossary.3544"></a><a href="#glo:dual.glossary">glossaries</a> given in <span class="meta">〈<em class="metainner">list</em>〉</span> to the list of
+<a id="wrglossary.3545"></a><a href="#glo:dual.glossary">glossaries</a> that are identified as lists of <a id="wrglossary.3546"></a><a href="#glo:idx.acronym">acronyms</a>.
+To replace the list of <a id="wrglossary.3547"></a><a href="#glo:idx.acronym">acronym</a> lists with a new list 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.3551"></a><code class="code"><dfn id="glo:SetAcronymLists"><code class="csfmt">\SetAcronymLists</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3548"></a><code class="code"><dfn id="glo:SetAcronymLists"><code class="csfmt">\SetAcronymLists</code></dfn>{<span class="meta">〈<em class="metainner">list</em>〉</span>}</code></div><!-- end of pinnedbox -->
<p>
-If the list is changed after <a id="wrglossary.3552"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>
+If the list is changed after <a id="wrglossary.3549"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>
then it will result in inconsistencies in the formatting. If this does
happen, and is for some reason unavoidable (such as
-<a id="wrglossary.3553"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a> occurring in a package that loads
-<a id="wrglossary.3554"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>), you will need to set the <a id="wrglossary.3555"></a><a href="#glo:idx.entryformat">entry format</a> to
+<a id="wrglossary.3550"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a> occurring in a package that loads
+<a id="wrglossary.3551"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>), you will need to set the <a id="wrglossary.3552"></a><a href="#glo:idx.entryformat">entry format</a> to
match the style:
-<pre class="compactcodebox"><a id="wrglossary.3556"></a><a href="#glo:DeclareAcronymList"><code class="csfmt">\DeclareAcronymList</code></a>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}
-<a id="wrglossary.3557"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>[<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>]{<a id="wrglossary.3558"></a><a href="#glo:GlsUseAcrEntryDispStyle"><code class="csfmt">\GlsUseAcrEntryDispStyle</code></a>}{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}
+<pre class="compactcodebox"><a id="wrglossary.3553"></a><a href="#glo:DeclareAcronymList"><code class="csfmt">\DeclareAcronymList</code></a>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}
+<a id="wrglossary.3554"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>[<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>]{<a id="wrglossary.3555"></a><a href="#glo:GlsUseAcrEntryDispStyle"><code class="csfmt">\GlsUseAcrEntryDispStyle</code></a>}{<span class="meta">〈<em class="metainner">style-name</em>〉</span>}
</pre>
<p>
-You can determine if a <a id="wrglossary.3559"></a><a href="#glo:dual.glossary">glossary</a> has been identified as being a list
-of <a id="wrglossary.3560"></a><a href="#glo:idx.acronym">acronyms</a> using:
+You can determine if a <a id="wrglossary.3556"></a><a href="#glo:dual.glossary">glossary</a> has been identified as being a list
+of <a id="wrglossary.3557"></a><a href="#glo:idx.acronym">acronyms</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.3561"></a><code class="code"><dfn id="glo:glsIfListOfAcronyms"><code class="csfmt">\glsIfListOfAcronyms</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3558"></a><code class="code"><dfn id="glo:glsIfListOfAcronyms"><code class="csfmt">\glsIfListOfAcronyms</code></dfn>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}{<span class="meta">〈<em class="metainner">true</em>〉</span>}{<span class="meta">〈<em class="metainner">false</em>〉</span>}</code></div><!-- end of pinnedbox -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3562"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3559"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-This option and associated commands are incompatible with <a id="wrglossary.3563"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a>
-<a id="wrglossary.3564"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a> mechanism. Lists of <a id="wrglossary.3565"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> don’t need identifying.
+This option and associated commands are incompatible with <a id="wrglossary.3560"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a>
+<a id="wrglossary.3561"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a> mechanism. Lists of <a id="wrglossary.3562"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> don’t need identifying.
</div><!-- end of information -->
<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.3566"></a><code class="code"><dfn id="glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></dfn>={<span class="meta">〈<em class="metainner">boolean</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">default: </span>false; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3563"></a><code class="code"><dfn id="glo:opt.shortcuts"><span class="styoptfmt">shortcuts</span></dfn>={<span class="meta">〈<em class="metainner">boolean</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">default: </span>false; <span class="summarytag">initial: </span>false</span><span class="clearfix"></span></div><!-- end of settingsbox -->
This option provides shortcut commands
-for <a id="wrglossary.3567"></a><a href="#glo:idx.acronym">acronyms</a>. See §<a href="#sec:acronyms">6</a> for further details.
+for <a id="wrglossary.3564"></a><a href="#glo:idx.acronym">acronyms</a>. See §<a href="#sec:acronyms">6</a> for further details.
Alternatively you can 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.3568"></a><code class="code"><dfn id="glo:DefineAcronymSynonyms"><code class="csfmt">\DefineAcronymSynonyms</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3565"></a><code class="code"><dfn id="glo:DefineAcronymSynonyms"><code class="csfmt">\DefineAcronymSynonyms</code></dfn></code></div><!-- end of pinnedbox -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3569"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3566"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.3570"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides additional shortcuts.
+The <a id="wrglossary.3567"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides additional shortcuts.
</div><!-- end of information -->
<p>
@@ -11772,99 +11776,99 @@
started generating warnings in version 4.47 (2021-09-20) and as from
version 4.50 will now generate an error unless you use rollback.
<p>
-If you want to change the <a id="wrglossary.3571"></a><a href="#glo:idx.acronymstyle">acronym style</a>, use <a id="wrglossary.3572"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>
+If you want to change the <a id="wrglossary.3568"></a><a href="#glo:idx.acronymstyle">acronym style</a>, use <a id="wrglossary.3569"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>
instead. See §<a href="#sec:acronyms">6</a> for further details.
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3573"></a><code class="code"><dfn id="glo:opt.description"><span class="styoptfmt">description</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3570"></a><code class="code"><dfn id="glo:opt.description"><span class="styoptfmt">description</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
-This option changed the definition of <a id="wrglossary.3574"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> to allow a description.
+This option changed the definition of <a id="wrglossary.3571"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> to allow a description.
This option may be replaced by:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3575"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3576"></a><a href="#glo:opt.acrstyle.long-short-desc"><span class="acrstylefmt">long-short-desc</span></a>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3572"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3573"></a><a href="#glo:opt.acrstyle.long-short-desc"><span class="acrstylefmt">long-short-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3577"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3578"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3579"></a><a href="#glo:opt.acrstyle.long-sc-short-desc"><span class="acrstylefmt">long-sc-short-desc</span></a>}
+or (with <a id="wrglossary.3574"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3575"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3576"></a><a href="#glo:opt.acrstyle.long-sc-short-desc"><span class="acrstylefmt">long-sc-short-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3580"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3581"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3582"></a><a href="#glo:opt.acrstyle.long-sm-short-desc"><span class="acrstylefmt">long-sm-short-desc</span></a>}
+or (with <a id="wrglossary.3577"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3578"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3579"></a><a href="#glo:opt.acrstyle.long-sm-short-desc"><span class="acrstylefmt">long-sm-short-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3583"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3584"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3585"></a><a href="#glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></a>}
+or (with <a id="wrglossary.3580"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3581"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3582"></a><a href="#glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3586"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a> and <a id="wrglossary.3587"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3588"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3589"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
+or (with <a id="wrglossary.3583"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a> and <a id="wrglossary.3584"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3585"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3586"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3590"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a> and <a id="wrglossary.3591"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3592"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3593"></a><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a>}
+or (with <a id="wrglossary.3587"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a> and <a id="wrglossary.3588"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3589"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3590"></a><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3594"></a><a href="#glo:opt.dua"><span class="styoptfmt">dua</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3595"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3596"></a><a href="#glo:opt.acrstyle.dua-desc"><span class="acrstylefmt">dua-desc</span></a>}
+or (with <a id="wrglossary.3591"></a><a href="#glo:opt.dua"><span class="styoptfmt">dua</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3592"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3593"></a><a href="#glo:opt.acrstyle.dua-desc"><span class="acrstylefmt">dua-desc</span></a>}
</pre>
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3597"></a><code class="code"><dfn id="glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3594"></a><code class="code"><dfn id="glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
This option changed the definition of
-<a id="wrglossary.3598"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
+<a id="wrglossary.3595"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
This option may be replaced by:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3599"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3600"></a><a href="#glo:opt.acrstyle.long-sc-short"><span class="acrstylefmt">long-sc-short</span></a>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3596"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3597"></a><a href="#glo:opt.acrstyle.long-sc-short"><span class="acrstylefmt">long-sc-short</span></a>}
</pre>
-or (with <a id="wrglossary.3601"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3602"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3603"></a><a href="#glo:opt.acrstyle.long-sc-short-desc"><span class="acrstylefmt">long-sc-short-desc</span></a>}
+or (with <a id="wrglossary.3598"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3599"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3600"></a><a href="#glo:opt.acrstyle.long-sc-short-desc"><span class="acrstylefmt">long-sc-short-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3604"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a> and <a id="wrglossary.3605"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3606"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3607"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
+or (with <a id="wrglossary.3601"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a> and <a id="wrglossary.3602"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3603"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3604"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
</pre>
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3608"></a><code class="code"><dfn id="glo:opt.smaller"><span class="styoptfmt">smaller</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3605"></a><code class="code"><dfn id="glo:opt.smaller"><span class="styoptfmt">smaller</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
This option changed the definition of
-<a id="wrglossary.3609"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
+<a id="wrglossary.3606"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
This option may be replaced by:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3610"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3611"></a><a href="#glo:opt.acrstyle.long-sm-short"><span class="acrstylefmt">long-sm-short</span></a>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3607"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3608"></a><a href="#glo:opt.acrstyle.long-sm-short"><span class="acrstylefmt">long-sm-short</span></a>}
</pre>
-or (with <a id="wrglossary.3612"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3613"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3614"></a><a href="#glo:opt.acrstyle.long-sm-short-desc"><span class="acrstylefmt">long-sm-short-desc</span></a>}
+or (with <a id="wrglossary.3609"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3610"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3611"></a><a href="#glo:opt.acrstyle.long-sm-short-desc"><span class="acrstylefmt">long-sm-short-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3615"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a> and <a id="wrglossary.3616"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3617"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3618"></a><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a>}
+or (with <a id="wrglossary.3612"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a> and <a id="wrglossary.3613"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3614"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3615"></a><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a>}
</pre>
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3619"></a><code class="code"><dfn id="glo:opt.footnote"><span class="styoptfmt">footnote</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3616"></a><code class="code"><dfn id="glo:opt.footnote"><span class="styoptfmt">footnote</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
This option changed the definition of
-<a id="wrglossary.3620"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
+<a id="wrglossary.3617"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
This option may be replaced by:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3621"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3622"></a><a href="#glo:opt.acrstyle.footnote"><span class="acrstylefmt">footnote</span></a>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3618"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3619"></a><a href="#glo:opt.acrstyle.footnote"><span class="acrstylefmt">footnote</span></a>}
</pre>
-or (with <a id="wrglossary.3623"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3624"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3625"></a><a href="#glo:opt.acrstyle.footnote-sc"><span class="acrstylefmt">footnote-sc</span></a>}
+or (with <a id="wrglossary.3620"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3621"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3622"></a><a href="#glo:opt.acrstyle.footnote-sc"><span class="acrstylefmt">footnote-sc</span></a>}
</pre>
-or (with <a id="wrglossary.3626"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3627"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3628"></a><a href="#glo:opt.acrstyle.footnote-sm"><span class="acrstylefmt">footnote-sm</span></a>}
+or (with <a id="wrglossary.3623"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3624"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3625"></a><a href="#glo:opt.acrstyle.footnote-sm"><span class="acrstylefmt">footnote-sm</span></a>}
</pre>
-or (with <a id="wrglossary.3629"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3630"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3631"></a><a href="#glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></a>}
+or (with <a id="wrglossary.3626"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3627"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3628"></a><a href="#glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3632"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a> and <a id="wrglossary.3633"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3634"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3635"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
+or (with <a id="wrglossary.3629"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a> and <a id="wrglossary.3630"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3631"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3632"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
</pre>
-or (with <a id="wrglossary.3636"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a> and <a id="wrglossary.3637"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3638"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3639"></a><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a>}
+or (with <a id="wrglossary.3633"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a> and <a id="wrglossary.3634"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3635"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3636"></a><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a>}
</pre>
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3640"></a><code class="code"><dfn id="glo:opt.dua"><span class="styoptfmt">dua</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3637"></a><code class="code"><dfn id="glo:opt.dua"><span class="styoptfmt">dua</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
This option changed the definition of
-<a id="wrglossary.3641"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> so that acronyms are always expanded.
+<a id="wrglossary.3638"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> so that acronyms are always expanded.
This option may be replaced by:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3642"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{dua}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3639"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{dua}
</pre>
-or (with <a id="wrglossary.3643"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3644"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3645"></a><a href="#glo:opt.acrstyle.dua-desc"><span class="acrstylefmt">dua-desc</span></a>}
+or (with <a id="wrglossary.3640"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a>)
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3641"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3642"></a><a href="#glo:opt.acrstyle.dua-desc"><span class="acrstylefmt">dua-desc</span></a>}
</pre>
<p>
@@ -11878,47 +11882,47 @@
are described below.
<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.3646"></a><code class="code"><dfn id="glo:opt.accsupp"><span class="xtrstyoptfmt">accsupp</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3643"></a><code class="code"><dfn id="glo:opt.accsupp"><span class="xtrstyoptfmt">accsupp</span></dfn></code></div><!-- end of settingsbox -->
<p>
-Only available with <a id="wrglossary.3647"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option
-loads the <a id="wrglossary.3648"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> package, which needs to be loaded
-either before <a id="wrglossary.3649"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> or while <a id="wrglossary.3650"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+Only available with <a id="wrglossary.3644"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option
+loads the <a id="wrglossary.3645"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> package, which needs to be loaded
+either before <a id="wrglossary.3646"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> or while <a id="wrglossary.3647"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
is loaded to ensure both packages are properly integrated.
<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.3651"></a><code class="code"><dfn id="glo:opt.prefix"><span class="xtrstyoptfmt">prefix</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3648"></a><code class="code"><dfn id="glo:opt.prefix"><span class="xtrstyoptfmt">prefix</span></dfn></code></div><!-- end of settingsbox -->
<p>
-Only available with <a id="wrglossary.3652"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option
-loads the <a id="wrglossary.3653"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> package.
+Only available with <a id="wrglossary.3649"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option
+loads the <a id="wrglossary.3650"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> package.
<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.3654"></a><code class="code"><dfn id="glo:opt.nomissingglstext"><span class="xtrstyoptfmt">nomissingglstext</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 -->
+<a id="wrglossary.3651"></a><code class="code"><dfn id="glo:opt.nomissingglstext"><span class="xtrstyoptfmt">nomissingglstext</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 may be used to suppress the boilerplate text generated
-by <a id="wrglossary.3655"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> if the <a id="wrglossary.3656"></a><a href="#glo:dual.indexingfile">indexing file</a> is missing.
+by <a id="wrglossary.3652"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> if the <a id="wrglossary.3653"></a><a href="#glo:dual.indexingfile">indexing file</a> is missing.
<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.3657"></a><code class="code"><dfn id="glo:opt.mfirstuc"><span class="styoptfmt">mfirstuc</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>unexpanded</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3654"></a><code class="code"><dfn id="glo:opt.mfirstuc"><span class="styoptfmt">mfirstuc</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>unexpanded</span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
The value may be either <span class="optfmt">expanded</span> or <span class="optfmt">unexpanded</span> and
-performs the same function as <a id="wrglossary.3658"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> <span class="optfmt">expanded</span>
+performs the same function as <a id="wrglossary.3655"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> <span class="optfmt">expanded</span>
and <span class="optfmt">unexpanded</span> package options. Note that there’s no value
-corresponding to <a id="wrglossary.3659"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> other package option.
+corresponding to <a id="wrglossary.3656"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> other package option.
<p>
-The default is <a id="wrglossary.3660"></a><a href="#glo:opt.mfirstuc"><span class="styoptfmt">mfirstuc</span></a><span class="optfmt">=unexpanded</span> to safeguard against
-<a id="wrglossary.3661"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that convert the description to
-<a id="wrglossary.3662"></a><a href="#glo:idx.sentencecase">sentence case</a>. With older versions of <a id="wrglossary.3663"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>
+The default is <a id="wrglossary.3657"></a><a href="#glo:opt.mfirstuc"><span class="styoptfmt">mfirstuc</span></a><span class="optfmt">=unexpanded</span> to safeguard against
+<a id="wrglossary.3658"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that convert the description to
+<a id="wrglossary.3659"></a><a href="#glo:idx.sentencecase">sentence case</a>. With older versions of <a id="wrglossary.3660"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>
(pre v2.08), fragile commands in the description would not have been
-affected by the <a id="wrglossary.3664"></a><a href="#glo:dual.casechange">case change</a>, but now, if the entire description is passed
-to <a id="wrglossary.3665"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, it will be expanded, which could break
+affected by the <a id="wrglossary.3661"></a><a href="#glo:dual.casechange">case change</a>, but now, if the entire description is passed
+to <a id="wrglossary.3662"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, it will be expanded, which could break
existing documents.
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3666"></a><code class="code"><dfn id="glo:opt.compatible-2.07"><span class="styoptfmt">compatible-2.07</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3663"></a><code class="code"><dfn id="glo:opt.compatible-2.07"><span class="styoptfmt">compatible-2.07</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
<p>
Compatibility mode for old documents created using version 2.07 or
@@ -11926,7 +11930,7 @@
§<a href="#sec:rollback">1.1</a>).
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></div><!-- end of settingsboxtitle -->
-<a id="wrglossary.3667"></a><code class="code"><dfn id="glo:opt.compatible-3.07"><span class="styoptfmt">compatible-3.07</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3664"></a><code class="code"><dfn id="glo:opt.compatible-3.07"><span class="styoptfmt">compatible-3.07</span></dfn></code><span class="floatrightbox"><a href="#glo:sym.deprecated"><span title="Deprecated" class="icon"><span class="deprecatedorbannedfmt">🗑</span></span></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
Compatibility mode for old documents created using version 3.07 or
below. This option is now only available with rollback (see
@@ -11933,11 +11937,11 @@
§<a href="#sec:rollback">1.1</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.3668"></a><code class="code"><dfn id="glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</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 -->
+<a id="wrglossary.3665"></a><code class="code"><dfn id="glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</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 -->
-As a legacy from the precursor <a id="wrglossary.3669"></a><a href="#glo:pkg.glossary"><span class="styfmt">glossary</span></a> package, the standard
-glossary commands provided by the LaTeX kernel (<a id="wrglossary.3670"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>
-and <a id="wrglossary.3671"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a>) are redefined in terms of the <a id="wrglossary.3672"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+As a legacy from the precursor <a id="wrglossary.3666"></a><a href="#glo:pkg.glossary"><span class="styfmt">glossary</span></a> package, the standard
+glossary commands provided by the LaTeX kernel (<a id="wrglossary.3667"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>
+and <a id="wrglossary.3668"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a>) are redefined in terms of the <a id="wrglossary.3669"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
package’s commands. However, they were never documented in this
user manual, and the conversion guide (<a href="glossary2glossaries.html"><span class="qt">“Upgrading from the
<span class="styfmt">glossary</span> package to the <span class="styfmt">glossaries</span> package”</span></a>)
@@ -11945,43 +11949,43 @@
<p>
The redefinitions of these commands was removed in v4.10,
but unfortunately it turned out that some packages had hacked
-the internal commands provided by <a id="wrglossary.3673"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and no longer
+the internal commands provided by <a id="wrglossary.3670"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and no longer
worked when they were removed, so they were restored in v4.41 with
-this option to undo the effect with <a id="wrglossary.3674"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a><span class="optfmt">=true</span>
+this option to undo the effect with <a id="wrglossary.3671"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a><span class="optfmt">=true</span>
as the default. As from v4.50, the default is now
-<a id="wrglossary.3675"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a><span class="optfmt">=false</span>.
+<a id="wrglossary.3672"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a><span class="optfmt">=false</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.3676"></a><a id="wrglossary.3677"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a>=<code class="code"><dfn id="glo:optval.kernelglossredefs.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
+<a id="wrglossary.3673"></a><a id="wrglossary.3674"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a>=<code class="code"><dfn id="glo:optval.kernelglossredefs.false"><span class="optfmt">false</span></dfn></code></div><!-- end of optionvaluebox -->
-Don’t redefine <a id="wrglossary.3678"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3679"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>. If they have
-been previously redefined by <a id="wrglossary.3680"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a> their original
-definitions (at the time <a id="wrglossary.3681"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> was loaded) will be
+Don’t redefine <a id="wrglossary.3675"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3676"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>. If they have
+been previously redefined by <a id="wrglossary.3677"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a> their original
+definitions (at the time <a id="wrglossary.3678"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> was loaded) will be
restored.
<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.3682"></a><a id="wrglossary.3683"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a>=<code class="code"><dfn id="glo:optval.kernelglossredefs.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
+<a id="wrglossary.3679"></a><a id="wrglossary.3680"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a>=<code class="code"><dfn id="glo:optval.kernelglossredefs.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
-Redefine <a id="wrglossary.3684"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3685"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>, but their use will
+Redefine <a id="wrglossary.3681"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3682"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>, but their use will
trigger warnings.
<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.3686"></a><a id="wrglossary.3687"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a>=<code class="code"><dfn id="glo:optval.kernelglossredefs.nowarn"><span class="optfmt">nowarn</span></dfn></code></div><!-- end of optionvaluebox -->
+<a id="wrglossary.3683"></a><a id="wrglossary.3684"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a>=<code class="code"><dfn id="glo:optval.kernelglossredefs.nowarn"><span class="optfmt">nowarn</span></dfn></code></div><!-- end of optionvaluebox -->
-Redefine <a id="wrglossary.3688"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3689"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a> without any warnings.
+Redefine <a id="wrglossary.3685"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3686"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a> without any warnings.
<p>
-The only glossary-related commands provided by the LaTeX kernel are <a id="wrglossary.3690"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a> and <a id="wrglossary.3691"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a>. Other packages
+The only glossary-related commands provided by the LaTeX kernel are <a id="wrglossary.3687"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a> and <a id="wrglossary.3688"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a>. Other packages
or classes may provide additional glossary-related commands or
-environments that conflict with <a id="wrglossary.3692"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> (such as
-<a id="wrglossary.3693"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.3694"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>). These non-kernel commands
+environments that conflict with <a id="wrglossary.3689"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> (such as
+<a id="wrglossary.3690"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.3691"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>). These non-kernel commands
aren’t affected by this package option, and you will have to find
some way to resolve the conflict if you require both glossary
-mechanisms. (The <a id="wrglossary.3695"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will override the existing
-definitions of <a id="wrglossary.3696"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.3697"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>.)
+mechanisms. (The <a id="wrglossary.3692"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will override the existing
+definitions of <a id="wrglossary.3693"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.3694"></a><a href="#glo:env.theglossary"><span class="envfmt">theglossary</span></a>.)
<p>
In general, if possible, it’s best to stick with just one package that
-provides a glossary mechanism. (The <a id="wrglossary.3698"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package does
-check for the <a id="wrglossary.3699"></a><a href="#glo:pkg.doc"><span class="styfmt">doc</span></a> package and patches <a id="wrglossary.3700"></a><a href="#glo:PrintChanges"><code class="csfmt">\PrintChanges</code></a>.)
+provides a glossary mechanism. (The <a id="wrglossary.3695"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package does
+check for the <a id="wrglossary.3696"></a><a href="#glo:pkg.doc"><span class="styfmt">doc</span></a> package and patches <a id="wrglossary.3697"></a><a href="#glo:PrintChanges"><code class="csfmt">\PrintChanges</code></a>.)
<p>
</section><!-- end of section sec:pkgopts-other -->
@@ -11991,24 +11995,24 @@
<p>
Some of the options described above may also be set after the
-<a id="wrglossary.3701"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package has been loaded using
+<a id="wrglossary.3698"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package has been loaded 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.3702"></a><code class="code"><dfn id="glo:setupglossaries"><code class="csfmt">\setupglossaries</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3699"></a><code class="code"><dfn id="glo:setupglossaries"><code class="csfmt">\setupglossaries</code></dfn>{<span class="meta">〈<em class="metainner">options</em>〉</span>}</code></div><!-- end of pinnedbox -->
The following package options <strong class="strong">can’t</strong> be used in
-<a id="wrglossary.3703"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>: <a id="wrglossary.3704"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>, <a id="wrglossary.3705"></a><a href="#glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></a>,
-<a id="wrglossary.3706"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a>, <a id="wrglossary.3707"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>,
-<a id="wrglossary.3708"></a><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a>, <a id="wrglossary.3709"></a><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a>, <a id="wrglossary.3710"></a><a href="#glo:opt.nolist"><span class="styoptfmt">nolist</span></a>,
-<a id="wrglossary.3711"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a>, <a id="wrglossary.3712"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>, <a id="wrglossary.3713"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a>,
-<a id="wrglossary.3714"></a><a href="#glo:opt.compatible-2.07"><span class="styoptfmt">compatible-2.07</span></a>, <a id="wrglossary.3715"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>, <a id="wrglossary.3716"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>,
-<a id="wrglossary.3717"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>, <a id="wrglossary.3718"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>. These options have to be set while the package is
-loading, except for the <a id="wrglossary.3719"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> sub-options which can be set
-using commands like <a id="wrglossary.3720"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> (see
+<a id="wrglossary.3700"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>: <a id="wrglossary.3701"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>, <a id="wrglossary.3702"></a><a href="#glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></a>,
+<a id="wrglossary.3703"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a>, <a id="wrglossary.3704"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>,
+<a id="wrglossary.3705"></a><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a>, <a id="wrglossary.3706"></a><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a>, <a id="wrglossary.3707"></a><a href="#glo:opt.nolist"><span class="styoptfmt">nolist</span></a>,
+<a id="wrglossary.3708"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a>, <a id="wrglossary.3709"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>, <a id="wrglossary.3710"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a>,
+<a id="wrglossary.3711"></a><a href="#glo:opt.compatible-2.07"><span class="styoptfmt">compatible-2.07</span></a>, <a id="wrglossary.3712"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>, <a id="wrglossary.3713"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>,
+<a id="wrglossary.3714"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>, <a id="wrglossary.3715"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>. These options have to be set while the package is
+loading, except for the <a id="wrglossary.3716"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> sub-options which can be set
+using commands like <a id="wrglossary.3717"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> (see
§<a href="#sec:xindy">14</a> 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 -->
If you need to use this command, use it as soon as
-possible after loading <a id="wrglossary.3721"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> otherwise you might
+possible after loading <a id="wrglossary.3718"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> otherwise you might
end up using it too late for the change to take effect. If you
try changing the sort option after you have
started to define entries, you may get unexpected results.
@@ -12015,9 +12019,9 @@
</div><!-- end of important -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3722"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3719"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-With <a id="wrglossary.3723"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, use <a id="wrglossary.3724"></a><a href="#glo:glossariesextrasetup"><code class="xtrcsfmt">\glossariesextrasetup</code></a>
+With <a id="wrglossary.3720"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, use <a id="wrglossary.3721"></a><a href="#glo:glossariesextrasetup"><code class="xtrcsfmt">\glossariesextrasetup</code></a>
instead.
</div><!-- end of information -->
@@ -12030,16 +12034,16 @@
<h1><!-- start of chapter header -->3. Setting Up<span class="labellink"><a href="#sec:setup">[link]</a></span></h1><!-- end of chapter header -->
<p>
-In the <a id="wrglossary.3725"></a><a href="#glo:idx.preamble/document">preamble</a> you need to indicate which method you want to use to
-generate the <a id="wrglossary.3726"></a><a href="#glo:dual.glossary">glossary</a> (or <a id="wrglossary.3727"></a><a href="#glo:dual.glossary">glossaries</a>). The available options with
-both <a id="wrglossary.3728"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.3729"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> are
+In the <a id="wrglossary.3722"></a><a href="#glo:idx.preamble/document">preamble</a> you need to indicate which method you want to use to
+generate the <a id="wrglossary.3723"></a><a href="#glo:dual.glossary">glossary</a> (or <a id="wrglossary.3724"></a><a href="#glo:dual.glossary">glossaries</a>). The available options with
+both <a id="wrglossary.3725"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.3726"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> are
summarized in §<a href="#sec:indexingoptions">1.3</a>. This chapter
documents 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>, which are provided by the base package. See the
-<a id="wrglossary.3730"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.3731"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manuals for the full
+<a id="wrglossary.3727"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.3728"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manuals for the full
documentation of the other options.
<p>
-If you don’t need to display any <a id="wrglossary.3732"></a><a href="#glo:dual.glossary">glossaries</a>, for example, if you are
-just using the <a id="wrglossary.3733"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to enable consistent
+If you don’t need to display any <a id="wrglossary.3729"></a><a href="#glo:dual.glossary">glossaries</a>, for example, if you are
+just using the <a id="wrglossary.3730"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package to enable consistent
formatting, then skip ahead to §<a href="#sec:newglosentry">4</a>.
<p>
@@ -12051,15 +12055,15 @@
<p>
The 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.3734"></a><code class="code"><dfn id="glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></dfn></code>
+<a id="wrglossary.3731"></a><code class="code"><dfn id="glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></dfn></code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
-must be placed in the <a id="wrglossary.3735"></a><a href="#glo:idx.preamble/document">document preamble</a>. This sets up the internal commands
-required to make <a id="wrglossary.3736"></a><a href="#glo:idx.opt.noidx">Option 1</a> work.
-<strong class="strong">If you omit <a id="wrglossary.3737"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> none of
-the <a id="wrglossary.3738"></a><a href="#glo:dual.glossary">glossaries</a> will be displayed.</strong>
+must be placed in the <a id="wrglossary.3732"></a><a href="#glo:idx.preamble/document">document preamble</a>. This sets up the internal commands
+required to make <a id="wrglossary.3733"></a><a href="#glo:idx.opt.noidx">Option 1</a> work.
+<strong class="strong">If you omit <a id="wrglossary.3734"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> none of
+the <a id="wrglossary.3735"></a><a href="#glo:dual.glossary">glossaries</a> will be displayed.</strong>
<p>
</section><!-- end of section sec:setupopt1 -->
@@ -12070,104 +12074,104 @@
<p>
The 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.3739"></a><code class="code"><dfn id="glo:makeglossaries"><code class="csfmt">\makeglossaries</code></dfn></code>
+<a id="wrglossary.3736"></a><code class="code"><dfn id="glo:makeglossaries"><code class="csfmt">\makeglossaries</code></dfn></code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
-must be placed in the <a id="wrglossary.3740"></a><a href="#glo:idx.preamble/document">document preamble</a> in order to create the customised
-<a id="wrglossary.3741"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.3742"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.3743"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.3744"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>)
+must be placed in the <a id="wrglossary.3737"></a><a href="#glo:idx.preamble/document">document preamble</a> in order to create the customised
+<a id="wrglossary.3738"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.3739"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.3740"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.3741"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>)
style file (for Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, respectively) and to ensure that
-<a id="wrglossary.3745"></a><a href="#glo:dual.glossary">glossary</a> entries are written to the appropriate output files.
-<strong class="strong">If you omit <a id="wrglossary.3746"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> none of
-the <a id="wrglossary.3747"></a><a href="#glo:dual.indexingfile">indexing files</a> will be created.</strong>
+<a id="wrglossary.3742"></a><a href="#glo:dual.glossary">glossary</a> entries are written to the appropriate output files.
+<strong class="strong">If you omit <a id="wrglossary.3743"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> none of
+the <a id="wrglossary.3744"></a><a href="#glo:dual.indexingfile">indexing files</a> will be created.</strong>
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3748"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3745"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-If you are using <a id="wrglossary.3749"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, <a id="wrglossary.3750"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> has an
+If you are using <a id="wrglossary.3746"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, <a id="wrglossary.3747"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> has an
optional argument that allows you to have a hybrid of Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.mkidx">2</a> or
-Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.xdy">3</a>. See <a id="wrglossary.3751"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.xdy">3</a>. See <a id="wrglossary.3748"></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="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Note that some of the commands provided by the <a id="wrglossary.3752"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
-package must not be used after <a id="wrglossary.3753"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> as they are
+Note that some of the commands provided by the <a id="wrglossary.3749"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+package must not be used after <a id="wrglossary.3750"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> as they are
required when creating the customised style file. If you attempt
-to use those commands after <a id="wrglossary.3754"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> you will generate
+to use those commands after <a id="wrglossary.3751"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> you will generate
an error.
Similarly, there are some commands that must not be used before
-<a id="wrglossary.3755"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> because they require the associated
-<a id="wrglossary.3756"></a><a href="#glo:dual.indexingfile">indexing files</a> to be open, if those files should be created.
+<a id="wrglossary.3752"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> because they require the associated
+<a id="wrglossary.3753"></a><a href="#glo:dual.indexingfile">indexing files</a> to be open, if those files should be created.
These may not necessarily generate an error or warning as a
-different <a id="wrglossary.3757"></a><a href="#glo:dual.indexing">indexing</a> option may be chosen that doesn’t require
+different <a id="wrglossary.3754"></a><a href="#glo:dual.indexing">indexing</a> option may be chosen that doesn’t require
those files (such as Options <a href="#glo:idx.opt.unsrt">5</a> or <a href="#glo:idx.opt.standalone">6</a>).
</div><!-- end of important -->
<p>
-The <a id="wrglossary.3758"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> command internally uses:
+The <a id="wrglossary.3755"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> command internally 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.3759"></a><code class="code"><dfn id="glo:writeist"><code class="csfmt">\writeist</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3756"></a><code class="code"><dfn id="glo:writeist"><code class="csfmt">\writeist</code></dfn></code></div><!-- end of pinnedbox -->
-to create the custom <a id="wrglossary.3760"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.3761"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file.
-This command disables itself by setting itself to <a id="wrglossary.3762"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> so
+to create the custom <a id="wrglossary.3757"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.3758"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file.
+This command disables itself by setting itself to <a id="wrglossary.3759"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> so
that it can only be used once. In general, there should be no reason
to use or alter this command.
<p>
The default name for the customised style file is given by
-<code class="code"><a id="wrglossary.3763"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.3764"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a></code> (<a id="wrglossary.3765"></a><a href="#glo:idx.opt.mkidx">Option 2</a>) or
-<code class="code"><a id="wrglossary.3766"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.3767"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a></code> (<a id="wrglossary.3768"></a><a href="#glo:idx.opt.xdy">Option 3</a>). This name may be
+<code class="code"><a id="wrglossary.3760"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.3761"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a></code> (<a id="wrglossary.3762"></a><a href="#glo:idx.opt.mkidx">Option 2</a>) or
+<code class="code"><a id="wrglossary.3763"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.3764"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a></code> (<a id="wrglossary.3765"></a><a href="#glo:idx.opt.xdy">Option 3</a>). This name may be
changed 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.3769"></a><code class="code"><dfn id="glo:setStyleFile"><code class="csfmt">\setStyleFile</code></dfn>{<span class="meta">〈<em class="metainner">name</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3766"></a><code class="code"><dfn id="glo:setStyleFile"><code class="csfmt">\setStyleFile</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 name of the style file without the
extension.
<p>
-<a id="sec:isthook"></a>There is a hook near the end of <a id="wrglossary.3770"></a><a href="#glo:writeist"><code class="csfmt">\writeist</code></a> that can be set with:
+<a id="sec:isthook"></a>There is a hook near the end of <a id="wrglossary.3767"></a><a href="#glo:writeist"><code class="csfmt">\writeist</code></a> that can be set 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.3771"></a><code class="code"><dfn id="glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></dfn>{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3768"></a><code class="code"><dfn id="glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></dfn>{<span class="meta">〈<em class="metainner">code</em>〉</span>}</code></div><!-- end of pinnedbox -->
The <span class="meta">〈<em class="metainner">code</em>〉</span> will be performed while the style file is still
open, which allows additional content to be added to it.
The associated write register is:
<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.3772"></a><code class="code"><dfn id="glo:glswrite"><code class="csfmt">\glswrite</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3769"></a><code class="code"><dfn id="glo:glswrite"><code class="csfmt">\glswrite</code></dfn></code></div><!-- end of pinnedbox -->
-Note that this register is defined by <a id="wrglossary.3773"></a><a href="#glo:writeist"><code class="csfmt">\writeist</code></a> to prevent an
-unnecessary write register from being created in the event that neither <a id="wrglossary.3774"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-nor <a id="wrglossary.3775"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is required.
+Note that this register is defined by <a id="wrglossary.3770"></a><a href="#glo:writeist"><code class="csfmt">\writeist</code></a> to prevent an
+unnecessary write register from being created in the event that neither <a id="wrglossary.3771"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+nor <a id="wrglossary.3772"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is required.
<p>
-If you use the <a id="wrglossary.3776"></a><a href="#glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></a> hook to write extra
+If you use the <a id="wrglossary.3773"></a><a href="#glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></a> hook to write extra
information to the style file, make sure you use the appropriate
-syntax for the desired <a id="wrglossary.3777"></a><a href="#glo:dual.indexingapp">indexing application</a>. For example, with
-<a id="wrglossary.3778"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3779"></a><a href="#glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></a>{<span class="comment">% </span>
- <a id="wrglossary.3780"></a><a href="#glo:write"><code class="csfmt">\write</code></a><a id="wrglossary.3781"></a><a href="#glo:glswrite"><code class="csfmt">\glswrite</code></a>{page_precedence "arnAR"}<span class="comment">% </span>
- <a id="wrglossary.3782"></a><a href="#glo:write"><code class="csfmt">\write</code></a><a id="wrglossary.3783"></a><a href="#glo:glswrite"><code class="csfmt">\glswrite</code></a>{line_max 80}<span class="comment">% </span>
+syntax for the desired <a id="wrglossary.3774"></a><a href="#glo:dual.indexingapp">indexing application</a>. For example, with
+<a id="wrglossary.3775"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3776"></a><a href="#glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></a>{<span class="comment">% </span>
+ <a id="wrglossary.3777"></a><a href="#glo:write"><code class="csfmt">\write</code></a><a id="wrglossary.3778"></a><a href="#glo:glswrite"><code class="csfmt">\glswrite</code></a>{page_precedence "arnAR"}<span class="comment">% </span>
+ <a id="wrglossary.3779"></a><a href="#glo:write"><code class="csfmt">\write</code></a><a id="wrglossary.3780"></a><a href="#glo:glswrite"><code class="csfmt">\glswrite</code></a>{line_max 80}<span class="comment">% </span>
}
</pre>
-This changes the <a id="wrglossary.3784"></a><a href="#glo:idx.pageprecedence">page precedence</a> and the maximum line length
-used by <a id="wrglossary.3785"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.
+This changes the <a id="wrglossary.3781"></a><a href="#glo:idx.pageprecedence">page precedence</a> and the maximum line length
+used by <a id="wrglossary.3782"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.
<p>
-Remember that if you switch to <a id="wrglossary.3786"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, this will no longer be
+Remember that if you switch to <a id="wrglossary.3783"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, this will no longer be
valid code.
<p>
-You can suppress the creation of the customised <a id="wrglossary.3787"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
-or <a id="wrglossary.3788"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style file using:
+You can suppress the creation of the customised <a id="wrglossary.3784"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+or <a id="wrglossary.3785"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style file 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.3789"></a><code class="code"><dfn id="glo:noist"><code class="csfmt">\noist</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3786"></a><code class="code"><dfn id="glo:noist"><code class="csfmt">\noist</code></dfn></code></div><!-- end of pinnedbox -->
This is provided in the event that you want to supply your own
customized style file that can’t be replicated with the available
-options and commands provided by the <a id="wrglossary.3790"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
-This command sets <a id="wrglossary.3791"></a><a href="#glo:writeist"><code class="csfmt">\writeist</code></a> to <a id="wrglossary.3792"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> (making it do
-nothing) but will also update the <a id="wrglossary.3793"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
-<a id="wrglossary.3794"></a><a href="#glo:idx.xindyattr">attribute list</a> if applicable.
+options and commands provided by the <a id="wrglossary.3787"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
+This command sets <a id="wrglossary.3788"></a><a href="#glo:writeist"><code class="csfmt">\writeist</code></a> to <a id="wrglossary.3789"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> (making it do
+nothing) but will also update the <a id="wrglossary.3790"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+<a id="wrglossary.3791"></a><a href="#glo:idx.xindyattr">attribute list</a> if applicable.
<p>
-If you have a custom <a id="wrglossary.3795"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> file created when using
-<a id="wrglossary.3796"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> version 2.07 (2010-0710) or below, you will need to use
-rollback and the <a id="wrglossary.3797"></a><a href="#glo:opt.compatible-2.07"><span class="styoptfmt">compatible-2.07</span></a> package option with it.
+If you have a custom <a id="wrglossary.3792"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> file created when using
+<a id="wrglossary.3793"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> version 2.07 (2010-0710) or below, you will need to use
+rollback and the <a id="wrglossary.3794"></a><a href="#glo:opt.compatible-2.07"><span class="styoptfmt">compatible-2.07</span></a> package option with it.
However, that is now so dated and the LaTeX kernel has changed
significantly since that time that you may need to use a legacy
distribution (see
@@ -12174,50 +12178,50 @@
<a href="https://www.dickimaw-books.com/blog/legacy-documents-and-tex-live-docker-images">Legacy Documents
and TeX Live Docker Images</a>).
<p>
-Each <a id="wrglossary.3798"></a><a href="#glo:idx.glossaryentry">glossary entry</a> is assigned a <a id="wrglossary.3799"></a><a href="#glo:locationlist">number list</a> that lists all
-the <a id="wrglossary.3800"></a><a href="#glo:dual.entrylocation">locations</a> in the document where that <a id="wrglossary.3801"></a><a href="#glo:idx.glossaryentry">entry</a> was used. By default,
-the <a id="wrglossary.3802"></a><a href="#glo:dual.entrylocation">location</a> refers to the page number but this may be overridden
-using the <a id="wrglossary.3803"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option. The default form of
-the <a id="wrglossary.3804"></a><a href="#glo:dual.entrylocation">location</a> number assumes a full stop <a id="wrglossary.3805"></a><a href="#glo:idx.compositor">compositor</a> (for example, 1.2),
-but if your <a id="wrglossary.3806"></a><a href="#glo:dual.entrylocation">location</a> numbers use a different <a id="wrglossary.3807"></a><a href="#glo:idx.compositor">compositor</a> (for
+Each <a id="wrglossary.3795"></a><a href="#glo:idx.glossaryentry">glossary entry</a> is assigned a <a id="wrglossary.3796"></a><a href="#glo:locationlist">number list</a> that lists all
+the <a id="wrglossary.3797"></a><a href="#glo:dual.entrylocation">locations</a> in the document where that <a id="wrglossary.3798"></a><a href="#glo:idx.glossaryentry">entry</a> was used. By default,
+the <a id="wrglossary.3799"></a><a href="#glo:dual.entrylocation">location</a> refers to the page number but this may be overridden
+using the <a id="wrglossary.3800"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option. The default form of
+the <a id="wrglossary.3801"></a><a href="#glo:dual.entrylocation">location</a> number assumes a full stop <a id="wrglossary.3802"></a><a href="#glo:idx.compositor">compositor</a> (for example, 1.2),
+but if your <a id="wrglossary.3803"></a><a href="#glo:dual.entrylocation">location</a> numbers use a different <a id="wrglossary.3804"></a><a href="#glo:idx.compositor">compositor</a> (for
example, 1-2) you need to set this 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.3808"></a><code class="code"><dfn id="glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3805"></a><code class="code"><dfn id="glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code></div><!-- end of pinnedbox -->
{symbol}
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3809"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>{-}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3806"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>{-}
</pre>
-This command must not be used after <a id="wrglossary.3810"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Note that
-with <a id="wrglossary.3811"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, any <a id="wrglossary.3812"></a><a href="#glo:dual.entrylocation">locations</a> with the wrong <a id="wrglossary.3813"></a><a href="#glo:idx.compositor">compositor</a>
+This command must not be used after <a id="wrglossary.3807"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Note that
+with <a id="wrglossary.3808"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, any <a id="wrglossary.3809"></a><a href="#glo:dual.entrylocation">locations</a> with the wrong <a id="wrglossary.3810"></a><a href="#glo:idx.compositor">compositor</a>
(or one that hasn’t been correctly identified with
-<a id="wrglossary.3814"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>) will cause <a id="wrglossary.3815"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> to reject the
-<a id="wrglossary.3816"></a><a href="#glo:dual.entrylocation">location</a> with an invalid number/digit message. As from
-v4.50, <a id="wrglossary.3817"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for this message and attempt
+<a id="wrglossary.3811"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>) will cause <a id="wrglossary.3812"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> to reject the
+<a id="wrglossary.3813"></a><a href="#glo:dual.entrylocation">location</a> with an invalid number/digit message. As from
+v4.50, <a id="wrglossary.3814"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for this message and attempt
a correction, but this can result in an incorrectly formatted
-<a id="wrglossary.3818"></a><a href="#glo:dual.entrylocation">location</a> in the <a id="wrglossary.3819"></a><a href="#glo:locationlist">number list</a>. See the information about
-<a id="wrglossary.3820"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span>’s</a> <a id="wrglossary.3821"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a> switch
+<a id="wrglossary.3815"></a><a href="#glo:dual.entrylocation">location</a> in the <a id="wrglossary.3816"></a><a href="#glo:locationlist">number list</a>. See the information about
+<a id="wrglossary.3817"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span>’s</a> <a id="wrglossary.3818"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a> switch
in §<a href="#sec:makeglossariesapp">1.6.1</a> for further details.
<p>
-An invalid page number will also cause <a id="wrglossary.3822"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to fail with a
+An invalid page number will also cause <a id="wrglossary.3819"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to fail with a
<span class="qt">“did not match any location-class”</span> warning. This is also
-something that <a id="wrglossary.3823"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for and will provided
+something that <a id="wrglossary.3820"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for and will provided
diagnostic information, but it won’t attempt to make any correction.
<p>
-If you use <a id="wrglossary.3824"></a><a href="#glo:idx.opt.xdy">Option 3</a>, you can have a different <a id="wrglossary.3825"></a><a href="#glo:idx.compositor">compositor</a> for page
+If you use <a id="wrglossary.3821"></a><a href="#glo:idx.opt.xdy">Option 3</a>, you can have a different <a id="wrglossary.3822"></a><a href="#glo:idx.compositor">compositor</a> for page
numbers starting with an upper case alphabetical 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.3826"></a><code class="code"><dfn id="glo:glsSetAlphaCompositor"><code class="csfmt">\glsSetAlphaCompositor</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code>
+<a id="wrglossary.3823"></a><code class="code"><dfn id="glo:glsSetAlphaCompositor"><code class="csfmt">\glsSetAlphaCompositor</code></dfn>{<span class="meta">〈<em class="metainner">character</em>〉</span>}</code>
<p>
<div class="noteBox"></div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
-This command is only available with <a id="wrglossary.3827"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. For example, if you want
-<a id="wrglossary.3828"></a><a href="#glo:locationlist">number lists</a> containing a mixture of A-1 and 2.3 style
+This command is only available with <a id="wrglossary.3824"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. For example, if you want
+<a id="wrglossary.3825"></a><a href="#glo:locationlist">number lists</a> containing a mixture of A-1 and 2.3 style
formats, then do:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3829"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>{.}<a id="wrglossary.3830"></a><a href="#glo:glsSetAlphaCompositor"><code class="csfmt">\glsSetAlphaCompositor</code></a>{-}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3826"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>{.}<a id="wrglossary.3827"></a><a href="#glo:glsSetAlphaCompositor"><code class="csfmt">\glsSetAlphaCompositor</code></a>{-}
</pre>
See §<a href="#sec:numberlists">12</a> for further information about
-<a id="wrglossary.3831"></a><a href="#glo:locationlist">number lists</a>.
+<a id="wrglossary.3828"></a><a href="#glo:locationlist">number lists</a>.
<p>
</section><!-- end of section sec:setupopt23 -->
@@ -12226,71 +12230,71 @@
<h1><!-- start of chapter header -->4. Defining Glossary Entries<span class="labellink"><a href="#sec:newglosentry">[link]</a></span></h1><!-- end of chapter header -->
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3832"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3829"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-If you want to use <a id="wrglossary.3833"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, entries must be defined in
-<a id="wrglossary.3834"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files using the syntax described in the <a id="wrglossary.3835"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
+If you want to use <a id="wrglossary.3830"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, entries must be defined in
+<a id="wrglossary.3831"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files using the syntax described in the <a id="wrglossary.3832"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
user manual.
</div><!-- end of information -->
<p>
-<a id="wrglossary.3836"></a><a href="#glo:idx.acronym">Acronyms</a> are covered in §<a href="#sec:acronyms">6</a> but they use the
-same underlying mechanism as all the other <a id="wrglossary.3837"></a><a href="#glo:idx.glossaryentry">glossary entries</a>, so it’s a good
+<a id="wrglossary.3833"></a><a href="#glo:idx.acronym">Acronyms</a> are covered in §<a href="#sec:acronyms">6</a> but they use the
+same underlying mechanism as all the other <a id="wrglossary.3834"></a><a href="#glo:idx.glossaryentry">glossary entries</a>, so it’s a good
idea to read this chapter first. The keys provided for
-<a id="wrglossary.3838"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> can also be used in the optional argument of
-<a id="wrglossary.3839"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, although some of them, such as <a id="wrglossary.3840"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and
-<a id="wrglossary.3841"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>, interfere with the <a id="wrglossary.3842"></a><a href="#glo:idx.acronymstyle">acronym styles</a>.
+<a id="wrglossary.3835"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> can also be used in the optional argument of
+<a id="wrglossary.3836"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, although some of them, such as <a id="wrglossary.3837"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and
+<a id="wrglossary.3838"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>, interfere with the <a id="wrglossary.3839"></a><a href="#glo:idx.acronymstyle">acronym styles</a>.
<p>
-All <a id="wrglossary.3843"></a><a href="#glo:idx.glossaryentry">glossary entries</a> must be defined before they are used, so it is
-better to define them in the <a id="wrglossary.3844"></a><a href="#glo:idx.preamble/document">document preamble</a> to ensure this. In fact, some
-commands such as <a id="wrglossary.3845"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>
-may only be used in the <a id="wrglossary.3846"></a><a href="#glo:idx.preamble/document">preamble</a>. See §<a href="#sec:docdefs">4.8</a> for
-a discussion of the problems with defining <a id="wrglossary.3847"></a><a href="#glo:idx.glossaryentry">entries</a> within the
-document instead of in the <a id="wrglossary.3848"></a><a href="#glo:idx.preamble/document">preamble</a>. (The <a id="wrglossary.3849"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+All <a id="wrglossary.3840"></a><a href="#glo:idx.glossaryentry">glossary entries</a> must be defined before they are used, so it is
+better to define them in the <a id="wrglossary.3841"></a><a href="#glo:idx.preamble/document">document preamble</a> to ensure this. In fact, some
+commands such as <a id="wrglossary.3842"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>
+may only be used in the <a id="wrglossary.3843"></a><a href="#glo:idx.preamble/document">preamble</a>. See §<a href="#sec:docdefs">4.8</a> for
+a discussion of the problems with defining <a id="wrglossary.3844"></a><a href="#glo:idx.glossaryentry">entries</a> within the
+document instead of in the <a id="wrglossary.3845"></a><a href="#glo:idx.preamble/document">preamble</a>. (The <a id="wrglossary.3846"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
package has an option that provides a restricted form of document
definitions that avoids some of the issues discussed in
§<a href="#sec:docdefs">4.8</a>.)
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-<a id="wrglossary.3850"></a><a href="#glo:idx.opt.noidx">Option 1</a> enforces the <a id="wrglossary.3851"></a><a href="#glo:idx.preamble/document">preamble</a>-only restriction on
-<a id="wrglossary.3852"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. <a id="wrglossary.3853"></a><a href="#glo:idx.opt.b2g">Option 4</a> requires that definitions are provided
-in <a id="wrglossary.3854"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> format. Options <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a> work best with either
-<a id="wrglossary.3855"></a><a href="#glo:idx.preamble/document">preamble</a>-only
-definitions or the use of the <a id="wrglossary.3856"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package option
-<a id="wrglossary.3857"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>.
+<a id="wrglossary.3847"></a><a href="#glo:idx.opt.noidx">Option 1</a> enforces the <a id="wrglossary.3848"></a><a href="#glo:idx.preamble/document">preamble</a>-only restriction on
+<a id="wrglossary.3849"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. <a id="wrglossary.3850"></a><a href="#glo:idx.opt.b2g">Option 4</a> requires that definitions are provided
+in <a id="wrglossary.3851"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> format. Options <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a> work best with either
+<a id="wrglossary.3852"></a><a href="#glo:idx.preamble/document">preamble</a>-only
+definitions or the use of the <a id="wrglossary.3853"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package option
+<a id="wrglossary.3854"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>.
</div><!-- end of important -->
<p>
-Bear in mind that with <a id="wrglossary.3858"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>, the
-<a id="wrglossary.3859"></a><a href="#glo:idx.glossaryentry">entries</a> must be defined before any <a id="wrglossary.3860"></a><a href="#glo:idx.glossaryentry">entries</a> are used,
-including when they are displayed in the <a id="wrglossary.3861"></a><a href="#glo:dual.glossary">glossary</a> (for example, with
-<a id="wrglossary.3862"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>) or where they appear in the
-<a id="wrglossary.3863"></a><a href="#glo:idx.tableofcontents">table of contents</a> or list of floats. This is essentially the
+Bear in mind that with <a id="wrglossary.3855"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>, the
+<a id="wrglossary.3856"></a><a href="#glo:idx.glossaryentry">entries</a> must be defined before any <a id="wrglossary.3857"></a><a href="#glo:idx.glossaryentry">entries</a> are used,
+including when they are displayed in the <a id="wrglossary.3858"></a><a href="#glo:dual.glossary">glossary</a> (for example, with
+<a id="wrglossary.3859"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>) or where they appear in the
+<a id="wrglossary.3860"></a><a href="#glo:idx.tableofcontents">table of contents</a> or list of floats. This is essentially the
same problem as defining a robust command mid-document and using it
in a section title or caption.
<p>
-Only those <a id="wrglossary.3864"></a><a href="#glo:idx.glossaryentry">entries</a> that are <a id="wrglossary.3865"></a><a href="#glo:dual.indexing">indexed</a> in the document
+Only those <a id="wrglossary.3861"></a><a href="#glo:idx.glossaryentry">entries</a> that are <a id="wrglossary.3862"></a><a href="#glo:dual.indexing">indexed</a> in the document
(using any of the commands described in
§<a href="#sec:glslink">5.1</a>, §<a href="#sec:glsadd">10</a> or
-§<a href="#sec:crossref">11</a>) will appear in the <a id="wrglossary.3866"></a><a href="#glo:dual.glossary">glossary</a>. See
+§<a href="#sec:crossref">11</a>) will appear in the <a id="wrglossary.3863"></a><a href="#glo:dual.glossary">glossary</a>. See
§<a href="#sec:printglossary">8</a> to find out how to display the
-<a id="wrglossary.3867"></a><a href="#glo:dual.glossary">glossary</a>.
+<a id="wrglossary.3864"></a><a href="#glo:dual.glossary">glossary</a>.
<p>
-New <a id="wrglossary.3868"></a><a href="#glo:idx.glossaryentry">glossary entries</a> are defined using the command:
+New <a id="wrglossary.3865"></a><a href="#glo:idx.glossaryentry">glossary entries</a> are defined using the 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.3869"></a><code class="code"><dfn id="glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3866"></a><code class="code"><dfn id="glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}</code></div><!-- end of pinnedbox -->
This is a short command, so values in <span class="meta">〈<em class="metainner">key=value list</em>〉</span> can’t
contain any paragraph breaks. Take care to enclose values containing
-any commas (<a id="wrglossary.3870"></a><a href="#glo:idx.sym.comma"><code class="code">,</code></a>) or equal signs (<a id="wrglossary.3871"></a><a href="#glo:idx.sym.equals"><code class="code">=</code></a>) with braces to hide them
+any commas (<a id="wrglossary.3867"></a><a href="#glo:idx.sym.comma"><code class="code">,</code></a>) or equal signs (<a id="wrglossary.3868"></a><a href="#glo:idx.sym.equals"><code class="code">=</code></a>) with braces to hide them
from the <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> list parser.
<p>
If you have a long description that
needs to span multiple paragraphs, use the following instead:
<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.3872"></a><code class="code"><dfn id="glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3869"></a><code class="code"><dfn id="glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code></div><!-- end of pinnedbox -->
Note that this command may only be used in the
-<a id="wrglossary.3873"></a><a href="#glo:idx.preamble/document">preamble</a> (regardless of <a id="wrglossary.3874"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>).
+<a id="wrglossary.3870"></a><a href="#glo:idx.preamble/document">preamble</a> (regardless of <a id="wrglossary.3871"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a>).
<p>
<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
Be careful of unwanted spaces.
@@ -12297,39 +12301,39 @@
</div><!-- end of warning -->
<p>
-<a id="wrglossary.3875"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> will remove trailing spaces in the
-description (via <a id="wrglossary.3876"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a>) but won’t remove leading spaces. This
-command also appends <a id="wrglossary.3877"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> to the end of the description,
+<a id="wrglossary.3872"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> will remove trailing spaces in the
+description (via <a id="wrglossary.3873"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a>) but won’t remove leading spaces. This
+command also appends <a id="wrglossary.3874"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> to the end of the description,
which suppresses the post-description hook (since the terminating
punctuation is more likely to be included in a multi-paragraph
-description). The <a id="wrglossary.3878"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a starred
-version of <a id="wrglossary.3879"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> that doesn’t append either
-<a id="wrglossary.3880"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a> or <a id="wrglossary.3881"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>.
+description). The <a id="wrglossary.3875"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a starred
+version of <a id="wrglossary.3876"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> that doesn’t append either
+<a id="wrglossary.3877"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a> or <a id="wrglossary.3878"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>.
<p>
-There are also commands that will only define the <a id="wrglossary.3882"></a><a href="#glo:idx.glossaryentry">entry</a> if it
+There are also commands that will only define the <a id="wrglossary.3879"></a><a href="#glo:idx.glossaryentry">entry</a> if it
hasn’t already been defined:
<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.3883"></a><code class="code"><dfn id="glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3880"></a><code class="code"><dfn id="glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}</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.3884"></a><code class="code"><dfn id="glo:longprovideglossaryentry"><code class="csfmt">\longprovideglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3881"></a><code class="code"><dfn id="glo:longprovideglossaryentry"><code class="csfmt">\longprovideglossaryentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">key=value list</em>〉</span>}{<span class="meta">〈<em class="metainner">description</em>〉</span>}</code></div><!-- end of pinnedbox -->
-(These are both <a id="wrglossary.3885"></a><a href="#glo:idx.preamble/document">preamble</a>-only commands.)
+(These are both <a id="wrglossary.3882"></a><a href="#glo:idx.preamble/document">preamble</a>-only commands.)
<p>
For all the above commands, the first argument, <span class="meta">〈<em class="metainner">entry-label</em>〉</span>, must be
-a unique label with which to identify this <a id="wrglossary.3886"></a><a href="#glo:idx.glossaryentry">entry</a>. <strong class="strong">This can’t contain
+a unique label with which to identify this <a id="wrglossary.3883"></a><a href="#glo:idx.glossaryentry">entry</a>. <strong class="strong">This can’t contain
any non-expandable or fragile commands.</strong> The reason for
this restriction is that the label is used to construct internal commands
that store the associated information (similarly to commands
-like <a id="wrglossary.3887"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) and therefore must be able to expand to a valid
+like <a id="wrglossary.3884"></a><a href="#glo:label"><code class="csfmt">\label</code></a>) and therefore must be able to expand to a valid
control sequence name. With modern LaTeX kernels, you should now
-be able to use <a id="wrglossary.3888"></a><a href="#glo:dual.utf8">UTF-8</a> characters in the label.
+be able to use <a id="wrglossary.3885"></a><a href="#glo:dual.utf8">UTF-8</a> characters in the label.
<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.3889"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> options that change certain
-punctuation characters, such as colon (<a id="wrglossary.3890"></a><a href="#glo:idx.sym.colon"><code class="code">:</code></a>) or double-quote
-(<a id="wrglossary.3891"></a><a href="#glo:idx.sym.dblquote"><code class="code">"</code></a>), to active characters.
+Be careful of <a id="wrglossary.3886"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> options that change certain
+punctuation characters, such as colon (<a id="wrglossary.3887"></a><a href="#glo:idx.sym.colon"><code class="code">:</code></a>) or double-quote
+(<a id="wrglossary.3888"></a><a href="#glo:idx.sym.dblquote"><code class="code">"</code></a>), to active characters.
</div><!-- end of important -->
<p>
@@ -12336,511 +12340,511 @@
The second argument, <span class="meta">〈<em class="metainner">key=value list</em>〉</span>, is
a <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> list that supplies the relevant
information about this entry. There are two required fields:
-<a id="wrglossary.3892"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> and either <a id="wrglossary.3893"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> or <a id="wrglossary.3894"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a>.
+<a id="wrglossary.3889"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> and either <a id="wrglossary.3890"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> or <a id="wrglossary.3891"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a>.
The description is set in the third argument of
-<a id="wrglossary.3895"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> and <a id="wrglossary.3896"></a><a href="#glo:longprovideglossaryentry"><code class="csfmt">\longprovideglossaryentry</code></a>. With
-the other commands it’s set via the <a id="wrglossary.3897"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key.
+<a id="wrglossary.3892"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> and <a id="wrglossary.3893"></a><a href="#glo:longprovideglossaryentry"><code class="csfmt">\longprovideglossaryentry</code></a>. With
+the other commands it’s set via the <a id="wrglossary.3894"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key.
<p>
As is typical with <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> lists, values that contain
-a comma (<a id="wrglossary.3898"></a><a href="#glo:idx.sym.comma"><code class="code">,</code></a>) or equal sign (<a id="wrglossary.3899"></a><a href="#glo:idx.sym.equals"><code class="code">=</code></a>) must be
+a comma (<a id="wrglossary.3895"></a><a href="#glo:idx.sym.comma"><code class="code">,</code></a>) or equal sign (<a id="wrglossary.3896"></a><a href="#glo:idx.sym.equals"><code class="code">=</code></a>) must be
enclosed in braces. Available fields
are listed below. Additional fields are provided by the
-supplementary packages <a id="wrglossary.3900"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>
-(§<a href="#sec:prefix">16</a>) and <a id="wrglossary.3901"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>
-(§<a href="#sec:accsupp">17</a>) and also by <a id="wrglossary.3902"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+supplementary packages <a id="wrglossary.3897"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a>
+(§<a href="#sec:prefix">16</a>) and <a id="wrglossary.3898"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a>
+(§<a href="#sec:accsupp">17</a>) and also by <a id="wrglossary.3899"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
You can also define your own custom keys (see
§<a href="#sec:addkey">4.3</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.3903"></a><code class="code"><dfn id="glo:opt.gloskey.name"><span class="csoptfmt">name</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3900"></a><code class="code"><dfn id="glo:opt.gloskey.name"><span class="csoptfmt">name</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
-The name of the <a id="wrglossary.3904"></a><a href="#glo:idx.glossaryentry">entry</a> (as it will appear in
-the <a id="wrglossary.3905"></a><a href="#glo:dual.glossary">glossary</a>). If this key is omitted and the <a id="wrglossary.3906"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a>
+The name of the <a id="wrglossary.3901"></a><a href="#glo:idx.glossaryentry">entry</a> (as it will appear in
+the <a id="wrglossary.3902"></a><a href="#glo:dual.glossary">glossary</a>). If this key is omitted and the <a id="wrglossary.3903"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a>
key is supplied, this value will be the same as the parent’s name.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-If the <a id="wrglossary.3907"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key contains any commands, you must also
-use the <a id="wrglossary.3908"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key (described below) if you intend sorting
-the <a id="wrglossary.3909"></a><a href="#glo:idx.glossaryentry">entries</a> alphabetically with Options <a href="#glo:idx.opt.noidx">1</a>, <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>,
+If the <a id="wrglossary.3904"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key contains any commands, you must also
+use the <a id="wrglossary.3905"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key (described below) if you intend sorting
+the <a id="wrglossary.3906"></a><a href="#glo:idx.glossaryentry">entries</a> alphabetically with Options <a href="#glo:idx.opt.noidx">1</a>, <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>,
otherwise the entries can’t be sorted correctly.
</div><!-- end of important -->
<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.3910"></a><code class="code"><dfn id="glo:opt.gloskey.description"><span class="csoptfmt">description</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3907"></a><code class="code"><dfn id="glo:opt.gloskey.description"><span class="csoptfmt">description</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
-A brief description of this term (to appear in the <a id="wrglossary.3911"></a><a href="#glo:dual.glossary">glossary</a>).
+A brief description of this term (to appear in the <a id="wrglossary.3908"></a><a href="#glo:dual.glossary">glossary</a>).
Within this value, you can 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.3912"></a><code class="code"><dfn id="glo:nopostdesc"><code class="csfmt">\nopostdesc</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3909"></a><code class="code"><dfn id="glo:nopostdesc"><code class="csfmt">\nopostdesc</code></dfn></code></div><!-- end of pinnedbox -->
to suppress the description terminator for this entry. For example, if this
entry is a parent entry that doesn’t require a description, you
-can do <a id="wrglossary.3913"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.3914"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>. If you want a paragraph
+can do <a id="wrglossary.3910"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.3911"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>. If you want a paragraph
break in the description 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.3915"></a><code class="code"><dfn id="glo:glspar"><code class="csfmt">\glspar</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3912"></a><code class="code"><dfn id="glo:glspar"><code class="csfmt">\glspar</code></dfn></code></div><!-- end of pinnedbox -->
-or, better, use <a id="wrglossary.3916"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>.
-However, note that not all <a id="wrglossary.3917"></a><a href="#glo:idx.glossarystyle">glossary styles</a> support multi-line
+or, better, use <a id="wrglossary.3913"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>.
+However, note that not all <a id="wrglossary.3914"></a><a href="#glo:idx.glossarystyle">glossary styles</a> support multi-line
descriptions. If you are using one of the tabular-like
-<a id="wrglossary.3918"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that permit multi-line descriptions and you
-really need an explicit line break, use <a id="wrglossary.3919"></a><a href="#glo:newline"><code class="csfmt">\newline</code></a> not <a id="wrglossary.3920"></a><a href="#glo:cs.bsl"><code class="csfmt">\\</code></a>
-(but in general, avoid <a id="wrglossary.3921"></a><a href="#glo:cs.bsl"><code class="csfmt">\\</code></a> outside of tabular contexts anyway
-and use a ragged <a id="wrglossary.3922"></a><a href="#glo:dual.glossary">style</a> if you are having problems
+<a id="wrglossary.3915"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that permit multi-line descriptions and you
+really need an explicit line break, use <a id="wrglossary.3916"></a><a href="#glo:newline"><code class="csfmt">\newline</code></a> not <a id="wrglossary.3917"></a><a href="#glo:cs.bsl"><code class="csfmt">\\</code></a>
+(but in general, avoid <a id="wrglossary.3918"></a><a href="#glo:cs.bsl"><code class="csfmt">\\</code></a> outside of tabular contexts anyway
+and use a ragged <a id="wrglossary.3919"></a><a href="#glo:dual.glossary">style</a> if you are having problems
with line breaks in a narrow column).
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.3923"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3920"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-With <a id="wrglossary.3924"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, use <a id="wrglossary.3925"></a><a href="#glo:glsxtrnopostpunc"><code class="xtrcsfmt">\glsxtrnopostpunc</code></a> instead of
-<a id="wrglossary.3926"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> to suppress the post-description punctuation.
+With <a id="wrglossary.3921"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, use <a id="wrglossary.3922"></a><a href="#glo:glsxtrnopostpunc"><code class="xtrcsfmt">\glsxtrnopostpunc</code></a> instead of
+<a id="wrglossary.3923"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a> to suppress the post-description punctuation.
</div><!-- end of information -->
<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.3927"></a><code class="code"><dfn id="glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></dfn>=<span class="meta">〈<em class="metainner">parent-label</em>〉</span></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3924"></a><code class="code"><dfn id="glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></dfn>=<span class="meta">〈<em class="metainner">parent-label</em>〉</span></code></div><!-- end of settingsbox -->
-This key establishes the <a id="wrglossary.3928"></a><a href="#glo:idx.glossaryentry">entry’s</a> <a id="wrglossary.3929"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>.
-The value must be the <span style="font-style: italic; font-variant: normal; ">label</span> of the parent <a id="wrglossary.3930"></a><a href="#glo:idx.glossaryentry">entry</a>
-(not the <a id="wrglossary.3931"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, although they may be the same).
+This key establishes the <a id="wrglossary.3925"></a><a href="#glo:idx.glossaryentry">entry’s</a> <a id="wrglossary.3926"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a>.
+The value must be the <span style="font-style: italic; font-variant: normal; ">label</span> of the parent <a id="wrglossary.3927"></a><a href="#glo:idx.glossaryentry">entry</a>
+(not the <a id="wrglossary.3928"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, although they may be the same).
The <span class="meta">〈<em class="metainner">parent-label</em>〉</span> value must match the
-<span class="meta">〈<em class="metainner">entry-label</em>〉</span> used when the parent <a id="wrglossary.3932"></a><a href="#glo:idx.glossaryentry">entry</a> was defined.
+<span class="meta">〈<em class="metainner">entry-label</em>〉</span> used when the parent <a id="wrglossary.3929"></a><a href="#glo:idx.glossaryentry">entry</a> was defined.
See §<a href="#sec:subentries">4.5</a> 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 parent <a id="wrglossary.3933"></a><a href="#glo:idx.glossaryentry">entry</a> must be defined before it’s referenced in
-the <a id="wrglossary.3934"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key of another <a id="wrglossary.3935"></a><a href="#glo:idx.glossaryentry">entry</a>.
+The parent <a id="wrglossary.3930"></a><a href="#glo:idx.glossaryentry">entry</a> must be defined before it’s referenced in
+the <a id="wrglossary.3931"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key of another <a id="wrglossary.3932"></a><a href="#glo:idx.glossaryentry">entry</a>.
</div><!-- end of important -->
<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.3936"></a><code class="code"><dfn id="glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3933"></a><code class="code"><dfn id="glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
The plural form of the description, if required. If omitted, the
-value is set to the same as the <a id="wrglossary.3937"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key.
+value is set to the same as the <a id="wrglossary.3934"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key.
<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.3938"></a><code class="code"><dfn id="glo:opt.gloskey.text"><span class="csoptfmt">text</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3935"></a><code class="code"><dfn id="glo:opt.gloskey.text"><span class="csoptfmt">text</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
How this entry will appear in the document text
-when using <a id="wrglossary.3939"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> on <a id="wrglossary.3940"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. If this
-field is omitted, the value of the <a id="wrglossary.3941"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key is used.
+when using <a id="wrglossary.3936"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> on <a id="wrglossary.3937"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. If this
+field is omitted, the value of the <a id="wrglossary.3938"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key is used.
<p>
-This key is automatically set by <a id="wrglossary.3942"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>. Although it is
-possible to override it by using <a id="wrglossary.3943"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> in the optional
-argument of <a id="wrglossary.3944"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it will interfere with the
-<a id="wrglossary.3945"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results.
+This key is automatically set by <a id="wrglossary.3939"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>. Although it is
+possible to override it by using <a id="wrglossary.3940"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> in the optional
+argument of <a id="wrglossary.3941"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it will interfere with the
+<a id="wrglossary.3942"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results.
<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.3946"></a><code class="code"><dfn id="glo:opt.gloskey.first"><span class="csoptfmt">first</span></dfn>={<span class="meta">〈<em class="metainner">first</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3943"></a><code class="code"><dfn id="glo:opt.gloskey.first"><span class="csoptfmt">first</span></dfn>={<span class="meta">〈<em class="metainner">first</em>〉</span>}</code></div><!-- end of settingsbox -->
-How the <a id="wrglossary.3947"></a><a href="#glo:idx.glossaryentry">entry</a> will appear in the document text on <a id="wrglossary.3948"></a><a href="#glo:dual.firstuse">first use</a>
-with <a id="wrglossary.3949"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. If this field is omitted, the value of the
-<a id="wrglossary.3950"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> key is used. Note that if you use <a id="wrglossary.3951"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>,
-<a id="wrglossary.3952"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>, <a id="wrglossary.3953"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>, <a id="wrglossary.3954"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> before using <a id="wrglossary.3955"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, the
-<a id="wrglossary.3956"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> value won’t be used with <a id="wrglossary.3957"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.
+How the <a id="wrglossary.3944"></a><a href="#glo:idx.glossaryentry">entry</a> will appear in the document text on <a id="wrglossary.3945"></a><a href="#glo:dual.firstuse">first use</a>
+with <a id="wrglossary.3946"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. If this field is omitted, the value of the
+<a id="wrglossary.3947"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> key is used. Note that if you use <a id="wrglossary.3948"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>,
+<a id="wrglossary.3949"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>, <a id="wrglossary.3950"></a><a href="#glo:GLSpl"><code class="csfmt">\GLSpl</code></a>, <a id="wrglossary.3951"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> before using <a id="wrglossary.3952"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, the
+<a id="wrglossary.3953"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> value won’t be used with <a id="wrglossary.3954"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.
<p>
-You may prefer to use <a id="wrglossary.3958"></a><a href="#glo:idx.acronym">acronyms</a> (§<a href="#sec:acronyms">6</a>) or the
-<a id="wrglossary.3959"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> or the category post-link hook (<a id="wrglossary.3960"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>) provided by
-<a id="wrglossary.3961"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> if you would like to automatically append
-content on <a id="wrglossary.3962"></a><a href="#glo:dual.firstuse">first use</a> in a consistent manner. See, for example,
+You may prefer to use <a id="wrglossary.3955"></a><a href="#glo:idx.acronym">acronyms</a> (§<a href="#sec:acronyms">6</a>) or the
+<a id="wrglossary.3956"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> or the category post-link hook (<a id="wrglossary.3957"></a><a href="#glo:glsdefpostlink"><code class="csfmt">\glsdefpostlink</code></a>) provided by
+<a id="wrglossary.3958"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> if you would like to automatically append
+content on <a id="wrglossary.3959"></a><a href="#glo:dual.firstuse">first use</a> in a consistent manner. See, for example,
<a href="https://www.dickimaw-books.com/gallery/index.php?label=sample-units">Gallery: Units (<span class="styfmt">glossaries-extra.sty</span>)</a>.
<p>
-Although it is possible to use <a id="wrglossary.3963"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> in the optional
-argument of <a id="wrglossary.3964"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it can interfere with the
-<a id="wrglossary.3965"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results.
+Although it is possible to use <a id="wrglossary.3960"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> in the optional
+argument of <a id="wrglossary.3961"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it can interfere with the
+<a id="wrglossary.3962"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results.
<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.3966"></a><code class="code"><dfn id="glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3963"></a><code class="code"><dfn id="glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
How the entry will appear in the document text
-when using <a id="wrglossary.3967"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> on <a id="wrglossary.3968"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. If this
+when using <a id="wrglossary.3964"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> on <a id="wrglossary.3965"></a><a href="#glo:dual.subsequentuse">subsequent use</a>. If this
field is omitted, the value is obtained by appending
-<a id="wrglossary.3969"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> to the value of the <a id="wrglossary.3970"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field.
+<a id="wrglossary.3966"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> to the value of the <a id="wrglossary.3967"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field.
<p>
-Although it is possible to use <a id="wrglossary.3971"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> in the optional
-argument of <a id="wrglossary.3972"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it can interfere with the
-<a id="wrglossary.3973"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results. Use <a id="wrglossary.3974"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a>
+Although it is possible to use <a id="wrglossary.3968"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> in the optional
+argument of <a id="wrglossary.3969"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it can interfere with the
+<a id="wrglossary.3970"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results. Use <a id="wrglossary.3971"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a>
instead, if the default value is inappropriate.
<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.3975"></a><code class="code"><dfn id="glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.3972"></a><code class="code"><dfn id="glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
-How the <a id="wrglossary.3976"></a><a href="#glo:idx.glossaryentry">entry</a> will appear in the
-document text on <a id="wrglossary.3977"></a><a href="#glo:dual.firstuse">first use</a> with <a id="wrglossary.3978"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.
+How the <a id="wrglossary.3973"></a><a href="#glo:idx.glossaryentry">entry</a> will appear in the
+document text on <a id="wrglossary.3974"></a><a href="#glo:dual.firstuse">first use</a> with <a id="wrglossary.3975"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.
If this field is omitted, the value is obtained
-from the <a id="wrglossary.3979"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key, if the <a id="wrglossary.3980"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key is omitted,
-or by appending <a id="wrglossary.3981"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> to the value of the
-<a id="wrglossary.3982"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field, if the <a id="wrglossary.3983"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field is present. Note
-that if you use <a id="wrglossary.3984"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, <a id="wrglossary.3985"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>, <a id="wrglossary.3986"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>, <a id="wrglossary.3987"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> before
-using <a id="wrglossary.3988"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>, the <a id="wrglossary.3989"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> value won’t be used
-with <a id="wrglossary.3990"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.
+from the <a id="wrglossary.3976"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key, if the <a id="wrglossary.3977"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key is omitted,
+or by appending <a id="wrglossary.3978"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> to the value of the
+<a id="wrglossary.3979"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field, if the <a id="wrglossary.3980"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> field is present. Note
+that if you use <a id="wrglossary.3981"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>, <a id="wrglossary.3982"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>, <a id="wrglossary.3983"></a><a href="#glo:GLS"><code class="csfmt">\GLS</code></a>, <a id="wrglossary.3984"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> before
+using <a id="wrglossary.3985"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>, the <a id="wrglossary.3986"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> value won’t be used
+with <a id="wrglossary.3987"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>.
<p>
-Although it is possible to use <a id="wrglossary.3991"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> in the optional
-argument of <a id="wrglossary.3992"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it can interfere with the
-<a id="wrglossary.3993"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results. Use <a id="wrglossary.3994"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a>
-and <a id="wrglossary.3995"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> instead, if the default value is inappropriate.
+Although it is possible to use <a id="wrglossary.3988"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> in the optional
+argument of <a id="wrglossary.3989"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, it can interfere with the
+<a id="wrglossary.3990"></a><a href="#glo:idx.acronymstyle">acronym style</a> and cause unexpected results. Use <a id="wrglossary.3991"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a>
+and <a id="wrglossary.3992"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> instead, if the default value is inappropriate.
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
Prior to version 1.13, the default value of
-<a id="wrglossary.3996"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> was always taken by appending <span class="qt">“s”</span> to the
-<a id="wrglossary.3997"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key, which meant that you had to specify both
-<a id="wrglossary.3998"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> and <a id="wrglossary.3999"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, even if you hadn’t
-used the <a id="wrglossary.4000"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key.
+<a id="wrglossary.3993"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a> was always taken by appending <span class="qt">“s”</span> to the
+<a id="wrglossary.3994"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key, which meant that you had to specify both
+<a id="wrglossary.3995"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> and <a id="wrglossary.3996"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>, even if you hadn’t
+used the <a id="wrglossary.3997"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> key.
</div><!-- end of information -->
<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.4001"></a><code class="code"><dfn id="glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></dfn>={<span class="meta">〈<em class="metainner">symbol</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span><a id="wrglossary.4002"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.3998"></a><code class="code"><dfn id="glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></dfn>={<span class="meta">〈<em class="metainner">symbol</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">initial: </span><a id="wrglossary.3999"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
This field is provided to allow the user
to specify an associated symbol. If omitted, the value is set to
-<a id="wrglossary.4003"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>. Note that not all <a id="wrglossary.4004"></a><a href="#glo:idx.glossarystyle">glossary styles</a> display the symbol.
+<a id="wrglossary.4000"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a>. Note that not all <a id="wrglossary.4001"></a><a href="#glo:idx.glossarystyle">glossary styles</a> display the symbol.
<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.4005"></a><code class="code"><dfn id="glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></dfn>={<span class="meta">〈<em class="metainner">symbol plural</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4002"></a><code class="code"><dfn id="glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></dfn>={<span class="meta">〈<em class="metainner">symbol plural</em>〉</span>}</code></div><!-- end of settingsbox -->
This is the plural form of the symbol. If omitted, the value
-is set to the same as the <a id="wrglossary.4006"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key.
+is set to the same as the <a id="wrglossary.4003"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key.
<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.4007"></a><code class="code"><dfn id="glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="meta">〈<em class="metainner">entry name</em>〉</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.4004"></a><code class="code"><dfn id="glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></dfn>=<span class="meta">〈<em class="metainner">value</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><span class="meta">〈<em class="metainner">entry name</em>〉</span></span><span class="clearfix"></span></div><!-- end of settingsbox -->
This value indicates the text to be used by the sort comparator when
-ordering all the <a id="wrglossary.4008"></a><a href="#glo:idx.glossaryentry">glossary entries</a>. If omitted, the value is given by the
-<a id="wrglossary.4009"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field unless one of the package options
-<a id="wrglossary.4010"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.4011"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> and <a id="wrglossary.4012"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.4013"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> have been
-used. With <a id="wrglossary.4014"></a><a href="#glo:idx.opt.mkidx">Option 2</a> it’s best to use the <a id="wrglossary.4015"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key
-if the <a id="wrglossary.4016"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> contains commands (for example,
-<code class="code"><a id="wrglossary.4017"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<span class="cmdfmt">\alpha</span>}</code>) and with
-Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, it’s strongly recommended as the <a id="wrglossary.4018"></a><a href="#glo:dual.indexing">indexing</a>
+ordering all the <a id="wrglossary.4005"></a><a href="#glo:idx.glossaryentry">glossary entries</a>. If omitted, the value is given by the
+<a id="wrglossary.4006"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field unless one of the package options
+<a id="wrglossary.4007"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.4008"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> and <a id="wrglossary.4009"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.4010"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> have been
+used. With <a id="wrglossary.4011"></a><a href="#glo:idx.opt.mkidx">Option 2</a> it’s best to use the <a id="wrglossary.4012"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key
+if the <a id="wrglossary.4013"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> contains commands (for example,
+<code class="code"><a id="wrglossary.4014"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<span class="cmdfmt">\alpha</span>}</code>) and with
+Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, it’s strongly recommended as the <a id="wrglossary.4015"></a><a href="#glo:dual.indexing">indexing</a>
may fail if you don’t (see below).
<p>
-You can also override the <a id="wrglossary.4019"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key by redefining
-<a id="wrglossary.4020"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> (see §<a href="#sec:pkgopts-sort">2.5</a>).
+You can also override the <a id="wrglossary.4016"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key by redefining
+<a id="wrglossary.4017"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> (see §<a href="#sec:pkgopts-sort">2.5</a>).
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.4021"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.4018"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.4022"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key shouldn’t be used with <a id="wrglossary.4023"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. It has
-a system of fallbacks that allow different types of <a id="wrglossary.4024"></a><a href="#glo:idx.glossaryentry">entries</a> to
+The <a id="wrglossary.4019"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key shouldn’t be used with <a id="wrglossary.4020"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. It has
+a system of fallbacks that allow different types of <a id="wrglossary.4021"></a><a href="#glo:idx.glossaryentry">entries</a> to
obtain the sort value from the most relevant field. See the
-<a id="wrglossary.4025"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details, and see also
+<a id="wrglossary.4022"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details, and see also
<a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a>.
</div><!-- end of information -->
<p>
-<a id="wrglossary.4026"></a><a href="#glo:idx.opt.noidx">Option 1</a> by default strips the <a id="wrglossary.4027"></a><a href="#glo:latexexlatinchar">standard
+<a id="wrglossary.4023"></a><a href="#glo:idx.opt.noidx">Option 1</a> by default strips the <a id="wrglossary.4024"></a><a href="#glo:latexexlatinchar">standard
LaTeX accents</a> (that is, accents generated by core LaTeX commands) from the
-<a id="wrglossary.4028"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key when it sets the <a id="wrglossary.4029"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. So with
-<a id="wrglossary.4030"></a><a href="#glo:idx.opt.noidx">Option 1</a>:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4031"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{
- <a id="wrglossary.4032"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4033"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite}</span>,
- <a id="wrglossary.4034"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group of people}</span>
+<a id="wrglossary.4025"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key when it sets the <a id="wrglossary.4026"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. So with
+<a id="wrglossary.4027"></a><a href="#glo:idx.opt.noidx">Option 1</a>:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4028"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{
+ <a id="wrglossary.4029"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4030"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite}</span>,
+ <a id="wrglossary.4031"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group of people}</span>
}
</pre>
This is equivalent to:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4035"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{
- <a id="wrglossary.4036"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4037"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite}</span>,
- <a id="wrglossary.4038"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group of people}</span>
- <a id="wrglossary.4039"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={elite}</span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4032"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{
+ <a id="wrglossary.4033"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4034"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite}</span>,
+ <a id="wrglossary.4035"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group of people}</span>
+ <a id="wrglossary.4036"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={elite}</span>
}
</pre>
-Unless you use the package option <a id="wrglossary.4040"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>, in
+Unless you use the package option <a id="wrglossary.4037"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>, in
which case it’s equivalent to:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4041"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{
- <a id="wrglossary.4042"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4043"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite}</span>,
- <a id="wrglossary.4044"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group of people}</span>
- <a id="wrglossary.4045"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<a id="wrglossary.4046"></a><a href="#glo:idx.sym.bksl"><code class="code">\</code></a><a id="wrglossary.4047"></a><a href="#glo:idx.sym.apos"><code class="code">'</code></a>elite}</span>,
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4038"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{
+ <a id="wrglossary.4039"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4040"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>elite}</span>,
+ <a id="wrglossary.4041"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group of people}</span>
+ <a id="wrglossary.4042"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<a id="wrglossary.4043"></a><a href="#glo:idx.sym.bksl"><code class="code">\</code></a><a id="wrglossary.4044"></a><a href="#glo:idx.sym.apos"><code class="code">'</code></a>elite}</span>,
}
</pre>
-This will place the <a id="wrglossary.4048"></a><a href="#glo:idx.glossaryentry">entry</a> before the <span class="qt">“A”</span> <a id="wrglossary.4049"></a><a href="#glo:idx.group">letter group</a> since the
-sort value starts with a symbol (a literal backslash <a id="wrglossary.4050"></a><a href="#glo:idx.sym.bksl"><code class="code">\</code></a>).
-Note that <a id="wrglossary.4051"></a><a href="#glo:idx.opt.noidx">Option 1</a> shouldn’t be used with <a id="wrglossary.4052"></a><a href="#glo:dual.utf8">UTF-8</a>
+This will place the <a id="wrglossary.4045"></a><a href="#glo:idx.glossaryentry">entry</a> before the <span class="qt">“A”</span> <a id="wrglossary.4046"></a><a href="#glo:idx.group">letter group</a> since the
+sort value starts with a symbol (a literal backslash <a id="wrglossary.4047"></a><a href="#glo:idx.sym.bksl"><code class="code">\</code></a>).
+Note that <a id="wrglossary.4048"></a><a href="#glo:idx.opt.noidx">Option 1</a> shouldn’t be used with <a id="wrglossary.4049"></a><a href="#glo:dual.utf8">UTF-8</a>
characters. With old LaTeX kernels, it was able to convert a
-<a id="wrglossary.4053"></a><a href="#glo:dual.utf8">UTF-8</a> character, such as <code class="code">é</code>, to an <a id="wrglossary.4054"></a><a href="#glo:dual.ascii">ASCII</a>
+<a id="wrglossary.4050"></a><a href="#glo:dual.utf8">UTF-8</a> character, such as <code class="code">é</code>, to an <a id="wrglossary.4051"></a><a href="#glo:dual.ascii">ASCII</a>
equivalent but this is no longer possible.
<p>
-With Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, the default value of <a id="wrglossary.4055"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> will either be
-set to the <a id="wrglossary.4056"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key (if <a id="wrglossary.4057"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>) or it
-will set it to the expansion of the <a id="wrglossary.4058"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key (if
-<a id="wrglossary.4059"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</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>, the default value of <a id="wrglossary.4052"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> will either be
+set to the <a id="wrglossary.4053"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key (if <a id="wrglossary.4054"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>) or it
+will set it to the expansion of the <a id="wrglossary.4055"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key (if
+<a id="wrglossary.4056"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=false</span>).
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Take care with <a id="wrglossary.4060"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.4061"></a><a href="#glo:idx.opt.xdy">Option 3</a>): if you have <a id="wrglossary.4062"></a><a href="#glo:idx.glossaryentry">entries</a> with the same
-<a id="wrglossary.4063"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> value they will be treated as the
-same entry. If you use <a id="wrglossary.4064"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and aren’t using the
-<a id="wrglossary.4065"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>
-or <a id="wrglossary.4066"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> sort methods, <strong class="strong">always</strong> use the <a id="wrglossary.4067"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
+Take care with <a id="wrglossary.4057"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.4058"></a><a href="#glo:idx.opt.xdy">Option 3</a>): if you have <a id="wrglossary.4059"></a><a href="#glo:idx.glossaryentry">entries</a> with the same
+<a id="wrglossary.4060"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> value they will be treated as the
+same entry. If you use <a id="wrglossary.4061"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and aren’t using the
+<a id="wrglossary.4062"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>
+or <a id="wrglossary.4063"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> sort methods, <strong class="strong">always</strong> use the <a id="wrglossary.4064"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
key for entries where the name just consists of commands
-(for example <a id="wrglossary.4068"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="csfmt">\alpha</code>}</span>).
+(for example <a id="wrglossary.4065"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="csfmt">\alpha</code>}</span>).
<p>
-Take care if you use <a id="wrglossary.4069"></a><a href="#glo:idx.opt.noidx">Option 1</a> and the <a id="wrglossary.4070"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> contains fragile
-commands. You will either need to explicitly set the <a id="wrglossary.4071"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
-key or use the <a id="wrglossary.4072"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> package option (unless
-you use the <a id="wrglossary.4073"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.4074"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> sort methods).
+Take care if you use <a id="wrglossary.4066"></a><a href="#glo:idx.opt.noidx">Option 1</a> and the <a id="wrglossary.4067"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> contains fragile
+commands. You will either need to explicitly set the <a id="wrglossary.4068"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
+key or use the <a id="wrglossary.4069"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> package option (unless
+you use the <a id="wrglossary.4070"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.4071"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> sort methods).
</div><!-- end of important -->
<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.4075"></a><code class="code"><dfn id="glo:opt.gloskey.type"><span class="csoptfmt">type</span></dfn>=<span class="meta">〈<em class="metainner"><a id="wrglossary.4076"></a><a href="#glo:dual.glossary">glossary</a>-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><a id="wrglossary.4077"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.4072"></a><code class="code"><dfn id="glo:opt.gloskey.type"><span class="csoptfmt">type</span></dfn>=<span class="meta">〈<em class="metainner"><a id="wrglossary.4073"></a><a href="#glo:dual.glossary">glossary</a>-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span><a id="wrglossary.4074"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a></span><span class="clearfix"></span></div><!-- end of settingsbox -->
-This specifies the label of the <a id="wrglossary.4078"></a><a href="#glo:dual.glossary">glossary</a> in which this entry
-belongs. If omitted, the default <a id="wrglossary.4079"></a><a href="#glo:dual.glossary">glossary</a> identified by
-<a id="wrglossary.4080"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed unless <a id="wrglossary.4081"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is used (see
+This specifies the label of the <a id="wrglossary.4075"></a><a href="#glo:dual.glossary">glossary</a> in which this entry
+belongs. If omitted, the default <a id="wrglossary.4076"></a><a href="#glo:dual.glossary">glossary</a> identified by
+<a id="wrglossary.4077"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> is assumed unless <a id="wrglossary.4078"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is used (see
§<a href="#sec:acronyms">6</a>).
<p>
Six keys are provided for any additional information the user may want
to specify. (For example, an associated dimension or an alternative
plural or some other grammatical construct.) Alternatively, you can
-add new keys using <a id="wrglossary.4082"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> or <a id="wrglossary.4083"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>
+add new keys using <a id="wrglossary.4079"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> or <a id="wrglossary.4080"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>
(see §<a href="#sec:addkey">4.3</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.4084"></a><code class="code"><dfn id="glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4081"></a><code class="code"><dfn id="glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
The first user key.
<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.4085"></a><code class="code"><dfn id="glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4082"></a><code class="code"><dfn id="glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
The second user key.
<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.4086"></a><code class="code"><dfn id="glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4083"></a><code class="code"><dfn id="glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
The third user key.
<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.4087"></a><code class="code"><dfn id="glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4084"></a><code class="code"><dfn id="glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
The fourth user key.
<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.4088"></a><code class="code"><dfn id="glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4085"></a><code class="code"><dfn id="glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
The fifth user key.
<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.4089"></a><code class="code"><dfn id="glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4086"></a><code class="code"><dfn id="glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></dfn>={<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of settingsbox -->
The sixth user key.
<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.4090"></a><code class="code"><dfn id="glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</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 -->
+<a id="wrglossary.4087"></a><code class="code"><dfn id="glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</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 the value is missing or is <span class="optfmt">true</span>, this will suppress
-the <a id="wrglossary.4091"></a><a href="#glo:locationlist">number list</a> just for
-this <a id="wrglossary.4092"></a><a href="#glo:idx.glossaryentry">entry</a>. Conversely, if you have used the package option
-<a id="wrglossary.4093"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a><span class="optfmt">=true</span>, you can activate the <a id="wrglossary.4094"></a><a href="#glo:locationlist">number list</a> just
-for this entry with <a id="wrglossary.4095"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={false}</span>.
+the <a id="wrglossary.4088"></a><a href="#glo:locationlist">number list</a> just for
+this <a id="wrglossary.4089"></a><a href="#glo:idx.glossaryentry">entry</a>. Conversely, if you have used the package option
+<a id="wrglossary.4090"></a><a href="#glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></a><span class="optfmt">=true</span>, you can activate the <a id="wrglossary.4091"></a><a href="#glo:locationlist">number list</a> just
+for this entry with <a id="wrglossary.4092"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={false}</span>.
(See §<a href="#sec:numberlists">12</a>.)
<p>
-This key works by adding <a id="wrglossary.4096"></a><a href="#glo:glsnonextpages"><code class="csfmt">\glsnonextpages</code></a>
-(<a id="wrglossary.4097"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={true}</span>) or <a id="wrglossary.4098"></a><a href="#glo:glsnextpages"><code class="csfmt">\glsnextpages</code></a>
-(<a id="wrglossary.4099"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={false}</span>) to the <a id="wrglossary.4100"></a><a href="#glo:dual.indexing">indexing</a> information
+This key works by adding <a id="wrglossary.4093"></a><a href="#glo:glsnonextpages"><code class="csfmt">\glsnonextpages</code></a>
+(<a id="wrglossary.4094"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={true}</span>) or <a id="wrglossary.4095"></a><a href="#glo:glsnextpages"><code class="csfmt">\glsnextpages</code></a>
+(<a id="wrglossary.4096"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={false}</span>) to the <a id="wrglossary.4097"></a><a href="#glo:dual.indexing">indexing</a> information
for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>. Note that this means that if the entry is
-added to the <a id="wrglossary.4101"></a><a href="#glo:dual.glossary">glossary</a> simply because it has an <a id="wrglossary.4102"></a><a href="#glo:dual.indexing">indexed</a> descendent (and has not been <a id="wrglossary.4103"></a><a href="#glo:dual.indexing">indexed</a> itself) then the first
-<a id="wrglossary.4104"></a><a href="#glo:dual.indexing">indexed</a> sub-entry that follows will have its <a id="wrglossary.4105"></a><a href="#glo:locationlist">number list</a> suppressed
+added to the <a id="wrglossary.4098"></a><a href="#glo:dual.glossary">glossary</a> simply because it has an <a id="wrglossary.4099"></a><a href="#glo:dual.indexing">indexed</a> descendent (and has not been <a id="wrglossary.4100"></a><a href="#glo:dual.indexing">indexed</a> itself) then the first
+<a id="wrglossary.4101"></a><a href="#glo:dual.indexing">indexed</a> sub-entry that follows will have its <a id="wrglossary.4102"></a><a href="#glo:locationlist">number list</a> suppressed
instead.
<p>
-With <a id="wrglossary.4106"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this key saves the appropriate command in the
-<a id="wrglossary.4107"></a><a href="#glo:opt.glosfield.prenumberlist"><span class="csoptfmt">prenumberlist</span></a> internal field, which is used by
-<a id="wrglossary.4108"></a><a href="#glo:glsnoidxprenumberlist"><code class="csfmt">\glsnoidxprenumberlist</code></a>.
+With <a id="wrglossary.4103"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this key saves the appropriate command in the
+<a id="wrglossary.4104"></a><a href="#glo:opt.glosfield.prenumberlist"><span class="csoptfmt">prenumberlist</span></a> internal field, which is used by
+<a id="wrglossary.4105"></a><a href="#glo:glsnoidxprenumberlist"><code class="csfmt">\glsnoidxprenumberlist</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.4109"></a><code class="code"><dfn id="glo:opt.gloskey.see"><span class="csoptfmt">see</span></dfn>={[<span class="meta">〈<em class="metainner">tag</em>〉</span>]<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4106"></a><code class="code"><dfn id="glo:opt.gloskey.see"><span class="csoptfmt">see</span></dfn>={[<span class="meta">〈<em class="metainner">tag</em>〉</span>]<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code></div><!-- end of settingsbox -->
This key essentially provides a convenient shortcut that performs
-<pre class="compactcodebox"><a id="wrglossary.4110"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>[<span class="meta">〈<em class="metainner">tag</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}
+<pre class="compactcodebox"><a id="wrglossary.4107"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>[<span class="meta">〈<em class="metainner">tag</em>〉</span>]{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}
</pre>
-after the <a id="wrglossary.4111"></a><a href="#glo:idx.glossaryentry">entry</a> has been defined. (See §<a href="#sec:crossref">11</a>.)
+after the <a id="wrglossary.4108"></a><a href="#glo:idx.glossaryentry">entry</a> has been defined. (See §<a href="#sec:crossref">11</a>.)
It was originally designed for synonyms that may not occur in the
-document text but needed to be included in the <a id="wrglossary.4112"></a><a href="#glo:dual.glossary">glossary</a> in order to
-redirect the reader. Note that it doesn’t <a id="wrglossary.4113"></a><a href="#glo:dual.indexing">index</a> the cross-referenced
-<a id="wrglossary.4114"></a><a href="#glo:idx.glossaryentry">entry</a> (or <a id="wrglossary.4115"></a><a href="#glo:idx.glossaryentry">entries</a>) as that would interfere with their <a id="wrglossary.4116"></a><a href="#glo:locationlist">number lists</a>.
+document text but needed to be included in the <a id="wrglossary.4109"></a><a href="#glo:dual.glossary">glossary</a> in order to
+redirect the reader. Note that it doesn’t <a id="wrglossary.4110"></a><a href="#glo:dual.indexing">index</a> the cross-referenced
+<a id="wrglossary.4111"></a><a href="#glo:idx.glossaryentry">entry</a> (or <a id="wrglossary.4112"></a><a href="#glo:idx.glossaryentry">entries</a>) as that would interfere with their <a id="wrglossary.4113"></a><a href="#glo:locationlist">number lists</a>.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Using the <a id="wrglossary.4117"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key will <span style="font-style: italic; font-variant: normal; ">automatically add this <a id="wrglossary.4118"></a><a href="#glo:idx.glossaryentry">entry</a>
-to the <a id="wrglossary.4119"></a><a href="#glo:dual.glossary">glossary</a></span>, but will not automatically add the
-cross-referenced <a id="wrglossary.4120"></a><a href="#glo:idx.glossaryentry">entry</a>.
+Using the <a id="wrglossary.4114"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key will <span style="font-style: italic; font-variant: normal; ">automatically add this <a id="wrglossary.4115"></a><a href="#glo:idx.glossaryentry">entry</a>
+to the <a id="wrglossary.4116"></a><a href="#glo:dual.glossary">glossary</a></span>, but will not automatically add the
+cross-referenced <a id="wrglossary.4117"></a><a href="#glo:idx.glossaryentry">entry</a>.
</div><!-- end of important -->
<p>
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4121"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.4122"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,
- <a id="wrglossary.4123"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={variety of small marrow}</span>}
-<a id="wrglossary.4124"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.4125"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,
- <a id="wrglossary.4126"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={(North American)}</span>,
- <a id="wrglossary.4127"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={courgette}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4118"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{courgette}{<a id="wrglossary.4119"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={courgette}</span>,
+ <a id="wrglossary.4120"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={variety of small marrow}</span>}
+<a id="wrglossary.4121"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.4122"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,
+ <a id="wrglossary.4123"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={(North American)}</span>,
+ <a id="wrglossary.4124"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={courgette}</span>}
</pre>
This defines two entries (courgette and zucchini) and automatically
adds a cross-reference from zucchini to courgette. (That is, it adds
-<span class="qt">“<span style="font-style: italic; font-variant: normal; ">see courgette”</span> to zucchini’s <a id="wrglossary.4128"></a><a href="#glo:locationlist">number list</a>.) This
-doesn’t automatically <a id="wrglossary.4129"></a><a href="#glo:dual.indexing">index</a> courgette since this would create an
-unwanted <a id="wrglossary.4130"></a><a href="#glo:dual.entrylocation">location</a> in courgette’s <a id="wrglossary.4131"></a><a href="#glo:locationlist">number list</a>. (Page 1, if the
-definitions occur in the <a id="wrglossary.4132"></a><a href="#glo:idx.preamble/document">preamble</a>.)
+<span class="qt">“<span style="font-style: italic; font-variant: normal; ">see courgette”</span> to zucchini’s <a id="wrglossary.4125"></a><a href="#glo:locationlist">number list</a>.) This
+doesn’t automatically <a id="wrglossary.4126"></a><a href="#glo:dual.indexing">index</a> courgette since this would create an
+unwanted <a id="wrglossary.4127"></a><a href="#glo:dual.entrylocation">location</a> in courgette’s <a id="wrglossary.4128"></a><a href="#glo:locationlist">number list</a>. (Page 1, if the
+definitions occur in the <a id="wrglossary.4129"></a><a href="#glo:idx.preamble/document">preamble</a>.)
<p>
Note that while it’s possible to put the cross-reference in the
description instead, for example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4133"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.4134"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,
- <a id="wrglossary.4135"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={(North American) see <a id="wrglossary.4136"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{courgette}}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4130"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{zucchini}{<a id="wrglossary.4131"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={zucchini}</span>,
+ <a id="wrglossary.4132"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={(North American) see <a id="wrglossary.4133"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{courgette}}</span>}
</pre>
-this won’t <a id="wrglossary.4137"></a><a href="#glo:dual.indexing">index</a> the zucchini entry, so if zucchini
-isn’t <a id="wrglossary.4138"></a><a href="#glo:dual.indexing">indexed</a> elsewhere (with commands like <a id="wrglossary.4139"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.4140"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) then it won’t
-appear in the <a id="wrglossary.4141"></a><a href="#glo:dual.glossary">glossary</a> even if courgette does.
+this won’t <a id="wrglossary.4134"></a><a href="#glo:dual.indexing">index</a> the zucchini entry, so if zucchini
+isn’t <a id="wrglossary.4135"></a><a href="#glo:dual.indexing">indexed</a> elsewhere (with commands like <a id="wrglossary.4136"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.4137"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) then it won’t
+appear in the <a id="wrglossary.4138"></a><a href="#glo:dual.glossary">glossary</a> even if courgette does.
<p>
-The referenced <a id="wrglossary.4142"></a><a href="#glo:idx.glossaryentry">entry</a> should be supplied as the value to this key.
+The referenced <a id="wrglossary.4139"></a><a href="#glo:idx.glossaryentry">entry</a> should be supplied as the value to this key.
If you want to override the <span class="qt">“see”</span> tag, you can supply the new
tag in square brackets before the label. For example
-<a id="wrglossary.4143"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[see also]{anotherlabel}}</span>.
+<a id="wrglossary.4140"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[see also]{anotherlabel}}</span>.
<p>
<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
-If you have suppressed the <a id="wrglossary.4144"></a><a href="#glo:locationlist">number list</a>, the cross-referencing
-information won’t appear in the <a id="wrglossary.4145"></a><a href="#glo:dual.glossary">glossary</a>, as it forms part of
-the <a id="wrglossary.4146"></a><a href="#glo:locationlist">number list</a>.
+If you have suppressed the <a id="wrglossary.4141"></a><a href="#glo:locationlist">number list</a>, the cross-referencing
+information won’t appear in the <a id="wrglossary.4142"></a><a href="#glo:dual.glossary">glossary</a>, as it forms part of
+the <a id="wrglossary.4143"></a><a href="#glo:locationlist">number list</a>.
</div><!-- end of warning -->
<p>
-You can override this for individual <a id="wrglossary.4147"></a><a href="#glo:idx.glossaryentry">glossary entries</a> using
-<a id="wrglossary.4148"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={false}</span>. Alternatively, you can use the
-<a id="wrglossary.4149"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a> package option. For further details, see
+You can override this for individual <a id="wrglossary.4144"></a><a href="#glo:idx.glossaryentry">glossary entries</a> using
+<a id="wrglossary.4145"></a><a href="#glo:opt.gloskey.nonumberlist"><span class="csoptfmt">nonumberlist</span></a><span class="optfmt">={false}</span>. Alternatively, you can use the
+<a id="wrglossary.4146"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a> package option. For further details, see
§<a href="#sec:crossref">11</a>.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-For Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, <a id="wrglossary.4150"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> must be used before any occurrence of
-<a id="wrglossary.4151"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> that contains the <a id="wrglossary.4152"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key.
+For Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, <a id="wrglossary.4147"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> must be used before any occurrence of
+<a id="wrglossary.4148"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> that contains the <a id="wrglossary.4149"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key.
</div><!-- end of important -->
<p>
-Since it’s useful to suppress the <a id="wrglossary.4153"></a><a href="#glo:dual.indexing">indexing</a> while working on a draft
-document, consider using the <a id="wrglossary.4154"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a> package option to
-warn about or ignore the <a id="wrglossary.4155"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key while <a id="wrglossary.4156"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> is
+Since it’s useful to suppress the <a id="wrglossary.4150"></a><a href="#glo:dual.indexing">indexing</a> while working on a draft
+document, consider using the <a id="wrglossary.4151"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a> package option to
+warn about or ignore the <a id="wrglossary.4152"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key while <a id="wrglossary.4153"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> is
commented out.
<p>
-If you use the <a id="wrglossary.4157"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key, you may want to consider using the
-<a id="wrglossary.4158"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package which additionally
-provides a <a id="wrglossary.4159"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> and <a id="wrglossary.4160"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> key. If you want to
-avoid the automatic <a id="wrglossary.4161"></a><a href="#glo:dual.indexing">indexing</a> triggered by the <a id="wrglossary.4162"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key,
-consider using <a id="wrglossary.4163"></a><a href="#glo:idx.opt.b2g">Option 4</a>. See also the FAQ item
+If you use the <a id="wrglossary.4154"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key, you may want to consider using the
+<a id="wrglossary.4155"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package which additionally
+provides a <a id="wrglossary.4156"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> and <a id="wrglossary.4157"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> key. If you want to
+avoid the automatic <a id="wrglossary.4158"></a><a href="#glo:dual.indexing">indexing</a> triggered by the <a id="wrglossary.4159"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key,
+consider using <a id="wrglossary.4160"></a><a href="#glo:idx.opt.b2g">Option 4</a>. See also the FAQ item
<a href="https://www.dickimaw-books.com/faq.php?itemlabel=whyseekeyautoindex">Why does the see key automatically index the entry?</a>
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.4164"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.4161"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-The analogous <a id="wrglossary.4165"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.4166"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.4167"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> and
-<a id="wrglossary.4168"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> fields have a slightly different meaning. The
-<a id="wrglossary.4169"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> resource option determines the behaviour.
+The analogous <a id="wrglossary.4162"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> <a id="wrglossary.4163"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a>, <a id="wrglossary.4164"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> and
+<a id="wrglossary.4165"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> fields have a slightly different meaning. The
+<a id="wrglossary.4166"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a> resource option determines the behaviour.
</div><!-- end of information -->
<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.4170"></a><code class="code"><dfn id="glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></dfn>={<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4167"></a><code class="code"><dfn id="glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></dfn>={<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</code></div><!-- end of settingsbox -->
-This key is only available with <a id="wrglossary.4171"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is
-similar to <a id="wrglossary.4172"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> but it doesn’t allow for the optional tag.
-The <a id="wrglossary.4173"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.4174"></a><a href="#glo:seealsoname"><code class="xtrcsfmt">\seealsoname</code></a> and
-<a id="wrglossary.4175"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a><span class="optfmt">={xr-list}</span> is essentially like
-<a id="wrglossary.4176"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[<a id="wrglossary.4177"></a><a href="#glo:seealsoname"><code class="xtrcsfmt">\seealsoname</code></a>]<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</span>
+This key is only available with <a id="wrglossary.4168"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is
+similar to <a id="wrglossary.4169"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> but it doesn’t allow for the optional tag.
+The <a id="wrglossary.4170"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.4171"></a><a href="#glo:seealsoname"><code class="xtrcsfmt">\seealsoname</code></a> and
+<a id="wrglossary.4172"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a><span class="optfmt">={xr-list}</span> is essentially like
+<a id="wrglossary.4173"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={[<a id="wrglossary.4174"></a><a href="#glo:seealsoname"><code class="xtrcsfmt">\seealsoname</code></a>]<span class="meta">〈<em class="metainner">xr-list</em>〉</span>}</span>
(Options <a href="#glo:idx.opt.xdy">3</a> and <a href="#glo:idx.opt.b2g">4</a> may treat these differently).
<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.4178"></a><code class="code"><dfn id="glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></dfn>={<span class="meta">〈<em class="metainner">xr-label</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4175"></a><code class="code"><dfn id="glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></dfn>={<span class="meta">〈<em class="metainner">xr-label</em>〉</span>}</code></div><!-- end of settingsbox -->
-This key is only available with <a id="wrglossary.4179"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is
+This key is only available with <a id="wrglossary.4176"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is
another form of cross-referencing. An entry can be aliased to
-another entry with <a id="wrglossary.4180"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={other-label}</span>. This behaves like
-<a id="wrglossary.4181"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={other-label}</span> but also alters the behaviour of commands
-like <a id="wrglossary.4182"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> so that they <a id="wrglossary.4183"></a><a href="#glo:dual.indexing">index</a> the <a id="wrglossary.4184"></a><a href="#glo:idx.glossaryentry">entry</a>
-given by <span class="meta">〈<em class="metainner">label</em>〉</span> instead of the original <a id="wrglossary.4185"></a><a href="#glo:idx.glossaryentry">entry</a>. (See, for example,
+another entry with <a id="wrglossary.4177"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={other-label}</span>. This behaves like
+<a id="wrglossary.4178"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={other-label}</span> but also alters the behaviour of commands
+like <a id="wrglossary.4179"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> so that they <a id="wrglossary.4180"></a><a href="#glo:dual.indexing">index</a> the <a id="wrglossary.4181"></a><a href="#glo:idx.glossaryentry">entry</a>
+given by <span class="meta">〈<em class="metainner">label</em>〉</span> instead of the original <a id="wrglossary.4182"></a><a href="#glo:idx.glossaryentry">entry</a>. (See, for example,
<a href="https://www.dickimaw-books.com/gallery/index.php?label=aliases">Gallery: Aliases</a>.)
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.4186"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.4183"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-More variations with the <a id="wrglossary.4187"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> key are available with <a id="wrglossary.4188"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
+More variations with the <a id="wrglossary.4184"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> key are available with <a id="wrglossary.4185"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
</div><!-- end of information -->
<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.4189"></a><code class="code"><dfn id="glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></dfn>={<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code></div><!-- end of settingsbox -->
+<a id="wrglossary.4186"></a><code class="code"><dfn id="glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></dfn>={<span class="meta">〈<em class="metainner">counter-name</em>〉</span>}</code></div><!-- end of settingsbox -->
-This key will set the default <a id="wrglossary.4190"></a><a href="#glo:dual.locationcounter">location counter</a> for the given
-<a id="wrglossary.4191"></a><a href="#glo:idx.glossaryentry">entry</a>. This will override the <a id="wrglossary.4192"></a><a href="#glo:dual.locationcounter">counter</a>
-assigned to the entry’s <a id="wrglossary.4193"></a><a href="#glo:dual.glossary">glossary</a> in the final optional
-argument of <a id="wrglossary.4194"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> (if provided) and the counter
-identified by the <a id="wrglossary.4195"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option. The
-<a id="wrglossary.4196"></a><a href="#glo:dual.locationcounter">location counter</a> can be overridden by the <a id="wrglossary.4197"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a>
-option when using the <a id="wrglossary.4198"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4199"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.
+This key will set the default <a id="wrglossary.4187"></a><a href="#glo:dual.locationcounter">location counter</a> for the given
+<a id="wrglossary.4188"></a><a href="#glo:idx.glossaryentry">entry</a>. This will override the <a id="wrglossary.4189"></a><a href="#glo:dual.locationcounter">counter</a>
+assigned to the entry’s <a id="wrglossary.4190"></a><a href="#glo:dual.glossary">glossary</a> in the final optional
+argument of <a id="wrglossary.4191"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> (if provided) and the counter
+identified by the <a id="wrglossary.4192"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option. The
+<a id="wrglossary.4193"></a><a href="#glo:dual.locationcounter">location counter</a> can be overridden by the <a id="wrglossary.4194"></a><a href="#glo:opt.glsopt.counter"><span class="csoptfmt">counter</span></a>
+option when using the <a id="wrglossary.4195"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> and <a id="wrglossary.4196"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.
<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.4200"></a><code class="code"><dfn id="glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></dfn>=<span class="meta">〈<em class="metainner">category-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>general</span><span class="clearfix"></span></div><!-- end of settingsbox -->
+<a id="wrglossary.4197"></a><code class="code"><dfn id="glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></dfn>=<span class="meta">〈<em class="metainner">category-label</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>general</span><span class="clearfix"></span></div><!-- end of settingsbox -->
-This key is only available with <a id="wrglossary.4201"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is used
-to assign a category to the <a id="wrglossary.4202"></a><a href="#glo:idx.glossaryentry">entry</a>. The value should be a label that
+This key is only available with <a id="wrglossary.4198"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and is used
+to assign a category to the <a id="wrglossary.4199"></a><a href="#glo:idx.glossaryentry">entry</a>. The value should be a label that
can be used to identify the category. See
-<a id="wrglossary.4203"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.4200"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
<p>
-The following keys are reserved for <a id="wrglossary.4204"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> (see
-§<a href="#sec:acronyms">6</a>) and also for <a id="wrglossary.4205"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> (see the
-<a id="wrglossary.4206"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual): <a id="wrglossary.4207"></a><dfn id="glo:opt.gloskey.long"><span class="csoptfmt">long</span></dfn>,
-<a id="wrglossary.4208"></a><dfn id="glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></dfn>,
-<a id="wrglossary.4209"></a><dfn id="glo:opt.gloskey.short"><span class="csoptfmt">short</span></dfn> and
-<a id="wrglossary.4210"></a><dfn id="glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></dfn>.
-You can use <a id="wrglossary.4211"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> and <a id="wrglossary.4212"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> in the
-optional argument of <a id="wrglossary.4213"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> (or <a id="wrglossary.4214"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>) to
-override the defaults, but don’t explicitly use the <a id="wrglossary.4215"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a>
-or <a id="wrglossary.4216"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> keys as that may interfere with
-<a id="wrglossary.4217"></a><a href="#glo:idx.acronymstyle">acronym style</a> (or <a id="wrglossary.4218"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a>).
+The following keys are reserved for <a id="wrglossary.4201"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> (see
+§<a href="#sec:acronyms">6</a>) and also for <a id="wrglossary.4202"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> (see the
+<a id="wrglossary.4203"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual): <a id="wrglossary.4204"></a><dfn id="glo:opt.gloskey.long"><span class="csoptfmt">long</span></dfn>,
+<a id="wrglossary.4205"></a><dfn id="glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></dfn>,
+<a id="wrglossary.4206"></a><dfn id="glo:opt.gloskey.short"><span class="csoptfmt">short</span></dfn> and
+<a id="wrglossary.4207"></a><dfn id="glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></dfn>.
+You can use <a id="wrglossary.4208"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a> and <a id="wrglossary.4209"></a><a href="#glo:opt.gloskey.shortplural"><span class="csoptfmt">shortplural</span></a> in the
+optional argument of <a id="wrglossary.4210"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> (or <a id="wrglossary.4211"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>) to
+override the defaults, but don’t explicitly use the <a id="wrglossary.4212"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a>
+or <a id="wrglossary.4213"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> keys as that may interfere with
+<a id="wrglossary.4214"></a><a href="#glo:idx.acronymstyle">acronym style</a> (or <a id="wrglossary.4215"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a>).
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.4219"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.4216"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-There are also special internal field names used by <a id="wrglossary.4220"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
-See the <a id="wrglossary.4221"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.
+There are also special internal field names used by <a id="wrglossary.4217"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
+See the <a id="wrglossary.4218"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.
</div><!-- end of information -->
<p>
-The supplementary packages <a id="wrglossary.4222"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> (§<a href="#sec:prefix">16</a>) and
-<a id="wrglossary.4223"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> (§<a href="#sec:accsupp">17</a>) provide additional keys.
+The supplementary packages <a id="wrglossary.4219"></a><a href="#glo:pkg.glossaries-prefix"><span class="styfmt">glossaries-prefix</span></a> (§<a href="#sec:prefix">16</a>) and
+<a id="wrglossary.4220"></a><a href="#glo:pkg.glossaries-accsupp"><span class="styfmt">glossaries-accsupp</span></a> (§<a href="#sec:accsupp">17</a>) provide additional keys.
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-Avoid using any of the <a id="wrglossary.4224"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.4225"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands within
-the <a id="wrglossary.4226"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>, <a id="wrglossary.4227"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.4228"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> or
-<a id="wrglossary.4229"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> keys (or their plural equivalent) or any
+Avoid using any of the <a id="wrglossary.4221"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.4222"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands within
+the <a id="wrglossary.4223"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a>, <a id="wrglossary.4224"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a>, <a id="wrglossary.4225"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> or
+<a id="wrglossary.4226"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> keys (or their plural equivalent) or any
other key that you plan to access through those commands.
-(For example, the <a id="wrglossary.4230"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key if you intend to use
-<a id="wrglossary.4231"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>.) Otherwise you can up with nested links, which
+(For example, the <a id="wrglossary.4227"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key if you intend to use
+<a id="wrglossary.4228"></a><a href="#glo:glssymbol"><code class="csfmt">\glssymbol</code></a>.) Otherwise you can up with nested links, which
can cause complications. You can use them within the value of keys
that won’t be accessed through those commands. For example,
-the <a id="wrglossary.4232"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key if you don’t use <a id="wrglossary.4233"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a>.
+the <a id="wrglossary.4229"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key if you don’t use <a id="wrglossary.4230"></a><a href="#glo:glsdesc"><code class="csfmt">\glsdesc</code></a>.
Additionally, they’ll confuse the formatting placeholder commands, such as
-<a id="wrglossary.4234"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>. The <a id="wrglossary.4235"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides
-<a id="wrglossary.4236"></a><a href="#glo:glsxtrp"><code class="xtrcsfmt">\glsxtrp</code></a> for this type of situation.
+<a id="wrglossary.4231"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>. The <a id="wrglossary.4232"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides
+<a id="wrglossary.4233"></a><a href="#glo:glsxtrp"><code class="xtrcsfmt">\glsxtrp</code></a> for this type of situation.
</div><!-- end of important -->
<p>
-With older LaTeX kernels and pre-2.08 versions of <a id="wrglossary.4237"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>,
-if the name starts with <a id="wrglossary.4238"></a><a href="#glo:dual.nonlatinchar">non-Latin character</a>, you need to group the character,
-otherwise it will cause a problem for commands like <a id="wrglossary.4239"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> and <a id="wrglossary.4240"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a>.
+With older LaTeX kernels and pre-2.08 versions of <a id="wrglossary.4234"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>,
+if the name starts with <a id="wrglossary.4235"></a><a href="#glo:dual.nonlatinchar">non-Latin character</a>, you need to group the character,
+otherwise it will cause a problem for commands like <a id="wrglossary.4236"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> and <a id="wrglossary.4237"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</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.4241"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07</span>
-<a id="wrglossary.4242"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.4243"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{<a id="wrglossary.4244"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>e}lite}</span>,
-<a id="wrglossary.4245"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+<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.4238"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07</span>
+<a id="wrglossary.4239"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.4240"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{<a id="wrglossary.4241"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a>e}lite}</span>,
+<a id="wrglossary.4242"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
</pre>
-Note that the same applies with <a id="wrglossary.4246"></a><a href="#glo:pkg.inputenc"><span class="styfmt">inputenc</span></a>:
-<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.4247"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07</span>
-<a id="wrglossary.4248"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.4249"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
-<a id="wrglossary.4250"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+Note that the same applies with <a id="wrglossary.4243"></a><a href="#glo:pkg.inputenc"><span class="styfmt">inputenc</span></a>:
+<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.4244"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07</span>
+<a id="wrglossary.4245"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.4246"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
+<a id="wrglossary.4247"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
</pre>
This doesn’t apply for XeLaTeX or LuaLaTeX documents or with
-<a id="wrglossary.4251"></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.4252"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08</span>
-<a id="wrglossary.4253"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.4254"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
-<a id="wrglossary.4255"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+<a id="wrglossary.4248"></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.4249"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08</span>
+<a id="wrglossary.4250"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.4251"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+<a id="wrglossary.4252"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
</pre>
-See the <a id="wrglossary.4256"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> manual for further details.
+See the <a id="wrglossary.4253"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> manual for further details.
<p>
-Note that in the above <a id="wrglossary.4257"></a><a href="#glo:dual.utf8">UTF-8</a> examples, you will also need to
-supply the <a id="wrglossary.4258"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key if you are using Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.mkidx">2</a>
-whereas <a id="wrglossary.4259"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.4260"></a><a href="#glo:idx.opt.xdy">Option 3</a>) is usually able to sort
-<a id="wrglossary.4261"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a> correctly.
+Note that in the above <a id="wrglossary.4254"></a><a href="#glo:dual.utf8">UTF-8</a> examples, you will also need to
+supply the <a id="wrglossary.4255"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key if you are using Options <a href="#glo:idx.opt.noidx">1</a> or <a href="#glo:idx.opt.mkidx">2</a>
+whereas <a id="wrglossary.4256"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.4257"></a><a href="#glo:idx.opt.xdy">Option 3</a>) is usually able to sort
+<a id="wrglossary.4258"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a> correctly.
<p>
</section><!-- end of section sec:newglosentry -->
@@ -12850,44 +12854,44 @@
<p>
You may have noticed from above that you can specify the plural form
-when you define an <a id="wrglossary.4262"></a><a href="#glo:idx.glossaryentry">entry</a>. If you omit this, the plural will be
+when you define an <a id="wrglossary.4259"></a><a href="#glo:idx.glossaryentry">entry</a>. If you omit this, the plural will be
obtained by appending:
<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.4263"></a><code class="code"><dfn id="glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>s</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
+<a id="wrglossary.4260"></a><code class="code"><dfn id="glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></dfn></code><span class="floatrightbox"><span class="summarytag">initial: </span>s</span><span class="clearfix"></span></div><!-- end of pinnedbox -->
to the singular form.
-This command may expand when the <a id="wrglossary.4264"></a><a href="#glo:idx.glossaryentry">entry</a> is defined, if expansion is
-on for the relevant keys, or may not expand until the <a id="wrglossary.4265"></a><a href="#glo:idx.glossaryentry">entry</a> is
+This command may expand when the <a id="wrglossary.4261"></a><a href="#glo:idx.glossaryentry">entry</a> is defined, if expansion is
+on for the relevant keys, or may not expand until the <a id="wrglossary.4262"></a><a href="#glo:idx.glossaryentry">entry</a> is
referenced, if expansion is off or if the suffix has been hidden
inside non-expanding context (which can happen when defining
-<a id="wrglossary.4266"></a><a href="#glo:idx.acronym">acronyms</a> or <a id="wrglossary.4267"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a>).
+<a id="wrglossary.4263"></a><a href="#glo:idx.acronym">acronyms</a> or <a id="wrglossary.4264"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a>).
<p>
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4268"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cow}{<a id="wrglossary.4269"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cow}</span>,<a id="wrglossary.4270"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fully grown
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4265"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cow}{<a id="wrglossary.4266"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cow}</span>,<a id="wrglossary.4267"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fully grown
female of any bovine animal}</span>}
</pre>
-defines a new <a id="wrglossary.4271"></a><a href="#glo:idx.glossaryentry">entry</a> whose singular form is <span class="qt">“cow”</span> and plural form
+defines a new <a id="wrglossary.4268"></a><a href="#glo:idx.glossaryentry">entry</a> whose singular form is <span class="qt">“cow”</span> and plural form
is <span class="qt">“cows”</span>. However, if you are writing in archaic English, you
may want to use <span class="qt">“kine”</span> as the plural form, in which case you
would have to do:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4272"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cow}{<a id="wrglossary.4273"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cow}</span>,<a id="wrglossary.4274"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={kine}</span>,
-<a id="wrglossary.4275"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fully grown female of any bovine animal}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4269"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cow}{<a id="wrglossary.4270"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cow}</span>,<a id="wrglossary.4271"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={kine}</span>,
+<a id="wrglossary.4272"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fully grown female of any bovine animal}</span>}
</pre>
<p>
If you are writing in a language that supports
-multiple plurals (for a given term) then use the <a id="wrglossary.4276"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key
+multiple plurals (for a given term) then use the <a id="wrglossary.4273"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key
for one of them and one of the user keys to specify the
other plural form. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4277"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cow}{
- <a id="wrglossary.4278"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cow}</span>,
- <a id="wrglossary.4279"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fully grown female of any bovine animal
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4274"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{cow}{
+ <a id="wrglossary.4275"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={cow}</span>,
+ <a id="wrglossary.4276"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fully grown female of any bovine animal
(plural cows, archaic plural kine)}</span>,
- <a id="wrglossary.4280"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={kine}</span>}
+ <a id="wrglossary.4277"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={kine}</span>}
</pre>
-You can then use <code class="code"><a id="wrglossary.4281"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{cow}</code> to produce <span class="qt">“cows”</span> and
-<code class="code"><a id="wrglossary.4282"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a>{cow}</code> to produce <span class="qt">“kine”</span>. You can, of course,
+You can then use <code class="code"><a id="wrglossary.4278"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{cow}</code> to produce <span class="qt">“cows”</span> and
+<code class="code"><a id="wrglossary.4279"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a>{cow}</code> to produce <span class="qt">“kine”</span>. You can, of course,
define an easy to remember synonym. For example:
-<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">\glsaltpl</code><a id="wrglossary.4283"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a>
+<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">\glsaltpl</code><a id="wrglossary.4280"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a>
</pre>
Then you don’t have to remember which key you used to store the
second plural. (Be careful with using <code class="csfmt">\let</code> as it doesn’t
@@ -12894,16 +12898,16 @@
check if the command already exists.)
<p>
Alternatively, you can define your own keys using
-<a id="wrglossary.4284"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>, described in §<a href="#sec:addkey">4.3</a> (or simply use
-<a id="wrglossary.4285"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> or <a id="wrglossary.4286"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> with the appropriate text).
+<a id="wrglossary.4281"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>, described in §<a href="#sec:addkey">4.3</a> (or simply use
+<a id="wrglossary.4282"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> or <a id="wrglossary.4283"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> with the appropriate text).
<p>
If you are using a language that usually forms plurals
by appending a different letter, or sequence of letters, you can
-redefine <a id="wrglossary.4287"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> as required. However, this must be
+redefine <a id="wrglossary.4284"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> as required. However, this must be
done <span style="font-style: italic; font-variant: normal; ">before</span> the entries are defined and is unreliable for
multilingual documents. For languages that don’t
form plurals by simply appending a suffix, all the plural forms must be
-specified using the <a id="wrglossary.4288"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key (and the <a id="wrglossary.4289"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>
+specified using the <a id="wrglossary.4285"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key (and the <a id="wrglossary.4286"></a><a href="#glo:opt.gloskey.firstplural"><span class="csoptfmt">firstplural</span></a>
key where necessary).
<p>
@@ -12915,16 +12919,16 @@
<p>
You can use the six user keys to provide alternatives, such as
participles. For example:
-<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">\glsing</code><a id="wrglossary.4290"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a>
-<code class="cmd">\let</code><code class="cmd">\glsd</code><a id="wrglossary.4291"></a><a href="#glo:glsuserii"><code class="csfmt">\glsuserii</code></a>
+<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">\glsing</code><a id="wrglossary.4287"></a><a href="#glo:glsuseri"><code class="csfmt">\glsuseri</code></a>
+<code class="cmd">\let</code><code class="cmd">\glsd</code><a id="wrglossary.4288"></a><a href="#glo:glsuserii"><code class="csfmt">\glsuserii</code></a>
-<code class="cmd">\newcommand</code>*{<code class="cmd">\ingkey</code>}{<a id="wrglossary.4292"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a>}
-<code class="cmd">\newcommand</code>*{<code class="cmd">\edkey</code>}{<a id="wrglossary.4293"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a>}
+<code class="cmd">\newcommand</code>*{<code class="cmd">\ingkey</code>}{<a id="wrglossary.4289"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a>}
+<code class="cmd">\newcommand</code>*{<code class="cmd">\edkey</code>}{<a id="wrglossary.4290"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a>}
<code class="cmd">\newcommand</code>*{<code class="cmd">\newword</code>}[3][]{<span class="comment">% </span>
- <a id="wrglossary.4294"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{#2}{<span class="comment">% </span>
- <a id="wrglossary.4295"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={#2}</span>,<span class="comment">% </span>
- <a id="wrglossary.4296"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={#3}</span>,<span class="comment">% </span>
+ <a id="wrglossary.4291"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{#2}{<span class="comment">% </span>
+ <a id="wrglossary.4292"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={#2}</span>,<span class="comment">% </span>
+ <a id="wrglossary.4293"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={#3}</span>,<span class="comment">% </span>
<code class="cmd">\edkey</code>={#2ed},<span class="comment">% </span>
<code class="cmd">\ingkey</code>={#2ing},#1<span class="comment">% </span>
}}
@@ -12943,9 +12947,9 @@
</pre>
<p>
Alternatively, you can define your own keys using
-<a id="wrglossary.4297"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>, described below in §<a href="#sec:addkey">4.3</a>.
-It may, however, be simpler just to use <a id="wrglossary.4298"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> or
-<a id="wrglossary.4299"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> with the appropriate <a id="wrglossary.4300"></a><a href="#glo:dual.linktext">link text</a>.
+<a id="wrglossary.4294"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>, described below in §<a href="#sec:addkey">4.3</a>.
+It may, however, be simpler just to use <a id="wrglossary.4295"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> or
+<a id="wrglossary.4296"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a> with the appropriate <a id="wrglossary.4297"></a><a href="#glo:dual.linktext">link text</a>.
<p>
</section><!-- end of section sec:grammar -->
@@ -12961,19 +12965,19 @@
<p>
For example, if you want to add a key that indicates the associated
unit for a term, you might want to reference this unit in your
-document. In this case use <a id="wrglossary.4301"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> described in
+document. In this case use <a id="wrglossary.4298"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> described in
§<a href="#sec:glsaddkey">4.3.1</a>. If, on the other hand, you want to add a
-key to indicate to a <a id="wrglossary.4302"></a><a href="#glo:idx.glossarystyle">glossary style</a> or <a id="wrglossary.4303"></a><a href="#glo:idx.acronymstyle">acronym style</a> that
-this <a id="wrglossary.4304"></a><a href="#glo:idx.glossaryentry">entry</a> should be formatted differently to other
-<a id="wrglossary.4305"></a><a href="#glo:idx.glossaryentry">entries</a>, then you can use <a id="wrglossary.4306"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> described in
+key to indicate to a <a id="wrglossary.4299"></a><a href="#glo:idx.glossarystyle">glossary style</a> or <a id="wrglossary.4300"></a><a href="#glo:idx.acronymstyle">acronym style</a> that
+this <a id="wrglossary.4301"></a><a href="#glo:idx.glossaryentry">entry</a> should be formatted differently to other
+<a id="wrglossary.4302"></a><a href="#glo:idx.glossaryentry">entries</a>, then you can use <a id="wrglossary.4303"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> described in
§<a href="#sec:glsaddstoragekey">4.3.2</a>.
<p>
In both cases, a new command <span class="meta">〈<em class="metainner">no link cs</em>〉</span> will be defined that
can be used to access the value of this key (analogous to commands
-such as <a id="wrglossary.4307"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>). This can be used in an expandable
+such as <a id="wrglossary.4304"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>). This can be used in an expandable
context (provided any fragile commands stored in the key have been
-protected). The new keys must be added using <a id="wrglossary.4308"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> or
-<a id="wrglossary.4309"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> before <a id="wrglossary.4310"></a><a href="#glo:idx.glossaryentry">glossary entries</a> are defined.
+protected). The new keys must be added using <a id="wrglossary.4305"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> or
+<a id="wrglossary.4306"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> before <a id="wrglossary.4307"></a><a href="#glo:idx.glossaryentry">glossary entries</a> are defined.
<p>
</section><!-- end of section sec:addkey -->
@@ -12984,33 +12988,33 @@
<p>
A custom key that can be used in the document is defined 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.4311"></a><code class="code"><dfn id="glo:glsaddkey"><code class="csfmt">\glsaddkey</code></dfn>{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}{<span class="meta">〈<em class="metainner">no link ucfirst cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link ucfirst cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link allcaps cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4308"></a><code class="code"><dfn id="glo:glsaddkey"><code class="csfmt">\glsaddkey</code></dfn>{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}{<span class="meta">〈<em class="metainner">no link ucfirst cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link ucfirst cs</em>〉</span>}{<span class="meta">〈<em class="metainner">link allcaps cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
where the arguments are as follows:
<dl class="inlinetitle">
-<span class="meta">〈<em class="metainner">key</em>〉</span> is the new key to use in <a id="wrglossary.4312"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
-(or similar commands such as <a id="wrglossary.4313"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>);
+<span class="meta">〈<em class="metainner">key</em>〉</span> is the new key to use in <a id="wrglossary.4309"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>
+(or similar commands such as <a id="wrglossary.4310"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>);
<span class="meta">〈<em class="metainner">default value</em>〉</span> is the default value to use if this key
isn’t used in an entry definition (this may reference the current
-entry label via <a id="wrglossary.4314"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>, but you will have to switch on
-expansion via the starred version of <a id="wrglossary.4315"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> and protect
+entry label via <a id="wrglossary.4311"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>, but you will have to switch on
+expansion via the starred version of <a id="wrglossary.4312"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> and protect
fragile commands);
<span class="meta">〈<em class="metainner">no link cs</em>〉</span> is the control sequence to use analogous
-to commands like <a id="wrglossary.4316"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>;
+to commands like <a id="wrglossary.4313"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>;
<span class="meta">〈<em class="metainner">no link ucfirst cs</em>〉</span> is the control sequence to use analogous
-to commands like <a id="wrglossary.4317"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a>;
+to commands like <a id="wrglossary.4314"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a>;
<span class="meta">〈<em class="metainner">link cs</em>〉</span> is the control sequence to use analogous
-to commands like <a id="wrglossary.4318"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>;
+to commands like <a id="wrglossary.4315"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>;
<span class="meta">〈<em class="metainner">link ucfirst cs</em>〉</span> is the control sequence to use analogous
-to commands like <a id="wrglossary.4319"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a>;
+to commands like <a id="wrglossary.4316"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a>;
<span class="meta">〈<em class="metainner">link allcaps cs</em>〉</span> is the control sequence to use analogous
-to commands like <a id="wrglossary.4320"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a>.
+to commands like <a id="wrglossary.4317"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a>.
</dl>
-The starred version of <a id="wrglossary.4321"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> switches on expansion for this
+The starred version of <a id="wrglossary.4318"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> switches on expansion for this
key. The unstarred version doesn’t override the current expansion
setting.
<p>
@@ -13020,42 +13024,42 @@
respectively. The default value will need expanding in both cases, so
I need to use the starred form:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% Define "ed" key:</span>
- <a id="wrglossary.4322"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>*
+ <a id="wrglossary.4319"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>*
{ed}<span class="comment">% key</span>
- {<a id="wrglossary.4323"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{<a id="wrglossary.4324"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}ed}<span class="comment">% default value</span>
- {<code class="cmd">\glsentryed</code>}<span class="comment">% command analogous to <a id="wrglossary.4325"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a></span>
- {<code class="cmd">\Glsentryed</code>}<span class="comment">% command analogous to <a id="wrglossary.4326"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a></span>
- {<code class="cmd">\glsed</code>}<span class="comment">% command analogous to <a id="wrglossary.4327"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a></span>
- {<code class="cmd">\Glsed</code>}<span class="comment">% command analogous to <a id="wrglossary.4328"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a></span>
- {<code class="cmd">\GLSed</code>}<span class="comment">% command analogous to <a id="wrglossary.4329"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a></span>
+ {<a id="wrglossary.4320"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{<a id="wrglossary.4321"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}ed}<span class="comment">% default value</span>
+ {<code class="cmd">\glsentryed</code>}<span class="comment">% command analogous to <a id="wrglossary.4322"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a></span>
+ {<code class="cmd">\Glsentryed</code>}<span class="comment">% command analogous to <a id="wrglossary.4323"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a></span>
+ {<code class="cmd">\glsed</code>}<span class="comment">% command analogous to <a id="wrglossary.4324"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a></span>
+ {<code class="cmd">\Glsed</code>}<span class="comment">% command analogous to <a id="wrglossary.4325"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a></span>
+ {<code class="cmd">\GLSed</code>}<span class="comment">% command analogous to <a id="wrglossary.4326"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a></span>
<span class="comment">% Define "ing" key:</span>
- <a id="wrglossary.4330"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>*
+ <a id="wrglossary.4327"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>*
{ing}<span class="comment">% key</span>
- {<a id="wrglossary.4331"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{<a id="wrglossary.4332"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}ing}<span class="comment">% default value</span>
- {<code class="cmd">\glsentrying</code>}<span class="comment">% command analogous to <a id="wrglossary.4333"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a></span>
- {<code class="cmd">\Glsentrying</code>}<span class="comment">% command analogous to <a id="wrglossary.4334"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a></span>
- {<code class="cmd">\glsing</code>}<span class="comment">% command analogous to <a id="wrglossary.4335"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a></span>
- {<code class="cmd">\Glsing</code>}<span class="comment">% command analogous to <a id="wrglossary.4336"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a></span>
- {<code class="cmd">\GLSing</code>}<span class="comment">% command analogous to <a id="wrglossary.4337"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a></span>
+ {<a id="wrglossary.4328"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a>{<a id="wrglossary.4329"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}ing}<span class="comment">% default value</span>
+ {<code class="cmd">\glsentrying</code>}<span class="comment">% command analogous to <a id="wrglossary.4330"></a><a href="#glo:glsentrytext"><code class="csfmt">\glsentrytext</code></a></span>
+ {<code class="cmd">\Glsentrying</code>}<span class="comment">% command analogous to <a id="wrglossary.4331"></a><a href="#glo:Glsentrytext"><code class="csfmt">\Glsentrytext</code></a></span>
+ {<code class="cmd">\glsing</code>}<span class="comment">% command analogous to <a id="wrglossary.4332"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a></span>
+ {<code class="cmd">\Glsing</code>}<span class="comment">% command analogous to <a id="wrglossary.4333"></a><a href="#glo:Glstext"><code class="csfmt">\Glstext</code></a></span>
+ {<code class="cmd">\GLSing</code>}<span class="comment">% command analogous to <a id="wrglossary.4334"></a><a href="#glo:GLStext"><code class="csfmt">\GLStext</code></a></span>
</pre>
-Now I can define some <a id="wrglossary.4338"></a><a href="#glo:idx.glossaryentry">entries</a>:
+Now I can define some <a id="wrglossary.4335"></a><a href="#glo:idx.glossaryentry">entries</a>:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% No need to override defaults for this entry:</span>
-<a id="wrglossary.4339"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{jump}{<a id="wrglossary.4340"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={jump}</span>,<a id="wrglossary.4341"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+<a id="wrglossary.4336"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{jump}{<a id="wrglossary.4337"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={jump}</span>,<a id="wrglossary.4338"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
<span class="comment">% Need to override defaults on these entries:</span>
-<a id="wrglossary.4342"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{run}{<a id="wrglossary.4343"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={run}</span>,
+<a id="wrglossary.4339"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{run}{<a id="wrglossary.4340"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={run}</span>,
ed={ran},
ing={running},
- <a id="wrglossary.4344"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+ <a id="wrglossary.4341"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
-<a id="wrglossary.4345"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{waddle}{<a id="wrglossary.4346"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={waddle}</span>,
+<a id="wrglossary.4342"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{waddle}{<a id="wrglossary.4343"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={waddle}</span>,
ed={waddled},
ing={waddling},
- <a id="wrglossary.4347"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
+ <a id="wrglossary.4344"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={}</span>}
</pre>
<p>
-These <a id="wrglossary.4348"></a><a href="#glo:idx.glossaryentry">entries</a> can later be used in the document:
+These <a id="wrglossary.4345"></a><a href="#glo:idx.glossaryentry">entries</a> can later be used in the document:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The dog <code class="cmd">\glsed</code>{jump} over the duck.
The duck was <code class="cmd">\glsing</code>{waddle} round the dog.
@@ -13062,7 +13066,7 @@
The dog <code class="cmd">\glsed</code>{run} away from the duck.
</pre>
-For a complete document, see the sample file <a id="wrglossary.4349"></a><a href="#glo:file.sample-newkeys.tex"><span class="filefmt">sample-newkeys.tex</span></a>.
+For a complete document, see the sample file <a id="wrglossary.4346"></a><a href="#glo:file.sample-newkeys.tex"><span class="filefmt">sample-newkeys.tex</span></a>.
</div>
<p>
@@ -13075,12 +13079,12 @@
A custom key that can be used for simply storing information is
defined 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.4350"></a><code class="code"><dfn id="glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></dfn>{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4347"></a><code class="code"><dfn id="glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></dfn>{<span class="meta">〈<em class="metainner">key</em>〉</span>}{<span class="meta">〈<em class="metainner">default value</em>〉</span>}{<span class="meta">〈<em class="metainner">no link cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
where the arguments are as the first three arguments of
-<a id="wrglossary.4351"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>, described above in §<a href="#sec:glsaddkey">4.3.1</a>.
+<a id="wrglossary.4348"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a>, described above in §<a href="#sec:glsaddkey">4.3.1</a>.
<p>
-This is essentially the same as <a id="wrglossary.4352"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> except that it
+This is essentially the same as <a id="wrglossary.4349"></a><a href="#glo:glsaddkey"><code class="csfmt">\glsaddkey</code></a> except that it
doesn’t define the additional commands. You can access or update
the value of your new field using the commands described in
§<a href="#sec:fetchset">15.6</a>.
@@ -13088,166 +13092,166 @@
<div class="example" id="ex:addstoragekey"><div class="title">Example 14: Defining Custom Storage Key (Acronyms and Initialisms)</div>
Suppose I want to define acronyms (an abbreviation that is
pronounced as a word) and other forms of abbreviations, such as
-initialisms, but I want them all in the same <a id="wrglossary.4353"></a><a href="#glo:dual.glossary">glossary</a> and I
-want the acronyms on <a id="wrglossary.4354"></a><a href="#glo:dual.firstuse">first use</a> to be displayed with the short
+initialisms, but I want them all in the same <a id="wrglossary.4350"></a><a href="#glo:dual.glossary">glossary</a> and I
+want the acronyms on <a id="wrglossary.4351"></a><a href="#glo:dual.firstuse">first use</a> to be displayed with the short
form followed by the long form in parentheses, but the opposite way
-round for other forms of abbreviations. (The <a id="wrglossary.4355"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+round for other forms of abbreviations. (The <a id="wrglossary.4352"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
package provides a simpler way of achieving this.)
<p>
Here I can define a new key that determines whether the term is
actually an acronym rather than some other form of abbreviation. I’m
-going to call this key <span class="optfmt">abbrtype</span> (since <a id="wrglossary.4356"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>
+going to call this key <span class="optfmt">abbrtype</span> (since <a id="wrglossary.4353"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>
already exists):
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4357"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4354"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>
{abbrtype}<span class="comment">% key/field name</span>
{word}<span class="comment">% default value if not explicitly set</span>
{<code class="cmd">\abbrtype</code>}<span class="comment">% custom command to access the value if required</span>
</pre>
<p>
-Now I can define a <a id="wrglossary.4358"></a><a href="#glo:idx.acronymstyle">style</a> that looks up the value of
+Now I can define a <a id="wrglossary.4355"></a><a href="#glo:idx.acronymstyle">style</a> that looks up the value of
this new key to determine how to display the full form:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4359"></a><a href="#glo:newacronymstyle"><code class="csfmt">\newacronymstyle</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4356"></a><a href="#glo:newacronymstyle"><code class="csfmt">\newacronymstyle</code></a>
{mystyle}<span class="comment">% style name</span>
{<span class="comment">% Use the generic display</span>
- <a id="wrglossary.4360"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.4361"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<a id="wrglossary.4362"></a><a href="#glo:glsgenacfmt"><code class="csfmt">\glsgenacfmt</code></a>}{<a id="wrglossary.4363"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.4357"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.4358"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<a id="wrglossary.4359"></a><a href="#glo:glsgenacfmt"><code class="csfmt">\glsgenacfmt</code></a>}{<a id="wrglossary.4360"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a>}<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% Put the long form in the description</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4364"></a><a href="#glo:GenericAcronymFields"><code class="csfmt">\GenericAcronymFields</code></a>}{<span class="comment">% </span>
- <a id="wrglossary.4365"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4366"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}</span>}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4361"></a><a href="#glo:GenericAcronymFields"><code class="csfmt">\GenericAcronymFields</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.4362"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4363"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}</span>}<span class="comment">% </span>
<span class="comment">% For the full format, test the value of the "abbrtype" key.</span>
<span class="comment">% If it's set to "word" put the short form first with</span>
<span class="comment">% the long form in brackets.</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4367"></a><a href="#glo:genacrfullformat"><code class="csfmt">\genacrfullformat</code></a>}[2]{<span class="comment">% </span>
- <a id="wrglossary.4368"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4369"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4364"></a><a href="#glo:genacrfullformat"><code class="csfmt">\genacrfullformat</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.4365"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4366"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}
{<span class="comment">% is a proper acronym</span>
- <code class="cmd">\protect</code><a id="wrglossary.4370"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4371"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4372"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4373"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4374"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<a id="wrglossary.4375"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4376"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
+ <code class="cmd">\protect</code><a id="wrglossary.4367"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4368"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4369"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4370"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4371"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<a id="wrglossary.4372"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4373"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% is another form of abbreviation</span>
- <a id="wrglossary.4377"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4378"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4379"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4380"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<code class="cmd">\protect</code><a id="wrglossary.4381"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4382"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4383"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
+ <a id="wrglossary.4374"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4375"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4376"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4377"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<code class="cmd">\protect</code><a id="wrglossary.4378"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4379"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4380"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
}<span class="comment">% </span>
}<span class="comment">% </span>
- <span class="comment">% <a id="wrglossary.4384"></a><a href="#glo:idx.sentencecase">sentence case</a> version:</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4385"></a><a href="#glo:Genacrfullformat"><code class="csfmt">\Genacrfullformat</code></a>}[2]{<span class="comment">% </span>
- <a id="wrglossary.4386"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4387"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}
+ <span class="comment">% <a id="wrglossary.4381"></a><a href="#glo:idx.sentencecase">sentence case</a> version:</span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4382"></a><a href="#glo:Genacrfullformat"><code class="csfmt">\Genacrfullformat</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.4383"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4384"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}
{<span class="comment">% is a proper acronym</span>
- <code class="cmd">\protect</code><a id="wrglossary.4388"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4389"></a><a href="#glo:Glsentryshort"><code class="csfmt">\Glsentryshort</code></a>{<a id="wrglossary.4390"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4391"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4392"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<a id="wrglossary.4393"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4394"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
+ <code class="cmd">\protect</code><a id="wrglossary.4385"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4386"></a><a href="#glo:Glsentryshort"><code class="csfmt">\Glsentryshort</code></a>{<a id="wrglossary.4387"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4388"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4389"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<a id="wrglossary.4390"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4391"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
}
{<span class="comment">% is another form of abbreviation</span>
- <a id="wrglossary.4395"></a><a href="#glo:Glsentrylong"><code class="csfmt">\Glsentrylong</code></a>{<a id="wrglossary.4396"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4397"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4398"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<code class="cmd">\protect</code><a id="wrglossary.4399"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4400"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4401"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
+ <a id="wrglossary.4392"></a><a href="#glo:Glsentrylong"><code class="csfmt">\Glsentrylong</code></a>{<a id="wrglossary.4393"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4394"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4395"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<code class="cmd">\protect</code><a id="wrglossary.4396"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4397"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4398"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
}<span class="comment">% </span>
}<span class="comment">% </span>
<span class="comment">% plural</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4402"></a><a href="#glo:genplacrfullformat"><code class="csfmt">\genplacrfullformat</code></a>}[2]{<span class="comment">% </span>
- <a id="wrglossary.4403"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4404"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4399"></a><a href="#glo:genplacrfullformat"><code class="csfmt">\genplacrfullformat</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.4400"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4401"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}<span class="comment">% </span>
{<span class="comment">% is a proper acronym</span>
- <code class="cmd">\protect</code><a id="wrglossary.4405"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4406"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<a id="wrglossary.4407"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4408"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4409"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<a id="wrglossary.4410"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4411"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
+ <code class="cmd">\protect</code><a id="wrglossary.4402"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4403"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<a id="wrglossary.4404"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4405"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4406"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<a id="wrglossary.4407"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4408"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% is another form of abbreviation</span>
- <a id="wrglossary.4412"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a>{<a id="wrglossary.4413"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4414"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4415"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<code class="cmd">\protect</code><a id="wrglossary.4416"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4417"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<a id="wrglossary.4418"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
+ <a id="wrglossary.4409"></a><a href="#glo:glsentrylongpl"><code class="csfmt">\glsentrylongpl</code></a>{<a id="wrglossary.4410"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4411"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4412"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<code class="cmd">\protect</code><a id="wrglossary.4413"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4414"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<a id="wrglossary.4415"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
}<span class="comment">% </span>
}<span class="comment">% </span>
- <span class="comment">% plural and <a id="wrglossary.4419"></a><a href="#glo:idx.sentencecase">sentence case</a></span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4420"></a><a href="#glo:Genplacrfullformat"><code class="csfmt">\Genplacrfullformat</code></a>}[2]{<span class="comment">% </span>
- <a id="wrglossary.4421"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4422"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}<span class="comment">% </span>
+ <span class="comment">% plural and <a id="wrglossary.4416"></a><a href="#glo:idx.sentencecase">sentence case</a></span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4417"></a><a href="#glo:Genplacrfullformat"><code class="csfmt">\Genplacrfullformat</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.4418"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4419"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}<span class="comment">% </span>
{<span class="comment">% is a proper acronym</span>
- <code class="cmd">\protect</code><a id="wrglossary.4423"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4424"></a><a href="#glo:Glsentryshortpl"><code class="csfmt">\Glsentryshortpl</code></a>{<a id="wrglossary.4425"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4426"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4427"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<a id="wrglossary.4428"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4429"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
+ <code class="cmd">\protect</code><a id="wrglossary.4420"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4421"></a><a href="#glo:Glsentryshortpl"><code class="csfmt">\Glsentryshortpl</code></a>{<a id="wrglossary.4422"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<a id="wrglossary.4423"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4424"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<a id="wrglossary.4425"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4426"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<span class="comment">% </span>
}<span class="comment">% </span>
{<span class="comment">% is another form of abbreviation</span>
- <a id="wrglossary.4430"></a><a href="#glo:Glsentrylongpl"><code class="csfmt">\Glsentrylongpl</code></a>{<a id="wrglossary.4431"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4432"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4433"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
- (<code class="cmd">\protect</code><a id="wrglossary.4434"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4435"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<a id="wrglossary.4436"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
+ <a id="wrglossary.4427"></a><a href="#glo:Glsentrylongpl"><code class="csfmt">\Glsentrylongpl</code></a>{<a id="wrglossary.4428"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4429"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2<a id="wrglossary.4430"></a><a href="#glo:space"><code class="csfmt">\space</code></a>
+ (<code class="cmd">\protect</code><a id="wrglossary.4431"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>{<a id="wrglossary.4432"></a><a href="#glo:glsentryshortpl"><code class="csfmt">\glsentryshortpl</code></a>{<a id="wrglossary.4433"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}})<span class="comment">% </span>
}<span class="comment">% </span>
}<span class="comment">% </span>
- <span class="comment">% Just use the short form as the name part in the <a id="wrglossary.4437"></a><a href="#glo:dual.glossary">glossary</a>:</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4438"></a><a href="#glo:acronymentry"><code class="csfmt">\acronymentry</code></a>}[1]{<span class="comment">% </span>
- <a id="wrglossary.4439"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>{<a id="wrglossary.4440"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4441"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}}<span class="comment">% </span>
+ <span class="comment">% Just use the short form as the name part in the <a id="wrglossary.4434"></a><a href="#glo:dual.glossary">glossary</a>:</span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4435"></a><a href="#glo:acronymentry"><code class="csfmt">\acronymentry</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.4436"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>{<a id="wrglossary.4437"></a><a href="#glo:glsentryshort"><code class="csfmt">\glsentryshort</code></a>{<a id="wrglossary.4438"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}}<span class="comment">% </span>
<span class="comment">% Sort by the short form:</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4442"></a><a href="#glo:acronymsort"><code class="csfmt">\acronymsort</code></a>}[2]{<a id="wrglossary.4443"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4439"></a><a href="#glo:acronymsort"><code class="csfmt">\acronymsort</code></a>}[2]{<a id="wrglossary.4440"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
<span class="comment">% Just use the surrounding font for the short form:</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4444"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>}[1]{<a id="wrglossary.4445"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
- <span class="comment">% Same for <a id="wrglossary.4446"></a><a href="#glo:dual.firstuse">first use</a>:</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4447"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>}[1]{<a id="wrglossary.4448"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>{<a id="wrglossary.4449"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4441"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>}[1]{<a id="wrglossary.4442"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
+ <span class="comment">% Same for <a id="wrglossary.4443"></a><a href="#glo:dual.firstuse">first use</a>:</span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4444"></a><a href="#glo:firstacronymfont"><code class="csfmt">\firstacronymfont</code></a>}[1]{<a id="wrglossary.4445"></a><a href="#glo:acronymfont"><code class="csfmt">\acronymfont</code></a>{<a id="wrglossary.4446"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}<span class="comment">% </span>
<span class="comment">% Default plural suffix if the plural isn't explicitly set</span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4450"></a><a href="#glo:acrpluralsuffix"><code class="csfmt">\acrpluralsuffix</code></a>}{<a id="wrglossary.4451"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4447"></a><a href="#glo:acrpluralsuffix"><code class="csfmt">\acrpluralsuffix</code></a>}{<a id="wrglossary.4448"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}<span class="comment">% </span>
}
</pre>
Remember that the new style needs to be set before defining any
terms:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4452"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{mystyle}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4449"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{mystyle}
</pre>
<p>
-Since it may be a bit confusing to use <a id="wrglossary.4453"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> for something
+Since it may be a bit confusing to use <a id="wrglossary.4450"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> for something
that’s not technically an acronym, let’s define a new command for
initialisms:
<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">\newinitialism</code>}[4][]{<span class="comment">% </span>
- <a id="wrglossary.4454"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[abbrtype=initialism,#1]{#2}{#3}{#4}<span class="comment">% </span>
+ <a id="wrglossary.4451"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[abbrtype=initialism,#1]{#2}{#3}{#4}<span class="comment">% </span>
}
</pre>
-Now the <a id="wrglossary.4455"></a><a href="#glo:idx.glossaryentry">entries</a> can all be defined:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4456"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{radar}{radar}{radio detecting and ranging}
-<a id="wrglossary.4457"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{laser}{laser}{light amplification by stimulated
+Now the <a id="wrglossary.4452"></a><a href="#glo:idx.glossaryentry">entries</a> can all be defined:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4453"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{radar}{radar}{radio detecting and ranging}
+<a id="wrglossary.4454"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{laser}{laser}{light amplification by stimulated
emission of radiation}
-<a id="wrglossary.4458"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{scuba}{scuba}{self-contained underwater breathing
+<a id="wrglossary.4455"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{scuba}{scuba}{self-contained underwater breathing
apparatus}
<code class="cmd">\newinitialism</code>{dsp}{DSP}{digital signal processing}
<code class="cmd">\newinitialism</code>{atm}{ATM}{automated teller machine}
</pre>
-On <a id="wrglossary.4459"></a><a href="#glo:dual.firstuse">first use</a>, <code class="code"><a id="wrglossary.4460"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{radar}</code> will produce <span class="qt">“radar (radio
-detecting and ranging)”</span> but <code class="code"><a id="wrglossary.4461"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{dsp}</code> will produce <span class="qt">“DSP
+On <a id="wrglossary.4456"></a><a href="#glo:dual.firstuse">first use</a>, <code class="code"><a id="wrglossary.4457"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{radar}</code> will produce <span class="qt">“radar (radio
+detecting and ranging)”</span> but <code class="code"><a id="wrglossary.4458"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{dsp}</code> will produce <span class="qt">“DSP
(digital signal processing)”</span>.
<p>
For a complete document, see the sample file
-<a id="wrglossary.4462"></a><a href="#glo:file.sample-storage-abbr.tex"><span class="filefmt">sample-storage-abbr.tex</span></a>.
+<a id="wrglossary.4459"></a><a href="#glo:file.sample-storage-abbr.tex"><span class="filefmt">sample-storage-abbr.tex</span></a>.
</div>
<p>
-In the above example, if <a id="wrglossary.4463"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is explicitly used
-(instead of through <a id="wrglossary.4464"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>) the <span class="optfmt">abbrtype</span> key will
-be set to its default value of <span class="qt">“word”</span> but the <a id="wrglossary.4465"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>
-test in the custom <a id="wrglossary.4466"></a><a href="#glo:idx.acronymstyle">acronym style</a> will be false (since the
-<a id="wrglossary.4467"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key hasn’t been set) so the <a id="wrglossary.4468"></a><a href="#glo:idx.entryformat">display style</a> will switch
-to that given by <a id="wrglossary.4469"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> and they’ll be no test
+In the above example, if <a id="wrglossary.4460"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is explicitly used
+(instead of through <a id="wrglossary.4461"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>) the <span class="optfmt">abbrtype</span> key will
+be set to its default value of <span class="qt">“word”</span> but the <a id="wrglossary.4462"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>
+test in the custom <a id="wrglossary.4463"></a><a href="#glo:idx.acronymstyle">acronym style</a> will be false (since the
+<a id="wrglossary.4464"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key hasn’t been set) so the <a id="wrglossary.4465"></a><a href="#glo:idx.entryformat">display style</a> will switch
+to that given by <a id="wrglossary.4466"></a><a href="#glo:glsgenentryfmt"><code class="csfmt">\glsgenentryfmt</code></a> and they’ll be no test
performed on the <span class="optfmt">abbrtype</span> field.
<p>
<div class="example" id="ex:addstoragekey2"><div class="title">Example 15: Defining Custom Storage Key (Acronyms and
Non-Acronyms with Descriptions)</div>
-The previous example can be modified if the <a id="wrglossary.4470"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>
+The previous example can be modified if the <a id="wrglossary.4467"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>
also needs to be provided. Here I’ve changed <span class="qt">“word”</span> to
<span class="qt">“acronym”</span>:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4471"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4468"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a>
{abbrtype}<span class="comment">% key/field name</span>
{acronym}<span class="comment">% default value if not explicitly set</span>
{<code class="cmd">\abbrtype</code>}<span class="comment">% custom command to access the value if required</span>
</pre>
-This may seem a little odd for non-abbreviated <a id="wrglossary.4472"></a><a href="#glo:idx.glossaryentry">entries</a> that are defined using
-<a id="wrglossary.4473"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> directly, but <a id="wrglossary.4474"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> can be used
+This may seem a little odd for non-abbreviated <a id="wrglossary.4469"></a><a href="#glo:idx.glossaryentry">entries</a> that are defined using
+<a id="wrglossary.4470"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> directly, but <a id="wrglossary.4471"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> can be used
to determine whether or not to reference the value of this new
<span class="optfmt">abbrtype</span> field.
<p>
-The new <a id="wrglossary.4475"></a><a href="#glo:idx.acronymstyle">acronym style</a> has a minor modification that forces the user
+The new <a id="wrglossary.4472"></a><a href="#glo:idx.acronymstyle">acronym style</a> has a minor modification that forces the user
to specify a description. In the previous example, the line:
-<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.4476"></a><a href="#glo:GenericAcronymFields"><code class="csfmt">\GenericAcronymFields</code></a>}{<span class="comment">% </span>
- <a id="wrglossary.4477"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4478"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}</span>}<span class="comment">% </span>
+<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.4473"></a><a href="#glo:GenericAcronymFields"><code class="csfmt">\GenericAcronymFields</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.4474"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<code class="cmd">\the</code><a id="wrglossary.4475"></a><a href="#glo:glslongtok"><code class="csfmt">\glslongtok</code></a>}</span>}<span class="comment">% </span>
</pre>
needs to be changed to:
-<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.4479"></a><a href="#glo:GenericAcronymFields"><code class="csfmt">\GenericAcronymFields</code></a>}{}<span class="comment">% </span>
+<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.4476"></a><a href="#glo:GenericAcronymFields"><code class="csfmt">\GenericAcronymFields</code></a>}{}<span class="comment">% </span>
</pre>
Additionally, to accommodate the change in the default value of the
<span class="optfmt">abbrtype</span> key, all instances of
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4480"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4481"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4477"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4478"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{word}
</pre>
need to be changed to:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4482"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4483"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{acronym}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4479"></a><a href="#glo:ifglsfieldeq"><code class="csfmt">\ifglsfieldeq</code></a>{<a id="wrglossary.4480"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{abbrtype}{acronym}
</pre>
<p>
-Once this new <a id="wrglossary.4484"></a><a href="#glo:idx.acronymstyle">style</a> has been set, the new acronyms can be defined
+Once this new <a id="wrglossary.4481"></a><a href="#glo:idx.acronymstyle">style</a> has been set, the new acronyms can be defined
using the optional argument to set the description:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4485"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.4486"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={system for detecting the position and
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4482"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.4483"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={system for detecting the position and
speed of aircraft, ships, etc}</span>]{radar}{radar}{radio detecting
and ranging}
</pre>
@@ -13254,7 +13258,7 @@
<p>
No change is required for the definition of <code class="cmd">\newinitialism</code> but
again the optional argument is required to set the description:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newinitialism</code>[<a id="wrglossary.4487"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={mathematical manipulation of an
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newinitialism</code>[<a id="wrglossary.4484"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={mathematical manipulation of an
information signal}</span>]{dsp}{DSP}{digital signal processing}
</pre>
<p>
@@ -13261,46 +13265,46 @@
We can also accommodate contractions in a similar manner to the
initialisms:
<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">\newcontraction</code>}[4][]{<span class="comment">% </span>
- <a id="wrglossary.4488"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[abbrtype=contraction,#1]{#2}{#3}{#4}<span class="comment">% </span>
+ <a id="wrglossary.4485"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[abbrtype=contraction,#1]{#2}{#3}{#4}<span class="comment">% </span>
}
</pre>
The contractions can similarly been defined using this new command:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcontraction</code>[<a id="wrglossary.4489"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={front part of a ship below the
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcontraction</code>[<a id="wrglossary.4486"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={front part of a ship below the
deck}</span>]{focsle}{fo'c's'le}{forecastle}
</pre>
<p>
-Since the custom <a id="wrglossary.4490"></a><a href="#glo:idx.acronymstyle">acronym style</a> just checks if <span class="optfmt">abbrtype</span> is
+Since the custom <a id="wrglossary.4487"></a><a href="#glo:idx.acronymstyle">acronym style</a> just checks if <span class="optfmt">abbrtype</span> is
<span class="qt">“acronym”</span>, the contractions will be treated the same as the
-initialisms, but the <a id="wrglossary.4491"></a><a href="#glo:idx.acronymstyle">style</a> could be modified by a further test of
+initialisms, but the <a id="wrglossary.4488"></a><a href="#glo:idx.acronymstyle">style</a> could be modified by a further test of
the <span class="optfmt">abbrtype</span> value if required.
<p>
To test regular non-abbreviated entries, I’ve also defined a simple
word:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4492"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{apple}{<a id="wrglossary.4493"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={apple}</span>,<a id="wrglossary.4494"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fruit}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4489"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{apple}{<a id="wrglossary.4490"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={apple}</span>,<a id="wrglossary.4491"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a fruit}</span>}
</pre>
<p>
-Now for a new <a id="wrglossary.4495"></a><a href="#glo:idx.glossarystyle">glossary style</a> that provides information about the
+Now for a new <a id="wrglossary.4492"></a><a href="#glo:idx.glossarystyle">glossary style</a> that provides information about the
abbreviation (in addition to the description):
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4496"></a><a href="#glo:newglossarystyle"><code class="csfmt">\newglossarystyle</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4493"></a><a href="#glo:newglossarystyle"><code class="csfmt">\newglossarystyle</code></a>
{mystyle}<span class="comment">% style name</span>
{<span class="comment">% base it on the "list" style</span>
- <a id="wrglossary.4497"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{list}<span class="comment">% </span>
- <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4498"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a>}[2]{<span class="comment">% </span>
- <a id="wrglossary.4499"></a><a href="#glo:item"><code class="csfmt">\item</code></a>[<a id="wrglossary.4500"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>{<a id="wrglossary.4501"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
- <a id="wrglossary.4502"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>{<a id="wrglossary.4503"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{<a id="wrglossary.4504"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{<a id="wrglossary.4505"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}]
- <a id="wrglossary.4506"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.4507"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
- { (<code class="cmd">\abbrtype</code>{<a id="wrglossary.4508"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}: <a id="wrglossary.4509"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4510"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<a id="wrglossary.4511"></a><a href="#glo:space"><code class="csfmt">\space</code></a>}{}<span class="comment">% </span>
- <a id="wrglossary.4512"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{<a id="wrglossary.4513"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4514"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a><a id="wrglossary.4515"></a><a href="#glo:space"><code class="csfmt">\space</code></a> <a id="wrglossary.4516"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2}<span class="comment">% </span>
+ <a id="wrglossary.4494"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{list}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.4495"></a><a href="#glo:glossentry"><code class="csfmt">\glossentry</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.4496"></a><a href="#glo:item"><code class="csfmt">\item</code></a>[<a id="wrglossary.4497"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>{<a id="wrglossary.4498"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
+ <a id="wrglossary.4499"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>{<a id="wrglossary.4500"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}{<a id="wrglossary.4501"></a><a href="#glo:glossentryname"><code class="csfmt">\glossentryname</code></a>{<a id="wrglossary.4502"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}}]
+ <a id="wrglossary.4503"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.4504"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<span class="comment">% </span>
+ { (<code class="cmd">\abbrtype</code>{<a id="wrglossary.4505"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}: <a id="wrglossary.4506"></a><a href="#glo:glsentrylong"><code class="csfmt">\glsentrylong</code></a>{<a id="wrglossary.4507"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1})<a id="wrglossary.4508"></a><a href="#glo:space"><code class="csfmt">\space</code></a>}{}<span class="comment">% </span>
+ <a id="wrglossary.4509"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{<a id="wrglossary.4510"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>1}<a id="wrglossary.4511"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a><a id="wrglossary.4512"></a><a href="#glo:space"><code class="csfmt">\space</code></a> <a id="wrglossary.4513"></a><a href="#glo:idx.sym.hashhash"><code class="code">##</code></a>2}<span class="comment">% </span>
}
</pre>
-This uses <a id="wrglossary.4517"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> to determine whether or not the term is
-an abbreviation. (An alternative is to use <a id="wrglossary.4518"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>. The
-<a id="wrglossary.4519"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> and <a id="wrglossary.4520"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> keys are only set for
-<a id="wrglossary.4521"></a><a href="#glo:idx.acronym">acronyms</a>/<a id="wrglossary.4522"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a>.)
+This uses <a id="wrglossary.4514"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> to determine whether or not the term is
+an abbreviation. (An alternative is to use <a id="wrglossary.4515"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>. The
+<a id="wrglossary.4516"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> and <a id="wrglossary.4517"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> keys are only set for
+<a id="wrglossary.4518"></a><a href="#glo:idx.acronym">acronyms</a>/<a id="wrglossary.4519"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a>.)
<p>
-If the entry has an <a id="wrglossary.4523"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>/<a id="wrglossary.4524"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> value, the full form is
+If the entry has an <a id="wrglossary.4520"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>/<a id="wrglossary.4521"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> value, the full form is
supplied in parentheses and <code class="csfmt">\abbrtype</code> (defined by
-<a id="wrglossary.4525"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> earlier) is used to indicate the type of
+<a id="wrglossary.4522"></a><a href="#glo:glsaddstoragekey"><code class="csfmt">\glsaddstoragekey</code></a> earlier) is used to indicate the type of
abbreviation.
<p>
With this style set, the <span class="qt">“apple”</span> entry is simply displayed in
@@ -13342,7 +13346,7 @@
(for contractions).
<p>
-For a complete document, see <a id="wrglossary.4526"></a><a href="#glo:file.sample-storage-abbr-desc.tex"><span class="filefmt">sample-storage-abbr-desc.tex</span></a>.
+For a complete document, see <a id="wrglossary.4523"></a><a href="#glo:file.sample-storage-abbr-desc.tex"><span class="filefmt">sample-storage-abbr-desc.tex</span></a>.
</div>
<p>
@@ -13352,21 +13356,21 @@
<h2><!-- start of section header -->4.4. Expansion<span class="labellink"><a href="#sec:expansion">[link]</a></span></h2><!-- end of section header -->
<p>
-When you define new <a id="wrglossary.4527"></a><a href="#glo:idx.glossaryentry">glossary entries</a> expansion is performed by
-default, except for the <a id="wrglossary.4528"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4529"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>,
-<a id="wrglossary.4530"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a>, <a id="wrglossary.4531"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a>, <a id="wrglossary.4532"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a>
-and <a id="wrglossary.4533"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> keys (these keys all have expansion suppressed via
-<a id="wrglossary.4534"></a><a href="#glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></a>).
+When you define new <a id="wrglossary.4524"></a><a href="#glo:idx.glossaryentry">glossary entries</a> expansion is performed by
+default, except for the <a id="wrglossary.4525"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, <a id="wrglossary.4526"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a>,
+<a id="wrglossary.4527"></a><a href="#glo:opt.gloskey.descriptionplural"><span class="csoptfmt">descriptionplural</span></a>, <a id="wrglossary.4528"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a>, <a id="wrglossary.4529"></a><a href="#glo:opt.gloskey.symbolplural"><span class="csoptfmt">symbolplural</span></a>
+and <a id="wrglossary.4530"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> keys (these keys all have expansion suppressed via
+<a id="wrglossary.4531"></a><a href="#glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></a>).
<p>
You can switch expansion on or off for individual keys 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.4535"></a><code class="code"><dfn id="glo:glssetexpandfield"><code class="csfmt">\glssetexpandfield</code></dfn>{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4532"></a><code class="code"><dfn id="glo:glssetexpandfield"><code class="csfmt">\glssetexpandfield</code></dfn>{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code></div><!-- end of pinnedbox -->
or
<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.4536"></a><code class="code"><dfn id="glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></dfn>{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4533"></a><code class="code"><dfn id="glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></dfn>{<span class="meta">〈<em class="metainner">field</em>〉</span>}</code></div><!-- end of pinnedbox -->
-respectively, where <span class="meta">〈<em class="metainner">field</em>〉</span> is the <a id="wrglossary.4537"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> corresponding to
+respectively, where <span class="meta">〈<em class="metainner">field</em>〉</span> is the <a id="wrglossary.4534"></a><a href="#glo:dual.internalfieldlabel">internal field label</a> corresponding to
the key. In most cases, this is the same as the name of the key
except for those listed in Table <a href="#tab:fieldmap">4.1</a>.
<p>
@@ -13406,21 +13410,21 @@
<p>
Any keys that haven’t had the expansion explicitly set using
-<a id="wrglossary.4538"></a><a href="#glo:glssetexpandfield"><code class="csfmt">\glssetexpandfield</code></a> or <a id="wrglossary.4539"></a><a href="#glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></a> are governed by
+<a id="wrglossary.4535"></a><a href="#glo:glssetexpandfield"><code class="csfmt">\glssetexpandfield</code></a> or <a id="wrglossary.4536"></a><a href="#glo:glssetnoexpandfield"><code class="csfmt">\glssetnoexpandfield</code></a> are governed 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.4540"></a><code class="code"><dfn id="glo:glsexpandfields"><code class="csfmt">\glsexpandfields</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4537"></a><code class="code"><dfn id="glo:glsexpandfields"><code class="csfmt">\glsexpandfields</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.4541"></a><code class="code"><dfn id="glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4538"></a><code class="code"><dfn id="glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></dfn></code></div><!-- end of pinnedbox -->
<p>
If your entries contain any fragile commands, I recommend you switch
-off expansion via <a id="wrglossary.4542"></a><a href="#glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></a>. (This should be used
+off expansion via <a id="wrglossary.4539"></a><a href="#glo:glsnoexpandfields"><code class="csfmt">\glsnoexpandfields</code></a>. (This should be used
before you define the entries.)
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-Both <a id="wrglossary.4543"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and <a id="wrglossary.4544"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> partially suppress
+Both <a id="wrglossary.4540"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and <a id="wrglossary.4541"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> partially suppress
expansion of some keys regardless of the above expansion settings.
</div><!-- end of information -->
@@ -13432,64 +13436,64 @@
<h2><!-- start of section header -->4.5. Sub-Entries<span class="labellink"><a href="#sec:subentries">[link]</a></span></h2><!-- end of section header -->
<p>
-A <a id="wrglossary.4545"></a><dfn id="glo:idx.sub-entry">sub-entry</dfn> is created by setting the <a id="wrglossary.4546"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key. These
+A <a id="wrglossary.4542"></a><dfn id="glo:idx.sub-entry">sub-entry</dfn> is created by setting the <a id="wrglossary.4543"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key. These
will normally be sorted so that they are placed immediately after
-their parent <a id="wrglossary.4547"></a><a href="#glo:idx.glossaryentry">entry</a>. However, some sort methods aren’t suitable when
-there are <a id="wrglossary.4548"></a><a href="#glo:idx.sub-entry">sub-entries</a>. In particular, <a id="wrglossary.4549"></a><a href="#glo:idx.sub-entry">sub-entries</a> are problematic
-with <a id="wrglossary.4550"></a><a href="#glo:idx.opt.noidx">Option 1</a>, and with <a id="wrglossary.4551"></a><a href="#glo:idx.opt.unsrt">Option 5</a> the <a id="wrglossary.4552"></a><a href="#glo:idx.sub-entry">sub-entries</a> must
-be defined immediately after their parent <a id="wrglossary.4553"></a><a href="#glo:idx.glossaryentry">entry</a> (rather than at any
-point after the parent <a id="wrglossary.4554"></a><a href="#glo:idx.glossaryentry">entry</a> has been defined).
+their parent <a id="wrglossary.4544"></a><a href="#glo:idx.glossaryentry">entry</a>. However, some sort methods aren’t suitable when
+there are <a id="wrglossary.4545"></a><a href="#glo:idx.sub-entry">sub-entries</a>. In particular, <a id="wrglossary.4546"></a><a href="#glo:idx.sub-entry">sub-entries</a> are problematic
+with <a id="wrglossary.4547"></a><a href="#glo:idx.opt.noidx">Option 1</a>, and with <a id="wrglossary.4548"></a><a href="#glo:idx.opt.unsrt">Option 5</a> the <a id="wrglossary.4549"></a><a href="#glo:idx.sub-entry">sub-entries</a> must
+be defined immediately after their parent <a id="wrglossary.4550"></a><a href="#glo:idx.glossaryentry">entry</a> (rather than at any
+point after the parent <a id="wrglossary.4551"></a><a href="#glo:idx.glossaryentry">entry</a> has been defined).
<p>
-The <a id="wrglossary.4555"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> indicates the <a id="wrglossary.4556"></a><a href="#glo:idx.sub-entry">sub-entry</a> level. An
-<a id="wrglossary.4557"></a><a href="#glo:idx.glossaryentry">entry</a> with no parent (a top level entry) is a <a id="wrglossary.4558"></a><a href="#glo:dual.hierarchicallevel">hierarchical level 0</a>
-entry. An <a id="wrglossary.4559"></a><a href="#glo:idx.glossaryentry">entry</a> with a parent has a <a id="wrglossary.4560"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> that’s
+The <a id="wrglossary.4552"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> indicates the <a id="wrglossary.4553"></a><a href="#glo:idx.sub-entry">sub-entry</a> level. An
+<a id="wrglossary.4554"></a><a href="#glo:idx.glossaryentry">entry</a> with no parent (a top level entry) is a <a id="wrglossary.4555"></a><a href="#glo:dual.hierarchicallevel">hierarchical level 0</a>
+entry. An <a id="wrglossary.4556"></a><a href="#glo:idx.glossaryentry">entry</a> with a parent has a <a id="wrglossary.4557"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> that’s
one more than its parent’s level. The level is calculated when an
-<a id="wrglossary.4561"></a><a href="#glo:idx.glossaryentry">entry</a> is defined.
+<a id="wrglossary.4558"></a><a href="#glo:idx.glossaryentry">entry</a> is defined.
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.4562"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> is stored in the <a id="wrglossary.4563"></a><a href="#glo:opt.glosfield.level"><span class="csoptfmt">level</span></a>
+The <a id="wrglossary.4559"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> is stored in the <a id="wrglossary.4560"></a><a href="#glo:opt.glosfield.level"><span class="csoptfmt">level</span></a>
internal field. It can be accessed using commands like
-<a id="wrglossary.4564"></a><a href="#glo:glsfieldfetch"><code class="csfmt">\glsfieldfetch</code></a> or (with <a id="wrglossary.4565"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>)
-<a id="wrglossary.4566"></a><a href="#glo:glsxtrusefield"><code class="xtrcsfmt">\glsxtrusefield</code></a>, but neither the <a id="wrglossary.4567"></a><a href="#glo:opt.glosfield.level"><span class="csoptfmt">level</span></a> nor the
-<a id="wrglossary.4568"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> values should be altered as it can cause
-inconsistencies in the sorting and <a id="wrglossary.4569"></a><a href="#glo:dual.glossary">glossary</a> formatting. The
-<a id="wrglossary.4570"></a><a href="#glo:dual.indexing">indexing</a> syntax for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> is generated when the
+<a id="wrglossary.4561"></a><a href="#glo:glsfieldfetch"><code class="csfmt">\glsfieldfetch</code></a> or (with <a id="wrglossary.4562"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>)
+<a id="wrglossary.4563"></a><a href="#glo:glsxtrusefield"><code class="xtrcsfmt">\glsxtrusefield</code></a>, but neither the <a id="wrglossary.4564"></a><a href="#glo:opt.glosfield.level"><span class="csoptfmt">level</span></a> nor the
+<a id="wrglossary.4565"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> values should be altered as it can cause
+inconsistencies in the sorting and <a id="wrglossary.4566"></a><a href="#glo:dual.glossary">glossary</a> formatting. The
+<a id="wrglossary.4567"></a><a href="#glo:dual.indexing">indexing</a> syntax for Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a> is generated when the
entry is first defined, so it’s too late to change the hierarchy
-after that, and <a id="wrglossary.4571"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> obtains the hierarchical
-information from the <a id="wrglossary.4572"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files and the resource options.
-Note, however, that <a id="wrglossary.4573"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> does allow the ability to
-locally alter the level with the <a id="wrglossary.4574"></a><a href="#glo:opt.printgloss.leveloffset"><span class="xtrcsoptfmt">leveloffset</span></a> option,
-which is mainly intended for nested <a id="wrglossary.4575"></a><a href="#glo:dual.glossary">glossary</a>. See the
-<a id="wrglossary.4576"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details and also
+after that, and <a id="wrglossary.4568"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> obtains the hierarchical
+information from the <a id="wrglossary.4569"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files and the resource options.
+Note, however, that <a id="wrglossary.4570"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> does allow the ability to
+locally alter the level with the <a id="wrglossary.4571"></a><a href="#glo:opt.printgloss.leveloffset"><span class="xtrcsoptfmt">leveloffset</span></a> option,
+which is mainly intended for nested <a id="wrglossary.4572"></a><a href="#glo:dual.glossary">glossary</a>. See the
+<a id="wrglossary.4573"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details and also
<a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-inner">Gallery: Inner or Nested Glossaries</a>.
</div><!-- end of information -->
<p>
-There are two different types of <a id="wrglossary.4577"></a><a href="#glo:idx.sub-entry">sub-entries</a>: those that have the
-same name as their parent (<a id="wrglossary.4578"></a><a href="#glo:dual.homograph">homographs</a>, see
+There are two different types of <a id="wrglossary.4574"></a><a href="#glo:idx.sub-entry">sub-entries</a>: those that have the
+same name as their parent (<a id="wrglossary.4575"></a><a href="#glo:dual.homograph">homographs</a>, see
§<a href="#sec:homographs">4.5.2</a>) and those that establish a hierarchy
(see §<a href="#sec:hierarchical">4.5.1</a>). Both types are considered
-<a id="wrglossary.4579"></a><a href="#glo:hierarchicallevel">hierarchical</a> entries from the point of view of the <a id="wrglossary.4580"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
-package and the <a id="wrglossary.4581"></a><a href="#glo:dual.indexingapp">indexing applications</a>, but typically <a id="wrglossary.4582"></a><a href="#glo:dual.homograph">homographs</a>
-will have the <a id="wrglossary.4583"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key obtained from the parent, rather
-than have it explicitly set, and have a maximum <a id="wrglossary.4584"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> of 1.
+<a id="wrglossary.4576"></a><a href="#glo:hierarchicallevel">hierarchical</a> entries from the point of view of the <a id="wrglossary.4577"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+package and the <a id="wrglossary.4578"></a><a href="#glo:dual.indexingapp">indexing applications</a>, but typically <a id="wrglossary.4579"></a><a href="#glo:dual.homograph">homographs</a>
+will have the <a id="wrglossary.4580"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key obtained from the parent, rather
+than have it explicitly set, and have a maximum <a id="wrglossary.4581"></a><a href="#glo:dual.hierarchicallevel">hierarchical level</a> of 1.
<p>
-Not all <a id="wrglossary.4585"></a><a href="#glo:idx.glossarystyle">glossary styles</a> support <a id="wrglossary.4586"></a><a href="#glo:hierarchicallevel">hierarchical</a> entries and
-may display all the <a id="wrglossary.4587"></a><a href="#glo:idx.glossaryentry">entries</a> in a flat format. Of the
-<a id="wrglossary.4588"></a><a href="#glo:idx.glossarystyle">styles</a> that support <a id="wrglossary.4589"></a><a href="#glo:idx.sub-entry">sub-entries</a>, some
-display the <a id="wrglossary.4590"></a><a href="#glo:idx.sub-entry">sub-entry’s</a> name whilst others don’t. Therefore
+Not all <a id="wrglossary.4582"></a><a href="#glo:idx.glossarystyle">glossary styles</a> support <a id="wrglossary.4583"></a><a href="#glo:hierarchicallevel">hierarchical</a> entries and
+may display all the <a id="wrglossary.4584"></a><a href="#glo:idx.glossaryentry">entries</a> in a flat format. Of the
+<a id="wrglossary.4585"></a><a href="#glo:idx.glossarystyle">styles</a> that support <a id="wrglossary.4586"></a><a href="#glo:idx.sub-entry">sub-entries</a>, some
+display the <a id="wrglossary.4587"></a><a href="#glo:idx.sub-entry">sub-entry’s</a> name whilst others don’t. Therefore
you need to ensure that you use a suitable
-<a id="wrglossary.4591"></a><a href="#glo:idx.glossarystyle">style</a>. (See §<a href="#sec:styles">13</a> for a list
-of predefined <a id="wrglossary.4592"></a><a href="#glo:idx.glossarystyle">glossary styles</a>.) If you want <a id="wrglossary.4593"></a><a href="#glo:hierarchicallevel">level 1</a>
-<a id="wrglossary.4594"></a><a href="#glo:idx.sub-entry">sub-entries</a> automatically numbered (in <a id="wrglossary.4595"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that
-support it) use the <a id="wrglossary.4596"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> package option (see
+<a id="wrglossary.4588"></a><a href="#glo:idx.glossarystyle">style</a>. (See §<a href="#sec:styles">13</a> for a list
+of predefined <a id="wrglossary.4589"></a><a href="#glo:idx.glossarystyle">glossary styles</a>.) If you want <a id="wrglossary.4590"></a><a href="#glo:hierarchicallevel">level 1</a>
+<a id="wrglossary.4591"></a><a href="#glo:idx.sub-entry">sub-entries</a> automatically numbered (in <a id="wrglossary.4592"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that
+support it) use the <a id="wrglossary.4593"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> package option (see
§<a href="#sec:pkgopts-printglos">2.3</a> for further details).
<p>
-Note that the parent <a id="wrglossary.4597"></a><a href="#glo:idx.glossaryentry">entry</a> will automatically be added to the
-<a id="wrglossary.4598"></a><a href="#glo:dual.glossary">glossary</a> if any of its child <a id="wrglossary.4599"></a><a href="#glo:idx.glossaryentry">entries</a> are used in the document.
-If the parent <a id="wrglossary.4600"></a><a href="#glo:idx.glossaryentry">entry</a> is not referenced in the document, it will not
-have a <a id="wrglossary.4601"></a><a href="#glo:locationlist">number list</a>. Note also that <a id="wrglossary.4602"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> has a
-restriction on the maximum <a id="wrglossary.4603"></a><a href="#glo:hierarchicallevel">hierarchical</a> depth.
+Note that the parent <a id="wrglossary.4594"></a><a href="#glo:idx.glossaryentry">entry</a> will automatically be added to the
+<a id="wrglossary.4595"></a><a href="#glo:dual.glossary">glossary</a> if any of its child <a id="wrglossary.4596"></a><a href="#glo:idx.glossaryentry">entries</a> are used in the document.
+If the parent <a id="wrglossary.4597"></a><a href="#glo:idx.glossaryentry">entry</a> is not referenced in the document, it will not
+have a <a id="wrglossary.4598"></a><a href="#glo:locationlist">number list</a>. Note also that <a id="wrglossary.4599"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> has a
+restriction on the maximum <a id="wrglossary.4600"></a><a href="#glo:hierarchicallevel">hierarchical</a> depth.
<p>
</section><!-- end of section sec:subentries -->
@@ -13498,11 +13502,11 @@
<h3><!-- start of subsection header -->4.5.1. Hierarchy<span class="labellink"><a href="#sec:hierarchical">[link]</a></span></h3><!-- end of subsection header -->
<p>
-To create a <a id="wrglossary.4604"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.4605"></a><a href="#glo:hierarchicallevel">hierarchical</a> divisions, you need
-to first define the division, which will be a <a id="wrglossary.4606"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entry, and
-then define the <a id="wrglossary.4607"></a><a href="#glo:idx.sub-entry">sub-entries</a> using the relevant higher level
-entry as the value of the <a id="wrglossary.4608"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key. (In a
-<a id="wrglossary.4609"></a><a href="#glo:hierarchicallevel">hierarchical</a> context, a higher level indicates a numerically
+To create a <a id="wrglossary.4601"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.4602"></a><a href="#glo:hierarchicallevel">hierarchical</a> divisions, you need
+to first define the division, which will be a <a id="wrglossary.4603"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entry, and
+then define the <a id="wrglossary.4604"></a><a href="#glo:idx.sub-entry">sub-entries</a> using the relevant higher level
+entry as the value of the <a id="wrglossary.4605"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key. (In a
+<a id="wrglossary.4606"></a><a href="#glo:hierarchicallevel">hierarchical</a> context, a higher level indicates a numerically
smaller level number, so level 0 is one level higher than level 1.)
The top level entry may represent, for example, a topic or
classification. A level 1 entry may represent, for example, a
@@ -13511,38 +13515,38 @@
<div class="example" id="ex:hierarchical"><div class="title">Example 16: Hierarchical Divisions—Greek and Roman
Mathematical Symbols</div>
<p>
-Suppose I want a <a id="wrglossary.4610"></a><a href="#glo:dual.glossary">glossary</a> of mathematical symbols that
+Suppose I want a <a id="wrglossary.4607"></a><a href="#glo:dual.glossary">glossary</a> of mathematical symbols that
are divided into Greek letters and Roman letters. Then I can define
the divisions as follows:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4611"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{greekletter}{<a id="wrglossary.4612"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Greek letters}</span>,
-<a id="wrglossary.4613"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4614"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4608"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{greekletter}{<a id="wrglossary.4609"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Greek letters}</span>,
+<a id="wrglossary.4610"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4611"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>}
-<a id="wrglossary.4615"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>romanletter{<a id="wrglossary.4616"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Roman letters}</span>,
-<a id="wrglossary.4617"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4618"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>}
+<a id="wrglossary.4612"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>romanletter{<a id="wrglossary.4613"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Roman letters}</span>,
+<a id="wrglossary.4614"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4615"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>}
</pre>
<p>
Note that in this example, the top level entries don’t need a
-description so I have set the descriptions to <a id="wrglossary.4619"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>.
+description so I have set the descriptions to <a id="wrglossary.4616"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>.
This gives a blank description and suppresses the
description terminator.
<p>
-I can now define my <a id="wrglossary.4620"></a><a href="#glo:idx.sub-entry">sub-entries</a> as follows:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4621"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pi}<a id="wrglossary.4622"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4623"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\pi</code>}}</span>,<a id="wrglossary.4624"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={pi}</span>,
-<a id="wrglossary.4625"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ratio of the circumference of a circle to
+I can now define my <a id="wrglossary.4617"></a><a href="#glo:idx.sub-entry">sub-entries</a> as follows:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4618"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{pi}<a id="wrglossary.4619"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4620"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\pi</code>}}</span>,<a id="wrglossary.4621"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={pi}</span>,
+<a id="wrglossary.4622"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ratio of the circumference of a circle to
the diameter}</span>,
-<a id="wrglossary.4626"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={greekletter}</span>
+<a id="wrglossary.4623"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={greekletter}</span>
-<a id="wrglossary.4627"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{C}{<a id="wrglossary.4628"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4629"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{C}}</span>,<a id="wrglossary.4630"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={C}</span>,
-<a id="wrglossary.4631"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Euler's constant}</span>,
-<a id="wrglossary.4632"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={romanletter}</span>}
+<a id="wrglossary.4624"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{C}{<a id="wrglossary.4625"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.4626"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{C}}</span>,<a id="wrglossary.4627"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={C}</span>,
+<a id="wrglossary.4628"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Euler's constant}</span>,
+<a id="wrglossary.4629"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={romanletter}</span>}
</pre>
-For a complete document, see the sample file <a id="wrglossary.4633"></a><a href="#glo:file.sampletree.tex"><span class="filefmt">sampletree.tex</span></a>.
+For a complete document, see the sample file <a id="wrglossary.4630"></a><a href="#glo:file.sampletree.tex"><span class="filefmt">sampletree.tex</span></a>.
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.4634"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.4631"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-If you want to switch to <a id="wrglossary.4635"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, you will need to move the
-definitions of the <a id="wrglossary.4636"></a><a href="#glo:idx.sub-entry">sub-entries</a> to immediately after the definition
-of their parent <a id="wrglossary.4637"></a><a href="#glo:idx.glossaryentry">entry</a>. So, in this case, <span class="qt">“pi”</span> needs to be defined
+If you want to switch to <a id="wrglossary.4632"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, you will need to move the
+definitions of the <a id="wrglossary.4633"></a><a href="#glo:idx.sub-entry">sub-entries</a> to immediately after the definition
+of their parent <a id="wrglossary.4634"></a><a href="#glo:idx.glossaryentry">entry</a>. So, in this case, <span class="qt">“pi”</span> needs to be defined
after <span class="qt">“greekletter”</span> and before <span class="qt">“romanletter”</span>.
</div><!-- end of information -->
@@ -13555,62 +13559,62 @@
<h3><!-- start of subsection header -->4.5.2. Homographs<span class="labellink"><a href="#sec:homographs">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<a id="wrglossary.4638"></a><a id="wrglossary.4639"></a><a href="#glo:idx.sub-entry">Sub-entries</a> that have the same name as the parent <a id="wrglossary.4640"></a><a href="#glo:idx.glossaryentry">entry</a> don’t need
-to have the <a id="wrglossary.4641"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key explicitly set. For example, the word <span class="qt">“glossary”</span>
+<a id="wrglossary.4635"></a><a id="wrglossary.4636"></a><a href="#glo:idx.sub-entry">Sub-entries</a> that have the same name as the parent <a id="wrglossary.4637"></a><a href="#glo:idx.glossaryentry">entry</a> don’t need
+to have the <a id="wrglossary.4638"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key explicitly set. For example, the word <span class="qt">“glossary”</span>
can mean a list of technical words or a collection of glosses. In
both cases the plural is <span class="qt">“glossaries”</span>. So first define the parent
entry:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4642"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{glossary}{<a id="wrglossary.4643"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={glossary}</span>,
-<a id="wrglossary.4644"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4645"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>,
-<a id="wrglossary.4646"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={glossaries}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4639"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{glossary}{<a id="wrglossary.4640"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={glossary}</span>,
+<a id="wrglossary.4641"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4642"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>,
+<a id="wrglossary.4643"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={glossaries}</span>}
</pre>
As in the previous example, the parent entry has no description, so the description
-terminator needs to be suppressed using <a id="wrglossary.4647"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>.
+terminator needs to be suppressed using <a id="wrglossary.4644"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>.
<p>
Now define the two different meanings of the word with the
-<a id="wrglossary.4648"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key set to the above parent <a id="wrglossary.4649"></a><a href="#glo:idx.glossaryentry">entry</a> label:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4650"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{glossarylist}{
-<a id="wrglossary.4651"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={list of technical words}</span>,
-<a id="wrglossary.4652"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={1}</span>,
-<a id="wrglossary.4653"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={glossary}</span>}
+<a id="wrglossary.4645"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a> key set to the above parent <a id="wrglossary.4646"></a><a href="#glo:idx.glossaryentry">entry</a> label:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4647"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{glossarylist}{
+<a id="wrglossary.4648"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={list of technical words}</span>,
+<a id="wrglossary.4649"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={1}</span>,
+<a id="wrglossary.4650"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={glossary}</span>}
-<a id="wrglossary.4654"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{glossarycol}{
-<a id="wrglossary.4655"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={collection of glosses}</span>,
-<a id="wrglossary.4656"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={2}</span>,
-<a id="wrglossary.4657"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={glossary}</span>}
+<a id="wrglossary.4651"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{glossarycol}{
+<a id="wrglossary.4652"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={collection of glosses}</span>,
+<a id="wrglossary.4653"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={2}</span>,
+<a id="wrglossary.4654"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={glossary}</span>}
</pre>
-Note that if I reference the parent <a id="wrglossary.4658"></a><a href="#glo:idx.glossaryentry">entry</a> (for example,
-<code class="code"><a id="wrglossary.4659"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{glossary}</code>), the <a id="wrglossary.4660"></a><a href="#glo:dual.entrylocation">location</a> will be added to
-the parent’s <a id="wrglossary.4661"></a><a href="#glo:locationlist">number list</a>, whereas if I reference any of the
-child entries (for example, <code class="code"><a id="wrglossary.4662"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{glossarylist}</code>),
-the <a id="wrglossary.4663"></a><a href="#glo:dual.entrylocation">location</a> will be added to the child entry’s <a id="wrglossary.4664"></a><a href="#glo:locationlist">number list</a>.
-Note also that since the <a id="wrglossary.4665"></a><a href="#glo:idx.sub-entry">sub-entries</a> have the same name, the
-<a id="wrglossary.4666"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is required with <a id="wrglossary.4667"></a><a href="#glo:idx.opt.xdy">Option 3</a> (<a id="wrglossary.4668"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) and recommended
-with <a id="wrglossary.4669"></a><a href="#glo:idx.opt.mkidx">Option 2</a> (<a id="wrglossary.4670"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>). You can use the <a id="wrglossary.4671"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> package
-option to automatically number the <a id="wrglossary.4672"></a><a href="#glo:hierarchicallevel">level 1</a> child entries in the
-<a id="wrglossary.4673"></a><a href="#glo:dual.glossary">glossary</a> (if you use a <a id="wrglossary.4674"></a><a href="#glo:idx.glossarystyle">glossary style</a> that supports it).
+Note that if I reference the parent <a id="wrglossary.4655"></a><a href="#glo:idx.glossaryentry">entry</a> (for example,
+<code class="code"><a id="wrglossary.4656"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{glossary}</code>), the <a id="wrglossary.4657"></a><a href="#glo:dual.entrylocation">location</a> will be added to
+the parent’s <a id="wrglossary.4658"></a><a href="#glo:locationlist">number list</a>, whereas if I reference any of the
+child entries (for example, <code class="code"><a id="wrglossary.4659"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{glossarylist}</code>),
+the <a id="wrglossary.4660"></a><a href="#glo:dual.entrylocation">location</a> will be added to the child entry’s <a id="wrglossary.4661"></a><a href="#glo:locationlist">number list</a>.
+Note also that since the <a id="wrglossary.4662"></a><a href="#glo:idx.sub-entry">sub-entries</a> have the same name, the
+<a id="wrglossary.4663"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key is required with <a id="wrglossary.4664"></a><a href="#glo:idx.opt.xdy">Option 3</a> (<a id="wrglossary.4665"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) and recommended
+with <a id="wrglossary.4666"></a><a href="#glo:idx.opt.mkidx">Option 2</a> (<a id="wrglossary.4667"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>). You can use the <a id="wrglossary.4668"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> package
+option to automatically number the <a id="wrglossary.4669"></a><a href="#glo:hierarchicallevel">level 1</a> child entries in the
+<a id="wrglossary.4670"></a><a href="#glo:dual.glossary">glossary</a> (if you use a <a id="wrglossary.4671"></a><a href="#glo:idx.glossarystyle">glossary style</a> that supports it).
See §<a href="#sec:pkgopts-printglos">2.3</a> for further details.
<p>
In the above example, the plural form for both of the child entries
-is the same as the parent entry, so the <a id="wrglossary.4675"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key was
-not required for the child entries. However, if the <a id="wrglossary.4676"></a><a href="#glo:idx.sub-entry">sub-entries</a>
+is the same as the parent entry, so the <a id="wrglossary.4672"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a> key was
+not required for the child entries. However, if the <a id="wrglossary.4673"></a><a href="#glo:idx.sub-entry">sub-entries</a>
have different plurals, they will need to be specified. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4677"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{bravo}{<a id="wrglossary.4678"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={bravo}</span>,
-<a id="wrglossary.4679"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4680"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4674"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{bravo}{<a id="wrglossary.4675"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={bravo}</span>,
+<a id="wrglossary.4676"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.4677"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>}</span>}
-<a id="wrglossary.4681"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{bravocry}{<a id="wrglossary.4682"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={cry of approval
+<a id="wrglossary.4678"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{bravocry}{<a id="wrglossary.4679"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={cry of approval
(pl. bravos)}</span>,
-<a id="wrglossary.4683"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={1}</span>,
-<a id="wrglossary.4684"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={bravos}</span>,
-<a id="wrglossary.4685"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={bravo}</span>}
+<a id="wrglossary.4680"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={1}</span>,
+<a id="wrglossary.4681"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={bravos}</span>,
+<a id="wrglossary.4682"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={bravo}</span>}
-<a id="wrglossary.4686"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{bravoruffian}{<a id="wrglossary.4687"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={hired
+<a id="wrglossary.4683"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{bravoruffian}{<a id="wrglossary.4684"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={hired
ruffian or killer (pl. bravoes)}</span>,
-<a id="wrglossary.4688"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={2}</span>,
-<a id="wrglossary.4689"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={bravoes}</span>,
-<a id="wrglossary.4690"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={bravo}</span>}
+<a id="wrglossary.4685"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={2}</span>,
+<a id="wrglossary.4686"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a><span class="optfmt">={bravoes}</span>,
+<a id="wrglossary.4687"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={bravo}</span>}
</pre>
-For a complete document, see the sample file <a id="wrglossary.4691"></a><a href="#glo:file.sample.tex"><span class="filefmt">sample.tex</span></a>.
+For a complete document, see the sample file <a id="wrglossary.4688"></a><a href="#glo:file.sample.tex"><span class="filefmt">sample.tex</span></a>.
<p>
</section><!-- end of section sec:homographs -->
@@ -13619,45 +13623,45 @@
<h2><!-- start of section header -->4.6. Loading Entries From a File<span class="labellink"><a href="#sec:loadglsentries">[link]</a></span></h2><!-- end of section header -->
<p>
-You can store all your <a id="wrglossary.4692"></a><a href="#glo:idx.glossaryentry">glossary entry</a> definitions in another
+You can store all your <a id="wrglossary.4689"></a><a href="#glo:idx.glossaryentry">glossary entry</a> definitions in another
file and 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.4693"></a><code class="code"><dfn id="glo:loadglsentries"><code class="csfmt">\loadglsentries</code></dfn>[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">filename</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4690"></a><code class="code"><dfn id="glo:loadglsentries"><code class="csfmt">\loadglsentries</code></dfn>[<span class="meta">〈<em class="metainner">type</em>〉</span>]{<span class="meta">〈<em class="metainner">filename</em>〉</span>}</code></div><!-- end of pinnedbox -->
where <span class="meta">〈<em class="metainner">filename</em>〉</span> is the name of the file containing all the
-<a id="wrglossary.4694"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>, <a id="wrglossary.4695"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>, <a id="wrglossary.4696"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>
+<a id="wrglossary.4691"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>, <a id="wrglossary.4692"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>, <a id="wrglossary.4693"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>
etc commands. The optional argument <span class="meta">〈<em class="metainner">type</em>〉</span> is the name of the
-<a id="wrglossary.4697"></a><a href="#glo:dual.glossary">glossary</a> to which those <a id="wrglossary.4698"></a><a href="#glo:idx.glossaryentry">entries</a> should belong, for those
-<a id="wrglossary.4699"></a><a href="#glo:idx.glossaryentry">entries</a> where the <a id="wrglossary.4700"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key has been omitted (or, more
-specifically, for those entries whose <a id="wrglossary.4701"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> has been set to
-<a id="wrglossary.4702"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>, which is what <a id="wrglossary.4703"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> uses by
-default). See <a id="wrglossary.4704"></a><a href="#glo:file.sampleDB.tex"><span class="filefmt">sampleDB.tex</span></a> for a complete example document.
+<a id="wrglossary.4694"></a><a href="#glo:dual.glossary">glossary</a> to which those <a id="wrglossary.4695"></a><a href="#glo:idx.glossaryentry">entries</a> should belong, for those
+<a id="wrglossary.4696"></a><a href="#glo:idx.glossaryentry">entries</a> where the <a id="wrglossary.4697"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key has been omitted (or, more
+specifically, for those entries whose <a id="wrglossary.4698"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> has been set to
+<a id="wrglossary.4699"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>, which is what <a id="wrglossary.4700"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> uses by
+default). See <a id="wrglossary.4701"></a><a href="#glo:file.sampleDB.tex"><span class="filefmt">sampleDB.tex</span></a> for a complete example document.
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-Commands like <a id="wrglossary.4705"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, <a id="wrglossary.4706"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>,
-<a id="wrglossary.4707"></a><a href="#glo:newterm"><code class="csfmt">\newterm</code></a>, <a id="wrglossary.4708"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a> and <a id="wrglossary.4709"></a><a href="#glo:glsxtrnewnumber"><code class="xtrcsfmt">\glsxtrnewnumber</code></a> all
-set the <a id="wrglossary.4710"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key to the appropriate <a id="wrglossary.4711"></a><a href="#glo:dual.glossary">glossary</a>. This
+Commands like <a id="wrglossary.4702"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, <a id="wrglossary.4703"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>,
+<a id="wrglossary.4704"></a><a href="#glo:newterm"><code class="csfmt">\newterm</code></a>, <a id="wrglossary.4705"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a> and <a id="wrglossary.4706"></a><a href="#glo:glsxtrnewnumber"><code class="xtrcsfmt">\glsxtrnewnumber</code></a> all
+set the <a id="wrglossary.4707"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> key to the appropriate <a id="wrglossary.4708"></a><a href="#glo:dual.glossary">glossary</a>. This
means that the <span class="meta">〈<em class="metainner">type</em>〉</span> optional argument won’t apply to those
-commands, unless they have <a id="wrglossary.4712"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4713"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>.
+commands, unless they have <a id="wrglossary.4709"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4710"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>.
</div><!-- end of information -->
<p>
-This is a <a id="wrglossary.4714"></a><a href="#glo:idx.preamble/document">preamble</a>-only command. You may also use <a id="wrglossary.4715"></a><a href="#glo:input"><code class="csfmt">\input</code></a> to load
-the file but don’t use <a id="wrglossary.4716"></a><a href="#glo:include"><code class="csfmt">\include</code></a>. If you find that your file is
+This is a <a id="wrglossary.4711"></a><a href="#glo:idx.preamble/document">preamble</a>-only command. You may also use <a id="wrglossary.4712"></a><a href="#glo:input"><code class="csfmt">\input</code></a> to load
+the file but don’t use <a id="wrglossary.4713"></a><a href="#glo:include"><code class="csfmt">\include</code></a>. If you find that your file is
becoming unmanageably large, you may want to consider switching to
-<a id="wrglossary.4717"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and use an application such as JabRef to manage the
+<a id="wrglossary.4714"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and use an application such as JabRef to manage the
entry definitions.
<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 <a id="wrglossary.4718"></a><a href="#glo:AtBeginDocument"><code class="csfmt">\AtBeginDocument</code></a> to <a id="wrglossary.4719"></a><a href="#glo:input"><code class="csfmt">\input</code></a> all your
-<a id="wrglossary.4720"></a><a href="#glo:idx.glossaryentry">entries</a> automatically at the start of the document, add the
-<a id="wrglossary.4721"></a><a href="#glo:AtBeginDocument"><code class="csfmt">\AtBeginDocument</code></a> command <span style="font-style: italic; font-variant: normal; ">before</span> you load the
-<a id="wrglossary.4722"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package (and <a id="wrglossary.4723"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, if you are also loading
+If you want to use <a id="wrglossary.4715"></a><a href="#glo:AtBeginDocument"><code class="csfmt">\AtBeginDocument</code></a> to <a id="wrglossary.4716"></a><a href="#glo:input"><code class="csfmt">\input</code></a> all your
+<a id="wrglossary.4717"></a><a href="#glo:idx.glossaryentry">entries</a> automatically at the start of the document, add the
+<a id="wrglossary.4718"></a><a href="#glo:AtBeginDocument"><code class="csfmt">\AtBeginDocument</code></a> command <span style="font-style: italic; font-variant: normal; ">before</span> you load the
+<a id="wrglossary.4719"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package (and <a id="wrglossary.4720"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, if you are also loading
that) to avoid the creation of the
-<a id="wrglossary.4724"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file and any associated problems that are caused
-by defining commands in the <a id="wrglossary.4725"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment.
+<a id="wrglossary.4721"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file and any associated problems that are caused
+by defining commands in the <a id="wrglossary.4722"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment.
(See §<a href="#sec:docdefs">4.8</a>.) Alternatively, if you are using
-<a id="wrglossary.4726"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, use the <a id="wrglossary.4727"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.4728"></a><a href="#glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></a>
+<a id="wrglossary.4723"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, use the <a id="wrglossary.4724"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.4725"></a><a href="#glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></a>
package option.
</div><!-- end of important -->
@@ -13664,44 +13668,44 @@
<p>
<div class="example" id="ex:loadgls"><div class="title">Example 17: Loading Entries from Another File</div>
Suppose I have a file called <span class="filefmt">myentries.tex</span> which contains:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4729"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{perl}{<a id="wrglossary.4730"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4731"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>}</span>,
-<a id="wrglossary.4732"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Perl}</span>,
-<a id="wrglossary.4733"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={A scripting language}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4726"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{perl}{<a id="wrglossary.4727"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4728"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>}</span>,
+<a id="wrglossary.4729"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={Perl}</span>,
+<a id="wrglossary.4730"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={A scripting language}</span>}
-<a id="wrglossary.4734"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{tex}{<a id="wrglossary.4735"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\TeX</code>}</span>,
-<a id="wrglossary.4736"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={A typesetting language}</span>,<a id="wrglossary.4737"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={TeX}</span>}
+<a id="wrglossary.4731"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{tex}{<a id="wrglossary.4732"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<code class="cmd">\TeX</code>}</span>,
+<a id="wrglossary.4733"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={A typesetting language}</span>,<a id="wrglossary.4734"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={TeX}</span>}
-<a id="wrglossary.4738"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{html}{<a id="wrglossary.4739"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4740"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,
-<a id="wrglossary.4741"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={html}</span>,
-<a id="wrglossary.4742"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={A mark up language}</span>}
+<a id="wrglossary.4735"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{html}{<a id="wrglossary.4736"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4737"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,
+<a id="wrglossary.4738"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={html}</span>,
+<a id="wrglossary.4739"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={A mark up language}</span>}
</pre>
-and suppose in my <a id="wrglossary.4743"></a><a href="#glo:idx.preamble/document">preamble</a> I use the command:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4744"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>[languages]{myentries}
+and suppose in my <a id="wrglossary.4740"></a><a href="#glo:idx.preamble/document">preamble</a> I use the command:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4741"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>[languages]{myentries}
</pre>
then this will add the entries <span class="qt">“tex”</span> and <span class="qt">“html”</span>
-to the <a id="wrglossary.4745"></a><a href="#glo:dual.glossary">glossary</a> whose type is given by <span class="optfmt">languages</span>, but
-the entry <span class="qt">“perl”</span> will be added to the <a id="wrglossary.4746"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary, since
-it explicitly sets the <a id="wrglossary.4747"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> to <a id="wrglossary.4748"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>.
+to the <a id="wrglossary.4742"></a><a href="#glo:dual.glossary">glossary</a> whose type is given by <span class="optfmt">languages</span>, but
+the entry <span class="qt">“perl”</span> will be added to the <a id="wrglossary.4743"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary, since
+it explicitly sets the <a id="wrglossary.4744"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> to <a id="wrglossary.4745"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>.
</div>
<p>
Now suppose I have a file <span class="filefmt">myacronyms.tex</span> that contains:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4749"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{aca}{aca}{a contrived acronym}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4746"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{aca}{aca}{a contrived acronym}
</pre>
-then (supposing I have defined a new <a id="wrglossary.4750"></a><a href="#glo:dual.glossary">glossary</a> type called
+then (supposing I have defined a new <a id="wrglossary.4747"></a><a href="#glo:dual.glossary">glossary</a> type called
<span class="optfmt">altacronym</span>)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4751"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>[altacronym]{myacronyms}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4748"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>[altacronym]{myacronyms}
</pre>
-will add <span class="qt">“aca”</span> to the glossary type <a id="wrglossary.4752"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>, if the
-package option <a id="wrglossary.4753"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> has been specified, or will add
+will add <span class="qt">“aca”</span> to the glossary type <a id="wrglossary.4749"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>, if the
+package option <a id="wrglossary.4750"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> has been specified, or will add
<span class="qt">“aca”</span> to the glossary type <span class="optfmt">altacronym</span>, if the
-package option <a id="wrglossary.4754"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> is not specified. This is
-because <a id="wrglossary.4755"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> is set to <a id="wrglossary.4756"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> if the
-<a id="wrglossary.4757"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option is not used so the optional argument of
-<a id="wrglossary.4758"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> will work in that case, but if the
-<a id="wrglossary.4759"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is used then <a id="wrglossary.4760"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> will be
-redefined to <a id="wrglossary.4761"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>.
+package option <a id="wrglossary.4751"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> is not specified. This is
+because <a id="wrglossary.4752"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> is set to <a id="wrglossary.4753"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> if the
+<a id="wrglossary.4754"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option is not used so the optional argument of
+<a id="wrglossary.4755"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> will work in that case, but if the
+<a id="wrglossary.4756"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is used then <a id="wrglossary.4757"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> will be
+redefined to <a id="wrglossary.4758"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>.
<p>
-If you want to use <a id="wrglossary.4762"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> with the <a id="wrglossary.4763"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>
+If you want to use <a id="wrglossary.4759"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> with the <a id="wrglossary.4760"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>
package option set, there are two possible solutions to this problem:
<ol class="displaylist">
@@ -13708,58 +13712,58 @@
<li><span class="numitem">1.</span>Change <span class="filefmt">myacronyms.tex</span> so that entries are defined in
the form:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4764"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.4765"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4766"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>]{aca}{aca}{a
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4761"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.4762"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.4763"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>]{aca}{aca}{a
contrived acronym}
</pre>
and do:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4767"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>[altacronym]{myacronyms}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4764"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>[altacronym]{myacronyms}
</pre>
<p>
-<li><span class="numitem">2.</span>Temporarily change <a id="wrglossary.4768"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to the target <a id="wrglossary.4769"></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">\let</code><code class="cmd">\orgacronymtype</code><a id="wrglossary.4770"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>
-<code class="cmd">\renewcommand</code>{<a id="wrglossary.4771"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}{altacronym}
-<a id="wrglossary.4772"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>myacronyms
-<code class="cmd">\let</code><a id="wrglossary.4773"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a><code class="cmd">\orgacronymtype</code>
+<li><span class="numitem">2.</span>Temporarily change <a id="wrglossary.4765"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to the target <a id="wrglossary.4766"></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">\let</code><code class="cmd">\orgacronymtype</code><a id="wrglossary.4767"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.4768"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>}{altacronym}
+<a id="wrglossary.4769"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>myacronyms
+<code class="cmd">\let</code><a id="wrglossary.4770"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a><code class="cmd">\orgacronymtype</code>
</pre>
</ol>
<p>
-Note that only those entries that have been <a id="wrglossary.4774"></a><a href="#glo:dual.indexing">indexed</a> in the text will appear in the relevant <a id="wrglossary.4775"></a><a href="#glo:dual.glossary">glossaries</a>.
-Note also that <a id="wrglossary.4776"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> may only be used in the
-<a id="wrglossary.4777"></a><a href="#glo:idx.preamble/document">preamble</a>.
+Note that only those entries that have been <a id="wrglossary.4771"></a><a href="#glo:dual.indexing">indexed</a> in the text will appear in the relevant <a id="wrglossary.4772"></a><a href="#glo:dual.glossary">glossaries</a>.
+Note also that <a id="wrglossary.4773"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> may only be used in the
+<a id="wrglossary.4774"></a><a href="#glo:idx.preamble/document">preamble</a>.
<p>
<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
-Don’t use the <a id="wrglossary.4778"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key in a large file of entries that may
-or may not be <a id="wrglossary.4779"></a><a href="#glo:dual.indexing">indexed</a> in the document. Similarly for
-<a id="wrglossary.4780"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> and <a id="wrglossary.4781"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> with <a id="wrglossary.4782"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+Don’t use the <a id="wrglossary.4775"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key in a large file of entries that may
+or may not be <a id="wrglossary.4776"></a><a href="#glo:dual.indexing">indexed</a> in the document. Similarly for
+<a id="wrglossary.4777"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> and <a id="wrglossary.4778"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> with <a id="wrglossary.4779"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
If you need them and you need a large database of entries, consider
-switching to <a id="wrglossary.4783"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
+switching to <a id="wrglossary.4780"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
</div><!-- end of warning -->
<p>
-Remember that you can use <a id="wrglossary.4784"></a><a href="#glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></a> rather than
-<a id="wrglossary.4785"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. Suppose you want to maintain a large database
-of <a id="wrglossary.4786"></a><a href="#glo:idx.acronym">acronyms</a> or terms that you’re likely to use in your documents,
-but you may want to use a modified version of some of those <a id="wrglossary.4787"></a><a href="#glo:idx.glossaryentry">entries</a>.
+Remember that you can use <a id="wrglossary.4781"></a><a href="#glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></a> rather than
+<a id="wrglossary.4782"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. Suppose you want to maintain a large database
+of <a id="wrglossary.4783"></a><a href="#glo:idx.acronym">acronyms</a> or terms that you’re likely to use in your documents,
+but you may want to use a modified version of some of those <a id="wrglossary.4784"></a><a href="#glo:idx.glossaryentry">entries</a>.
(Suppose, for example, one document may require a more detailed
-description.) Then if you define the <a id="wrglossary.4788"></a><a href="#glo:idx.glossaryentry">entries</a> using
-<a id="wrglossary.4789"></a><a href="#glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></a> in your database file, you can override
-the definition by simply using <a id="wrglossary.4790"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> before loading
+description.) Then if you define the <a id="wrglossary.4785"></a><a href="#glo:idx.glossaryentry">entries</a> using
+<a id="wrglossary.4786"></a><a href="#glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></a> in your database file, you can override
+the definition by simply using <a id="wrglossary.4787"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> before loading
the file. For example, suppose your file (called, say,
<span class="filefmt">terms.tex</span>) contains:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4791"></a><a href="#glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></a>{mallard}{<a id="wrglossary.4792"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={mallard}</span>,
- <a id="wrglossary.4793"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a type of duck}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.4788"></a><a href="#glo:provideglossaryentry"><code class="csfmt">\provideglossaryentry</code></a>{mallard}{<a id="wrglossary.4789"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={mallard}</span>,
+ <a id="wrglossary.4790"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a type of duck}</span>}
</pre>
but suppose your document requires a more detailed description, you
can do:
<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}
-<a id="wrglossary.4794"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.4791"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<a id="wrglossary.4795"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{mallard}{<a id="wrglossary.4796"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={mallard}</span>,
- <a id="wrglossary.4797"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a dabbling duck where the male has a green head}</span>}
+<a id="wrglossary.4792"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{mallard}{<a id="wrglossary.4793"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={mallard}</span>,
+ <a id="wrglossary.4794"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a dabbling duck where the male has a green head}</span>}
-<a id="wrglossary.4798"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>{terms}
+<a id="wrglossary.4795"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>{terms}
</pre>
Now the <span class="qt">“mallard”</span> definition in the <span class="filefmt">terms.tex</span> file
will be ignored.
@@ -13771,37 +13775,37 @@
<h2><!-- start of section header -->4.7. Moving Entries to Another Glossary<span class="labellink"><a href="#sec:moveentry">[link]</a></span></h2><!-- end of section header -->
<p>
-You can move an entry from one <a id="wrglossary.4799"></a><a href="#glo:dual.glossary">glossary</a> to another using:
+You can move an entry from one <a id="wrglossary.4796"></a><a href="#glo:dual.glossary">glossary</a> to another 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.4800"></a><code class="code"><dfn id="glo:glsmoveentry"><code class="csfmt">\glsmoveentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">target glossary label</em>〉</span>}</code></div><!-- end of pinnedbox -->
+<a id="wrglossary.4797"></a><code class="code"><dfn id="glo:glsmoveentry"><code class="csfmt">\glsmoveentry</code></dfn>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<span class="meta">〈<em class="metainner">target glossary label</em>〉</span>}</code></div><!-- end of pinnedbox -->
where <span class="meta">〈<em class="metainner">entry-label</em>〉</span> is the unique label identifying the required
-<a id="wrglossary.4801"></a><a href="#glo:idx.glossaryentry">entry</a> and <span class="meta">〈<em class="metainner">target glossary label</em>〉</span> is the unique label
-identifying the <a id="wrglossary.4802"></a><a href="#glo:dual.glossary">glossary</a> in which to put the <a id="wrglossary.4803"></a><a href="#glo:idx.glossaryentry">entry</a>. If you are
-using Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, <a id="wrglossary.4804"></a><a href="#glo:idx.glossaryentry">entries</a> shouldn’t be moved after the
-<a id="wrglossary.4805"></a><a href="#glo:dual.indexingfile">indexing files</a> have been opened by <a id="wrglossary.4806"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
+<a id="wrglossary.4798"></a><a href="#glo:idx.glossaryentry">entry</a> and <span class="meta">〈<em class="metainner">target glossary label</em>〉</span> is the unique label
+identifying the <a id="wrglossary.4799"></a><a href="#glo:dual.glossary">glossary</a> in which to put the <a id="wrglossary.4800"></a><a href="#glo:idx.glossaryentry">entry</a>. If you are
+using Options <a href="#glo:idx.opt.mkidx">2</a> or <a href="#glo:idx.opt.xdy">3</a>, <a id="wrglossary.4801"></a><a href="#glo:idx.glossaryentry">entries</a> shouldn’t be moved after the
+<a id="wrglossary.4802"></a><a href="#glo:dual.indexingfile">indexing files</a> have been opened by <a id="wrglossary.4803"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
<p>
<div class="warning"><div class="warningtitle"><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
-Simply changing the value of the <a id="wrglossary.4807"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> field using a
-command like <a id="wrglossary.4808"></a><a href="#glo:glsfielddef"><code class="csfmt">\glsfielddef</code></a> won’t correctly move the entry, since the label
-needs to be removed from the old <a id="wrglossary.4809"></a><a href="#glo:dual.glossary">glossary’s</a> internal list
-and added to the new <a id="wrglossary.4810"></a><a href="#glo:dual.glossary">glossary’s</a> internal list to allow
-commands such as <a id="wrglossary.4811"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a> and <a id="wrglossary.4812"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> to work.
+Simply changing the value of the <a id="wrglossary.4804"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a> field using a
+command like <a id="wrglossary.4805"></a><a href="#glo:glsfielddef"><code class="csfmt">\glsfielddef</code></a> won’t correctly move the entry, since the label
+needs to be removed from the old <a id="wrglossary.4806"></a><a href="#glo:dual.glossary">glossary’s</a> internal list
+and added to the new <a id="wrglossary.4807"></a><a href="#glo:dual.glossary">glossary’s</a> internal list to allow
+commands such as <a id="wrglossary.4808"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a> and <a id="wrglossary.4809"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> to work.
</div><!-- end of warning -->
<p>
Note that no check is performed to determine the existence of
-the target <a id="wrglossary.4813"></a><a href="#glo:dual.glossary">glossary</a>. If you want to move an entry to a <a id="wrglossary.4814"></a><a href="#glo:dual.glossary">glossary</a>
-that’s skipped by <a id="wrglossary.4815"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>, then define an
-<a id="wrglossary.4816"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a> with <a id="wrglossary.4817"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>. (See
+the target <a id="wrglossary.4810"></a><a href="#glo:dual.glossary">glossary</a>. If you want to move an entry to a <a id="wrglossary.4811"></a><a href="#glo:dual.glossary">glossary</a>
+that’s skipped by <a id="wrglossary.4812"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>, then define an
+<a id="wrglossary.4813"></a><a href="#glo:dual.ignoredglossary">ignored glossary</a> with <a id="wrglossary.4814"></a><a href="#glo:newignoredglossary"><code class="csfmt">\newignoredglossary</code></a>. (See
§<a href="#sec:newglossary">9</a>.) With Options <a href="#glo:idx.opt.b2g">4</a> and <a href="#glo:idx.opt.unsrt">5</a>, it’s also
@@ Diff output truncated at 1234567 characters. @@
More information about the tex-live-commits
mailing list.